@zonsh/ui 0.5.0 → 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 (559) 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 +6 -6
  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/audio-player.d.ts +134 -0
  35. package/dist/components/audio-player.js +618 -0
  36. package/dist/components/avatar.d.ts +6 -6
  37. package/dist/components/avatar.js +13 -11
  38. package/dist/components/badge.d.ts +12 -12
  39. package/dist/components/badge.js +7 -5
  40. package/dist/components/bottom-nav.d.ts +53 -11
  41. package/dist/components/bottom-nav.js +388 -23
  42. package/dist/components/breadcrumb.d.ts +11 -2
  43. package/dist/components/breadcrumb.js +60 -6
  44. package/dist/components/button-group.js +5 -1
  45. package/dist/components/button.d.ts +23 -6
  46. package/dist/components/button.js +63 -7
  47. package/dist/components/calendar.js +8 -6
  48. package/dist/components/card.d.ts +10 -8
  49. package/dist/components/card.js +15 -14
  50. package/dist/components/carousel.d.ts +2 -2
  51. package/dist/components/carousel.js +21 -8
  52. package/dist/components/chart.d.ts +27 -1
  53. package/dist/components/chart.js +15 -5
  54. package/dist/components/checkbox.js +2 -2
  55. package/dist/components/code-block.d.ts +9 -2
  56. package/dist/components/code-block.js +26 -7
  57. package/dist/components/collapsible.js +3 -3
  58. package/dist/components/color-picker.d.ts +2 -2
  59. package/dist/components/color-picker.js +5 -5
  60. package/dist/components/combobox.d.ts +26 -7
  61. package/dist/components/combobox.js +32 -13
  62. package/dist/components/command.d.ts +29 -5
  63. package/dist/components/command.js +35 -10
  64. package/dist/components/context-menu.d.ts +5 -2
  65. package/dist/components/context-menu.js +24 -3
  66. package/dist/components/conversation.d.ts +1 -1
  67. package/dist/components/conversation.js +67 -13
  68. package/dist/components/copy-button.d.ts +1 -1
  69. package/dist/components/copy-button.js +1 -1
  70. package/dist/components/data-table.d.ts +6 -6
  71. package/dist/components/data-table.js +41 -15
  72. package/dist/components/date-picker.d.ts +31 -9
  73. package/dist/components/date-picker.js +100 -18
  74. package/dist/components/dialog.d.ts +17 -10
  75. package/dist/components/dialog.js +20 -13
  76. package/dist/components/drawer.d.ts +26 -8
  77. package/dist/components/drawer.js +75 -16
  78. package/dist/components/drawing.d.ts +25 -0
  79. package/dist/components/drawing.js +32 -0
  80. package/dist/components/empty.js +2 -2
  81. package/dist/components/feature-list.d.ts +65 -13
  82. package/dist/components/feature-list.js +116 -15
  83. package/dist/components/field.js +2 -2
  84. package/dist/components/file-drop.d.ts +9 -7
  85. package/dist/components/file-drop.js +8 -43
  86. package/dist/components/filter-bar.d.ts +10 -9
  87. package/dist/components/filter-bar.js +42 -25
  88. package/dist/components/graph.d.ts +19 -3
  89. package/dist/components/graph.js +170 -25
  90. package/dist/components/illustration.js +3 -28
  91. package/dist/components/input-group.d.ts +5 -10
  92. package/dist/components/input-group.js +16 -16
  93. package/dist/components/input.d.ts +2 -2
  94. package/dist/components/input.js +3 -3
  95. package/dist/components/item.d.ts +9 -6
  96. package/dist/components/item.js +13 -8
  97. package/dist/components/kbd.d.ts +1 -1
  98. package/dist/components/kbd.js +1 -1
  99. package/dist/components/lightbox.d.ts +76 -9
  100. package/dist/components/lightbox.js +333 -45
  101. package/dist/components/locale.d.ts +6 -6
  102. package/dist/components/logo.d.ts +21 -1
  103. package/dist/components/logo.js +32 -2
  104. package/dist/components/markdown-editor.d.ts +275 -0
  105. package/dist/components/markdown-editor.js +831 -0
  106. package/dist/components/mentions.d.ts +153 -0
  107. package/dist/components/mentions.js +507 -0
  108. package/dist/components/menu.d.ts +2 -1
  109. package/dist/components/menu.js +5 -4
  110. package/dist/components/menubar.d.ts +23 -5
  111. package/dist/components/menubar.js +97 -22
  112. package/dist/components/message.d.ts +62 -11
  113. package/dist/components/message.js +49 -13
  114. package/dist/components/meter.js +1 -1
  115. package/dist/components/money-input.d.ts +1 -1
  116. package/dist/components/money-input.js +1 -1
  117. package/dist/components/native-select.d.ts +2 -2
  118. package/dist/components/native-select.js +4 -4
  119. package/dist/components/navigation-menu.d.ts +3 -1
  120. package/dist/components/navigation-menu.js +23 -12
  121. package/dist/components/number-field.d.ts +2 -9
  122. package/dist/components/number-field.js +86 -36
  123. package/dist/components/number-roll.d.ts +26 -0
  124. package/dist/components/number-roll.js +81 -0
  125. package/dist/components/otp-field.d.ts +1 -1
  126. package/dist/components/otp-field.js +24 -3
  127. package/dist/components/pagination.d.ts +11 -3
  128. package/dist/components/pagination.js +59 -13
  129. package/dist/components/pdf-viewer.d.ts +1 -1
  130. package/dist/components/pdf-viewer.js +8 -8
  131. package/dist/components/phone-input.d.ts +1 -1
  132. package/dist/components/phone-input.js +2 -2
  133. package/dist/components/popover.js +5 -3
  134. package/dist/components/preview-card.d.ts +37 -2
  135. package/dist/components/preview-card.js +226 -2
  136. package/dist/components/progress.js +1 -1
  137. package/dist/components/prompt-input.d.ts +1 -1
  138. package/dist/components/prompt-input.js +24 -14
  139. package/dist/components/pull-to-refresh.d.ts +50 -0
  140. package/dist/components/pull-to-refresh.js +189 -0
  141. package/dist/components/quote.d.ts +6 -1
  142. package/dist/components/quote.js +3 -2
  143. package/dist/components/radio-group.js +1 -1
  144. package/dist/components/rating.d.ts +4 -1
  145. package/dist/components/rating.js +131 -10
  146. package/dist/components/reasoning.d.ts +1 -1
  147. package/dist/components/reasoning.js +7 -3
  148. package/dist/components/resizable.d.ts +1 -1
  149. package/dist/components/resizable.js +2 -2
  150. package/dist/components/response.d.ts +1 -1
  151. package/dist/components/response.js +18 -6
  152. package/dist/components/scheduler.d.ts +352 -0
  153. package/dist/components/scheduler.js +1717 -0
  154. package/dist/components/scroll-area.js +1 -1
  155. package/dist/components/select.d.ts +17 -4
  156. package/dist/components/select.js +140 -9
  157. package/dist/components/separator.d.ts +1 -1
  158. package/dist/components/separator.js +3 -3
  159. package/dist/components/sidebar.d.ts +44 -3
  160. package/dist/components/sidebar.js +57 -17
  161. package/dist/components/site-header.d.ts +18 -13
  162. package/dist/components/site-header.js +23 -11
  163. package/dist/components/skeleton.d.ts +17 -7
  164. package/dist/components/skeleton.js +22 -7
  165. package/dist/components/slider.js +2 -2
  166. package/dist/components/sortable.d.ts +55 -4
  167. package/dist/components/sortable.js +172 -103
  168. package/dist/components/sources.d.ts +1 -1
  169. package/dist/components/sources.js +2 -2
  170. package/dist/components/spinner.d.ts +4 -4
  171. package/dist/components/spinner.js +4 -4
  172. package/dist/components/stat.d.ts +21 -4
  173. package/dist/components/stat.js +17 -8
  174. package/dist/components/stepper.d.ts +1 -1
  175. package/dist/components/stepper.js +8 -7
  176. package/dist/components/suggestions.d.ts +11 -3
  177. package/dist/components/suggestions.js +10 -4
  178. package/dist/components/swipe-actions.d.ts +66 -0
  179. package/dist/components/swipe-actions.js +292 -0
  180. package/dist/components/switch.js +1 -1
  181. package/dist/components/table.d.ts +12 -6
  182. package/dist/components/table.js +78 -30
  183. package/dist/components/tabs.js +7 -4
  184. package/dist/components/tag.d.ts +19 -20
  185. package/dist/components/tag.js +9 -5
  186. package/dist/components/tags-input.d.ts +2 -7
  187. package/dist/components/tags-input.js +11 -8
  188. package/dist/components/textarea.d.ts +3 -2
  189. package/dist/components/textarea.js +4 -3
  190. package/dist/components/theme.d.ts +49 -6
  191. package/dist/components/theme.js +147 -9
  192. package/dist/components/time-field.d.ts +4 -9
  193. package/dist/components/time-field.js +6 -6
  194. package/dist/components/timeline.d.ts +19 -3
  195. package/dist/components/timeline.js +21 -9
  196. package/dist/components/tippy.d.ts +17 -1
  197. package/dist/components/tippy.js +95 -15
  198. package/dist/components/toast.d.ts +2 -7
  199. package/dist/components/toast.js +12 -8
  200. package/dist/components/toggle-group.d.ts +7 -1
  201. package/dist/components/toggle-group.js +16 -5
  202. package/dist/components/toggle.d.ts +2 -2
  203. package/dist/components/toggle.js +3 -2
  204. package/dist/components/tool-call.d.ts +1 -1
  205. package/dist/components/tool-call.js +4 -4
  206. package/dist/components/toolbar.d.ts +57 -4
  207. package/dist/components/toolbar.js +216 -16
  208. package/dist/components/tooltip.d.ts +1 -1
  209. package/dist/components/tooltip.js +4 -2
  210. package/dist/components/tour.d.ts +1 -1
  211. package/dist/components/tour.js +36 -15
  212. package/dist/components/tree.js +5 -5
  213. package/dist/components/typography.d.ts +31 -8
  214. package/dist/components/typography.js +21 -10
  215. package/dist/components/video-player.d.ts +7 -2
  216. package/dist/components/video-player.js +121 -220
  217. package/dist/index.d.ts +99 -92
  218. package/dist/index.js +99 -92
  219. package/dist/lib/calendar.d.ts +153 -0
  220. package/dist/lib/calendar.js +312 -0
  221. package/dist/lib/cn.d.ts +3 -1
  222. package/dist/lib/cn.js +5 -0
  223. package/dist/lib/code-highlight.d.ts +14 -0
  224. package/dist/lib/code-highlight.js +81 -18
  225. package/dist/lib/drag.d.ts +39 -0
  226. package/dist/lib/drag.js +96 -0
  227. package/dist/lib/editorial-assets.js +16 -8
  228. package/dist/lib/figure/figures/automation.js +25 -6
  229. package/dist/lib/figure/figures/bar-chart.js +6 -1
  230. package/dist/lib/figure/figures/brackets-classic.js +4 -1
  231. package/dist/lib/figure/figures/city.js +12 -2
  232. package/dist/lib/figure/figures/conveyor.js +17 -4
  233. package/dist/lib/figure/figures/database.js +5 -2
  234. package/dist/lib/figure/figures/documents.js +11 -3
  235. package/dist/lib/figure/figures/inbox.js +5 -2
  236. package/dist/lib/figure/figures/laptop.js +3 -1
  237. package/dist/lib/figure/figures/pipeline.js +45 -10
  238. package/dist/lib/figure/figures/platform.js +62 -7
  239. package/dist/lib/figure/figures/server.js +21 -5
  240. package/dist/lib/figure/figures/spreadsheet.js +29 -5
  241. package/dist/lib/figure/kernel.d.ts +4 -2
  242. package/dist/lib/figure/kernel.js +10 -5
  243. package/dist/lib/figure/parts.js +6 -2
  244. package/dist/lib/files.d.ts +31 -0
  245. package/dist/lib/files.js +60 -0
  246. package/dist/lib/gesture.d.ts +70 -0
  247. package/dist/lib/gesture.js +141 -0
  248. package/dist/lib/glide.d.ts +5 -0
  249. package/dist/lib/glide.js +9 -1
  250. package/dist/lib/icons.d.ts +1 -0
  251. package/dist/lib/icons.js +6 -0
  252. package/dist/lib/illustration-library.js +1 -6
  253. package/dist/lib/markdown-edit.d.ts +112 -0
  254. package/dist/lib/markdown-edit.js +557 -0
  255. package/dist/lib/markdown-rich-editor.d.ts +188 -0
  256. package/dist/lib/markdown-rich-editor.js +1153 -0
  257. package/dist/lib/markdown-rich.d.ts +63 -0
  258. package/dist/lib/markdown-rich.js +534 -0
  259. package/dist/lib/mentions.d.ts +100 -0
  260. package/dist/lib/mentions.js +246 -0
  261. package/dist/lib/motion.d.ts +18 -0
  262. package/dist/lib/motion.js +43 -5
  263. package/dist/lib/number-roll.d.ts +89 -0
  264. package/dist/lib/number-roll.js +391 -0
  265. package/dist/lib/platform.d.ts +6 -0
  266. package/dist/lib/platform.js +14 -0
  267. package/dist/lib/portal-container.d.ts +9 -0
  268. package/dist/lib/portal-container.js +10 -0
  269. package/dist/lib/press.d.ts +5 -0
  270. package/dist/lib/press.js +186 -0
  271. package/dist/lib/scheduler.d.ts +128 -0
  272. package/dist/lib/scheduler.js +272 -0
  273. package/dist/lib/scroll-edges.d.ts +9 -0
  274. package/dist/lib/scroll-edges.js +50 -0
  275. package/dist/lib/table-fit.d.ts +1 -1
  276. package/dist/lib/table-fit.js +65 -8
  277. package/dist/lib/theme-preset.d.ts +267 -0
  278. package/dist/lib/theme-preset.js +1046 -0
  279. package/dist/lib/theme-script.d.ts +23 -3
  280. package/dist/lib/theme-script.js +17 -5
  281. package/dist/lib/tippy/sprite.d.ts +36 -4
  282. package/dist/lib/tippy/sprite.js +188 -15
  283. package/dist/lib/tone.d.ts +4 -0
  284. package/dist/lib/tone.js +1 -0
  285. package/dist/messages/de.d.ts +3 -3
  286. package/dist/messages/de.js +274 -3
  287. package/dist/skills/zon-ui/SKILL.md +279 -0
  288. package/dist/skills/zon-ui/references/authoring.md +265 -0
  289. package/dist/skills/zon-ui/references/brand.md +416 -0
  290. package/dist/skills/zon-ui/references/components/accordion.md +199 -0
  291. package/dist/skills/zon-ui/references/components/action-sheet.md +268 -0
  292. package/dist/skills/zon-ui/references/components/alert-dialog.md +276 -0
  293. package/dist/skills/zon-ui/references/components/alert.md +167 -0
  294. package/dist/skills/zon-ui/references/components/app-bar.md +307 -0
  295. package/dist/skills/zon-ui/references/components/ascii-field.md +121 -0
  296. package/dist/skills/zon-ui/references/components/aspect-ratio.md +112 -0
  297. package/dist/skills/zon-ui/references/components/audio-player.md +231 -0
  298. package/dist/skills/zon-ui/references/components/avatar.md +98 -0
  299. package/dist/skills/zon-ui/references/components/badge.md +227 -0
  300. package/dist/skills/zon-ui/references/components/bottom-nav.md +709 -0
  301. package/dist/skills/zon-ui/references/components/breadcrumb.md +143 -0
  302. package/dist/skills/zon-ui/references/components/button-group.md +216 -0
  303. package/dist/skills/zon-ui/references/components/button.md +309 -0
  304. package/dist/skills/zon-ui/references/components/calendar.md +296 -0
  305. package/dist/skills/zon-ui/references/components/card.md +158 -0
  306. package/dist/skills/zon-ui/references/components/carousel.md +297 -0
  307. package/dist/skills/zon-ui/references/components/chart.md +739 -0
  308. package/dist/skills/zon-ui/references/components/chat.md +417 -0
  309. package/dist/skills/zon-ui/references/components/checkbox.md +219 -0
  310. package/dist/skills/zon-ui/references/components/code-block.md +143 -0
  311. package/dist/skills/zon-ui/references/components/code-highlight.md +118 -0
  312. package/dist/skills/zon-ui/references/components/collapsible.md +146 -0
  313. package/dist/skills/zon-ui/references/components/color-picker.md +200 -0
  314. package/dist/skills/zon-ui/references/components/combobox.md +455 -0
  315. package/dist/skills/zon-ui/references/components/command.md +326 -0
  316. package/dist/skills/zon-ui/references/components/contact-form.md +562 -0
  317. package/dist/skills/zon-ui/references/components/context-menu.md +159 -0
  318. package/dist/skills/zon-ui/references/components/conversation.md +146 -0
  319. package/dist/skills/zon-ui/references/components/copy-button.md +162 -0
  320. package/dist/skills/zon-ui/references/components/crm.md +1022 -0
  321. package/dist/skills/zon-ui/references/components/dashboard.md +612 -0
  322. package/dist/skills/zon-ui/references/components/data-table.md +776 -0
  323. package/dist/skills/zon-ui/references/components/date-picker.md +444 -0
  324. package/dist/skills/zon-ui/references/components/dialog.md +335 -0
  325. package/dist/skills/zon-ui/references/components/direction.md +165 -0
  326. package/dist/skills/zon-ui/references/components/drawer.md +276 -0
  327. package/dist/skills/zon-ui/references/components/drawing.md +94 -0
  328. package/dist/skills/zon-ui/references/components/empty.md +225 -0
  329. package/dist/skills/zon-ui/references/components/feature-list.md +412 -0
  330. package/dist/skills/zon-ui/references/components/field.md +209 -0
  331. package/dist/skills/zon-ui/references/components/file-drop.md +234 -0
  332. package/dist/skills/zon-ui/references/components/filter-bar.md +485 -0
  333. package/dist/skills/zon-ui/references/components/form.md +970 -0
  334. package/dist/skills/zon-ui/references/components/graph.md +339 -0
  335. package/dist/skills/zon-ui/references/components/illustration.md +497 -0
  336. package/dist/skills/zon-ui/references/components/inbox.md +263 -0
  337. package/dist/skills/zon-ui/references/components/input-group.md +339 -0
  338. package/dist/skills/zon-ui/references/components/input.md +189 -0
  339. package/dist/skills/zon-ui/references/components/item.md +277 -0
  340. package/dist/skills/zon-ui/references/components/kanban.md +626 -0
  341. package/dist/skills/zon-ui/references/components/kbd.md +116 -0
  342. package/dist/skills/zon-ui/references/components/label.md +104 -0
  343. package/dist/skills/zon-ui/references/components/layout.md +291 -0
  344. package/dist/skills/zon-ui/references/components/lightbox.md +235 -0
  345. package/dist/skills/zon-ui/references/components/locale.md +279 -0
  346. package/dist/skills/zon-ui/references/components/logo.md +257 -0
  347. package/dist/skills/zon-ui/references/components/markdown-editor.md +558 -0
  348. package/dist/skills/zon-ui/references/components/mentions.md +512 -0
  349. package/dist/skills/zon-ui/references/components/menu.md +218 -0
  350. package/dist/skills/zon-ui/references/components/menubar.md +292 -0
  351. package/dist/skills/zon-ui/references/components/message.md +243 -0
  352. package/dist/skills/zon-ui/references/components/meter.md +105 -0
  353. package/dist/skills/zon-ui/references/components/money-input.md +333 -0
  354. package/dist/skills/zon-ui/references/components/native-select.md +197 -0
  355. package/dist/skills/zon-ui/references/components/navigation-menu.md +253 -0
  356. package/dist/skills/zon-ui/references/components/number-field.md +210 -0
  357. package/dist/skills/zon-ui/references/components/number-roll.md +175 -0
  358. package/dist/skills/zon-ui/references/components/onboarding.md +896 -0
  359. package/dist/skills/zon-ui/references/components/otp-field.md +166 -0
  360. package/dist/skills/zon-ui/references/components/pagination.md +109 -0
  361. package/dist/skills/zon-ui/references/components/pdf-viewer.md +177 -0
  362. package/dist/skills/zon-ui/references/components/phone-input.md +252 -0
  363. package/dist/skills/zon-ui/references/components/popover.md +176 -0
  364. package/dist/skills/zon-ui/references/components/preview-card.md +193 -0
  365. package/dist/skills/zon-ui/references/components/pricing.md +724 -0
  366. package/dist/skills/zon-ui/references/components/progress.md +92 -0
  367. package/dist/skills/zon-ui/references/components/prompt-input.md +307 -0
  368. package/dist/skills/zon-ui/references/components/pull-to-refresh.md +188 -0
  369. package/dist/skills/zon-ui/references/components/quote.md +115 -0
  370. package/dist/skills/zon-ui/references/components/radio-group.md +215 -0
  371. package/dist/skills/zon-ui/references/components/rating.md +260 -0
  372. package/dist/skills/zon-ui/references/components/reasoning.md +102 -0
  373. package/dist/skills/zon-ui/references/components/resizable.md +213 -0
  374. package/dist/skills/zon-ui/references/components/response.md +170 -0
  375. package/dist/skills/zon-ui/references/components/scheduler.md +732 -0
  376. package/dist/skills/zon-ui/references/components/scroll-area.md +122 -0
  377. package/dist/skills/zon-ui/references/components/select.md +351 -0
  378. package/dist/skills/zon-ui/references/components/separator.md +103 -0
  379. package/dist/skills/zon-ui/references/components/settings.md +793 -0
  380. package/dist/skills/zon-ui/references/components/shop.md +1715 -0
  381. package/dist/skills/zon-ui/references/components/sidebar.md +813 -0
  382. package/dist/skills/zon-ui/references/components/sign-in.md +1639 -0
  383. package/dist/skills/zon-ui/references/components/site-header.md +303 -0
  384. package/dist/skills/zon-ui/references/components/skeleton.md +256 -0
  385. package/dist/skills/zon-ui/references/components/slider.md +172 -0
  386. package/dist/skills/zon-ui/references/components/sortable.md +405 -0
  387. package/dist/skills/zon-ui/references/components/sources.md +106 -0
  388. package/dist/skills/zon-ui/references/components/spinner.md +222 -0
  389. package/dist/skills/zon-ui/references/components/stat.md +267 -0
  390. package/dist/skills/zon-ui/references/components/stepper.md +285 -0
  391. package/dist/skills/zon-ui/references/components/suggestions.md +146 -0
  392. package/dist/skills/zon-ui/references/components/swipe-actions.md +344 -0
  393. package/dist/skills/zon-ui/references/components/switch.md +160 -0
  394. package/dist/skills/zon-ui/references/components/table.md +999 -0
  395. package/dist/skills/zon-ui/references/components/tabs.md +258 -0
  396. package/dist/skills/zon-ui/references/components/tag.md +115 -0
  397. package/dist/skills/zon-ui/references/components/tags-input.md +216 -0
  398. package/dist/skills/zon-ui/references/components/textarea.md +95 -0
  399. package/dist/skills/zon-ui/references/components/theme-editor.md +3940 -0
  400. package/dist/skills/zon-ui/references/components/theme.md +362 -0
  401. package/dist/skills/zon-ui/references/components/time-field.md +222 -0
  402. package/dist/skills/zon-ui/references/components/timeline.md +285 -0
  403. package/dist/skills/zon-ui/references/components/tippy.md +243 -0
  404. package/dist/skills/zon-ui/references/components/toast.md +220 -0
  405. package/dist/skills/zon-ui/references/components/toggle-group.md +261 -0
  406. package/dist/skills/zon-ui/references/components/toggle.md +167 -0
  407. package/dist/skills/zon-ui/references/components/tool-call.md +146 -0
  408. package/dist/skills/zon-ui/references/components/toolbar.md +260 -0
  409. package/dist/skills/zon-ui/references/components/tooltip.md +172 -0
  410. package/dist/skills/zon-ui/references/components/tour.md +423 -0
  411. package/dist/skills/zon-ui/references/components/tree.md +481 -0
  412. package/dist/skills/zon-ui/references/components/typography.md +347 -0
  413. package/dist/skills/zon-ui/references/components/video-player.md +386 -0
  414. package/dist/skills/zon-ui/references/marketing.md +467 -0
  415. package/dist/skills/zon-ui/references/motion.md +455 -0
  416. package/dist/skills/zon-ui/references/recipes.md +1232 -0
  417. package/dist/skills/zon-ui/references/tokens.md +866 -0
  418. package/dist/sources/accordion.css +4 -0
  419. package/dist/sources/action-sheet.css +11 -0
  420. package/dist/sources/alert-dialog.css +6 -0
  421. package/dist/sources/alert.css +3 -0
  422. package/dist/sources/app-bar.css +14 -0
  423. package/dist/sources/ascii-field.css +3 -0
  424. package/dist/sources/aspect-ratio.css +3 -0
  425. package/dist/sources/audio-player.css +20 -0
  426. package/dist/sources/avatar.css +3 -0
  427. package/dist/sources/badge.css +3 -0
  428. package/dist/sources/bottom-nav.css +9 -0
  429. package/dist/sources/breadcrumb.css +14 -0
  430. package/dist/sources/button-group.css +3 -0
  431. package/dist/sources/button.css +9 -0
  432. package/dist/sources/calendar.css +13 -0
  433. package/dist/sources/card.css +3 -0
  434. package/dist/sources/carousel.css +11 -0
  435. package/dist/sources/chart.css +5 -0
  436. package/dist/sources/checkbox.css +6 -0
  437. package/dist/sources/code-block.css +13 -0
  438. package/dist/sources/collapsible.css +4 -0
  439. package/dist/sources/color-picker.css +13 -0
  440. package/dist/sources/combobox.css +13 -0
  441. package/dist/sources/command.css +13 -0
  442. package/dist/sources/context-menu.css +12 -0
  443. package/dist/sources/conversation.css +10 -0
  444. package/dist/sources/copy-button.css +10 -0
  445. package/dist/sources/data-table.css +27 -0
  446. package/dist/sources/date-picker.css +20 -0
  447. package/dist/sources/dialog.css +9 -0
  448. package/dist/sources/direction.css +2 -0
  449. package/dist/sources/drawer.css +9 -0
  450. package/dist/sources/drawing.css +5 -0
  451. package/dist/sources/empty.css +3 -0
  452. package/dist/sources/feature-list.css +4 -0
  453. package/dist/sources/field.css +4 -0
  454. package/dist/sources/file-drop.css +15 -0
  455. package/dist/sources/filter-bar.css +30 -0
  456. package/dist/sources/form.css +4 -0
  457. package/dist/sources/graph.css +19 -0
  458. package/dist/sources/illustration.css +28 -0
  459. package/dist/sources/input-group.css +7 -0
  460. package/dist/sources/input.css +3 -0
  461. package/dist/sources/item.css +4 -0
  462. package/dist/sources/kbd.css +5 -0
  463. package/dist/sources/label.css +3 -0
  464. package/dist/sources/layout.css +3 -0
  465. package/dist/sources/lightbox.css +33 -0
  466. package/dist/sources/locale.css +2 -0
  467. package/dist/sources/logo.css +4 -0
  468. package/dist/sources/markdown-editor.css +41 -0
  469. package/dist/sources/mentions.css +13 -0
  470. package/dist/sources/menu.css +11 -0
  471. package/dist/sources/menubar.css +14 -0
  472. package/dist/sources/message.css +16 -0
  473. package/dist/sources/meter.css +4 -0
  474. package/dist/sources/money-input.css +10 -0
  475. package/dist/sources/native-select.css +4 -0
  476. package/dist/sources/navigation-menu.css +8 -0
  477. package/dist/sources/number-field.css +8 -0
  478. package/dist/sources/number-roll.css +6 -0
  479. package/dist/sources/otp-field.css +5 -0
  480. package/dist/sources/pagination.css +11 -0
  481. package/dist/sources/pdf-viewer.css +30 -0
  482. package/dist/sources/phone-input.css +20 -0
  483. package/dist/sources/popover.css +7 -0
  484. package/dist/sources/preview-card.css +7 -0
  485. package/dist/sources/progress.css +4 -0
  486. package/dist/sources/prompt-input.css +15 -0
  487. package/dist/sources/pull-to-refresh.css +14 -0
  488. package/dist/sources/quote.css +3 -0
  489. package/dist/sources/radio-group.css +5 -0
  490. package/dist/sources/rating.css +6 -0
  491. package/dist/sources/reasoning.css +6 -0
  492. package/dist/sources/resizable.css +4 -0
  493. package/dist/sources/response.css +16 -0
  494. package/dist/sources/scheduler.css +44 -0
  495. package/dist/sources/scroll-area.css +3 -0
  496. package/dist/sources/select.css +12 -0
  497. package/dist/sources/separator.css +3 -0
  498. package/dist/sources/sidebar.css +19 -0
  499. package/dist/sources/site-header.css +15 -0
  500. package/dist/sources/skeleton.css +3 -0
  501. package/dist/sources/slider.css +6 -0
  502. package/dist/sources/sortable.css +12 -0
  503. package/dist/sources/sources.css +6 -0
  504. package/dist/sources/spinner.css +6 -0
  505. package/dist/sources/stat.css +9 -0
  506. package/dist/sources/stepper.css +6 -0
  507. package/dist/sources/suggestions.css +10 -0
  508. package/dist/sources/swipe-actions.css +20 -0
  509. package/dist/sources/switch.css +5 -0
  510. package/dist/sources/table.css +7 -0
  511. package/dist/sources/tabs.css +5 -0
  512. package/dist/sources/tag.css +3 -0
  513. package/dist/sources/tags-input.css +6 -0
  514. package/dist/sources/textarea.css +3 -0
  515. package/dist/sources/theme.css +13 -0
  516. package/dist/sources/time-field.css +7 -0
  517. package/dist/sources/timeline.css +7 -0
  518. package/dist/sources/tippy.css +6 -0
  519. package/dist/sources/toast.css +6 -0
  520. package/dist/sources/toggle-group.css +5 -0
  521. package/dist/sources/toggle.css +3 -0
  522. package/dist/sources/tool-call.css +16 -0
  523. package/dist/sources/toolbar.css +14 -0
  524. package/dist/sources/tooltip.css +6 -0
  525. package/dist/sources/tour.css +14 -0
  526. package/dist/sources/tree.css +6 -0
  527. package/dist/sources/typography.css +4 -0
  528. package/dist/sources/video-player.css +21 -0
  529. package/dist/styles/ai.css +3 -0
  530. package/dist/styles/brand.css +98 -0
  531. package/dist/styles/core.css +266 -0
  532. package/dist/styles/editor.css +3 -0
  533. package/dist/styles/expressive.css +35 -56
  534. package/dist/styles/fonts.css +61 -117
  535. package/dist/styles/graph.css +4 -0
  536. package/dist/styles/illustration.css +4 -0
  537. package/dist/styles/index.css +11 -201
  538. package/dist/styles/material.css +138 -12
  539. package/dist/styles/parts/ai.css +18 -13
  540. package/dist/styles/parts/brand.css +2 -2
  541. package/dist/styles/parts/controls.css +29 -20
  542. package/dist/styles/parts/data.css +13 -9
  543. package/dist/styles/parts/editor.css +372 -0
  544. package/dist/styles/parts/feedback.css +32 -2
  545. package/dist/styles/parts/foundations.css +12 -7
  546. package/dist/styles/parts/graph.css +25 -9
  547. package/dist/styles/parts/inputs.css +172 -9
  548. package/dist/styles/parts/isometric.css +6 -5
  549. package/dist/styles/parts/navigation.css +206 -27
  550. package/dist/styles/parts/overlays.css +19 -4
  551. package/dist/styles/parts/pdf.css +2 -2
  552. package/dist/styles/pdf.css +3 -0
  553. package/dist/styles/prose.css +3 -0
  554. package/dist/styles/tokens.css +89 -14
  555. package/dist/theme.d.ts +1 -0
  556. package/dist/theme.js +5 -0
  557. package/dist/vite.d.ts +48 -59
  558. package/dist/vite.js +54 -21
  559. package/package.json +69 -2
