@zonsh/ui 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,268 @@
1
+ # Action Sheet
2
+
3
+ ```tsx
4
+ import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button, Eyebrow, Heading } from "@zonsh/ui";
5
+ import { EllipsisIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ /**
9
+ * A phone-sized screen. Its layout containment makes it the box a sheet's fixed backdrop and
10
+ * viewport fill, so the sheet opens inside the screen rather than across the docs page.
11
+ */
12
+ function Phone({
13
+ label,
14
+ screen,
15
+ children,
16
+ }: {
17
+ label: string;
18
+ screen: React.RefObject<HTMLDivElement | null>;
19
+ children: React.ReactNode;
20
+ }) {
21
+ return (
22
+ <div
23
+ ref={screen}
24
+ className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge [contain:layout_paint]"
25
+ >
26
+ <div role="region" aria-label={label} className="h-full overflow-y-auto px-5 pt-8">
27
+ {children}
28
+ </div>
29
+ </div>
30
+ );
31
+ }
32
+
33
+ const photos = [
34
+ { name: "Harbour at dawn", meta: "IMG_2041 · 4.2 MB" },
35
+ { name: "Market in Ribeira", meta: "IMG_2057 · 3.8 MB" },
36
+ { name: "Tram 28", meta: "IMG_2063 · 5.1 MB" },
37
+ ];
38
+
39
+ export function Basic() {
40
+ const screen = React.useRef<HTMLDivElement>(null);
41
+ const [done, setDone] = React.useState("");
42
+ const toast = (words: string) => setDone(words);
43
+ return (
44
+ <Phone label="Photos screen" screen={screen}>
45
+ <Eyebrow>Album</Eyebrow>
46
+ <Heading level={3} className="mt-2">
47
+ Porto, October
48
+ </Heading>
49
+ <ul className="mt-6">
50
+ {photos.map((photo) => (
51
+ <li
52
+ key={photo.name}
53
+ className="flex items-center justify-between gap-3 border-t border-border/60 py-3 last:border-b"
54
+ >
55
+ <div className="min-w-0">
56
+ <p className="truncate text-15">{photo.name}</p>
57
+ <p className="mt-0.5 font-mono text-11 text-muted-foreground">{photo.meta}</p>
58
+ </div>
59
+ <ActionSheet presentation="sheet">
60
+ <ActionSheetTrigger
61
+ render={<Button variant="ghost" size="icon-sm" aria-label={`Options for ${photo.name}`} />}
62
+ >
63
+ <EllipsisIcon />
64
+ </ActionSheetTrigger>
65
+ <ActionSheetContent
66
+ portal={{ container: screen }}
67
+ title={photo.name}
68
+ description="Deleted photos stay in Recently deleted for 30 days."
69
+ >
70
+ <ActionSheetAction onClick={() => toast("Link copied")}>Share link</ActionSheetAction>
71
+ <ActionSheetAction onClick={() => toast("Duplicated")}>Duplicate</ActionSheetAction>
72
+ <ActionSheetAction onClick={() => toast("Moved to Favourites")}>
73
+ Move to Favourites
74
+ </ActionSheetAction>
75
+ <ActionSheetAction variant="destructive" onClick={() => toast("Photo deleted")}>
76
+ Delete photo
77
+ </ActionSheetAction>
78
+ </ActionSheetContent>
79
+ </ActionSheet>
80
+ </li>
81
+ ))}
82
+ </ul>
83
+ <p className="mt-4 text-13 text-muted-foreground" aria-live="polite">
84
+ {done}
85
+ </p>
86
+ </Phone>
87
+ );
88
+ }
89
+ ```
90
+
91
+ The choices for one thing — a photo, a message, a file — rising from the bottom of a phone screen where the thumb already is. A 20px card in the menu material holds an optional title and one sentence about what happens, then the actions, each a full-width 46px row with its label centred; apart from it, a second card holds Cancel. It sits 8px in from the screen's edges and above the home indicator.
92
+
93
+ The choices run edge to edge across their card, nothing inset: a choice's highlight fills the card's width, square where two choices meet and following the card's 20px corners at its top and bottom. The Cancel card is the button itself, so its highlight and its focus ring are the card's own shape. A choice lights up under the finger the moment it lands, a shade of its own ink (the destructive one deepens its red), and its card gives a little, to 98.5%, springing back when let go; Cancel does the same. Under reduced motion only the shade shows.
94
+
95
+ It is a Base UI Drawer underneath: it slides up over 300ms, follows the finger 1:1 when swiped down and closes past a flick, and the backdrop lightens as it goes. Escape, a tap on the backdrop, Cancel or any action closes it, and focus goes back to what opened it.
96
+
97
+ **On a desktop it is a dialog.** `presentation="auto"` (the default) shows the sheet on a phone — a coarse pointer under 768px — and the same two cards as a small centred dialog everywhere else. A sheet stuck to the bottom of a wide window is far from the pointer that opened it. A `Menu` was the other candidate; it was not chosen because a menu is anchored to its trigger and reads its items as menu items with arrow-key focus only, while an action sheet's title and message must be read, and the same content and focus order should hold in both forms.
98
+
99
+ ## When to use
100
+
101
+ - Two to six actions on one thing, on a phone, where the thing's own screen has no room for them: Share, Duplicate, Move, Delete.
102
+ - Confirming a destructive action that has a gentler alternative ("Pause until January" or "Leave the course").
103
+ - A pointer on a desktop, near the trigger: a `Menu`. A yes-or-no confirmation with nothing else: an `AlertDialog`.
104
+ - Anything to fill in or read at length: a `Drawer`.
105
+
106
+ ## Usage
107
+
108
+ ```tsx
109
+ import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button } from "@zonsh/ui";
110
+
111
+ <ActionSheet>
112
+ <ActionSheetTrigger render={<Button variant="secondary" />}>Manage file</ActionSheetTrigger>
113
+ <ActionSheetContent title="quarterly-plan.pdf">
114
+ <ActionSheetAction onClick={share}>Share</ActionSheetAction>
115
+ <ActionSheetAction onClick={duplicate}>Make a copy</ActionSheetAction>
116
+ <ActionSheetAction variant="destructive" onClick={remove}>
117
+ Delete
118
+ </ActionSheetAction>
119
+ </ActionSheetContent>
120
+ </ActionSheet>;
121
+ ```
122
+
123
+ An action closes the sheet after its `onClick`; call `event.preventDefault()` there to keep it open. Cancel is added for you.
124
+
125
+ ## Examples
126
+
127
+ ### Auto
128
+
129
+ A sheet on a phone, a small dialog here. Icons go before every label or none.
130
+
131
+ ```tsx
132
+ import { ActionSheet, ActionSheetAction, ActionSheetContent, ActionSheetTrigger, Button } from "@zonsh/ui";
133
+ import { CopyIcon, FolderInputIcon, ShareIcon, Trash2Icon } from "lucide-react";
134
+ import * as React from "react";
135
+
136
+ export function Auto() {
137
+ const [done, setDone] = React.useState("");
138
+ const toast = (words: string) => setDone(words);
139
+ return (
140
+ <div className="flex flex-col items-start gap-3">
141
+ <ActionSheet>
142
+ <ActionSheetTrigger render={<Button variant="secondary" />}>Manage file</ActionSheetTrigger>
143
+ <ActionSheetContent title="quarterly-plan.pdf">
144
+ <ActionSheetAction icon={<ShareIcon />} onClick={() => toast("Share sheet opened")}>
145
+ Share
146
+ </ActionSheetAction>
147
+ <ActionSheetAction icon={<CopyIcon />} onClick={() => toast("Copy made")}>
148
+ Make a copy
149
+ </ActionSheetAction>
150
+ <ActionSheetAction icon={<FolderInputIcon />} onClick={() => toast("Moved to Archive")}>
151
+ Move to Archive
152
+ </ActionSheetAction>
153
+ <ActionSheetAction variant="destructive" icon={<Trash2Icon />} onClick={() => toast("File deleted")}>
154
+ Delete
155
+ </ActionSheetAction>
156
+ </ActionSheetContent>
157
+ </ActionSheet>
158
+ <p className="text-13 text-muted-foreground" aria-live="polite">
159
+ {done}
160
+ </p>
161
+ </div>
162
+ );
163
+ }
164
+ ```
165
+
166
+ ### Controlled
167
+
168
+ `open` and `onOpenChange` open it from anywhere — after a swipe, a long press, or as here, a plain button.
169
+
170
+ ```tsx
171
+ import { ActionSheet, ActionSheetAction, ActionSheetContent, Button } from "@zonsh/ui";
172
+ import * as React from "react";
173
+
174
+ export function Controlled() {
175
+ const [open, setOpen] = React.useState(false);
176
+ const [choice, setChoice] = React.useState("Nothing chosen yet.");
177
+ return (
178
+ <div className="flex flex-col items-start gap-3">
179
+ <Button variant="secondary" onClick={() => setOpen(true)}>
180
+ Leave the course
181
+ </Button>
182
+ <p className="text-13 text-muted-foreground" aria-live="polite">
183
+ {choice}
184
+ </p>
185
+ <ActionSheet open={open} onOpenChange={setOpen}>
186
+ <ActionSheetContent
187
+ title="Leave Watercolour basics?"
188
+ description="Your sketches stay in your library; your place in the class goes to the waiting list."
189
+ >
190
+ <ActionSheetAction onClick={() => setChoice("Paused until January.")}>
191
+ Pause until January
192
+ </ActionSheetAction>
193
+ <ActionSheetAction variant="destructive" onClick={() => setChoice("You left the course.")}>
194
+ Leave the course
195
+ </ActionSheetAction>
196
+ </ActionSheetContent>
197
+ </ActionSheet>
198
+ </div>
199
+ );
200
+ }
201
+ ```
202
+
203
+ ### Inside a preview
204
+
205
+ A sheet's backdrop and viewport are fixed to the screen. In a phone-sized preview, render it into the preview with `portal={{ container }}` and give the preview `contain: layout paint`, so the sheet fills the preview instead of the window — as the first example does.
206
+
207
+ ## Props
208
+
209
+ ### ActionSheet
210
+
211
+ | Prop | Type | Default | Notes |
212
+ | ---------------------- | ------------------------------- | -------- | ----------------------------------------------------------------- |
213
+ | `open` | `boolean` | — | Controlled. |
214
+ | `defaultOpen` | `boolean` | `false` | Uncontrolled. |
215
+ | `onOpenChange` | `(open, eventDetails?) => void` | — | Opening and closing, by any means. |
216
+ | `onOpenChangeComplete` | `(open: boolean) => void` | — | After the motion has finished. |
217
+ | `presentation` | `"auto" \| "sheet" \| "dialog"` | `"auto"` | A sheet on a phone and a dialog elsewhere, or always one of them. |
218
+ | `children` | `ReactNode` | — | The trigger and the content. |
219
+
220
+ ### ActionSheetContent
221
+
222
+ | Prop | Type | Default | Notes |
223
+ | ------------- | ------------------------------ | ------- | ---------------------------------------------------------------------------------- |
224
+ | `title` | `ReactNode` | — | What the actions act on, one short line. The sheet's name. |
225
+ | `description` | `ReactNode` | — | One sentence on what happens. |
226
+ | `cancel` | `boolean` | `true` | The separate Cancel card. |
227
+ | `labels` | `Partial<ActionSheetMessages>` | — | `cancel` ("Cancel"), and `actions` ("Actions"), the name without a title. |
228
+ | `portal` | `{ container?, keepMounted? }` | — | Where it renders: a preview's element, say. |
229
+ | `dir` | `string` | — | The popup's direction; inside a right-to-left `DirectionProvider` it follows that. |
230
+
231
+ ### ActionSheetAction
232
+
233
+ | Prop | Type | Default | Notes |
234
+ | -------------- | ---------------------------- | ----------- | ----------------------------------------------------- |
235
+ | `variant` | `"default" \| "destructive"` | `"default"` | The destructive ink, for the one action that deletes. |
236
+ | `icon` | `ReactNode` | — | A lucide icon before the label. |
237
+ | `closeOnClick` | `boolean` | `true` | Closes the sheet after `onClick`. |
238
+
239
+ Every other prop goes to the `<button>`. `ActionSheetTrigger` takes Base UI's trigger props, `render` among them.
240
+
241
+ ## Brand rules
242
+
243
+ - **Do** name each action by what it does to the thing ("Delete photo", "Move to Favourites"), with at most one destructive, last before Cancel.
244
+ - **Do** keep the title to what the sheet is about and the message to one sentence; no headline, no icon in the header.
245
+ - **Don't** put a primary button in a sheet, colour a row, or add a fill: the menu material and the destructive ink are the only marks.
246
+ - **Don't** reach for it for more than six actions, or for settings: that is a screen of its own or a `Drawer`.
247
+
248
+ ## Accessibility
249
+
250
+ - A modal dialog named by its `title` (or "Actions"), described by its `description`. Focus moves to the first action when it opens, stays inside while it is open, and returns to the trigger when it closes.
251
+ - Actions are buttons in reading order; the destructive one says what it destroys in words, not only in red.
252
+ - Swiping down is never the only way out: Cancel, Escape and the backdrop close it too.
253
+ - Under reduced motion the sheet and the dialog fade in place instead of travelling.
254
+
255
+ ### Keyboard
256
+
257
+ | Key | What it does |
258
+ | --------------- | ----------------------------------------------- |
259
+ | Enter / Space | On the trigger, opens it; on an action, runs it |
260
+ | Tab / Shift+Tab | Moves through the actions and Cancel, inside it |
261
+ | Arrow Down / Up | Moves to the next or previous action, wrapping |
262
+ | Escape | Closes it without choosing |
263
+
264
+ ---
265
+
266
+ - Import: `import { ActionSheet, ActionSheetTrigger, ActionSheetContent, ActionSheetAction } from "@zonsh/ui"`
267
+ - Source: `packages/ui/src/components/action-sheet.tsx`
268
+ - Primitive: `@base-ui/react/drawer` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/drawer.md`)
@@ -0,0 +1,276 @@
1
+ # Alert Dialog
2
+
3
+ ```tsx
4
+ import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
5
+
6
+ export function Destructive() {
7
+ return (
8
+ <AlertDialog>
9
+ <AlertDialogTrigger render={<Button variant="destructive" />}>Remove integration</AlertDialogTrigger>
10
+ <AlertDialogContent>
11
+ <AlertDialogHeader>
12
+ <AlertDialogTitle>Remove this integration?</AlertDialogTitle>
13
+ <AlertDialogDescription>
14
+ Events will stop syncing from your calendar. Events already imported stay where they are.
15
+ </AlertDialogDescription>
16
+ </AlertDialogHeader>
17
+ <AlertDialogFooter>
18
+ <AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
19
+ <AlertDialogClose render={<Button variant="destructive" />}>Remove integration</AlertDialogClose>
20
+ </AlertDialogFooter>
21
+ </AlertDialogContent>
22
+ </AlertDialog>
23
+ );
24
+ }
25
+ ```
26
+
27
+ A `Dialog` for a decision someone must make before going on. It is announced as an alert, ignores outside clicks and has no close button: the footer holds the two answers.
28
+
29
+ ## Usage
30
+
31
+ ```tsx
32
+ import {
33
+ AlertDialog,
34
+ AlertDialogClose,
35
+ AlertDialogContent,
36
+ AlertDialogDescription,
37
+ AlertDialogFooter,
38
+ AlertDialogHeader,
39
+ AlertDialogTitle,
40
+ AlertDialogTrigger,
41
+ Button,
42
+ } from "@zonsh/ui";
43
+
44
+ <AlertDialog>
45
+ <AlertDialogTrigger render={<Button variant="destructive" />}>Remove integration</AlertDialogTrigger>
46
+ <AlertDialogContent>
47
+ <AlertDialogHeader>
48
+ <AlertDialogTitle>Remove this integration?</AlertDialogTitle>
49
+ <AlertDialogDescription>Events will stop syncing.</AlertDialogDescription>
50
+ </AlertDialogHeader>
51
+ <AlertDialogFooter>
52
+ <AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
53
+ <AlertDialogClose render={<Button variant="destructive" />} onClick={remove}>
54
+ Remove integration
55
+ </AlertDialogClose>
56
+ </AlertDialogFooter>
57
+ </AlertDialogContent>
58
+ </AlertDialog>;
59
+ ```
60
+
61
+ The props you'll reach for: `open` / `onOpenChange` on `AlertDialog`, `render` on `AlertDialogClose`, `size` on `AlertDialogContent`.
62
+
63
+ ## When to use
64
+
65
+ - Confirming what cannot be undone: "Remove this integration?", "Delete workspace?".
66
+ - Leaving with unsaved work: "Save your changes first?".
67
+ - Not for information (a toast or inline message) or tasks with fields (`Dialog`).
68
+
69
+ ## Examples
70
+
71
+ ### Unsaved changes
72
+
73
+ Control `open` when the confirm does work before closing.
74
+
75
+ ```tsx
76
+ import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
77
+ import * as React from "react";
78
+
79
+ export function UnsavedChanges() {
80
+ const [open, setOpen] = React.useState(false);
81
+ const [saved, setSaved] = React.useState(false);
82
+ return (
83
+ <div className="flex items-center gap-4">
84
+ <AlertDialog open={open} onOpenChange={setOpen}>
85
+ <AlertDialogTrigger render={<Button variant="secondary" />}>Leave editor</AlertDialogTrigger>
86
+ <AlertDialogContent>
87
+ <AlertDialogHeader>
88
+ <AlertDialogTitle>Save your changes first?</AlertDialogTitle>
89
+ <AlertDialogDescription>
90
+ You edited the chapter draft. If you leave now, those edits are lost.
91
+ </AlertDialogDescription>
92
+ </AlertDialogHeader>
93
+ <AlertDialogFooter>
94
+ <AlertDialogClose render={<Button variant="secondary" />}>Discard edits</AlertDialogClose>
95
+ <Button
96
+ onClick={() => {
97
+ setSaved(true);
98
+ setOpen(false);
99
+ }}
100
+ >
101
+ Save and leave
102
+ </Button>
103
+ </AlertDialogFooter>
104
+ </AlertDialogContent>
105
+ </AlertDialog>
106
+ {saved && <span className="text-sm text-muted-foreground">Your changes are saved.</span>}
107
+ </div>
108
+ );
109
+ }
110
+ ```
111
+
112
+ ### Pending confirm
113
+
114
+ When the confirm can fail, keep the dialog open until it settles: the confirm takes `loading`, the other choice is disabled and Escape waits. On failure, say what to do in a `role="alert"` line and keep both choices; close only on success.
115
+
116
+ ```tsx
117
+ import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
118
+ import { CircleAlertIcon } from "lucide-react";
119
+ import * as React from "react";
120
+
121
+ const DELETE_LATENCY = 800;
122
+
123
+ /**
124
+ * The confirm does work before it closes: it shows a spinner, the dialog holds while it runs, and a
125
+ * failure is said in the dialog, which stays open so the person can try again or keep the page.
126
+ * Here the first attempt fails and the second goes through.
127
+ */
128
+ export function Pending() {
129
+ const [open, setOpen] = React.useState(false);
130
+ const [pending, setPending] = React.useState(false);
131
+ const [error, setError] = React.useState<string | null>(null);
132
+ const [deleted, setDeleted] = React.useState(false);
133
+ const attempts = React.useRef(0);
134
+ const timer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
135
+ React.useEffect(() => () => clearTimeout(timer.current), []);
136
+
137
+ const remove = () => {
138
+ setPending(true);
139
+ setError(null);
140
+ timer.current = setTimeout(() => {
141
+ setPending(false);
142
+ attempts.current += 1;
143
+ if (attempts.current === 1) {
144
+ setError("The page couldn't be deleted: the connection dropped. Try again.");
145
+ return;
146
+ }
147
+ setOpen(false);
148
+ setDeleted(true);
149
+ }, DELETE_LATENCY);
150
+ };
151
+
152
+ return (
153
+ <div className="flex items-center gap-4">
154
+ <AlertDialog
155
+ open={open}
156
+ onOpenChange={(next) => {
157
+ // While the delete runs, Escape does not close the dialog: its answer is still to come.
158
+ if (pending) return;
159
+ setOpen(next);
160
+ if (next) setError(null);
161
+ }}
162
+ >
163
+ <AlertDialogTrigger render={<Button variant="destructive" />}>Delete page</AlertDialogTrigger>
164
+ <AlertDialogContent>
165
+ <AlertDialogHeader>
166
+ <AlertDialogTitle>Delete “Spring catalogue”?</AlertDialogTitle>
167
+ <AlertDialogDescription>
168
+ The page and its 14 product cards are deleted for everyone. The products themselves stay in the
169
+ shop.
170
+ </AlertDialogDescription>
171
+ </AlertDialogHeader>
172
+ {error && (
173
+ <p role="alert" className="m-0 flex items-start gap-2 text-sm text-destructive">
174
+ <CircleAlertIcon aria-hidden className="mt-0.5 size-4 shrink-0" />
175
+ {error}
176
+ </p>
177
+ )}
178
+ <AlertDialogFooter>
179
+ <AlertDialogClose render={<Button variant="secondary" />} disabled={pending}>
180
+ Keep page
181
+ </AlertDialogClose>
182
+ <Button variant="destructive" loading={pending} loadingLabel="Deleting page" onClick={remove}>
183
+ Delete page
184
+ </Button>
185
+ </AlertDialogFooter>
186
+ </AlertDialogContent>
187
+ </AlertDialog>
188
+ {deleted && (
189
+ <span role="status" className="text-sm text-muted-foreground">
190
+ “Spring catalogue” is deleted.
191
+ </span>
192
+ )}
193
+ </div>
194
+ );
195
+ }
196
+ ```
197
+
198
+ ### Sizes
199
+
200
+ `sm` fits most questions; `lg` and `xl` show what a confirmation affects. On mobile every size is full width minus a 16px gutter.
201
+
202
+ ```tsx
203
+ import { AlertDialog, AlertDialogClose, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, Button } from "@zonsh/ui";
204
+
205
+ const alertSizes = [
206
+ { size: "sm", width: "416px" },
207
+ { size: "default", width: "512px" },
208
+ { size: "lg", width: "704px" },
209
+ { size: "xl", width: "896px" },
210
+ ] as const;
211
+
212
+ export function Sizes() {
213
+ return (
214
+ <div className="flex flex-wrap gap-3">
215
+ {alertSizes.map(({ size, width }) => (
216
+ <AlertDialog key={size}>
217
+ <AlertDialogTrigger render={<Button variant="secondary" />}>{size}</AlertDialogTrigger>
218
+ <AlertDialogContent size={size}>
219
+ <AlertDialogHeader>
220
+ <AlertDialogTitle>Archive this project?</AlertDialogTitle>
221
+ <AlertDialogDescription>
222
+ Its pages, notes and files move to the archive and stay readable. This dialog uses size "
223
+ {size}" ({width}).
224
+ </AlertDialogDescription>
225
+ </AlertDialogHeader>
226
+ <AlertDialogFooter>
227
+ <AlertDialogClose render={<Button variant="secondary" />}>Keep it</AlertDialogClose>
228
+ <AlertDialogClose render={<Button />}>Archive project</AlertDialogClose>
229
+ </AlertDialogFooter>
230
+ </AlertDialogContent>
231
+ </AlertDialog>
232
+ ))}
233
+ </div>
234
+ );
235
+ }
236
+ ```
237
+
238
+ ## Props
239
+
240
+ | Prop | Type | Default |
241
+ | ---------------------------------- | ------------------------------------------------------------- | ------- |
242
+ | `AlertDialog.open` / `defaultOpen` | `boolean` | — |
243
+ | `AlertDialog.onOpenChange` | `(open, details) => void` | — |
244
+ | `AlertDialogContent.size` | `"sm" \| "default" \| "lg" \| "xl"` (416 / 512 / 704 / 896px) | `"sm"` |
245
+ | `AlertDialogContent.portal` | `AlertDialog.Portal` props | — |
246
+ | `AlertDialogClose.render` | element, e.g. `<Button variant="secondary" />` | — |
247
+
248
+ `AlertDialog` is Base UI `AlertDialog.Root`; its props are forwarded. `AlertDialogContent` renders Portal → Backdrop → Viewport → Popup with `role="alertdialog"`.
249
+
250
+ ## Brand rules
251
+
252
+ - **Do** phrase the title as the question, and name the action in the button: "Remove integration", never "OK" or "Yes".
253
+ - **Do** say concretely what is lost and what is kept.
254
+ - **Do** use `destructive` only when something is really destroyed; red is a status colour, never emphasis.
255
+ - **Don't** add icons, illustrations or a coloured header for urgency. The interruption is the urgency.
256
+ - **Don't** stack an alert dialog on a toast; if it needs confirming, it isn't a toast.
257
+
258
+ ## Accessibility
259
+
260
+ - `role="alertdialog"`, labelled by `AlertDialogTitle` and described by `AlertDialogDescription`.
261
+ - Focus moves to the first button (the safe choice — put cancel first in the markup) and is trapped.
262
+ - Outside presses do not dismiss it, so a stray tap cannot answer the question.
263
+
264
+ ### Keyboard
265
+
266
+ | Key | What it does |
267
+ | --------------- | -------------------------------------------------------------------- |
268
+ | Enter / Space | Opens the dialog from its trigger, or presses the focused button |
269
+ | Tab / Shift+Tab | Moves between the two choices; focus stays inside the dialog |
270
+ | Escape | Closes the dialog without an answer and returns focus to the trigger |
271
+
272
+ ---
273
+
274
+ - Import: `import { AlertDialog, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogClose } from "@zonsh/ui"`
275
+ - Source: `packages/ui/src/components/alert-dialog.tsx`
276
+ - Primitive: `@base-ui/react/alert-dialog` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/alert-dialog.md`)