@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
@@ -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";
@@ -17,6 +19,11 @@ const SidebarContext = React.createContext(null);
17
19
  const SidebarSizeContext = React.createContext("default");
18
20
  /** The edge the sidebar is on (`Sidebar side`): its icon rail's tooltips open towards the page. */
19
21
  const SidebarSideContext = React.createContext("left");
22
+ /**
23
+ * The last desktop toggle came from the keyboard shortcut: the panel then opens and closes at
24
+ * once, as a shortcut someone presses many times a day should; a click on a trigger animates.
25
+ */
26
+ const SidebarInstantContext = React.createContext(false);
20
27
  /** Where a `Sidebar` is rendered: the desktop panel or the mobile sheet. */
21
28
  const SidebarSurfaceContext = React.createContext("panel");
22
29
  /**
@@ -71,7 +78,7 @@ function writeStored(key, open) {
71
78
  *
72
79
  * It renders the shell's flex row; put the `Sidebar` and a `SidebarInset` inside. The shell is
73
80
  * at least the viewport tall (`min-h-svh`) — give it a fixed height (`h-[560px] min-h-0`) to
74
- * 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`.
75
82
  */
76
83
  export function SidebarProvider({ defaultOpen = true, open: openProp, onOpenChange, collapsible = "offcanvas", storageKey = "zon-sidebar", keyboardShortcut = "b", className, style, children, ...props }) {
77
84
  const isMobile = useIsMobile();
@@ -95,12 +102,22 @@ export function SidebarProvider({ defaultOpen = true, open: openProp, onOpenChan
95
102
  if (stored !== undefined)
96
103
  setOpenState(stored);
97
104
  }, [openProp, storageKey]);
98
- const toggleSidebar = React.useCallback(() => {
105
+ const toggle = React.useCallback(() => {
99
106
  if (isMobile)
100
107
  setOpenMobile((value) => !value);
101
108
  else
102
109
  setOpen(!openRef.current);
103
110
  }, [isMobile, setOpen]);
111
+ // Only the shortcut toggles instantly; the trigger and setOpen animate.
112
+ const [instant, setInstant] = React.useState(false);
113
+ const toggleSidebar = React.useCallback(() => {
114
+ setInstant(false);
115
+ toggle();
116
+ }, [toggle]);
117
+ const setOpenAnimated = React.useCallback((value) => {
118
+ setInstant(false);
119
+ setOpen(value);
120
+ }, [setOpen]);
104
121
  // Leaving the mobile layout closes the sheet: narrowing the window again must not reopen it.
105
122
  if (!isMobile && openMobile)
106
123
  setOpenMobile(false);
@@ -121,26 +138,27 @@ export function SidebarProvider({ defaultOpen = true, open: openProp, onOpenChan
121
138
  if (event.target instanceof HTMLElement && event.target.isContentEditable)
122
139
  return;
123
140
  event.preventDefault();
124
- toggleSidebar();
141
+ setInstant(true);
142
+ toggle();
125
143
  };
126
144
  window.addEventListener("keydown", onKeyDown);
127
145
  return () => window.removeEventListener("keydown", onKeyDown);
128
- }, [keyboardShortcut, collapsible, toggleSidebar]);
146
+ }, [keyboardShortcut, collapsible, toggle]);
129
147
  const value = React.useMemo(() => ({
130
148
  state: open || collapsible === "none" ? "expanded" : "collapsed",
131
149
  open,
132
- setOpen,
150
+ setOpen: setOpenAnimated,
133
151
  openMobile,
134
152
  setOpenMobile,
135
153
  isMobile,
136
154
  toggleSidebar,
137
155
  collapsible,
138
- }), [open, setOpen, openMobile, isMobile, toggleSidebar, collapsible]);
139
- return (_jsx(SidebarContext.Provider, { value: value, children: _jsx(TooltipProvider, { children: _jsx("div", { "data-slot": "sidebar-wrapper", className: cn("flex min-h-svh w-full", className), style: {
140
- "--sidebar-width": "16rem",
141
- "--sidebar-width-icon": "calc(var(--control-h) + 25px)",
142
- ...style,
143
- }, ...props, children: children }) }) }));
156
+ }), [open, setOpenAnimated, openMobile, isMobile, toggleSidebar, collapsible]);
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: {
158
+ "--sidebar-width": "calc(16rem * var(--type))",
159
+ "--sidebar-width-icon": "calc(var(--control-h) + 25px)",
160
+ ...style,
161
+ }, ...props, children: children }) }) }) }));
144
162
  }
