@zonsh/ui 0.4.1 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (562) hide show
  1. package/CHANGELOG.md +639 -0
  2. package/README.md +49 -21
  3. package/dist/brand.d.ts +3 -0
  4. package/dist/brand.js +7 -0
  5. package/dist/components/_breadcrumb-more.d.ts +6 -0
  6. package/dist/components/_breadcrumb-more.js +5 -0
  7. package/dist/components/_drawing-svg.d.ts +11 -0
  8. package/dist/components/_drawing-svg.js +30 -0
  9. package/dist/components/_media.d.ts +159 -0
  10. package/dist/components/_media.js +266 -0
  11. package/dist/components/_overlay.d.ts +8 -5
  12. package/dist/components/_overlay.js +11 -6
  13. package/dist/components/_scheduler-calendar.d.ts +71 -0
  14. package/dist/components/_scheduler-calendar.js +940 -0
  15. package/dist/components/_scheduler-editor.d.ts +29 -0
  16. package/dist/components/_scheduler-editor.js +111 -0
  17. package/dist/components/_scheduler-menu.d.ts +16 -0
  18. package/dist/components/_scheduler-menu.js +18 -0
  19. package/dist/components/_scheduler-parts.d.ts +164 -0
  20. package/dist/components/_scheduler-parts.js +327 -0
  21. package/dist/components/_suggest-list.d.ts +142 -0
  22. package/dist/components/_suggest-list.js +159 -0
  23. package/dist/components/_toolbar-more.d.ts +24 -0
  24. package/dist/components/_toolbar-more.js +25 -0
  25. package/dist/components/accordion.d.ts +1 -1
  26. package/dist/components/accordion.js +7 -7
  27. package/dist/components/action-sheet.d.ts +88 -0
  28. package/dist/components/action-sheet.js +124 -0
  29. package/dist/components/alert-dialog.js +3 -1
  30. package/dist/components/alert.d.ts +11 -18
  31. package/dist/components/alert.js +9 -6
  32. package/dist/components/app-bar.d.ts +93 -0
  33. package/dist/components/app-bar.js +175 -0
  34. package/dist/components/ascii-field.js +2 -1
  35. package/dist/components/audio-player.d.ts +134 -0
  36. package/dist/components/audio-player.js +618 -0
  37. package/dist/components/avatar.d.ts +6 -6
  38. package/dist/components/avatar.js +13 -11
  39. package/dist/components/badge.d.ts +12 -12
  40. package/dist/components/badge.js +7 -5
  41. package/dist/components/bottom-nav.d.ts +53 -11
  42. package/dist/components/bottom-nav.js +389 -24
  43. package/dist/components/breadcrumb.d.ts +11 -2
  44. package/dist/components/breadcrumb.js +60 -6
  45. package/dist/components/button-group.js +5 -1
  46. package/dist/components/button.d.ts +23 -6
  47. package/dist/components/button.js +64 -8
  48. package/dist/components/calendar.js +8 -6
  49. package/dist/components/card.d.ts +10 -8
  50. package/dist/components/card.js +15 -14
  51. package/dist/components/carousel.d.ts +2 -2
  52. package/dist/components/carousel.js +21 -8
  53. package/dist/components/chart.d.ts +38 -1
  54. package/dist/components/chart.js +27 -5
  55. package/dist/components/checkbox.js +2 -2
  56. package/dist/components/code-block.d.ts +9 -2
  57. package/dist/components/code-block.js +26 -7
  58. package/dist/components/collapsible.js +4 -4
  59. package/dist/components/color-picker.d.ts +2 -2
  60. package/dist/components/color-picker.js +5 -5
  61. package/dist/components/combobox.d.ts +26 -7
  62. package/dist/components/combobox.js +32 -13
  63. package/dist/components/command.d.ts +29 -5
  64. package/dist/components/command.js +37 -12
  65. package/dist/components/context-menu.d.ts +5 -2
  66. package/dist/components/context-menu.js +24 -3
  67. package/dist/components/conversation.d.ts +1 -1
  68. package/dist/components/conversation.js +77 -16
  69. package/dist/components/copy-button.d.ts +1 -1
  70. package/dist/components/copy-button.js +8 -6
  71. package/dist/components/data-table.d.ts +6 -6
  72. package/dist/components/data-table.js +41 -15
  73. package/dist/components/date-picker.d.ts +31 -9
  74. package/dist/components/date-picker.js +100 -18
  75. package/dist/components/dialog.d.ts +17 -10
  76. package/dist/components/dialog.js +20 -13
  77. package/dist/components/drawer.d.ts +26 -8
  78. package/dist/components/drawer.js +75 -16
  79. package/dist/components/drawing.d.ts +25 -0
  80. package/dist/components/drawing.js +32 -0
  81. package/dist/components/empty.js +2 -2
  82. package/dist/components/feature-list.d.ts +65 -13
  83. package/dist/components/feature-list.js +116 -15
  84. package/dist/components/field.js +2 -2
  85. package/dist/components/file-drop.d.ts +9 -7
  86. package/dist/components/file-drop.js +8 -43
  87. package/dist/components/filter-bar.d.ts +10 -9
  88. package/dist/components/filter-bar.js +42 -25
  89. package/dist/components/graph.d.ts +19 -3
  90. package/dist/components/graph.js +190 -28
  91. package/dist/components/illustration.js +53 -31
  92. package/dist/components/input-group.d.ts +6 -11
  93. package/dist/components/input-group.js +21 -19
  94. package/dist/components/input.d.ts +2 -2
  95. package/dist/components/input.js +3 -3
  96. package/dist/components/item.d.ts +9 -6
  97. package/dist/components/item.js +13 -8
  98. package/dist/components/kbd.d.ts +1 -1
  99. package/dist/components/kbd.js +1 -1
  100. package/dist/components/layout.d.ts +2 -1
  101. package/dist/components/layout.js +55 -11
  102. package/dist/components/lightbox.d.ts +76 -9
  103. package/dist/components/lightbox.js +354 -48
  104. package/dist/components/locale.d.ts +6 -6
  105. package/dist/components/logo.d.ts +21 -1
  106. package/dist/components/logo.js +32 -2
  107. package/dist/components/markdown-editor.d.ts +275 -0
  108. package/dist/components/markdown-editor.js +831 -0
  109. package/dist/components/mentions.d.ts +153 -0
  110. package/dist/components/mentions.js +507 -0
  111. package/dist/components/menu.d.ts +2 -1
  112. package/dist/components/menu.js +5 -4
  113. package/dist/components/menubar.d.ts +23 -5
  114. package/dist/components/menubar.js +153 -31
  115. package/dist/components/message.d.ts +62 -11
  116. package/dist/components/message.js +51 -14
  117. package/dist/components/meter.js +1 -1
  118. package/dist/components/money-input.d.ts +1 -1
  119. package/dist/components/money-input.js +1 -1
  120. package/dist/components/native-select.d.ts +2 -2
  121. package/dist/components/native-select.js +4 -4
  122. package/dist/components/navigation-menu.d.ts +3 -1
  123. package/dist/components/navigation-menu.js +23 -10
  124. package/dist/components/number-field.d.ts +2 -9
  125. package/dist/components/number-field.js +90 -26
  126. package/dist/components/number-roll.d.ts +26 -0
  127. package/dist/components/number-roll.js +81 -0
  128. package/dist/components/otp-field.d.ts +1 -1
  129. package/dist/components/otp-field.js +24 -3
  130. package/dist/components/pagination.d.ts +11 -3
  131. package/dist/components/pagination.js +59 -13
  132. package/dist/components/pdf-viewer.d.ts +1 -1
  133. package/dist/components/pdf-viewer.js +8 -8
  134. package/dist/components/phone-input.d.ts +1 -1
  135. package/dist/components/phone-input.js +2 -2
  136. package/dist/components/popover.js +5 -3
  137. package/dist/components/preview-card.d.ts +37 -2
  138. package/dist/components/preview-card.js +226 -2
  139. package/dist/components/progress.js +1 -1
  140. package/dist/components/prompt-input.d.ts +1 -1
  141. package/dist/components/prompt-input.js +35 -17
  142. package/dist/components/pull-to-refresh.d.ts +50 -0
  143. package/dist/components/pull-to-refresh.js +189 -0
  144. package/dist/components/quote.d.ts +6 -1
  145. package/dist/components/quote.js +3 -2
  146. package/dist/components/radio-group.js +8 -3
  147. package/dist/components/rating.d.ts +4 -1
  148. package/dist/components/rating.js +131 -10
  149. package/dist/components/reasoning.d.ts +1 -1
  150. package/dist/components/reasoning.js +7 -3
  151. package/dist/components/resizable.d.ts +1 -1
  152. package/dist/components/resizable.js +2 -2
  153. package/dist/components/response.d.ts +4 -3
  154. package/dist/components/response.js +39 -15
  155. package/dist/components/scheduler.d.ts +352 -0
  156. package/dist/components/scheduler.js +1717 -0
  157. package/dist/components/scroll-area.js +1 -1
  158. package/dist/components/select.d.ts +17 -4
  159. package/dist/components/select.js +140 -9
  160. package/dist/components/separator.d.ts +1 -1
  161. package/dist/components/separator.js +3 -3
  162. package/dist/components/sidebar.d.ts +44 -3
  163. package/dist/components/sidebar.js +90 -31
  164. package/dist/components/site-header.d.ts +18 -13
  165. package/dist/components/site-header.js +26 -9
  166. package/dist/components/skeleton.d.ts +18 -8
  167. package/dist/components/skeleton.js +23 -8
  168. package/dist/components/slider.js +2 -2
  169. package/dist/components/sortable.d.ts +55 -4
  170. package/dist/components/sortable.js +187 -94
  171. package/dist/components/sources.d.ts +1 -1
  172. package/dist/components/sources.js +2 -2
  173. package/dist/components/spinner.d.ts +4 -4
  174. package/dist/components/spinner.js +4 -4
  175. package/dist/components/stat.d.ts +21 -4
  176. package/dist/components/stat.js +17 -8
  177. package/dist/components/stepper.d.ts +1 -1
  178. package/dist/components/stepper.js +8 -7
  179. package/dist/components/suggestions.d.ts +11 -3
  180. package/dist/components/suggestions.js +10 -4
  181. package/dist/components/swipe-actions.d.ts +66 -0
  182. package/dist/components/swipe-actions.js +292 -0
  183. package/dist/components/switch.js +1 -1
  184. package/dist/components/table.d.ts +13 -7
  185. package/dist/components/table.js +124 -23
  186. package/dist/components/tabs.js +15 -8
  187. package/dist/components/tag.d.ts +19 -20
  188. package/dist/components/tag.js +9 -5
  189. package/dist/components/tags-input.d.ts +2 -7
  190. package/dist/components/tags-input.js +11 -8
  191. package/dist/components/textarea.d.ts +3 -2
  192. package/dist/components/textarea.js +4 -3
  193. package/dist/components/theme.d.ts +50 -7
  194. package/dist/components/theme.js +168 -12
  195. package/dist/components/time-field.d.ts +6 -10
  196. package/dist/components/time-field.js +19 -9
  197. package/dist/components/timeline.d.ts +19 -3
  198. package/dist/components/timeline.js +21 -9
  199. package/dist/components/tippy.d.ts +17 -1
  200. package/dist/components/tippy.js +95 -15
  201. package/dist/components/toast.d.ts +2 -7
  202. package/dist/components/toast.js +12 -8
  203. package/dist/components/toggle-group.d.ts +7 -1
  204. package/dist/components/toggle-group.js +17 -5
  205. package/dist/components/toggle.d.ts +2 -2
  206. package/dist/components/toggle.js +3 -2
  207. package/dist/components/tool-call.d.ts +1 -1
  208. package/dist/components/tool-call.js +8 -3
  209. package/dist/components/toolbar.d.ts +57 -4
  210. package/dist/components/toolbar.js +219 -16
  211. package/dist/components/tooltip.d.ts +5 -3
  212. package/dist/components/tooltip.js +14 -6
  213. package/dist/components/tour.d.ts +1 -1
  214. package/dist/components/tour.js +70 -24
  215. package/dist/components/tree.js +33 -10
  216. package/dist/components/typography.d.ts +31 -8
  217. package/dist/components/typography.js +21 -10
  218. package/dist/components/video-player.d.ts +7 -2
  219. package/dist/components/video-player.js +182 -225
  220. package/dist/index.d.ts +99 -92
  221. package/dist/index.js +99 -92
  222. package/dist/lib/calendar.d.ts +153 -0
  223. package/dist/lib/calendar.js +312 -0
  224. package/dist/lib/cn.d.ts +3 -1
  225. package/dist/lib/cn.js +5 -0
  226. package/dist/lib/code-highlight.d.ts +14 -0
  227. package/dist/lib/code-highlight.js +81 -18
  228. package/dist/lib/drag.d.ts +39 -0
  229. package/dist/lib/drag.js +96 -0
  230. package/dist/lib/editorial-assets.js +16 -8
  231. package/dist/lib/figure/figures/automation.js +25 -6
  232. package/dist/lib/figure/figures/bar-chart.js +6 -1
  233. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  234. package/dist/lib/figure/figures/city.js +12 -2
  235. package/dist/lib/figure/figures/conveyor.js +17 -4
  236. package/dist/lib/figure/figures/database.js +5 -2
  237. package/dist/lib/figure/figures/documents.js +11 -3
  238. package/dist/lib/figure/figures/inbox.js +5 -2
  239. package/dist/lib/figure/figures/laptop.js +3 -1
  240. package/dist/lib/figure/figures/pipeline.js +45 -10
  241. package/dist/lib/figure/figures/platform.js +62 -7
  242. package/dist/lib/figure/figures/server.js +21 -5
  243. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  244. package/dist/lib/figure/kernel.d.ts +4 -2
  245. package/dist/lib/figure/kernel.js +10 -5
  246. package/dist/lib/figure/parts.js +6 -2
  247. package/dist/lib/files.d.ts +31 -0
  248. package/dist/lib/files.js +60 -0
  249. package/dist/lib/gesture.d.ts +70 -0
  250. package/dist/lib/gesture.js +141 -0
  251. package/dist/lib/glide.d.ts +10 -4
  252. package/dist/lib/glide.js +14 -5
  253. package/dist/lib/icons.d.ts +1 -0
  254. package/dist/lib/icons.js +6 -0
  255. package/dist/lib/illustration-library.js +1 -6
  256. package/dist/lib/markdown-edit.d.ts +112 -0
  257. package/dist/lib/markdown-edit.js +557 -0
  258. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  259. package/dist/lib/markdown-rich-editor.js +1153 -0
  260. package/dist/lib/markdown-rich.d.ts +63 -0
  261. package/dist/lib/markdown-rich.js +534 -0
  262. package/dist/lib/mentions.d.ts +100 -0
  263. package/dist/lib/mentions.js +246 -0
  264. package/dist/lib/motion.d.ts +18 -0
  265. package/dist/lib/motion.js +43 -5
  266. package/dist/lib/number-roll.d.ts +89 -0
  267. package/dist/lib/number-roll.js +391 -0
  268. package/dist/lib/platform.d.ts +6 -0
  269. package/dist/lib/platform.js +14 -0
  270. package/dist/lib/portal-container.d.ts +9 -0
  271. package/dist/lib/portal-container.js +10 -0
  272. package/dist/lib/press.d.ts +5 -0
  273. package/dist/lib/press.js +186 -0
  274. package/dist/lib/scheduler.d.ts +128 -0
  275. package/dist/lib/scheduler.js +272 -0
  276. package/dist/lib/scroll-edges.d.ts +9 -0
  277. package/dist/lib/scroll-edges.js +50 -0
  278. package/dist/lib/table-fit.d.ts +4 -3
  279. package/dist/lib/table-fit.js +92 -25
  280. package/dist/lib/theme-preset.d.ts +267 -0
  281. package/dist/lib/theme-preset.js +1046 -0
  282. package/dist/lib/theme-script.d.ts +23 -3
  283. package/dist/lib/theme-script.js +17 -5
  284. package/dist/lib/tippy/sprite.d.ts +36 -4
  285. package/dist/lib/tippy/sprite.js +188 -15
  286. package/dist/lib/tone.d.ts +4 -0
  287. package/dist/lib/tone.js +1 -0
  288. package/dist/messages/de.d.ts +3 -3
  289. package/dist/messages/de.js +274 -3
  290. package/dist/skills/zon-ui/SKILL.md +279 -0
  291. package/dist/skills/zon-ui/references/authoring.md +265 -0
  292. package/dist/skills/zon-ui/references/brand.md +416 -0
  293. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  294. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  295. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  296. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  297. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  298. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  299. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  300. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  301. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  302. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  303. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  304. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  305. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  306. package/dist/skills/zon-ui/references/components/button.md +309 -0
  307. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  308. package/dist/skills/zon-ui/references/components/card.md +158 -0
  309. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  310. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  311. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  312. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  313. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  314. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  315. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  316. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  317. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  318. package/dist/skills/zon-ui/references/components/command.md +326 -0
  319. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  320. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  321. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  322. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  323. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  324. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  325. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  326. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  327. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  328. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  329. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  330. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  331. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  332. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  333. package/dist/skills/zon-ui/references/components/field.md +209 -0
  334. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  335. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  336. package/dist/skills/zon-ui/references/components/form.md +970 -0
  337. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  338. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  339. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  340. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  341. package/dist/skills/zon-ui/references/components/input.md +189 -0
  342. package/dist/skills/zon-ui/references/components/item.md +277 -0
  343. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  344. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  345. package/dist/skills/zon-ui/references/components/label.md +104 -0
  346. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  347. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  348. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  349. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  350. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  351. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  352. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  353. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  354. package/dist/skills/zon-ui/references/components/message.md +243 -0
  355. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  356. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  357. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  358. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  359. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  360. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  361. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  362. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  363. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  364. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  365. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  366. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  367. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  368. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  369. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  370. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  371. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  372. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  373. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  374. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  375. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  376. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  377. package/dist/skills/zon-ui/references/components/response.md +170 -0
  378. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  379. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  380. package/dist/skills/zon-ui/references/components/select.md +351 -0
  381. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  382. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  383. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  384. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  385. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  386. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  387. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  388. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  389. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  390. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  391. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  392. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  393. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  394. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  395. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  396. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  397. package/dist/skills/zon-ui/references/components/table.md +999 -0
  398. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  399. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  400. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  401. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  402. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  403. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  404. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  405. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  406. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  407. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  408. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  409. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  410. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  411. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  412. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  413. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  414. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  415. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  416. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  417. package/dist/skills/zon-ui/references/marketing.md +467 -0
  418. package/dist/skills/zon-ui/references/motion.md +455 -0
  419. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  420. package/dist/skills/zon-ui/references/tokens.md +866 -0
  421. package/dist/sources/accordion.css +4 -0
  422. package/dist/sources/action-sheet.css +11 -0
  423. package/dist/sources/alert-dialog.css +6 -0
  424. package/dist/sources/alert.css +3 -0
  425. package/dist/sources/app-bar.css +14 -0
  426. package/dist/sources/ascii-field.css +3 -0
  427. package/dist/sources/aspect-ratio.css +3 -0
  428. package/dist/sources/audio-player.css +20 -0
  429. package/dist/sources/avatar.css +3 -0
  430. package/dist/sources/badge.css +3 -0
  431. package/dist/sources/bottom-nav.css +9 -0
  432. package/dist/sources/breadcrumb.css +14 -0
  433. package/dist/sources/button-group.css +3 -0
  434. package/dist/sources/button.css +9 -0
  435. package/dist/sources/calendar.css +13 -0
  436. package/dist/sources/card.css +3 -0
  437. package/dist/sources/carousel.css +11 -0
  438. package/dist/sources/chart.css +5 -0
  439. package/dist/sources/checkbox.css +6 -0
  440. package/dist/sources/code-block.css +13 -0
  441. package/dist/sources/collapsible.css +4 -0
  442. package/dist/sources/color-picker.css +13 -0
  443. package/dist/sources/combobox.css +13 -0
  444. package/dist/sources/command.css +13 -0
  445. package/dist/sources/context-menu.css +12 -0
  446. package/dist/sources/conversation.css +10 -0
  447. package/dist/sources/copy-button.css +10 -0
  448. package/dist/sources/data-table.css +27 -0
  449. package/dist/sources/date-picker.css +20 -0
  450. package/dist/sources/dialog.css +9 -0
  451. package/dist/sources/direction.css +2 -0
  452. package/dist/sources/drawer.css +9 -0
  453. package/dist/sources/drawing.css +5 -0
  454. package/dist/sources/empty.css +3 -0
  455. package/dist/sources/feature-list.css +4 -0
  456. package/dist/sources/field.css +4 -0
  457. package/dist/sources/file-drop.css +15 -0
  458. package/dist/sources/filter-bar.css +30 -0
  459. package/dist/sources/form.css +4 -0
  460. package/dist/sources/graph.css +19 -0
  461. package/dist/sources/illustration.css +28 -0
  462. package/dist/sources/input-group.css +7 -0
  463. package/dist/sources/input.css +3 -0
  464. package/dist/sources/item.css +4 -0
  465. package/dist/sources/kbd.css +5 -0
  466. package/dist/sources/label.css +3 -0
  467. package/dist/sources/layout.css +3 -0
  468. package/dist/sources/lightbox.css +33 -0
  469. package/dist/sources/locale.css +2 -0
  470. package/dist/sources/logo.css +4 -0
  471. package/dist/sources/markdown-editor.css +41 -0
  472. package/dist/sources/mentions.css +13 -0
  473. package/dist/sources/menu.css +11 -0
  474. package/dist/sources/menubar.css +14 -0
  475. package/dist/sources/message.css +16 -0
  476. package/dist/sources/meter.css +4 -0
  477. package/dist/sources/money-input.css +10 -0
  478. package/dist/sources/native-select.css +4 -0
  479. package/dist/sources/navigation-menu.css +8 -0
  480. package/dist/sources/number-field.css +8 -0
  481. package/dist/sources/number-roll.css +6 -0
  482. package/dist/sources/otp-field.css +5 -0
  483. package/dist/sources/pagination.css +11 -0
  484. package/dist/sources/pdf-viewer.css +30 -0
  485. package/dist/sources/phone-input.css +20 -0
  486. package/dist/sources/popover.css +7 -0
  487. package/dist/sources/preview-card.css +7 -0
  488. package/dist/sources/progress.css +4 -0
  489. package/dist/sources/prompt-input.css +15 -0
  490. package/dist/sources/pull-to-refresh.css +14 -0
  491. package/dist/sources/quote.css +3 -0
  492. package/dist/sources/radio-group.css +5 -0
  493. package/dist/sources/rating.css +6 -0
  494. package/dist/sources/reasoning.css +6 -0
  495. package/dist/sources/resizable.css +4 -0
  496. package/dist/sources/response.css +16 -0
  497. package/dist/sources/scheduler.css +44 -0
  498. package/dist/sources/scroll-area.css +3 -0
  499. package/dist/sources/select.css +12 -0
  500. package/dist/sources/separator.css +3 -0
  501. package/dist/sources/sidebar.css +19 -0
  502. package/dist/sources/site-header.css +15 -0
  503. package/dist/sources/skeleton.css +3 -0
  504. package/dist/sources/slider.css +6 -0
  505. package/dist/sources/sortable.css +12 -0
  506. package/dist/sources/sources.css +6 -0
  507. package/dist/sources/spinner.css +6 -0
  508. package/dist/sources/stat.css +9 -0
  509. package/dist/sources/stepper.css +6 -0
  510. package/dist/sources/suggestions.css +10 -0
  511. package/dist/sources/swipe-actions.css +20 -0
  512. package/dist/sources/switch.css +5 -0
  513. package/dist/sources/table.css +7 -0
  514. package/dist/sources/tabs.css +5 -0
  515. package/dist/sources/tag.css +3 -0
  516. package/dist/sources/tags-input.css +6 -0
  517. package/dist/sources/textarea.css +3 -0
  518. package/dist/sources/theme.css +13 -0
  519. package/dist/sources/time-field.css +7 -0
  520. package/dist/sources/timeline.css +7 -0
  521. package/dist/sources/tippy.css +6 -0
  522. package/dist/sources/toast.css +6 -0
  523. package/dist/sources/toggle-group.css +5 -0
  524. package/dist/sources/toggle.css +3 -0
  525. package/dist/sources/tool-call.css +16 -0
  526. package/dist/sources/toolbar.css +14 -0
  527. package/dist/sources/tooltip.css +6 -0
  528. package/dist/sources/tour.css +14 -0
  529. package/dist/sources/tree.css +6 -0
  530. package/dist/sources/typography.css +4 -0
  531. package/dist/sources/video-player.css +21 -0
  532. package/dist/styles/ai.css +3 -0
  533. package/dist/styles/brand.css +98 -0
  534. package/dist/styles/core.css +266 -0
  535. package/dist/styles/editor.css +3 -0
  536. package/dist/styles/expressive.css +75 -77
  537. package/dist/styles/fonts.css +61 -117
  538. package/dist/styles/graph.css +4 -0
  539. package/dist/styles/illustration.css +4 -0
  540. package/dist/styles/index.css +11 -193
  541. package/dist/styles/material.css +177 -31
  542. package/dist/styles/parts/ai.css +20 -14
  543. package/dist/styles/parts/brand.css +2 -2
  544. package/dist/styles/parts/controls.css +51 -38
  545. package/dist/styles/parts/data.css +43 -11
  546. package/dist/styles/parts/editor.css +372 -0
  547. package/dist/styles/parts/feedback.css +75 -15
  548. package/dist/styles/parts/foundations.css +12 -7
  549. package/dist/styles/parts/graph.css +25 -9
  550. package/dist/styles/parts/inputs.css +172 -9
  551. package/dist/styles/parts/isometric.css +6 -5
  552. package/dist/styles/parts/navigation.css +237 -25
  553. package/dist/styles/parts/overlays.css +110 -8
  554. package/dist/styles/parts/pdf.css +15 -9
  555. package/dist/styles/pdf.css +3 -0
  556. package/dist/styles/prose.css +3 -0
  557. package/dist/styles/tokens.css +105 -15
  558. package/dist/theme.d.ts +1 -0
  559. package/dist/theme.js +5 -0
  560. package/dist/vite.d.ts +48 -59
  561. package/dist/vite.js +54 -21
  562. package/package.json +69 -2
