@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,412 @@
1
+ # Feature List
2
+
3
+ ```tsx
4
+ import { FeatureItem, FeatureList } from "@zonsh/ui";
5
+ import { GitBranchIcon, RotateCcwIcon, ScrollTextIcon } from "lucide-react";
6
+
7
+ export function Features() {
8
+ return (
9
+ <FeatureList columns={3}>
10
+ <FeatureItem index="01" icon={<GitBranchIcon />} title="Preview deploys">
11
+ <p>Every branch gets its own URL, so a change can be reviewed before it reaches anyone else.</p>
12
+ </FeatureItem>
13
+ <FeatureItem index="02" icon={<RotateCcwIcon />} title="One-click rollback">
14
+ <p>Each release is kept. If something breaks, go back to the last good one and fix it calmly.</p>
15
+ </FeatureItem>
16
+ <FeatureItem index="03" icon={<ScrollTextIcon />} title="Readable logs">
17
+ <p>Build and runtime logs in one place, searchable and linked to the commit that produced them.</p>
18
+ </FeatureItem>
19
+ </FeatureList>
20
+ );
21
+ }
22
+ ```
23
+
24
+ The brand's feature lists — **not boxes**: each item sits on a hairline with generous padding. An item has a mono index, an optional 20px lucide icon, a title (Licht Sans, or Licht for editorial lists), body copy and, in some layouts, media.
25
+
26
+ ## Usage
27
+
28
+ ```tsx
29
+ import { FeatureItem, FeatureList } from "@zonsh/ui";
30
+ import { GitBranchIcon } from "lucide-react";
31
+
32
+ <FeatureList columns={3}>
33
+ <FeatureItem index="01" icon={<GitBranchIcon />} title="Preview deploys">
34
+ <p>Every branch gets its own URL, so a change can be reviewed before it reaches anyone else.</p>
35
+ </FeatureItem>
36
+ </FeatureList>;
37
+ ```
38
+
39
+ The props you'll reach for: `layout` and `columns` on the list, `title` / `index` / `icon` on each item.
40
+
41
+ ## When to use
42
+
43
+ Five layouts for the same items:
44
+
45
+ | `layout` | What it looks like | Use it for |
46
+ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
47
+ | `grid` | Items side by side in 1–3 columns on a top hairline, the columns divided by vertical rules. | Three to six parallel ideas of the same weight. |
48
+ | `bento` | A ruled sheet with a crosshair on each corner, divided into cells; a cell can take two columns or rows (`span`) and shows its `media` on a dotted stage that runs to its edges. | One main idea beside smaller ones; features worth showing, not only naming. |
49
+ | `rows` | One item per row, the text beside a picture larger than itself (in a `FeatureFigure`), the sides alternating. | Two to four features that each need a picture or a product detail to make sense. |
50
+ | `index` | A vertical list with large Licht numerals (40–88px) beside each title. | Steps in order: how it works, how to start, a process. |
51
+ | `split` | Two columns: the title on the left, the body on the right, a hairline between rows. | Specifications, what a plan includes, terms, facts about an offer — reference you scan. |
52
+
53
+ - Pick by content: order → `index`; reference → `split`; one idea that leads → `bento`; needs a picture → `rows`; equals → `grid`. Don't repeat a layout down a page; `grid` after `grid` reads as a template.
54
+ - **Callouts** — one line with an icon and a mono bold key ("**Fast search** — Find any note by a word inside it") — for a short list of problems or outcomes.
55
+ - Not for things people pick up and move, such as a pricing tier: those are objects on `surface-card`.
56
+
57
+ ## Examples
58
+
59
+ ### Bento
60
+
61
+ Each cell is composed by its `span`:
62
+
63
+ - **`large`** (2×2 from `md`): `media` on a dotted stage across the top, then a large Licht title.
64
+ - **`tall`** (two rows): words on top, stage below.
65
+ - **`wide`** (two columns): words in one half, stage in the other.
66
+ - **A small cell** with no `media`: index and icon on top, words at the bottom.
67
+
68
+ Put a small object on the stage — real components on `surface-card`, a few log lines, an illustration — not a screenshot.
69
+
70
+ ```tsx
71
+ import { Button, FeatureItem, FeatureList, Field, FieldLabel, Switch, Tag } from "@zonsh/ui";
72
+ import type { ReactNode } from "react";
73
+ import { ExternalLinkIcon, GitBranchIcon, LockIcon, RotateCcwIcon, ScrollTextIcon } from "lucide-react";
74
+
75
+ /** A small object resting on a bento cell's dotted stage. */
76
+ function Panel({ children, className }: { children: ReactNode; className?: string }) {
77
+ return (
78
+ <div className={`mx-auto flex w-full max-w-md flex-col surface-card p-4 sm:p-5 ${className ?? ""}`}>
79
+ {children}
80
+ </div>
81
+ );
82
+ }
83
+
84
+ const branches = [
85
+ { name: "fix-checkout-copy", state: "Ready", tone: "success", commit: "3f2a9c1" },
86
+ { name: "new-pricing-table", state: "Building", tone: "info", commit: "b81e04d" },
87
+ { name: "search-on-mobile", state: "Ready", tone: "success", commit: "77c0a3e" },
88
+ ] as const;
89
+
90
+ const logLines = [
91
+ ["14:02:11", "Installing dependencies"],
92
+ ["14:02:19", "Resolved 412 packages"],
93
+ ["14:02:24", "Building the site"],
94
+ ["14:02:51", "Compiled 128 pages"],
95
+ ["14:02:53", "Uploading to 3 regions"],
96
+ ["14:02:58", "Live at fix-checkout-copy"],
97
+ ] as const;
98
+
99
+ export function Bento() {
100
+ return (
101
+ <FeatureList layout="bento" columns={3}>
102
+ <FeatureItem
103
+ span="large"
104
+ index="01"
105
+ icon={<GitBranchIcon />}
106
+ title="Every branch gets its own preview"
107
+ media={
108
+ <Panel>
109
+ <ul className="m-0 flex list-none flex-col p-0">
110
+ {branches.map((b, i) => (
111
+ <li
112
+ key={b.name}
113
+ className={`flex flex-wrap items-center justify-between gap-3 py-3 ${i ? "hairline" : "pt-0"}`}
114
+ >
115
+ <div className="flex min-w-0 flex-col gap-1">
116
+ <span className="truncate font-mono text-[13px] text-foreground">{b.name}</span>
117
+ <span className="font-mono text-xs text-muted-foreground">Built from {b.commit}</span>
118
+ </div>
119
+ <Tag tone={b.tone} dot>
120
+ {b.state}
121
+ </Tag>
122
+ </li>
123
+ ))}
124
+ </ul>
125
+ <div className="flex justify-end pt-3 hairline">
126
+ <Button size="sm" variant="secondary">
127
+ Open preview
128
+ <ExternalLinkIcon className="rtl:-scale-x-100" />
129
+ </Button>
130
+ </div>
131
+ </Panel>
132
+ }
133
+ >
134
+ <p>
135
+ Push a branch and it is built and served at its own address, so a change can be read, clicked
136
+ through and reviewed before it reaches anyone else.
137
+ </p>
138
+ </FeatureItem>
139
+ <FeatureItem
140
+ span="tall"
141
+ index="02"
142
+ icon={<ScrollTextIcon />}
143
+ title="Logs you can read"
144
+ media={
145
+ <ol
146
+ aria-label="Build log"
147
+ className="m-0 flex list-none flex-col gap-2.5 [mask-image:linear-gradient(to_top,black_55%,transparent)] p-0 font-mono text-xs"
148
+ >
149
+ {logLines.map(([time, line], i) => (
150
+ <li key={time} className="flex gap-3">
151
+ <span className="text-muted-foreground tabular-nums">{time}</span>
152
+ <span className={i === logLines.length - 1 ? "text-success" : "text-foreground-soft"}>
153
+ {line}
154
+ </span>
155
+ </li>
156
+ ))}
157
+ </ol>
158
+ }
159
+ >
160
+ <p>Build and runtime logs in one place, searchable and linked to the commit that produced them.</p>
161
+ </FeatureItem>
162
+ <FeatureItem index="03" icon={<RotateCcwIcon />} title="One-click rollback">
163
+ <p>Each release is kept. If something breaks, go back to the last good one and fix it calmly.</p>
164
+ </FeatureItem>
165
+ <FeatureItem
166
+ span="wide"
167
+ index="04"
168
+ icon={<LockIcon />}
169
+ title="Previews for the people you choose"
170
+ media={
171
+ <Panel className="max-w-sm">
172
+ <Field>
173
+ <FieldLabel>
174
+ <Switch defaultChecked />
175
+ Ask for sign-in on preview links
176
+ </FieldLabel>
177
+ </Field>
178
+ </Panel>
179
+ }
180
+ >
181
+ <p>Keep work in progress inside the team, or share one link with a client for a day.</p>
182
+ </FeatureItem>
183
+ </FeatureList>
184
+ );
185
+ }
186
+ ```
187
+
188
+ ### Rows
189
+
190
+ Each feature beside a larger picture, alternating sides. Frame an illustration in a `FeatureFigure` (a square region on the blueprint grid) and let it fill the frame (`className="w-full"`).
191
+
192
+ ```tsx
193
+ <FeatureItem index="01 / 03" title="Write it once" media={<FeatureFigure><Illustration name="iso/pipeline" className="w-full" /></FeatureFigure>}>
194
+ <p>Describe the build in one file next to the code.</p>
195
+ </FeatureItem>
196
+ ```
197
+
198
+ ```tsx
199
+ import { FeatureFigure, FeatureItem, FeatureList } from "@zonsh/ui";
200
+ import { Illustration } from "@zonsh/ui/illustration";
201
+
202
+ const rows = [
203
+ {
204
+ figure: "iso/pipeline",
205
+ title: "Write it once",
206
+ body: "Describe the build in one file next to the code. The same steps run on your laptop and on every push.",
207
+ },
208
+ {
209
+ figure: "iso/server",
210
+ title: "Run it close to people",
211
+ body: "Each release is copied to the regions you pick, and requests go to the nearest one that is healthy.",
212
+ },
213
+ {
214
+ figure: "iso/timeline",
215
+ title: "Keep every version",
216
+ body: "Releases are never overwritten. Compare two of them, or put an older one back while you fix the new one.",
217
+ },
218
+ ] as const;
219
+
220
+ export function Rows() {
221
+ return (
222
+ <FeatureList layout="rows">
223
+ {rows.map((row, i) => (
224
+ <FeatureItem
225
+ key={row.title}
226
+ index={`${String(i + 1).padStart(2, "0")} / ${String(rows.length).padStart(2, "0")}`}
227
+ title={row.title}
228
+ media={
229
+ <FeatureFigure>
230
+ <Illustration name={row.figure} className="w-full" />
231
+ </FeatureFigure>
232
+ }
233
+ >
234
+ <p>{row.body}</p>
235
+ </FeatureItem>
236
+ ))}
237
+ </FeatureList>
238
+ );
239
+ }
240
+ ```
241
+
242
+ ### Steps
243
+
244
+ `layout="index"`, for steps in order.
245
+
246
+ ```tsx
247
+ import { FeatureItem, FeatureList } from "@zonsh/ui";
248
+
249
+ export function Steps() {
250
+ return (
251
+ <FeatureList layout="index">
252
+ <FeatureItem index="01" title="Connect the repository">
253
+ <p>Pick the repository and the branch that is production. Nothing in the code has to change.</p>
254
+ </FeatureItem>
255
+ <FeatureItem index="02" title="Push as you always do">
256
+ <p>
257
+ Every push is built. A branch gets a preview address; the production branch goes live once the build
258
+ passes.
259
+ </p>
260
+ </FeatureItem>
261
+ <FeatureItem index="03" title="Review, then release">
262
+ <p>Open the preview, leave a note on what needs to change, and merge when it is right.</p>
263
+ </FeatureItem>
264
+ </FeatureList>
265
+ );
266
+ }
267
+ ```
268
+
269
+ ### What's included
270
+
271
+ `layout="split"`, for reference people scan.
272
+
273
+ ```tsx
274
+ import { FeatureItem, FeatureList } from "@zonsh/ui";
275
+
276
+ export function Included() {
277
+ return (
278
+ <FeatureList layout="split">
279
+ <FeatureItem title="Builds">
280
+ <p>Unlimited builds on every branch, with the logs of the last 90 days.</p>
281
+ </FeatureItem>
282
+ <FeatureItem title="Previews">
283
+ <p>An address for every branch, optionally behind sign-in, removed when the branch is deleted.</p>
284
+ </FeatureItem>
285
+ <FeatureItem title="Rollback">
286
+ <p>Every release is kept for a year. Putting one back takes as long as switching a link.</p>
287
+ </FeatureItem>
288
+ <FeatureItem title="Support">
289
+ <p>Email, answered by the people who build the product, on working days.</p>
290
+ </FeatureItem>
291
+ </FeatureList>
292
+ );
293
+ }
294
+ ```
295
+
296
+ ### Principles
297
+
298
+ Two columns, Licht titles, no icons.
299
+
300
+ ```tsx
301
+ import { FeatureItem, FeatureList } from "@zonsh/ui";
302
+
303
+ export function Principles() {
304
+ return (
305
+ <FeatureList columns={2}>
306
+ <FeatureItem index="01" title="Precision" titleFont="heading">
307
+ <p>Say exactly what a thing does, then make sure it does exactly that.</p>
308
+ </FeatureItem>
309
+ <FeatureItem index="02" title="Reliability" titleFont="heading">
310
+ <p>It should work the same on the hundredth day as on the first.</p>
311
+ </FeatureItem>
312
+ <FeatureItem index="03" title="Long-term value" titleFont="heading">
313
+ <p>Built to be maintained and extended, not replaced every two years.</p>
314
+ </FeatureItem>
315
+ <FeatureItem index="04" title="Respect" titleFont="heading">
316
+ <p>People's time and attention are scarce. Ask for as little of both as you can.</p>
317
+ </FeatureItem>
318
+ </FeatureList>
319
+ );
320
+ }
321
+ ```
322
+
323
+ ### Problem callouts
324
+
325
+ An icon, a mono bold key, an em dash and one line.
326
+
327
+ ```tsx
328
+ import { FeatureCallout, FeatureCalloutList, FeatureItem, FeatureList } from "@zonsh/ui";
329
+ import { CloudOffIcon, LayersIcon, SearchIcon } from "lucide-react";
330
+
331
+ export function ProblemCallouts() {
332
+ return (
333
+ <FeatureList columns={1} className="max-w-2xl">
334
+ <FeatureItem index="01" title="Why people switch">
335
+ <FeatureCalloutList>
336
+ <FeatureCallout icon={<SearchIcon />} label="Fast search">
337
+ Find any note by a word inside it, as you type.
338
+ </FeatureCallout>
339
+ <FeatureCallout icon={<CloudOffIcon />} label="Works offline">
340
+ Write anywhere; changes sync when you are back online.
341
+ </FeatureCallout>
342
+ <FeatureCallout icon={<LayersIcon />} label="Less clutter">
343
+ Folders and tags stay out of the way until you need them.
344
+ </FeatureCallout>
345
+ </FeatureCalloutList>
346
+ </FeatureItem>
347
+ </FeatureList>
348
+ );
349
+ }
350
+ ```
351
+
352
+ ## Props
353
+
354
+ ### FeatureList
355
+
356
+ | Prop | Type | Default |
357
+ | --------- | --------------------------------------------------------------------------------------------------- | -------- |
358
+ | `layout` | `"grid" \| "bento" \| "rows" \| "index" \| "split"` | `"grid"` |
359
+ | `columns` | `1 \| 2 \| 3` — for `grid` and `bento`; one column on small screens, two from `md`, three from `lg` | `3` |
360
+
361
+ ### FeatureItem
362
+
363
+ | Prop | Type | Default |
364
+ | ----------- | --------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
365
+ | `title` | `ReactNode` | — |
366
+ | `index` | `ReactNode` — mono, e.g. `"01"`; a large Licht numeral in `index` | — |
367
+ | `icon` | `ReactNode` — a lucide icon, set to 20px | — |
368
+ | `titleFont` | `"body" \| "heading"` | `"heading"` in `rows`, `index` and a spanning bento cell, else `"body"` |
369
+ | `titleAs` | `"h2" \| "h3" \| "h4" \| "p"` | `"h3"` |
370
+ | `media` | `ReactNode` — under the text in `grid`; on a dotted stage in `bento`; beside the text in `rows`; not shown in `index` and `split` | — |
371
+ | `span` | `"wide" \| "tall" \| "large"` — `bento` only: two columns, two rows, or both, from `md` | — |
372
+ | `children` | `ReactNode` — body; `<p>`s and callouts | — |
373
+
374
+ ### FeatureFigure
375
+
376
+ | Prop | Type | Default |
377
+ | --------- | ------------------------------------------------------------------------------------------------------------ | ------------- |
378
+ | `texture` | `"blueprint" \| "dots" \| "none"` — the ground: the grid that lights under the pointer, a dot field, or none | `"blueprint"` |
379
+ | `ratio` | `string` — the frame's CSS aspect ratio | `"4 / 3"` |
380
+
381
+ ### FeatureCallout
382
+
383
+ | Prop | Type | Default |
384
+ | ---------- | ------------------------------------- | ------- |
385
+ | `label` | `ReactNode` — the mono key | — |
386
+ | `icon` | `ReactNode` — small lucide icon | — |
387
+ | `children` | `ReactNode` — the line after the dash | — |
388
+
389
+ `FeatureCalloutList` is a `<ul>` of callouts. All parts forward their element's props; the list carries `data-layout`, a bento cell `data-span`.
390
+
391
+ ## Brand rules
392
+
393
+ - **Do** let the rules and whitespace carry the structure.
394
+ - **Do** use outline lucide icons at 20px, all from the same family.
395
+ - **Do** vary the layout down a page: a `bento` of what it does, an `index` of how to start, a `split` of what's included.
396
+ - **Don't** add a background, border, radius or shadow around items — the most common break. The list draws its own rules; media sits in a `FeatureFigure` or on the stage.
397
+ - **Don't** shrink an illustration inside its frame: filling a `FeatureFigure` reads as a drawing, a small one in a big box as a placeholder.
398
+ - **Don't** fill a bento's media with invented numbers, customers or charts; show a real part of the product with sample data that reads as sample.
399
+ - **Don't** write callouts as slogans; each says what the thing does: "Find any note by a word inside it, as you type."
400
+
401
+ ## Accessibility
402
+
403
+ - Items are list items; titles are `<h3>` — set `titleAs` to fit the outline.
404
+ - Icons are `aria-hidden`; the title carries the meaning.
405
+ - The `rows` layout swaps sides visually only; the reading order is always text, then media.
406
+ - Live previews in `media` are real controls: label them and keep them few, so keyboard users don't tab through a showcase.
407
+ - Callout keys are `<strong>`, so the key and the line read as one sentence.
408
+
409
+ ---
410
+
411
+ - Import: `import { FeatureList, FeatureItem, FeatureFigure, FeatureCalloutList, FeatureCallout } from "@zonsh/ui"`
412
+ - Source: `packages/ui/src/components/feature-list.tsx`
@@ -0,0 +1,209 @@
1
+ # Field
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel, Input } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="max-w-sm">
9
+ <FieldLabel>Your name</FieldLabel>
10
+ <Input placeholder="Alex Weber" autoComplete="name" />
11
+ <FieldDescription>Shown on your profile and next to your comments.</FieldDescription>
12
+ </Field>
13
+ );
14
+ }
15
+ ```
16
+
17
+ The frame around any control — `Input`, `Select`, `Checkbox`, `Combobox` and the rest: a label that names it, a muted description and an error that describe it, stacked 8px apart. `Fieldset` groups related fields under a mono legend.
18
+
19
+ ```tsx
20
+ import { Field, FieldDescription, FieldError, FieldLabel, Input } from "@zonsh/ui";
21
+
22
+ /** One part of the field, outlined, with its name beside it — a spec sheet of the Field. */
23
+ function Part({ name, children }: { name: string; children: React.ReactNode }) {
24
+ return (
25
+ <div className="grid grid-cols-[minmax(0,1fr)_7.5rem] items-center gap-4">
26
+ <div className="rounded-item border border-dashed border-field-edge px-3 py-2.5">{children}</div>
27
+ <span className="font-mono text-[10.5px] leading-snug tracking-[0.04em] text-muted-foreground">
28
+ {name}
29
+ </span>
30
+ </div>
31
+ );
32
+ }
33
+
34
+ /**
35
+ * What a Field is made of: the label, the control, the description and the error, each outlined
36
+ * and named. The Field connects them; the control can be any zon control.
37
+ */
38
+ export function Anatomy() {
39
+ return (
40
+ <Field invalid className="w-full max-w-xl gap-2.5">
41
+ <Part name="FieldLabel">
42
+ <FieldLabel>Website</FieldLabel>
43
+ </Part>
44
+ <Part name="Input · any control">
45
+ <Input defaultValue="example" />
46
+ </Part>
47
+ <Part name="FieldDescription">
48
+ <FieldDescription>Shown on your public profile.</FieldDescription>
49
+ </Part>
50
+ <Part name="FieldError">
51
+ <FieldError match>Start the address with https://, for example https://example.com.</FieldError>
52
+ </Part>
53
+ </Field>
54
+ );
55
+ }
56
+ ```
57
+
58
+ ## Usage
59
+
60
+ ```tsx
61
+ import { Field, FieldDescription, FieldError, FieldLabel, Input } from "@zonsh/ui";
62
+
63
+ <Field name="name">
64
+ <FieldLabel>Your name</FieldLabel>
65
+ <Input required />
66
+ <FieldDescription>Shown on your profile and next to your comments.</FieldDescription>
67
+ <FieldError match="valueMissing">Tell us what to call you.</FieldError>
68
+ </Field>;
69
+ ```
70
+
71
+ The props you'll reach for: `name`, `validationMode`, and `FieldError.match`. A `FieldLabel` wrapping a `Checkbox`, `Radio` or `Switch` places the control beside its text, in a regular weight.
72
+
73
+ ## When to use
74
+
75
+ - Around every form control; every control needs a visible label.
76
+ - `Fieldset` for related fields (an address) or a radio or checkbox group.
77
+ - `FieldItem` for each option in a radio or checkbox group that has its own description.
78
+
79
+ ## Examples
80
+
81
+ ### Validation
82
+
83
+ `validationMode="onBlur"` checks on blur. One `FieldError` per `match` replaces the browser's messages; a bare `<FieldError />` after them shows a server error from `Form`, or the browser's message for anything unmatched.
84
+
85
+ ```tsx
86
+ import { Field, FieldError, FieldLabel, Input } from "@zonsh/ui";
87
+
88
+ export function Validation() {
89
+ return (
90
+ <Field name="email" validationMode="onBlur" className="max-w-sm">
91
+ <FieldLabel>Email</FieldLabel>
92
+ <Input required type="email" placeholder="alex@example.com" />
93
+ <FieldError match="valueMissing">We need an email address to reply to.</FieldError>
94
+ <FieldError match="typeMismatch">
95
+ That does not look like an email address. Check the @ part.
96
+ </FieldError>
97
+ </Field>
98
+ );
99
+ }
100
+ ```
101
+
102
+ ### States
103
+
104
+ `invalid` forces the invalid state (pair it with `<FieldError match>`); `disabled` dims control and label.
105
+
106
+ ```tsx
107
+ import { Field, FieldDescription, FieldError, FieldLabel, Input } from "@zonsh/ui";
108
+
109
+ function Invalid() {
110
+ return (
111
+ <Field invalid className="max-w-sm">
112
+ <FieldLabel>Website</FieldLabel>
113
+ <Input defaultValue="example" />
114
+ <FieldError match>Start the address with https://, for example https://example.com.</FieldError>
115
+ </Field>
116
+ );
117
+ }
118
+
119
+ function Disabled() {
120
+ return (
121
+ <Field disabled className="max-w-sm">
122
+ <FieldLabel>Project ID</FieldLabel>
123
+ <Input defaultValue="prj-2026-014" />
124
+ <FieldDescription>Assigned when the project is created.</FieldDescription>
125
+ </Field>
126
+ );
127
+ }
128
+
129
+ /** The invalid and disabled states, one under the other. */
130
+ export function States() {
131
+ return (
132
+ <div className="flex w-full max-w-sm flex-col gap-8">
133
+ <Invalid />
134
+ <Disabled />
135
+ </div>
136
+ );
137
+ }
138
+ ```
139
+
140
+ ### Fieldset group
141
+
142
+ ```tsx
143
+ import { Field, FieldLabel, Fieldset, FieldsetLegend, Input } from "@zonsh/ui";
144
+
145
+ export function FieldsetGroup() {
146
+ return (
147
+ <Fieldset className="w-full max-w-md">
148
+ <FieldsetLegend>Shipping address</FieldsetLegend>
149
+ <Field>
150
+ <FieldLabel>Street and number</FieldLabel>
151
+ <Input autoComplete="address-line1" placeholder="Hauptstraße 12" />
152
+ </Field>
153
+ <Field>
154
+ <FieldLabel>Postcode and city</FieldLabel>
155
+ <Input autoComplete="address-level2" placeholder="50667 Köln" />
156
+ </Field>
157
+ </Fieldset>
158
+ );
159
+ }
160
+ ```
161
+
162
+ ## With form libraries
163
+
164
+ When a library or your own state owns validation, pass its error to `error` and end with a bare `<FieldError />`. `error` takes a message, a `{ message }` (React Hook Form's `fieldState.error`) or a list (TanStack Form's `field.state.meta.errors`). It marks the field invalid, sets `aria-invalid` and links the message; in a `Form`, the next submit goes back to the library.
165
+
166
+ ```tsx
167
+ <Field error={fieldState.error}>
168
+ <FieldLabel>Workshop</FieldLabel>
169
+ <Select value={field.value ?? null} onValueChange={field.onChange} inputRef={field.ref}>
170
+ …
171
+ </Select>
172
+ <FieldError />
173
+ </Field>
174
+ ```
175
+
176
+ Full examples in Form: [React Hook Form](./form.md#react-hook-form), [TanStack Form](./form.md#tanstack-form), [server actions](./form.md#server-actions) and [binding each control](./form.md#binding-each-control).
177
+
178
+ ## Props
179
+
180
+ | Component | Prop | Type |
181
+ | ------------ | ---------------- | ----------------------------------------------------------------------------- |
182
+ | `Field` | `name` | `string`: the key for `Form` values and `errors` |
183
+ | | `validationMode` | `"onSubmit" \| "onBlur" \| "onChange"` |
184
+ | | `validate` | `(value, formValues) => string \| string[] \| null \| Promise<…>` |
185
+ | | `error` | `string \| { message } \| (string \| { message })[]`: an error from a library |
186
+ | | `invalid` | `boolean`: force the invalid state |
187
+ | | `disabled` | `boolean` |
188
+ | `FieldError` | `match` | `true \| "valueMissing" \| "typeMismatch" \| "tooShort" \| …` |
189
+
190
+ `FieldValidity` takes a function child that receives the validity state, for custom messages. Data attributes: `data-invalid`, `data-valid`, `data-disabled`, `data-dirty`, `data-touched`.
191
+
192
+ ## Brand rules
193
+
194
+ - **Do** write labels as plain questions or nouns: "Your name", "What is it about?".
195
+ - **Do** write errors that say how to fix it: "That does not look like an email address. Check the @ part."
196
+ - **Don't** use placeholder text as a label.
197
+ - **Don't** colour anything red except invalid fields and their messages.
198
+
199
+ ## Accessibility
200
+
201
+ - The label is a real `<label>` linked to the control; description and error are linked through `aria-describedby`.
202
+ - Invalid controls get `aria-invalid`, a destructive border and a soft 3px ring, and the message appears as text.
203
+ - A `Fieldset` renders `<fieldset>`, named by its legend.
204
+
205
+ ---
206
+
207
+ - Import: `import { Field, FieldLabel, FieldDescription, FieldError, Fieldset, FieldsetLegend, FieldItem, FieldValidity } from "@zonsh/ui"`
208
+ - Source: `packages/ui/src/components/field.tsx`
209
+ - Primitive: `@base-ui/react/field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/field.md`)