@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,197 @@
1
+ # Native Select
2
+
3
+ ```tsx
4
+ import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="w-full max-w-sm">
9
+ <FieldLabel>Country</FieldLabel>
10
+ <NativeSelect defaultValue="de" name="country">
11
+ <NativeSelectOption value="de">Germany</NativeSelectOption>
12
+ <NativeSelectOption value="at">Austria</NativeSelectOption>
13
+ <NativeSelectOption value="ch">Switzerland</NativeSelectOption>
14
+ <NativeSelectOption value="nl">Netherlands</NativeSelectOption>
15
+ <NativeSelectOption value="other">Somewhere else</NativeSelectOption>
16
+ </NativeSelect>
17
+ </Field>
18
+ );
19
+ }
20
+ ```
21
+
22
+ A real `<select>` in the field material, 38px (30px with `size="sm"`), with `Select`'s chevron. The platform draws the list — a wheel or sheet on phones, the OS menu on desktop.
23
+
24
+ ## Usage
25
+
26
+ ```tsx
27
+ import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
28
+
29
+ <Field>
30
+ <FieldLabel>Country</FieldLabel>
31
+ <NativeSelect name="country" defaultValue="de">
32
+ <NativeSelectOption value="de">Germany</NativeSelectOption>
33
+ <NativeSelectOption value="at">Austria</NativeSelectOption>
34
+ </NativeSelect>
35
+ </Field>;
36
+ ```
37
+
38
+ The props you'll reach for: `name`, `defaultValue` (or `value` / `onChange`) and `size`.
39
+
40
+ ## When to use
41
+
42
+ - Plain forms — contact, settings, checkout; the value submits like any field.
43
+ - Long lists searched by typing (countries, years), mobile-first screens, and pages that must work before JavaScript loads.
44
+ - `Select` when options need icons, descriptions or the menu material; `Combobox` to filter a long list.
45
+
46
+ ## Examples
47
+
48
+ ### Placeholder
49
+
50
+ A native select has no placeholder; use a disabled, empty first option.
51
+
52
+ ```tsx
53
+ import { Field, FieldDescription, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
54
+
55
+ export function Placeholder() {
56
+ return (
57
+ <Field className="w-full max-w-sm">
58
+ <FieldLabel>Team size</FieldLabel>
59
+ <NativeSelect defaultValue="" required>
60
+ <NativeSelectOption value="" disabled>
61
+ Choose a range
62
+ </NativeSelectOption>
63
+ <NativeSelectOption value="1-10">1–10 people</NativeSelectOption>
64
+ <NativeSelectOption value="11-50">11–50 people</NativeSelectOption>
65
+ <NativeSelectOption value="51-250">51–250 people</NativeSelectOption>
66
+ <NativeSelectOption value="250+">More than 250</NativeSelectOption>
67
+ </NativeSelect>
68
+ <FieldDescription>A disabled empty first option works as the placeholder.</FieldDescription>
69
+ </Field>
70
+ );
71
+ }
72
+ ```
73
+
74
+ ### Groups
75
+
76
+ ```tsx
77
+ import { Field, FieldLabel, NativeSelect, NativeSelectOptGroup, NativeSelectOption } from "@zonsh/ui";
78
+
79
+ export function Groups() {
80
+ return (
81
+ <Field className="w-full max-w-sm">
82
+ <FieldLabel>What is it about?</FieldLabel>
83
+ <NativeSelect defaultValue="problem">
84
+ <NativeSelectOptGroup label="Help">
85
+ <NativeSelectOption value="general">General question</NativeSelectOption>
86
+ <NativeSelectOption value="billing">Billing</NativeSelectOption>
87
+ <NativeSelectOption value="problem">Report a problem</NativeSelectOption>
88
+ </NativeSelectOptGroup>
89
+ <NativeSelectOptGroup label="Ideas">
90
+ <NativeSelectOption value="feedback">Feedback</NativeSelectOption>
91
+ <NativeSelectOption value="feature">A feature request</NativeSelectOption>
92
+ </NativeSelectOptGroup>
93
+ </NativeSelect>
94
+ </Field>
95
+ );
96
+ }
97
+ ```
98
+
99
+ ### Sizes
100
+
101
+ ```tsx
102
+ import { Field, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
103
+
104
+ export function Sizes() {
105
+ return (
106
+ <div className="flex w-full max-w-xs flex-col gap-4">
107
+ <Field>
108
+ <FieldLabel>Dense</FieldLabel>
109
+ <NativeSelect size="sm" defaultValue="25">
110
+ <NativeSelectOption value="25">25 rows</NativeSelectOption>
111
+ <NativeSelectOption value="50">50 rows</NativeSelectOption>
112
+ <NativeSelectOption value="100">100 rows</NativeSelectOption>
113
+ </NativeSelect>
114
+ </Field>
115
+ <Field>
116
+ <FieldLabel>Default</FieldLabel>
117
+ <NativeSelect defaultValue="25">
118
+ <NativeSelectOption value="25">25 rows</NativeSelectOption>
119
+ <NativeSelectOption value="50">50 rows</NativeSelectOption>
120
+ <NativeSelectOption value="100">100 rows</NativeSelectOption>
121
+ </NativeSelect>
122
+ </Field>
123
+ </div>
124
+ );
125
+ }
126
+ ```
127
+
128
+ ### States
129
+
130
+ ```tsx
131
+ import { Field, FieldError, FieldLabel, NativeSelect, NativeSelectOption } from "@zonsh/ui";
132
+
133
+ function Invalid() {
134
+ return (
135
+ <Field invalid className="w-full max-w-sm">
136
+ <FieldLabel>Preferred language</FieldLabel>
137
+ <NativeSelect defaultValue="">
138
+ <NativeSelectOption value="" disabled>
139
+ Choose a language
140
+ </NativeSelectOption>
141
+ <NativeSelectOption value="en">English</NativeSelectOption>
142
+ <NativeSelectOption value="de">Deutsch</NativeSelectOption>
143
+ </NativeSelect>
144
+ <FieldError match>Choose a language for the interface.</FieldError>
145
+ </Field>
146
+ );
147
+ }
148
+
149
+ function Disabled() {
150
+ return (
151
+ <Field disabled className="w-full max-w-sm">
152
+ <FieldLabel>Billing period</FieldLabel>
153
+ <NativeSelect defaultValue="monthly">
154
+ <NativeSelectOption value="monthly">Monthly</NativeSelectOption>
155
+ <NativeSelectOption value="yearly">Yearly</NativeSelectOption>
156
+ </NativeSelect>
157
+ </Field>
158
+ );
159
+ }
160
+
161
+ /** The invalid and disabled states, one under the other. */
162
+ export function States() {
163
+ return (
164
+ <div className="flex w-full max-w-sm flex-col gap-8">
165
+ <Invalid />
166
+ <Disabled />
167
+ </div>
168
+ );
169
+ }
170
+ ```
171
+
172
+ ## Props
173
+
174
+ | Component | Prop | Type | Default |
175
+ | -------------- | ------------------ | ------------------- | ----------- |
176
+ | `NativeSelect` | `size` | `"sm" \| "default"` | `"default"` |
177
+ | `NativeSelect` | `wrapperClassName` | `string` | — |
178
+
179
+ `NativeSelect` takes every `<select>` prop (`name`, `value`, `defaultValue`, `onChange`, `required`, `disabled`). `className` styles the select; `wrapperClassName` the wrapper holding the chevron (width, layout). As a Base UI `Field.Control` it takes a `Field`'s label, description and validation. `NativeSelectOption` is `<option>`, `NativeSelectOptGroup` `<optgroup>`. Data attributes: `data-size`, `data-invalid`, `data-disabled`.
180
+
181
+ ## Brand rules
182
+
183
+ - **Do** keep option labels short and plain; browsers ignore most `<option>` styling.
184
+ - **Do** match the height of the fields beside it.
185
+ - **Don't** use `multiple`: the native multi-select cannot take the material. Use `CheckboxGroup` or `Combobox`.
186
+
187
+ ## Accessibility
188
+
189
+ - Keyboard, typeahead and screen reader support come from the platform.
190
+ - Label it with `FieldLabel` inside a `Field`.
191
+ - The chevron is decorative and `aria-hidden`.
192
+ - Invalid selects show the destructive border and ring, and a `FieldError` message.
193
+
194
+ ---
195
+
196
+ - Import: `import { NativeSelect, NativeSelectOption, NativeSelectOptGroup } from "@zonsh/ui"`
197
+ - Source: `packages/ui/src/components/native-select.tsx`
@@ -0,0 +1,253 @@
1
+ # Navigation menu
2
+
3
+ ```tsx
4
+ import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
5
+
6
+ const product = [
7
+ { href: "#projects", title: "Projects", description: "Create, organise and share your work." },
8
+ {
9
+ href: "#deploys",
10
+ title: "Deploys",
11
+ description: "A preview for every branch, production on merge.",
12
+ },
13
+ {
14
+ href: "#analytics",
15
+ title: "Analytics",
16
+ description: "Visits and performance, without cookies.",
17
+ },
18
+ ];
19
+
20
+ const docs = [
21
+ { href: "#start", title: "Getting started", description: "Install, sign in and deploy a first project." },
22
+ { href: "#guides", title: "Guides", description: "Step-by-step walkthroughs for common tasks." },
23
+ { href: "#reference", title: "API reference", description: "Every endpoint, parameter and response." },
24
+ ];
25
+
26
+ export function Header() {
27
+ return (
28
+ <NavigationMenu>
29
+ <NavigationMenuList>
30
+ <NavigationMenuItem>
31
+ <NavigationMenuTrigger>Product</NavigationMenuTrigger>
32
+ <NavigationMenuContent>
33
+ <ul className="m-0 grid list-none gap-1 p-0 sm:w-[440px]">
34
+ {product.map((item) => (
35
+ <li key={item.href}>
36
+ <NavigationMenuLink variant="row" href={item.href}>
37
+ {item.title}
38
+ <small>{item.description}</small>
39
+ </NavigationMenuLink>
40
+ </li>
41
+ ))}
42
+ </ul>
43
+ </NavigationMenuContent>
44
+ </NavigationMenuItem>
45
+ <NavigationMenuItem>
46
+ <NavigationMenuTrigger>Docs</NavigationMenuTrigger>
47
+ <NavigationMenuContent>
48
+ <ul className="m-0 grid list-none gap-1 p-0 sm:w-[380px]">
49
+ {docs.map((item) => (
50
+ <li key={item.href}>
51
+ <NavigationMenuLink variant="row" href={item.href}>
52
+ {item.title}
53
+ <small>{item.description}</small>
54
+ </NavigationMenuLink>
55
+ </li>
56
+ ))}
57
+ </ul>
58
+ </NavigationMenuContent>
59
+ </NavigationMenuItem>
60
+ <NavigationMenuItem>
61
+ <NavigationMenuLink href="#pricing" active>
62
+ Pricing
63
+ </NavigationMenuLink>
64
+ </NavigationMenuItem>
65
+ <NavigationMenuItem>
66
+ <NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
67
+ </NavigationMenuItem>
68
+ <NavigationMenuItem>
69
+ <NavigationMenuLink href="#about">About</NavigationMenuLink>
70
+ </NavigationMenuItem>
71
+ </NavigationMenuList>
72
+ </NavigationMenu>
73
+ );
74
+ }
75
+ ```
76
+
77
+ Site-header links that brighten on hover, when open, or on the current page. A panel opens in one `material-menu` popup that resizes and slides between items; its rows (`variant="row"`) take a title and a `<small>` description.
78
+
79
+ ## Usage
80
+
81
+ ```tsx
82
+ import {
83
+ NavigationMenu,
84
+ NavigationMenuContent,
85
+ NavigationMenuItem,
86
+ NavigationMenuLink,
87
+ NavigationMenuList,
88
+ NavigationMenuTrigger,
89
+ } from "@zonsh/ui";
90
+
91
+ <NavigationMenu>
92
+ <NavigationMenuList>
93
+ <NavigationMenuItem>
94
+ <NavigationMenuTrigger>Product</NavigationMenuTrigger>
95
+ <NavigationMenuContent>
96
+ <NavigationMenuLink variant="row" href="/product/deploys">
97
+ Deploys
98
+ </NavigationMenuLink>
99
+ </NavigationMenuContent>
100
+ </NavigationMenuItem>
101
+ <NavigationMenuItem>
102
+ <NavigationMenuLink href="/about">About</NavigationMenuLink>
103
+ </NavigationMenuItem>
104
+ </NavigationMenuList>
105
+ </NavigationMenu>;
106
+ ```
107
+
108
+ The props you'll use: `variant` on the root, and `active` (the current page) and `render` (your router's link) on links.
109
+
110
+ ## When to use
111
+
112
+ - A desktop header with a few sections, some grouping several pages ("Product").
113
+ - For a whole site header (logo, actions, mobile panel) use `SiteHeader`, built on this; use it directly only for what SiteHeader cannot express.
114
+ - Not for in-page views (`Tabs`) or app navigation (`Sidebar`).
115
+
116
+ ## Examples
117
+
118
+ ### Pill
119
+
120
+ One raised surface glides to the hovered item, the open trigger, or the current page.
121
+
122
+ ```tsx
123
+ import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
124
+
125
+ // product: as in the first example on this page that uses them.
126
+
127
+ export function Pill() {
128
+ return (
129
+ <NavigationMenu variant="pill">
130
+ <NavigationMenuList>
131
+ <NavigationMenuItem>
132
+ <NavigationMenuTrigger>Product</NavigationMenuTrigger>
133
+ <NavigationMenuContent>
134
+ <ul className="m-0 grid list-none gap-1 p-0 sm:w-[440px]">
135
+ {product.map((item) => (
136
+ <li key={item.href}>
137
+ <NavigationMenuLink variant="row" href={item.href}>
138
+ {item.title}
139
+ <small>{item.description}</small>
140
+ </NavigationMenuLink>
141
+ </li>
142
+ ))}
143
+ </ul>
144
+ </NavigationMenuContent>
145
+ </NavigationMenuItem>
146
+ <NavigationMenuItem>
147
+ <NavigationMenuLink href="#pricing" active>
148
+ Pricing
149
+ </NavigationMenuLink>
150
+ </NavigationMenuItem>
151
+ <NavigationMenuItem>
152
+ <NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
153
+ </NavigationMenuItem>
154
+ <NavigationMenuItem>
155
+ <NavigationMenuLink href="#about">About</NavigationMenuLink>
156
+ </NavigationMenuItem>
157
+ </NavigationMenuList>
158
+ </NavigationMenu>
159
+ );
160
+ }
161
+ ```
162
+
163
+ ### Underline
164
+
165
+ A 1px foreground rule, gliding the same way.
166
+
167
+ ```tsx
168
+ import { NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger } from "@zonsh/ui";
169
+
170
+ // docs: as in the first example on this page that uses them.
171
+
172
+ export function Underline() {
173
+ return (
174
+ <NavigationMenu variant="underline">
175
+ <NavigationMenuList>
176
+ <NavigationMenuItem>
177
+ <NavigationMenuTrigger>Docs</NavigationMenuTrigger>
178
+ <NavigationMenuContent>
179
+ <ul className="m-0 grid list-none gap-1 p-0 sm:w-[380px]">
180
+ {docs.map((item) => (
181
+ <li key={item.href}>
182
+ <NavigationMenuLink variant="row" href={item.href}>
183
+ {item.title}
184
+ <small>{item.description}</small>
185
+ </NavigationMenuLink>
186
+ </li>
187
+ ))}
188
+ </ul>
189
+ </NavigationMenuContent>
190
+ </NavigationMenuItem>
191
+ <NavigationMenuItem>
192
+ <NavigationMenuLink href="#pricing" active>
193
+ Pricing
194
+ </NavigationMenuLink>
195
+ </NavigationMenuItem>
196
+ <NavigationMenuItem>
197
+ <NavigationMenuLink href="#blog">Blog</NavigationMenuLink>
198
+ </NavigationMenuItem>
199
+ <NavigationMenuItem>
200
+ <NavigationMenuLink href="#about">About</NavigationMenuLink>
201
+ </NavigationMenuItem>
202
+ </NavigationMenuList>
203
+ </NavigationMenu>
204
+ );
205
+ }
206
+ ```
207
+
208
+ ## Props
209
+
210
+ | Prop | Type | Default |
211
+ | ---------------------------------------- | ------------------------------------------------------------------------ | --------------- |
212
+ | `NavigationMenu.variant` | `"text" \| "pill" \| "underline"` — the bar's design | `"text"` |
213
+ | `NavigationMenu.positioner` | Base UI `Positioner` props (`sideOffset`, `align`, `collisionPadding` …) | `sideOffset: 8` |
214
+ | `NavigationMenu.value` / `onValueChange` | controlled open item | — |
215
+ | `NavigationMenu.delay` / `closeDelay` | `number` (ms) | `50` |
216
+ | `NavigationMenuLink.variant` | `"bar" \| "row"` | `"bar"` |
217
+ | `NavigationMenuLink.active` | `boolean` — the current page | `false` |
218
+ | `NavigationMenuLink.closeOnClick` | `boolean` | `false` |
219
+ | `NavigationMenuLink.render` | `ReactElement` — your router's link | `<a>` |
220
+
221
+ `NavigationMenu` renders the portal, positioner, popup and viewport for you. Data attributes: `data-variant` on the root and links, `data-popup-open` on triggers, `data-active` on the current link.
222
+
223
+ ## Brand rules
224
+
225
+ - **Do** keep top-level labels to one word, and about five of them: "Product Docs Pricing Blog About".
226
+ - **Do** give panel rows a short description of the page.
227
+ - **Don't** put actions ("Sign up") in the menu; use a `Button` in the header's actions.
228
+ - **Don't** fill top-level items on hover; in `pill` one surface glides between them.
229
+ - **Don't** add more than one level of panels.
230
+
231
+ ## Accessibility
232
+
233
+ - Base UI provides the disclosure semantics and `aria-expanded`.
234
+ - `active` sets `aria-current="page"` on the link.
235
+ - On small screens, switch to a full panel (see `SiteHeader`) rather than a hover menu.
236
+
237
+ ### Keyboard
238
+
239
+ | Key | What it does |
240
+ | --------------- | -------------------------------------------------------------------------- |
241
+ | Tab / Shift+Tab | Moves between the links and triggers; from an open trigger, into its panel |
242
+ | ← / → | Moves between the links and triggers (swapped right to left) |
243
+ | Enter / Space | Opens or closes the focused trigger's panel, or follows the focused link |
244
+ | ↓ | Opens the focused trigger's panel |
245
+ | Escape | Closes the open panel and returns focus to its trigger |
246
+
247
+ Tabbing out of an open panel closes it.
248
+
249
+ ---
250
+
251
+ - Import: `import { NavigationMenu, NavigationMenuList, NavigationMenuItem, NavigationMenuTrigger, NavigationMenuContent, NavigationMenuLink } from "@zonsh/ui"`
252
+ - Source: `packages/ui/src/components/navigation-menu.tsx`
253
+ - Primitive: `@base-ui/react/navigation-menu` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/navigation-menu.md`)
@@ -0,0 +1,210 @@
1
+ # Number Field
2
+
3
+ ```tsx
4
+ import { Field, FieldDescription, FieldLabel, NumberField } from "@zonsh/ui";
5
+
6
+ export function Basic() {
7
+ return (
8
+ <Field className="max-w-60">
9
+ <FieldLabel>Tickets</FieldLabel>
10
+ <NumberField defaultValue={2} min={1} max={10} />
11
+ <FieldDescription>Up to ten per order.</FieldDescription>
12
+ </Field>
13
+ );
14
+ }
15
+ ```
16
+
17
+ A recessed 38px field (30px dense): the number centred in Licht Mono tabular figures, a raised round − and + on either side.
18
+
19
+ ## Usage
20
+
21
+ ```tsx
22
+ import { Field, FieldLabel, NumberField } from "@zonsh/ui";
23
+
24
+ <Field>
25
+ <FieldLabel>Tickets</FieldLabel>
26
+ <NumberField defaultValue={2} min={1} max={10} />
27
+ </Field>;
28
+ ```
29
+
30
+ The props you'll use: `min` / `max`, `step`, and `format` for currency and units.
31
+
32
+ ## When to use
33
+
34
+ - Exact counts, quantities and amounts: tickets, seats, a monthly budget.
35
+ - For a rough position or a range, use `Slider`.
36
+
37
+ ## Examples
38
+
39
+ ### Stacked steppers
40
+
41
+ `steppers="stacked"` puts the number at the start and ▲ ▼ in one split key at the end (mirrored right to left), for settings packed in a column. The halves are small, so keep `sides` for touch.
42
+
43
+ ```tsx
44
+ import { Field, FieldLabel, NumberField } from "@zonsh/ui";
45
+
46
+ export function Stacked() {
47
+ return (
48
+ <div className="flex flex-col gap-4">
49
+ <Field className="max-w-48">
50
+ <FieldLabel>Width (px)</FieldLabel>
51
+ <NumberField steppers="stacked" defaultValue={320} min={0} step={10} />
52
+ </Field>
53
+ <Field className="max-w-48">
54
+ <FieldLabel>Columns</FieldLabel>
55
+ <NumberField steppers="stacked" size="sm" defaultValue={12} min={1} max={24} />
56
+ </Field>
57
+ </div>
58
+ );
59
+ }
60
+ ```
61
+
62
+ ### Scrub label
63
+
64
+ `label` is a scrub area: drag across it. Leave it out under a `FieldLabel`.
65
+
66
+ ```tsx
67
+ import { NumberField } from "@zonsh/ui";
68
+
69
+ export function ScrubLabel() {
70
+ return (
71
+ <div className="max-w-60">
72
+ <NumberField label="Seats" defaultValue={12} min={1} max={250} />
73
+ </div>
74
+ );
75
+ }
76
+ ```
77
+
78
+ ### Currency
79
+
80
+ `format` writes currency and units.
81
+
82
+ ```tsx
83
+ import { Field, FieldLabel, NumberField } from "@zonsh/ui";
84
+
85
+ export function Currency() {
86
+ return (
87
+ <Field className="max-w-60">
88
+ <FieldLabel>Monthly budget</FieldLabel>
89
+ <NumberField
90
+ defaultValue={4000}
91
+ min={0}
92
+ step={500}
93
+ format={{ style: "currency", currency: "EUR", maximumFractionDigits: 0 }}
94
+ />
95
+ </Field>
96
+ );
97
+ }
98
+ ```
99
+
100
+ ### Sizes
101
+
102
+ Dense steppers are flat until hovered.
103
+
104
+ ```tsx
105
+ import { Field, FieldLabel, NumberField } from "@zonsh/ui";
106
+
107
+ export function Sizes() {
108
+ return (
109
+ <div className="flex flex-col gap-4">
110
+ <Field className="max-w-48">
111
+ <FieldLabel>Dense</FieldLabel>
112
+ <NumberField size="sm" defaultValue={3} min={0} />
113
+ </Field>
114
+ <Field className="max-w-48">
115
+ <FieldLabel>Default</FieldLabel>
116
+ <NumberField defaultValue={3} min={0} />
117
+ </Field>
118
+ </div>
119
+ );
120
+ }
121
+ ```
122
+
123
+ ### States
124
+
125
+ ```tsx
126
+ import { Field, FieldError, FieldLabel, NumberField } from "@zonsh/ui";
127
+
128
+ function Invalid() {
129
+ return (
130
+ <Field invalid className="max-w-60">
131
+ <FieldLabel>Copies</FieldLabel>
132
+ <NumberField defaultValue={0} min={0} />
133
+ <FieldError match>Order at least one copy.</FieldError>
134
+ </Field>
135
+ );
136
+ }
137
+
138
+ function Disabled() {
139
+ return (
140
+ <Field disabled className="max-w-60">
141
+ <FieldLabel>Storage included (GB)</FieldLabel>
142
+ <NumberField defaultValue={10} />
143
+ </Field>
144
+ );
145
+ }
146
+
147
+ /** The invalid and disabled states, one under the other. */
148
+ export function States() {
149
+ return (
150
+ <div className="flex w-full max-w-sm flex-col gap-8">
151
+ <Invalid />
152
+ <Disabled />
153
+ </div>
154
+ );
155
+ }
156
+ ```
157
+
158
+ ## Motion
159
+
160
+ A step (stepper, arrow key, wheel) rolls the changed digits: up rises from below, down drops from above. A digit that appears or disappears (9 → 10) grows or shrinks its place, so the value never jumps. Typing, pasting and scrubbing don't roll. A step that comes while the digits still roll (a held key or stepper, a fast wheel) rolls on from where they are, so a held key keeps counting visibly and lands on the last value. The roll is NumberRoll's: drawn over the input while it moves, and the input, with its caret and selection, shows again once the digits land.
161
+
162
+ ## Props
163
+
164
+ | Prop | Type | Default |
165
+ | ------------- | ---------------------------------------------- | -------------------------------------------- |
166
+ | `size` | `"sm" \| "default"` | `"default"` |
167
+ | `steppers` | `"sides" \| "stacked"` | `"sides"` |
168
+ | `label` | `ReactNode`: renders a scrub-area label | — |
169
+ | `placeholder` | `string` | — |
170
+ | `labels` | `{ decrement?, increment?, roleDescription? }` | `"Decrease"`, `"Increase"`, `"Number field"` |
171
+ | `min` / `max` | `number` | — |
172
+ | `step` | `number \| "any"` | `1` |
173
+ | `format` | `Intl.NumberFormatOptions` | — |
174
+
175
+ `value`, `defaultValue`, `onValueChange`, `onValueCommitted`, `smallStep`, `largeStep`, `allowWheelScrub`, `name`, `required`, `disabled` and `readOnly` go to Base UI's `NumberField.Root`. A form reset returns an uncontrolled field to its `defaultValue`. Data attributes: `data-size`, `data-steppers`, `data-disabled`, `data-invalid`, `data-scrubbing`.
176
+
177
+ `labels` (`Partial<NumberFieldMessages>`) names the steppers and the field's role; a `LocaleProvider` sets them for every NumberField (`messages.numberField`), and its `locale` formats the number unless `locale` is given.
178
+
179
+ ## Brand rules
180
+
181
+ - **Do** set `min` and `max` to the business rule, so the steppers stop where they should.
182
+ - **Do** keep digits mono and tabular.
183
+ - **Don't** type units into the input by hand. Use `format`.
184
+
185
+ ## Accessibility
186
+
187
+ - The input is a text field with `aria-roledescription="Number field"`. While an IME composes, its keys don't step or commit.
188
+ - Pressing a stepper or the scrub label focuses the input, so the arrows keep stepping; no caret shows until the number is clicked or edited.
189
+ - The steppers have accessible names; change them with `labels.decrement` and `labels.increment`.
190
+ - Focus shows the field's 2px `--control-focus` outline and border.
191
+ - The digit roll is an overlay hidden from assistive tech; the input keeps the value and name. Under `prefers-reduced-motion` the value changes without moving.
192
+
193
+ ### Keyboard
194
+
195
+ | Key | What it does |
196
+ | ------------------- | ------------------------------------------------------------------- |
197
+ | ↑ / ↓ | Steps the value by `step` |
198
+ | Shift+↑ / ↓ | Steps by `largeStep` (10 by default) |
199
+ | Page Up / Page Down | Steps by `largeStep`, as Shift+↑ / ↓ do |
200
+ | Alt+↑ / ↓ | Steps by `smallStep` (0.1 by default) |
201
+ | Home / End | Sets the value to `min` or `max`, when that bound is set |
202
+ | Enter | Puts the typed number in, and the focus stays; a form still submits |
203
+
204
+ Typed numbers are clamped and formatted on Enter or blur. Only digits, the locale's separators and a sign (when negatives are allowed) can be typed.
205
+
206
+ ---
207
+
208
+ - Import: `import { NumberField } from "@zonsh/ui"`
209
+ - Source: `packages/ui/src/components/number-field.tsx`
210
+ - Primitive: `@base-ui/react/number-field` (Base UI docs: `node_modules/@base-ui/react/docs/react/components/number-field.md`)