@zonsh/ui 0.4.1 → 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 (562) 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 +7 -7
  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/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,793 @@
1
+ # Settings
2
+
3
+ ```tsx
4
+ import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Avatar, Button, Field, FieldDescription, FieldError, FieldLabel, Fieldset, FieldsetLegend, Form, FormActions, Heading, Input, InputGroup, InputGroupAddon, InputGroupInput, InputGroupText, Item, ItemActions, ItemContent, ItemDescription, ItemGroup, ItemMedia, ItemSeparator, ItemTitle, Section, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Switch, Tabs, TabsList, TabsPanel, TabsTab, Tag, Text, Textarea, Toaster, toast } from "@zonsh/ui";
5
+ import { ImageUpIcon, LaptopIcon, MonitorIcon, SmartphoneIcon, Trash2Icon, UserPlusIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ type Profile = { name: string; email: string; bio: string; language: string; photo: string | null };
9
+
10
+ type Workspace = { name: string; slug: string; timeZone: string };
11
+
12
+ type Notifications = Record<(typeof notificationRows)[number]["id"], boolean>;
13
+
14
+ const initialProfile: Profile = {
15
+ name: "Alex Weber",
16
+ email: "alex@example.com",
17
+ bio: "I edit the newsletter and look after our photo archive.",
18
+ language: "en-GB",
19
+ photo: null,
20
+ };
21
+
22
+ const initialWorkspace: Workspace = { name: "Field Notes", slug: "field-notes", timeZone: "Europe/Berlin" };
23
+
24
+ const languages = [
25
+ { value: "en-GB", label: "English (UK)" },
26
+ { value: "en-US", label: "English (US)" },
27
+ { value: "de-DE", label: "Deutsch" },
28
+ { value: "fr-FR", label: "Français" },
29
+ { value: "nl-NL", label: "Nederlands" },
30
+ ];
31
+
32
+ const timeZones = [
33
+ { value: "Europe/London", label: "Europe/London" },
34
+ { value: "Europe/Berlin", label: "Europe/Berlin" },
35
+ { value: "America/New_York", label: "America/New_York" },
36
+ { value: "Asia/Tokyo", label: "Asia/Tokyo" },
37
+ { value: "UTC", label: "UTC" },
38
+ ];
39
+
40
+ const notificationRows = [
41
+ {
42
+ id: "mentions",
43
+ group: "email",
44
+ label: "Mentions",
45
+ description: "When someone mentions you in a comment or a note.",
46
+ },
47
+ {
48
+ id: "summary",
49
+ group: "email",
50
+ label: "Weekly summary",
51
+ description: "What changed in your projects, every Monday morning.",
52
+ },
53
+ {
54
+ id: "product",
55
+ group: "email",
56
+ label: "Product updates",
57
+ description: "Occasional notes about new features and changes.",
58
+ },
59
+ {
60
+ id: "signIn",
61
+ group: "security",
62
+ label: "Sign-in alerts",
63
+ description: "An email when your account is used on a new device.",
64
+ },
65
+ ] as const;
66
+
67
+ const notificationGroups = [
68
+ { id: "email", legend: "Email" },
69
+ { id: "security", legend: "Security" },
70
+ ] as const;
71
+
72
+ /** The people in the workspace. The owner's role is fixed; the others change at once. */
73
+ const members = [
74
+ { id: "alex", name: "Alex Weber", email: "alex@example.com", role: "owner" },
75
+ { id: "sam", name: "Sam Okoro", email: "sam@example.com", role: "admin" },
76
+ { id: "lena", name: "Lena Fischer", email: "lena@example.com", role: "member" },
77
+ { id: "tomas", name: "Tomás Rivera", email: "tomas@example.com", role: "viewer" },
78
+ ];
79
+
80
+ const roles = [
81
+ { value: "admin", label: "Admin" },
82
+ { value: "member", label: "Member" },
83
+ { value: "viewer", label: "Viewer" },
84
+ ];
85
+
86
+ /** The devices this account is signed in on, the one in use first. */
87
+ const initialSessions = [
88
+ {
89
+ id: "mac",
90
+ device: "Chrome on macOS",
91
+ place: "Berlin",
92
+ seen: "Active now",
93
+ current: true,
94
+ icon: LaptopIcon,
95
+ },
96
+ {
97
+ id: "iphone",
98
+ device: "Safari on iPhone",
99
+ place: "Berlin",
100
+ seen: "2 hours ago",
101
+ current: false,
102
+ icon: SmartphoneIcon,
103
+ },
104
+ {
105
+ id: "pc",
106
+ device: "Firefox on Windows",
107
+ place: "Hamburg",
108
+ seen: "3 days ago",
109
+ current: false,
110
+ icon: MonitorIcon,
111
+ },
112
+ ];
113
+
114
+ const SAVE_DELAY = 900;
115
+
116
+ /** A saved value and an editable draft of it, with a fake, timed save. */
117
+ function useDraft<T extends object>(initial: T) {
118
+ const [saved, setSaved] = React.useState(initial);
119
+ const [draft, setDraft] = React.useState(initial);
120
+ const [saving, setSaving] = React.useState(false);
121
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
122
+ React.useEffect(() => () => clearTimeout(timer.current), []);
123
+
124
+ const dirty = (Object.keys(draft) as (keyof T)[]).some((key) => draft[key] !== saved[key]);
125
+ const set = <K extends keyof T>(key: K, value: T[K]) =>
126
+ setDraft((current) => ({ ...current, [key]: value }));
127
+ const discard = () => setDraft(saved);
128
+ const save = (onSaved: () => void) => {
129
+ setSaving(true);
130
+ const snapshot = draft;
131
+ timer.current = setTimeout(() => {
132
+ setSaved(snapshot);
133
+ setSaving(false);
134
+ onSaved();
135
+ }, SAVE_DELAY);
136
+ };
137
+ return { saved, draft, dirty, saving, set, discard, save };
138
+ }
139
+
140
+ function SettingsSection({
141
+ title,
142
+ description,
143
+ children,
144
+ className,
145
+ headingId,
146
+ }: {
147
+ title: string;
148
+ description: string;
149
+ children: React.ReactNode;
150
+ className?: string;
151
+ /** Lets the heading take focus (tabIndex -1) by this id, for when what had focus is gone. */
152
+ headingId?: string;
153
+ }) {
154
+ return (
155
+ <Section
156
+ className={[
157
+ "grid gap-5 py-8 first:border-t-0 first:pt-3 @2xl:grid-cols-[13rem_minmax(0,1fr)] @2xl:gap-10",
158
+ className,
159
+ ]
160
+ .filter(Boolean)
161
+ .join(" ")}
162
+ >
163
+ <div className="flex flex-col gap-1.5">
164
+ <Heading
165
+ level={4}
166
+ as="h3"
167
+ id={headingId}
168
+ tabIndex={headingId ? -1 : undefined}
169
+ className={headingId ? "outline-none" : undefined}
170
+ >
171
+ {title}
172
+ </Heading>
173
+ <Text size="sm" tone="muted">
174
+ {description}
175
+ </Text>
176
+ </div>
177
+ <div className="flex min-w-0 flex-col gap-5">{children}</div>
178
+ </Section>
179
+ );
180
+ }
181
+
182
+ /** The save row: a note on the left, Discard and the one primary on the right. */
183
+ function SaveRow({
184
+ dirty,
185
+ saving,
186
+ onDiscard,
187
+ label,
188
+ }: {
189
+ dirty: boolean;
190
+ saving: boolean;
191
+ onDiscard: () => void;
192
+ label: string;
193
+ }) {
194
+ return (
195
+ <FormActions align="between" className="pt-6 hairline">
196
+ <p role="status" className="font-mono text-xs text-muted-foreground">
197
+ {dirty && !saving ? "You have unsaved changes." : ""}
198
+ </p>
199
+ <div className="flex items-center gap-3">
200
+ <Button
201
+ type="button"
202
+ variant="ghost"
203
+ disabled={!dirty || saving}
204
+ focusableWhenDisabled
205
+ onClick={onDiscard}
206
+ >
207
+ Discard
208
+ </Button>
209
+ <Button type="submit" disabled={!dirty} focusableWhenDisabled loading={saving} loadingLabel={label}>
210
+ Save changes
211
+ </Button>
212
+ </div>
213
+ </FormActions>
214
+ );
215
+ }
216
+
217
+ export function Settings() {
218
+ const profile = useDraft(initialProfile);
219
+ const workspace = useDraft(initialWorkspace);
220
+ const [notifications, setNotifications] = React.useState<Notifications>({
221
+ mentions: true,
222
+ summary: true,
223
+ product: false,
224
+ signIn: true,
225
+ });
226
+
227
+ // Photo previews stay in the browser as object URLs; release them when the page goes away.
228
+ const photoInput = React.useRef<HTMLInputElement>(null);
229
+ const objectUrls = React.useRef<string[]>([]);
230
+ React.useEffect(() => () => objectUrls.current.forEach((url) => URL.revokeObjectURL(url)), []);
231
+
232
+ const [memberRoles, setMemberRoles] = React.useState(() =>
233
+ Object.fromEntries(members.map((member) => [member.id, member.role])),
234
+ );
235
+ const [twoStep, setTwoStep] = React.useState(true);
236
+ const [sessions, setSessions] = React.useState(initialSessions);
237
+
238
+ const changeRole = (member: (typeof members)[number], role: string) => {
239
+ setMemberRoles((current) => ({ ...current, [member.id]: role }));
240
+ const label = roles.find((r) => r.value === role)?.label.toLowerCase() ?? role;
241
+ toast(`${member.name.split(" ")[0]} is now ${label === "admin" ? "an" : "a"} ${label}.`);
242
+ };
243
+
244
+ // Signing out removes the row that holds the pressed button. Focus goes to the next device's
245
+ // button (or the one before, at the end), and to the "Devices" heading when only this device is
246
+ // left — never to the page's body.
247
+ const devicesId = React.useId();
248
+ const focusAfterSignOut = React.useRef<string | null>(null);
249
+ React.useEffect(() => {
250
+ if (!focusAfterSignOut.current) return;
251
+ document.getElementById(focusAfterSignOut.current)?.focus();
252
+ focusAfterSignOut.current = null;
253
+ }, [sessions]);
254
+
255
+ const signOut = (ids: string[]) => {
256
+ const names = sessions.filter((session) => ids.includes(session.id)).map((session) => session.device);
257
+ const at = sessions.findIndex((session) => ids.includes(session.id));
258
+ const others = (list: typeof sessions) => list.filter((s) => !s.current && !ids.includes(s.id));
259
+ const next = others(sessions.slice(at))[0] ?? others(sessions.slice(0, at)).at(-1);
260
+ focusAfterSignOut.current = next ? `${devicesId}-${next.id}` : `${devicesId}-heading`;
261
+ setSessions((current) => current.filter((session) => !ids.includes(session.id)));
262
+ toast(names.length === 1 ? `Signed out of ${names[0]}.` : `Signed out of ${names.length} devices.`);
263
+ };
264
+
265
+ const [deleteOpen, setDeleteOpen] = React.useState(false);
266
+ const [deleting, setDeleting] = React.useState(false);
267
+ const deleteTimer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
268
+ React.useEffect(() => () => clearTimeout(deleteTimer.current), []);
269
+
270
+ const pickPhoto = (event: React.ChangeEvent<HTMLInputElement>) => {
271
+ const file = event.target.files?.[0];
272
+ event.target.value = "";
273
+ if (!file) return;
274
+ const url = URL.createObjectURL(file);
275
+ objectUrls.current.push(url);
276
+ profile.set("photo", url);
277
+ };
278
+
279
+ const toggleNotification = (row: (typeof notificationRows)[number], checked: boolean) => {
280
+ setNotifications((current) => ({ ...current, [row.id]: checked }));
281
+ toast(`${row.label} turned ${checked ? "on" : "off"}.`);
282
+ };
283
+
284
+ const deleteWorkspace = () => {
285
+ setDeleting(true);
286
+ deleteTimer.current = setTimeout(() => {
287
+ setDeleting(false);
288
+ setDeleteOpen(false);
289
+ toast("Workspace deleted", { description: "This is a demo, so nothing was removed." });
290
+ }, SAVE_DELAY);
291
+ };
292
+
293
+ return (
294
+ <div className="@container w-full max-w-3xl">
295
+ <Toaster />
296
+ <header className="mb-6 flex flex-col gap-1.5">
297
+ <Heading level={3} as="h2">
298
+ Settings
299
+ </Heading>
300
+ <Text size="sm" tone="muted">
301
+ Your profile, the workspace you share, and what we send you.
302
+ </Text>
303
+ </header>
304
+
305
+ <Tabs defaultValue="profile">
306
+ {/* Four tabs fit most phones with a little less room between them; on the narrowest the row scrolls. */}
307
+ <TabsList variant="underline" className="gap-3 @md:gap-6">
308
+ <TabsTab value="profile">Profile</TabsTab>
309
+ <TabsTab value="workspace">Workspace</TabsTab>
310
+ <TabsTab value="notifications">Notifications</TabsTab>
311
+ <TabsTab value="security">Security</TabsTab>
312
+ </TabsList>
313
+
314
+ <TabsPanel value="profile">
315
+ <Form
316
+ className="gap-0"
317
+ onFormSubmit={() => profile.save(() => toast.success("Your profile is saved."))}
318
+ >
319
+ <SettingsSection title="Photo" description="Shown next to your comments and in the member list.">
320
+ <div className="flex flex-wrap items-center gap-4">
321
+ <Avatar size="lg" name={profile.draft.name} src={profile.draft.photo ?? undefined} />
322
+ <div className="flex flex-wrap items-center gap-2">
323
+ <Button
324
+ type="button"
325
+ variant="secondary"
326
+ size="sm"
327
+ onClick={() => photoInput.current?.click()}
328
+ >
329
+ <ImageUpIcon aria-hidden />
330
+ Change photo
331
+ </Button>
332
+ {profile.draft.photo && (
333
+ <Button
334
+ type="button"
335
+ variant="ghost"
336
+ size="sm"
337
+ onClick={() => profile.set("photo", null)}
338
+ >
339
+ Remove
340
+ </Button>
341
+ )}
342
+ </div>
343
+ <input ref={photoInput} type="file" accept="image/*" hidden onChange={pickPhoto} />
344
+ </div>
345
+ <p className="text-13 leading-normal text-muted-foreground">
346
+ A square image works best. In this demo it stays in your browser.
347
+ </p>
348
+ </SettingsSection>
349
+
350
+ <SettingsSection title="About you" description="How people in your workspace see you.">
351
+ <Field name="name">
352
+ <FieldLabel>Name</FieldLabel>
353
+ <Input
354
+ required
355
+ autoComplete="name"
356
+ value={profile.draft.name}
357
+ onValueChange={(value) => profile.set("name", value)}
358
+ />
359
+ <FieldError match="valueMissing">Tell us what to call you.</FieldError>
360
+ </Field>
361
+ <Field name="email">
362
+ <FieldLabel>Email</FieldLabel>
363
+ <Input
364
+ required
365
+ type="email"
366
+ autoComplete="email"
367
+ value={profile.draft.email}
368
+ onValueChange={(value) => profile.set("email", value)}
369
+ />
370
+ <FieldDescription>Where we send sign-in links and the emails you choose.</FieldDescription>
371
+ <FieldError match="valueMissing">We need an email address to reach you.</FieldError>
372
+ <FieldError match="typeMismatch">
373
+ That does not look like an email address. Check the @ part.
374
+ </FieldError>
375
+ </Field>
376
+ <Field name="bio">
377
+ <FieldLabel>Short bio</FieldLabel>
378
+ <Textarea value={profile.draft.bio} onValueChange={(value) => profile.set("bio", value)} />
379
+ <FieldDescription>A sentence or two about what you work on.</FieldDescription>
380
+ </Field>
381
+ </SettingsSection>
382
+
383
+ <SettingsSection title="Language" description="Used for menus, emails and dates.">
384
+ <Field name="language">
385
+ <FieldLabel>Interface language</FieldLabel>
386
+ <Select
387
+ items={languages}
388
+ value={profile.draft.language}
389
+ onValueChange={(value) => value && profile.set("language", value)}
390
+ >
391
+ <SelectTrigger>
392
+ <SelectValue />
393
+ </SelectTrigger>
394
+ <SelectContent>
395
+ {languages.map((language) => (
396
+ <SelectItem key={language.value} value={language.value}>
397
+ {language.label}
398
+ </SelectItem>
399
+ ))}
400
+ </SelectContent>
401
+ </Select>
402
+ </Field>
403
+ </SettingsSection>
404
+
405
+ <SaveRow
406
+ dirty={profile.dirty}
407
+ saving={profile.saving}
408
+ onDiscard={profile.discard}
409
+ label="Saving your profile"
410
+ />
411
+ </Form>
412
+ </TabsPanel>
413
+
414
+ <TabsPanel value="workspace">
415
+ <Form
416
+ className="gap-0"
417
+ onFormSubmit={() => workspace.save(() => toast.success("Workspace settings are saved."))}
418
+ >
419
+ <SettingsSection title="Workspace" description="Everyone in the workspace sees these.">
420
+ <Field name="workspaceName">
421
+ <FieldLabel>Workspace name</FieldLabel>
422
+ <Input
423
+ required
424
+ autoComplete="organization"
425
+ value={workspace.draft.name}
426
+ onValueChange={(value) => workspace.set("name", value)}
427
+ />
428
+ <FieldError match="valueMissing">Give the workspace a name.</FieldError>
429
+ </Field>
430
+ <Field name="slug">
431
+ <FieldLabel>Workspace address</FieldLabel>
432
+ {/* A web address reads left to right, in a right-to-left page too. */}
433
+ <InputGroup dir="ltr">
434
+ <InputGroupInput
435
+ required
436
+ pattern="[a-z0-9\-]+"
437
+ value={workspace.draft.slug}
438
+ onValueChange={(value) => workspace.set("slug", value)}
439
+ />
440
+ <InputGroupAddon>
441
+ <InputGroupText>example.com/</InputGroupText>
442
+ </InputGroupAddon>
443
+ </InputGroup>
444
+ <FieldDescription>Old links stop working when you change it.</FieldDescription>
445
+ <FieldError match="valueMissing">The workspace needs an address.</FieldError>
446
+ <FieldError match="patternMismatch">Use lowercase letters, numbers and hyphens.</FieldError>
447
+ </Field>
448
+ <Field name="timeZone">
449
+ <FieldLabel>Time zone</FieldLabel>
450
+ <Select
451
+ items={timeZones}
452
+ value={workspace.draft.timeZone}
453
+ onValueChange={(value) => value && workspace.set("timeZone", value)}
454
+ >
455
+ <SelectTrigger>
456
+ <SelectValue />
457
+ </SelectTrigger>
458
+ <SelectContent>
459
+ {timeZones.map((zone) => (
460
+ <SelectItem key={zone.value} value={zone.value}>
461
+ {zone.label}
462
+ </SelectItem>
463
+ ))}
464
+ </SelectContent>
465
+ </Select>
466
+ <FieldDescription>Reminders and the weekly summary follow this time zone.</FieldDescription>
467
+ </Field>
468
+ </SettingsSection>
469
+
470
+ <SaveRow
471
+ dirty={workspace.dirty}
472
+ saving={workspace.saving}
473
+ onDiscard={workspace.discard}
474
+ label="Saving workspace settings"
475
+ />
476
+ </Form>
477
+
478
+ <SettingsSection
479
+ className="mt-8"
480
+ title="Members"
481
+ description="Who can open the workspace, and what they can change. A new role applies at once."
482
+ >
483
+ <ItemGroup render={<ul />} aria-label="Members" className="gap-0">
484
+ {members.map((member, i) => (
485
+ <React.Fragment key={member.id}>
486
+ {i > 0 && <ItemSeparator />}
487
+ <Item render={<li />} size="sm" className="px-0">
488
+ <ItemMedia>
489
+ <Avatar name={member.name} aria-hidden />
490
+ </ItemMedia>
491
+ <ItemContent>
492
+ <ItemTitle>{member.name}</ItemTitle>
493
+ <ItemDescription>{member.email}</ItemDescription>
494
+ </ItemContent>
495
+ <ItemActions>
496
+ {member.role === "owner" ? (
497
+ <span className="px-3 font-mono text-xs text-muted-foreground">Owner</span>
498
+ ) : (
499
+ <Select
500
+ items={roles}
501
+ value={memberRoles[member.id]}
502
+ onValueChange={(value) => value && changeRole(member, value)}
503
+ >
504
+ <SelectTrigger
505
+ size="sm"
506
+ aria-label={`Role for ${member.name}`}
507
+ className="w-32 min-w-0"
508
+ >
509
+ <SelectValue />
510
+ </SelectTrigger>
511
+ <SelectContent>
512
+ {roles.map((role) => (
513
+ <SelectItem key={role.value} value={role.value}>
514
+ {role.label}
515
+ </SelectItem>
516
+ ))}
517
+ </SelectContent>
518
+ </Select>
519
+ )}
520
+ </ItemActions>
521
+ </Item>
522
+ </React.Fragment>
523
+ ))}
524
+ </ItemGroup>
525
+ <Button
526
+ type="button"
527
+ variant="secondary"
528
+ className="self-start"
529
+ onClick={() => toast("Invitations are not sent in this demo.")}
530
+ >
531
+ <UserPlusIcon aria-hidden />
532
+ Invite people
533
+ </Button>
534
+ </SettingsSection>
535
+
536
+ <SettingsSection
537
+ className="mt-8"
538
+ title="Danger zone"
539
+ description="Deleting a workspace removes it for everyone in it."
540
+ >
541
+ <div className="flex flex-col items-start gap-4">
542
+ <Text size="sm" tone="soft">
543
+ Projects, files and history in {workspace.saved.name} are deleted with it. This cannot be
544
+ undone.
545
+ </Text>
546
+ <AlertDialog open={deleteOpen} onOpenChange={(open) => !deleting && setDeleteOpen(open)}>
547
+ <AlertDialogTrigger render={<Button variant="destructive" />}>
548
+ <Trash2Icon aria-hidden />
549
+ Delete workspace
550
+ </AlertDialogTrigger>
551
+ <AlertDialogContent>
552
+ <AlertDialogHeader>
553
+ <AlertDialogTitle>Delete {workspace.saved.name}?</AlertDialogTitle>
554
+ <AlertDialogDescription>
555
+ Everyone loses access to its projects, files and history. This cannot be undone.
556
+ </AlertDialogDescription>
557
+ </AlertDialogHeader>
558
+ <AlertDialogFooter>
559
+ <AlertDialogClose render={<Button variant="secondary" />} disabled={deleting}>
560
+ Keep workspace
561
+ </AlertDialogClose>
562
+ <Button
563
+ variant="destructive"
564
+ onClick={deleteWorkspace}
565
+ loading={deleting}
566
+ loadingLabel="Deleting workspace"
567
+ >
568
+ Delete workspace
569
+ </Button>
570
+ </AlertDialogFooter>
571
+ </AlertDialogContent>
572
+ </AlertDialog>
573
+ </div>
574
+ </SettingsSection>
575
+ </TabsPanel>
576
+
577
+ <TabsPanel value="notifications">
578
+ <SettingsSection
579
+ title="Email and alerts"
580
+ description="These take effect as soon as you switch them. There is nothing to save."
581
+ >
582
+ {notificationGroups.map((group) => (
583
+ <Fieldset key={group.id} className="gap-0">
584
+ <FieldsetLegend className="mb-3">{group.legend}</FieldsetLegend>
585
+ {notificationRows
586
+ .filter((row) => row.group === group.id)
587
+ .map((row) => (
588
+ <Field
589
+ key={row.id}
590
+ className="flex-row items-center justify-between gap-6 border-t border-border/60 py-4 last:border-b"
591
+ >
592
+ <div className="flex flex-col gap-1">
593
+ <FieldLabel>{row.label}</FieldLabel>
594
+ <FieldDescription>{row.description}</FieldDescription>
595
+ </div>
596
+ <Switch
597
+ checked={notifications[row.id]}
598
+ onCheckedChange={(checked) => toggleNotification(row, checked)}
599
+ nativeButton
600
+ render={<button type="button" />}
601
+ />
602
+ </Field>
603
+ ))}
604
+ </Fieldset>
605
+ ))}
606
+ </SettingsSection>
607
+ </TabsPanel>
608
+
609
+ <TabsPanel value="security">
610
+ <SettingsSection
611
+ title="Password"
612
+ description="Change it whenever you think someone else may know it."
613
+ >
614
+ <div className="flex flex-wrap items-center justify-between gap-x-6 gap-y-3">
615
+ <Text size="sm" tone="soft">
616
+ Last changed on 12 June 2026.
617
+ </Text>
618
+ <Button
619
+ type="button"
620
+ variant="secondary"
621
+ onClick={() =>
622
+ toast("Check your email", {
623
+ description: `We sent a link to set a new password to ${profile.saved.email}.`,
624
+ })
625
+ }
626
+ >
627
+ Change password
628
+ </Button>
629
+ </div>
630
+ </SettingsSection>
631
+
632
+ <SettingsSection
633
+ title="Two-step sign-in"
634
+ description="A code from your phone as well as your password, on a device you have not used before."
635
+ >
636
+ <Field className="flex-row items-center justify-between gap-6">
637
+ <div className="flex flex-col gap-1">
638
+ <FieldLabel>Ask for a code</FieldLabel>
639
+ <FieldDescription>From an authenticator app. It applies at once.</FieldDescription>
640
+ </div>
641
+ <Switch
642
+ checked={twoStep}
643
+ onCheckedChange={(checked) => {
644
+ setTwoStep(checked);
645
+ toast(`Two-step sign-in turned ${checked ? "on" : "off"}.`);
646
+ }}
647
+ nativeButton
648
+ render={<button type="button" />}
649
+ />
650
+ </Field>
651
+ </SettingsSection>
652
+
653
+ <SettingsSection
654
+ headingId={`${devicesId}-heading`}
655
+ title="Devices"
656
+ description="Where this account is signed in. Sign out of a device you no longer use or do not recognise."
657
+ >
658
+ <ItemGroup render={<ul />} aria-label="Signed-in devices" className="gap-0">
659
+ {sessions.map((session, i) => (
660
+ <React.Fragment key={session.id}>
661
+ {i > 0 && <ItemSeparator />}
662
+ <Item render={<li />} size="sm" className="px-0">
663
+ <ItemMedia variant="icon">
664
+ <session.icon />
665
+ </ItemMedia>
666
+ <ItemContent>
667
+ <ItemTitle>
668
+ {session.device}
669
+ {session.current && <Tag variant="muted">This device</Tag>}
670
+ </ItemTitle>
671
+ <ItemDescription>
672
+ {session.place} · {session.seen}
673
+ </ItemDescription>
674
+ </ItemContent>
675
+ {!session.current && (
676
+ <ItemActions>
677
+ <Button
678
+ type="button"
679
+ variant="ghost"
680
+ size="sm"
681
+ id={`${devicesId}-${session.id}`}
682
+ aria-label={`Sign out of ${session.device}`}
683
+ onClick={() => signOut([session.id])}
684
+ >
685
+ Sign out
686
+ </Button>
687
+ </ItemActions>
688
+ )}
689
+ </Item>
690
+ </React.Fragment>
691
+ ))}
692
+ </ItemGroup>
693
+ {sessions.length > 1 && (
694
+ <Button
695
+ type="button"
696
+ variant="secondary"
697
+ className="self-start"
698
+ onClick={() =>
699
+ signOut(sessions.filter((session) => !session.current).map((session) => session.id))
700
+ }
701
+ >
702
+ Sign out of other devices
703
+ </Button>
704
+ )}
705
+ </SettingsSection>
706
+ </TabsPanel>
707
+ </Tabs>
708
+ </div>
709
+ );
710
+ }
711
+ ```
712
+
713
+ Profile, Workspace, Notifications and Security under underline tabs, each pane in hairline sections (title left, fields right, stacking when narrow). Edit a field and "Save changes" wakes; save and a toast confirms; switches and member roles apply at once. Security changes the password by emailed link, toggles two-step sign-in and lists signed-in devices with Sign out. Saving is faked.
714
+
715
+ ## Usage
716
+
717
+ - **`Tabs` with `TabsList variant="underline"`** — the panes of one page.
718
+ - **`Section` + `Form` / `FormActions`** — hairline groups, title beside fields, ending in one "Save changes".
719
+ - **`toast`** — confirms a save or a change, then goes away.
720
+
721
+ Keep saved values beside a draft and compare them for `dirty`; lift both above the tabs so an edit survives a pane switch (only the active `TabsPanel` is mounted).
722
+
723
+ ```tsx
724
+ import { Button, Field, FieldLabel, Form, FormActions, Input, Section, Tabs, TabsList, TabsPanel, TabsTab, Toaster, toast } from "@zonsh/ui";
725
+
726
+ <>
727
+ <Toaster />
728
+ <Tabs defaultValue="profile">
729
+ <TabsList variant="underline">
730
+ <TabsTab value="profile">Profile</TabsTab>
731
+ <TabsTab value="notifications">Notifications</TabsTab>
732
+ </TabsList>
733
+ <TabsPanel value="profile">
734
+ <Form onFormSubmit={() => save(draft).then(() => toast.success("Your profile is saved."))}>
735
+ <Section>
736
+ <Field name="name">
737
+ <FieldLabel>Name</FieldLabel>
738
+ <Input required value={draft.name} onValueChange={(name) => setDraft({ ...draft, name })} />
739
+ </Field>
740
+ </Section>
741
+ <FormActions>
742
+ <Button type="submit" disabled={!dirty} focusableWhenDisabled>
743
+ Save changes
744
+ </Button>
745
+ </FormActions>
746
+ </Form>
747
+ </TabsPanel>
748
+ <TabsPanel value="notifications">…</TabsPanel>
749
+ </Tabs>
750
+ </>;
751
+ ```
752
+
753
+ ## When to use
754
+
755
+ - Profile, workspace and notification settings. Fields that belong together save together; switches apply when flipped.
756
+ - One or two preferences: a `Switch` or `Select` beside what it changes.
757
+ - Sections with their own pages (Billing, Team): `Sidebar` navigation, not tabs.
758
+
759
+ ## The parts
760
+
761
+ | Part | Page | Job |
762
+ | ------------------------------------------ | ------------- | -------------------------------------------------------------------- |
763
+ | `Tabs` with `TabsList variant="underline"` | Tabs | Switches between the panes of the page |
764
+ | `Section` | Layout | One hairline-ruled group: a title and description beside its fields |
765
+ | `Form`, `FormActions` | Form | Validates the fields and ends in the save row, primary on the right |
766
+ | `Field`, `Input`, `Textarea` | Field | Name, email and bio, each with a label, a description and an error |
767
+ | `InputGroup` | Input Group | The workspace address, with its fixed prefix in mono |
768
+ | `Avatar` | Avatar | The photo, with initials until one is picked |
769
+ | `Select` | Select | Interface language and workspace time zone |
770
+ | `Fieldset`, `Switch` | Field, Switch | Notification rows under mono legends, each applied as it flips |
771
+ | `Item`, `Tag` | Item, Tag | Members with their role, and the signed-in devices, "This device" marked |
772
+ | `Spinner` | Spinner | Shows inside the button while a save or a delete runs |
773
+ | `Toaster`, `toast` | Toast | Confirms a save or a change, then goes away |
774
+ | `AlertDialog` | Alert Dialog | Asks before the workspace is deleted, with two clearly named choices |
775
+
776
+ ## Brand rules
777
+
778
+ - **Do** keep one primary per pane: "Save changes". Discard is `ghost`; the delete trigger and its confirm are `destructive`, never `primary`.
779
+ - **Do** keep "Save changes" disabled until something changed, and `focusableWhenDisabled` so focus stays while it saves. Never use it to point out errors: let people submit and show the `FieldError`.
780
+ - **Do** group with hairlines and whitespace; only the alert dialog is a card.
781
+ - **Do** write plain-noun labels and descriptions of what the setting does: "Where we send sign-in links and the emails you choose."
782
+ - **Don't** put a switch in a form that needs "Save changes"; use a `Checkbox`.
783
+ - **Don't** colour the danger zone; destructive ink on the button and the confirmation are enough.
784
+
785
+ ## Accessibility
786
+
787
+ - The tabs are a real `tablist`, arrow keys move between them, and each pane is a `tabpanel` named by its tab.
788
+ - Every control has a visible label; descriptions and errors are linked through `aria-describedby`. On an invalid submit, focus moves to the first invalid field.
789
+ - The note beside the save row is `role="status"`, so "You have unsaved changes" is announced. While saving, the button is `aria-busy` and its spinner names what is being saved.
790
+ - Each notification row is a labelled `switch` with its description attached. The photo picker opens from a real button; the file input behind it is hidden.
791
+ - Each role picker is named for its member ("Role for Sam Okoro"), each Sign out for its device ("Sign out of Safari on iPhone"). Changes are confirmed in a toast.
792
+ - Signing out removes the focused row, so focus moves to the next device's Sign out, the previous one at the end, or the "Devices" heading (`tabIndex={-1}`) — never the page.
793
+ - The alert dialog cannot be dismissed by clicking outside. While the delete runs, Escape and "Keep workspace" do nothing, so nobody leaves halfway through.