@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
@@ -4,21 +4,21 @@ import { Avatar as BaseAvatar } from "@base-ui/react/avatar";
4
4
  import * as React from "react";
5
5
  import { cn, sx } from "../lib/cn.js";
6
6
  const avatarSizes = {
7
- sm: "size-6 text-[9px]",
8
- default: "size-8 text-[11px]",
9
- lg: "size-10 text-[13px]",
7
+ sm: "size-6 text-[max(9px,calc(9px*var(--density)))]",
8
+ default: "size-8 text-11",
9
+ lg: "size-10 text-13",
10
10
  /** A profile page's own picture. */
11
- xl: "size-20 text-[22px]",
11
+ xl: "size-20 text-22",
12
12
  /** A profile picker ("Who's watching?"), where the picture is the button. */
13
- "2xl": "size-32 text-[34px]",
13
+ "2xl": "size-32 text-34",
14
14
  };
15
15
  /** AvatarGroup's `+N`: as tall as the avatars, and as wide as a long count needs ("+1204"). */
16
16
  const countSizes = {
17
- sm: "h-6 min-w-6 px-1 text-[9px]",
18
- default: "h-8 min-w-8 px-1.5 text-[11px]",
19
- lg: "h-10 min-w-10 px-2 text-[13px]",
20
- xl: "h-20 min-w-20 px-4 text-[22px]",
21
- "2xl": "h-32 min-w-32 px-6 text-[34px]",
17
+ sm: "h-6 min-w-6 px-1 text-[max(9px,calc(9px*var(--density)))]",
18
+ default: "h-8 min-w-8 px-1.5 text-11",
19
+ lg: "h-10 min-w-10 px-2 text-13",
20
+ xl: "h-20 min-w-20 px-4 text-22",
21
+ "2xl": "h-32 min-w-32 px-6 text-34",
22
22
  };
