@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,709 @@
1
+ # Bottom Nav
2
+
3
+ ```tsx
4
+ import { BottomNav, BottomNavItem, Eyebrow, Heading } from "@zonsh/ui";
5
+ import { HouseIcon, LibraryIcon, SearchIcon, UserIcon } from "lucide-react";
6
+ import * as React from "react";
7
+
8
+ /**
9
+ * A phone-sized screen for the demos: 390px wide, its content scrolling inside, and the bar
10
+ * pinned to its bottom with `position="absolute"`. The content keeps the bar's height free, and a
11
+ * floating capsule's gaps too.
12
+ */
13
+ function Phone({
14
+ label,
15
+ children,
16
+ nav,
17
+ floating = false,
18
+ }: {
19
+ label: string;
20
+ children: React.ReactNode;
21
+ nav: React.ReactNode;
22
+ floating?: boolean;
23
+ }) {
24
+ return (
25
+ <div className="relative mx-auto h-[600px] w-full max-w-[390px] overflow-hidden border border-field-edge">
26
+ {/* Focusable, so the screen scrolls from the keyboard too. */}
27
+ <div
28
+ role="region"
29
+ aria-label={label}
30
+ tabIndex={0}
31
+ data-slot="demo-phone-screen"
32
+ className={
33
+ floating
34
+ ? "h-full overflow-y-auto px-5 pt-8 pb-[calc(var(--bottom-nav-bar)+40px)] focus-ring"
35
+ : "h-full overflow-y-auto px-5 pt-8 pb-[calc(var(--bottom-nav-bar)+1px)] focus-ring"
36
+ }
37
+ >
38
+ {children}
39
+ </div>
40
+ {nav}
41
+ </div>
42
+ );
43
+ }
44
+
45
+ function Rows({ rows }: { rows: { title: string; meta: string }[] }) {
46
+ return (
47
+ <ul className="mt-6">
48
+ {rows.map((row) => (
49
+ <li key={row.title} className="border-t border-border/60 py-4 last:border-b">
50
+ <p className="text-[15px] leading-snug text-foreground">{row.title}</p>
51
+ <p className="mt-1 font-mono text-xs text-muted-foreground">{row.meta}</p>
52
+ </li>
53
+ ))}
54
+ </ul>
55
+ );
56
+ }
57
+
58
+ const screens: Record<string, { eyebrow: string; title: string; rows: { title: string; meta: string }[] }> = {
59
+ home: {
60
+ eyebrow: "Continue reading",
61
+ title: "Good evening",
62
+ rows: [
63
+ { title: "The Overstory", meta: "Chapter 14 · 62%" },
64
+ { title: "A Field Guide to Getting Lost", meta: "Essay 3 · 18%" },
65
+ { title: "Braiding Sweetgrass", meta: "Chapter 2 · 9%" },
66
+ ],
67
+ },
68
+ search: {
69
+ eyebrow: "Search",
70
+ title: "Find a book",
71
+ rows: [
72
+ { title: "Recently searched: Ursula K. Le Guin", meta: "12 results" },
73
+ { title: "Recently searched: tide pools", meta: "4 results" },
74
+ ],
75
+ },
76
+ library: {
77
+ eyebrow: "Library",
78
+ title: "Your shelves",
79
+ rows: [
80
+ { title: "Reading", meta: "3 books" },
81
+ { title: "Want to read", meta: "17 books" },
82
+ { title: "Finished this year", meta: "9 books" },
83
+ ],
84
+ },
85
+ account: {
86
+ eyebrow: "Account",
87
+ title: "Mara Okafor",
88
+ rows: [
89
+ { title: "Reading goal", meta: "12 books in 2026" },
90
+ { title: "Downloads", meta: "On this phone only" },
91
+ ],
92
+ },
93
+ };
94
+
95
+ export function Basic() {
96
+ const [value, setValue] = React.useState("home");
97
+ const screen = screens[value]!;
98
+ return (
99
+ <Phone
100
+ label="Reading app screen"
101
+ nav={
102
+ <BottomNav position="absolute" aria-label="Reading app" value={value} onValueChange={setValue}>
103
+ <BottomNavItem value="home" icon={<HouseIcon />} label="Home" />
104
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
105
+ <BottomNavItem value="library" icon={<LibraryIcon />} label="Library" />
106
+ <BottomNavItem value="account" icon={<UserIcon />} label="Account" />
107
+ </BottomNav>
108
+ }
109
+ >
110
+ <Eyebrow>{screen.eyebrow}</Eyebrow>
111
+ <Heading level={3} className="mt-2">
112
+ {screen.title}
113
+ </Heading>
114
+ <Rows rows={screen.rows} />
115
+ </Phone>
116
+ );
117
+ }
118
+ ```
119
+
120
+ The places of a phone app, fixed to the bottom of the screen above the home indicator. Each item is an icon alone, its label read by screen readers. The current item is in the foreground ink, the rest muted; its mark glides to the item you pick in 240ms (`--duration-glide`), and a tap answers on touch-down — the icon presses in and springs back. Two variants, either one can be frosted:
121
+
122
+ - **`bar`** (default): full width on the page ground behind a hairline, 22px icons; a 32px, 2px rule marks the current place.
123
+ - **`capsule`**: floats over the page, up to 28rem wide; the current item sits on a pill in the secondary button's material. It can take one round primary `action`.
124
+
125
+ ## Usage
126
+
127
+ ```tsx
128
+ import { BottomNav, BottomNavItem } from "@zonsh/ui";
129
+ import { HouseIcon, LibraryIcon, SearchIcon, UserIcon } from "lucide-react";
130
+
131
+ const [view, setView] = React.useState("home");
132
+
133
+ <main className="pb-(--bottom-nav-h)">…</main>
134
+
135
+ <BottomNav value={view} onValueChange={setView}>
136
+ <BottomNavItem value="home" icon={<HouseIcon />} label="Home" />
137
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
138
+ <BottomNavItem value="library" icon={<LibraryIcon />} label="Library" />
139
+ <BottomNavItem value="account" icon={<UserIcon />} label="Account" />
140
+ </BottomNav>
141
+ ```
142
+
143
+ The props you'll reach for: `value` / `onValueChange`, `variant`, and `icon` + `label` on each item.
144
+
145
+ The bar is `position: fixed` and sets `--bottom-nav-h` on the root to its height (safe area included; `0px` while hidden). Reserve it with `pb-(--bottom-nav-h)`, `scroll-pb` or a sticky footer's `bottom-(--bottom-nav-h)`. The root's `scroll-padding-bottom` follows it, so a field focused by Tab scrolls above the bar, and `Toaster` lifts its toasts over it. The safe area needs `viewport-fit=cover` in the viewport meta.
146
+
147
+ ## When to use
148
+
149
+ - Three to five top-level places people switch between all day (Home, Search, Library, Account), each one short word.
150
+ - More places, or ones visited now and then: a `Sidebar`, whose mobile sheet holds the rest — see [With a sidebar](#with-a-sidebar).
151
+ - Views of one thing (a project's Overview, Activity, Settings): `Tabs`. A bottom nav changes where you are; tabs change what you see.
152
+ - An action is never an item. The one thing people make all day can be a capsule's `action`; Log out or Share is a `Button` on the page.
153
+ - It is hidden from `md` up: give the same places to a `Sidebar` or `SiteHeader` there.
154
+
155
+ ## Examples
156
+
157
+ ### Capsule
158
+
159
+ Floats 16px above the bottom edge or the home indicator; the page around it stays touchable.
160
+
161
+ ```tsx
162
+ import { BottomNav, BottomNavItem, Eyebrow, Heading } from "@zonsh/ui";
163
+ import { HouseIcon, LibraryIcon, SearchIcon, UserIcon } from "lucide-react";
164
+ import * as React from "react";
165
+
166
+ // Phone, Rows, screens: as in the first example on this page that uses them.
167
+
168
+ export function Capsule() {
169
+ const [value, setValue] = React.useState("home");
170
+ const screen = screens[value]!;
171
+ return (
172
+ <Phone
173
+ floating
174
+ label="Reading app screen, capsule"
175
+ nav={
176
+ <BottomNav
177
+ variant="capsule"
178
+ position="absolute"
179
+ aria-label="Reading app"
180
+ value={value}
181
+ onValueChange={setValue}
182
+ >
183
+ <BottomNavItem value="home" icon={<HouseIcon />} label="Home" />
184
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
185
+ <BottomNavItem value="library" icon={<LibraryIcon />} label="Library" />
186
+ <BottomNavItem value="account" icon={<UserIcon />} label="Account" />
187
+ </BottomNav>
188
+ }
189
+ >
190
+ <Eyebrow>{screen.eyebrow}</Eyebrow>
191
+ <Heading level={3} className="mt-2">
192
+ {screen.title}
193
+ </Heading>
194
+ <Rows rows={screen.rows} />
195
+ </Phone>
196
+ );
197
+ }
198
+ ```
199
+
200
+ ### Capsule and action
201
+
202
+ `action` puts one `BottomNavAction` — a round icon-only primary named by `label` — beside the capsule, for the screen's main job. A bar takes no action.
203
+
204
+ ```tsx
205
+ <BottomNav
206
+ variant="capsule"
207
+ value={view}
208
+ onValueChange={setView}
209
+ action={<BottomNavAction icon={<PlusIcon />} label="New note" onClick={createNote} />}
210
+ >
211
+ <BottomNavItem value="notes" icon={<NotebookPenIcon />} label="Notes" />…
212
+ </BottomNav>
213
+ ```
214
+
215
+ ```tsx
216
+ import { BottomNav, BottomNavAction, BottomNavItem, Eyebrow, Heading, Text } from "@zonsh/ui";
217
+ import { NotebookPenIcon, PlusIcon, SearchIcon, SettingsIcon, UsersIcon } from "lucide-react";
218
+ import * as React from "react";
219
+
220
+ // Phone, Rows: as in the first example on this page that uses them.
221
+
222
+ export function CapsuleAction() {
223
+ const [value, setValue] = React.useState("notes");
224
+ const [notes, setNotes] = React.useState([
225
+ { title: "Glaze recipes to try", meta: "Edited today" },
226
+ { title: "Kiln log, November", meta: "Edited yesterday" },
227
+ { title: "Market stall checklist", meta: "Edited 3 days ago" },
228
+ ]);
229
+ return (
230
+ <Phone
231
+ floating
232
+ label="Notebook screen, capsule and action"
233
+ nav={
234
+ <BottomNav
235
+ variant="capsule"
236
+ position="absolute"
237
+ aria-label="Notebook"
238
+ value={value}
239
+ onValueChange={setValue}
240
+ action={
241
+ <BottomNavAction
242
+ icon={<PlusIcon />}
243
+ label="New note"
244
+ onClick={() => {
245
+ setValue("notes");
246
+ setNotes((all) => [{ title: `Untitled note ${all.length - 2}`, meta: "Just now" }, ...all]);
247
+ }}
248
+ />
249
+ }
250
+ >
251
+ <BottomNavItem value="notes" icon={<NotebookPenIcon />} label="Notes" />
252
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
253
+ <BottomNavItem value="shared" icon={<UsersIcon />} label="Shared" badge={2} />
254
+ <BottomNavItem value="settings" icon={<SettingsIcon />} label="Settings" />
255
+ </BottomNav>
256
+ }
257
+ >
258
+ <Eyebrow>Notebook</Eyebrow>
259
+ <Heading level={3} className="mt-2">
260
+ {value === "notes" ? "All notes" : value[0]!.toUpperCase() + value.slice(1)}
261
+ </Heading>
262
+ {value === "notes" ? (
263
+ <Rows rows={notes} />
264
+ ) : (
265
+ <Text tone="muted" size="sm" className="mt-3">
266
+ Nothing here yet.
267
+ </Text>
268
+ )}
269
+ </Phone>
270
+ );
271
+ }
272
+ ```
273
+
274
+ ### Frosted
275
+
276
+ `frosted` lets the page show through, blurred, with a stronger resting ink. Use it where photos, a map or covers scroll under; over text it only greys the page. Without `backdrop-filter` it is nearly opaque.
277
+
278
+ ```tsx
279
+ import { BottomNav, BottomNavAction, BottomNavItem, Eyebrow, Heading } from "@zonsh/ui";
280
+ import { ImagesIcon, PlusIcon, SearchIcon, SparklesIcon, UsersIcon } from "lucide-react";
281
+ import * as React from "react";
282
+
283
+ // Phone: as in the first example on this page that uses them.
284
+
285
+ /** Stand-ins for photos: soft fields of colour, so the glass has something to show. */
286
+ const photos = [
287
+ "radial-gradient(70% 90% at 30% 30%, oklch(0.74 0.11 58), transparent), oklch(0.62 0.06 40)",
288
+ "radial-gradient(80% 80% at 70% 60%, oklch(0.6 0.09 250), transparent), oklch(0.8 0.03 230)",
289
+ "radial-gradient(70% 70% at 40% 70%, oklch(0.7 0.1 140), transparent), oklch(0.86 0.04 110)",
290
+ "radial-gradient(60% 80% at 60% 30%, oklch(0.82 0.08 85), transparent), oklch(0.66 0.05 60)",
291
+ "radial-gradient(70% 90% at 30% 70%, oklch(0.55 0.08 300), transparent), oklch(0.78 0.04 320)",
292
+ "radial-gradient(80% 70% at 50% 40%, oklch(0.72 0.07 200), transparent), oklch(0.52 0.05 220)",
293
+ ];
294
+
295
+ function PhotoGrid() {
296
+ return (
297
+ <>
298
+ <Eyebrow>Library</Eyebrow>
299
+ <Heading level={3} className="mt-2">
300
+ November
301
+ </Heading>
302
+ <ul className="mt-6 grid grid-cols-3 gap-1">
303
+ {Array.from({ length: 24 }, (_, i) => (
304
+ <li key={i}>
305
+ <div
306
+ role="img"
307
+ aria-label={`Photo ${i + 1}`}
308
+ className="aspect-square"
309
+ style={{ background: photos[(i * 5) % photos.length] }}
310
+ />
311
+ </li>
312
+ ))}
313
+ </ul>
314
+ </>
315
+ );
316
+ }
317
+
318
+ export function Frosted() {
319
+ const [value, setValue] = React.useState("library");
320
+ return (
321
+ <Phone
322
+ floating
323
+ label="Photos screen, frosted capsule"
324
+ nav={
325
+ <BottomNav
326
+ variant="capsule"
327
+ frosted
328
+ position="absolute"
329
+ aria-label="Photos"
330
+ value={value}
331
+ onValueChange={setValue}
332
+ action={<BottomNavAction icon={<PlusIcon />} label="Add photos" />}
333
+ >
334
+ <BottomNavItem value="library" icon={<ImagesIcon />} label="Library" />
335
+ <BottomNavItem value="memories" icon={<SparklesIcon />} label="Memories" />
336
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
337
+ <BottomNavItem value="shared" icon={<UsersIcon />} label="Shared" badge />
338
+ </BottomNav>
339
+ }
340
+ >
341
+ <PhotoGrid />
342
+ </Phone>
343
+ );
344
+ }
345
+ ```
346
+
347
+ ```tsx
348
+ import { BottomNav, BottomNavItem, Eyebrow, Heading } from "@zonsh/ui";
349
+ import { ImagesIcon, SearchIcon, SparklesIcon, UserIcon, UsersIcon } from "lucide-react";
350
+ import * as React from "react";
351
+
352
+ // Phone, photos, PhotoGrid: as in the first example on this page that uses them.
353
+
354
+ export function FrostedBar() {
355
+ const [value, setValue] = React.useState("library");
356
+ return (
357
+ <Phone
358
+ label="Photos screen, frosted bar"
359
+ nav={
360
+ <BottomNav frosted position="absolute" aria-label="Photos" value={value} onValueChange={setValue}>
361
+ <BottomNavItem value="library" icon={<ImagesIcon />} label="Library" />
362
+ <BottomNavItem value="memories" icon={<SparklesIcon />} label="Memories" />
363
+ <BottomNavItem value="search" icon={<SearchIcon />} label="Search" />
364
+ <BottomNavItem value="shared" icon={<UsersIcon />} label="Shared" badge />
365
+ <BottomNavItem value="account" icon={<UserIcon />} label="Account" />
366
+ </BottomNav>
367
+ }
368
+ >
369
+ <PhotoGrid />
370
+ </Phone>
371
+ );
372
+ }
373
+ ```
374
+
375
+ ### Drag to choose
376
+
377
+ Press the current item and drag: the pill lifts and trails your finger on a spring, stretching with speed, and the icon under it swells (with a haptic tick where supported). Let go and the item under it is chosen as by a tap — or, let go while still moving, the one the finger was heading for — a link navigates, `onValueChange` fires, and the pill sets down in one motion: it carries on from its own speed, shrinks, loses its lift and lands on the item together, on one spring, and ends on the very pixel where it then rests. On a bar the rule does the same. A press that stays put is a tap, a vertical swipe still scrolls, and mouse and pen drag too. Under reduced motion there are no springs or stretch.
378
+
379
+ ### With badges
380
+
381
+ `badge` takes a count ("99+" above 99, nothing at zero) or `true` for a dot, read after the label as "3 new" / "New", or your `badgeLabel`.
382
+
383
+ ```tsx
384
+ import { BottomNav, BottomNavItem, Eyebrow, Heading } from "@zonsh/ui";
385
+ import { HeartIcon, PackageIcon, ShoppingBagIcon, ShoppingBasketIcon, UserIcon } from "lucide-react";
386
+ import * as React from "react";
387
+
388
+ // Phone, Rows: as in the first example on this page that uses them.
389
+
390
+ export function Badges() {
391
+ const [value, setValue] = React.useState("shop");
392
+ return (
393
+ <Phone
394
+ label="Shop screen"
395
+ nav={
396
+ <BottomNav position="absolute" aria-label="Shop" value={value} onValueChange={setValue}>
397
+ <BottomNavItem value="shop" icon={<ShoppingBagIcon />} label="Shop" />
398
+ <BottomNavItem value="saved" icon={<HeartIcon />} label="Saved" />
399
+ <BottomNavItem
400
+ value="basket"
401
+ icon={<ShoppingBasketIcon />}
402
+ label="Basket"
403
+ badge={2}
404
+ badgeLabel="2 in your basket"
405
+ />
406
+ <BottomNavItem
407
+ value="orders"
408
+ icon={<PackageIcon />}
409
+ label="Orders"
410
+ badge
411
+ badgeLabel="An order has shipped"
412
+ />
413
+ <BottomNavItem value="account" icon={<UserIcon />} label="Account" />
414
+ </BottomNav>
415
+ }
416
+ >
417
+ <Eyebrow>Autumn ceramics</Eyebrow>
418
+ <Heading level={3} className="mt-2">
419
+ Stoneware for the table
420
+ </Heading>
421
+ <Rows
422
+ rows={[
423
+ { title: "Speckled mug, 350 ml", meta: "€24" },
424
+ { title: "Shallow bowl, oat glaze", meta: "€32" },
425
+ { title: "Serving plate, 28 cm", meta: "€48" },
426
+ ]}
427
+ />
428
+ </Phone>
429
+ );
430
+ }
431
+ ```
432
+
433
+ ### Router links
434
+
435
+ Pass the router's link as `render` and set `current` from the pathname, so `/notes/42` still marks Notes. `href` alone renders an `<a>`; neither, a `<button>`.
436
+
437
+ ```tsx
438
+ import { Link, useLocation } from "react-router";
439
+
440
+ const { pathname } = useLocation();
441
+
442
+ <BottomNav>
443
+ <BottomNavItem
444
+ icon={<NotebookPenIcon />}
445
+ label="Notes"
446
+ current={pathname.startsWith("/notes")}
447
+ render={<Link to="/notes" />}
448
+ />
449
+ …
450
+ </BottomNav>;
451
+ ```
452
+
453
+ ```tsx
454
+ import { BottomNav, BottomNavItem, Eyebrow, Heading, Text } from "@zonsh/ui";
455
+ import { NotebookPenIcon, SearchIcon, SettingsIcon, UsersIcon } from "lucide-react";
456
+ import * as React from "react";
457
+
458
+ // Phone: as in the first example on this page that uses them.
459
+
460
+ /** Stands in for a router's link (`<Link to>` in React Router, TanStack Router or Next.js). */
461
+ function Link({
462
+ to,
463
+ navigate,
464
+ ...props
465
+ }: React.ComponentProps<"a"> & { to: string; navigate: (to: string) => void }) {
466
+ return (
467
+ <a
468
+ href={to}
469
+ {...props}
470
+ onClick={(event) => {
471
+ props.onClick?.(event);
472
+ // A router navigates on the client instead of loading the page.
473
+ event.preventDefault();
474
+ navigate(to);
475
+ }}
476
+ />
477
+ );
478
+ }
479
+
480
+ export function RouterLinks() {
481
+ const [pathname, navigate] = React.useState("/notes");
482
+ const pages = [
483
+ { to: "/notes", icon: <NotebookPenIcon />, label: "Notes" },
484
+ { to: "/search", icon: <SearchIcon />, label: "Search" },
485
+ { to: "/shared", icon: <UsersIcon />, label: "Shared" },
486
+ { to: "/settings", icon: <SettingsIcon />, label: "Settings" },
487
+ ];
488
+ const page = pages.find((p) => p.to === pathname)!;
489
+ return (
490
+ <Phone
491
+ label="Notebook screen"
492
+ nav={
493
+ <BottomNav position="absolute" aria-label="Notebook">
494
+ {pages.map((p) => (
495
+ <BottomNavItem
496
+ key={p.to}
497
+ icon={p.icon}
498
+ label={p.label}
499
+ current={pathname.startsWith(p.to)}
500
+ render={<Link to={p.to} navigate={navigate} />}
501
+ />
502
+ ))}
503
+ </BottomNav>
504
+ }
505
+ >
506
+ <Eyebrow>{pathname}</Eyebrow>
507
+ <Heading level={3} className="mt-2">
508
+ {page.label}
509
+ </Heading>
510
+ <Text tone="muted" size="sm" className="mt-3">
511
+ Each item is a link; the router decides which one is current.
512
+ </Text>
513
+ </Phone>
514
+ );
515
+ }
516
+ ```
517
+
518
+ ### Hide on scroll
519
+
520
+ `hideOnScroll` slides the bar away on scroll down and back on scroll up, at the top, or on focus. Its space stays reserved, so nothing jumps.
521
+
522
+ ```tsx
523
+ import { BottomNav, BottomNavItem, Eyebrow, Heading, Text } from "@zonsh/ui";
524
+ import { BookOpenIcon, CalendarDaysIcon, UserIcon } from "lucide-react";
525
+ import * as React from "react";
526
+
527
+ // Phone, Rows: as in the first example on this page that uses them.
528
+
529
+ const lessons = [
530
+ "Reading a chord chart",
531
+ "Open chords: C, G and D",
532
+ "Strumming in four",
533
+ "Changing chords on the beat",
534
+ "The minor chords: Am, Em, Dm",
535
+ "Fingerpicking the bass note",
536
+ "Barre chords without the ache",
537
+ "Playing with a capo",
538
+ "Slides and hammer-ons",
539
+ "Your first song, start to finish",
540
+ "Keeping time with a metronome",
541
+ "Tuning by ear",
542
+ "Power chords and palm muting",
543
+ "The twelve-bar blues",
544
+ "Your first riff",
545
+ "Bending a note in tune",
546
+ "The pentatonic box",
547
+ "Playing along with a band",
548
+ "Writing a chord progression",
549
+ "Practising without getting bored",
550
+ ];
551
+
552
+ export function HideOnScroll() {
553
+ const [value, setValue] = React.useState("lessons");
554
+ return (
555
+ <Phone
556
+ label="Guitar course screen"
557
+ nav={
558
+ <BottomNav
559
+ position="absolute"
560
+ aria-label="Guitar course"
561
+ hideOnScroll
562
+ value={value}
563
+ onValueChange={setValue}
564
+ >
565
+ <BottomNavItem value="lessons" icon={<BookOpenIcon />} label="Lessons" />
566
+ <BottomNavItem value="schedule" icon={<CalendarDaysIcon />} label="Schedule" />
567
+ <BottomNavItem value="profile" icon={<UserIcon />} label="Profile" />
568
+ </BottomNav>
569
+ }
570
+ >
571
+ <Eyebrow>Beginner guitar</Eyebrow>
572
+ <Heading level={3} className="mt-2">
573
+ Twenty lessons
574
+ </Heading>
575
+ <Text tone="muted" size="sm" className="mt-3">
576
+ Scroll down: the bar slides away. Scroll up a little and it comes back.
577
+ </Text>
578
+ <Rows rows={lessons.map((title, i) => ({ title, meta: `Lesson ${String(i + 1).padStart(2, "0")}` }))} />
579
+ </Phone>
580
+ );
581
+ }
582
+ ```
583
+
584
+ ### In a preview
585
+
586
+ `position="absolute"` pins the bar to its positioned parent — a phone-sized preview or embedded screen. It then shows at every width and sets no `--bottom-nav-h`: pad the scroller with `pb-[calc(var(--bottom-nav-bar)+1px)]` (`+40px` under a capsule).
587
+
588
+ ```tsx
589
+ <div className="relative h-[600px] overflow-hidden">
590
+ <div className="h-full overflow-y-auto pb-[calc(var(--bottom-nav-bar)+1px)]">…</div>
591
+ <BottomNav position="absolute">…</BottomNav>
592
+ </div>
593
+ ```
594
+
595
+ ### With a sidebar
596
+
597
+ Both switch at `md` (48rem): below it the `Sidebar` is a sheet and the bar shows; above, the sidebar is a panel and the bar is gone. `SidebarInset` already reserves `--bottom-nav-h`. Give the bar the four daily places and a last item, "More", that opens the sheet and is current on any of the sheet's places. Put the bar inside `SidebarProvider`.
598
+
599
+ ```tsx
600
+ import { BottomNav, BottomNavItem, Sidebar, SidebarInset, SidebarProvider, useSidebar } from "@zonsh/ui";
601
+
602
+ const daily = ["inbox", "today", "projects", "search"];
603
+
604
+ function MoreItem({ page }: { page: string }) {
605
+ const { openMobile, setOpenMobile } = useSidebar();
606
+ return (
607
+ <BottomNavItem
608
+ icon={<MenuIcon />}
609
+ label="More"
610
+ current={!daily.includes(page)}
611
+ aria-haspopup="dialog"
612
+ aria-expanded={openMobile}
613
+ onClick={() => setOpenMobile(true)}
614
+ />
615
+ );
616
+ }
617
+
618
+ <SidebarProvider>
619
+ <Sidebar aria-label="Workspace">…every place, the four daily ones included…</Sidebar>
620
+ <SidebarInset>…</SidebarInset>
621
+ <BottomNav aria-label="Workspace shortcuts">
622
+ <BottomNavItem href="/inbox" current={page === "inbox"} icon={<InboxIcon />} label="Inbox" />
623
+ {/* … today, projects, search … */}
624
+ <MoreItem page={page} />
625
+ </BottomNav>
626
+ </SidebarProvider>;
627
+ ```
628
+
629
+ Never make "More" the only way to a daily place.
630
+
631
+ ## Props
632
+
633
+ ### BottomNav
634
+
635
+ | Prop | Type | Default | Notes |
636
+ | --------------- | ------------------------------- | ----------------------- | --------------------------------------------------------------------------------------- |
637
+ | `value` | `string` | — | The current item's `value`, for app state. Router-driven bars set `current` per item. |
638
+ | `defaultValue` | `string` | — | The item current at first, uncontrolled. |
639
+ | `onValueChange` | `(value: string) => void` | — | Called with an item's `value` when it is chosen. |
640
+ | `variant` | `"bar" \| "capsule"` | `"bar"` | A full-width bar behind a hairline, or a capsule floating over the page. |
641
+ | `frosted` | `boolean` | `false` | Frosted glass: the page shows through, blurred. For pictures scrolling under it. |
642
+ | `action` | `ReactNode` | — | A `BottomNavAction` beside a capsule. Capsule only. |
643
+ | `position` | `"fixed" \| "absolute"` | `"fixed"` | `absolute` pins it to its positioned parent: previews, embedded screens. |
644
+ | `breakpoint` | `"sm" \| "md" \| "lg" \| false` | `"md"` (fixed), `false` | Hidden at and above this width (40, 48, 64rem). `false` shows it at every width. |
645
+ | `hideOnScroll` | `boolean` | `false` | Slides away while scrolling down, back on the way up, at the top and on focus. |
646
+ | `labels` | `Partial<BottomNavMessages>` | — | `nav` (the landmark's name, "Main"), `count(n)` ("3 new") and `dot` ("New"). |
647
+ | `aria-label` | `string` | `"Main"` | Name the bar for the app ("Reading app") when the page has another navigation landmark. |
648
+ | `ref` | `Ref<HTMLElement>` | — | The `<nav>`. |
649
+
650
+ Every other prop goes to the `<nav>`.
651
+
652
+ ### BottomNavItem
653
+
654
+ | Prop | Type | Default | Notes |
655
+ | ------------ | ------------------- | ------- | ------------------------------------------------------------------------------------------ |
656
+ | `icon` | `ReactNode` | — | A lucide icon, drawn at 22px in a bar and 20px in a capsule. |
657
+ | `label` | `ReactNode` | — | One short word: the item's name, read aloud, not drawn. Required. |
658
+ | `value` | `string` | — | Matched against the bar's `value`; choosing the item reports it. |
659
+ | `current` | `boolean` | — | The current page (`aria-current="page"`). Wins over the bar's `value`. |
660
+ | `badge` | `number \| boolean` | — | A count on the icon, or `true` for a dot. |
661
+ | `badgeLabel` | `string` | — | What is read for the badge, instead of "3 new" or "New". |
662
+ | `disabled` | `boolean` | `false` | Dimmed and inert to the pointer and to Enter, but still focusable and read as unavailable. |
663
+ | `href` | `string` | — | Renders an `<a>`. Without `href` or `render`, a `<button>`. |
664
+ | `render` | `ReactElement` | — | A router link, e.g. `render={<Link to="/notes" />}`. |
665
+ | `ref` | `Ref<HTMLElement>` | — | The rendered `<a>` or `<button>`. |
666
+
667
+ ### BottomNavAction
668
+
669
+ | Prop | Type | Default | Notes |
670
+ | -------- | ------------------ | ------- | ----------------------------------------------- |
671
+ | `icon` | `ReactNode` | — | A lucide icon, drawn at 24px. |
672
+ | `label` | `string` | — | What it does, read aloud: "New note". Required. |
673
+ | `render` | `ReactElement` | — | A router link instead of the `<button>`. |
674
+ | `ref` | `Ref<HTMLElement>` | — | The rendered `<button>` or link. |
675
+
676
+ Every other prop goes to the `<button>`.
677
+
678
+ ## Brand rules
679
+
680
+ - **Do** keep to three to five places with icons people know (a house, a magnifier, a person) and one-word labels. An icon nobody can name belongs in a sidebar, with words.
681
+ - **Do** let the rule or the raised pill mark the current place in the foreground ink, the others muted — never a coloured icon, a filled pill or a heavier stroke.
682
+ - **Do** keep badges to counts and news people act on — unread messages, a basket — in the monochrome primary fill.
683
+ - **Don't** put an action among the items, or more than one beside a capsule; it is the screen's main job, never Settings or Log out.
684
+ - **Don't** add your own fill, shadow or blur: the bar is the page ground behind a hairline, the capsule the menu material, and `frosted` the one glass, only over pictures.
685
+ - **Don't** let content run under it: reserve `--bottom-nav-h`.
686
+
687
+ ## Accessibility
688
+
689
+ - A `<nav>` landmark named "Main" by default; name it for the app with `aria-label` when the page has another navigation landmark.
690
+ - Items are links or buttons in reading order; the current one carries `aria-current="page"`. In a bar the whole cell is the target, at least 58px tall; in a capsule each item is 48 by 46px and the action 58px round.
691
+ - Each item's `label` is its accessible name in visually hidden text; badges are read in words after it ("Inbox, 3 new") and the drawn number is hidden. A `BottomNavAction` is named by its `label`.
692
+ - Focus shows the 2px `--control-focus` outline on the item's tile and around the action. With `hideOnScroll`, focus moving into a hidden bar brings it back.
693
+ - Right to left, the items run from the right and the mark glides the mirrored way.
694
+ - In forced colours the current mark is drawn with a `Highlight` edge.
695
+
696
+ ### Keyboard
697
+
698
+ | Key | What it does |
699
+ | --------------- | ------------------------------------------------------- |
700
+ | Tab / Shift+Tab | Moves to the next or previous item, and to the action |
701
+ | Enter | Follows the focused link, or presses the focused button |
702
+ | Space | Presses the focused button |
703
+
704
+ No arrow keys: each item is its own Tab stop, like links in a nav.
705
+
706
+ ---
707
+
708
+ - Import: `import { BottomNav, BottomNavItem, BottomNavAction } from "@zonsh/ui"`
709
+ - Source: `packages/ui/src/components/bottom-nav.tsx`