@zonsh/ui 0.5.0 → 0.6.1

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 +643 -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
@@ -6,6 +6,17 @@ import { cn } from "../lib/cn.js";
6
6
  import { CopyButton } from "./copy-button.js";
7
7
  import { useMessages } from "./locale.js";
8
8
  const defaultMessages = { copy: "Copy code" };
9
+ /**
10
+ * The mask of the code under a floating copy button: all of it but the button's corner — the
11
+ * button (`--control-h-sm`) with its 12px inset above and to the right, and 8px before it.
12
+ */
13
+ const copyNotch = {
14
+ maskImage: "linear-gradient(#000, #000), linear-gradient(#000, #000)",
15
+ maskSize: "100% 100%, calc(var(--control-h-sm) + 1.25rem) calc(var(--control-h-sm) + 0.75rem)",
16
+ maskPosition: "0 0, top right",
17
+ maskRepeat: "no-repeat",
18
+ maskComposite: "exclude",
19
+ };
9
20
  /**
10
21
  * CodeBlock — source code in Licht Mono 13px, 1.75 line height, `white-space: pre`, tab size 2,
11
22
  * scrolling horizontally rather than wrapping. Give it a height or a max height and the code
@@ -18,8 +29,9 @@ const defaultMessages = { copy: "Copy code" };
18
29
  * people break: a theme of their own. Syntax colours are kinds of token, so they come from the
19
30
  * category tones (`--code-*`), never a palette brought in from an editor.
20
31
  */