@@ -0,0 +1,218 @@
1
+ # Menu
2
+
3
+ ```tsx
4
+ import { Button, Menu, MenuContent, MenuItem, MenuSeparator, MenuShortcut, MenuTrigger } from "@zonsh/ui";
5
+ import { ArchiveIcon, ChevronDownIcon, CopyIcon, PencilIcon, Trash2Icon } from "lucide-react";
6
+
7
+ export function Basic() {
8
+ return (
9
+ <Menu>
10
+ <MenuTrigger render={<Button variant="secondary" />}>
11
+ Project
12
+ <ChevronDownIcon />
13
+ </MenuTrigger>
14
+ <MenuContent>
15
+ <MenuItem>
16
+ <PencilIcon />
17
+ Rename
18
+ <MenuShortcut keys={["mod", "R"]} />
19
+ </MenuItem>
20
+ <MenuItem>
21
+ <CopyIcon />
22
+ Duplicate
23
+ <MenuShortcut keys={["mod", "D"]} />
24
+ </MenuItem>
25
+ <MenuItem>
26
+ <ArchiveIcon />
27
+ Archive
28
+ </MenuItem>
29
+ <MenuSeparator />
30
+ <MenuItem variant="destructive">
31
+ <Trash2Icon />
32
+ Delete project
33
+ </MenuItem>
34
+ </MenuContent>
35
+ </Menu>
36
+ );
37
+ }
38
+ ```
39
+
40
+ Actions behind a button, in `material-menu` at 12px: 38px items at 7px that lift on highlight like `SelectItem`, mono group labels and shortcuts.
41
+
42
+ ## Usage
43
+
44
+ ```tsx
45
+ import { Button, Menu, MenuContent, MenuItem, MenuSeparator, MenuTrigger } from "@zonsh/ui";
46
+
47
+ <Menu>
48
+ <MenuTrigger render={<Button variant="secondary" />}>Project</MenuTrigger>
49
+ <MenuContent>
50
+ <MenuItem onClick={rename}>Rename</MenuItem>
51
+ <MenuItem onClick={duplicate}>Duplicate</MenuItem>
52
+ <MenuSeparator />
53
+ <MenuItem variant="destructive" onClick={remove}>
54
+ Delete project
55
+ </MenuItem>
56
+ </MenuContent>
57
+ </Menu>;
58
+ ```
59
+
60
+ The props you'll use: `MenuTrigger render` (a secondary or ghost `Button`), `MenuItem variant="destructive"` and `MenuContent align`. Icons first (16px lucide), shortcuts last.
61
+
62
+ ## When to use
63
+
64
+ - Secondary actions on a thing ("Rename", "Delete project"), often from an overflow `…` button.
65
+ - View toggles and sort order (`MenuCheckboxItem`, `MenuRadioGroup`).
66
+ - Not for choosing a form value — use `Select`. Not for site navigation — use `NavigationMenu`.
67
+
68
+ ## Examples
69
+
70
+ ### Checkbox and radio
71
+
72
+ They keep the menu open on click.
73
+
74
+ ```tsx
75
+ import { Button, Menu, MenuCheckboxItem, MenuContent, MenuGroup, MenuGroupLabel, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuTrigger } from "@zonsh/ui";
76
+ import { ChevronDownIcon } from "lucide-react";
77
+ import * as React from "react";
78
+
79
+ export function CheckboxAndRadio() {
80
+ const [grid, setGrid] = React.useState(true);
81
+ const [notes, setNotes] = React.useState(false);
82
+ const [sort, setSort] = React.useState("updated");
83
+ return (
84
+ <Menu>
85
+ <MenuTrigger render={<Button variant="secondary" />}>
86
+ View
87
+ <ChevronDownIcon />
88
+ </MenuTrigger>
89
+ <MenuContent className="min-w-56">
90
+ <MenuGroup>
91
+ <MenuGroupLabel>Show</MenuGroupLabel>
92
+ <MenuCheckboxItem checked={grid} onCheckedChange={setGrid}>
93
+ Blueprint grid
94
+ </MenuCheckboxItem>
95
+ <MenuCheckboxItem checked={notes} onCheckedChange={setNotes}>
96
+ Margin notes
97
+ </MenuCheckboxItem>
98
+ </MenuGroup>
99
+ <MenuSeparator />
100
+ <MenuRadioGroup value={sort} onValueChange={setSort}>
101
+ <MenuGroupLabel>Sort by</MenuGroupLabel>
102
+ <MenuRadioItem value="updated">Last updated</MenuRadioItem>
103
+ <MenuRadioItem value="name">Name</MenuRadioItem>
104
+ <MenuRadioItem value="owner">Owner</MenuRadioItem>
105
+ </MenuRadioGroup>
106
+ </MenuContent>
107
+ </Menu>
108
+ );
109
+ }
110
+ ```
111
+
112
+ ### Submenu
113
+
114
+ Submenus open to the inline end on hover or arrow key; `MenuLinkItem` is a real link.
115
+
116
+ ```tsx
117
+ import { Button, Menu, MenuContent, MenuItem, MenuLinkItem, MenuSeparator, MenuSub, MenuSubContent, MenuSubTrigger, MenuTrigger } from "@zonsh/ui";
118
+ import { EllipsisIcon, ExternalLinkIcon, PencilIcon, Share2Icon } from "lucide-react";
119
+
120
+ export function Submenu() {
121
+ return (
122
+ <Menu>
123
+ <MenuTrigger render={<Button variant="ghost" size="icon" aria-label="More actions" />}>
124
+ <EllipsisIcon />
125
+ </MenuTrigger>
126
+ <MenuContent>
127
+ <MenuItem>
128
+ <PencilIcon />
129
+ Edit post
130
+ </MenuItem>
131
+ <MenuSub>
132
+ <MenuSubTrigger>
133
+ <Share2Icon />
134
+ Share
135
+ </MenuSubTrigger>
136
+ <MenuSubContent>
137
+ <MenuItem>Copy link</MenuItem>
138
+ <MenuItem>Send by email</MenuItem>
139
+ <MenuItem>Export as PDF</MenuItem>
140
+ </MenuSubContent>
141
+ </MenuSub>
142
+ <MenuSeparator />
143
+ <MenuLinkItem href="#history">
144
+ <ExternalLinkIcon className="rtl:-scale-x-100" />
145
+ Open version history
146
+ </MenuLinkItem>
147
+ </MenuContent>
148
+ </Menu>
149
+ );
150
+ }
151
+ ```
152
+
153
+ ## Behaviour
154
+
155
+ Checks draw in and out; a radio group's dot glides to the option picked. Popups stay inside their trigger's room: in a narrow panel they shift and narrow, and a submenu with no room beside it opens below its item.
156
+
157
+ ## Props
158
+
159
+ | Prop | Type | Default |
160
+ | ---------------------------------------------- | ---------------------------------------------------------- | ----------- |
161
+ | `MenuContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"bottom"` |
162
+ | `MenuContent.align` | `"start" \| "center" \| "end"` | `"start"` |
163
+ | `MenuContent.sideOffset` | `number` | `6` |
164
+ | `MenuContent.positioner` / `portal` | Base UI positioner / portal props | — |
165
+ | `MenuItem.variant` | `"default" \| "destructive"` | `"default"` |
166
+ | `MenuItem.closeOnClick` | `boolean` | `true` |
167
+ | `MenuItem.disabled` | `boolean` | `false` |
168
+ | `MenuCheckboxItem.checked` / `onCheckedChange` | `boolean` | — |
169
+ | `MenuRadioGroup.value` / `onValueChange` | `any` | — |
170
+ | `MenuShortcut.keys` | `string[]` — `["mod", "D"]`: ⌘D on Apple, Ctrl+D elsewhere | — |
171
+ | `MenuRadioItem.value` | `any` — required | — |
172
+ | `MenuTrigger.openOnHover` | `boolean` | `false` |
173
+ | `MenuSubContent.sideOffset` / `alignOffset` | `number` | `2` / `-5` |
174
+
175
+ `Menu` is Base UI `Menu.Root`; `MenuSub` is `Menu.SubmenuRoot`. Data attributes: `data-variant` on items, plus Base UI's `data-highlighted`, `data-checked`, `data-disabled`, `data-popup-open`.
176
+
177
+ ## Brand rules
178
+
179
+ - **Do** write items as verbs: "Rename", "Export as PDF", "Delete project".
180
+ - **Do** put destructive items last, after a separator, and confirm them with an `AlertDialog`.
181
+ - **Don't** colour icons or the highlight; only destructive ink and a status mark (a dot beside a state) take colour.
182
+ - **Don't** shrink items below 38px or change the 7px item radius.
183
+ - **Don't** nest more than one level of submenu.
184
+
185
+ ## Accessibility
186
+
187
+ - `role="menu"` with `menuitem`, `menuitemcheckbox` and `menuitemradio` items.
188
+ - Give icon-only triggers an `aria-label`.
189
+ - `MenuShortcut` is decorative (`aria-hidden`); wire the shortcut yourself (`event.metaKey || event.ctrlKey` for `mod`). `keys` writes it for the device (⌘D on a Mac, Ctrl+D elsewhere); it is hidden on touch-only devices.
190
+ - Label groups with `MenuGroupLabel` so they are announced together.
191
+
192
+ ### Keyboard
193
+
194
+ On the trigger:
195
+
196
+ | Key | What it does |
197
+ | ----------------- | -------------------------------------------- |
198
+ | Enter / Space / ↓ | Opens the menu and highlights the first item |
199
+ | ↑ | Opens the menu and highlights the last item |
200
+
201
+ In the menu:
202
+
203
+ | Key | What it does |
204
+ | ------------- | ------------------------------------------------------------------------------------------------------- |
205
+ | ↓ / ↑ | Moves the highlight, looping at the ends |
206
+ | Home / End | Highlights the first or last item |
207
+ | Enter / Space | Runs the highlighted item and closes the menu; a checkbox or radio item toggles and the menu stays open |
208
+ | → | Opens the highlighted submenu and highlights its first item (← right to left) |
209
+ | ← | Closes the submenu and returns to its trigger (→ right to left) |
210
+ | Typing | Highlights the next item that starts with the letters typed |
211
+ | Escape | Closes the menu and returns focus to the trigger |
212
+ | Tab | Closes the menu and moves focus on |
213
+
214
+ ---
215
+
216
+ - Import: `import { Menu, MenuTrigger, MenuContent, MenuItem, MenuLinkItem, MenuCheckboxItem, MenuRadioGroup, MenuRadioItem } from "@zonsh/ui"`
217
+ - Source: `packages/ui/src/components/menu.tsx`
218
+ - Primitive: `@base-ui/react/menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/menu.md`)
@@ -0,0 +1,292 @@
1
+ # Menubar
2
+
3
+ ```tsx
4
+ import { Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarGroupLabel, MenubarItem, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger } from "@zonsh/ui";
5
+ import { FilePlusIcon, FolderOpenIcon, SaveIcon, Trash2Icon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ export function Basic() {
9
+ const [grid, setGrid] = React.useState(true);
10
+ const [rulers, setRulers] = React.useState(false);
11
+ const [zoom, setZoom] = React.useState("fit");
12
+ return (
13
+ <Menubar>
14
+ <MenubarMenu>
15
+ <MenubarTrigger>File</MenubarTrigger>
16
+ <MenubarContent>
17
+ <MenubarItem>
18
+ <FilePlusIcon />
19
+ New document
20
+ <MenubarShortcut keys={["mod", "N"]} />
21
+ </MenubarItem>
22
+ <MenubarItem>
23
+ <FolderOpenIcon />
24
+ Open…
25
+ <MenubarShortcut keys={["mod", "O"]} />
26
+ </MenubarItem>
27
+ <MenubarItem>
28
+ <SaveIcon />
29
+ Save
30
+ <MenubarShortcut keys={["mod", "S"]} />
31
+ </MenubarItem>
32
+ <MenubarSeparator />
33
+ <MenubarSub>
34
+ <MenubarSubTrigger>Export as</MenubarSubTrigger>
35
+ <MenubarSubContent>
36
+ <MenubarItem>PDF</MenubarItem>
37
+ <MenubarItem>PNG</MenubarItem>
38
+ <MenubarItem>JSON</MenubarItem>
39
+ </MenubarSubContent>
40
+ </MenubarSub>
41
+ <MenubarSeparator />
42
+ <MenubarItem variant="destructive">
43
+ <Trash2Icon />
44
+ Delete document
45
+ </MenubarItem>
46
+ </MenubarContent>
47
+ </MenubarMenu>
48
+ <MenubarMenu>
49
+ <MenubarTrigger>Edit</MenubarTrigger>
50
+ <MenubarContent>
51
+ <MenubarItem>
52
+ Undo
53
+ <MenubarShortcut keys={["mod", "Z"]} />
54
+ </MenubarItem>
55
+ <MenubarItem>
56
+ Redo
57
+ <MenubarShortcut keys={["mod", "shift", "Z"]} />
58
+ </MenubarItem>
59
+ <MenubarSeparator />
60
+ <MenubarItem>
61
+ Duplicate step
62
+ <MenubarShortcut keys={["mod", "D"]} />
63
+ </MenubarItem>
64
+ <MenubarItem disabled>Paste step</MenubarItem>
65
+ </MenubarContent>
66
+ </MenubarMenu>
67
+ <MenubarMenu>
68
+ <MenubarTrigger>View</MenubarTrigger>
69
+ <MenubarContent>
70
+ <MenubarCheckboxItem checked={grid} onCheckedChange={setGrid}>
71
+ Show grid
72
+ </MenubarCheckboxItem>
73
+ <MenubarCheckboxItem checked={rulers} onCheckedChange={setRulers}>
74
+ Show rulers
75
+ </MenubarCheckboxItem>
76
+ <MenubarSeparator />
77
+ <MenubarGroup>
78
+ <MenubarGroupLabel>Zoom</MenubarGroupLabel>
79
+ <MenubarRadioGroup value={zoom} onValueChange={setZoom}>
80
+ <MenubarRadioItem value="fit">Fit to screen</MenubarRadioItem>
81
+ <MenubarRadioItem value="100">100%</MenubarRadioItem>
82
+ <MenubarRadioItem value="200">200%</MenubarRadioItem>
83
+ </MenubarRadioGroup>
84
+ </MenubarGroup>
85
+ </MenubarContent>
86
+ </MenubarMenu>
87
+ <MenubarMenu>
88
+ <MenubarTrigger>Help</MenubarTrigger>
89
+ <MenubarContent>
90
+ <MenubarItem>Keyboard shortcuts</MenubarItem>
91
+ <MenubarItem>Documentation</MenubarItem>
92
+ </MenubarContent>
93
+ </MenubarMenu>
94
+ </Menubar>
95
+ );
96
+ }
97
+ ```
98
+
99
+ A desktop-style menu bar: dense 30px triggers in a 38px bar, opening the `Menu` popup and items.
100
+
101
+ ## Usage
102
+
103
+ ```tsx
104
+ import {
105
+ Menubar,
106
+ MenubarContent,
107
+ MenubarItem,
108
+ MenubarMenu,
109
+ MenubarSeparator,
110
+ MenubarShortcut,
111
+ MenubarTrigger,
112
+ } from "@zonsh/ui";
113
+
114
+ <Menubar>
115
+ <MenubarMenu>
116
+ <MenubarTrigger>File</MenubarTrigger>
117
+ <MenubarContent>
118
+ <MenubarItem>
119
+ New document
120
+ <MenubarShortcut keys={["mod", "N"]} />
121
+ </MenubarItem>
122
+ <MenubarSeparator />
123
+ <MenubarItem variant="destructive">Delete document</MenubarItem>
124
+ </MenubarContent>
125
+ </MenubarMenu>
126
+ </Menubar>;
127
+ ```
128
+
129
+ The props you'll use: `MenubarContent align`, `MenubarItem variant` and `MenubarShortcut keys` (`["mod", "N"]`: ⌘N on a Mac, Ctrl+N elsewhere).
130
+
131
+ ## When to use
132
+
133
+ - The command set of an editor or admin tool, where people expect "File / Edit / View" and shortcuts.
134
+ - Not for site navigation (`NavigationMenu`), actions on one thing (`Menu`) or direct commands (`Toolbar`).
135
+
136
+ ## Examples
137
+
138
+ ### In a toolbar row
139
+
140
+ Menus aligned to the end of a document header.
141
+
142
+ ```tsx
143
+ import { Menubar, MenubarContent, MenubarItem, MenubarMenu, MenubarShortcut, MenubarTrigger } from "@zonsh/ui";
144
+
145
+ export function InAToolbar() {
146
+ return (
147
+ <div className="flex w-full max-w-2xl items-center justify-between gap-4 border-b border-border/60 pb-3">
148
+ <span className="font-mono text-xs text-muted-foreground">backup-photos.sh</span>
149
+ <Menubar>
150
+ <MenubarMenu>
151
+ <MenubarTrigger>Run</MenubarTrigger>
152
+ <MenubarContent align="end">
153
+ <MenubarItem>
154
+ Run once
155
+ <MenubarShortcut keys={["mod", "enter"]} />
156
+ </MenubarItem>
157
+ <MenubarItem>Run on schedule…</MenubarItem>
158
+ </MenubarContent>
159
+ </MenubarMenu>
160
+ <MenubarMenu>
161
+ <MenubarTrigger>Share</MenubarTrigger>
162
+ <MenubarContent align="end">
163
+ <MenubarItem>Copy link</MenubarItem>
164
+ <MenubarItem>Invite a teammate…</MenubarItem>
165
+ </MenubarContent>
166
+ </MenubarMenu>
167
+ </Menubar>
168
+ </div>
169
+ );
170
+ }
171
+ ```
172
+
173
+ ### On a narrow screen
174
+
175
+ A bar that does not fit its row folds into one menu button. Its menu holds every menu's items, each under its menu's name as a group, in one list a thumb can scroll — no menus opening sideways off a phone's edge. The bar comes back when there is room. Here, beside a file name in a 288px header.
176
+
177
+ ```tsx
178
+ import { Menubar, MenubarCheckboxItem, MenubarContent, MenubarItem, MenubarMenu, MenubarShortcut, MenubarTrigger } from "@zonsh/ui";
179
+ import { FilePlusIcon, SaveIcon } from "lucide-react";
180
+ import * as React from "react";
181
+
182
+ export function Narrow() {
183
+ const [wrap, setWrap] = React.useState(true);
184
+ return (
185
+ <div className="flex w-full max-w-72 items-center justify-between gap-3 border-b border-border/60 pb-3">
186
+ <span className="shrink-0 font-mono text-xs text-muted-foreground">field-notes.md</span>
187
+ <Menubar>
188
+ <MenubarMenu>
189
+ <MenubarTrigger>File</MenubarTrigger>
190
+ <MenubarContent>
191
+ <MenubarItem>
192
+ <FilePlusIcon />
193
+ New note
194
+ <MenubarShortcut keys={["mod", "N"]} />
195
+ </MenubarItem>
196
+ <MenubarItem>
197
+ <SaveIcon />
198
+ Save
199
+ <MenubarShortcut keys={["mod", "S"]} />
200
+ </MenubarItem>
201
+ </MenubarContent>
202
+ </MenubarMenu>
203
+ <MenubarMenu>
204
+ <MenubarTrigger>Edit</MenubarTrigger>
205
+ <MenubarContent>
206
+ <MenubarItem>
207
+ Undo
208
+ <MenubarShortcut keys={["mod", "Z"]} />
209
+ </MenubarItem>
210
+ <MenubarItem>Find and replace…</MenubarItem>
211
+ </MenubarContent>
212
+ </MenubarMenu>
213
+ <MenubarMenu>
214
+ <MenubarTrigger>View</MenubarTrigger>
215
+ <MenubarContent>
216
+ <MenubarCheckboxItem checked={wrap} onCheckedChange={setWrap}>
217
+ Wrap long lines
218
+ </MenubarCheckboxItem>
219
+ </MenubarContent>
220
+ </MenubarMenu>
221
+ <MenubarMenu>
222
+ <MenubarTrigger>Help</MenubarTrigger>
223
+ <MenubarContent>
224
+ <MenubarItem>Keyboard shortcuts</MenubarItem>
225
+ </MenubarContent>
226
+ </MenubarMenu>
227
+ </Menubar>
228
+ </div>
229
+ );
230
+ }
231
+ ```
232
+
233
+ `collapse="auto"` is the default; `collapse` folds it always (a phone layout of your own), `collapse={false}` never.
234
+
235
+ ## Behaviour
236
+
237
+ Hover only brightens a trigger, so a closed menu never looks open. One raised highlight marks the open trigger and glides along the bar; with a menu open, moving along opens the next in one shared, resizing surface.
238
+
239
+ ## Props
240
+
241
+ | Prop | Type | Default |
242
+ | ------------------------------------------- | ------------------------------------------ | -------------- |
243
+ | `Menubar.orientation` | `"horizontal" \| "vertical"` | `"horizontal"` |
244
+ | `Menubar.loopFocus` | `boolean` | `true` |
245
+ | `Menubar.modal` | `boolean` | `true` |
246
+ | `Menubar.disabled` | `boolean` | `false` |
247
+ | `Menubar.collapse` | `boolean \| "auto"` — one menu button, its menus as groups; `"auto"` while the bar would not fit | `"auto"` |
248
+ | `Menubar.labels` | `{ menu?: string }` — the collapsed button's name | English |
249
+ | `MenubarContent.side` | `"top" \| "right" \| "bottom" \| "left" …` | `"bottom"` |
250
+ | `MenubarContent.align` | `"start" \| "center" \| "end"` | `"start"` |
251
+ | `MenubarContent.sideOffset` | `number` | `8` |
252
+ | `MenubarContent.positioner` / `portal` | Base UI positioner / portal props | — |
253
+ | `MenubarItem.variant` | `"default" \| "destructive"` | `"default"` |
254
+ | `MenubarCheckboxItem.checked` | `boolean` | — |
255
+ | `MenubarRadioGroup.value` / `onValueChange` | `any` | — |
256
+
257
+ `MenubarMenu` is Base UI `Menu.Root`; `MenubarSub` is `Menu.SubmenuRoot`. Items are the `Menu` items with their own `data-slot` (`menubar-item` …); every `Menu` prop applies. Triggers expose Base UI's `data-popup-open` and `data-pressed`.
258
+
259
+ ## Brand rules
260
+
261
+ - **Do** keep menu names to one word: "File", "Edit", "View", "Run".
262
+ - **Do** give frequent commands a `MenubarShortcut` with `keys`, and wire the keys yourself.
263
+ - **Don't** put a menubar on a marketing or content page; it belongs to tools.
264
+ - **Don't** add icons to the bar's triggers or make them 38px; the bar is dense.
265
+ - **Don't** colour the open trigger. The raised material is the state.
266
+
267
+ ## Accessibility
268
+
269
+ - `role="menubar"` with `menuitem` triggers.
270
+ - `MenubarShortcut` is decorative (`aria-hidden`); register the shortcut on the page.
271
+ - Collapsed, the bar is one menu button named "Menu" (`labels.menu`, `messages.menubar.menu`); each menu is a `group` labelled by its name. The button takes a 44px tap area on a touch screen (`touch-target`).
272
+
273
+ ### Keyboard
274
+
275
+ | Key | What it does |
276
+ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------ |
277
+ | ← / → | Moves between the triggers, looping at the ends (swapped right to left); with a menu open, opens the neighbouring menu instead |
278
+ | Home / End | Moves to the first or last trigger |
279
+ | Enter / Space / ↓ | Opens the focused trigger's menu and highlights its first item |
280
+ | ↓ / ↑ | Moves the highlight in the open menu, looping at the ends |
281
+ | Enter / Space | Runs the highlighted item; a checkbox or radio item toggles and the menu stays open |
282
+ | Typing | Highlights the next item that starts with the letters typed |
283
+ | Escape | Closes the menu and returns focus to its trigger |
284
+ | Tab | Leaves the menubar: it is one Tab stop |
285
+
286
+ Submenus inside a menu take → and ← as in `Menu`.
287
+
288
+ ---
289
+
290
+ - Import: `import { Menubar, MenubarMenu, MenubarTrigger, MenubarContent, MenubarItem, MenubarLinkItem, MenubarCheckboxItem, MenubarRadioGroup } from "@zonsh/ui"`
291
+ - Source: `packages/ui/src/components/menubar.tsx`
292
+ - Primitive: `@base-ui/react/menubar` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/menubar.md`)