145
163
  /* ── The current row glides ──────────────────────────────────────────────── */
146
164
  const ROW = '[data-slot="sidebar-item"]';
@@ -206,15 +224,17 @@ function CurrentGlide() {
206
224
  }
207
225
  }
208
226
  ghost.style.visibility = "visible";
209
- const duration = parseFloat(getComputedStyle(nav).getPropertyValue("--duration")) || 150;
227
+ // --duration-glide, resolved: the copy's animation-duration (it runs no CSS animation) is
228
+ // set to it, as the token itself is a calc() that getPropertyValue returns unresolved.
229
+ const duration = parseFloat(getComputedStyle(ghost).animationDuration) * 1000 || 0;
210
230
  const at = (b) => ({
211
231
  translate: `${b.x}px ${b.y}px`,
212
232
  width: `${b.w}px`,
213
233
  height: `${b.h}px`,
214
234
  });
215
235
  running = ghost.animate([at(from), at(to)], {
216
- duration: duration * 2,
217
- easing: getComputedStyle(nav).getPropertyValue("--ease").trim() || "ease-out",
236
+ duration,
237
+ easing: cssEase("--ease-glide", nav),
218
238
  fill: "forwards",
219
239
  });
220
240
  running.onfinish = land;
@@ -233,7 +253,7 @@ function CurrentGlide() {
233
253
  delete row.dataset.glide;
234
254
  };
235
255
  }, []);
236
- return (_jsx("span", { ref: ref, "aria-hidden": true, "data-slot": "sidebar-current-glide", "data-current": "", className: "pointer-events-none invisible absolute top-0 left-0 -z-1 rounded-button material-row" }));
256
+ return (_jsx("span", { ref: ref, "aria-hidden": true, "data-slot": "sidebar-current-glide", "data-current": "", className: "pointer-events-none invisible absolute top-0 left-0 -z-1 rounded-button material-row [animation-duration:var(--duration-glide)]" }));
237
257
  }
238
258
  /**
239
259
  * Hover is one soft fill that follows the pointer up and down the list instead of each row lighting
@@ -311,7 +331,7 @@ function HoverGlide() {
311
331
  nav.removeEventListener("scroll", follow, true);
312
332
  };
313
333
  }, []);
314
- return (_jsx("span", { ref: ref, "aria-hidden": true, "data-slot": "sidebar-hover-glide", className: cn("pointer-events-none absolute top-0 left-0 -z-1 rounded-button bg-(--ink-ghost) opacity-0 data-visible:opacity-100", "transition-[translate,width,height,opacity] duration-[calc(var(--duration)*1.4)] ease-brand data-instant:transition-none") }));
334
+ return (_jsx("span", { ref: ref, "aria-hidden": true, "data-slot": "sidebar-hover-glide", className: cn("pointer-events-none absolute top-0 left-0 -z-1 rounded-button bg-(--ink-ghost) opacity-0 data-visible:opacity-100", "transition-[translate,width,height,opacity] [transition-duration:var(--duration-glide),var(--duration-glide),var(--duration-glide),var(--duration-fade)] ease-(--ease-glide) data-instant:transition-none") }));
315
335
  }
316
336
  /**
317
337
  * Sidebar — section navigation for docs, settings and dashboards.
@@ -326,30 +346,34 @@ function HoverGlide() {
326
346
  * the page by a hairline, holding `SidebarHeader`, `SidebarContent` and `SidebarFooter`. It
327
347
  * collapses on desktop and turns into a sheet on mobile.
328
348
  */
