@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,296 @@
1
+ # Calendar
2
+
3
+ ```tsx
4
+ import { Calendar } from "@zonsh/ui/calendar";
5
+ import { addDays, startOfToday } from "date-fns";
6
+ import * as React from "react";
7
+
8
+ /** A calendar shown inline is an object on the page, so it sits on a card. */
9
+ const card = "surface-card w-fit [--card-padding:4px]";
10
+
11
+ export function Basic() {
12
+ const [date, setDate] = React.useState<Date | undefined>(() => addDays(startOfToday(), 3));
13
+ return (
14
+ <div className={card}>
15
+ <Calendar mode="single" selected={date} onSelect={setDate} />
16
+ </div>
17
+ );
18
+ }
19
+ ```
20
+
21
+ react-day-picker v10 in the zon material: a Licht caption, mono weekday eyebrows and 38px days with 7px corners. Today has a dot, the selection takes the primary fill, a range's middle sits on the hover fill, and disabled days are struck through. It has no surface of its own: in a `DatePicker` it sits in the popover; inline on a page, put it on a card.
22
+
23
+ ## Usage
24
+
25
+ Calendar has its own entry, `@zonsh/ui/calendar`, and needs the optional dependency `react-day-picker`.
26
+
27
+ ```bash
28
+ pnpm add react-day-picker
29
+ ```
30
+
31
+ ```tsx
32
+ import { Calendar } from "@zonsh/ui/calendar";
33
+
34
+ const [date, setDate] = React.useState<Date>();
35
+
36
+ <Calendar mode="single" selected={date} onSelect={setDate} />;
37
+ ```
38
+
39
+ The props you'll reach for: `mode`, `selected` / `onSelect`, `disabled`.
40
+
41
+ ## When to use
42
+
43
+ - A date where the weekday and its neighbours matter: a call, a delivery, a workshop; a range (`mode="range"`) or several days (`mode="multiple"`).
44
+ - In a form, use `DatePicker`, which opens the calendar from a field.
45
+ - Dates people know by heart (a birthday) are faster typed; if you must use a calendar, use `captionLayout="dropdown"`.
46
+
47
+ ## Examples
48
+
49
+ ### Range
50
+
51
+ Two months side by side; where they do not fit they stack, each arrow staying with its month.
52
+
53
+ ```tsx
54
+ import { Calendar, type DateRange } from "@zonsh/ui/calendar";
55
+ import { addDays, startOfToday } from "date-fns";
56
+ import * as React from "react";
57
+
58
+ // card: as in the first example on this page that uses them.
59
+
60
+ export function Range() {
61
+ const [range, setRange] = React.useState<DateRange | undefined>(() => ({
62
+ from: addDays(startOfToday(), 2),
63
+ to: addDays(startOfToday(), 9),
64
+ }));
65
+ return (
66
+ <div className={card}>
67
+ <Calendar mode="range" numberOfMonths={2} selected={range} onSelect={setRange} />
68
+ </div>
69
+ );
70
+ }
71
+ ```
72
+
73
+ ### Multiple days
74
+
75
+ `max` limits how many days can be picked.
76
+
77
+ ```tsx
78
+ import { Calendar } from "@zonsh/ui/calendar";
79
+ import { addDays, startOfToday } from "date-fns";
80
+ import * as React from "react";
81
+
82
+ // card: as in the first example on this page that uses them.
83
+
84
+ export function Multiple() {
85
+ const [days, setDays] = React.useState<Date[] | undefined>(() => [
86
+ addDays(startOfToday(), 1),
87
+ addDays(startOfToday(), 3),
88
+ addDays(startOfToday(), 8),
89
+ ]);
90
+ return (
91
+ <div className={card}>
92
+ <Calendar
93
+ mode="multiple"
94
+ max={5}
95
+ selected={days}
96
+ onSelect={setDays}
97
+ footer={`${days?.length ?? 0} of 5 workshop days picked.`}
98
+ />
99
+ </div>
100
+ );
101
+ }
102
+ ```
103
+
104
+ ### Month and year menus
105
+
106
+ `captionLayout="dropdown"` replaces the caption with month and year dropdowns; set `startMonth` and `endMonth` to the range people need. By default (`dropdown="native"`) they are dense `NativeSelect`s, so phones show their own picker.
107
+
108
+ ```tsx
109
+ import { Calendar } from "@zonsh/ui/calendar";
110
+ import * as React from "react";
111
+
112
+ // card: as in the first example on this page that uses them.
113
+
114
+ export function Dropdowns() {
115
+ const [date, setDate] = React.useState<Date | undefined>();
116
+ return (
117
+ <div className={card}>
118
+ <Calendar
119
+ mode="single"
120
+ captionLayout="dropdown"
121
+ startMonth={new Date(2015, 0)}
122
+ endMonth={new Date(2030, 11)}
123
+ selected={date}
124
+ onSelect={setDate}
125
+ />
126
+ </div>
127
+ );
128
+ }
129
+ ```
130
+
131
+ ### Custom dropdowns
132
+
133
+ `dropdown="custom"` draws them with our `Select`, for desktop surfaces where the native list looks out of place. Months outside `startMonth`/`endMonth` are disabled in both.
134
+
135
+ ```tsx
136
+ import { Calendar } from "@zonsh/ui/calendar";
137
+ import * as React from "react";
138
+
139
+ // card: as in the first example on this page that uses them.
140
+
141
+ export function CustomDropdowns() {
142
+ const [date, setDate] = React.useState<Date | undefined>();
143
+ return (
144
+ <div className={card}>
145
+ <Calendar
146
+ mode="single"
147
+ captionLayout="dropdown"
148
+ dropdown="custom"
149
+ startMonth={new Date(2015, 0)}
150
+ endMonth={new Date(2030, 11)}
151
+ selected={date}
152
+ onSelect={setDate}
153
+ />
154
+ </div>
155
+ );
156
+ }
157
+ ```
158
+
159
+ ### Locale and week start
160
+
161
+ A `react-day-picker/locale` locale sets the names, the first weekday (Monday in German) and the accessible labels; `date-fns/locale` locales work but keep English labels. `weekStartsOn` overrides the first day.
162
+
163
+ Weekdays are tracked capitals only in scripts with case (Latin, Greek, Cyrillic, Armenian); others stay untracked so joined letters hold together. Short names too wide for the column (Arabic's) switch to narrow ones: س ح ن. Your own `formatters.formatWeekdayName` is left alone.
164
+
165
+ ```tsx
166
+ import { Calendar } from "@zonsh/ui/calendar";
167
+ import { startOfToday } from "date-fns";
168
+ import { de } from "react-day-picker/locale";
169
+ import * as React from "react";
170
+
171
+ // card: as in the first example on this page that uses them.
172
+
173
+ export function Locale() {
174
+ const [date, setDate] = React.useState<Date | undefined>(() => startOfToday());
175
+ return (
176
+ <div className="flex flex-wrap gap-6">
177
+ <figure className="m-0 flex flex-col gap-2">
178
+ <figcaption className="text-center eyebrow">US · weeks start Sunday</figcaption>
179
+ <div className={card}>
180
+ <Calendar mode="single" selected={date} onSelect={setDate} />
181
+ </div>
182
+ </figure>
183
+ <figure className="m-0 flex flex-col gap-2">
184
+ <figcaption className="text-center eyebrow">DE · weeks start Monday</figcaption>
185
+ <div className={card}>
186
+ <Calendar mode="single" locale={de} selected={date} onSelect={setDate} />
187
+ </div>
188
+ </figure>
189
+ </div>
190
+ );
191
+ }
192
+ ```
193
+
194
+ ### Disabled days
195
+
196
+ `disabled` takes matchers: `{ before: date }`, `{ dayOfWeek: [0, 6] }`, a date, a range or a function.
197
+
198
+ ```tsx
199
+ import { Calendar } from "@zonsh/ui/calendar";
200
+ import { startOfToday } from "date-fns";
201
+ import * as React from "react";
202
+
203
+ // card: as in the first example on this page that uses them.
204
+
205
+ export function DisabledDays() {
206
+ const [date, setDate] = React.useState<Date | undefined>();
207
+ return (
208
+ <div className={card}>
209
+ <Calendar
210
+ mode="single"
211
+ selected={date}
212
+ onSelect={setDate}
213
+ weekStartsOn={1}
214
+ disabled={[{ before: startOfToday() }, { dayOfWeek: [0, 6] }]}
215
+ footer="Calls run Monday to Friday."
216
+ />
217
+ </div>
218
+ );
219
+ }
220
+ ```
221
+
222
+ ### Week numbers
223
+
224
+ ```tsx
225
+ import { Calendar } from "@zonsh/ui/calendar";
226
+ import { de } from "react-day-picker/locale";
227
+
228
+ // card: as in the first example on this page that uses them.
229
+
230
+ export function WeekNumbers() {
231
+ return (
232
+ <div className={card}>
233
+ <Calendar locale={de} showWeekNumber />
234
+ </div>
235
+ );
236
+ }
237
+ ```
238
+
239
+ ## Props
240
+
241
+ `Calendar` takes every react-day-picker `DayPicker` prop and sets these defaults:
242
+
243
+ | Prop | Type | Default |
244
+ | ----------------- | ---------------------------------------------------------------- | ----------- |
245
+ | `mode` | `"single" \| "multiple" \| "range"` | — |
246
+ | `selected` | `Date` \| `Date[]` \| `DateRange` | — |
247
+ | `onSelect` | `(selected, triggerDate, modifiers, event) => void` | — |
248
+ | `showOutsideDays` | `boolean` | `true` |
249
+ | `captionLayout` | `"label" \| "dropdown" \| "dropdown-months" \| "dropdown-years"` | `"label"` |
250
+ | `dropdown` | `"native" \| "custom"` — how the caption dropdowns are drawn | `"native"` |
251
+ | `numberOfMonths` | `number` | `1` |
252
+ | `locale` | a date-fns or `react-day-picker/locale` locale | `enUS` |
253
+ | `weekStartsOn` | `0`–`6` | from locale |
254
+ | `disabled` | `Matcher \| Matcher[]` | — |
255
+
256
+ Also forwarded: `month` / `defaultMonth` / `onMonthChange`, `startMonth` / `endMonth`, `min` / `max`, `required`, `showWeekNumber`, `fixedWeeks`, `footer`, `timeZone`, `modifiers`, `components` and `classNames` (merged with ours per part). The module also exports the `DateRange`, `CalendarLocale` and `CalendarMatcher` types. Data attributes on each day button: `data-selected-single`, `data-range-start`, `data-range-middle`, `data-range-end`, `data-today`, `data-outside`, `data-disabled`.
257
+
258
+ ## Brand rules
259
+
260
+ - **Do** keep the selected day on the primary fill — the one dark object in the grid.
261
+ - **Do** put an inline calendar on a card; inside a popover it needs nothing more.
262
+ - **Do** use `react-day-picker/locale` locales so labels match the page.
263
+ - **Do** keep `dropdown="native"` for forms used mostly on phones; `custom` for desktop surfaces where the native list breaks the material.
264
+ - **Don't** fill day cells with colour. Use `disabled` or a `modifiers` class; to tell event kinds apart, a small category-colour dot named in a legend.
265
+ - **Don't** make cells smaller than 38px — they are the tap targets.
266
+
267
+ ## Accessibility
268
+
269
+ - The month is a `grid`, one Tab stop.
270
+ - Right to left (a `DirectionProvider` or `dir="rtl"`), the grid, the previous/next buttons and the arrow keys all mirror.
271
+ - Each day has a full label ("Today, Monday, October 5th, 2026, selected") from the locale's `labels`.
272
+ - The caption is a live region: month changes are announced.
273
+ - Disabled days are not focusable, and struck through, not only muted.
274
+ - The today dot is decorative; "Today" is part of the label.
275
+ - In forced colours, selected days and ranges take the system Highlight; the today dot keeps its ink.
276
+
277
+ ### Keyboard
278
+
279
+ | Key | What it does |
280
+ | ------------------------------- | -------------------------------------------------------------------------- |
281
+ | Tab | Moves between the month buttons, the month and year dropdowns and the grid |
282
+ | Enter / Space | Picks the focused day (in a range, its start, then its end) |
283
+ | ← / → | Moves a day back or forward (swapped right to left) |
284
+ | ↑ / ↓ | Moves a week back or forward |
285
+ | Shift+← / Shift+→ | Moves a month back or forward (swapped right to left) |
286
+ | Shift+↑ / Shift+↓ | Moves a year back or forward |
287
+ | Page Up / Page Down | Moves a month back or forward |
288
+ | Shift+Page Up / Shift+Page Down | Moves a year back or forward |
289
+ | Home / End | Moves to the first or last day of the week |
290
+
291
+ The grid's Tab stop is the day last focused, the selected day, today, or else the first day that can be picked. Moving past the month turns the page; disabled days are skipped.
292
+
293
+ ---
294
+
295
+ - Import: `import { Calendar } from "@zonsh/ui/calendar"`
296
+ - Source: `packages/ui/src/components/calendar.tsx`
@@ -0,0 +1,158 @@
1
+ # Cards
2
+
3
+ ```tsx
4
+ import { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "@zonsh/ui";
5
+ import { ArrowRightIcon } from "lucide-react";
6
+
7
+ export function ObjectCard() {
8
+ return (
9
+ <Card render={<article />} className="max-w-md">
10
+ <CardHeader>
11
+ <CardTitle>Typography basics</CardTitle>
12
+ <CardDescription>Six short lessons on choosing and pairing typefaces.</CardDescription>
13
+ </CardHeader>
14
+ <CardContent>
15
+ Learn how to set a readable line length, build a type scale and pair a serif with a sans. Each lesson
16
+ takes about ten minutes and ends with a small exercise you can check yourself.
17
+ </CardContent>
18
+ <CardFooter>
19
+ <Button>
20
+ Start course
21
+ <ArrowRightIcon className="rtl:-scale-x-100" />
22
+ </Button>
23
+ </CardFooter>
24
+ </Card>
25
+ );
26
+ }
27
+ ```
28
+
29
+ A `Card` is an object with its own padding, a 20px radius and the one soft shadow; its footer holds one primary at most. `variant` gives three kinds, in the order to reach for them:
30
+
31
+ 1. **`plain` — no box.** A top hairline and whitespace. The default way to group content.
32
+ 2. **`region` — a part of the page** (a section panel, a specimen sheet, a cover): the `surface-container` material with **square** corners, no shadow.
33
+ 3. **`card` — an object** _on_ the page (a quote, a pricing option, a form panel): the same material, a 20px radius, 24/32/40px padding and `0 4px 16px #0000000a`, the only drop shadow in the system.
34
+
35
+ ## Usage
36
+
37
+ ```tsx
38
+ import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
39
+
40
+ <Card>
41
+ <CardHeader>
42
+ <CardTitle>Typography basics</CardTitle>
43
+ <CardDescription>Six short lessons on choosing and pairing typefaces.</CardDescription>
44
+ </CardHeader>
45
+ <CardContent>…</CardContent>
46
+ </Card>;
47
+
48
+ <Card variant="region" render={<section />}>…</Card>;
49
+
50
+ <Card variant="plain">…</Card>;
51
+ ```
52
+
53
+ The props you'll reach for: `variant`, `render` (`<article />`, `<section />`), and `[--card-padding:0]` for full-bleed contents.
54
+
55
+ ## When to use
56
+
57
+ | Ask, in this order | If yes | It looks like |
58
+ | ------------------------------------------------ | -------- | -------------------------------------------------- |
59
+ | Would a hairline rule and whitespace do? | `plain` | a top rule and space — no box |
60
+ | Is it a part _of_ the page — a section, a sheet? | `region` | the material, square, no shadow |
61
+ | Is it a thing _on_ the page — a quote, a form? | `card` | the material, 20px, its own padding, a soft shadow |
62
+
63
+ Could it be picked up and moved elsewhere on its own? A quote, a pricing card, a data table could — `card`. A section panel or page cover could not — `region`. When unsure, prefer a region. For features and steps in a grid, `FeatureList` adds a mono index and an icon to `plain`. A card holding inputs shares their `--field-edge` border.
64
+
65
+ ## Examples
66
+
67
+ ### Kinds
68
+
69
+ The same content as each kind.
70
+
71
+ ```tsx
72
+ import { Card, CardDescription, CardHeader, CardTitle } from "@zonsh/ui";
73
+
74
+ const kinds = [
75
+ { variant: "card", caption: "card · an object on the page" },
76
+ { variant: "region", caption: "region · a part of the page" },
77
+ { variant: "plain", caption: "plain · no box, a hairline" },
78
+ ] as const;
79
+
80
+ /** The same content as each kind of card. */
81
+ export function Kinds() {
82
+ return (
83
+ // Columns by the room the example has, not the window: one per row in a narrow frame.
84
+ <div className="@container w-full max-w-5xl">
85
+ <div className="grid gap-6 @2xl:grid-cols-3">
86
+ {kinds.map((k) => (
87
+ <figure key={k.variant} className="m-0 flex flex-col gap-3">
88
+ <figcaption className="eyebrow">{k.caption}</figcaption>
89
+ <Card variant={k.variant} className="flex-1">
90
+ <CardHeader>
91
+ <CardTitle>Shared folders</CardTitle>
92
+ <CardDescription>
93
+ Invite people to a folder and decide who can edit and who can only read.
94
+ </CardDescription>
95
+ </CardHeader>
96
+ </Card>
97
+ </figure>
98
+ ))}
99
+ </div>
100
+ </div>
101
+ );
102
+ }
103
+ ```
104
+
105
+ ### Form panel
106
+
107
+ ```tsx
108
+ import { Button, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Field, FieldLabel, Input } from "@zonsh/ui";
109
+
110
+ export function FormPanel() {
111
+ return (
112
+ <Card className="max-w-md">
113
+ <CardHeader>
114
+ <CardTitle>New project</CardTitle>
115
+ <CardDescription>Give it a name now; you can change it later.</CardDescription>
116
+ </CardHeader>
117
+ <CardContent className="flex flex-col gap-4">
118
+ <Field>
119
+ <FieldLabel>Project name</FieldLabel>
120
+ <Input placeholder="my-app" />
121
+ </Field>
122
+ </CardContent>
123
+ <CardFooter>
124
+ <Button>Create project</Button>
125
+ </CardFooter>
126
+ </Card>
127
+ );
128
+ }
129
+ ```
130
+
131
+ ## Props
132
+
133
+ | Prop | Type | Default |
134
+ | ------------------ | ---------------------------------------------------------------------------------------------------- | -------- |
135
+ | `Card.variant` | `"card" \| "region" \| "plain"` | `"card"` |
136
+ | `Card.render` | `ReactElement` — e.g. `<article />`, `<section />` | `<div>` |
137
+ | `CardTitle.render` | `ReactElement` — another heading level | `<h3>` |
138
+
139
+ `CardHeader`, `CardDescription`, `CardContent` and `CardFooter` are plain elements; all forward props. Padding comes from `--card-padding`: set `[--card-padding:0]` for full bleed, never `p-0`. Data attributes: `data-slot="card"` with `data-variant`.
140
+
141
+ ## Brand rules
142
+
143
+ - **Do** default to a hairline and whitespace (`plain`); box only when the thing is an object or a part of the page.
144
+ - **Do** let the card own its padding — never pad a `Card` at the call site.
145
+ - **Don't** round a part of the page or give it a shadow — it would look detachable. It is a `region`.
146
+ - **Don't** put `plain` cards inside a card, or "upgrade" a `plain` group to a `card`.
147
+ - **Don't** use `--border` for a card's edge; it is `--field-edge`, like the inputs inside it.
148
+ - **Don't** make a whole card hoverable with a flat fill. Link its title, or use the raised material.
149
+
150
+ ## Accessibility
151
+
152
+ - Give a standalone card a `CardTitle`, and render self-contained content as `<article>`.
153
+ - Render a `region` as `<section>` with a heading, so it appears in the outline.
154
+
155
+ ---
156
+
157
+ - Import: `import { Card, CardHeader, CardTitle, CardDescription, CardContent, CardFooter } from "@zonsh/ui"`
158
+ - Source: `packages/ui/src/components/card.tsx`