@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { ScrollArea as BaseScrollArea } from "@base-ui/react/scroll-area";
4
4
  import { cn, sx } from "../lib/cn.js";
5
5
  function ScrollAreaScrollbar({ orientation }) {
6
- return (_jsx(BaseScrollArea.Scrollbar, { "data-slot": "scroll-area-scrollbar", orientation: orientation, className: cn("m-1 flex touch-none rounded-full opacity-0 transition-opacity duration-(--duration) ease-(--ease) select-none", "pointer-events-none data-hovering:pointer-events-auto data-hovering:opacity-100 data-scrolling:pointer-events-auto data-scrolling:opacity-100", "data-[orientation=horizontal]:h-1 data-[orientation=vertical]:w-1"), children: _jsx(BaseScrollArea.Thumb, { "data-slot": "scroll-area-thumb", className: "rounded-full bg-field-edge transition-colors duration-(--duration) ease-(--ease) hover:bg-control-focus data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full" }) }));
6
+ return (_jsx(BaseScrollArea.Scrollbar, { "data-slot": "scroll-area-scrollbar", orientation: orientation, className: cn("m-1 flex touch-none rounded-full opacity-0 transition-opacity duration-(--duration-fade) ease-(--ease) select-none", "pointer-events-none data-hovering:pointer-events-auto data-hovering:opacity-100 data-scrolling:pointer-events-auto data-scrolling:opacity-100", "data-[orientation=horizontal]:h-[calc(var(--scroll-thumb)*var(--density))] data-[orientation=vertical]:w-[calc(var(--scroll-thumb)*var(--density))]"), children: _jsx(BaseScrollArea.Thumb, { "data-slot": "scroll-area-thumb", className: "rounded-full bg-field-edge transition-colors duration-(--duration-fade) ease-(--ease) hover:bg-control-focus data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full" }) }));
7
7
  }