329
- export function Sidebar({ side = "left", variant = "sidebar", size = "default", hover = "text", className, children, ...props }) {
330
- 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;
352
+ const instant = React.useContext(SidebarInstantContext);
331
353
  const text = useMessages("sidebar", defaultMessages);
332
354
  const dense = size === "sm";
333
355
  // Dense: every control inside (the rows, a search field, a header button) is 30px.
334
356
  const sizeClass = dense ? "[--control-h:var(--control-h-sm)]" : undefined;
335
357
  const content = (_jsx(SidebarSizeContext.Provider, { value: size, children: _jsxs(SidebarSideContext.Provider, { value: side, children: [hover === "glide" && _jsx(HoverGlide, {}), _jsx(CurrentGlide, {}), children] }) }));
336
358
  if (!shell) {
337
- 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;
338
362
  }
339
363
  const { state, collapsible, isMobile, openMobile, setOpenMobile } = shell;
340
364
  // No fill beside the page: the page ground (the body's grain) runs under the sidebar too.
341
365
  // isolate: the gliding current row paints under the rows but over the panel's own fill.
342
366
  const panelClass = "isolate flex h-full flex-col font-body text-foreground";
343
367
  if (collapsible === "none") {
344
- 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 }));
345
369
  }
346
370
  if (isMobile) {
347
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 })] }) }) }));
348
372
  }
349
373
  const offcanvas = state === "collapsed" && collapsible === "offcanvas";
350
- return (_jsx("div", { "data-slot": "sidebar-shell", "data-variant": variant, "data-size": size, style: dense
374
+ return (_jsx("div", { "data-slot": "sidebar-shell", "data-instant": instant ? "" : undefined, "data-variant": variant, "data-size": size, style: dense
351
375
  ? { "--sidebar-width-icon": "calc(var(--control-h-sm) + 25px)" }
352
- : 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-[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-[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 }) }));
353
377
  }
354
378
  /** The top of an app-shell sidebar: a logo, a workspace switcher, a search row. Never scrolls. */
355
379
  export function SidebarHeader({ className, ...props }) {
@@ -385,11 +409,13 @@ export function SidebarGroup({ className, ...props }) {
385
409
  */
386
410
  export function SidebarGroupLabel({ className, ...props }) {
387
411
  const dense = React.useContext(SidebarSizeContext) === "sm";
388
- return (_jsx("div", { "data-slot": "sidebar-group-label", className: cn("overflow-hidden eyebrow whitespace-nowrap transition-[margin,opacity] duration-(--duration) ease-brand", "group-data-[collapsible=icon]/sidebar:pointer-events-none group-data-[collapsible=icon]/sidebar:opacity-0",
389
- // Fixed heights (line + padding) so the fold is exact: 16 + 8 = 24px, dense 14 + 6 = 20px.
390
- dense
391
- ? "px-2.5 pb-1.5 text-[11px] leading-[14px] group-data-[collapsible=icon]/sidebar:-mt-5"
392
- : "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 }));
393
419
  }
394
420
  function textOf(node) {
395
421
  if (typeof node === "string" || typeof node === "number")
@@ -428,7 +454,7 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
428
454
  },
429
455
  className: cn(
430
456
  // cursor-pointer: rows may render as a <button> (theme switch, account menu), which has no pointer by default.
431
- "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",
432
458
  // Hover is quieter than current: the label brightens (over the gliding fill with hover="glide"),
433
459
  // the row itself takes no fill, edge or shadow. The raised row means "you are here".
434
460
  "hover:not-aria-[current=page]:bg-transparent! hover:not-aria-[current=page]:bg-none! hover:not-aria-[current=page]:shadow-none!",
@@ -437,7 +463,10 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
437
463
  // While the current row glides (CurrentGlide), the old and new rows stay flat.
438
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 &&
439
465
  // A square in the icon rail with the 16px icon centred: (row - icon - border) / 2 a side.
440
- "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),
441
470
  children,
442
471
  },
443
472
  });
@@ -453,6 +482,36 @@ export function SidebarItem({ current, tooltip, render, ref, className, children
453
482
  export function SidebarMenuBadge({ className, ...props }) {
454
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 }));
455
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
+ }
456
515
  /* ── Controls ──────────────────────────────────────────────────────────────── */
457
516
  /**
458
517
  * The button that opens and closes the sidebar: a circular ghost icon button, usually first in
@@ -484,7 +543,7 @@ export function SidebarRail({ className, onClick, ...props }) {
484
543
  onClick?.(event);
485
544
  if (!event.defaultPrevented)
486
545
  toggleSidebar();
487
- }, 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",
488
547
  // On the edge next to the page: the end of a start sidebar, in either direction.
489
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",
490
549
  // The cursor points the way the panel will go: towards its edge to close, away to open.