23
23
  function initials(name) {
24
24
  if (!name)
@@ -51,5 +51,7 @@ export function AvatarGroup({ max, size = "default", className, children, ...pro
51
51
  const items = React.Children.toArray(children);
52
52
  const shown = max != null ? items.slice(0, max) : items;
53
53
  const rest = items.length - shown.length;
54
- return (_jsxs("div", { "data-slot": "avatar-group", className: cn("flex items-center -space-x-2 *:outline-2 *:outline-background", size === "lg" && "-space-x-2.5", className), ...props, children: [shown, rest > 0 && (_jsxs("span", { "data-slot": "avatar-group-count", className: cn("relative inline-flex shrink-0 items-center justify-center rounded-full font-mono leading-none text-foreground-soft tabular-nums", "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent ring-1 ring-field-edge", countSizes[size]), children: ["+", rest] }))] }));
54
+ return (_jsxs("div", { "data-slot": "avatar-group", className: cn("flex items-center -space-x-2 *:outline-2 *:outline-background",
55
+ // A third of a small avatar would hide its second initial: they overlap less.
56
+ size === "sm" && "-space-x-1", size === "lg" && "-space-x-2.5", className), ...props, children: [shown, rest > 0 && (_jsxs("span", { "data-slot": "avatar-group-count", className: cn("relative inline-flex shrink-0 items-center justify-center rounded-full font-mono leading-none text-foreground-soft tabular-nums", "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent ring-1 ring-field-edge", countSizes[size]), children: ["+", rest] }))] }));
55
57
  }
@@ -1,28 +1,28 @@
1
1
  import type * as React from "react";
2
+ import type { StatusTone } from "../lib/tone.js";
2
3
  declare const badgeVariants: {
3
4
  /** The primary fill: dark in light mode, light in dark mode. Counts that need attention. */
4
5
  readonly default: "bg-(--primary-fill) text-(--primary-text) shadow-checked";
5
6
  /** The raised key surface with foreground ink. Quiet counts and "New" markers. */
6
7
  readonly secondary: "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent text-foreground shadow-key";
7
- /** Status only: done, connected, online. Never decoration. */
8
- readonly success: "bg-success text-background shadow-checked";
9
- /** Status only: away, expiring, a count of things that need attention soon. Never decoration. */
10
- readonly warning: "bg-warning text-background shadow-checked";
11
- /** Status only: new, syncing, an unread count of neutral news. Never decoration. */
12
- readonly info: "bg-info text-background shadow-checked";
13
- /** Status only: failed, offline, an error count. Never decoration. */
14
- readonly destructive: "bg-destructive text-background shadow-checked";
15
8
  };
16
9
  declare const badgeSizes: {
17
10
  /** 16px — on 30px controls, 24px avatars and inline in dense rows. */
18
- readonly sm: "h-4 min-w-4 px-1 text-[10px]";
11
+ readonly sm: "h-[max(var(--badge-h-sm),1.5em)] min-w-[max(var(--badge-h-sm),1.5em)] px-1 text-[10px]";
19
12
  /** 20px — on 36–46px controls and 32–40px avatars. */
20
- readonly default: "h-5 min-w-5 px-1.5 text-[11px]";
13
+ readonly default: "h-[max(var(--badge-h),1.5em)] min-w-[max(var(--badge-h),1.5em)] px-1.5 text-11";
21
14
  };
15
+ /** The look: `default` (the primary fill) or `secondary` (the raised key). A status colour is `tone`. */
22
16
  export type BadgeVariant = keyof typeof badgeVariants;
23
17
  export type BadgeSize = keyof typeof badgeSizes;
24
18
  export interface BadgeProps extends React.ComponentProps<"span"> {
19
+ /**
20
+ * `default`: the primary fill, for counts that need attention. `secondary`: the raised key, for
21
+ * quiet counts and "New".
22
+ */
25
23
  variant?: BadgeVariant;
24
+ /** A status colour in place of the look: `success`, `warning`, `info`, `destructive`. Status only. */
25
+ tone?: StatusTone;
26
26
  /** `sm` 16px (dot 8px) · `default` 20px (dot 10px). */
27
27
  size?: BadgeSize;
28
28
  /**
@@ -43,14 +43,14 @@ export interface BadgeProps extends React.ComponentProps<"span"> {
43
43
  /**
44
44
  * Badge — a small count or status mark: a notification count on an icon button or avatar,
45
45
  * a "New" marker beside a nav item, or a status dot. Mono, tabular numerals; 16 or 20px tall,
46
- * fully round. Monochrome by default; `success`, `warning`, `info` and `destructive` are status only.
46
+ * fully round. Monochrome by default; `tone` (`success`, `warning`, `info`, `destructive`) is status only.
47
47
  *
48
48
  * Wrap the thing it marks in `BadgeAnchor` to pin it to the corner. Not the same as `Tag`:
49
49
  * a tag is metadata that names something ("TypeScript", "Draft"); a badge counts or flags
50
50
  * something about the object it sits on. The rule people break: colour as decoration — a
51
51
  * green "New" or a red count that is not an error.
52
52
  */
53
- export declare function Badge({ variant, size, count, max, dot, label, className, children, ...props }: BadgeProps): React.JSX.Element | null;
53
+ export declare function Badge({ variant, tone, size, count, max, dot, label, className, children, ...props }: BadgeProps): React.JSX.Element | null;
54
54
  export interface BadgeAnchorProps extends React.ComponentProps<"span"> {
55
55
  /**
56
56
  * The outline of what is marked. `circle` (default) for avatars and icon buttons: the badge
@@ -6,6 +6,8 @@ const badgeVariants = {
6
6
  default: "bg-(--primary-fill) text-(--primary-text) shadow-checked",
7
7
  /** The raised key surface with foreground ink. Quiet counts and "New" markers. */
8
8
  secondary: "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent text-foreground shadow-key",
9
+ };
10
+ const badgeTones = {
9
11
  /** Status only: done, connected, online. Never decoration. */
10
12
  success: "bg-success text-background shadow-checked",
11
13
  /** Status only: away, expiring, a count of things that need attention soon. Never decoration. */
@@ -17,9 +19,9 @@ const badgeVariants = {
17
19
  };
18
20
  const badgeSizes = {
19
21
  /** 16px — on 30px controls, 24px avatars and inline in dense rows. */
20
- sm: "h-4 min-w-4 px-1 text-[10px]",
22
+ sm: "h-[max(var(--badge-h-sm),1.5em)] min-w-[max(var(--badge-h-sm),1.5em)] px-1 text-[10px]",
21
23
  /** 20px — on 36–46px controls and 32–40px avatars. */
22
- default: "h-5 min-w-5 px-1.5 text-[11px]",
24
+ default: "h-[max(var(--badge-h),1.5em)] min-w-[max(var(--badge-h),1.5em)] px-1.5 text-11",
23
25
  };
24
26
  const dotSizes = {
25
27
  sm: "size-2",
@@ -28,19 +30,19 @@ const dotSizes = {
28
30
  /**
29
31
  * Badge — a small count or status mark: a notification count on an icon button or avatar,
30
32
  * a "New" marker beside a nav item, or a status dot. Mono, tabular numerals; 16 or 20px tall,
31
- * fully round. Monochrome by default; `success`, `warning`, `info` and `destructive` are status only.
33
+ * fully round. Monochrome by default; `tone` (`success`, `warning`, `info`, `destructive`) is status only.
32
34
  *
33
35
  * Wrap the thing it marks in `BadgeAnchor` to pin it to the corner. Not the same as `Tag`:
34
36
  * a tag is metadata that names something ("TypeScript", "Draft"); a badge counts or flags
35
37
  * something about the object it sits on. The rule people break: colour as decoration — a
36
38
  * green "New" or a red count that is not an error.
37
39
  */
38
- export function Badge({ variant = "default", size = "default", count, max = 99, dot = false, label, className, children, ...props }) {
40
+ export function Badge({ variant = "default", tone, size = "default", count, max = 99, dot = false, label, className, children, ...props }) {
39
41
  // Not above zero — or not a number yet (NaN while a count loads) — renders nothing.
40
42
  if (count !== undefined && !(count > 0) && !dot)
41
43
  return null;
42
44
  const content = count !== undefined ? (count > max ? `${max}+` : String(count)) : children;
43
- return (_jsxs("span", { "data-slot": "badge", "data-variant": variant, "data-size": size, "data-dot": dot || undefined, className: cn("inline-flex shrink-0 items-center justify-center rounded-full leading-none whitespace-nowrap select-none", badgeVariants[variant], dot
45
+ return (_jsxs("span", { "data-slot": "badge", "data-variant": variant, "data-tone": tone, "data-size": size, "data-dot": dot || undefined, className: cn("inline-flex shrink-0 items-center justify-center rounded-full leading-none whitespace-nowrap select-none", tone ? badgeTones[tone] : badgeVariants[variant], dot
44
46
  ? dotSizes[size]
45
47
  : [
46
48
  "font-mono font-medium tracking-[0.02em] tabular-nums",
@@ -9,10 +9,15 @@ export interface BottomNavMessages {
9
9
  dot: string;
10
10
  }
11
11
  declare module "./locale" {
12
- interface Messages {
12
+ interface LocaleMessages {
13
13
  bottomNav: BottomNavMessages;
14
14
  }
15
15
  }
16
+ /**
17
+ * `bar`: full width on the page ground behind a hairline, a short rule over the current icon.
18
+ * `capsule`: a rounded capsule floating over the page, the current icon on a raised pill.
19
+ */
20
+ export type BottomNavVariant = "bar" | "capsule";
16
21
  /** At and above this width the bar is hidden: `sm` 40rem, `md` 48rem, `lg` 64rem. */
17
22
  export type BottomNavBreakpoint = "sm" | "md" | "lg";
18
23
  export interface BottomNavProps extends Omit<React.ComponentProps<"nav">, "defaultValue" | "onChange"> {
@@ -22,6 +27,22 @@ export interface BottomNavProps extends Omit<React.ComponentProps<"nav">, "defau
22
27
  defaultValue?: string;
23
28
  /** Called with an item's `value` when it is chosen. */
24
29
  onValueChange?: (value: string) => void;
30
+ /**
31
+ * `bar` (default): full width on the page ground behind a hairline, a short rule on the edge over
32
+ * the current icon. `capsule`: a rounded capsule floating over the page, its items hugged
33
+ * together, the current one on a raised pill that glides.
34
+ */
35
+ variant?: BottomNavVariant;
36
+ /**
37
+ * Frosted glass instead of an opaque surface: the page shows through, blurred and a little lit.
38
+ * For a page of pictures or colour scrolling under the bar; on plain pages leave it off.
39
+ */
40
+ frosted?: boolean;
41
+ /**
42
+ * The capsule's one action, beside it: a `BottomNavAction` ("New note"). The capsule then takes
43
+ * the width that is left. Capsule only; a bar has no action.
44
+ */
45
+ action?: React.ReactNode;
25
46
  /**
26
47
  * `fixed` (default): pinned to the bottom of the viewport, and the page reserves its height
27
48
  * through `--bottom-nav-h`. `absolute`: pinned to the bottom of its positioned parent — a
@@ -44,10 +65,12 @@ export interface BottomNavProps extends Omit<React.ComponentProps<"nav">, "defau
44
65
  ref?: React.Ref<HTMLElement>;
45
66
  }
46
67
  /**
47
- * BottomNav — the bar of destinations at the bottom of a phone screen: 3–5 items, each an icon
48
- * over a short Licht Sans label, on the page ground behind a hairline. The current item is in the
49
- * foreground ink on a raised 12px tile that glides to the next one; the others rest muted. It
50
- * clears the home indicator (`env(safe-area-inset-bottom)`), and while it is shown the page
68
+ * BottomNav — the bar of destinations at the bottom of a phone screen: 3–5 items, each an icon,
69
+ * its label read aloud. As a `bar` it is the page ground behind a hairline, a 2px rule on the edge
70
+ * over the current icon; as a `capsule` it floats over the page, the current icon on a raised pill,
71
+ * optionally beside one round primary `action`. Either can be `frosted`. The current item is in the
72
+ * foreground ink and its mark glides to the next one; the others rest muted. It clears the home
73
+ * indicator (`env(safe-area-inset-bottom)`), and while it is shown the page
51
74
  * reserves its height as `--bottom-nav-h` — put `pb-(--bottom-nav-h)` on the content's container.
52
75
  * Hidden from `md` up by default, where a `Sidebar` or `SiteHeader` takes over.
53
76
  *
@@ -55,11 +78,14 @@ export interface BottomNavProps extends Omit<React.ComponentProps<"nav">, "defau
55
78
  * The rule people break: putting actions (Compose, Log out) or more than five destinations in
56
79
  * it — an action is a `Button`, and a sixth place belongs in a sidebar sheet or an account menu.
57
80
  */
58
- export declare function BottomNav({ value: valueProp, defaultValue, onValueChange, position, breakpoint, hideOnScroll, labels, className, children, ref, onFocus, ...props }: BottomNavProps): React.JSX.Element;
81
+ export declare function BottomNav({ value: valueProp, defaultValue, onValueChange, variant, frosted, action, position, breakpoint, hideOnScroll, labels, className, children, ref, onFocus, ...props }: BottomNavProps): React.JSX.Element;
59
82
  export interface BottomNavItemProps extends Omit<useRender.ComponentProps<"a">, "children"> {
60
- /** A 20px lucide icon over the label. */
83
+ /** A lucide icon: 22px in a bar, 20px in a capsule. The item shows the icon alone. */
61
84
  icon: React.ReactNode;
62
- /** One short word ("Home", "Search", "Orders"). Always shown: the bar is never icon-only. */
85
+ /**
86
+ * One short word ("Home", "Search", "Orders"): the item's name, read aloud, never drawn. Required,
87
+ * since an icon alone names nothing to a screen reader.
88
+ */
63
89
  label: React.ReactNode;
64
90
  /** The item's value, for `BottomNav value`. Choosing the item reports it to `onValueChange`. */
65
91
  value?: string;
@@ -79,8 +105,24 @@ export interface BottomNavItemProps extends Omit<useRender.ComponentProps<"a">,
79
105
  disabled?: boolean;
80
106
  }
81
107
  /**
82
- * BottomNavItem — one destination: an icon over a label, at least 44px to touch (the whole cell
83
- * of the bar). Renders an `<a>` with `href`, `render={<Link to="…" />}` for a router link, or a
84
- * `<button>` for app state with neither. Never icon-only, and never an action.
108
+ * BottomNavItem — one destination: its icon, named by its label for screen readers, at least 44px
109
+ * to touch (in a bar the whole cell). Renders an `<a>` with `href`, `render={<Link to="…" />}` for
110
+ * a router link, or a `<button>` for app state with neither. Never an action: that is
111
+ * `BottomNavAction`, beside a capsule.
85
112
  */
86
113
  export declare function BottomNavItem({ icon, label, value, current: currentProp, badge, badgeLabel, disabled, render, ref, className, onClick, ...props }: BottomNavItemProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;
114
+ export interface BottomNavActionProps extends Omit<useRender.ComponentProps<"button">, "children"> {
115
+ /** A lucide icon, drawn at 24px: a plus, a pen. */
116
+ icon: React.ReactNode;
117
+ /** What it does, read aloud: "New note", "Add photo". */
118
+ label: string;
119
+ }
120
+ /**
121
+ * BottomNavAction — the one thing people make, as a round primary beside a capsule BottomNav: as
122
+ * tall as the capsule, the primary's material, its icon alone, named by `label`. Pass it to the
123
+ * capsule's `action`. Renders a `<button>`, or the element in `render` (a router link).
124
+ *
125
+ * The rule people break: a second action, or one that is not the screen's main job. Rare actions
126
+ * go in a menu on the page.
127
+ */
128
+ export declare function BottomNavAction({ icon, label, render, ref, className, ...props }: BottomNavActionProps): React.ReactElement<unknown, string | React.JSXElementConstructor<any>>;