8
8
  /**
9
9
  * ScrollArea — a scrolling region with a thin, quiet scrollbar.
@@ -1,15 +1,28 @@
1
1
  import { Select as BaseSelect } from "@base-ui/react/select";
2
2
  import * as React from "react";
3
+ export interface SelectProps<Value, Multiple extends boolean | undefined = false> extends BaseSelect.Root
4
+ .Props<Value, Multiple> {
5
+ /**
6
+ * Render a real `<select>` (a `NativeSelect`) so the platform's own picker opens: `"touch"` (the
7
+ * default) on a phone only — a coarse primary pointer and a viewport under 768px — `true`
8
+ * everywhere, `false` never. It needs `items` with plain-text labels and one value; a `multiple`
9
+ * select, or one whose labels are elements, keeps the custom popup. Size, width and name come
10
+ * from the `SelectTrigger`, the placeholder from `SelectValue`. Default `"touch"`.
11
+ */
12
+ native?: boolean | "touch";
13
+ }
3
14
  /**
4
15
  * Select — pick one option from a list. Use `ToggleGroup` instead when there are 2–5 short
5
16
  * options and seeing them side by side is the point.
6
17
  *
7
- * Pass `items` to `<Select>` so `<SelectValue>` can render the selected label.
18
+ * Pass `items` to `<Select>` so `<SelectValue>` can render the selected label — and so a phone
19
+ * opens the platform's own picker, as it does by default (`native="touch"`; `native={false}` keeps
20
+ * the popup there too).
8
21
  */
