@zonsh/ui 0.5.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (559) hide show
  1. package/CHANGELOG.md +643 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +6 -6
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -0,0 +1,335 @@
1
+ # Dialog
2
+
3
+ ```tsx
4
+ import { Button, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Dialog>
9
+ <DialogTrigger render={<Button variant="secondary" />}>Share album</DialogTrigger>
10
+ <DialogContent>
11
+ <DialogHeader>
12
+ <DialogTitle>Share this album</DialogTitle>
13
+ <DialogDescription>
14
+ Anyone with the link can view the 48 photos in "Lisbon, May". They can download them, but not edit
15
+ or delete anything.
16
+ </DialogDescription>
17
+ </DialogHeader>
18
+ <DialogFooter>
19
+ <DialogClose render={<Button variant="secondary" />}>Not now</DialogClose>
20
+ <DialogClose render={<Button />}>Copy link</DialogClose>
21
+ </DialogFooter>
22
+ </DialogContent>
23
+ </Dialog>
24
+ );
25
+ }
26
+ ```
27
+
28
+ A focused task on top of the page: a Licht title, a sentence or two, actions, and a round close button in the corner. A dialog is an **object**: card geometry (20px corners, `--field-edge` border, 160° gradient, inset highlight) plus the menu float shadow, over a plain `black/40` backdrop (`black/60` dark), no blur. It fades and scales from 0.97 over 150ms.
29
+
30
+ ## Usage
31
+
32
+ ```tsx
33
+ import {
34
+ Button,
35
+ Dialog,
36
+ DialogClose,
37
+ DialogContent,
38
+ DialogDescription,
39
+ DialogFooter,
40
+ DialogHeader,
41
+ DialogTitle,
42
+ DialogTrigger,
43
+ } from "@zonsh/ui";
44
+
45
+ <Dialog>
46
+ <DialogTrigger render={<Button variant="secondary" />}>Share album</DialogTrigger>
47
+ <DialogContent>
48
+ <DialogHeader>
49
+ <DialogTitle>Share this album</DialogTitle>
50
+ <DialogDescription>Anyone with the link can view the photos.</DialogDescription>
51
+ </DialogHeader>
52
+ <DialogFooter>
53
+ <DialogClose render={<Button variant="secondary" />}>Not now</DialogClose>
54
+ <DialogClose render={<Button />}>Copy link</DialogClose>
55
+ </DialogFooter>
56
+ </DialogContent>
57
+ </Dialog>;
58
+ ```
59
+
60
+ The props you'll reach for: `open` / `onOpenChange` on `Dialog`, and `size` on `DialogContent`.
61
+
62
+ ## When to use
63
+
64
+ - A short task that keeps the page behind it: rename a project, share an album, edit a record.
65
+ - A detail view quicker to dismiss than to navigate back from.
66
+ - Not for confirmations — use `AlertDialog`. Not for panels with gestures — use `Drawer`. Not for long flows — give them a page.
67
+
68
+ ## Examples
69
+
70
+ ### With form
71
+
72
+ Control `open` to close after a submit. Put the `<form>` inside `DialogContent` with `className="contents"` so the dialog's layout still applies.
73
+
74
+ ```tsx
75
+ import { Button, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Field, FieldLabel, Input } from "@zonsh/ui";
76
+ import * as React from "react";
77
+
78
+ export function WithForm() {
79
+ const [open, setOpen] = React.useState(false);
80
+ return (
81
+ <Dialog open={open} onOpenChange={setOpen}>
82
+ <DialogTrigger render={<Button variant="secondary" />}>Rename project</DialogTrigger>
83
+ <DialogContent size="sm">
84
+ <form
85
+ className="contents"
86
+ onSubmit={(event) => {
87
+ event.preventDefault();
88
+ setOpen(false);
89
+ }}
90
+ >
91
+ <DialogHeader>
92
+ <DialogTitle>Rename this project</DialogTitle>
93
+ <DialogDescription>The new name shows up for everyone on your team.</DialogDescription>
94
+ </DialogHeader>
95
+ <Field>
96
+ <FieldLabel>Project name</FieldLabel>
97
+ <Input name="name" defaultValue="Marketing site" />
98
+ </Field>
99
+ <DialogFooter>
100
+ <DialogClose render={<Button variant="secondary" />}>Cancel</DialogClose>
101
+ <Button type="submit">Save name</Button>
102
+ </DialogFooter>
103
+ </form>
104
+ </DialogContent>
105
+ </Dialog>
106
+ );
107
+ }
108
+ ```
109
+
110
+ ### Form in a dialog
111
+
112
+ Past about four fields, use the width: the form in `DialogBody` as a `@container`, two columns when there is room (`grid gap-5 @md:grid-cols-2`), long fields across both (`@md:col-span-2`). The footer sits outside the `<form>`, so give the `Form` an `id` and the submit button `form="…"`; the actions stay in view while the body scrolls.
113
+
114
+ ```tsx
115
+ import { Button, Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Field, FieldDescription, FieldError, FieldLabel, Form, Input, NativeSelect, NativeSelectOption } from "@zonsh/ui";
116
+ import * as React from "react";
117
+
118
+ export function FormInDialog() {
119
+ const [open, setOpen] = React.useState(false);
120
+ return (
121
+ <Dialog open={open} onOpenChange={setOpen}>
122
+ <DialogTrigger render={<Button variant="secondary" />}>Add address</DialogTrigger>
123
+ <DialogContent>
124
+ <DialogHeader>
125
+ <DialogTitle>Add a delivery address</DialogTitle>
126
+ <DialogDescription>
127
+ Orders placed before 2 pm leave for this address the same day.
128
+ </DialogDescription>
129
+ </DialogHeader>
130
+ {/* The body is the container: two columns once it is wide enough, one on a phone. */}
131
+ <DialogBody className="@container">
132
+ <Form
133
+ id="delivery-address"
134
+ className="grid gap-5 @md:grid-cols-2"
135
+ onFormSubmit={() => setOpen(false)}
136
+ >
137
+ <Field name="name">
138
+ <FieldLabel>Full name</FieldLabel>
139
+ <Input required autoComplete="name" />
140
+ <FieldError match="valueMissing">Whose name goes on the label?</FieldError>
141
+ </Field>
142
+ <Field name="company">
143
+ <FieldLabel>Company (optional)</FieldLabel>
144
+ <Input autoComplete="organization" />
145
+ </Field>
146
+ <Field name="street" className="@md:col-span-2">
147
+ <FieldLabel>Street and number</FieldLabel>
148
+ <Input required autoComplete="address-line1" />
149
+ <FieldError match="valueMissing">We need a street to deliver to.</FieldError>
150
+ </Field>
151
+ <Field name="postcode">
152
+ <FieldLabel>Postcode</FieldLabel>
153
+ <Input required autoComplete="postal-code" />
154
+ <FieldError match="valueMissing">Add the postcode.</FieldError>
155
+ </Field>
156
+ <Field name="city">
157
+ <FieldLabel>City</FieldLabel>
158
+ <Input required autoComplete="address-level2" />
159
+ <FieldError match="valueMissing">Add the city.</FieldError>
160
+ </Field>
161
+ <Field name="country">
162
+ <FieldLabel>Country</FieldLabel>
163
+ <NativeSelect defaultValue="de" autoComplete="country">
164
+ <NativeSelectOption value="at">Austria</NativeSelectOption>
165
+ <NativeSelectOption value="de">Germany</NativeSelectOption>
166
+ <NativeSelectOption value="nl">Netherlands</NativeSelectOption>
167
+ <NativeSelectOption value="ch">Switzerland</NativeSelectOption>
168
+ </NativeSelect>
169
+ </Field>
170
+ <Field name="phone">
171
+ <FieldLabel>Phone (optional)</FieldLabel>
172
+ <Input type="tel" autoComplete="tel" />
173
+ <FieldDescription>Only for the courier, if they can't find you.</FieldDescription>
174
+ </Field>
175
+ </Form>
176
+ </DialogBody>
177
+ <DialogFooter>
178
+ <DialogClose render={<Button variant="secondary" />}>Cancel</DialogClose>
179
+ {/* Outside the <form>, so it names it: `form` submits the form by its id. */}
180
+ <Button type="submit" form="delivery-address">
181
+ Save address
182
+ </Button>
183
+ </DialogFooter>
184
+ </DialogContent>
185
+ </Dialog>
186
+ );
187
+ }
188
+ ```
189
+
190
+ ### Scrolling body
191
+
192
+ `DialogBody` scrolls between a fixed header and footer once the dialog reaches the viewport height; a `max-h` on `DialogContent` scrolls sooner.
193
+
194
+ ```tsx
195
+ import { Button, Dialog, DialogBody, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger } from "@zonsh/ui";
196
+
197
+ const sections = [
198
+ [
199
+ "Delivery times",
200
+ "Orders placed before 2 pm leave the warehouse the same day and usually arrive in two to four working days.",
201
+ ],
202
+ [
203
+ "Shipping costs",
204
+ "Shipping is calculated at checkout from the weight of the parcel and where it is going.",
205
+ ],
206
+ [
207
+ "Returns",
208
+ "Send anything back within 30 days, unused and in its original packaging. The return label is in the box.",
209
+ ],
210
+ ["Refunds", "We refund to the original payment method within five working days of the parcel arriving."],
211
+ [
212
+ "Damaged items",
213
+ "Send us a photo of the damage and we will replace the item or refund it, whichever you prefer.",
214
+ ],
215
+ ["Tracking", "You get a tracking link by email as soon as the parcel is handed to the carrier."],
216
+ ] as const;
217
+
218
+ export function ScrollingBody() {
219
+ return (
220
+ <Dialog>
221
+ <DialogTrigger render={<Button variant="secondary" />}>Shipping and returns</DialogTrigger>
222
+ {/* Capped, so the body scrolls on tall screens too; without it the dialog grows to the viewport.
223
+ `min(…, 100%)` keeps the cap from outgrowing a short screen (a phone on its side). */}
224
+ <DialogContent className="max-h-[min(32rem,100%)]">
225
+ <DialogHeader>
226
+ <DialogTitle>Shipping and returns</DialogTitle>
227
+ <DialogDescription>The header and footer stay put; the body scrolls.</DialogDescription>
228
+ </DialogHeader>
229
+ <DialogBody>
230
+ <div className="flex flex-col gap-6">
231
+ {[...sections, ...sections].map(([title, body], index) => (
232
+ <section key={index} className="flex flex-col gap-1">
233
+ <h3 className="m-0 font-body text-[15px] font-medium text-foreground">{title}</h3>
234
+ <p className="m-0">{body}</p>
235
+ </section>
236
+ ))}
237
+ </div>
238
+ </DialogBody>
239
+ <DialogFooter>
240
+ <DialogClose render={<Button />}>Got it</DialogClose>
241
+ </DialogFooter>
242
+ </DialogContent>
243
+ </Dialog>
244
+ );
245
+ }
246
+ ```
247
+
248
+ ### Sizes
249
+
250
+ Pick the size by the content. From 1280px each size but `sm` steps up.
251
+
252
+ | Size | Max width | For |
253
+ | --------- | ----------------------------------------------------- | ---------------------------------------------------------------- |
254
+ | `sm` | 416px | One field or a short message: rename, a single choice |
255
+ | `default` | 576px, 704px from 1280px | Most tasks: a short read, a form in two columns, a list of files |
256
+ | `lg` | 768px, 960px from 1280px | A table, a longer form, settings with several groups |
257
+ | `xl` | 960px, 1216px from 1280px | Side by side: a comparison, a preview next to its form |
258
+ | `full` | The screen but an 8px gutter, rounded like the others | A workspace: an editor, a reader, a gallery |
259
+
260
+ On phones every size but `full` is full width minus a 16px gutter. The description keeps a 640px measure. A `max-w-*` class replaces the size at every breakpoint.
261
+
262
+ ```tsx
263
+ import { Button, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger } from "@zonsh/ui";
264
+
265
+ export function Sizes() {
266
+ return (
267
+ <div className="flex flex-wrap gap-3">
268
+ {(["sm", "default", "lg", "xl", "full"] as const).map((size) => (
269
+ <Dialog key={size}>
270
+ <DialogTrigger render={<Button variant="secondary" />}>{size}</DialogTrigger>
271
+ <DialogContent size={size}>
272
+ <DialogHeader>
273
+ <DialogTitle>Your changes are saved.</DialogTitle>
274
+ <DialogDescription>This dialog uses size "{size}".</DialogDescription>
275
+ </DialogHeader>
276
+ </DialogContent>
277
+ </Dialog>
278
+ ))}
279
+ </div>
280
+ );
281
+ }
282
+ ```
283
+
284
+ ## On phones
285
+
286
+ A dialog stays a centred card on a phone, full width less a 16px gutter, and its body scrolls inside it. That suits a confirmation, a short message, a choice of two. A form or a task that wants the thumb — filters, a share sheet, an address — reads better as a bottom sheet: use a [`Drawer`](drawer.md) (`side="bottom"`) there, or both, a `Dialog` from `md` up and a `Drawer` below it. The close button takes a 44px tap area on a touch screen (`touch-target`); a dialog with fields keeps their 16px text, so the phone does not zoom in.
287
+
288
+ ## Props
289
+
290
+ | Prop | Type | Default |
291
+ | --------------------------------------------- | --------------------------------------------------------- | --------------- |
292
+ | `Dialog.open` / `defaultOpen` | `boolean` | — |
293
+ | `Dialog.onOpenChange` | `(open, details) => void` | — |
294
+ | `Dialog.modal` | `boolean \| "trap-focus"` | `true` |
295
+ | `DialogContent.size` | `"sm" \| "default" \| "lg" \| "xl" \| "full"` (see Sizes) | `"default"` |
296
+ | `DialogContent.showCloseButton` | `boolean` | `true` |
297
+ | `DialogContent.labels` | `{ close? }` — the close button's name | `"Close"` |
298
+ | `DialogContent.portal` | `Dialog.Portal` props (`container`, `keepMounted`) | — |
299
+ | `DialogContent.initialFocus` / `finalFocus` | ref, boolean or function | Base UI default |
300
+ | `DialogTrigger.render` / `DialogClose.render` | element to render as, e.g. `<Button />` | — |
301
+
302
+ `Dialog` is Base UI `Dialog.Root` with all its props (`handle`, `actionsRef`, `disablePointerDismissal`, …). `DialogContent` renders Portal → Backdrop → Viewport → Popup and forwards Popup props. The size sets `--dialog-width`. Data attributes: `data-size` on the popup, plus Base UI's `data-open`, `data-nested`, `data-starting-style`, `data-ending-style`.
303
+
304
+ The close button's name defaults to `messages.dialog.close`.
305
+
306
+ ## Brand rules
307
+
308
+ - **Do** pick the size by the content; past four fields, two columns.
309
+ - **Do** lead the title with the outcome: "Rename this project", not "Project settings".
310
+ - **Do** keep one primary in the footer; cancel is `secondary`.
311
+ - **Do** keep the card material; the `--field-edge` border ties the dialog to its inputs.
312
+ - **Don't** add a blur to the backdrop or a heavier shadow to the popup.
313
+ - **Don't** change the radius: dialogs are objects at 20px.
314
+ - **Don't** nest a dialog in a dialog for a confirmation — open an `AlertDialog`.
315
+
316
+ ## Accessibility
317
+
318
+ - Focus moves to the first tabbable element, is trapped, and returns to the trigger on close.
319
+ - `DialogTitle` labels and `DialogDescription` describes it; always render a title.
320
+ - Keep a visible close control inside (the corner button or a `DialogClose`) so touch screen-reader users can leave.
321
+ - Every focusable element keeps the flush 2px `--control-focus` outline.
322
+
323
+ ### Keyboard
324
+
325
+ | Key | What it does |
326
+ | --------------- | ---------------------------------------------------------------------------- |
327
+ | Enter / Space | Opens the dialog from its trigger |
328
+ | Tab / Shift+Tab | Moves through the dialog's controls; focus wraps and never leaves the dialog |
329
+ | Escape | Closes the dialog and returns focus to the trigger |
330
+
331
+ ---
332
+
333
+ - Import: `import { Dialog, DialogTrigger, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogBody, DialogFooter } from "@zonsh/ui"`
334
+ - Source: `packages/ui/src/components/dialog.tsx`
335
+ - Primitive: `@base-ui/react/dialog` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/dialog.md`)
@@ -0,0 +1,165 @@
1
+ # Direction
2
+
3
+ ```tsx
4
+ import { Button, DirectionProvider, Menu, MenuContent, MenuItem, MenuTrigger, Slider, Tabs, TabsList, TabsPanel, TabsTab } from "@zonsh/ui";
5
+ import { ArchiveIcon, ChevronDownIcon, CopyIcon, PencilIcon } from "lucide-react";
6
+
7
+ /** The menu's popup is portalled outside the `dir` element; it takes the direction from the provider. */
8
+ function ProjectMenu() {
9
+ return (
10
+ <Menu>
11
+ <MenuTrigger render={<Button variant="secondary" />}>
12
+ المشروع
13
+ <ChevronDownIcon />
14
+ </MenuTrigger>
15
+ <MenuContent>
16
+ <MenuItem>
17
+ <PencilIcon />
18
+ تعديل
19
+ </MenuItem>
20
+ <MenuItem>
21
+ <CopyIcon />
22
+ نسخ
23
+ </MenuItem>
24
+ <MenuItem>
25
+ <ArchiveIcon />
26
+ أرشفة
27
+ </MenuItem>
28
+ </MenuContent>
29
+ </Menu>
30
+ );
31
+ }
32
+
33
+ export function RightToLeft() {
34
+ return (
35
+ <DirectionProvider direction="rtl">
36
+ <div dir="rtl" lang="ar" className="flex w-full max-w-md flex-col gap-8">
37
+ <Tabs defaultValue="overview">
38
+ <TabsList>
39
+ <TabsTab value="overview">نظرة عامة</TabsTab>
40
+ <TabsTab value="process">العملية</TabsTab>
41
+ <TabsTab value="stack">التقنيات</TabsTab>
42
+ </TabsList>
43
+ <TabsPanel value="overview" />
44
+ <TabsPanel value="process" />
45
+ <TabsPanel value="stack" />
46
+ </Tabs>
47
+ <Slider label="الميزانية" showValue defaultValue={40} />
48
+ <div>
49
+ <ProjectMenu />
50
+ </div>
51
+ </div>
52
+ </DirectionProvider>
53
+ );
54
+ }
55
+ ```
56
+
57
+ Right-to-left support for Arabic, Hebrew, Persian and Urdu. `DirectionProvider` tells every Base UI component inside which way text runs: arrow keys, slider fill and popup alignment follow it. It changes **behaviour**, not layout — also set `dir="rtl"` on `<html>` (or the region's element) so alignment and logical utilities (`ps-*`, `start-*`) flip.
58
+
59
+ ## Usage
60
+
61
+ ```tsx
62
+ import { DirectionProvider } from "@zonsh/ui";
63
+
64
+ <html dir="rtl" lang="ar">
65
+ <body>
66
+ <DirectionProvider direction="rtl">
67
+ <App />
68
+ </DirectionProvider>
69
+ </body>
70
+ </html>;
71
+ ```
72
+
73
+ The props you'll reach for: `direction`, plus `dir` and `lang` on the element.
74
+
75
+ ## When to use
76
+
77
+ - An RTL app: wrap the root once and set `<html dir="rtl" lang="ar">`.
78
+ - An RTL region on an LTR page (a quotation, a translated form): wrap it and put `dir="rtl"` on its element.
79
+ - `useDirection()` for your own content portalled outside the `dir` element; the library's popups read it themselves.
80
+
81
+ ## Examples
82
+
83
+ ### Switching direction
84
+
85
+ A range slider in both directions, `useDirection()` reading the value.
86
+
87
+ ```tsx
88
+ import { DirectionProvider, Slider, ToggleGroup, ToggleGroupItem, useDirection } from "@zonsh/ui";
89
+ import * as React from "react";
90
+
91
+ function DirectionLabel() {
92
+ const direction = useDirection();
93
+ return (
94
+ <span dir="ltr" className="self-start font-mono text-xs text-muted-foreground">
95
+ useDirection() → "{direction}"
96
+ </span>
97
+ );
98
+ }
99
+
100
+ export function Switching() {
101
+ const [direction, setDirection] = React.useState<"ltr" | "rtl">("rtl");
102
+ return (
103
+ <div className="flex w-full max-w-md flex-col gap-6">
104
+ <ToggleGroup
105
+ aria-label="Text direction"
106
+ value={[direction]}
107
+ onValueChange={(value) => value[0] && setDirection(value[0] as "ltr" | "rtl")}
108
+ >
109
+ <ToggleGroupItem value="ltr">LTR</ToggleGroupItem>
110
+ <ToggleGroupItem value="rtl">RTL</ToggleGroupItem>
111
+ </ToggleGroup>
112
+ <DirectionProvider direction={direction}>
113
+ <div dir={direction} className="flex flex-col gap-4">
114
+ <Slider
115
+ label="Budget"
116
+ showValue
117
+ defaultValue={[20, 70]}
118
+ thumbLabels={["Minimum budget", "Maximum budget"]}
119
+ />
120
+ <DirectionLabel />
121
+ </div>
122
+ </DirectionProvider>
123
+ </div>
124
+ );
125
+ }
126
+ ```
127
+
128
+ ## Props
129
+
130
+ | Prop | Type | Default |
131
+ | ----------- | ---------------- | ------- |
132
+ | `direction` | `"ltr" \| "rtl"` | `"ltr"` |
133
+ | `children` | `ReactNode` | — |
134
+
135
+ `useDirection(): "ltr" | "rtl"` returns the nearest provider's direction. The `TextDirection` type is exported too.
136
+
137
+ ## Portalled content
138
+
139
+ Popups portal to the end of `<body>`, outside the `dir` element, so each library popup — menus, context menus, menubars, selects, comboboxes, popovers, tooltips, preview cards, navigation panels, dialogs, alert dialogs, drawers, the command palette, toasts — takes `dir="rtl"` from the provider. A `start`-aligned popup lines up with the trigger's right edge, a dialog's close sits top left, submenus open left, and toasts stack bottom left.
140
+
141
+ An explicit `dir` on a popup's content wins:
142
+
143
+ ```tsx
144
+ <MenuContent dir="ltr">…</MenuContent>
145
+ ```
146
+
147
+ Outside an RTL provider popups inherit `<html dir>`. An LTR region in an RTL page needs `<DirectionProvider direction="ltr">` (for the keyboard) and `dir="ltr"` on its popups' content.
148
+
149
+ ## Brand rules
150
+
151
+ - **Do** use logical utilities (`ps-4`, `ms-auto`, `start-3`, `text-start`) so your markup mirrors for free.
152
+ - **Do** mirror directional icons with `rtl:-scale-x-100` (or `rtl:rotate-180`): back/next arrows and chevrons, a link out (`ArrowUpRightIcon`, `ExternalLinkIcon`), undo/redo, sign in/out, send, `PanelLeftIcon`. Leave alone search, check, circular arrows (refresh — clocks turn clockwise everywhere), media controls and physical-key arrows.
153
+ - **Don't** mirror the logo, numerals, code or the ASCII artwork.
154
+ - **Don't** set the provider without `dir`; the components would behave RTL while the page reads LTR.
155
+
156
+ ## Accessibility
157
+
158
+ - Set `lang` with `dir` so screen readers choose the right voice and pronunciation.
159
+ - Arrow keys follow the reading direction: in RTL, → moves to the previous tab and decreases a horizontal slider.
160
+
161
+ ---
162
+
163
+ - Import: `import { DirectionProvider, useDirection } from "@zonsh/ui"`
164
+ - Source: `packages/ui/src/components/direction.tsx`
165
+ - Primitive: `@base-ui/react/direction-provider` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/direction-provider.md`)