@jcsoftdev/ui 0.2.3 → 0.4.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 (601) hide show
  1. package/CHANGELOG.md +390 -7
  2. package/README.md +57 -3
  3. package/bin/ui-theme.mjs +1162 -25
  4. package/dist/ai/attachment/attachment.js +1 -1
  5. package/dist/ai/chat-list/group.js +3 -1
  6. package/dist/ai/conversation/conversation.js +1 -1
  7. package/dist/ai/internal/use-copy.d.ts +1 -5
  8. package/dist/ai/internal/use-copy.js +1 -32
  9. package/dist/ai/markdown/parse.js +59 -17
  10. package/dist/ai/source/source.js +1 -1
  11. package/dist/atoms/avatar/avatar.d.ts +13 -3
  12. package/dist/atoms/avatar/avatar.js +40 -2
  13. package/dist/atoms/avatar/index.d.ts +1 -1
  14. package/dist/atoms/avatar/index.js +3 -1
  15. package/dist/atoms/button/button.d.ts +4 -1
  16. package/dist/atoms/button/button.js +4 -2
  17. package/dist/atoms/checkbox/checkbox.d.ts +8 -3
  18. package/dist/atoms/checkbox/checkbox.js +26 -3
  19. package/dist/atoms/chip/chip.d.ts +19 -5
  20. package/dist/atoms/chip/chip.js +34 -5
  21. package/dist/atoms/chip/index.d.ts +1 -1
  22. package/dist/atoms/chip/index.js +6 -1
  23. package/dist/atoms/due-chip/due-chip.d.ts +31 -0
  24. package/dist/atoms/due-chip/due-chip.js +41 -0
  25. package/dist/atoms/due-chip/index.d.ts +2 -0
  26. package/dist/atoms/due-chip/index.js +6 -0
  27. package/dist/atoms/due-chip/model.d.ts +25 -0
  28. package/dist/atoms/due-chip/model.js +44 -0
  29. package/dist/atoms/icon-button/icon-button.d.ts +22 -0
  30. package/dist/atoms/icon-button/icon-button.js +38 -0
  31. package/dist/atoms/icon-button/index.d.ts +1 -0
  32. package/dist/atoms/icon-button/index.js +8 -0
  33. package/dist/atoms/index.d.ts +5 -0
  34. package/dist/atoms/index.js +5 -0
  35. package/dist/atoms/internal/hit-area.d.ts +6 -0
  36. package/dist/atoms/internal/hit-area.js +4 -0
  37. package/dist/atoms/kbd/index.d.ts +1 -0
  38. package/dist/atoms/kbd/index.js +4 -0
  39. package/dist/atoms/kbd/kbd.d.ts +7 -0
  40. package/dist/atoms/kbd/kbd.js +17 -0
  41. package/dist/atoms/radio-group/radio-group.js +6 -2
  42. package/dist/atoms/seal/index.d.ts +1 -0
  43. package/dist/atoms/seal/index.js +4 -0
  44. package/dist/atoms/seal/seal.d.ts +30 -0
  45. package/dist/atoms/seal/seal.js +71 -0
  46. package/dist/atoms/spinner/index.d.ts +1 -0
  47. package/dist/atoms/spinner/index.js +5 -0
  48. package/dist/atoms/spinner/spinner.d.ts +19 -0
  49. package/dist/atoms/spinner/spinner.js +31 -0
  50. package/dist/atoms/status-dot/index.d.ts +1 -1
  51. package/dist/atoms/status-dot/status-dot.d.ts +4 -2
  52. package/dist/atoms/status-dot/status-dot.js +5 -1
  53. package/dist/atoms/switch/switch.js +3 -1
  54. package/dist/calendar/date-calendar/date-calendar.d.ts +32 -0
  55. package/dist/calendar/date-calendar/date-calendar.js +189 -0
  56. package/dist/calendar/date-calendar/index.d.ts +1 -0
  57. package/dist/calendar/date-calendar/index.js +6 -0
  58. package/dist/calendar/index.d.ts +1 -0
  59. package/dist/calendar/index.js +1 -0
  60. package/dist/calendar/internal/date-utils.d.ts +26 -0
  61. package/dist/calendar/internal/date-utils.js +95 -1
  62. package/dist/charts/bar-chart/bar-race-chart.js +1 -0
  63. package/dist/charts/beeswarm-chart/beeswarm-chart.js +1 -1
  64. package/dist/charts/chord-chart/chord-chart.js +13 -5
  65. package/dist/charts/core/cartesian/cartesian-chart.d.ts +1 -1
  66. package/dist/charts/core/cartesian/cartesian-chart.js +48 -11
  67. package/dist/charts/core/cartesian/layout.d.ts +6 -1
  68. package/dist/charts/core/cartesian/layout.js +14 -5
  69. package/dist/charts/core/cartesian/marks.d.ts +2 -2
  70. package/dist/charts/core/cartesian/marks.js +1 -1
  71. package/dist/charts/core/cartesian/types.d.ts +28 -2
  72. package/dist/charts/core/category-explorer.d.ts +2 -2
  73. package/dist/charts/core/category-explorer.js +8 -4
  74. package/dist/charts/core/chart-dock.d.ts +26 -0
  75. package/dist/charts/core/chart-dock.js +45 -0
  76. package/dist/charts/core/chart-frame.d.ts +9 -2
  77. package/dist/charts/core/chart-frame.js +105 -25
  78. package/dist/charts/core/distribution/explorer.d.ts +5 -2
  79. package/dist/charts/core/distribution/explorer.js +12 -5
  80. package/dist/charts/core/distribution/xy-points.js +1 -1
  81. package/dist/charts/core/index.d.ts +3 -0
  82. package/dist/charts/core/index.js +3 -0
  83. package/dist/charts/core/leave-grace.d.ts +11 -0
  84. package/dist/charts/core/leave-grace.js +26 -0
  85. package/dist/charts/core/nearest.d.ts +14 -0
  86. package/dist/charts/core/nearest.js +22 -0
  87. package/dist/charts/core/plot-overlay.js +9 -3
  88. package/dist/charts/core/pointer.test-utils.d.ts +38 -0
  89. package/dist/charts/core/pointer.test-utils.js +123 -0
  90. package/dist/charts/core/tooltip.d.ts +25 -2
  91. package/dist/charts/core/tooltip.js +115 -40
  92. package/dist/charts/core/touch-select.d.ts +20 -0
  93. package/dist/charts/core/touch-select.js +184 -0
  94. package/dist/charts/core/types.d.ts +8 -4
  95. package/dist/charts/core/types.js +5 -0
  96. package/dist/charts/core/use-index-navigation.d.ts +17 -6
  97. package/dist/charts/core/use-index-navigation.js +47 -10
  98. package/dist/charts/donut-chart/donut-chart.d.ts +5 -1
  99. package/dist/charts/donut-chart/donut-chart.js +40 -1
  100. package/dist/charts/donut-chart/slice-labels.d.ts +20 -0
  101. package/dist/charts/donut-chart/slice-labels.js +20 -0
  102. package/dist/charts/dumbbell-chart/dumbbell-chart.js +6 -3
  103. package/dist/charts/fill-gauge-chart/fill-gauge-chart.js +1 -0
  104. package/dist/charts/funnel-chart/funnel-chart.js +2 -1
  105. package/dist/charts/gauge-chart/gauge-chart.js +2 -1
  106. package/dist/charts/heatmap-chart/heatmap-chart.d.ts +4 -1
  107. package/dist/charts/heatmap-chart/heatmap-chart.js +3 -1
  108. package/dist/charts/heatmap-chart/heatmap-grid.d.ts +4 -1
  109. package/dist/charts/heatmap-chart/heatmap-grid.js +3 -1
  110. package/dist/charts/hex-tile-map/hex-tile-map.js +124 -115
  111. package/dist/charts/hierarchy-morph/hierarchy-morph.js +2 -1
  112. package/dist/charts/icicle-chart/icicle-chart.js +7 -9
  113. package/dist/charts/lollipop-chart/lollipop-chart.js +6 -3
  114. package/dist/charts/maps/geo/map-viewport.js +1 -1
  115. package/dist/charts/polar-area-chart/polar-area-chart.js +42 -12
  116. package/dist/charts/progress-units/progress-units.js +1 -0
  117. package/dist/charts/radar-chart/radar-chart.js +1 -1
  118. package/dist/charts/radial-bar-chart/radial-bar-chart.js +2 -1
  119. package/dist/charts/range-area-chart/range-area-chart.js +3 -2
  120. package/dist/charts/sankey-chart/sankey-chart.js +12 -4
  121. package/dist/charts/tree-chart/tree-chart.js +1 -0
  122. package/dist/charts/treemap-chart/treemap-chart.js +2 -7
  123. package/dist/charts/waterfall-chart/waterfall-chart.js +6 -3
  124. package/dist/containers/action-bar/action-bar.d.ts +11 -2
  125. package/dist/containers/action-bar/action-bar.js +4 -1
  126. package/dist/containers/aside/aside.d.ts +14 -0
  127. package/dist/containers/aside/aside.js +25 -0
  128. package/dist/containers/aside/index.d.ts +1 -0
  129. package/dist/containers/aside/index.js +5 -0
  130. package/dist/containers/banner/banner.d.ts +4 -1
  131. package/dist/containers/banner/banner.js +9 -1
  132. package/dist/containers/card/card.d.ts +21 -3
  133. package/dist/containers/card/card.js +20 -5
  134. package/dist/containers/description-list/description-list.d.ts +29 -6
  135. package/dist/containers/description-list/description-list.js +47 -6
  136. package/dist/containers/feed/feed.d.ts +23 -0
  137. package/dist/containers/feed/feed.js +77 -0
  138. package/dist/containers/feed/index.d.ts +2 -0
  139. package/dist/containers/feed/index.js +10 -0
  140. package/dist/containers/feed/model.d.ts +19 -0
  141. package/dist/containers/feed/model.js +38 -0
  142. package/dist/containers/grid/grid.d.ts +15 -0
  143. package/dist/containers/grid/grid.js +24 -0
  144. package/dist/containers/grid/index.d.ts +1 -0
  145. package/dist/containers/grid/index.js +4 -0
  146. package/dist/containers/index.d.ts +9 -0
  147. package/dist/containers/index.js +9 -0
  148. package/dist/containers/kpi/kpi.d.ts +60 -7
  149. package/dist/containers/kpi/kpi.js +142 -28
  150. package/dist/containers/kpi-group/index.d.ts +1 -1
  151. package/dist/containers/kpi-group/index.js +3 -1
  152. package/dist/containers/kpi-group/kpi-group.d.ts +9 -1
  153. package/dist/containers/kpi-group/kpi-group.js +11 -1
  154. package/dist/containers/list-detail/index.d.ts +1 -0
  155. package/dist/containers/list-detail/index.js +20 -0
  156. package/dist/containers/list-detail/list-detail.d.ts +55 -0
  157. package/dist/containers/list-detail/list-detail.js +221 -0
  158. package/dist/containers/note/index.d.ts +1 -0
  159. package/dist/containers/note/index.js +4 -0
  160. package/dist/containers/note/note.d.ts +13 -0
  161. package/dist/containers/note/note.js +27 -0
  162. package/dist/containers/page/index.d.ts +1 -0
  163. package/dist/containers/page/index.js +4 -0
  164. package/dist/containers/page/page.d.ts +7 -0
  165. package/dist/containers/page/page.js +14 -0
  166. package/dist/containers/page-header/page-header.d.ts +8 -3
  167. package/dist/containers/page-header/page-header.js +35 -8
  168. package/dist/containers/responsive-list/responsive-list.d.ts +1 -1
  169. package/dist/containers/responsive-list/responsive-list.js +6 -3
  170. package/dist/containers/section/index.d.ts +1 -0
  171. package/dist/containers/section/index.js +6 -0
  172. package/dist/containers/section/section.d.ts +68 -0
  173. package/dist/containers/section/section.js +198 -0
  174. package/dist/containers/shortcuts/index.d.ts +1 -0
  175. package/dist/containers/shortcuts/index.js +8 -0
  176. package/dist/containers/shortcuts/shortcuts.d.ts +18 -0
  177. package/dist/containers/shortcuts/shortcuts.js +50 -0
  178. package/dist/containers/stack/index.d.ts +1 -0
  179. package/dist/containers/stack/index.js +6 -0
  180. package/dist/containers/stack/stack.d.ts +15 -0
  181. package/dist/containers/stack/stack.js +43 -0
  182. package/dist/containers/table/selection.d.ts +9 -0
  183. package/dist/containers/table/selection.js +20 -0
  184. package/dist/containers/table/table.d.ts +66 -4
  185. package/dist/containers/table/table.js +128 -7
  186. package/dist/containers/timeline/index.d.ts +1 -1
  187. package/dist/containers/timeline/index.js +4 -2
  188. package/dist/containers/timeline/timeline.d.ts +32 -5
  189. package/dist/containers/timeline/timeline.js +154 -90
  190. package/dist/forms/chip-group/chip-group.d.ts +54 -0
  191. package/dist/forms/chip-group/chip-group.js +114 -0
  192. package/dist/forms/chip-group/index.d.ts +1 -0
  193. package/dist/forms/chip-group/index.js +6 -0
  194. package/dist/forms/combobox/combobox.d.ts +60 -0
  195. package/dist/forms/combobox/combobox.js +281 -0
  196. package/dist/forms/combobox/index.d.ts +1 -0
  197. package/dist/forms/combobox/index.js +6 -0
  198. package/dist/forms/copy-field/copy-field.d.ts +17 -0
  199. package/dist/forms/copy-field/copy-field.js +72 -0
  200. package/dist/forms/copy-field/index.d.ts +1 -0
  201. package/dist/forms/copy-field/index.js +4 -0
  202. package/dist/forms/date-picker/date-picker.d.ts +40 -0
  203. package/dist/forms/date-picker/date-picker.js +183 -0
  204. package/dist/forms/date-picker/date-time-picker.d.ts +43 -0
  205. package/dist/forms/date-picker/date-time-picker.js +121 -0
  206. package/dist/forms/date-picker/index.d.ts +2 -0
  207. package/dist/forms/date-picker/index.js +10 -0
  208. package/dist/forms/date-picker/model.d.ts +35 -0
  209. package/dist/forms/date-picker/model.js +83 -0
  210. package/dist/forms/dropzone/dropzone.d.ts +30 -2
  211. package/dist/forms/dropzone/dropzone.js +153 -23
  212. package/dist/forms/emoji-picker/emoji-picker.js +1 -1
  213. package/dist/forms/field/field.d.ts +16 -10
  214. package/dist/forms/field/field.js +41 -5
  215. package/dist/forms/form/form.d.ts +15 -0
  216. package/dist/forms/form/form.js +29 -0
  217. package/dist/forms/form/index.d.ts +1 -0
  218. package/dist/forms/form/index.js +10 -0
  219. package/dist/forms/index.d.ts +6 -0
  220. package/dist/forms/index.js +6 -0
  221. package/dist/forms/input/index.d.ts +1 -1
  222. package/dist/forms/input/index.js +6 -2
  223. package/dist/forms/input/input.d.ts +23 -3
  224. package/dist/forms/input/input.js +78 -7
  225. package/dist/forms/input-icon/input-icon.d.ts +1 -1
  226. package/dist/forms/internal/listbox-items.d.ts +18 -0
  227. package/dist/forms/internal/listbox-items.js +88 -0
  228. package/dist/forms/internal/listbox.d.ts +44 -0
  229. package/dist/forms/internal/listbox.js +74 -0
  230. package/dist/forms/number-stepper/model.d.ts +16 -0
  231. package/dist/forms/number-stepper/model.js +23 -0
  232. package/dist/forms/number-stepper/number-stepper.d.ts +36 -6
  233. package/dist/forms/number-stepper/number-stepper.js +86 -37
  234. package/dist/forms/select-menu/index.d.ts +1 -0
  235. package/dist/forms/select-menu/index.js +6 -0
  236. package/dist/forms/select-menu/select-menu.d.ts +35 -0
  237. package/dist/forms/select-menu/select-menu.js +230 -0
  238. package/dist/glass/crystal-map.d.ts +70 -0
  239. package/dist/glass/crystal-map.js +88 -0
  240. package/dist/glass/displacement-map.d.ts +117 -0
  241. package/dist/glass/displacement-map.js +201 -0
  242. package/dist/glass/index.d.ts +8 -0
  243. package/dist/glass/index.js +63 -0
  244. package/dist/glass/lens-crystal.d.ts +29 -0
  245. package/dist/glass/lens-crystal.js +161 -0
  246. package/dist/glass/lens-dispersion.d.ts +11 -0
  247. package/dist/glass/lens-dispersion.js +19 -0
  248. package/dist/glass/liquid-glass.d.ts +41 -0
  249. package/dist/glass/liquid-glass.js +256 -0
  250. package/dist/glass/liquid-motion.d.ts +53 -0
  251. package/dist/glass/liquid-motion.js +302 -0
  252. package/dist/glass/liquid-options.d.ts +162 -0
  253. package/dist/glass/liquid-options.js +179 -0
  254. package/dist/glass/refraction.d.ts +100 -0
  255. package/dist/glass/refraction.js +714 -0
  256. package/dist/glass/specular-map.d.ts +26 -0
  257. package/dist/glass/specular-map.js +75 -0
  258. package/dist/glass/spring.d.ts +79 -0
  259. package/dist/glass/spring.js +58 -0
  260. package/dist/glass/support.d.ts +13 -0
  261. package/dist/glass/support.js +14 -0
  262. package/dist/glass/use-glass-refraction.d.ts +8 -0
  263. package/dist/glass/use-glass-refraction.js +16 -0
  264. package/dist/i18n/strings.d.ts +113 -0
  265. package/dist/i18n/strings.js +70 -2
  266. package/dist/i18n/ui-strings-provider.d.ts +1 -1
  267. package/dist/i18n/ui-strings-provider.js +6 -2
  268. package/dist/icons/index.d.ts +2 -0
  269. package/dist/icons/index.js +4 -0
  270. package/dist/icons/key.d.ts +2 -0
  271. package/dist/icons/key.js +12 -0
  272. package/dist/icons/webhook.d.ts +2 -0
  273. package/dist/icons/webhook.js +12 -0
  274. package/dist/liquid/index.d.ts +3 -0
  275. package/dist/liquid/index.js +29 -0
  276. package/dist/navigation/breadcrumbs/breadcrumbs.d.ts +29 -0
  277. package/dist/navigation/breadcrumbs/breadcrumbs.js +70 -0
  278. package/dist/navigation/breadcrumbs/index.d.ts +1 -0
  279. package/dist/navigation/breadcrumbs/index.js +6 -0
  280. package/dist/navigation/index.d.ts +2 -0
  281. package/dist/navigation/index.js +2 -0
  282. package/dist/navigation/segmented/index.d.ts +1 -1
  283. package/dist/navigation/segmented/model.d.ts +5 -0
  284. package/dist/navigation/segmented/model.js +6 -0
  285. package/dist/navigation/segmented/segmented.d.ts +17 -3
  286. package/dist/navigation/segmented/segmented.js +20 -4
  287. package/dist/navigation/stepper/index.d.ts +1 -1
  288. package/dist/navigation/stepper/index.js +3 -1
  289. package/dist/navigation/stepper/stepper.d.ts +8 -0
  290. package/dist/navigation/stepper/stepper.js +68 -45
  291. package/dist/navigation/tabs/index.d.ts +1 -0
  292. package/dist/navigation/tabs/index.js +6 -0
  293. package/dist/navigation/tabs/tabs-nav.d.ts +37 -0
  294. package/dist/navigation/tabs/tabs-nav.js +57 -0
  295. package/dist/navigation/wizard/index.d.ts +1 -0
  296. package/dist/navigation/wizard/index.js +6 -0
  297. package/dist/navigation/wizard/model.d.ts +33 -0
  298. package/dist/navigation/wizard/model.js +34 -0
  299. package/dist/navigation/wizard/wizard.d.ts +45 -0
  300. package/dist/navigation/wizard/wizard.js +169 -0
  301. package/dist/overlays/alert-dialog/alert-dialog.d.ts +103 -0
  302. package/dist/overlays/alert-dialog/alert-dialog.js +342 -0
  303. package/dist/overlays/alert-dialog/index.d.ts +1 -0
  304. package/dist/overlays/alert-dialog/index.js +26 -0
  305. package/dist/overlays/context-menu/context-menu.d.ts +9 -1
  306. package/dist/overlays/context-menu/context-menu.js +4 -1
  307. package/dist/overlays/dialog/dialog.d.ts +9 -1
  308. package/dist/overlays/dialog/dialog.js +3 -0
  309. package/dist/overlays/drawer/drawer.d.ts +9 -1
  310. package/dist/overlays/drawer/drawer.js +3 -0
  311. package/dist/overlays/dropdown-menu/dropdown-menu.d.ts +25 -1
  312. package/dist/overlays/dropdown-menu/dropdown-menu.js +14 -4
  313. package/dist/overlays/dropdown-menu/index.d.ts +1 -1
  314. package/dist/overlays/dropdown-menu/index.js +8 -2
  315. package/dist/overlays/hover-card/hover-card.d.ts +10 -1
  316. package/dist/overlays/hover-card/hover-card.js +4 -1
  317. package/dist/overlays/index.d.ts +2 -0
  318. package/dist/overlays/index.js +2 -0
  319. package/dist/overlays/popover/popover.d.ts +9 -1
  320. package/dist/overlays/popover/popover.js +3 -0
  321. package/dist/overlays/testing/index.d.ts +5 -0
  322. package/dist/overlays/testing/index.js +4 -0
  323. package/dist/overlays/toaster/index.d.ts +2 -1
  324. package/dist/overlays/toaster/index.js +4 -2
  325. package/dist/overlays/toaster/toast-store.d.ts +6 -2
  326. package/dist/overlays/toaster/toast.d.ts +3 -0
  327. package/dist/overlays/toaster/toast.js +3 -0
  328. package/dist/overlays/toaster/toaster.d.ts +3 -0
  329. package/dist/overlays/toaster/toaster.js +36 -3
  330. package/dist/overlays/tooltip/index.d.ts +1 -0
  331. package/dist/overlays/tooltip/index.js +4 -0
  332. package/dist/overlays/tooltip/model.d.ts +10 -0
  333. package/dist/overlays/tooltip/model.js +13 -0
  334. package/dist/overlays/tooltip/tooltip.d.ts +41 -0
  335. package/dist/overlays/tooltip/tooltip.js +116 -0
  336. package/dist/palette/command-palette/command-palette.d.ts +12 -2
  337. package/dist/palette/command-palette/command-palette.js +5 -0
  338. package/dist/primitives/command/command.d.ts +3 -2
  339. package/dist/primitives/command/command.js +2 -0
  340. package/dist/primitives/menu/menu.js +1 -1
  341. package/dist/primitives/popper/popper.js +5 -0
  342. package/dist/primitives/use-dismissable-layer.js +1 -1
  343. package/dist/rich-text/rich-text-editor.js +94 -8
  344. package/dist/rich-text/sanitize.js +70 -20
  345. package/dist/shell/app-shell/app-shell.d.ts +17 -0
  346. package/dist/shell/app-shell/app-shell.js +44 -4
  347. package/dist/shell/bottom-nav/bottom-nav.d.ts +34 -0
  348. package/dist/shell/bottom-nav/bottom-nav.js +124 -0
  349. package/dist/shell/bottom-nav/index.d.ts +2 -0
  350. package/dist/shell/bottom-nav/index.js +9 -0
  351. package/dist/shell/bottom-nav/split.d.ts +11 -0
  352. package/dist/shell/bottom-nav/split.js +10 -0
  353. package/dist/shell/sidebar/sidebar.d.ts +16 -2
  354. package/dist/shell/sidebar/sidebar.js +46 -4
  355. package/dist/shell/topbar/topbar.d.ts +20 -9
  356. package/dist/shell/topbar/topbar.js +16 -9
  357. package/dist/states/empty-state/empty-state.d.ts +3 -1
  358. package/dist/states/empty-state/empty-state.js +9 -1
  359. package/dist/states/error-state/error-state.d.ts +8 -1
  360. package/dist/states/error-state/error-state.js +15 -9
  361. package/dist/states/index.d.ts +1 -0
  362. package/dist/states/index.js +1 -0
  363. package/dist/states/live-status-bar/index.d.ts +1 -0
  364. package/dist/states/live-status-bar/index.js +6 -0
  365. package/dist/states/live-status-bar/live-status-bar.d.ts +17 -0
  366. package/dist/states/live-status-bar/live-status-bar.js +49 -0
  367. package/dist/states/offline-banner/offline-banner.d.ts +3 -1
  368. package/dist/states/offline-banner/offline-banner.js +8 -4
  369. package/dist/states/skeleton/skeleton.d.ts +8 -2
  370. package/dist/states/skeleton/skeleton.js +44 -2
  371. package/dist/utils/class-groups.js +17 -0
  372. package/dist/utils/index.d.ts +1 -0
  373. package/dist/utils/index.js +2 -0
  374. package/dist/utils/material.d.ts +13 -0
  375. package/dist/utils/material.js +6 -0
  376. package/dist/utils/tone.d.ts +8 -0
  377. package/dist/utils/tone.js +17 -0
  378. package/dist/utils/use-copy.d.ts +5 -0
  379. package/dist/utils/use-copy.js +35 -0
  380. package/icons/svg/key.svg +5 -0
  381. package/icons/svg/webhook.svg +5 -0
  382. package/package.json +31 -21
  383. package/scripts/build-theme.d.mts +22 -0
  384. package/scripts/build-theme.mjs +248 -5
  385. package/src/ai/attachment/attachment.tsx +1 -1
  386. package/src/ai/chat-list/group.ts +3 -1
  387. package/src/ai/conversation/conversation.tsx +1 -1
  388. package/src/ai/internal/use-copy.ts +1 -38
  389. package/src/ai/markdown/parse.ts +74 -17
  390. package/src/ai/source/source.tsx +1 -1
  391. package/src/atoms/avatar/avatar.tsx +57 -4
  392. package/src/atoms/avatar/index.ts +8 -1
  393. package/src/atoms/button/button.tsx +8 -3
  394. package/src/atoms/checkbox/checkbox.tsx +33 -4
  395. package/src/atoms/chip/chip.tsx +55 -8
  396. package/src/atoms/chip/index.ts +9 -1
  397. package/src/atoms/due-chip/due-chip.tsx +75 -0
  398. package/src/atoms/due-chip/index.ts +2 -0
  399. package/src/atoms/due-chip/model.ts +67 -0
  400. package/src/atoms/icon-button/icon-button.tsx +58 -0
  401. package/src/atoms/icon-button/index.ts +6 -0
  402. package/src/atoms/index.ts +5 -0
  403. package/src/atoms/internal/hit-area.ts +7 -0
  404. package/src/atoms/kbd/index.ts +1 -0
  405. package/src/atoms/kbd/kbd.tsx +20 -0
  406. package/src/atoms/radio-group/radio-group.tsx +8 -2
  407. package/src/atoms/seal/index.ts +1 -0
  408. package/src/atoms/seal/seal.tsx +107 -0
  409. package/src/atoms/spinner/index.ts +1 -0
  410. package/src/atoms/spinner/spinner.tsx +49 -0
  411. package/src/atoms/status-dot/index.ts +1 -0
  412. package/src/atoms/status-dot/status-dot.tsx +15 -3
  413. package/src/atoms/switch/switch.tsx +3 -1
  414. package/src/calendar/date-calendar/date-calendar.tsx +230 -0
  415. package/src/calendar/date-calendar/index.ts +5 -0
  416. package/src/calendar/index.ts +1 -0
  417. package/src/calendar/internal/date-utils.ts +115 -0
  418. package/src/charts/README.md +21 -0
  419. package/src/charts/bar-chart/bar-race-chart.tsx +1 -0
  420. package/src/charts/beeswarm-chart/beeswarm-chart.tsx +1 -1
  421. package/src/charts/chord-chart/chord-chart.tsx +13 -5
  422. package/src/charts/core/cartesian/cartesian-chart.tsx +55 -10
  423. package/src/charts/core/cartesian/layout.ts +29 -10
  424. package/src/charts/core/cartesian/marks.tsx +3 -3
  425. package/src/charts/core/cartesian/types.ts +30 -2
  426. package/src/charts/core/category-explorer.tsx +12 -6
  427. package/src/charts/core/chart-dock.tsx +68 -0
  428. package/src/charts/core/chart-frame.tsx +116 -27
  429. package/src/charts/core/distribution/explorer.tsx +17 -7
  430. package/src/charts/core/distribution/xy-points.tsx +1 -1
  431. package/src/charts/core/index.ts +3 -0
  432. package/src/charts/core/leave-grace.ts +35 -0
  433. package/src/charts/core/nearest.ts +38 -0
  434. package/src/charts/core/plot-overlay.tsx +9 -3
  435. package/src/charts/core/pointer.test-utils.ts +146 -0
  436. package/src/charts/core/tooltip.tsx +129 -15
  437. package/src/charts/core/touch-select.ts +250 -0
  438. package/src/charts/core/types.ts +13 -4
  439. package/src/charts/core/use-index-navigation.ts +70 -11
  440. package/src/charts/donut-chart/donut-chart.tsx +53 -3
  441. package/src/charts/donut-chart/slice-labels.ts +39 -0
  442. package/src/charts/dumbbell-chart/dumbbell-chart.tsx +8 -3
  443. package/src/charts/fill-gauge-chart/fill-gauge-chart.tsx +1 -0
  444. package/src/charts/funnel-chart/funnel-chart.tsx +2 -1
  445. package/src/charts/gauge-chart/gauge-chart.tsx +2 -1
  446. package/src/charts/heatmap-chart/heatmap-chart.tsx +5 -0
  447. package/src/charts/heatmap-chart/heatmap-grid.tsx +5 -1
  448. package/src/charts/hex-tile-map/hex-tile-map.tsx +6 -1
  449. package/src/charts/hierarchy-morph/hierarchy-morph.tsx +2 -1
  450. package/src/charts/icicle-chart/icicle-chart.tsx +8 -9
  451. package/src/charts/lollipop-chart/lollipop-chart.tsx +8 -3
  452. package/src/charts/maps/geo/map-viewport.tsx +1 -1
  453. package/src/charts/polar-area-chart/polar-area-chart.tsx +37 -12
  454. package/src/charts/progress-units/progress-units.tsx +1 -0
  455. package/src/charts/radar-chart/radar-chart.tsx +1 -1
  456. package/src/charts/radial-bar-chart/radial-bar-chart.tsx +2 -1
  457. package/src/charts/range-area-chart/range-area-chart.tsx +3 -2
  458. package/src/charts/sankey-chart/sankey-chart.tsx +12 -4
  459. package/src/charts/tree-chart/tree-chart.tsx +1 -0
  460. package/src/charts/treemap-chart/treemap-chart.tsx +2 -7
  461. package/src/charts/waterfall-chart/waterfall-chart.tsx +8 -3
  462. package/src/containers/action-bar/action-bar.tsx +13 -2
  463. package/src/containers/aside/aside.tsx +40 -0
  464. package/src/containers/aside/index.ts +1 -0
  465. package/src/containers/banner/banner.tsx +18 -1
  466. package/src/containers/card/card.tsx +43 -4
  467. package/src/containers/description-list/description-list.tsx +85 -9
  468. package/src/containers/feed/feed.tsx +99 -0
  469. package/src/containers/feed/index.ts +8 -0
  470. package/src/containers/feed/model.ts +54 -0
  471. package/src/containers/grid/grid.tsx +37 -0
  472. package/src/containers/grid/index.ts +1 -0
  473. package/src/containers/index.ts +9 -0
  474. package/src/containers/kpi/kpi.tsx +231 -38
  475. package/src/containers/kpi-group/index.ts +7 -1
  476. package/src/containers/kpi-group/kpi-group.tsx +26 -1
  477. package/src/containers/list-detail/index.ts +15 -0
  478. package/src/containers/list-detail/list-detail.tsx +293 -0
  479. package/src/containers/note/index.ts +1 -0
  480. package/src/containers/note/note.tsx +38 -0
  481. package/src/containers/page/index.ts +1 -0
  482. package/src/containers/page/page.tsx +17 -0
  483. package/src/containers/page-header/page-header.tsx +38 -8
  484. package/src/containers/responsive-list/responsive-list.tsx +7 -4
  485. package/src/containers/section/index.ts +11 -0
  486. package/src/containers/section/section.tsx +281 -0
  487. package/src/containers/shortcuts/index.ts +6 -0
  488. package/src/containers/shortcuts/shortcuts.tsx +92 -0
  489. package/src/containers/stack/index.ts +7 -0
  490. package/src/containers/stack/stack.tsx +55 -0
  491. package/src/containers/table/selection.ts +26 -0
  492. package/src/containers/table/table.tsx +215 -13
  493. package/src/containers/timeline/index.ts +3 -0
  494. package/src/containers/timeline/timeline.tsx +204 -93
  495. package/src/forms/chip-group/chip-group.tsx +184 -0
  496. package/src/forms/chip-group/index.ts +8 -0
  497. package/src/forms/combobox/combobox.tsx +359 -0
  498. package/src/forms/combobox/index.ts +7 -0
  499. package/src/forms/copy-field/copy-field.tsx +88 -0
  500. package/src/forms/copy-field/index.ts +1 -0
  501. package/src/forms/date-picker/date-picker.tsx +239 -0
  502. package/src/forms/date-picker/date-time-picker.tsx +178 -0
  503. package/src/forms/date-picker/index.ts +10 -0
  504. package/src/forms/date-picker/model.ts +108 -0
  505. package/src/forms/dropzone/dropzone.tsx +217 -35
  506. package/src/forms/emoji-picker/emoji-picker.tsx +1 -1
  507. package/src/forms/field/field.tsx +72 -7
  508. package/src/forms/form/form.tsx +46 -0
  509. package/src/forms/form/index.ts +8 -0
  510. package/src/forms/index.ts +6 -0
  511. package/src/forms/input/index.ts +8 -1
  512. package/src/forms/input/input.tsx +103 -7
  513. package/src/forms/input-icon/input-icon.tsx +1 -1
  514. package/src/forms/internal/listbox-items.tsx +103 -0
  515. package/src/forms/internal/listbox.ts +124 -0
  516. package/src/forms/number-stepper/model.ts +35 -0
  517. package/src/forms/number-stepper/number-stepper.tsx +132 -42
  518. package/src/forms/select-menu/index.ts +7 -0
  519. package/src/forms/select-menu/select-menu.tsx +280 -0
  520. package/src/glass/crystal-map.ts +150 -0
  521. package/src/glass/displacement-map.ts +317 -0
  522. package/src/glass/index.ts +43 -0
  523. package/src/glass/lens-crystal.ts +226 -0
  524. package/src/glass/lens-dispersion.ts +34 -0
  525. package/src/glass/liquid-glass.tsx +371 -0
  526. package/src/glass/liquid-motion.ts +395 -0
  527. package/src/glass/liquid-options.ts +306 -0
  528. package/src/glass/refraction.ts +1010 -0
  529. package/src/glass/specular-map.ts +95 -0
  530. package/src/glass/spring.ts +98 -0
  531. package/src/glass/support.ts +27 -0
  532. package/src/glass/use-glass-refraction.ts +21 -0
  533. package/src/i18n/strings.ts +113 -0
  534. package/src/i18n/ui-strings-provider.tsx +15 -4
  535. package/src/icons/index.ts +2 -0
  536. package/src/icons/key.tsx +13 -0
  537. package/src/icons/webhook.tsx +13 -0
  538. package/src/liquid/index.ts +24 -0
  539. package/src/navigation/breadcrumbs/breadcrumbs.tsx +103 -0
  540. package/src/navigation/breadcrumbs/index.ts +8 -0
  541. package/src/navigation/index.ts +2 -0
  542. package/src/navigation/segmented/index.ts +1 -0
  543. package/src/navigation/segmented/model.ts +11 -0
  544. package/src/navigation/segmented/segmented.tsx +45 -6
  545. package/src/navigation/stepper/index.ts +7 -1
  546. package/src/navigation/stepper/stepper.tsx +41 -5
  547. package/src/navigation/tabs/index.ts +7 -0
  548. package/src/navigation/tabs/tabs-nav.tsx +131 -0
  549. package/src/navigation/wizard/index.ts +7 -0
  550. package/src/navigation/wizard/model.ts +61 -0
  551. package/src/navigation/wizard/wizard.tsx +222 -0
  552. package/src/overlays/alert-dialog/alert-dialog.tsx +486 -0
  553. package/src/overlays/alert-dialog/index.ts +19 -0
  554. package/src/overlays/context-menu/context-menu.tsx +11 -1
  555. package/src/overlays/dialog/dialog.tsx +10 -0
  556. package/src/overlays/drawer/drawer.tsx +10 -0
  557. package/src/overlays/dropdown-menu/dropdown-menu.tsx +38 -4
  558. package/src/overlays/dropdown-menu/index.ts +3 -0
  559. package/src/overlays/hover-card/hover-card.tsx +12 -1
  560. package/src/overlays/index.ts +2 -0
  561. package/src/overlays/popover/popover.tsx +10 -0
  562. package/src/overlays/testing/index.ts +5 -0
  563. package/src/overlays/toaster/index.ts +2 -0
  564. package/src/overlays/toaster/toast-store.ts +6 -2
  565. package/src/overlays/toaster/toast.ts +6 -0
  566. package/src/overlays/toaster/toaster.tsx +44 -2
  567. package/src/overlays/tooltip/index.ts +1 -0
  568. package/src/overlays/tooltip/model.ts +18 -0
  569. package/src/overlays/tooltip/tooltip.tsx +166 -0
  570. package/src/palette/command-palette/command-palette.tsx +15 -1
  571. package/src/primitives/command/command.tsx +4 -0
  572. package/src/primitives/menu/menu.tsx +1 -1
  573. package/src/primitives/popper/popper.tsx +10 -0
  574. package/src/primitives/use-dismissable-layer.ts +7 -2
  575. package/src/rich-text/rich-text-editor.tsx +116 -13
  576. package/src/rich-text/sanitize.ts +94 -23
  577. package/src/shell/app-shell/app-shell.tsx +60 -4
  578. package/src/shell/bottom-nav/bottom-nav.tsx +187 -0
  579. package/src/shell/bottom-nav/index.ts +8 -0
  580. package/src/shell/bottom-nav/split.ts +20 -0
  581. package/src/shell/sidebar/sidebar.tsx +51 -5
  582. package/src/shell/topbar/topbar.tsx +81 -58
  583. package/src/states/empty-state/empty-state.tsx +11 -1
  584. package/src/states/error-state/error-state.tsx +23 -8
  585. package/src/states/index.ts +1 -0
  586. package/src/states/live-status-bar/index.ts +6 -0
  587. package/src/states/live-status-bar/live-status-bar.tsx +62 -0
  588. package/src/states/offline-banner/offline-banner.tsx +13 -5
  589. package/src/states/skeleton/skeleton.tsx +68 -2
  590. package/src/utils/class-groups.ts +17 -0
  591. package/src/utils/index.ts +1 -0
  592. package/src/utils/material.ts +16 -0
  593. package/src/utils/tone.ts +29 -0
  594. package/src/utils/use-copy.ts +38 -0
  595. package/styles/Theme.kt +64 -3
  596. package/styles/base.css +51 -0
  597. package/styles/tailwind.css +836 -0
  598. package/styles/theme.css +579 -34
  599. package/styles/tokens.css +788 -15
  600. package/tokens/default.json +918 -29
  601. package/scripts/build-theme.d.ts +0 -18