9
- export declare function Select<Value, Multiple extends boolean | undefined = false>({ inputRef, ...props }: BaseSelect.Root.Props<Value, Multiple>): React.JSX.Element;
22
+ export declare function Select<Value, Multiple extends boolean | undefined = false>({ inputRef, native: nativeProp, ...props }: SelectProps<Value, Multiple>): React.JSX.Element;
10
23
  declare const triggerSizes: {
11
- readonly sm: "min-h-(--control-h-sm) px-2.5 text-[13px]";
12
- readonly default: "min-h-(--control-h) ps-3.5 pe-2.5 text-[15px]";
24
+ readonly sm: "min-h-(--control-h-sm) px-2.5 text-13";
25
+ readonly default: "min-h-(--control-h) ps-3.5 pe-2.5 text-15";
13
26
  };
14
27
  export interface SelectTriggerProps extends BaseSelect.Trigger.Props {
15
28
  size?: keyof typeof triggerSizes;
@@ -1,20 +1,25 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Select as BaseSelect } from "@base-ui/react/select";
4
- import { CheckIcon, ChevronDownIcon, ChevronsUpDownIcon, ChevronUpIcon } from "lucide-react";
4
+ import { CheckIcon, ChevronDownIcon, ChevronsUpDownIcon, ChevronUpIcon } from "../lib/icons.js";
5
5
  import * as React from "react";
6
6
  import { cn, sx } from "../lib/cn.js";
7
7
  import { useFormReset } from "../lib/form-reset.js";
8
8
  import { mergeRefs } from "../lib/merge-refs.js";
9
+ import { usePhone } from "../lib/platform.js";
9
10
  import { usePopupDir } from "./_overlay.js";
11
+ import { NativeSelect, NativeSelectOptGroup, NativeSelectOption } from "./native-select.js";
10
12
  import { ScrollArea } from "./scroll-area.js";
13
+ import { usePortalContainer } from "../lib/portal-container.js";
11
14
  /**
12
15
  * Select — pick one option from a list. Use `ToggleGroup` instead when there are 2–5 short
13
16
  * options and seeing them side by side is the point.
14
17
  *
15
- * Pass `items` to `<Select>` so `<SelectValue>` can render the selected label.
18
+ * Pass `items` to `<Select>` so `<SelectValue>` can render the selected label — and so a phone
19
+ * opens the platform's own picker, as it does by default (`native="touch"`; `native={false}` keeps
20
+ * the popup there too).
16
21
  */
