@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,416 @@
1
+ # zon — Brand guidelines
2
+
3
+ Version: 1.2 / October 2026
4
+
5
+ Status: the canonical brand guide. It lives in the zon/ui repository as `docs/brand.md`; zon.sh/ui renders it (Brand), and zon.sh/ui/brand.md is the file itself, for copy and download. Change it here only.
6
+
7
+ Brand portal: `zon.sh/ui` (the components and this guide) · `zon.sh/ui/brand.md` (this guide as Markdown)
8
+
9
+ Audience: designers, developers, writers, and AI assistants.
10
+
11
+ ## Instructions for AI assistants
12
+
13
+ Use this document as the design brief when creating zon materials. Preserve the identity described here; do not substitute a generic SaaS aesthetic. Follow the user's current instructions if they override this guide. This document describes design, not authorization to publish, modify infrastructure, or perform external actions.
14
+
15
+ Read `packages/ui/src/styles/tokens.css` and `fonts.css` in `@zonsh/ui` before implementing changes. They are the source of truth for live tokens and font files. Import components from `@zonsh/ui` rather than recreating controls. Preserve keyboard focus, labels, disabled states, responsive behavior, and reduced-motion support.
16
+
17
+ For a new composition:
18
+
19
+ 1. Start with monochrome surfaces and one clear hierarchy; add colour only where it carries a status or a category. Group with hairlines and whitespace; make something a card only when it can be picked up, moved or opened on its own.
20
+ 2. Use Licht for expressive headlines, Licht Sans for reading, controls and navigation, and Licht Mono for small labels and technical details.
21
+ 3. Use the zon mark as supplied, with generous space around it.
22
+ 4. Choose a single primary action; use the shared layered button treatment.
23
+ 5. Keep body text readable and the layout spacious in both themes.
24
+ 6. Describe a concrete problem and outcome. Do not invent customer results, metrics, testimonials, ratings, logos, awards, or certifications. Content the owner supplies, or that the project already has, is kept as it is. A claim you cannot know (what the product does, how it treats data, prices, delivery) is written as a placeholder for the owner to confirm, never stated as fact.
25
+ 7. Preview desktop and mobile, light and dark, keyboard navigation, and reduced motion before release.
26
+
27
+ ## 01 — Brand foundation
28
+
29
+ Name: **zon** — always lowercase, also at the start of a sentence. The domain is zon.sh.
30
+
31
+ zon.sh is home to Licht, its own typeface (zon.sh/licht), the gallery (zon.sh/gallery) and this component library, zon/ui (zon.sh/ui).
32
+
33
+ > zon's positioning, tagline and values belong here. This guide does not invent them: write them in before using it as a brief for marketing copy.
34
+
35
+ Visual interpretation: human warmth in the serif headlines; technical clarity in the monospace details; calm confidence in the monochrome palette, with a few quiet colours that carry meaning. Depth is subtle, spacing is generous, and decoration has a purpose.
36
+
37
+ ## 02 — Logo
38
+
39
+ The zon mark is a crescent moon: a circle with an offset circle cut out, so the light is widest at the foot and thins to two tips around a 30° opening, the whole turned 14°. It is flat and in one colour: the ink, `#141414`, on a light ground and the light, `#f6f6f4`, on a dark one.
40
+
41
+ In code, the mark comes from `@zonsh/ui`:
42
+
43
+ - `Logo`: the lockup, the mark beside the wordmark; `variant="compact"` is the header logo, whose name slides out on hover; `product="ui"` sets the product lockup, "zon/ui".
44
+ - `LogoMark`: the mark alone. Its colour is the token `--logo`, which follows the theme.
45
+ - `LogoLeft`, `LogoRight`: the two brackets, kept as art (the Spinner's `brackets` face, the bracket illustrations, the AsciiField's default shape). They are not the logo.
46
+
47
+ For documents, slides and other sites, use the files on zon.sh: `zon.sh/logo.svg` and `zon.sh/logo.png` (1024px, transparent) are the light crescent, for dark grounds; `zon.sh/logo-ink.svg` and `zon.sh/logo-ink.png` are the ink one, for light grounds. The favicon, `zon.sh/favicon.svg`, follows the system scheme: the ink in light mode, the light in dark mode. Link previews use `zon.sh/og.png`, the crescent on the site's dark ground.
48
+
49
+ Use the supplied artwork. Do not redraw the mark, stretch it, rotate it further, mirror it, recolour it, or add outlines, shadows or a glow. It is flat, and the 14° turn is part of it.
50
+
51
+ The wordmark is **zon** in Licht, the Light face, lowercase, as every headline: the lockup and the hero speak the same voice. Its x-height is centred on the moon. The name must remain accessible even when visually hidden.
52
+
53
+ Recommended usage rules:
54
+
55
+ - Leave clear space of a quarter of the mark's height around it.
56
+ - Start at 16px for the mark and 20px for the lockup; check smaller applications individually.
57
+ - Place the mark on a quiet, solid surface; on busy imagery, give it a calm area of its own.
58
+ - In code, `size` is the moon's height.
59
+
60
+ ## 03 — Color system
61
+
62
+ Surfaces, controls and type are monochrome: the page, cards, buttons (the primary included), fields, headlines and body copy. Colour comes in as small marks that carry meaning, never as decoration or as a brand accent.
63
+
64
+ **Status colours** have a fixed meaning everywhere:
65
+
66
+ | Token | Light | Dark | Means |
67
+ | --------------- | -------------------------- | --------------------------- | ---------------------------------------------------- |
68
+ | `--success` | `oklch(0.505 0.133 152)` | `oklch(0.76 0.16 152)` | Done, saved, sent, connected |
69
+ | `--warning` | `oklch(0.53 0.12 65)` | `oklch(0.78 0.15 75)` | Needs attention soon: nearly full, partial, expiring |
70
+ | `--info` | `oklch(0.52 0.15 250)` | `oklch(0.74 0.14 245)` | Neutral news: new, selected, unsaved, in progress |
71
+ | `--destructive` | `oklch(0.55 0.224 27.325)` | `oklch(0.704 0.191 22.216)` | Error, failed, a destructive action |
72
+
73
+ **Category tones** have no fixed meaning. The app decides what each one stands for — a file type, a phase, a kind of item — and keeps it the same everywhere:
74
+
75
+ | Token | Light | Dark |
76
+ | ---------------- | ----------------------- | ---------------------- |
77
+ | `--tone-blue` | `oklch(0.52 0.15 250)` | `oklch(0.74 0.14 245)` |
78
+ | `--tone-aqua` | `oklch(0.51 0.09 195)` | `oklch(0.78 0.12 195)` |
79
+ | `--tone-violet` | `oklch(0.53 0.17 300)` | `oklch(0.75 0.15 300)` |
80
+ | `--tone-magenta` | `oklch(0.54 0.2 340)` | `oklch(0.74 0.18 340)` |
81
+ | `--tone-orange` | `oklch(0.535 0.153 45)` | `oklch(0.76 0.15 50)` |
82
+ | `--tone-lime` | `oklch(0.51 0.13 130)` | `oklch(0.8 0.16 130)` |
83
+
84
+ All ten sit at about the same lightness, so none shouts over the others or over the greys, and each reads at 4.5:1 or better as text on its theme's page. Tailwind utilities follow the names: `text-warning`, `bg-info/10`, `border-tone-violet/30`.
85
+
86
+ How to use them:
87
+
88
+ - **Colour carries meaning.** A status, or a category people need to tell apart at a glance. Never decoration, emphasis or branding.
89
+ - **Small marks only.** Tag text, a 6px dot, an icon, a bar or meter segment, a 1px edge, a 10–20% tint behind its own text. Never a coloured button, card, page, section or headline.
90
+ - **Never colour alone.** Pair it with text, an icon or a legend, so it reads in greyscale, in forced colours and for people who cannot tell the hues apart.
91
+ - **One meaning per colour.** Within an app, a tone always means the same kind, and a status colour only its status. Do not mix tones and status colours in one set of marks; they would read as one scale.
92
+ - **Few per view.** Most of a screen stays grey. If everything is coloured, nothing is.
93
+
94
+ The components carry this for you: `Tag` (tinted status and tone variants), `Badge`, `Alert` and `toast` (status), `Progress` and `Meter` (`tone`), and `ChartContainer` (`palette="tones"`).
95
+
96
+ Core CSS tokens from `tokens.css`:
97
+
98
+ | Token | Light | Dark | Purpose |
99
+ | ---------------------- | ------------------ | -------------------- | ------------------ |
100
+ | `--background` | `oklch(0.99 0 0)` | `oklch(0.07 0 0)` | Page canvas |
101
+ | `--foreground` | `oklch(0.145 0 0)` | `oklch(0.985 0 0)` | Main text |
102
+ | `--foreground-soft` | `oklch(0.37 0 0)` | `oklch(0.75 0 0)` | Secondary text |
103
+ | `--muted-foreground` | `oklch(0.556 0 0)` | `oklch(0.66 0 0)` | Supporting text |
104
+ | `--card` | `oklch(1 0 0)` | `oklch(0.115 0 0)` | Card surface |
105
+ | `--primary` | `oklch(0.205 0 0)` | `oklch(0.985 0 0)` | Semantic primary |
106
+ | `--primary-foreground` | `oklch(0.985 0 0)` | `oklch(0.145 0 0)` | Text on primary |
107
+ | `--border` | `oklch(0.922 0 0)` | `oklch(1 0 0 / 10%)` | Dividers |
108
+ | `--control-surface` | `#f5f5f5` | `#1e1e1e` | Secondary buttons |
109
+ | `--control-hover` | `#ebebeb` | `#2a2a2a` | Hover surface |
110
+ | `--field-surface` | `#ffffff` | `#161616` | Form field fill |
111
+ | `--field-edge` | `#d4d4d4` | `#393939` | Form field outline |
112
+ | `--control-focus` | `#737373` | `#999999` | Keyboard focus |
113
+
114
+ Primary buttons have a specific layered treatment: their base fill is `#292929` in light mode and `#cbcbcb` in dark mode — the dark fill mirrors the light one by perceived contrast, so its glow and rim have room to read. Do not replace these with a flat `--primary` fill when reproducing the button.
115
+
116
+ Prefer semantic CSS variables over copied color literals in new website components. Do not use low-contrast decorative grays for essential text. Check the actual foreground/background pair at its final size; a token alone does not guarantee accessible contrast.
117
+
118
+ ## 04 — Typography
119
+
120
+ | Role | Family | Application |
121
+ | ------------------ | ---------- | ------------------------------------------------------------- |
122
+ | Display / headings | Licht | Hero text, section titles, editorial statements, the wordmark |
123
+ | Body / controls | Licht Sans | Paragraphs, buttons, form fields, dropdowns, navigation |
124
+ | UI / technical | Licht Mono | Small labels, numbers, indices, ASCII art |
125
+
126
+ All three faces are our own: Licht, Licht Sans and Licht Mono. Never hotlink them, or any
127
+ future face, from a third-party host: that leaks the visitor's IP before consent.
128
+
129
+ They ship as a package, `licht`, and `@zonsh/ui` depends on it: `@import
130
+ "@zonsh/ui/styles.css"` brings the @font-face rules, and the app's bundler copies the WOFF2 files
131
+ into its build, so the browser only ever requests them from the site itself. Nothing to set up:
132
+ no proxy, no rewrite, no plugin. A new Licht release is a new version of `licht`, taken
133
+ up by a new `@zonsh/ui`; the lockfile pins the faces, so a release never changes a site (or this
134
+ repository's screenshots) by itself.
135
+
136
+ Licht implementation note: headlines are set in Licht Light (weight 300), and only Light.
137
+ `licht` has Licht's real cuts from 100 to 900, upright and italic, but hierarchy comes from
138
+ scale, never from weight: the heading rules and the `font-heading` and `display` utilities set 300
139
+ and turn font synthesis off, and a bold word in a headline keeps its Light. Never put a weight
140
+ utility on Licht text. Licht Sans and Licht Mono are different: they have real cuts from 100 to
141
+ 900 (Licht Mono to 800), one file each, each with an italic, and Tailwind's `font-*` weight
142
+ utilities and `italic` pick them.
143
+
144
+ Font files: the portal offers the faces for download under **Assets**. Licht, Licht Sans and
145
+ Licht Mono are ours, so their terms are ours to set; decide them
146
+ before treating the portal download as a public release. The portal is public and
147
+ unauthenticated, so treat anything listed there as published.
148
+
149
+ Current website scale (`Display`, `Heading`, `Lead`, `Text`, `Eyebrow` in `@zonsh/ui`):
150
+
151
+ - Hero: 48px on small screens, 60px at `sm`, 72px at `md`; line height 1.03.
152
+ - Section headings: typically 30–48px; line height around 1.05–1.1.
153
+ - Body default: 17px; line height 1.6. Hero supporting copy: 18–20px.
154
+ - UI controls: typically 14px. Input text stays at least 16px on mobile.
155
+ - Eyebrows: 12px Licht Mono, uppercase, tracking 0.18em, muted.
156
+ - Heading tracking: -0.02em.
157
+
158
+ Use mixed case for headlines. Reserve all caps for short labels. Keep long copy in Licht Sans, not Licht or monospace. Preserve German characters: Ä Ö Ü ä ö ü ß. Let headings wrap naturally on small screens.
159
+
160
+ ### Numbers
161
+
162
+ A number is typography, not a widget. Set it with the type you already have — `Stat` sets a
163
+ product figure exactly as below — and spend the effort on whether the number deserves to be there.
164
+
165
+ - **Editorial facts** (marketing pages, specimens): a large Licht numeral (64–88px, line height 1,
166
+ `tabular-nums`) with a small Licht unit word beside it and one plain sentence below. Three at
167
+ most, between hairlines.
168
+ - **Product figures** (dashboards, reports): Licht Mono, `tabular-nums`, an eyebrow label above.
169
+ In a dashboard, use `<dl>` with `<dt>` labels and `<dd>` values.
170
+ - **In a sentence**: put the figure in mono inside running text when the sentence is the point.
171
+
172
+ ```tsx
173
+ <p className="flex items-baseline gap-2">
174
+ <span className="font-heading text-[72px] leading-none font-light tabular-nums">173</span>
175
+ <span className="font-heading text-xl font-light text-foreground-soft">glyphs</span>
176
+ </p>
177
+ ```
178
+
179
+ - **Only real numbers.** Never invent savings, percentages, customer counts or growth figures. If a
180
+ number isn't measured and supportable, write the sentence without it.
181
+ - **Say where it comes from** when it isn't obvious ("in the last 30 days", "per week").
182
+ - **One unit, said plainly**: "3 h", "42 s", "1,284 downloads" — no "10x", no "up to". Keep the unit in
183
+ the same text as the number, so it is read together.
184
+ - **Few and large, or many and small.** Three editorial facts, or a dense row of mono figures —
185
+ never a wall of big numbers.
186
+ - Licht numerals stay weight 300; never bold a number for emphasis — size does that. Use
187
+ `tabular-nums` for anything that changes or sits in a column.
188
+
189
+ ## 05 — Buttons and form controls
190
+
191
+ Reuse `Button`, `Input`, `Textarea`, `Select`, `ToggleGroup`, `Checkbox`, `Field` and `Form` from `@zonsh/ui`.
192
+
193
+ ### Surfaces: regions, cards and tables
194
+
195
+ The default way to group content is a hairline rule and whitespace, not a box. Content
196
+ sections are separated by `border-t border-border/60` with generous padding and
197
+ `last:border-b`, and nothing is enclosed — a `plain` card is exactly that: a top rule and
198
+ padding, with no background, no radius and no border around it. Follow that.
199
+ Do not wrap content in a card because it feels tidier; whitespace and a fine rule carry
200
+ the structure, and boxing every group flattens the hierarchy instead of clarifying it.
201
+
202
+ A `card` (the default variant) exists for **objects only** — things that could be picked up, moved or opened
203
+ on their own (a quote card, a product, a deal on a board, a dialog, a table). A part of the page is
204
+ a `region`; a `plain` one is just a top rule and padding.
205
+ The default way to group content is still a hairline and whitespace, so reach for a card last.
206
+
207
+ **Fewer cards.** A page section, a form, a pricing table, a settings page and a sign-in form
208
+ on a page are not cards: they _are_ the page. Build them from hairline sections (`Section`,
209
+ `Separator`, `hairline`), whitespace and type hierarchy — a Licht heading, a mono eyebrow, muted
210
+ help text — with divided lists (`Item` rows under hairlines) and two-column rows, the label and
211
+ its description on the left and the control on the right. When a part needs a ground of its own,
212
+ make it a square `surface-container` region. Never put a card inside a card, and never a row of
213
+ identical cards where a divided list would do.
214
+
215
+ Every surface that encloses something shares one **material**: a `--field-edge` border,
216
+ a 160° gradient fill, and an inset top highlight. That is what makes a surface feel like
217
+ part of this system rather than a plain bordered box. Do not build a flat container.
218
+
219
+ ```css
220
+ /* .surface-container — the shared material */
221
+ border: 1px solid var(--field-edge);
222
+ background: linear-gradient(160deg, var(--control-surface), var(--field-surface) 55%);
223
+ box-shadow: inset 0 1px 0 var(--control-highlight);
224
+ ```
225
+
226
+ **Radius then says what kind of thing it is.** Three tiers, nothing in between:
227
+
228
+ - **Controls are rounded to the control vocabulary.** Buttons 12px, inputs and select
229
+ triggers 10px, select items and swatch buttons 7px, icon buttons fully round, menus,
230
+ toasts and expandable panels 12px. Never introduce a new radius for a control.
231
+ - **Regions are square.** A region is part of the page: panels, specimen sheets,
232
+ posters, covers, grids, sections. It takes the material above and `border-radius: 0`.
233
+ The border already separates it from the page; rounding would make it look detachable
234
+ when it is not.
235
+ - **Objects are cards, at 20px.** A card is a discrete thing sitting _on_ the page
236
+ rather than a region _of_ it — a quote card, a product, a dialog, a table.
237
+ It takes the material plus 20px radius, responsive padding, and a soft drop shadow
238
+ that lifts it off the page.
239
+
240
+ ```css
241
+ /* .surface-card — material, plus object geometry. Tables use this too. */
242
+ border-radius: 20px;
243
+ padding: 24px; /* 32px at sm, 40px at md */
244
+ box-shadow:
245
+ inset 0 1px 0 var(--control-highlight),
246
+ 0 4px 16px rgb(0 0 0 / 0.04);
247
+ ```
248
+
249
+ The one thing that skips the material is a surface whose fill _is_ the content: a
250
+ colour swatch, an image cover, a logo shown on a fixed light or dark ground. Those
251
+ keep their own flat background and take only the border. Everything else gets it.
252
+
253
+ Use `Card` — `variant="region"` or the default `card` (the `surface-container` and `surface-card`
254
+ utilities) — rather than re-deriving either. The `0 4px 16px` at 4% black is the only drop shadow in the system and it
255
+ belongs to cards alone: the rule against heavy floating shadows still holds everywhere else,
256
+ and a region never gets one.
257
+
258
+ Deciding between the two: ask whether the thing could be picked up and moved somewhere
259
+ else on its own. A quote card, a product card, a data table could. A section panel, a
260
+ specimen sheet, a page cover could not — they are that part of the page. When genuinely
261
+ unsure, prefer the region: the default way to group content here is still a rule and
262
+ whitespace, and boxing every group flattens the hierarchy rather than clarifying it.
263
+
264
+ A form that stands alone as an object — in a dialog, or the one thing on an otherwise empty
265
+ screen — may be a `Card`, and then carries exactly the card treatment. A form on a page is not.
266
+ Two things apply to every card:
267
+
268
+ - **Padding belongs to the card**, not the call site. It used to be applied by each
269
+ usage, and the two usages had already drifted to different values.
270
+ - **The `--field-edge` border is what ties a card to its contents.** A card holding
271
+ inputs wears the same edge as the inputs. Reaching for `--border` instead is the most
272
+ common way to make a card look subtly foreign to what is inside it.
273
+
274
+ **On phones, the native picker.** Custom popups on the desktop, the platform's own picker on a
275
+ phone: it is larger, scrolls natively and is what the thumb expects. `Select` and `DatePicker`
276
+ (and `DateTimePicker`) do this by default (`native="touch"`): a `NativeSelect`, or a native date
277
+ field, when the pointer is coarse and the screen is phone-sized, and the custom popup everywhere
278
+ else. Use `NativeSelect` outright in plain forms. Keep the custom popup on a phone too
279
+ (`native={false}`) only for multiple choice, options with icons or descriptions, and a date range.
280
+
281
+ `ToggleGroup` is the segmented control. Use it for 2–5 short, mutually exclusive options where comparing them is the point — a `Select` hides the alternatives behind a click, which is the wrong trade when seeing them side by side is the value. Past five options, or when the labels are long, go back to `Select`. It renders as a recessed track holding one raised, current segment: field treatment outside, secondary-button treatment on the active item.
282
+
283
+ Current geometry:
284
+
285
+ - Text buttons: 12px corner radius.
286
+ - Icon buttons (`size="icon"`): circular, `9999px` radius.
287
+ - Inputs / textareas / select triggers: 10px radius (`--radius-control`).
288
+ - Select menus: 12px radius; items: 7px radius, at least 38px tall.
289
+ - Navigation and sidebar rows: 12px radius, 38px tall, matching text buttons.
290
+ - Cards, tables and the form panel: 20px radius, 24/32/40px padding, soft drop shadow.
291
+ - Regions (section panels, covers, specimen sheets, posters, grids): square, no shadow.
292
+ - Checkboxes: 18 × 18px, 5px radius.
293
+
294
+ Control heights use three steps and nothing in between:
295
+
296
+ - **30px, dense.** For compact, data-heavy surfaces: toolbars, table rows, filter bars,
297
+ settings panels, admin and dashboard screens — anywhere controls are stacked close
298
+ enough that 38px would push the content off screen. Reach for it by the surface being
299
+ dense, not by the control being minor: a dense screen uses 30px throughout rather than
300
+ mixing steps. Set with `size="sm"` on `Button`, `Select` and `Input`. A segmented
301
+ control's inner segments already sit at 30px, so a dense `ToggleGroup` needs no change.
302
+ - **38px, the default.** Inputs, default select triggers, select menu items, default
303
+ buttons, and navigation or sidebar rows. This is the height to reach for on ordinary
304
+ marketing and content pages, unless there is a reason not to.
305
+ - **46px, prominent.** Reserved for the calls to action that carry a page: the hero
306
+ pair, a floating CTA, and section-closing CTAs (`size="lg"`).
307
+ - Icon-only buttons are circular and 2px under the default height (36 × 36px at zon's); they are a shape, not a step on this scale.
308
+ - A segmented control is 38px overall. Its segments are 30px inside a 3px track, which is
309
+ internal geometry rather than a separate step — the control is what sits on the grid.
310
+ - Textareas: at least 140px tall; allow vertical resizing.
311
+
312
+ Set every one of these with `min-height`, never by padding a box until it happens to
313
+ measure right. Padding-derived heights resolve against `line-height`, so they drift the
314
+ moment a font or size changes — that is how this system previously ended up with select
315
+ items at 40px, sidebar rows at 41px, hero buttons at 46px and a floating CTA at 48px, none
316
+ of them deliberate. Do not add a third height, and do not override one of these with a
317
+ utility class such as `h-12` on the element.
318
+
319
+ **Density** moves the whole ladder, not one control. A theme sets it from Dense to Spacious
320
+ (30 / 34 / 38 / 42 / 46px default controls; zon's own is 38): the three steps keep their
321
+ proportions (24 / 30 / 36 at Dense), and the padding, gaps and type inside every component
322
+ follow, the type by half as much and never under 10px. The steps keep their jobs at every
323
+ density — `size="sm"` is still the dense surface and `size="lg"` still the call to action — and
324
+ what the brand fixes in px stays: checkboxes, radios, switches, slider thumbs and badges.
325
+
326
+ Primary buttons use a fine dark outer stroke, an inner highlight, and subtle top/bottom shading. Secondary buttons use a quiet surface with inset highlights. Fields are recessed. Keep this dimensionality restrained; do not add glow, animated gradients, thick outlines, or heavy floating shadows.
327
+
328
+ This applies to **every** interactive surface, not only the components listed above. Navigation rows, sidebar items, tabs, cards that respond to a pointer, and anything else that lights up on hover or marks itself as current must use the same raised treatment as a secondary button (`material-raised`, or `material-row` for surfaces that are flat at rest), and must not invent a flat fill:
329
+
330
+ ```css
331
+ background-color: var(--control-surface); /* var(--control-hover) while hovered */
332
+ background-image: linear-gradient(180deg, var(--control-inner-edge), transparent);
333
+ box-shadow:
334
+ 0 0 0 1px var(--control-edge),
335
+ inset 0 1px 0 var(--control-highlight),
336
+ inset 0 0 0 1px var(--control-inner-edge);
337
+ ```
338
+
339
+ Three mistakes to avoid. Do not swap `background` alone with no outer stroke and no `--control-highlight` inset, which reads as a flat block next to a real button. Do not use `--control-surface` as a hover or current state, because it is the _resting_ fill of a secondary button and the row ends up dimmer than an untouched control; `--control-hover` is the hovered fill. Do not omit the 150ms transition on `background-color`, `color`, and `box-shadow`, or the surface will snap while every neighbouring control eases.
340
+
341
+ State guidance:
342
+
343
+ - Hover: short surface-color changes on hover-capable devices.
344
+ - Pressed: inset shadow rather than layout movement.
345
+ - Focus-visible: 2px `--control-focus` outline sitting flush on the control (`outline-offset: 0`). Text fields — inputs, textareas, input groups — take a softer focus edge instead: the 1px border shifts halfway to `--control-focus`, with no ring, because a ring on every click is noise and the caret already marks where typing goes. An open select takes the same softer edge; a field that is a button (a select's trigger) keeps the ring for keyboard focus, which a click never shows. Never add an outline offset, a detached halo, or a gap between the control and its focus ring. Never hide keyboard focus on anything without a caret.
346
+ - Disabled: noninteractive, visually subdued.
347
+ - Error: use destructive color plus a readable error message, not color alone.
348
+ - Every icon-only button needs an accessible name. Every field needs a visible label.
349
+ - Touch: on a touch screen every control under 44px takes a 44 × 44px tap area around it (`touch-target`), with nothing drawn; the geometry stays 30 / 38 / 46.
350
+
351
+ Primary labels name the outcome in a few words: “Save changes”, “Create project”, “Get started”, “Send message”. Secondary actions describe their destination, e.g. “See the components”.
352
+
353
+ ## 06 — Layout, imagery, icons, and motion
354
+
355
+ Website content container: `Container` / `container-page` — `max-w-7xl` (80rem / 1280px), centered. Horizontal padding: 24px, then 40px at `sm`, then 64px at `lg`.
356
+
357
+ Section spacing token: `--section-pad: clamp(3.5rem, 7vw, 7rem)`.
358
+
359
+ The page ground of zon.sh is `--background` under a still film grain and, in dark, a faint light from above. It is zon.sh's own look, not the design system's: a zon.sh page imports `@zonsh/ui/brand.css` after `@zonsh/ui/styles.css` to get it, and an app built on the library without it stands on plain `--background`. Never recreate the grain by hand.
360
+
361
+ Recommended spacing rhythm: 4, 8, 12, 16, 24, 32, 48, 64, 96px. Use whitespace and fine rules to separate content; avoid making every paragraph a card.
362
+
363
+ Use the illustration library (`Illustration`): the editorial line art of zon.sh, the isometric objects, the light-table drawings and the spec sheets, all line art in the current ink and all bracket-aware — keep them uncoloured. ASCII (`AsciiField`) is a supporting visual language, not a type treatment for body text. Preserve the logo's silhouette in illustrative interpretations. Avoid generic neon AI graphics or unsubstantiated product screenshots.
364
+
365
+ Icons come from `lucide-react`. Keep a consistent outline style, typically 16–20px in controls with the library's default 2px stroke. Do not mix filled and outlined icon families arbitrarily.
366
+
367
+ Motion should clarify interaction or reveal content gently; [docs/motion.md](motion.md) has the details:
368
+
369
+ - Control transition: 150ms, `cubic-bezier(0.16, 1, 0.3, 1)` (`--ease`); gliding indicators 240ms on a softer ease-out (`--ease-glide`); moves the interface makes on its own ease in and out (`--ease-move`).
370
+ - Only what someone sees now and then moves. Nothing the keyboard does animates (but for the digit roll and the OTP ring, which show what a key changed), and what is seen all day moves little and fast.
371
+ - Leaving is quicker than arriving. Motion that answers an action ends within 300ms.
372
+ - A press shows in the material, never as movement.
373
+ - The logo reveal uses short opacity and spacing transitions.
374
+ - Respect `prefers-reduced-motion`: movement stops, fades stay. Readable content must not depend on animation.
375
+ - The page never smooth-scrolls on its own (no `scroll-behavior: smooth`): the reader's own scroll
376
+ is theirs. A scroll the interface makes for them (a jump to a section, a table of contents keeping
377
+ its current entry in view, a carousel, a conversation following a reply) may glide, and jumps
378
+ under reduced motion.
379
+ - Keep mobile hero blobs static, as in the current performance treatment.
380
+ - Do not add continuous large blur/filter animations to mobile pages.
381
+
382
+ ## 07 — Voice and writing
383
+
384
+ Less noise, more signal: say it once, plainly, and stop. Be precise, quiet, direct and practical. Prefer the concrete word and the short sentence; leave out what does not help the reader. Write in clear English, or natural German where a page needs it, with the same factual promise in both.
385
+
386
+ zon.sh itself writes in lowercase — “less noise. more signal.” — as part of its look. In product copy and documentation, use sentence case; keep the name **zon** lowercase in running text. Short mono labels set everything in capitals, the name included (`ZON.SH`).
387
+
388
+ Say: “Install the package and import the components you need.”
389
+
390
+ Avoid: “Unlock limitless potential with revolutionary AI.”
391
+
392
+ Say: “Every component is documented once, for people and agents.”
393
+
394
+ Avoid: “The ultimate one-size-fits-all platform.”
395
+
396
+ German example: “Weniger Rauschen. Mehr Signal.”
397
+
398
+ Avoid unsupported guarantees, invented numbers, jargon-heavy sentences, pressure tactics, and excessive superlatives.
399
+
400
+ The rule is about inventing, not about deleting. Quotes, ratings, logos, team photos and figures that the owner supplies, or that the page being redesigned already has, are theirs: keep them as they are (fix an obvious typo), and point out any that look like placeholders. What nobody has told you — a feature, what happens to people's data, a price, a delivery time — goes in as a marked placeholder ("[Confirm: notes are deleted after 30 days]") and on a list for the owner, not as a plain statement of fact.
401
+
402
+ zon/ui is for any product — a shop, a notebook, a course, a dashboard, a tool for one person. Write copy for the product at hand, not for zon's own site, and in examples vary the domain so no single trade becomes the house style.
403
+
404
+ ## 08 — Assets and handoff
405
+
406
+ In code, use the assets that ship with `@zonsh/ui`. For everything else, use the mark on zon.sh (`logo.svg`, `logo.png`).
407
+
408
+ This Markdown file is the portable AI/design handoff. zon.sh/ui renders this exact file, and zon.sh/ui/brand.md serves it for copy and download. Keep it in sync when changing brand tokens or component conventions, and keep it here — it is the only copy.
409
+
410
+ ### Accessibility: contrast themes and large text
411
+
412
+ - **Forced colours.** In a contrast theme (Windows) the browser paints with a few system colours and drops the material's fills, gradients and shadows. Every state must survive that: focus is an outline (in `Highlight`), a chosen radio, an "on" switch, the current tab and a progress value take system colours (`Highlight`, `CanvasText`), icons ink with `currentColor`, and disabled controls stay dimmed. Never carry a state in a fill or a shadow alone.
413
+ - **Text at 200%.** Text set twice as large, with nothing else changed, must stay whole: labels grow their controls or end in "…", lines keep their spacing, and the page never scrolls sideways at a desktop width.
414
+ - **Narrow screens.** A row that runs out of room folds (one menu for a menubar, "…" in a breadcrumb, a compact pager) or scrolls inside itself with faded ends; it never widens the page.
415
+
416
+ Final review: logo integrity, correct fonts and weights, theme contrast, responsive line wrapping, keyboard focus, disabled/error states, reduced motion, accurate claims, and current export assets.
@@ -0,0 +1,199 @@
1
+ # Accordion
2
+
3
+ ```tsx
4
+ import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
5
+
6
+ const faq = [
7
+ {
8
+ q: "Can I learn at my own pace?",
9
+ a: "Yes. Every lesson is recorded and stays available, so you can pause for a week and pick up exactly where you left off.",
10
+ },
11
+ {
12
+ q: "What if I miss a live session?",
13
+ a: "The recording is posted the same evening, and you can ask questions about it in the course forum.",
14
+ },
15
+ {
16
+ q: "Can I get a refund?",
17
+ a: "Within 14 days of buying the course, as long as you have watched fewer than a third of the lessons. Write to us and we will refund you in full.",
18
+ },
19
+ ];
20
+
21
+ export function Faq() {
22
+ return (
23
+ <Accordion className="max-w-2xl">
24
+ {faq.map((item) => (
25
+ <AccordionItem key={item.q} value={item.q}>
26
+ <AccordionTrigger>{item.q}</AccordionTrigger>
27
+ <AccordionPanel>{item.a}</AccordionPanel>
28
+ </AccordionItem>
29
+ ))}
30
+ </Accordion>
31
+ );
32
+ }
33
+ ```
34
+
35
+ Questions or steps that open in place, separated by hairlines, with no boxes. Titles are 18px Licht Sans with an optional mono index; a plus turns into × when open.
36
+
37
+ ## Usage
38
+
39
+ ```tsx
40
+ import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
41
+
42
+ <Accordion>
43
+ <AccordionItem value="start">
44
+ <AccordionTrigger>Can I learn at my own pace?</AccordionTrigger>
45
+ <AccordionPanel>Yes. Every lesson is recorded and stays available.</AccordionPanel>
46
+ </AccordionItem>
47
+ </Accordion>;
48
+ ```
49
+
50
+ The props you'll reach for: `multiple`, `defaultValue`, and `index` on the trigger.
51
+
52
+ ## When to use
53
+
54
+ - FAQs, numbered steps, product details people scan by title.
55
+ - `size="display"` (Licht) when the titles are the headline.
56
+ - One hidden block is a `Collapsible`.
57
+ - Not for content everyone needs; skimmers miss what's closed.
58
+
59
+ ## Examples
60
+
61
+ ### Steps
62
+
63
+ `index` and `size="display"`; `inset` lines the panel up with the title.
64
+
65
+ ```tsx
66
+ import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
67
+
68
+ const steps = [
69
+ {
70
+ title: "Choose",
71
+ body: "Pick the photos you want from your albums; duplicates and blurry shots are flagged.",
72
+ },
73
+ {
74
+ title: "Arrange",
75
+ body: "Drag them onto pages, choose a layout for each spread and add captions where they help.",
76
+ },
77
+ {
78
+ title: "Proof",
79
+ body: "Page through a full preview at print size and fix anything that is cropped too tight.",
80
+ },
81
+ { title: "Print", body: "Choose paper and binding, and the book is printed and posted to you." },
82
+ ];
83
+
84
+ export function Steps() {
85
+ return (
86
+ <Accordion size="display" defaultValue={["Choose"]} className="max-w-3xl">
87
+ {steps.map((step, i) => (
88
+ <AccordionItem key={step.title} value={step.title}>
89
+ <AccordionTrigger index={String(i + 1).padStart(2, "0")}>{step.title}</AccordionTrigger>
90
+ <AccordionPanel inset>{step.body}</AccordionPanel>
91
+ </AccordionItem>
92
+ ))}
93
+ </Accordion>
94
+ );
95
+ }
96
+ ```
97
+
98
+ ### Multiple
99
+
100
+ `multiple` lets several panels open.
101
+
102
+ ```tsx
103
+ import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
104
+
105
+ // faq: as in the first example on this page that uses them.
106
+
107
+ export function Multiple() {
108
+ return (
109
+ <Accordion multiple defaultValue={[faq[0]?.q]} className="max-w-2xl">
110
+ {faq.map((item) => (
111
+ <AccordionItem key={item.q} value={item.q}>
112
+ <AccordionTrigger>{item.q}</AccordionTrigger>
113
+ <AccordionPanel>{item.a}</AccordionPanel>
114
+ </AccordionItem>
115
+ ))}
116
+ </Accordion>
117
+ );
118
+ }
119
+ ```
120
+
121
+ ### Disabled
122
+
123
+ A disabled item stays in place at half opacity, shut and unfocusable; say in the title when it opens. `disabled` on the `Accordion` shuts every item.
124
+
125
+ ```tsx
126
+ import { Accordion, AccordionItem, AccordionPanel, AccordionTrigger } from "@zonsh/ui";
127
+
128
+ export function Disabled() {
129
+ return (
130
+ <Accordion className="max-w-2xl">
131
+ <AccordionItem value="syllabus">
132
+ <AccordionTrigger>What does the course cover?</AccordionTrigger>
133
+ <AccordionPanel>
134
+ Twelve weeks of watercolour: washes, layering, colour mixing and painting outdoors, with a finished
135
+ piece every fortnight.
136
+ </AccordionPanel>
137
+ </AccordionItem>
138
+ <AccordionItem value="certificate" disabled>
139
+ <AccordionTrigger>Your certificate (after the last lesson)</AccordionTrigger>
140
+ <AccordionPanel>Download your certificate as a PDF.</AccordionPanel>
141
+ </AccordionItem>
142
+ <AccordionItem value="materials">
143
+ <AccordionTrigger>Which materials do I need?</AccordionTrigger>
144
+ <AccordionPanel>
145
+ A starter set of twelve pans, two round brushes and a block of cold-pressed paper. The list in the
146
+ first lesson names brands at three prices.
147
+ </AccordionPanel>
148
+ </AccordionItem>
149
+ </Accordion>
150
+ );
151
+ }
152
+ ```
153
+
154
+ ## Props
155
+
156
+ | Prop | Type | Default |
157
+ | ------------------------------------------------- | --------------------------------------- | ----------- |
158
+ | `Accordion.size` | `"default" \| "display"` | `"default"` |
159
+ | `Accordion.multiple` | `boolean` | `false` |
160
+ | `Accordion.defaultValue` | `any[]` | — |
161
+ | `Accordion.value` / `onValueChange` | controlled open items | — |
162
+ | `AccordionItem.value` | `any` | auto |
163
+ | `AccordionItem.disabled` / `Accordion.disabled` | `boolean` | `false` |
164
+ | `AccordionTrigger.index` | `ReactNode` — e.g. `"01"` | — |
165
+ | `AccordionTrigger.headerProps` | props for the `<h3>` wrapper | — |
166
+ | `AccordionPanel.inset` | `boolean` — align with an indexed title | `false` |
167
+ | `AccordionPanel.keepMounted` / `hiddenUntilFound` | `boolean` | `false` |
168
+
169
+ Other Base UI `Accordion` props are forwarded. Data attributes: `data-size` on the root, `data-open` on items and panels, `data-panel-open` on the trigger, `data-disabled` on a disabled item and its trigger.
170
+
171
+ ## Brand rules
172
+
173
+ - **Do** let the hairline and whitespace carry the structure.
174
+ - **Do** write titles as the question or the step, specific and short.
175
+ - **Don't** put the accordion, or each item, in a `Card`.
176
+ - **Don't** swap the plus for a chevron or add a fill on hover.
177
+ - **Don't** use Licht for long titles; `display` is for short editorial headings.
178
+
179
+ ## Accessibility
180
+
181
+ - Each trigger is a `<button>` inside an `<h3>`, with `aria-expanded` and `aria-controls`.
182
+ - The index is read as part of the button text, so keep it short.
183
+ - The height opens and closes in `--duration-glide` (240ms) on `--ease-glide`, and is instant under `prefers-reduced-motion`.
184
+
185
+ ### Keyboard
186
+
187
+ | Key | What it does |
188
+ | ------------- | ------------------------------------------------ |
189
+ | Tab | Moves to the next trigger, or into an open panel |
190
+ | Shift+Tab | Moves back |
191
+ | Enter / Space | Opens or closes the focused item |
192
+
193
+ Each trigger is its own Tab stop; arrow keys don't move between them (following the APG).
194
+
195
+ ---
196
+
197
+ - Import: `import { Accordion, AccordionItem, AccordionTrigger, AccordionPanel } from "@zonsh/ui"`
198
+ - Source: `packages/ui/src/components/accordion.tsx`
199
+ - Primitive: `@base-ui/react/accordion` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/accordion.md`)