21
- export function CodeBlock({ code, children, variant = "region", filename, language, lineNumbers = false, wrap = false, highlight = true, copyable = true, labels, className, ...props }) {
32
+ export function CodeBlock({ code, children, variant = "region", filename, language, lineNumbers = false, wrap = false, highlight = true, copyable = true, size: sizeProp, labels, className, ...props }) {
22
33
  const source = (code ?? children ?? "").replace(/\n$/, "");
34
+ const compact = sizeProp != null ? sizeProp === "sm" : filename == null && !lineNumbers && !source.includes("\n");
23
35
  const { tokens, pending } = useCodeTokens(source, language, highlight);
24
36
  const lines = React.useMemo(() => {
25
37
  if (!tokens)
@@ -37,17 +49,24 @@ export function CodeBlock({ code, children, variant = "region", filename, langua
37
49
  const widest = React.useMemo(() => chunked && !wrap
38
50
  ? source.split("\n").reduce((max, line) => Math.max(max, line.replace(/\t/g, " ").length), 0)
39
51
  : 0, [chunked, wrap, source]);
40
- const hasHeader = filename != null || language != null;
52
+ const hasHeader = !compact && (filename != null || language != null);
41
53
  const text = useMessages("codeBlock", defaultMessages);
42
- const copyButton = copyable && (_jsx(CopyButton, { value: source, labels: { ...labels, copy: labels?.copy ?? text.copy }, "data-slot": "code-block-copy", className: cn(!hasHeader && "absolute top-3 right-3 z-10") }));
43
- return (_jsxs("figure", { "data-slot": "code-block", "data-variant": variant, "data-highlighted": tokens ? "" : undefined, "data-highlight-pending": pending ? "" : undefined, className: cn("relative m-0 flex min-w-0 flex-col overflow-hidden text-foreground", variant === "card" ? "surface-card [--card-padding:0]" : "rounded-none surface-container", className), ...props, children: [hasHeader && (_jsxs("figcaption", { "data-slot": "code-block-header", className: cn("flex min-h-(--control-h) shrink-0 items-center justify-between gap-3 border-b border-border/60 ps-4",
54
+ const copyButton = copyable && (_jsx(CopyButton, { value: source, labels: { ...labels, copy: labels?.copy ?? text.copy }, "data-slot": "code-block-copy", className: cn(compact ? "me-2 shrink-0" : !hasHeader && "absolute top-3 right-3 z-10") }));
55
+ return (_jsxs("figure", { "data-slot": "code-block", "data-variant": variant, "data-size": compact ? "sm" : "default", "data-highlighted": tokens ? "" : undefined, "data-highlight-pending": pending ? "" : undefined, className: cn("relative m-0 flex min-w-0 overflow-hidden text-foreground",
56
+ // Compact: the line and the copy button in one row, the button 8px from the right edge and
57
+ // centred on the line.
58
+ compact ? "flex-row items-center" : "flex-col", variant === "card" ? "surface-card [--card-padding:0]" : "rounded-none surface-container", className), ...props, children: [hasHeader && (_jsxs("figcaption", { "data-slot": "code-block-header", className: cn("flex min-h-(--control-h) shrink-0 items-center justify-between gap-3 border-b border-border/(--hairline-opacity) ps-4",
44
59
  // With the copy button, the header is the button plus the same 8px above, below and
45
60
  // to the right, so the button sits as far from the top edge as from the right edge.
46
- copyable ? "py-2 pe-2" : "pe-4"), children: [_jsx("span", { className: "min-w-0 truncate eyebrow text-[11px] tracking-[0.12em] normal-case", children: filename }), _jsxs("span", { className: "flex shrink-0 items-center gap-3", children: [language && _jsx("span", { className: "eyebrow text-[11px]", children: language }), copyButton] })] })), !hasHeader && copyButton, _jsx("pre", { "data-slot": "code-block-pre",
61
+ copyable ? "py-2 pe-2" : "pe-4"), children: [_jsx("span", { className: "min-w-0 truncate eyebrow text-11 tracking-[0.12em] normal-case", children: filename }), _jsxs("span", { className: "flex shrink-0 items-center gap-3", children: [language && _jsx("span", { className: "eyebrow text-11", children: language }), copyButton] })] })), !hasHeader && !compact && copyButton, _jsx("pre", { "data-slot": "code-block-pre",
47
62
  // Code reads left to right on a right-to-left page too: its brackets and commas stay put.
48
63
  dir: "ltr", tabIndex: 0, className: cn(
49
64
  // A height or max height on the block scrolls the code under the header, both ways.
50
- "m-0 min-h-0 grow overflow-auto bg-transparent px-4 py-4 font-mono text-[13px] leading-[1.75] [tab-size:2] focus-ring", wrap ? "[overflow-wrap:anywhere] whitespace-pre-wrap" : "whitespace-pre", !hasHeader && copyable && "pr-14"), children: _jsx("code", { className: cn("font-[inherit]", chunked ? "block" : lineNumbers && "table min-w-full"),
65
+ "m-0 min-h-0 min-w-0 grow overflow-auto bg-transparent px-4 font-mono text-13 leading-[1.75] [tab-size:2] focus-ring", wrap ? "[overflow-wrap:anywhere] whitespace-pre-wrap" : "whitespace-pre", compact ? "py-3" : "py-4", !hasHeader && !compact && copyable && "pr-14"),
66
+ // The floating copy button keeps its corner of the scrolling area: a long first line is cut
67
+ // before the button and scrolls past beside it, never under it; the end padding lets the
68
+ // end of that line scroll clear of it.
69
+ style: !hasHeader && !compact && copyable ? copyNotch : undefined, children: _jsx("code", { className: cn("font-[inherit]", chunked ? "block" : lineNumbers && "table min-w-full"),
51
70
  // Chunks out of view are not laid out: the widest line keeps the width to scroll across.
52
71
  style: widest
53
72
  ? {
@@ -59,7 +78,7 @@ export function CodeBlock({ code, children, variant = "region", filename, langua
59
78
  ? lines.map((line, i) => (_jsxs("span", { className: "table-row", children: [_jsx("span", { "aria-hidden": true, className: "table-cell w-[1%] pr-5 text-right text-control-muted tabular-nums select-none", children: i + 1 }), _jsx("span", { className: "table-cell", children: isEmpty(line) ? "\n" : line })] }, i)))
60
79
  : tokens
61
80
  ? lines.map((line, i) => (_jsxs(React.Fragment, { children: [i > 0 && "\n", line] }, i)))
62
- : source }) })] }));
81
+ : source }) }), compact && copyButton] }));
63
82
  }
64
83
  const isEmpty = (line) => line === "" || (Array.isArray(line) && line.length === 0);
65
84
  /** Code longer than this many lines is drawn in chunks of CHUNK lines, each laid out only near the view. */
@@ -1,7 +1,7 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Collapsible as BaseCollapsible } from "@base-ui/react/collapsible";
4
- import { ChevronRightIcon } from "lucide-react";
4
+ import { ChevronRightIcon } from "../lib/icons.js";
5
5
  import { sx, triggerSlot } from "../lib/cn.js";
6
6
  /**
7
7
  * Collapsible — one region that can be shown and hidden by a trigger.
@@ -19,8 +19,8 @@ export function Collapsible({ className, ...props }) {
19
19
  /** A mono text trigger with a rotating chevron. Use `render` to swap in a `Button`. */
20
20
  export function CollapsibleTrigger({ showIcon = true, className, children, ...props }) {
21
21
  return (_jsxs(BaseCollapsible.Trigger, { ...triggerSlot("collapsible-trigger", props.render), className: sx([
22
- "group/collapsible-trigger inline-flex w-fit cursor-pointer items-center gap-2 py-1 font-mono text-[13px] text-foreground-soft focus-ring select-none",
23
- "transition-colors duration-(--duration) ease-(--ease) hover:text-foreground data-panel-open:text-foreground",
22
+ "group/collapsible-trigger inline-flex w-fit cursor-pointer items-center gap-2 py-1 font-mono text-13 text-foreground-soft focus-ring select-none",
23
+ "transition-colors duration-(--duration-fade) ease-(--ease) hover:text-foreground data-panel-open:text-foreground",
24
24
  "data-disabled:pointer-events-none data-disabled:opacity-50",
25
25
  ], className), ...props, children: [showIcon && (_jsx(ChevronRightIcon, { "aria-hidden": true,
26
26
  // Points along the line of reading: mirrored right to left, and down once open.
@@ -19,7 +19,7 @@ export interface ColorPickerMessages {
19
19
  placeholder: string;
20
20
  }
21
21
  declare module "./locale" {
22
- interface Messages {
22
+ interface LocaleMessages {
23
23
  colorPicker: ColorPickerMessages;
24
24
  }
25
25
  }
@@ -67,7 +67,7 @@ export interface ColorSwatchProps extends React.ComponentProps<"span"> {
67
67
  export declare function ColorSwatch({ color, className, style, ...props }: ColorSwatchProps): React.JSX.Element;
68
68
  declare const triggerSizes: {
69
69
  readonly sm: "min-h-(--control-h-sm) gap-2 px-2.5 text-xs";
70
- readonly default: "min-h-(--control-h) gap-2.5 px-2.5 text-[13px]";
70
+ readonly default: "min-h-(--control-h) gap-2.5 px-2.5 text-13";
71
71
  };
72
72
  export interface ColorPickerProps extends Pick<ColorPickerPanelProps, "value" | "defaultValue" | "onValueChange" | "format" | "alpha" | "presets" | "disabled" | "labels"> {
73
73
  /** `sm` (30px) for dense surfaces; `default` (38px) everywhere else. */
@@ -2,7 +2,7 @@
2
2
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { DirectionProvider } from "@base-ui/react/direction-provider";
4
4
  import { Field as BaseField } from "@base-ui/react/field";
5
- import { CheckIcon, ChevronsUpDownIcon } from "lucide-react";
5
+ import { CheckIcon, ChevronsUpDownIcon } from "../lib/icons.js";
6
6
  import * as React from "react";
7
7
  import { cn, sx } from "../lib/cn.js";
8
8
  import { Input } from "./input.js";
@@ -244,7 +244,7 @@ function ColorArea({ color, onChange, disabled, label, text }) {
244
244
  }, onPointerMove: (event) => {
245
245
  if (event.currentTarget.hasPointerCapture(event.pointerId))
246
246
  move(event);
247
- }, children: [_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-0 rounded-item border border-control-edge shadow-field" }), _jsx("div", { ref: thumb, role: "slider", tabIndex: disabled ? -1 : 0, "aria-label": label, "aria-roledescription": text.areaRole, "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": saturation, "aria-valuetext": text.areaValue(saturation, brightness), "aria-disabled": disabled || undefined, "data-slot": "color-picker-area-thumb", onKeyDown: disabled ? undefined : onKeyDown, className: cn("absolute size-[18px] -translate-x-1/2 -translate-y-1/2 cursor-grab rounded-full border-2 border-white shadow-thumb forced-color-adjust-auto active:cursor-grabbing", "focus-visible:outline-2 focus-visible:outline-offset-0 focus-visible:outline-control-focus", disabled && "cursor-not-allowed"), style: {
247
+ }, children: [_jsx("span", { "aria-hidden": true, className: "pointer-events-none absolute inset-0 rounded-item border border-control-edge shadow-field" }), _jsx("div", { ref: thumb, role: "slider", tabIndex: disabled ? -1 : 0, "aria-label": label, "aria-roledescription": text.areaRole, "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": saturation, "aria-valuetext": text.areaValue(saturation, brightness), "aria-disabled": disabled || undefined, "data-slot": "color-picker-area-thumb", onKeyDown: disabled ? undefined : onKeyDown, className: cn("absolute size-(--slider-thumb) -translate-x-1/2 -translate-y-1/2 cursor-grab rounded-full border-2 border-white shadow-thumb forced-color-adjust-auto active:cursor-grabbing", "focus-visible:outline-(length:--focus-width) focus-visible:outline-offset-0 focus-visible:outline-control-focus", disabled && "cursor-not-allowed"), style: {
248
248
  // Rounded: read from oklch(), the server's maths and the browser's can differ in the
249
249
  // last digits, and the page would not hydrate.
250
250
  left: `${round(color.s * 100, 2)}%`,
@@ -312,7 +312,7 @@ function PanelBody({ color, text, onColorChange, format = "hex", alpha = false,
312
312
  return (_jsxs("div", { "data-slot": "color-picker-panel", className: cn("flex w-full min-w-0 flex-col gap-3", className), ...props, children: [_jsx(ColorArea, { color: color, onChange: onColorChange, disabled: disabled, label: messages.area, text: messages }), _jsx(DirectionProvider, { direction: "ltr", children: _jsxs("div", { dir: "ltr", className: "flex flex-col gap-2", children: [_jsx(OwnField, { children: _jsx(Slider, { "data-slot": "color-picker-hue", min: 0, max: 360, step: 1, thumbAlignment: "edge", value: Math.round(color.h), onValueChange: (h) => onColorChange({ ...color, h }), thumbLabels: [messages.hue], disabled: disabled, className: paintedSlider, style: {
313
313
  "--color-picker-track": hueTrack,
314
314
  "--color-picker-thumb": `hsl(${hue} 100% 50%)`,
315
- } }) }), alpha && (_jsx(OwnField, { children: _jsx(Slider, { "data-slot": "color-picker-alpha", min: 0, max: 1, step: 0.01, thumbAlignment: "edge", value: color.a, onValueChange: (a) => onColorChange({ ...color, a }), format: { style: "percent" }, thumbLabels: [messages.alpha], disabled: disabled, className: paintedSlider, style: {
315
+ } }) }), alpha && (_jsx(OwnField, { children: _jsx(Slider, { "data-slot": "color-picker-alpha", min: 0, max: 1, step: 0.01, largeStep: 0.1, thumbAlignment: "edge", value: color.a, onValueChange: (a) => onColorChange({ ...color, a }), format: { style: "percent" }, thumbLabels: [messages.alpha], disabled: disabled, className: paintedSlider, style: {
316
316
  "--color-picker-track": `linear-gradient(to right, transparent, ${opaque}), ${checker}`,
317
317
  "--color-picker-thumb": `linear-gradient(${cssColor(color)}, ${cssColor(color)}), ${checker}`,
318
318
  } }) }))] }) }), _jsx(OwnField, { children: _jsx(Input, { size: "sm", "data-slot": "color-picker-input", "aria-label": labels?.input ?? messages.value(format), "aria-invalid": invalid || undefined, spellCheck: false, autoComplete: "off", disabled: disabled, value: draft, onChange: (event) => {
@@ -363,7 +363,7 @@ export function ColorSwatch({ color, className, style, ...props }) {
363
363
  /* ── ColorPicker ────────────────────────────────────────────────────────────── */
364
364
  const triggerSizes = {
365
365
  sm: "min-h-(--control-h-sm) gap-2 px-2.5 text-xs",
366
- default: "min-h-(--control-h) gap-2.5 px-2.5 text-[13px]",
366
+ default: "min-h-(--control-h) gap-2.5 px-2.5 text-13",
367
367
  };
368
368
  /**
369
369
  * ColorPicker — a recessed trigger like a `Select` trigger, with a swatch and the value in Licht
@@ -418,7 +418,7 @@ export function ColorPicker({ value, defaultValue, onValueChange, format = "hex"
418
418
  "aria-label": ariaLabel,
419
419
  "aria-labelledby": ariaLabelledBy,
420
420
  "aria-describedby": ariaDescribedBy,
421
- }).filter(([, v]) => v !== undefined)), className: cn("group/trigger inline-flex w-full min-w-40 material-field cursor-pointer items-center rounded-control text-start font-mono leading-none whitespace-nowrap tabular-nums outline-none select-none", "disabled:cursor-not-allowed disabled:opacity-55", triggerSizes[size], className), children: [_jsx(ColorSwatch, { color: empty ? "transparent" : cssColor(state.color), className: size === "sm" ? "size-4" : "size-5" }), _jsx("span", { id: valueId, "data-slot": "color-picker-value", className: cn("flex-1 truncate", empty && "text-control-muted"), children: empty ? (placeholder ?? text.placeholder) : state.text }), _jsx(ChevronsUpDownIcon, { "aria-hidden": true, className: "size-4 shrink-0 text-muted-foreground transition-colors duration-(--duration) ease-brand group-hover/trigger:not-group-data-disabled/trigger:text-foreground" })] }), _jsx(PopoverContent, { align: "start", ...popover, "data-slot": "color-picker-content", className: sx("p-3", popover?.className), onBlur: (event) => {
421
+ }).filter(([, v]) => v !== undefined)), className: cn("group/trigger inline-flex w-full min-w-40 material-field cursor-pointer items-center rounded-control text-start font-mono leading-none whitespace-nowrap tabular-nums outline-none select-none", "disabled:cursor-not-allowed disabled:opacity-55", triggerSizes[size], className), children: [_jsx(ColorSwatch, { color: empty ? "transparent" : cssColor(state.color), className: size === "sm" ? "size-4" : "size-5" }), _jsx("span", { id: valueId, "data-slot": "color-picker-value", className: cn("flex-1 truncate", empty && "text-control-muted"), children: empty ? (placeholder ?? text.placeholder) : state.text }), _jsx(ChevronsUpDownIcon, { "aria-hidden": true, className: "size-4 shrink-0 text-muted-foreground transition-colors duration-(--duration-fade) ease-(--ease) group-hover/trigger:not-group-data-disabled/trigger:text-foreground" })] }), _jsx(PopoverContent, { align: "start", ...popover, "data-slot": "color-picker-content", className: sx("p-3", popover?.className), onBlur: (event) => {
422
422
  popover?.onBlur?.(event);
423
423
  // Out of the panel, and not back to the trigger: the field is left.
424
424
  const to = event.relatedTarget;
@@ -7,9 +7,11 @@ export interface ComboboxMessages {
7
7
  showOptions: string;
8
8
  /** A chip's remove button, by the chip's text when it is a string. */
9
9
  remove: (label?: string) => string;
10
+ /** ComboboxStatus while `loading`, when it has no text of its own. */
11
+ loading: string;
10
12
  }
11
13
  declare module "./locale" {
12
- interface Messages {
14
+ interface LocaleMessages {
13
15
  combobox: ComboboxMessages;
14
16
  }
15
17
  }
@@ -23,8 +25,8 @@ declare module "./locale" {
23
25
  */
24
26
  export declare function Combobox<Value, Multiple extends boolean | undefined = false, Item = Value>({ inputRef, onItemHighlighted, ...props }: BaseCombobox.Root.Props<Value, Multiple, Item>): React.JSX.Element;
25
27
  declare const groupSizes: {
26
- readonly sm: "min-h-(--control-h-sm) gap-0.5 py-0.5 ps-2.5 pe-0.5 text-[13px]";
27
- readonly default: "min-h-(--control-h) gap-0.5 py-[3px] ps-3.5 pe-[3px] text-base sm:text-[15px]";
28
+ readonly sm: "min-h-(--control-h-sm) gap-0.5 py-0.5 ps-2.5 pe-0.5 text-13 pointer-coarse:text-base";
29
+ readonly default: "min-h-(--control-h) gap-0.5 py-[3px] ps-3.5 pe-[3px] text-base sm:text-15";
28
30
  };
29
31
  export interface ComboboxInputProps extends Omit<BaseCombobox.Input.Props, "size" | "className"> {
30
32
  /** `sm` (30px) for dense surfaces; `default` (38px) everywhere else. */
@@ -57,13 +59,13 @@ export interface ComboboxChipsProps<Value = any> extends Omit<BaseCombobox.Chips
57
59
  export declare function ComboboxChips<Value = any>({ className, children, ...props }: ComboboxChipsProps<Value>): React.JSX.Element;
58
60
  export interface ComboboxChipProps extends BaseCombobox.Chip.Props {
59
61
  /**
60
- * Accessible name for the remove button. Defaults to "Remove {label}" for string children
61
- * (`messages.combobox.remove`).
62
+ * The remove button's name, by the chip's text when it is a string: `remove`. Defaults to
63
+ * "Remove {label}", or `messages.combobox.remove` from a LocaleProvider.
62
64
  */
63
- removeLabel?: string;
65
+ labels?: Partial<Pick<ComboboxMessages, "remove">>;
64
66
  }
65
67
  /** ComboboxChip — one selected value, with a remove button. */
66
- export declare function ComboboxChip({ className, children, removeLabel, ...props }: ComboboxChipProps): React.JSX.Element;
68
+ export declare function ComboboxChip({ className, children, labels, ...props }: ComboboxChipProps): React.JSX.Element;
67
69
  export interface ComboboxContentProps extends BaseCombobox.Popup.Props {
68
70
  /** Positioner props: side, align, sideOffset, collisionPadding … */
69
71
  positioner?: Omit<BaseCombobox.Positioner.Props, "children">;
@@ -90,6 +92,23 @@ export declare function ComboboxItem({ className, children, ...props }: BaseComb
90
92
  * ("No service matches. Try a broader word."), not just "No results".
91
93
  */
92
94
  export declare function ComboboxEmpty({ className, ...props }: BaseCombobox.Empty.Props): React.JSX.Element;
95
+ export interface ComboboxStatusProps extends BaseCombobox.Status.Props {
96
+ /**
97
+ * Results are on their way: a small spinner before the text, which is "Loading…" (or
98
+ * `messages.combobox.loading`) when the status has none of its own. Put `aria-busy` on the
99
+ * `ComboboxContent` for the same time.
100
+ */
101
+ loading?: boolean;
102
+ /** The text while loading with no children of its own (`loading`); a LocaleProvider sets it for every Combobox. */
103
+ labels?: Partial<Pick<ComboboxMessages, "loading">>;
104
+ }
105
+ /**
106
+ * ComboboxStatus — a line above the list that screen readers announce politely as it changes:
107
+ * "Searching…" while results load, a hint before anything is typed, or how many were found. It
108
+ * stays mounted; change what it says, and give it no children when there is nothing to say.
109
+ * For "nothing matches", use `ComboboxEmpty`.
110
+ */
111
+ export declare function ComboboxStatus({ loading, labels, className, children, ...props }: ComboboxStatusProps): React.JSX.Element;
93
112
  /** ComboboxGroup — a labelled section. Pair with `<ComboboxGroupLabel>` and `<ComboboxCollection>`. */
94
113
  export declare function ComboboxGroup({ className, ...props }: BaseCombobox.Group.Props): React.JSX.Element;
95
114
  export declare function ComboboxGroupLabel({ className, ...props }: BaseCombobox.GroupLabel.Props): React.JSX.Element;
@@ -2,7 +2,7 @@
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Combobox as BaseCombobox } from "@base-ui/react/combobox";
4
4
  import { useVirtualizer } from "@tanstack/react-virtual";
5
- import { CheckIcon, ChevronsUpDownIcon, XIcon } from "lucide-react";
5
+ import { CheckIcon, ChevronsUpDownIcon, XIcon } from "../lib/icons.js";
6
6
  import * as React from "react";
7
7
  import { cn, sx } from "../lib/cn.js";
8
8
  import { useFormReset } from "../lib/form-reset.js";
@@ -10,10 +10,13 @@ import { mergeRefs } from "../lib/merge-refs.js";
10
10
  import { usePopupDir } from "./_overlay.js";
11
11
  import { useMessages } from "./locale.js";
12
12
  import { ScrollArea } from "./scroll-area.js";
13
+ import { usePortalContainer } from "../lib/portal-container.js";
14
+ import { Spinner } from "./spinner.js";
13
15
  const defaultMessages = {
14
16
  clear: "Clear selection",
15
17
  showOptions: "Show options",
16
18
  remove: (label) => (label ? `Remove ${label}` : "Remove"),
19
+ loading: "Loading…",
17
20
  };
18
21
  /**
19
22
  * Combobox — a `Select` you can type into: the input filters a fixed list of options.
@@ -47,7 +50,7 @@ export function Combobox({ inputRef, onItemHighlighted, ...props }) {
47
50
  if (reason === "none" || (reason === "keyboard" && edge))
48
51
  queueMicrotask(() => virtualizer.scrollToIndex(index, { align: edge && index > 0 ? "start" : "auto" }));
49
52
  };
50
- return (_jsx(VirtualContext.Provider, { value: virtual ? virtualizerRef : null, children: _jsx(BaseCombobox.Root, { inputRef: refs, virtualized: virtual || undefined, onItemHighlighted: highlighted, ...props }, resetKey) }));
53
+ return (_jsx(VirtualContext.Provider, { value: virtual ? virtualizerRef : null, children: _jsx(BaseCombobox.Root, { inputRef: refs, virtualized: virtual || undefined, onItemHighlighted: highlighted, ...props, ...(props.readOnly ? { open: false } : {}) }, resetKey) }));
51
54
  }
52
55
  /** Flat lists of more options than this render only those in view. */
53
56
  const VIRTUAL_FROM = 200;
@@ -57,8 +60,8 @@ const VirtualContext = React.createContext(null);
57
60
  const ChipsContext = React.createContext(false);
58
61
  const fieldGroup = "flex w-full items-center rounded-control material-field font-body";
59
62
  const groupSizes = {
60
- sm: "min-h-(--control-h-sm) gap-0.5 py-0.5 ps-2.5 pe-0.5 text-[13px]",
61
- default: "min-h-(--control-h) gap-0.5 py-[3px] ps-3.5 pe-[3px] text-base sm:text-[15px]",
63
+ sm: "min-h-(--control-h-sm) gap-0.5 py-0.5 ps-2.5 pe-0.5 text-13 pointer-coarse:text-base",
64
+ default: "min-h-(--control-h) gap-0.5 py-[3px] ps-3.5 pe-[3px] text-base sm:text-15",
62
65
  };
63
66
  const iconButtonSizes = {
64
67
  sm: "size-(--control-inset-sm)",
@@ -73,9 +76,11 @@ export function ComboboxInput({ size = "default", showTrigger = true, showClear
73
76
  const inChips = React.useContext(ChipsContext);
74
77
  const text = useMessages("combobox", defaultMessages, labels);
75
78
  if (inChips) {
76
- return (_jsx(BaseCombobox.Input, { "data-slot": "combobox-input", className: cn("min-h-(--control-h-sm) min-w-16 flex-1 bg-transparent px-1.5 text-base outline-none placeholder:text-control-muted sm:text-[15px]", className), ...props }));
79
+ return (_jsx(BaseCombobox.Input, { "data-slot": "combobox-input", className: cn("h-(--control-inset) min-w-16 flex-1 bg-transparent px-1.5 text-base outline-none placeholder:text-control-muted sm:text-15", className), ...props }));
77
80
  }
78
- return (_jsxs(BaseCombobox.InputGroup, { "data-slot": "combobox-input-group", "data-size": size, className: cn(fieldGroup, groupSizes[size], className), children: [_jsx(BaseCombobox.Input, { "data-slot": "combobox-input", className: "min-w-0 flex-1 self-stretch bg-transparent outline-none placeholder:text-control-muted", ...props }), showClear && (_jsx(BaseCombobox.Clear, { "data-slot": "combobox-clear", "aria-label": text.clear, className: cn(iconButton, iconButtonSizes[size]), children: _jsx(XIcon, {}) })), showTrigger && (_jsx(BaseCombobox.Trigger, { "data-slot": "combobox-trigger", "aria-label": text.showOptions, "aria-labelledby": undefined, className: cn(iconButton, iconButtonSizes[size]), children: _jsx(ChevronsUpDownIcon, {}) }))] }));
81
+ return (_jsxs(BaseCombobox.InputGroup, { "data-slot": "combobox-input-group", "data-size": size, className: cn(fieldGroup, groupSizes[size], className), children: [_jsx(BaseCombobox.Input, { "data-slot": "combobox-input", className: "min-w-0 flex-1 self-stretch bg-transparent outline-none placeholder:text-control-muted", ...props }), showClear && (_jsx(BaseCombobox.Clear, { "data-slot": "combobox-clear", "aria-label": text.clear, className: cn(iconButton, iconButtonSizes[size], "in-data-readonly:hidden"), children: _jsx(XIcon, {}) })), showTrigger && (_jsx(BaseCombobox.Trigger, { "data-slot": "combobox-trigger", "aria-label": text.showOptions, "aria-labelledby": undefined,
82
+ // Read-only, nothing opens: the field is a value to read, with no button to press.
83
+ className: cn(iconButton, iconButtonSizes[size], "in-data-readonly:hidden"), children: _jsx(ChevronsUpDownIcon, {}) }))] }));
79
84
  }
80
85
  /**
81
86
  * ComboboxChips — the field for a `multiple` combobox: selected values as raised 30px chips,
@@ -85,21 +90,25 @@ export function ComboboxChips({ className, children, ...props }) {
85
90
  return (_jsx(ChipsContext.Provider, { value: true, children: _jsx(BaseCombobox.InputGroup, { "data-slot": "combobox-chips-group", className: cn(fieldGroup, "min-h-(--control-h) cursor-text p-[3px]"), children: _jsx(BaseCombobox.Chips, { "data-slot": "combobox-chips", className: sx("flex w-full flex-wrap items-center gap-[3px]", className), ...props, children: typeof children === "function" ? (_jsx(BaseCombobox.Value, { children: (value) => children(value) })) : (children) }) }) }));
86
91
  }
87
92
  /** ComboboxChip — one selected value, with a remove button. */
88
- export function ComboboxChip({ className, children, removeLabel, ...props }) {
89
- const text = useMessages("combobox", defaultMessages);
90
- const label = removeLabel ?? text.remove(typeof children === "string" ? children : undefined);
93
+ export function ComboboxChip({ className, children, labels, ...props }) {
94
+ const text = useMessages("combobox", defaultMessages, labels);
95
+ const label = text.remove(typeof children === "string" ? children : undefined);
91
96
  return (_jsxs(BaseCombobox.Chip, { "data-slot": "combobox-chip", className: sx([
92
- "inline-flex min-h-(--control-h-sm) max-w-full cursor-default items-center gap-1 rounded-item border border-transparent ps-2.5 pe-[3px] text-[13px] leading-none font-medium text-foreground",
97
+ "inline-flex min-h-(--control-inset) max-w-full cursor-default items-center gap-1 rounded-item border border-transparent ps-2.5 pe-[3px] text-13 leading-none font-medium text-foreground pointer-coarse:overflow-clip",
93
98
  "bg-control-surface bg-linear-to-b from-control-inner-edge to-transparent shadow-raised",
94
- ], className), ...props, children: [_jsx("span", { className: "truncate", children: children }), _jsx(BaseCombobox.ChipRemove, { "data-slot": "combobox-chip-remove", "aria-label": label, className: "inline-flex size-(--control-inset-sm) shrink-0 cursor-pointer items-center justify-center rounded-full text-muted-foreground transition-[background-color,color] duration-(--duration) ease-brand hover:bg-control-hover hover:text-foreground [&_svg]:size-3.5", children: _jsx(XIcon, {}) })] }));
99
+ ], className), ...props, children: [_jsx("span", { className: "truncate", children: children }), _jsx(BaseCombobox.ChipRemove, { "data-slot": "combobox-chip-remove", "aria-label": label, className: "touch-target inline-flex size-(--control-inset-sm) shrink-0 cursor-pointer items-center justify-center rounded-full text-muted-foreground transition-[background-color,color] duration-(--duration-fade) ease-(--ease) hover:bg-control-hover hover:text-foreground [&_svg]:size-3.5", children: _jsx(XIcon, {}) })] }));
95
100
  }
96
101
  /**
97
102
  * ComboboxContent — the popup: menu material, 12px corners, as wide as the field. Place
98
103
  * `<ComboboxEmpty>` and `<ComboboxList>` inside it.
99
104
  */
100
105
  export function ComboboxContent({ className, children, positioner, dir, ...props }) {
106
+ const portalContainer = usePortalContainer();
101
107
  const popupDir = usePopupDir(dir);
102
- return (_jsx(BaseCombobox.Portal, { children: _jsx(BaseCombobox.Positioner, { sideOffset: 6, dir: popupDir, ...positioner, className: "z-50 outline-none", children: _jsx(BaseCombobox.Popup, { "data-slot": "combobox-content", className: sx("w-(--anchor-width) max-w-(--available-width) popup-motion overflow-hidden rounded-button material-menu p-1 font-body outline-none", className), ...props, children: children }) }) }));
108
+ return (_jsx(BaseCombobox.Portal, { container: portalContainer, children: _jsx(BaseCombobox.Positioner, { sideOffset: 6, dir: popupDir, ...positioner, className: "z-50 outline-none", children: _jsx(BaseCombobox.Popup, { "data-slot": "combobox-content", className: sx(
109
+ // No taller than the room on its side: with a search field above the list (PhoneInput, FilterBar),
110
+ // the list gives up the height, not the top of the popup.
111
+ "flex max-h-(--available-height) w-(--anchor-width) max-w-(--available-width) popup-motion flex-col overflow-hidden rounded-button material-menu p-1 font-body outline-none", className), ...props, children: children }) }) }));
103
112
  }
104
113
  export function ComboboxList({ className, children, ...props }) {
105
114
  const virtual = React.useContext(VirtualContext);
@@ -158,12 +167,22 @@ export function ComboboxItem({ className, children, ...props }) {
158
167
  export function ComboboxEmpty({ className, ...props }) {
159
168
  return (_jsx(BaseCombobox.Empty, { "data-slot": "combobox-empty", className: sx("px-2.5 py-2.5 text-sm text-muted-foreground empty:p-0", className), ...props }));
160
169
  }
170
+ /**
171
+ * ComboboxStatus — a line above the list that screen readers announce politely as it changes:
172
+ * "Searching…" while results load, a hint before anything is typed, or how many were found. It
173
+ * stays mounted; change what it says, and give it no children when there is nothing to say.
174
+ * For "nothing matches", use `ComboboxEmpty`.
175
+ */
176
+ export function ComboboxStatus({ loading = false, labels, className, children, ...props }) {
177
+ const text = useMessages("combobox", defaultMessages, labels);
178
+ return (_jsxs(BaseCombobox.Status, { "data-slot": "combobox-status", "data-loading": loading ? "" : undefined, className: sx("flex items-center gap-2 px-2.5 py-2.5 text-sm text-muted-foreground empty:p-0", className), ...props, children: [loading && _jsx(Spinner, { size: "sm", "aria-hidden": true }), loading ? (children ?? text.loading) : children] }));
179
+ }
161
180
  /** ComboboxGroup — a labelled section. Pair with `<ComboboxGroupLabel>` and `<ComboboxCollection>`. */
162
181
  export function ComboboxGroup({ className, ...props }) {
163
182
  return (_jsx(BaseCombobox.Group, { "data-slot": "combobox-group", className: sx("not-last:pb-1", className), ...props }));
164
183
  }
165
184
  export function ComboboxGroupLabel({ className, ...props }) {
166
- return (_jsx(BaseCombobox.GroupLabel, { "data-slot": "combobox-group-label", className: sx("px-2.5 pt-2.5 pb-1.5 eyebrow text-[11px] [overflow-wrap:anywhere]", className), ...props }));
185
+ return (_jsx(BaseCombobox.GroupLabel, { "data-slot": "combobox-group-label", className: sx("px-2.5 pt-2.5 pb-1.5 eyebrow text-11 [overflow-wrap:anywhere]", className), ...props }));
167
186
  }
168
187
  /** ComboboxCollection — renders a group's filtered items (function child), inside `<ComboboxGroup>`. */
169
188
  export const ComboboxCollection = BaseCombobox.Collection;
@@ -12,9 +12,11 @@ export interface CommandMessages {
12
12
  /** The footer's hints, after ↑ ↓ and ↵. */
13
13
  navigate: string;
14
14
  open: string;
15
+ /** CommandStatus while results are loading. */
16
+ loading: string;
15
17
  }
16
18
  declare module "./locale" {
17
- interface Messages {
19
+ interface LocaleMessages {
18
20
  command: CommandMessages;
19
21
  }
20
22
  }
@@ -64,6 +66,14 @@ export interface CommandDialogProps extends Pick<BaseDialog.Root.Props, "open" |
64
66
  emptyMessage?: React.ReactNode;
65
67
  /** The palette's words, for its parts too; a LocaleProvider sets them for every palette. */
66
68
  labels?: Partial<CommandMessages>;
69
+ /**
70
+ * Results are on their way (from a server, an index that loads): a "Searching…" row with a
71
+ * spinner above the list, announced politely, the palette `aria-busy`, and no "Nothing matches"
72
+ * until it settles. Fetch in `onQueryChange` and pass what comes back as `items`.
73
+ */
74
+ loading?: boolean;
75
+ /** Called with the search text as it is typed — and with "" when the palette closes. */
76
+ onQueryChange?: (query: string) => void;
67
77
  /** An element that opens the palette, e.g. `<Button variant="secondary" />`. */
68
78
  trigger?: React.ReactElement;
69
79
  /** Replace the default input / list / footer composition with your own command parts. */
@@ -79,10 +89,11 @@ export interface CommandDialogProps extends Pick<BaseDialog.Root.Props, "open" |
79
89
  * The rule people break: making the palette the only way to reach something. It is a shortcut;
80
90
  * every entry must also be reachable from the visible navigation.
81
91
  */
82
- export declare function CommandDialog({ items, filter, label, placeholder, emptyMessage, labels, trigger, children, className, onOpenChangeComplete, ...rootProps }: CommandDialogProps): React.JSX.Element;
92
+ export declare function CommandDialog({ items, filter, label, placeholder, emptyMessage, labels, trigger, children, className, loading, onQueryChange, onOpenChangeComplete, ...rootProps }: CommandDialogProps): React.JSX.Element;
83
93
  /**
84
94
  * The search field: borderless, 46px, a search icon before it and an `Esc` hint after it.
85
- * The hint is the palette's close button, so touch and screen-reader users have one too.
95
+ * The hint is the palette's close button, so touch and screen-reader users have one too; on a
96
+ * touch-only phone or tablet, where there is no Esc to press, it is a round × instead.
86
97
  */
87
98
  export declare function CommandInput({ className, ...props }: BaseAutocomplete.Input.Props): React.JSX.Element;
88
99
  /**
@@ -118,10 +129,23 @@ export interface CommandItemProps extends Omit<BaseAutocomplete.Item.Props, "val
118
129
  * unless you pass children.
119
130
  */
120
131
  export declare function CommandItem({ value, onItemSelect, closeOnSelect, className, children, onClick, ...props }: CommandItemProps): React.JSX.Element;
132
+ export interface CommandStatusProps extends BaseAutocomplete.Status.Props {
133
+ /** Results are loading: a spinner and "Searching…" (`labels.loading`), unless it has children. */
134
+ loading?: boolean;
135
+ }
136
+ /**
137
+ * A status row above the results, announced politely: "Searching…" with a spinner while results
138
+ * load, or your own words. Stays mounted (it is a live region); only what it says changes, and
139
+ * with nothing to say it takes no room. `CommandDialog` renders one for its `loading` prop.
140
+ */
141
+ export declare function CommandStatus({ loading, className, children, ...props }: CommandStatusProps): React.JSX.Element;
121
142
  /** Shown when nothing matches. Stays mounted (it is a live region); only its children toggle. */
122
143
  export declare function CommandEmpty({ className, ...props }: BaseAutocomplete.Empty.Props): React.JSX.Element;
123
- /** Keyboard hints along the bottom edge: "↑↓ navigate · ↵ open". */
124
- export declare function CommandFooter({ className, children, ...props }: React.ComponentProps<"div">): React.JSX.Element;
144
+ /**
145
+ * Keyboard hints along the bottom edge: "↑↓ navigate · ↵ open". Without children it renders
146
+ * nothing on a touch-only phone or tablet, where no key can be pressed.
147
+ */
148
+ export declare function CommandFooter({ className, children, ...props }: React.ComponentProps<"div">): React.JSX.Element | null;
125
149
  /**
126
150
  * useCommandShortcut — call `onOpen` on ⌘K (macOS) or Ctrl+K (elsewhere).
127
151
  *
@@ -2,14 +2,16 @@
2
2
  import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { Autocomplete as BaseAutocomplete } from "@base-ui/react/autocomplete";
4
4
  import { Dialog as BaseDialog } from "@base-ui/react/dialog";
5
- import { SearchIcon } from "lucide-react";
5
+ import { SearchIcon, XIcon } from "../lib/icons.js";
6
6
  import * as React from "react";
7
7
  import { cn, sx } from "../lib/cn.js";
8
- import { modPressed } from "../lib/platform.js";
8
+ import { modPressed, useShortcutKeys } from "../lib/platform.js";
9
9
  import { ScrollArea } from "./scroll-area.js";
10
10
  import { Kbd, kbdClassName } from "./kbd.js";
11
11
  import { overlayBackdrop, overlayCard, usePopupDir } from "./_overlay.js";
12
12
  import { useMessages } from "./locale.js";
13
+ import { usePortalContainer } from "../lib/portal-container.js";
14
+ import { Spinner } from "./spinner.js";
13
15
  const defaultMessages = {
14
16
  label: "Search",
15
17
  placeholder: "Search pages and actions…",
@@ -17,6 +19,7 @@ const defaultMessages = {
17
19
  close: "Close search",
18
20
  navigate: "navigate",
19
21
  open: "open",
22
+ loading: "Searching…",
20
23
  };
21
24
  /** Group a flat list by `group`, keeping first-seen order. */
22
25
  function groupEntries(entries) {
@@ -154,7 +157,8 @@ const useCommandText = () => useMessages("command", defaultMessages, React.useCo
154
157
  * The rule people break: making the palette the only way to reach something. It is a shortcut;
155
158
  * every entry must also be reachable from the visible navigation.
156
159
  */
157
- export function CommandDialog({ items, filter, label, placeholder, emptyMessage, labels, trigger, children, className, onOpenChangeComplete, ...rootProps }) {
160
+ export function CommandDialog({ items, filter, label, placeholder, emptyMessage, labels, trigger, children, className, loading = false, onQueryChange, onOpenChangeComplete, ...rootProps }) {
161
+ const portalContainer = usePortalContainer();
158
162
  const text = useMessages("command", defaultMessages, labels);
159
163
  const actionsRef = React.useRef(null);
160
164
  const [query, setQuery] = React.useState("");
@@ -163,23 +167,29 @@ export function CommandDialog({ items, filter, label, placeholder, emptyMessage,
163
167
  // Closing through Base UI's imperative action keeps controlled and uncontrolled use working:
164
168
  // onOpenChange fires with reason "imperative-action".
165
169
  const context = React.useMemo(() => ({ close: () => actionsRef.current?.close(), labels }), [labels]);
170
+ const search = (next) => {
171
+ setQuery(next);
172
+ onQueryChange?.(next);
173
+ };
166
174
  const popupDir = usePopupDir();
167
175
  return (_jsxs(BaseDialog.Root, { actionsRef: actionsRef, onOpenChangeComplete: (open) => {
168
176
  // Every opening starts from an empty search. Cleared once the palette has closed — also
169
177
  // when its owner closes it through `open` — so the results don't flash back while it
170
178
  // fades, and a close the owner refuses keeps what was typed.
171
179
  if (!open)
172
- setQuery("");
180
+ search("");
173
181
  onOpenChangeComplete?.(open);
174
- }, ...rootProps, children: [trigger && _jsx(BaseDialog.Trigger, { render: trigger }), _jsxs(BaseDialog.Portal, { children: [_jsx(BaseDialog.Backdrop, { "data-slot": "command-backdrop", className: cn(overlayBackdrop, "transition-none") }), _jsx(BaseDialog.Viewport, { "data-slot": "command-viewport", className: "fixed inset-0 z-50 flex items-start justify-center px-4 pt-[12dvh] pb-4 sm:pt-[16dvh]", children: _jsx(BaseDialog.Popup, { "data-slot": "command-dialog", "aria-label": label ?? text.label, dir: popupDir, className: cn("relative flex max-h-[min(34rem,calc(84dvh-1rem))] w-full max-w-[40rem] flex-col overflow-hidden rounded-card font-body outline-none", overlayCard, className), children: _jsx(CommandContext.Provider, { value: context, children: _jsx(BaseAutocomplete.Root, { open: true, inline: true, items: groups, filteredItems: results, value: query, onValueChange: setQuery, itemToStringValue: (item) => item.label, autoHighlight: "always", keepHighlight: true, children: children ?? (_jsxs(_Fragment, { children: [_jsx(CommandInput, { placeholder: placeholder ?? text.placeholder }), _jsx(CommandEmpty, { children: emptyMessage === undefined ? text.empty : emptyMessage }), _jsx(CommandList, { children: (group) => (_jsx(CommandGroup, { items: group.items, label: group.value, children: (entry) => _jsx(CommandItem, { value: entry }, entry.value) }, group.value)) }), _jsx(CommandFooter, {})] })) }) }) }) })] })] }));
182
+ }, ...rootProps, children: [trigger && _jsx(BaseDialog.Trigger, { render: trigger }), _jsxs(BaseDialog.Portal, { container: portalContainer, children: [_jsx(BaseDialog.Backdrop, { "data-slot": "command-backdrop", className: cn(overlayBackdrop, "transition-none") }), _jsx(BaseDialog.Viewport, { "data-slot": "command-viewport", className: "fixed inset-0 z-50 flex items-start justify-center px-4 pt-[12dvh] pb-4 sm:pt-[16dvh]", children: _jsx(BaseDialog.Popup, { "data-slot": "command-dialog", "aria-label": label ?? text.label, "aria-busy": loading || undefined, dir: popupDir, className: cn("relative flex max-h-[min(34rem,calc(84dvh-1rem))] w-full max-w-[40rem] flex-col overflow-hidden rounded-card font-body outline-none", overlayCard, className), children: _jsx(CommandContext.Provider, { value: context, children: _jsx(BaseAutocomplete.Root, { open: true, inline: true, items: groups, filteredItems: results, value: query, onValueChange: search, itemToStringValue: (item) => item.label, autoHighlight: "always", keepHighlight: true, children: children ?? (_jsxs(_Fragment, { children: [_jsx(CommandInput, { placeholder: placeholder ?? text.placeholder }), _jsx(CommandStatus, { loading: loading }), _jsx(CommandEmpty, { children: loading ? null : emptyMessage === undefined ? text.empty : emptyMessage }), _jsx(CommandList, { children: (group) => (_jsx(CommandGroup, { items: group.items, label: group.value, children: (entry) => _jsx(CommandItem, { value: entry }, entry.value) }, group.value)) }), _jsx(CommandFooter, {})] })) }) }) }) })] })] }));
175
183
  }
176
184
  /**
177
185
  * The search field: borderless, 46px, a search icon before it and an `Esc` hint after it.
178
- * The hint is the palette's close button, so touch and screen-reader users have one too.
186
+ * The hint is the palette's close button, so touch and screen-reader users have one too; on a
187
+ * touch-only phone or tablet, where there is no Esc to press, it is a round × instead.
179
188
  */
180
189
  export function CommandInput({ className, ...props }) {
181
190
  const text = useCommandText();
182
- return (_jsxs(BaseAutocomplete.InputGroup, { "data-slot": "command-input-group", className: "flex min-h-(--control-h-lg) shrink-0 cursor-text items-center gap-3 border-b border-border px-4", children: [_jsx(SearchIcon, { "aria-hidden": true, className: "size-4 shrink-0 text-muted-foreground" }), _jsx(BaseAutocomplete.Input, { "data-slot": "command-input", className: sx("min-h-(--control-h-lg) w-full min-w-0 flex-1 border-0 bg-transparent text-base text-foreground outline-none placeholder:text-control-muted sm:text-[15px]", className), ...props }), _jsxs(BaseDialog.Close, { "data-slot": "command-close", className: cn(kbdClassName, "cursor-pointer focus-ring"), children: ["Esc", _jsxs("span", { className: "sr-only", children: [", ", text.close] })] })] }));
191
+ const { hasKeyboard } = useShortcutKeys();
192
+ return (_jsxs(BaseAutocomplete.InputGroup, { "data-slot": "command-input-group", className: "flex min-h-(--control-h-lg) shrink-0 cursor-text items-center gap-3 border-b border-border px-4", children: [_jsx(SearchIcon, { "aria-hidden": true, className: "size-4 shrink-0 text-muted-foreground" }), _jsx(BaseAutocomplete.Input, { "data-slot": "command-input", className: sx("min-h-(--control-h-lg) w-full min-w-0 flex-1 border-0 bg-transparent text-base text-foreground outline-none placeholder:text-control-muted sm:text-15", className), ...props }), hasKeyboard ? (_jsxs(BaseDialog.Close, { "data-slot": "command-close", className: cn(kbdClassName, "cursor-pointer focus-ring"), children: ["Esc", _jsxs("span", { className: "sr-only", children: [", ", text.close] })] })) : (_jsx(BaseDialog.Close, { "data-slot": "command-close", "aria-label": text.close, className: "-me-2 inline-flex size-(--control-h-sm) shrink-0 cursor-pointer items-center justify-center rounded-full material-row text-muted-foreground focus-ring [&_svg]:size-4", children: _jsx(XIcon, { "aria-hidden": true }) }))] }));
183
193
  }
184
194
  export function CommandList({ className, children, ...props }) {
185
195
  return (_jsx(ScrollArea
@@ -199,7 +209,7 @@ export function CommandGroup({ items, label, children, className, ...props }) {
199
209
  }
200
210
  /** An eyebrow above a group: 11px mono, uppercase, tracked. */
201
211
  export function CommandGroupLabel({ className, ...props }) {
202
- return (_jsx(BaseAutocomplete.GroupLabel, { "data-slot": "command-group-label", className: sx("px-2.5 pt-2.5 pb-1.5 eyebrow text-[11px] [overflow-wrap:anywhere] select-none", className), ...props }));
212
+ return (_jsx(BaseAutocomplete.GroupLabel, { "data-slot": "command-group-label", className: sx("px-2.5 pt-2.5 pb-1.5 eyebrow text-11 [overflow-wrap:anywhere] select-none", className), ...props }));
203
213
  }
204
214
  /**
205
215
  * One result: 38px, 7px radius, raised when highlighted. Renders the entry's icon, label and hint
@@ -224,14 +234,29 @@ export function CommandItem({ value, onItemSelect, closeOnSelect = true, classNa
224
234
  ], className), ...props, children: children ??
225
235
  (value.hint ? (_jsxs(_Fragment, { children: [value.icon, _jsxs("span", { className: "grid min-w-0 flex-1 grid-cols-[minmax(0,max-content)_minmax(0,max-content)] items-center justify-between gap-3", children: [_jsx("span", { className: "truncate", children: value.label }), _jsx("span", { className: "truncate font-mono text-xs text-muted-foreground [unicode-bidi:plaintext]", children: value.hint })] })] })) : (_jsxs(_Fragment, { children: [value.icon, _jsx("span", { className: "min-w-0 flex-1 truncate", children: value.label })] }))) }));
226
236
  }
237
+ /**
238
+ * A status row above the results, announced politely: "Searching…" with a spinner while results
239
+ * load, or your own words. Stays mounted (it is a live region); only what it says changes, and
240
+ * with nothing to say it takes no room. `CommandDialog` renders one for its `loading` prop.
241
+ */
242
+ export function CommandStatus({ loading = false, className, children, ...props }) {
243
+ const text = useCommandText();
244
+ return (_jsxs(BaseAutocomplete.Status, { "data-slot": "command-status", "data-loading": loading ? "" : undefined, className: sx("flex shrink-0 items-center gap-3 px-4.5 text-sm text-muted-foreground [&:not(:empty)]:min-h-(--control-h) [&:not(:empty)]:pt-2", className), ...props, children: [loading && _jsx(Spinner, { "aria-hidden": true }), loading ? (children ?? text.loading) : children] }));
245
+ }
227
246
  /** Shown when nothing matches. Stays mounted (it is a live region); only its children toggle. */
228
247
  export function CommandEmpty({ className, ...props }) {
229
248
  return (_jsx(BaseAutocomplete.Empty, { "data-slot": "command-empty", className: sx("text-center text-sm text-muted-foreground [&:not(:empty)]:px-4 [&:not(:empty)]:py-10", className), ...props }));
230
249
  }
231
- /** Keyboard hints along the bottom edge: "↑↓ navigate · ↵ open". */
250
+ /**
251
+ * Keyboard hints along the bottom edge: "↑↓ navigate · ↵ open". Without children it renders
252
+ * nothing on a touch-only phone or tablet, where no key can be pressed.
253
+ */
232
254
  export function CommandFooter({ className, children, ...props }) {
233
255
  const text = useCommandText();
234
- return (_jsx("div", { "data-slot": "command-footer", className: cn("flex min-h-(--control-h) shrink-0 items-center gap-4 border-t border-border px-4 font-mono text-[11px] text-muted-foreground select-none", className), ...props, children: children ?? (_jsxs(_Fragment, { children: [_jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx(Kbd, { children: "\u2191" }), _jsx(Kbd, { children: "\u2193" }), text.navigate] }), _jsx("span", { "aria-hidden": true, children: "\u00B7" }), _jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx(Kbd, { children: "\u21B5" }), text.open] })] })) }));
256
+ const { hasKeyboard } = useShortcutKeys();
257
+ if (children == null && !hasKeyboard)
258
+ return null;
259
+ return (_jsx("div", { "data-slot": "command-footer", className: cn("flex min-h-(--control-h) shrink-0 items-center gap-4 border-t border-border px-4 font-mono text-11 text-muted-foreground select-none", className), ...props, children: children ?? (_jsxs(_Fragment, { children: [_jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx(Kbd, { children: "\u2191" }), _jsx(Kbd, { children: "\u2193" }), text.navigate] }), _jsx("span", { "aria-hidden": true, children: "\u00B7" }), _jsxs("span", { className: "inline-flex items-center gap-1.5", children: [_jsx(Kbd, { children: "\u21B5" }), text.open] })] })) }));
235
260
  }
236
261
  export function useCommandShortcut(keyOrHandler, maybeHandler) {
237
262
  const key = (typeof keyOrHandler === "string" ? keyOrHandler : "k").toLowerCase();
@@ -9,8 +9,11 @@ import { MenuCheckboxItem, MenuGroup, MenuGroupLabel, MenuItem, MenuLinkItem, Me
9
9
  * shortcut; every action in it must also be reachable from a visible control.
10
10
  */
11
11
  export declare const ContextMenu: typeof BaseContextMenu.Root;
12
- /** The area that opens the menu on right click or long press. Renders a `<div>`. */
13
- export declare function ContextMenuTrigger({ className, ...props }: BaseContextMenu.Trigger.Props): import("react").JSX.Element;
12
+ /**
13
+ * The area that opens the menu on right click or long press, and on the context-menu key or
14
+ * Shift+F10 while the focus is on something inside it. Renders a `<div>`.
15
+ */
16
+ export declare function ContextMenuTrigger({ className, onContextMenu, ...props }: BaseContextMenu.Trigger.Props): import("react").JSX.Element;
14
17
  export type ContextMenuContentProps = Omit<MenuFrameProps, "slot">;
15
18
  /** Portal + Positioner + Popup, placed at the pointer. Same surface as `MenuContent`. */
16
19
  export declare function ContextMenuContent(props: ContextMenuContentProps): import("react").JSX.Element;
@@ -12,9 +12,30 @@ import { MenuCheckboxItem, MenuGroup, MenuGroupLabel, MenuItem, MenuLinkItem, Me
12
12
  * shortcut; every action in it must also be reachable from a visible control.
13
13
  */
14
14
  export const ContextMenu = BaseContextMenu.Root;
15
- /** The area that opens the menu on right click or long press. Renders a `<div>`. */
16
- export function ContextMenuTrigger({ className, ...props }) {
17
- return (_jsx(BaseContextMenu.Trigger, { "data-slot": "context-menu-trigger", className: sx("select-none", className), ...props }));
15
+ /**
16
+ * The area that opens the menu on right click or long press, and on the context-menu key or
17
+ * Shift+F10 while the focus is on something inside it. Renders a `<div>`.
18
+ */
19
+ export function ContextMenuTrigger({ className, onContextMenu, ...props }) {
20
+ return (_jsx(BaseContextMenu.Trigger, { "data-slot": "context-menu-trigger", className: sx("select-none", className), onContextMenu: (event) => {
21
+ onContextMenu?.(event);
22
+ // From the keyboard the event comes from the focused element, at a point the browser picks
23
+ // (0, 0 in some): the menu opens under that element's start corner instead.
24
+ const target = event.target;
25
+ const native = event.nativeEvent;
26
+ const rect = target.getBoundingClientRect?.();
27
+ if (!rect || (rect.width === 0 && rect.height === 0))
28
+ return;
29
+ const outside = event.clientX < rect.left - 1 ||
30
+ event.clientX > rect.right + 1 ||
31
+ event.clientY < rect.top - 1 ||
32
+ event.clientY > rect.bottom + 1;
33
+ if (native.pointerType !== "" && !outside)
34
+ return;
35
+ const rtl = getComputedStyle(target).direction === "rtl";
36
+ event.clientX = rtl ? rect.right : rect.left;
37
+ event.clientY = rect.bottom;
38
+ }, ...props }));
18
39
  }
19
40
  /** Portal + Positioner + Popup, placed at the pointer. Same surface as `MenuContent`. */
20
41
  export function ContextMenuContent(props) {
@@ -5,7 +5,7 @@ export interface ConversationMessages {
5
5
  scrollToLatest: string;
6
6
  }
7
7
  declare module "./locale" {
8
- interface Messages {
8
+ interface LocaleMessages {
9
9
  conversation: ConversationMessages;
10
10
  }
11
11
  }