17
- export function Select({ inputRef, ...props }) {
22
+ export function Select({ inputRef, native: nativeProp = "touch", ...props }) {
18
23
  // A form's reset remounts it from its defaults (lib/form-reset); its hidden input finds the form.
19
24
  const [resetKey, formRef] = useFormReset();
20
25
  const refs = React.useMemo(() => mergeRefs(formRef, inputRef), [formRef, inputRef]);
@@ -26,27 +31,153 @@ export function Select({ inputRef, ...props }) {
26
31
  "a second from about a thousand. Use a Combobox: people can type to narrow the list, and it " +
27
32
  "draws only the options in view.");
28
33
  }
29
- return _jsx(BaseSelect.Root, { inputRef: refs, ...props }, resetKey);
34
+ // Only items a `<select>` can show go native: one value, plain-text labels.
35
+ const options = props.multiple ? null : nativeOptions(items, props.itemToStringValue);
36
+ const native = options ? nativeProp : false;
37
+ // With `native`, the value lives here, so it survives the switch between the two (a phone turned
38
+ // to landscape, a window narrowed) — only then; without it Base UI keeps its own, as always.
39
+ const phone = usePhone(native === "touch");
40
+ const [own, setOwn] = React.useState(props.defaultValue ?? null);
41
+ const defaultRef = React.useRef(props.defaultValue);
42
+ React.useEffect(() => {
43
+ if (native && resetKey)
44
+ setOwn(defaultRef.current ?? null);
45
+ }, [native, resetKey]);
46
+ if (!native)
47
+ return _jsx(BaseSelect.Root, { inputRef: refs, ...props }, resetKey);
48
+ const controlled = props.value !== undefined;
49
+ const value = controlled ? props.value : own;
50
+ const onValueChange = (next, details) => {
51
+ props.onValueChange?.(next, details);
52
+ if (!controlled && !details.isCanceled)
53
+ setOwn(next);
54
+ };
55
+ if (options && (native === true || phone)) {
56
+ return (_jsx(NativeFromItems, { options: options, value: value, onValueChange: onValueChange, isItemEqualToValue: props.isItemEqualToValue, trigger: findTrigger(props.children), name: props.name, form: props.form, id: props.id, required: props.required, disabled: props.disabled || props.readOnly, autoComplete: props.autoComplete, selectRef: formRef }));
57
+ }
58
+ return (_jsx(BaseSelect.Root, { inputRef: refs, ...props, value: value, onValueChange: onValueChange }, resetKey));
59
+ }
60
+ const plain = (node) => typeof node === "string" || typeof node === "number";
61
+ function stringValue(value, toString) {
62
+ if (value == null)
63
+ return "";
64
+ if (toString)
65
+ return toString(value);
66
+ if (typeof value === "object" && "value" in value)
67
+ return String(value.value);
68
+ return String(value);
69
+ }
70
+ /**
71
+ * `items` as plain options, or null when a `<select>` cannot show them: no items, or a label that
72
+ * is an element (an icon, a badge) and not text.
73
+ */
74
+ function nativeOptions(items, toString) {
75
+ if (!items)
76
+ return null;
77
+ const out = [];
78
+ const add = (value, label, group) => {
79
+ if (!plain(label))
80
+ return false;
81
+ out.push({ value, key: stringValue(value, toString), label: String(label), group });
82
+ return true;
83
+ };
84
+ if (!Array.isArray(items)) {
85
+ for (const [value, label] of Object.entries(items))
86
+ if (!add(value, label))
87
+ return null;
88
+ return out;
89
+ }
90
+ for (const item of items) {
91
+ if (Array.isArray(item.items)) {
92
+ const name = item.label ?? item.value;
93
+ if (!plain(name))
94
+ return null;
95
+ for (const child of item.items)
96
+ if (!add(child.value, child.label, String(name)))
97
+ return null;
98
+ }
99
+ else if (!add(item.value, item.label))
100
+ return null;
101
+ }
102
+ return out;
103
+ }
104
+ /** The `SelectTrigger` among a Select's children, and the placeholder of its `SelectValue`. */
105
+ function findTrigger(children, depth = 0) {
106
+ let found = null;
107
+ React.Children.forEach(children, (child) => {
108
+ if (found || !React.isValidElement(child) || depth > 4)
109
+ return;
110
+ if (child.type === SelectTrigger) {
111
+ const props = child.props;
112
+ let placeholder;
113
+ React.Children.forEach(props.children, (part) => {
114
+ if (React.isValidElement(part) && part.type === SelectValue)
115
+ placeholder = part.props.placeholder;
116
+ });
117
+ found = { props, placeholder };
118
+ }
119
+ else if (child.type !== SelectContent)
120
+ found = findTrigger(child.props.children, depth + 1);
121
+ });
122
+ return found;
123
+ }
124
+ function NativeFromItems({ options, value, onValueChange, isItemEqualToValue, trigger, selectRef, ...props }) {
125
+ const equal = isItemEqualToValue ?? Object.is;
126
+ const chosen = value == null ? undefined : options.find((option) => equal(option.value, value));
127
+ const nullOption = options.find((option) => option.value == null);
128
+ const { size, className, id, children: _children, render: _render, nativeButton: _nativeButton, ...rest } = trigger?.props ?? {};
129
+ // The trigger's own aria and data attributes (a name, a description) carry over.
130
+ const aria = Object.fromEntries(Object.entries(rest).filter(([name]) => name.startsWith("aria-") || name.startsWith("data-")));
131
+ const groups = [];
132
+ for (const option of options) {
133
+ if (option.value == null)
134
+ continue;
135
+ const last = groups.at(-1);
136
+ if (last && last.name === option.group)
137
+ last.options.push(option);
138
+ else
139
+ groups.push({ name: option.group, options: [option] });
140
+ }
141
+ const optionOf = (option) => (_jsx(NativeSelectOption, { value: option.key, children: option.label }, option.key));
142
+ return (_jsxs(NativeSelect, { ref: selectRef, ...aria, ...props, id: props.id ?? id, size: size, wrapperClassName: typeof className === "string" ? className : undefined, value: chosen?.key ?? "", onChange: (event) => {
143
+ const next = options.find((option) => option.key === event.currentTarget.value);
144
+ let canceled = false;
145
+ const details = {
146
+ reason: "none",
147
+ event: event.nativeEvent,
148
+ trigger: event.currentTarget,
149
+ cancel: () => {
150
+ canceled = true;
151
+ },
152
+ allowPropagation: () => { },
153
+ get isCanceled() {
154
+ return canceled;
155
+ },
156
+ isPropagationAllowed: false,
157
+ };
158
+ onValueChange(next ? next.value : null, details);
159
+ }, children: [(nullOption || !chosen) && (_jsx(NativeSelectOption, { value: "", disabled: !nullOption, children: nullOption?.label ?? (plain(trigger?.placeholder) ? String(trigger.placeholder) : "") })), groups.map((group, index) => group.name === undefined ? (group.options.map(optionOf)) : (_jsx(NativeSelectOptGroup, { label: group.name, children: group.options.map(optionOf) }, `${group.name}-${index}`)))] }));
30
160
  }
31
161
  /** Past this many options, development warns once (see Select). */
32
162
  const MANY_OPTIONS = 500;
33
163
  let warned = false;
34
164
  const triggerSizes = {
35
- sm: "min-h-(--control-h-sm) px-2.5 text-[13px]",
36
- default: "min-h-(--control-h) ps-3.5 pe-2.5 text-[15px]",
165
+ sm: "min-h-(--control-h-sm) px-2.5 text-13",
166
+ default: "min-h-(--control-h) ps-3.5 pe-2.5 text-15",
37
167
  };
38
168
  export function SelectTrigger({ size = "default", className, children, ...props }) {
39
169
  return (_jsxs(BaseSelect.Trigger, { "data-slot": "select-trigger", "data-size": size, className: sx([
40
170
  "group/trigger inline-flex w-full min-w-40 material-field cursor-pointer items-center justify-between gap-3 rounded-control font-body leading-none whitespace-nowrap outline-none select-none",
41
171
  triggerSizes[size],
42
- ], className), ...props, children: [children, _jsx(BaseSelect.Icon, { className: "flex text-muted-foreground transition-colors duration-(--duration) ease-(--ease) group-hover/trigger:not-group-data-disabled/trigger:text-foreground", children: _jsx(ChevronsUpDownIcon, { className: "size-4" }) })] }));
172
+ ], className), ...props, children: [children, _jsx(BaseSelect.Icon, { className: "flex text-muted-foreground transition-colors duration-(--duration-fade) ease-(--ease) group-hover/trigger:not-group-data-disabled/trigger:text-foreground", children: _jsx(ChevronsUpDownIcon, { className: "size-4" }) })] }));
43
173
  }
44
174
  export function SelectValue({ className, ...props }) {
45
175
  return (_jsx(BaseSelect.Value, { "data-slot": "select-value", className: sx(["truncate data-placeholder:text-control-muted"], className), ...props }));
46
176
  }