@@ -0,0 +1,184 @@
1
+ "use client";
2
+
3
+ import { type ReactNode, useEffect, useId, useRef, useState } from "react";
4
+ import { Check } from "../../icons/index.js";
5
+ import type { ClassNames } from "../../utils/class-names.js";
6
+ import { cn } from "../../utils/cn.js";
7
+ import { useComposedRefs } from "../../utils/compose.js";
8
+ import { useRovingFocus } from "../../utils/roving-focus.js";
9
+ import { useControllableState } from "../../utils/use-controllable-state.js";
10
+
11
+ export interface ChipGroupOption {
12
+ value: string;
13
+ label: ReactNode;
14
+ /** Small count after the label. */
15
+ count?: ReactNode;
16
+ /** Decorative glyph before the label (replaced by a check while selected in a multiple group). */
17
+ icon?: ReactNode;
18
+ disabled?: boolean;
19
+ }
20
+
21
+ export type ChipGroupPart = "root" | "chip" | "label" | "count" | "check";
22
+
23
+ interface ChipGroupCommon {
24
+ options: readonly ChipGroupOption[];
25
+ disabled?: boolean | undefined;
26
+ /** Form field name: a hidden input per selected value. */
27
+ name?: string | undefined;
28
+ /** Marks the group invalid (also set by `Field` through `aria-invalid`). */
29
+ invalid?: boolean | undefined;
30
+ /** Set by `Field`; the group is named from the field's label. */
31
+ id?: string | undefined;
32
+ "aria-label"?: string | undefined;
33
+ "aria-labelledby"?: string | undefined;
34
+ "aria-describedby"?: string | undefined;
35
+ "aria-invalid"?: boolean | "true" | "false" | undefined;
36
+ className?: string | undefined;
37
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root. */
38
+ classNames?: ClassNames<ChipGroupPart>;
39
+ }
40
+
41
+ export interface ChipGroupMultipleProps extends ChipGroupCommon {
42
+ /** Any number of chips can be on. This is the default. */
43
+ type?: "multiple";
44
+ value?: string[] | undefined;
45
+ defaultValue?: string[] | undefined;
46
+ onValueChange?: ((value: string[]) => void) | undefined;
47
+ }
48
+
49
+ export interface ChipGroupSingleProps extends ChipGroupCommon {
50
+ /** At most one chip is on. */
51
+ type: "single";
52
+ value?: string | undefined;
53
+ defaultValue?: string | undefined;
54
+ onValueChange?: ((value: string) => void) | undefined;
55
+ /** Lets the pressed chip be pressed again to clear the choice (`""`). Off by default: a filter keeps one on. */
56
+ allowDeselect?: boolean | undefined;
57
+ }
58
+
59
+ export type ChipGroupProps = ChipGroupMultipleProps | ChipGroupSingleProps;
60
+
61
+ /**
62
+ * A set of chips that act as toggle buttons (`aria-pressed`) in a `fieldset` (a named group): pick several
63
+ * (`type="multiple"`, default) or one (`type="single"`). Arrow keys, Home and End move between
64
+ * chips and Space or Enter toggles; the group works inside `Field` (named from its label,
65
+ * described by its hint and error) and submits one hidden input per selected value when named.
66
+ */
67
+ export function ChipGroup(props: ChipGroupProps) {
68
+ const {
69
+ options,
70
+ disabled,
71
+ name,
72
+ invalid,
73
+ id,
74
+ className,
75
+ classNames,
76
+ "aria-label": ariaLabel,
77
+ "aria-labelledby": ariaLabelledBy,
78
+ "aria-describedby": ariaDescribedBy,
79
+ "aria-invalid": ariaInvalid,
80
+ } = props;
81
+ const single = props.type === "single";
82
+ const generated = useId();
83
+ const baseId = id ?? generated;
84
+
85
+ const [multiValue, setMultiValue] = useControllableState<string[]>({
86
+ prop: props.type === "single" ? undefined : props.value,
87
+ defaultProp: (props.type === "single" ? undefined : props.defaultValue) ?? [],
88
+ onChange: props.type === "single" ? undefined : props.onValueChange,
89
+ });
90
+ const [singleValue, setSingleValue] = useControllableState<string>({
91
+ prop: props.type === "single" ? props.value : undefined,
92
+ defaultProp: (props.type === "single" ? props.defaultValue : undefined) ?? "",
93
+ onChange: props.type === "single" ? props.onValueChange : undefined,
94
+ });
95
+
96
+ const selected = single ? (singleValue ? [singleValue] : []) : multiValue;
97
+ const toggle = (value: string) => {
98
+ if (props.type === "single") {
99
+ if (singleValue === value) {
100
+ if (props.allowDeselect) setSingleValue("");
101
+ } else setSingleValue(value);
102
+ return;
103
+ }
104
+ setMultiValue(
105
+ multiValue.includes(value) ? multiValue.filter((v) => v !== value) : [...multiValue, value],
106
+ );
107
+ };
108
+
109
+ const roving = useRovingFocus({
110
+ activeId: selected.find((v) => options.some((o) => o.value === v && !o.disabled)) ?? null,
111
+ });
112
+ const { ref: rovingRef, onFocus: rovingOnFocus, tabIndex } = roving.rootProps;
113
+ const localRef = useRef<HTMLFieldSetElement | null>(null);
114
+ const composedRef = useComposedRefs<HTMLFieldSetElement>(rovingRef, localRef);
115
+
116
+ // A group is not a labelable element, so `Field`'s <label for> cannot name it: read its text.
117
+ const [fieldLabel, setFieldLabel] = useState<string | undefined>();
118
+ useEffect(() => {
119
+ if (ariaLabel || ariaLabelledBy || !id) return;
120
+ const label = Array.from(
121
+ localRef.current?.ownerDocument.querySelectorAll<HTMLLabelElement>("label[for]") ?? [],
122
+ ).find((candidate) => candidate.htmlFor === id);
123
+ setFieldLabel(label?.textContent?.trim() || undefined);
124
+ }, [id, ariaLabel, ariaLabelledBy]);
125
+
126
+ const isInvalid = invalid || ariaInvalid === true || ariaInvalid === "true";
127
+
128
+ return (
129
+ <fieldset
130
+ ref={composedRef}
131
+ id={baseId}
132
+ tabIndex={tabIndex}
133
+ aria-label={ariaLabel ?? (ariaLabelledBy ? undefined : fieldLabel)}
134
+ aria-labelledby={ariaLabelledBy}
135
+ aria-describedby={ariaDescribedBy}
136
+ data-type={single ? "single" : "multiple"}
137
+ data-invalid={isInvalid ? "" : undefined}
138
+ data-disabled={disabled ? "" : undefined}
139
+ onFocus={rovingOnFocus}
140
+ className={cn(
141
+ "group/chips m-0 flex min-w-0 flex-wrap gap-1.5 border-0 p-0 outline-none",
142
+ classNames?.root,
143
+ className,
144
+ )}
145
+ >
146
+ {options.map((option) => {
147
+ const pressed = selected.includes(option.value);
148
+ const off = disabled || option.disabled;
149
+ const item = roving.getItemProps<HTMLButtonElement>(option.value, { disabled: off });
150
+ return (
151
+ <button
152
+ key={option.value}
153
+ type="button"
154
+ aria-pressed={pressed}
155
+ disabled={off}
156
+ {...item}
157
+ onClick={() => toggle(option.value)}
158
+ className={cn(
159
+ "inline-flex min-h-7 cursor-pointer items-center gap-1.5 rounded-badge border-control bg-surface-control px-3 font-medium text-fs-130 text-ink-2 hover:bg-surface-2 focus-visible:focus-ring disabled:cursor-not-allowed disabled:opacity-50 aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-accent-ink group-data-[invalid]/chips:border-danger in-data-[density=touch]:min-h-11 [&_svg]:size-3",
160
+ classNames?.chip,
161
+ )}
162
+ >
163
+ {pressed && !single ? (
164
+ <Check aria-hidden="true" className={classNames?.check} />
165
+ ) : option.icon ? (
166
+ <span aria-hidden="true" className="inline-flex shrink-0">
167
+ {option.icon}
168
+ </span>
169
+ ) : null}
170
+ <span className={cn("min-w-0", classNames?.label)}>{option.label}</span>
171
+ {option.count !== undefined ? (
172
+ <span className={cn("text-count tabular-nums", classNames?.count)}>
173
+ {option.count}
174
+ </span>
175
+ ) : null}
176
+ </button>
177
+ );
178
+ })}
179
+ {name
180
+ ? selected.map((value) => <input key={value} type="hidden" name={name} value={value} />)
181
+ : null}
182
+ </fieldset>
183
+ );
184
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ ChipGroup,
3
+ type ChipGroupMultipleProps,
4
+ type ChipGroupOption,
5
+ type ChipGroupPart,
6
+ type ChipGroupProps,
7
+ type ChipGroupSingleProps,
8
+ } from "./chip-group.js";
@@ -0,0 +1,359 @@
1
+ "use client";
2
+
3
+ import {
4
+ type ComponentProps,
5
+ type KeyboardEvent,
6
+ useEffect,
7
+ useId,
8
+ useMemo,
9
+ useRef,
10
+ useState,
11
+ } from "react";
12
+ import { useUiStrings } from "../../i18n/index.js";
13
+ import { X } from "../../icons/index.js";
14
+ import * as PopoverPrimitive from "../../primitives/popover/popover.js";
15
+ import type { ClassNames } from "../../utils/class-names.js";
16
+ import { cn } from "../../utils/cn.js";
17
+ import { useComposedRefs } from "../../utils/compose.js";
18
+ import { type Material, materialClass } from "../../utils/material.js";
19
+ import { useControllableState } from "../../utils/use-controllable-state.js";
20
+ import {
21
+ filterItems,
22
+ flattenItems,
23
+ type ListboxGroup,
24
+ type ListboxOption,
25
+ matchesQuery,
26
+ moveActive,
27
+ } from "../internal/listbox.js";
28
+ import { LISTBOX_SURFACE, ListboxItems, optionDomId } from "../internal/listbox-items.js";
29
+
30
+ export type ComboboxOption = ListboxOption;
31
+ export type ComboboxGroup = ListboxGroup<ComboboxOption>;
32
+
33
+ export type ComboboxPart = "root" | "input" | "clear" | "content" | "option" | "group" | "status";
34
+
35
+ export interface ComboboxProps
36
+ extends Omit<
37
+ ComponentProps<"input">,
38
+ "value" | "defaultValue" | "onChange" | "type" | "role" | "size"
39
+ > {
40
+ /** Options, optionally nested in labelled groups. For async search, pass the current results. */
41
+ options: readonly (ComboboxOption | ComboboxGroup)[];
42
+ /** Selected option value (controlled). `""` means nothing is selected. */
43
+ value?: string;
44
+ defaultValue?: string;
45
+ onValueChange?: (value: string, option: ComboboxOption | null) => void;
46
+ /**
47
+ * Called on every keystroke with the text typed, and with `""` when the search resets. Debounce
48
+ * in the caller before fetching; the component never delays or cancels requests.
49
+ */
50
+ onSearchChange?: (query: string) => void;
51
+ /**
52
+ * Local filtering. `true` (default) matches label, description and keywords ignoring case and
53
+ * accents; `false` shows `options` as given (server-side search); a function decides per option.
54
+ */
55
+ filter?: boolean | ((option: ComboboxOption, query: string) => boolean);
56
+ /** Most options rendered at once. Default 50. */
57
+ maxVisible?: number;
58
+ /** Shows the loading status, e.g. while an async search is in flight. */
59
+ loading?: boolean;
60
+ loadingText?: string;
61
+ /** Shown when nothing matches. Defaults to the localized "No results". */
62
+ emptyText?: string;
63
+ /** Shows a button that clears the selection. Default `true`. */
64
+ clearable?: boolean;
65
+ clearLabel?: string;
66
+ /** Label to show for `value` while it is not (yet) among `options`, e.g. after an async search moved on. */
67
+ valueLabel?: string;
68
+ /** Submits the value (not the typed text) with a surrounding `<form>` through a hidden input. */
69
+ name?: string;
70
+ invalid?: boolean;
71
+ /**
72
+ * `required` always sets `aria-required`. The native attribute, which blocks form submission
73
+ * with the browser's own bubble before your validation can render, is added only when this is
74
+ * `true`. Default `false`.
75
+ */
76
+ nativeRequired?: boolean;
77
+ size?: "sm" | "md";
78
+ /** Portal target for the popup. Defaults to `document.body`; pass an element to keep a scoped `data-style`. */
79
+ container?: HTMLElement | null;
80
+ /** Popup surface material; see `PopoverContent`. */
81
+ material?: Material;
82
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
83
+ classNames?: ClassNames<ComboboxPart>;
84
+ }
85
+
86
+ /**
87
+ * Searchable single select (WAI-ARIA combobox with a listbox popup). The input shows the typed
88
+ * text while editing and the selected label otherwise; focus never leaves the input and the
89
+ * highlighted option is announced through `aria-activedescendant`. Works with local options or
90
+ * with results the caller loads from `onSearchChange`.
91
+ */
92
+ export function Combobox({
93
+ options,
94
+ value: valueProp,
95
+ defaultValue = "",
96
+ onValueChange,
97
+ onSearchChange,
98
+ filter = true,
99
+ maxVisible = 50,
100
+ loading = false,
101
+ loadingText,
102
+ emptyText,
103
+ clearable = true,
104
+ clearLabel,
105
+ valueLabel,
106
+ name,
107
+ invalid,
108
+ required,
109
+ nativeRequired = false,
110
+ size = "md",
111
+ container,
112
+ material,
113
+ disabled,
114
+ className,
115
+ classNames,
116
+ ref,
117
+ id,
118
+ onFocus,
119
+ onClick,
120
+ onBlur,
121
+ onKeyDown,
122
+ "aria-label": ariaLabel,
123
+ "aria-labelledby": ariaLabelledBy,
124
+ "aria-invalid": ariaInvalid,
125
+ ...props
126
+ }: ComboboxProps) {
127
+ const strings = useUiStrings();
128
+ const autoId = useId();
129
+ const inputId = id ?? autoId;
130
+ const listId = `${inputId}-listbox`;
131
+ const rootRef = useRef<HTMLDivElement | null>(null);
132
+ const inputRef = useRef<HTMLInputElement | null>(null);
133
+ const composedRef = useComposedRefs<HTMLInputElement>(ref, inputRef);
134
+ const allOptions = useMemo(() => flattenItems(options), [options]);
135
+ const [value, setValue] = useControllableState<string>({
136
+ prop: valueProp,
137
+ defaultProp: defaultValue,
138
+ onChange: (next) =>
139
+ onValueChange?.(next, allOptions.find((option) => option.value === next) ?? null),
140
+ });
141
+ const [query, setQuery] = useState<string | null>(null);
142
+ const [open, setOpen] = useState(false);
143
+ const [active, setActive] = useState(0);
144
+
145
+ const text = query ?? "";
146
+ const items = useMemo(() => {
147
+ const predicate =
148
+ filter === false
149
+ ? () => true
150
+ : typeof filter === "function"
151
+ ? (option: ComboboxOption) => filter(option, text)
152
+ : (option: ComboboxOption) => matchesQuery(option, text);
153
+ return filterItems(options, predicate, maxVisible);
154
+ }, [options, filter, text, maxVisible]);
155
+ const flat = useMemo(() => flattenItems(items), [items]);
156
+
157
+ const selected = value === "" ? undefined : allOptions.find((option) => option.value === value);
158
+ const selectedLabel = selected?.label ?? (value === "" ? "" : (valueLabel ?? ""));
159
+ const isOpen = open && !disabled;
160
+ const showList = isOpen && flat.length > 0;
161
+ const showEmpty = isOpen && !loading && flat.length === 0;
162
+ const activeIndex =
163
+ flat[active] && !flat[active]?.disabled ? active : moveActive(flat, -1, "first");
164
+ // biome-ignore lint/correctness/useExhaustiveDependencies: the highlight restarts when the text or the open state changes, not on every new results array.
165
+ useEffect(() => setActive(0), [query, isOpen]);
166
+ useEffect(() => {
167
+ if (!showList || activeIndex < 0) return;
168
+ document
169
+ .getElementById(optionDomId(listId, activeIndex))
170
+ ?.scrollIntoView?.({ block: "nearest" });
171
+ }, [showList, activeIndex, listId]);
172
+
173
+ const resetSearch = () => {
174
+ if (query !== null) onSearchChange?.("");
175
+ setQuery(null);
176
+ };
177
+
178
+ const pick = (option: ComboboxOption | undefined) => {
179
+ if (!option || option.disabled) return;
180
+ setValue(option.value);
181
+ resetSearch();
182
+ setOpen(false);
183
+ };
184
+
185
+ const clear = () => {
186
+ setValue("");
187
+ resetSearch();
188
+ setOpen(false);
189
+ inputRef.current?.focus();
190
+ };
191
+
192
+ const handleKeyDown = (event: KeyboardEvent<HTMLInputElement>) => {
193
+ onKeyDown?.(event);
194
+ if (event.defaultPrevented || event.altKey || event.ctrlKey || event.metaKey) return;
195
+ const { key } = event;
196
+ if (key === "ArrowDown") {
197
+ event.preventDefault();
198
+ if (!isOpen) setOpen(true);
199
+ else setActive(moveActive(flat, activeIndex, "next"));
200
+ } else if (key === "ArrowUp") {
201
+ event.preventDefault();
202
+ if (!isOpen) setOpen(true);
203
+ else setActive(moveActive(flat, activeIndex, "prev"));
204
+ } else if (key === "Enter") {
205
+ if (showList && flat[activeIndex]) {
206
+ event.preventDefault();
207
+ pick(flat[activeIndex]);
208
+ }
209
+ } else if (key === "Escape") {
210
+ if (isOpen) {
211
+ event.preventDefault();
212
+ setOpen(false);
213
+ } else if (query !== null) {
214
+ event.preventDefault();
215
+ resetSearch();
216
+ }
217
+ } else if (key === "Backspace" && clearable && text === "" && query !== null && selected) {
218
+ clear();
219
+ }
220
+ };
221
+
222
+ const hasClear = clearable && !disabled && value !== "";
223
+
224
+ return (
225
+ <PopoverPrimitive.Root open={isOpen} onOpenChange={setOpen}>
226
+ <PopoverPrimitive.Anchor asChild>
227
+ <div
228
+ ref={rootRef}
229
+ className={cn("relative flex w-full min-w-0", classNames?.root, className)}
230
+ >
231
+ <input
232
+ {...props}
233
+ ref={composedRef}
234
+ id={inputId}
235
+ type="text"
236
+ role="combobox"
237
+ data-ui-layer=""
238
+ autoComplete="off"
239
+ aria-expanded={isOpen}
240
+ aria-controls={isOpen ? listId : undefined}
241
+ aria-autocomplete="list"
242
+ aria-activedescendant={
243
+ showList && activeIndex >= 0 ? optionDomId(listId, activeIndex) : undefined
244
+ }
245
+ aria-label={ariaLabel}
246
+ aria-labelledby={ariaLabelledBy}
247
+ aria-invalid={ariaInvalid ?? (invalid || undefined)}
248
+ aria-required={required || undefined}
249
+ required={nativeRequired ? required : undefined}
250
+ disabled={disabled}
251
+ value={query ?? selectedLabel}
252
+ onFocus={(event) => {
253
+ onFocus?.(event);
254
+ event.currentTarget.select();
255
+ setOpen(true);
256
+ }}
257
+ onClick={(event) => {
258
+ onClick?.(event);
259
+ setOpen(true);
260
+ }}
261
+ onChange={(event) => {
262
+ setQuery(event.target.value);
263
+ onSearchChange?.(event.target.value);
264
+ setOpen(true);
265
+ }}
266
+ onBlur={(event) => {
267
+ onBlur?.(event);
268
+ setOpen(false);
269
+ resetSearch();
270
+ }}
271
+ onKeyDown={handleKeyDown}
272
+ className={cn(
273
+ "w-full min-w-0 rounded-input border-control bg-surface-control pl-3 text-control text-ink placeholder:text-ink-3 focus:border-transparent focus:outline-2 focus:outline-accent-ink focus:-outline-offset-1 disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-danger",
274
+ size === "sm" ? "h-control-sm" : "h-input min-h-(--touch-target)",
275
+ hasClear ? "pr-8" : "pr-3",
276
+ classNames?.input,
277
+ )}
278
+ />
279
+ {hasClear ? (
280
+ <button
281
+ type="button"
282
+ aria-label={clearLabel ?? strings.clear}
283
+ onPointerDown={(event) => event.preventDefault()}
284
+ onMouseDown={(event) => event.preventDefault()}
285
+ onClick={clear}
286
+ className={cn(
287
+ "absolute inset-y-0 right-0 flex w-8 items-center justify-center rounded-input text-ink-3 outline-none hover:text-ink focus-visible:focus-ring",
288
+ classNames?.clear,
289
+ )}
290
+ >
291
+ <X aria-hidden="true" className="size-3.5" />
292
+ </button>
293
+ ) : null}
294
+ {name ? <input type="hidden" name={name} value={value} disabled={disabled} /> : null}
295
+ </div>
296
+ </PopoverPrimitive.Anchor>
297
+ <PopoverPrimitive.Portal container={container}>
298
+ <PopoverPrimitive.Content
299
+ role="presentation"
300
+ sideOffset={4}
301
+ collisionPadding={8}
302
+ align="start"
303
+ // Focus stays in the input, going in and out.
304
+ onOpenAutoFocus={(event) => event.preventDefault()}
305
+ onCloseAutoFocus={(event) => event.preventDefault()}
306
+ onInteractOutside={(event) => {
307
+ if (rootRef.current?.contains(event.detail.originalEvent.target as Node)) {
308
+ event.preventDefault();
309
+ }
310
+ }}
311
+ className={cn(
312
+ LISTBOX_SURFACE,
313
+ materialClass(material, "surface-solid"),
314
+ classNames?.content,
315
+ )}
316
+ >
317
+ {loading ? (
318
+ <p
319
+ role="status"
320
+ className={cn("px-2.5 py-1.5 text-ink-3 text-meta", classNames?.status)}
321
+ >
322
+ {loadingText ?? strings.loading}
323
+ </p>
324
+ ) : null}
325
+ {showEmpty ? (
326
+ <p
327
+ role="status"
328
+ className={cn("px-2.5 py-1.5 text-ink-3 text-meta", classNames?.status)}
329
+ >
330
+ {emptyText ?? strings.noResults}
331
+ </p>
332
+ ) : null}
333
+ <div
334
+ id={listId}
335
+ role="listbox"
336
+ data-ui-layer=""
337
+ hidden={!showList}
338
+ aria-label={ariaLabelledBy ? undefined : ariaLabel}
339
+ aria-labelledby={ariaLabelledBy}
340
+ >
341
+ {showList ? (
342
+ <ListboxItems
343
+ items={items}
344
+ flat={flat}
345
+ idBase={listId}
346
+ isSelected={(option) => option.value === value}
347
+ activeIndex={activeIndex}
348
+ onActivate={setActive}
349
+ onPick={pick}
350
+ optionClassName={classNames?.option}
351
+ groupClassName={classNames?.group}
352
+ />
353
+ ) : null}
354
+ </div>
355
+ </PopoverPrimitive.Content>
356
+ </PopoverPrimitive.Portal>
357
+ </PopoverPrimitive.Root>
358
+ );
359
+ }
@@ -0,0 +1,7 @@
1
+ export {
2
+ Combobox,
3
+ type ComboboxGroup,
4
+ type ComboboxOption,
5
+ type ComboboxPart,
6
+ type ComboboxProps,
7
+ } from "./combobox.js";
@@ -0,0 +1,88 @@
1
+ "use client";
2
+
3
+ import { type ComponentPropsWithoutRef, type ReactNode, useId } from "react";
4
+ import { useUiStrings } from "../../i18n/index.js";
5
+ import { Check, Copy } from "../../icons/index.js";
6
+ import type { ClassNames } from "../../utils/class-names.js";
7
+ import { cn } from "../../utils/cn.js";
8
+ import { useCopy } from "../../utils/use-copy.js";
9
+
10
+ export type CopyFieldPart = "root" | "label" | "box" | "value" | "button";
11
+
12
+ export interface CopyFieldProps
13
+ extends Omit<ComponentPropsWithoutRef<"div">, "children" | "onCopy"> {
14
+ label: ReactNode;
15
+ /** Text shown in monospace and written to the clipboard. */
16
+ value: string;
17
+ /** Called after the value was copied. */
18
+ onCopy?: (value: string) => void;
19
+ /** Accessible name of the button; defaults to the UI string `copy`. */
20
+ copyLabel?: string;
21
+ /** Announced and shown on the button after copying; defaults to the UI string `copied`. */
22
+ copiedLabel?: string;
23
+ /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
24
+ classNames?: ClassNames<CopyFieldPart>;
25
+ }
26
+
27
+ export function CopyField({
28
+ label,
29
+ value,
30
+ onCopy,
31
+ copyLabel,
32
+ copiedLabel,
33
+ className,
34
+ classNames,
35
+ ...props
36
+ }: CopyFieldProps) {
37
+ const strings = useUiStrings();
38
+ const id = useId();
39
+ const { copied, copy } = useCopy(1500);
40
+ const buttonLabel = copied ? (copiedLabel ?? strings.copied) : (copyLabel ?? strings.copy);
41
+
42
+ return (
43
+ <div {...props} className={cn("flex min-w-0 flex-col gap-1.5", classNames?.root, className)}>
44
+ <label htmlFor={id} className={cn("font-semibold text-ink-2 text-meta", classNames?.label)}>
45
+ {label}
46
+ </label>
47
+ <div
48
+ className={cn(
49
+ "flex min-w-0 items-center gap-2 rounded-input border-control bg-surface-control pr-1 pl-3",
50
+ classNames?.box,
51
+ )}
52
+ >
53
+ <input
54
+ id={id}
55
+ readOnly
56
+ value={value}
57
+ onFocus={(event) => event.currentTarget.select()}
58
+ className={cn(
59
+ "h-input min-w-0 flex-1 truncate bg-transparent font-mono text-control text-ink focus:outline-none",
60
+ classNames?.value,
61
+ )}
62
+ />
63
+ <button
64
+ type="button"
65
+ onClick={() => {
66
+ void copy(value);
67
+ onCopy?.(value);
68
+ }}
69
+ className={cn(
70
+ "inline-flex h-control-sm shrink-0 cursor-pointer items-center gap-1.5 rounded-button px-2.5 font-semibold text-ink-2 text-meta hover:bg-surface-2 hover:text-ink focus-visible:focus-ring in-data-[density=touch]:h-11",
71
+ copied && "text-success",
72
+ classNames?.button,
73
+ )}
74
+ >
75
+ {copied ? (
76
+ <Check aria-hidden="true" className="size-4" />
77
+ ) : (
78
+ <Copy aria-hidden="true" className="size-4" />
79
+ )}
80
+ <span>{buttonLabel}</span>
81
+ </button>
82
+ </div>
83
+ <span role="status" className="sr-only">
84
+ {copied ? (copiedLabel ?? strings.copied) : null}
85
+ </span>
86
+ </div>
87
+ );
88
+ }
@@ -0,0 +1 @@
1
+ export { CopyField, type CopyFieldPart, type CopyFieldProps } from "./copy-field.js";