47
177
  export function SelectContent({ className, children, alignItemWithTrigger = false, positioner, dir, ...props }) {
178
+ const portalContainer = usePortalContainer();
48
179
  const popupDir = usePopupDir(dir);
49
- return (_jsx(BaseSelect.Portal, { children: _jsx(BaseSelect.Positioner, { sideOffset: 6, alignItemWithTrigger: alignItemWithTrigger, dir: popupDir, ...positioner, className: "z-50 outline-none select-none", children: _jsxs(BaseSelect.Popup, { "data-slot": "select-content", className: sx([
180
+ return (_jsx(BaseSelect.Portal, { container: portalContainer, children: _jsx(BaseSelect.Positioner, { sideOffset: 6, alignItemWithTrigger: alignItemWithTrigger, dir: popupDir, ...positioner, className: "z-50 outline-none select-none", children: _jsxs(BaseSelect.Popup, { "data-slot": "select-content", className: sx([
50
181
  // As wide as the trigger, or wider for long options — up to 24rem (or the trigger, if
51
182
  // wider) and never past the window, so the popup never spans the screen.
52
183
  "relative max-w-[min(var(--available-width),max(var(--anchor-width),24rem))] min-w-(--anchor-width) popup-motion overflow-hidden rounded-button material-menu p-1 font-body outline-none",
@@ -63,7 +194,7 @@ export function SelectGroup({ className, ...props }) {
63
194
  return _jsx(BaseSelect.Group, { "data-slot": "select-group", className: className, ...props });
64
195
  }
65
196
  export function SelectGroupLabel({ className, ...props }) {
66
- return (_jsx(BaseSelect.GroupLabel, { "data-slot": "select-group-label", className: sx(["px-2.5 pt-2.5 pb-1.5 eyebrow text-[11px] [overflow-wrap:anywhere]"], className), ...props }));
197
+ return (_jsx(BaseSelect.GroupLabel, { "data-slot": "select-group-label", className: sx(["px-2.5 pt-2.5 pb-1.5 eyebrow text-11 [overflow-wrap:anywhere]"], className), ...props }));
67
198
  }
68
199
  export function SelectSeparator({ className, ...props }) {
69
200
  return (_jsx(BaseSelect.Separator, { "data-slot": "select-separator", className: cn("-mx-1 my-1 h-px bg-border", className), ...props }));
@@ -7,7 +7,7 @@ export interface SeparatorProps extends BaseSeparator.Props {
7
7
  /**
8
8
  * Separator — the hairline rule, which is the default way to group content here.
9
9
  *
10
- * `border/60`, 1px, horizontal or vertical. An optional mono label sits in the middle of a
10
+ * `border` at `--hairline-opacity` (60%), 1px, horizontal or vertical. An optional mono label sits in the middle of a
11
11
  * horizontal rule. The rule people break: reaching for a box (a boxed `Card`) where
12
12
  * a rule and whitespace would do. Use this first.
13
13
  */
@@ -5,13 +5,13 @@ import { sx } from "../lib/cn.js";
5
5
  /**
6
6
  * Separator — the hairline rule, which is the default way to group content here.
7
7
  *
8
- * `border/60`, 1px, horizontal or vertical. An optional mono label sits in the middle of a
8
+ * `border` at `--hairline-opacity` (60%), 1px, horizontal or vertical. An optional mono label sits in the middle of a
9
9
  * horizontal rule. The rule people break: reaching for a box (a boxed `Card`) where
10
10
  * a rule and whitespace would do. Use this first.
11
11
  */
12
12
  export function Separator({ orientation = "horizontal", label, className, ...props }) {
13
13
  if (label != null && orientation === "horizontal") {
14
- return (_jsx(BaseSeparator, { "data-slot": "separator", "data-labelled": "", "aria-label": typeof label === "string" ? label : undefined, orientation: orientation, className: sx("flex w-full items-center gap-4 eyebrow text-[11px] before:h-px before:flex-1 before:bg-border/60 before:content-[''] after:h-px after:flex-1 after:bg-border/60 after:content-['']", className), ...props, children: _jsx("span", { className: "shrink-0", children: label }) }));
14
+ return (_jsx(BaseSeparator, { "data-slot": "separator", "data-labelled": "", "aria-label": typeof label === "string" ? label : undefined, orientation: orientation, className: sx("flex w-full items-center gap-4 eyebrow text-11 before:h-px before:flex-1 before:bg-border/(--hairline-opacity) before:content-[''] after:h-px after:flex-1 after:bg-border/(--hairline-opacity) after:content-['']", className), ...props, children: _jsx("span", { className: "shrink-0", children: label }) }));
15
15
  }
16
- return (_jsx(BaseSeparator, { "data-slot": "separator", orientation: orientation, className: sx("shrink-0 bg-border/60 data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:min-h-4 data-[orientation=vertical]:w-px data-[orientation=vertical]:self-stretch", className), ...props }));
16
+ return (_jsx(BaseSeparator, { "data-slot": "separator", orientation: orientation, className: sx("shrink-0 bg-border/(--hairline-opacity) data-[orientation=horizontal]:h-px data-[orientation=horizontal]:w-full data-[orientation=vertical]:min-h-4 data-[orientation=vertical]:w-px data-[orientation=vertical]:self-stretch", className), ...props }));
17
17
  }
@@ -1,3 +1,4 @@
1
+ import { Collapsible as BaseCollapsible } from "@base-ui/react/collapsible";
1
2
  import { useRender } from "@base-ui/react/use-render";
2
3
  import * as React from "react";
3
4
  import { type ButtonProps } from "./button.js";
@@ -10,7 +11,7 @@ export interface SidebarMessages {
10
11
  toggle: string;
11
12
  }
12
13
  declare module "./locale" {
13
- interface Messages {
14
+ interface LocaleMessages {
14
15
  sidebar: SidebarMessages;
15
16
  }
16
17
  }
@@ -66,7 +67,7 @@ export interface SidebarProviderProps extends React.ComponentProps<"div"> {
66
67
  *
67
68
  * It renders the shell's flex row; put the `Sidebar` and a `SidebarInset` inside. The shell is
68
69
  * at least the viewport tall (`min-h-svh`) — give it a fixed height (`h-[560px] min-h-0`) to
69
- * embed it in a page. Widths come from `--sidebar-width` (16rem) and `--sidebar-width-icon`.
70
+ * embed it in a page. Widths come from `--sidebar-width` (16rem, times the theme's `--type`) and `--sidebar-width-icon`.
70
71
  */
71
72
  export declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange, collapsible, storageKey, keyboardShortcut, className, style, children, ...props }: SidebarProviderProps): React.JSX.Element;
72
73
  export interface SidebarProps extends React.ComponentProps<"nav"> {
@@ -91,6 +92,12 @@ export interface SidebarProps extends React.ComponentProps<"nav"> {
91
92
  * soft fill under it that follows the pointer from row to row.
92
93
  */
93
94
  hover?: "text" | "glide";
95
+ /**
96
+ * Inside a `SidebarProvider`, render a plain `<nav>` of rows instead of the app shell's panel:
97
+ * a settings page's own list of sections beside its content. It doesn't collapse, stick or
98
+ * turn into a sheet, and its rows take no icon-rail tooltips.
99
+ */
100
+ standalone?: boolean;
94
101
  }
95
102
  /**
96
103
  * Sidebar — section navigation for docs, settings and dashboards.
@@ -105,7 +112,7 @@ export interface SidebarProps extends React.ComponentProps<"nav"> {
105
112
  * the page by a hairline, holding `SidebarHeader`, `SidebarContent` and `SidebarFooter`. It
106
113
  * collapses on desktop and turns into a sheet on mobile.
107
114
  */
108
- export declare function Sidebar({ side, variant, size, hover, className, children, ...props }: SidebarProps): React.JSX.Element;
115
+ export declare function Sidebar({ side, variant, size, hover, standalone, className, children, ...props }: SidebarProps): React.JSX.Element;
109
116
  /** The top of an app-shell sidebar: a logo, a workspace switcher, a search row. Never scrolls. */
110
117
  export declare function SidebarHeader({ className, ...props }: React.ComponentProps<"div">): React.JSX.Element;
111
118
  /** The bottom of an app-shell sidebar: the account, settings, help. Never scrolls. */
@@ -144,6 +151,40 @@ export interface SidebarItemProps extends useRender.ComponentProps<"a"> {
144
151
  export declare function SidebarItem({ current, tooltip, render, ref, className, children, onClick, ...props }: SidebarItemProps): React.JSX.Element;
145
152
  /** A count at the end of a row ("12"): mono, tabular, muted. Hidden in the icon rail. */
146
153
  export declare function SidebarMenuBadge({ className, ...props }: React.ComponentProps<"span">): React.JSX.Element;
154
+ export interface SidebarSubmenuProps extends Omit<BaseCollapsible.Root.Props, "render" | "className" | "open" | "defaultOpen" | "onOpenChange"> {
155
+ /** Open, controlled. */
156
+ open?: boolean;
157
+ /** Open at first, uncontrolled. Defaults to `active`. */
158
+ defaultOpen?: boolean;
159
+ /** Called when the submenu opens or closes. */
160
+ onOpenChange?: (open: boolean) => void;
161
+ /** The parent row's label. */
162
+ label: React.ReactNode;
163
+ /** The parent row's 16px icon. In the icon rail the row is this icon alone. */
164
+ icon?: React.ReactNode;
165
+ /**
166
+ * One of the rows inside is the current page. The parent row's label then reads in the
167
+ * foreground ink, and the submenu starts open (unless `defaultOpen` or `open` says otherwise).
168
+ */
169
+ active?: boolean;
170
+ /** In the icon rail, the tooltip beside the parent row. Defaults to `label` when it is text. */
171
+ tooltip?: React.ReactNode;
172
+ /** Classes for the root. */
173
+ className?: string;
174
+ /** The nested rows: `SidebarItem`s. */
175
+ children?: React.ReactNode;
176
+ }
177
+ /**
178
+ * SidebarSubmenu — a row that opens nested rows under it: a "Settings" that holds Profile,
179
+ * Billing and Members. The parent is a `SidebarItem` (a button) with a chevron at its end that
180
+ * turns down when open; the nested `SidebarItem`s sit indented on a hairline under its icon, and
181
+ * the height glides open and shut. In the icon rail the parent is its icon: pressing it expands
182
+ * the sidebar and opens the submenu.
183
+ *
184
+ * The rule people break: nesting deeper than one level, or making the parent a page as well as
185
+ * a toggle. Keep one level, and link the parent's overview as the first nested row.
186
+ */
187
+ export declare function SidebarSubmenu({ label, icon, active, tooltip, open: openProp, defaultOpen, onOpenChange, className, children, ...props }: SidebarSubmenuProps): React.JSX.Element;
147
188
  /**
148
189
  * The button that opens and closes the sidebar: a circular ghost icon button, usually first in
149
190
  * the inset's toolbar. On mobile it opens the sheet. Shows the ⌘B / Ctrl+B shortcut's action.
@@ -1,9 +1,11 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { Collapsible as BaseCollapsible } from "@base-ui/react/collapsible";
3
4
  import { useRender } from "@base-ui/react/use-render";
4
- import { PanelLeftIcon } from "lucide-react";
5
+ import { ChevronRightIcon, PanelLeftIcon } from "../lib/icons.js";
5
6
  import * as React from "react";
6
7
  import { cn } from "../lib/cn.js";
8
+ import { cssEase } from "../lib/motion.js";
7
9
  import { modPressed } from "../lib/platform.js";
8
10
  import { Button } from "./button.js";
9
11
  import { Drawer, DrawerContent, DrawerTitle } from "./drawer.js";
@@ -76,7 +78,7 @@ function writeStored(key, open) {
76
78
  *
77
79
  * It renders the shell's flex row; put the `Sidebar` and a `SidebarInset` inside. The shell is
78
80
  * at least the viewport tall (`min-h-svh`) — give it a fixed height (`h-[560px] min-h-0`) to
79
- * embed it in a page. Widths come from `--sidebar-width` (16rem) and `--sidebar-width-icon`.
81
+ * embed it in a page. Widths come from `--sidebar-width` (16rem, times the theme's `--type`) and `--sidebar-width-icon`.
80
82
  */
81
83
  export function SidebarProvider({ defaultOpen = true, open: openProp, onOpenChange, collapsible = "offcanvas", storageKey = "zon-sidebar", keyboardShortcut = "b", className, style, children, ...props }) {
82
84
  const isMobile = useIsMobile();
@@ -153,7 +155,7 @@ export function SidebarProvider({ defaultOpen = true, open: openProp, onOpenChan
153
155
  collapsible,
154
156
  }), [open, setOpenAnimated, openMobile, isMobile, toggleSidebar, collapsible]);
155
157
  return (_jsx(SidebarContext.Provider, { value: value, children: _jsx(SidebarInstantContext.Provider, { value: instant, children: _jsx(TooltipProvider, { children: _jsx("div", { "data-slot": "sidebar-wrapper", className: cn("flex min-h-svh w-full", className), style: {
156
- "--sidebar-width": "16rem",
158
+ "--sidebar-width": "calc(16rem * var(--type))",
157
159
  "--sidebar-width-icon": "calc(var(--control-h) + 25px)",
158
160
  ...style,
159
161
  }, ...props, children: children }) }) }) }));
@@ -232,7 +234,7 @@ function CurrentGlide() {
232
234
  });
233
235
  running = ghost.animate([at(from), at(to)], {
234
236
  duration,
235
- easing: getComputedStyle(nav).getPropertyValue("--ease-glide").trim() || "ease-out",
237
+ easing: cssEase("--ease-glide", nav),
236
238
  fill: "forwards",
237
239
  });
238
240
  running.onfinish = land;
@@ -344,8 +346,9 @@ function HoverGlide() {
344
346
  * the page by a hairline, holding `SidebarHeader`, `SidebarContent` and `SidebarFooter`. It
345
347
  * collapses on desktop and turns into a sheet on mobile.
346
348
  */
347
- export function Sidebar({ side = "left", variant = "sidebar", size = "default", hover = "text", className, children, ...props }) {
348
- const shell = React.useContext(SidebarContext);
349
+ export function Sidebar({ side = "left", variant = "sidebar", size = "default", hover = "text", standalone = false, className, children, ...props }) {
350
+ const providedShell = React.useContext(SidebarContext);
351
+ const shell = standalone ? null : providedShell;
349
352
  const instant = React.useContext(SidebarInstantContext);
350
353
  const text = useMessages("sidebar", defaultMessages);
351
354
  const dense = size === "sm";
@@ -353,14 +356,16 @@ export function Sidebar({ side = "left", variant = "sidebar", size = "default",
353
356
  const sizeClass = dense ? "[--control-h:var(--control-h-sm)]" : undefined;
354
357
  const content = (_jsx(SidebarSizeContext.Provider, { value: size, children: _jsxs(SidebarSideContext.Provider, { value: side, children: [hover === "glide" && _jsx(HoverGlide, {}), _jsx(CurrentGlide, {}), children] }) }));
355
358
  if (!shell) {
356
- return (_jsx("nav", { "data-slot": "sidebar", "data-size": size, className: cn("relative isolate flex w-full flex-col", dense ? "gap-5" : "gap-7", sizeClass, className), ...props, children: content }));
359
+ const nav = (_jsx("nav", { "data-slot": "sidebar", "data-size": size, className: cn("relative isolate flex w-full flex-col", dense ? "gap-5" : "gap-7", sizeClass, className), ...props, children: content }));
360
+ // A standalone sidebar inside the shell: its rows must not read the shell's state either.
361
+ return providedShell ? _jsx(SidebarContext.Provider, { value: null, children: nav }) : nav;
357
362
  }
358
363
  const { state, collapsible, isMobile, openMobile, setOpenMobile } = shell;
359
364
  // No fill beside the page: the page ground (the body's grain) runs under the sidebar too.
360
365
  // isolate: the gliding current row paints under the rows but over the panel's own fill.
361
366
  const panelClass = "isolate flex h-full flex-col font-body text-foreground";
362
367
  if (collapsible === "none") {
363
- return (_jsx("nav", { "data-slot": "sidebar", "data-side": side, "data-variant": variant, "data-size": size, "data-state": "expanded", className: cn(panelClass, sizeClass, "sticky top-0 h-svh max-h-full w-(--sidebar-width) shrink-0 border-border/60", variant !== "sidebar" ? undefined : side === "left" ? "border-e" : "border-s", className), ...props, children: content }));
368
+ return (_jsx("nav", { "data-slot": "sidebar", "data-side": side, "data-variant": variant, "data-size": size, "data-state": "expanded", className: cn(panelClass, sizeClass, "sticky top-0 h-svh max-h-full w-(--sidebar-width) shrink-0 border-border/(--hairline-opacity)", variant !== "sidebar" ? undefined : side === "left" ? "border-e" : "border-s", className), ...props, children: content }));
364
369
  }
365
370
  if (isMobile) {
366
371
  return (_jsx(Drawer, { side: side, open: openMobile, onOpenChange: setOpenMobile, children: _jsx(DrawerContent, { "data-slot": "sidebar-sheet", className: cn("w-[min(18rem,calc(100vw-3rem))] **:data-[slot=drawer-body]:gap-0 **:data-[slot=drawer-body]:p-0"), children: _jsxs(SidebarSurfaceContext.Provider, { value: "sheet", children: [_jsx(DrawerTitle, { className: "sr-only", children: props["aria-label"] ?? text.navigation }), _jsx("nav", { "data-slot": "sidebar", "data-side": side, "data-size": size, className: cn(panelClass, "relative min-h-0 flex-1 bg-background", sizeClass, className), ...props, children: content })] }) }) }));
@@ -368,7 +373,7 @@ export function Sidebar({ side = "left", variant = "sidebar", size = "default",
368
373
  const offcanvas = state === "collapsed" && collapsible === "offcanvas";
369
374
  return (_jsx("div", { "data-slot": "sidebar-shell", "data-instant": instant ? "" : undefined, "data-variant": variant, "data-size": size, style: dense
370
375
  ? { "--sidebar-width-icon": "calc(var(--control-h-sm) + 25px)" }
371
- : undefined, "data-state": state, "data-collapsible": state === "collapsed" ? collapsible : undefined, "data-side": side, className: cn("group/sidebar sticky top-0 hidden h-svh max-h-full w-(--sidebar-width) shrink-0 overflow-clip md:block", "transition-[width] duration-(--duration) ease-brand data-instant:transition-none", "data-[collapsible=icon]:w-(--sidebar-width-icon) data-[collapsible=offcanvas]:w-0"), children: _jsx("nav", { "data-slot": "sidebar", "data-side": side, "data-size": size, inert: offcanvas || undefined, className: cn(panelClass, sizeClass, "absolute inset-y-0 w-(--sidebar-width) border-border/60 transition-[width] duration-(--duration) ease-brand group-data-instant/sidebar:transition-none", "group-data-[collapsible=icon]/sidebar:w-(--sidebar-width-icon)", side === "left" ? "start-0" : "end-0", variant !== "sidebar" ? undefined : side === "left" ? "border-e" : "border-s", className), ...props, children: content }) }));
376
+ : undefined, "data-state": state, "data-collapsible": state === "collapsed" ? collapsible : undefined, "data-side": side, className: cn("group/sidebar sticky top-0 hidden h-svh max-h-full w-(--sidebar-width) shrink-0 overflow-clip md:block", "transition-[width] duration-(--duration) ease-(--ease) data-instant:transition-none", "data-[collapsible=icon]:w-(--sidebar-width-icon) data-[collapsible=offcanvas]:w-0"), children: _jsx("nav", { "data-slot": "sidebar", "data-side": side, "data-size": size, inert: offcanvas || undefined, className: cn(panelClass, sizeClass, "absolute inset-y-0 w-(--sidebar-width) border-border/(--hairline-opacity) transition-[width] duration-(--duration) ease-(--ease) group-data-instant/sidebar:transition-none", "group-data-[collapsible=icon]/sidebar:w-(--sidebar-width-icon)", side === "left" ? "start-0" : "end-0", variant !== "sidebar" ? undefined : side === "left" ? "border-e" : "border-s", className), ...props, children: content }) }));
372
377
  }
373
378
  /** The top of an app-shell sidebar: a logo, a workspace switcher, a search row. Never scrolls. */
374
379
  export function SidebarHeader({ className, ...props }) {
@@ -404,11 +409,13 @@ export function SidebarGroup({ className, ...props }) {
404
409
  */
405
410
  export function SidebarGroupLabel({ className, ...props }) {
406
411
  const dense = React.useContext(SidebarSizeContext) === "sm";
407
- return (_jsx("div", { "data-slot": "sidebar-group-label", className: cn("overflow-hidden eyebrow whitespace-nowrap transition-[margin,opacity] duration-(--duration) ease-brand group-data-instant/sidebar:transition-none", "group-data-[collapsible=icon]/sidebar:pointer-events-none group-data-[collapsible=icon]/sidebar:opacity-0",
408
- // Fixed heights (line + padding) so the fold is exact: 16 + 8 = 24px, dense 14 + 6 = 20px.
409
- dense
410
- ? "px-2.5 pb-1.5 text-[11px] leading-[14px] group-data-[collapsible=icon]/sidebar:-mt-5"
411
- : "px-3 pb-2 leading-4 group-data-[collapsible=icon]/sidebar:-mt-6", className), ...props }));
412
+ return (_jsx("div", { "data-slot": "sidebar-group-label", className: cn("overflow-hidden eyebrow whitespace-nowrap transition-[margin,opacity] [transition-duration:var(--duration),var(--duration-fade)] ease-(--ease) group-data-instant/sidebar:transition-none", "group-data-[collapsible=icon]/sidebar:pointer-events-none group-data-[collapsible=icon]/sidebar:opacity-0",
413
+ // Exact heights (line + padding) so the fold is exact: 16 + 8 = 24px, dense 14 + 6 = 20px.
414
+ // The line is in em, so text set larger (a text-only zoom) keeps its whole line and still
415
+ // folds away exactly; a label wider than the sidebar ends in "…".
416
+ "text-ellipsis", dense
417
+ ? "px-2.5 pb-1.5 text-11 leading-[1.2727em] group-data-[collapsible=icon]/sidebar:-mt-[calc(1.2727em+var(--spacing)*1.5)]"
418
+ : "px-3 pb-2 leading-[1.3333em] group-data-[collapsible=icon]/sidebar:-mt-[calc(1.3333em+var(--spacing)*2)]", className), ...props }));
412
419
  }
413
420
  function textOf(node) {
414
421
  if (typeof node === "string" || typeof node === "number")
@@ -447,7 +454,7 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
447
454
  },
448
455
  className: cn(
449
456
  // cursor-pointer: rows may render as a <button> (theme switch, account menu), which has no pointer by default.
450
- "flex min-h-(--control-h) w-full cursor-pointer items-center rounded-button material-row font-body leading-none no-underline focus-ring select-none", dense ? "gap-2 px-2.5 text-[13px]" : "gap-2.5 px-3 text-sm", "aria-disabled:pointer-events-none aria-disabled:opacity-50",
457
+ "flex min-h-(--control-h) w-full cursor-pointer items-center rounded-button material-row font-body leading-none no-underline focus-ring select-none", dense ? "gap-2 px-2.5 text-13" : "gap-2.5 px-3 text-sm", "aria-disabled:pointer-events-none aria-disabled:opacity-50",
451
458
  // Hover is quieter than current: the label brightens (over the gliding fill with hover="glide"),
452
459
  // the row itself takes no fill, edge or shadow. The raised row means "you are here".
453
460
  "hover:not-aria-[current=page]:bg-transparent! hover:not-aria-[current=page]:bg-none! hover:not-aria-[current=page]:shadow-none!",
@@ -456,7 +463,10 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
456
463
  // While the current row glides (CurrentGlide), the old and new rows stay flat.
457
464
  "data-glide:transition-none! data-[glide=hidden]:bg-transparent! data-[glide=hidden]:bg-none! data-[glide=hidden]:shadow-none!", "[&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4", inShell && "overflow-hidden whitespace-nowrap", inShell &&
458
465
  // A square in the icon rail with the 16px icon centred: (row - icon - border) / 2 a side.
459
- "group-data-[collapsible=icon]/sidebar:size-(--control-h) group-data-[collapsible=icon]/sidebar:px-[calc((var(--control-h)-18px)/2)]", className),
466
+ // The gap grows to a whole row, so the label (and a trailing Kbd or Tag) starts well past
467
+ // the clip edge: at the usual gap it starts exactly on it, and a glyph's overhang or a
468
+ // fractional pixel ratio leaks it in as specks beside the icon.
469
+ "group-data-[collapsible=icon]/sidebar:size-(--control-h) group-data-[collapsible=icon]/sidebar:gap-(--control-h) group-data-[collapsible=icon]/sidebar:px-[calc((var(--control-h)-18px)/2)]", className),
460
470
  children,
461
471
  },
462
472
  });
@@ -472,6 +482,36 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
472
482
  export function SidebarMenuBadge({ className, ...props }) {
473
483
  return (_jsx("span", { "data-slot": "sidebar-menu-badge", className: cn("ms-auto ps-2 font-mono text-xs leading-none text-muted-foreground tabular-nums group-data-[collapsible=icon]/sidebar:hidden", className), ...props }));
474
484
  }
485
+ /**
486
+ * SidebarSubmenu — a row that opens nested rows under it: a "Settings" that holds Profile,
487
+ * Billing and Members. The parent is a `SidebarItem` (a button) with a chevron at its end that
488
+ * turns down when open; the nested `SidebarItem`s sit indented on a hairline under its icon, and
489
+ * the height glides open and shut. In the icon rail the parent is its icon: pressing it expands
490
+ * the sidebar and opens the submenu.
491
+ *
492
+ * The rule people break: nesting deeper than one level, or making the parent a page as well as
493
+ * a toggle. Keep one level, and link the parent's overview as the first nested row.
494
+ */
495
+ export function SidebarSubmenu({ label, icon, active = false, tooltip, open: openProp, defaultOpen, onOpenChange, className, children, ...props }) {
496
+ const shell = React.useContext(SidebarContext);
497
+ const dense = React.useContext(SidebarSizeContext) === "sm";
498
+ const [ownOpen, setOwnOpen] = React.useState(defaultOpen ?? active);
499
+ const open = openProp ?? ownOpen;
500
+ const setOpen = (next) => {
501
+ if (openProp === undefined)
502
+ setOwnOpen(next);
503
+ onOpenChange?.(next);
504
+ };
505
+ const iconRail = !!shell && !shell.isMobile && shell.state === "collapsed" && shell.collapsible === "icon";
506
+ return (_jsxs(BaseCollapsible.Root, { "data-slot": "sidebar-submenu", "data-active": active ? "" : undefined, open: open, onOpenChange: (next) => setOpen(next), className: cn("flex flex-col gap-0.5", className), ...props, children: [_jsx(SidebarSurfaceContext.Provider, { value: "panel", children: _jsxs(BaseCollapsible.Trigger, { "data-slot": "sidebar-submenu-trigger", onClick: (event) => {
507
+ if (!iconRail || !shell)
508
+ return;
509
+ // In the icon rail there is no room for the nested rows: open the sidebar, and the submenu with it.
510
+ event.preventBaseUIHandler();
511
+ shell.setOpen(true);
512
+ setOpen(true);
513
+ }, render: _jsx(SidebarItem, { render: _jsx("button", { type: "button" }), tooltip: tooltip ?? (typeof label === "string" ? label : undefined), className: cn("group/sidebar-submenu", active && "not-aria-[current=page]:text-foreground") }), children: [icon, _jsx("span", { className: "min-w-0 truncate", children: label }), _jsx(ChevronRightIcon, { "aria-hidden": true, className: "ms-auto size-3.5 text-muted-foreground transition-[rotate] duration-(--duration) ease-(--ease) group-data-panel-open/sidebar-submenu:rotate-90 rtl:-scale-x-100 rtl:group-data-panel-open/sidebar-submenu:-rotate-90" })] }) }), _jsx(BaseCollapsible.Panel, { "data-slot": "sidebar-submenu-panel", className: "h-(--collapsible-panel-height) overflow-hidden transition-[height] duration-(--duration-glide) ease-(--ease-glide) group-data-instant/sidebar:transition-none group-data-[collapsible=icon]/sidebar:hidden data-ending-style:h-0 data-starting-style:h-0", children: _jsx("div", { "data-slot": "sidebar-submenu-rows", className: cn("flex flex-col gap-0.5 border-s border-border/(--hairline-opacity) py-0.5 pe-0.5", dense ? "ms-[17px] ps-1.5" : "ms-[19px] ps-2"), children: children }) })] }));
514
+ }
475
515
  /* ── Controls ──────────────────────────────────────────────────────────────── */
476
516
  /**
477
517
  * The button that opens and closes the sidebar: a circular ghost icon button, usually first in
@@ -503,7 +543,7 @@ export function SidebarRail({ className, onClick, ...props }) {
503
543
  onClick?.(event);
504
544
  if (!event.defaultPrevented)
505
545
  toggleSidebar();
506
- }, className: cn("absolute inset-y-0 z-20 w-2 border-0 bg-transparent p-0 outline-none", "after:absolute after:inset-y-0 after:w-px after:bg-transparent after:transition-[background-color] after:duration-(--duration) after:ease-brand after:content-[''] hover:after:bg-control-focus",
546
+ }, className: cn("absolute inset-y-0 z-20 w-2 border-0 bg-transparent p-0 outline-none", "after:absolute after:inset-y-0 after:w-px after:bg-transparent after:transition-[background-color] after:duration-(--duration-fade) after:ease-(--ease) after:content-[''] hover:after:bg-control-focus",
507
547
  // On the edge next to the page: the end of a start sidebar, in either direction.
508
548
  "group-data-[side=left]/sidebar:end-0 group-data-[side=right]/sidebar:start-0 group-data-[side=left]/sidebar:after:-end-px group-data-[side=right]/sidebar:after:-start-px",
509
549
  // The cursor points the way the panel will go: towards its edge to close, away to open.
@@ -10,7 +10,7 @@ export interface SiteHeaderMessages {
10
10
  menu: string;
11
11
  }
12
12
  declare module "./locale" {
13
- interface Messages {
13
+ interface LocaleMessages {
14
14
  siteHeader: SiteHeaderMessages;
15
15
  }
16
16
  }
@@ -39,12 +39,22 @@ export interface SiteHeaderLink {
39
39
  render?: React.ReactElement;
40
40
  }
41
41
  export interface SiteHeaderProps extends Omit<React.ComponentProps<"header">, "children"> {
42
- /** The lockup at the start: left, or right on a right-to-left page. Link it to the home page yourself. */
42
+ /**
43
+ * The lockup at the start: left, or right on a right-to-left page. Link it to the home page
44
+ * yourself. Your product's own mark and name — `<Wordmark>` — never zon's `Logo` on a site that
45
+ * isn't zon's.
46
+ */
43
47
  logo: React.ReactNode;
44
48
  /** Primary navigation, in order, about five links: e.g. "Product", "Docs", "Pricing", "Blog", "About". */
45
49
  links: SiteHeaderLink[];
46
- /** The slot at the end: locale switch, theme toggle, one CTA at most. */
50
+ /** The slot at the end: locale switch, theme toggle, one `secondary` or `ghost` CTA at most, never the primary. On phones it moves into the menu panel. */
47
51
  actions?: React.ReactNode;
52
+ /**
53
+ * Actions that stay in the bar at every width — a cart, the account, a sign-in — after `actions`
54
+ * on a wide bar and beside the menu button on a phone, where `actions` move into the panel. Keep
55
+ * it to one or two compact controls (an icon button, an avatar).
56
+ */
57
+ pinned?: React.ReactNode;
48
58
  /**
49
59
  * Where the links sit. `end` (default): with the actions at the end of the bar, after a hairline
50
60
  * divider. `start`: right after the logo, with the actions on their own at the end — for an app
@@ -59,17 +69,12 @@ export interface SiteHeaderProps extends Omit<React.ComponentProps<"header">, "c
59
69
  scrolled?: boolean;
60
70
  /** Pixels of scroll before the ground starts to come in. Defaults to 8. */
61
71
  scrollThreshold?: number;
62
- /** Accessible name of the `<nav>`. Defaults to "Main", or `messages.siteHeader.nav`. */
63
- navLabel?: string;
64
72
  /**
65
- * Accessible names for the mobile menu buttons. Default `messages.siteHeader` `openMenu`,
66
- * `closeMenu` and `menu`.
73
+ * The header's words: the `<nav>`'s name (`nav`), the phone menu button (`openMenu`), the
74
+ * panel's close button (`closeMenu`) and its title (`menu`). A LocaleProvider sets them for
75
+ * every SiteHeader.
67
76
  */
68
- menuLabels?: {
69
- open?: string;
70
- close?: string;
71
- title?: string;
72
- };
77
+ labels?: Partial<SiteHeaderMessages>;
73
78
  /**
74
79
  * The phone menu: below 48rem of header the links fold into a menu button that opens a full
75
80
  * panel. `false` leaves it out, for an app with navigation of its own on phones (a bottom tab
@@ -90,4 +95,4 @@ export interface SiteHeaderProps extends Omit<React.ComponentProps<"header">, "c
90
95
  * entry `items` and it opens a dropdown panel. The rule people break: filling the bar with
91
96
  * buttons. One CTA at most — the links are the navigation, the actions slot is for locale and theme.
92
97
  */
93
- export declare function SiteHeader({ logo, links, actions, align, scrolled: scrolledProp, scrollThreshold, navLabel: navLabelProp, menuLabels, menu, className, style, dir, ...props }: SiteHeaderProps): React.JSX.Element;
98
+ export declare function SiteHeader({ logo, links, actions, pinned, align, scrolled: scrolledProp, scrollThreshold, labels, menu, className, style, dir, ...props }: SiteHeaderProps): React.JSX.Element;