@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
@@ -1,7 +1,17 @@
1
1
  "use client";
2
2
 
3
- import { type ChangeEvent, type DragEvent, useRef, useState } from "react";
4
- import { Upload } from "../../icons/index.js";
3
+ import {
4
+ type ChangeEvent,
5
+ type ChangeEventHandler,
6
+ type DragEvent,
7
+ type MouseEvent,
8
+ useEffect,
9
+ useId,
10
+ useRef,
11
+ useState,
12
+ } from "react";
13
+ import { useUiStrings } from "../../i18n/index.js";
14
+ import { Upload, X } from "../../icons/index.js";
5
15
  import type { ClassNames } from "../../utils/class-names.js";
6
16
  import { cn } from "../../utils/cn.js";
7
17
 
@@ -12,7 +22,7 @@ export interface DropzoneRejection {
12
22
  reason: DropzoneRejectionReason;
13
23
  }
14
24
 
15
- export type DropzonePart = "root" | "icon" | "title" | "hint" | "browse";
25
+ export type DropzonePart = "root" | "icon" | "title" | "hint" | "browse" | "list" | "file";
16
26
 
17
27
  export interface DropzoneProps {
18
28
  onFiles: (files: File[]) => void;
@@ -25,6 +35,33 @@ export interface DropzoneProps {
25
35
  title: string;
26
36
  hint?: string;
27
37
  browseLabel: string;
38
+ /**
39
+ * `zone` (default): a drop target with a browse button. `field`: a form control. The real
40
+ * `<input type="file">` is the focusable, labelled element (Tab to it, Enter or Space opens the picker, a
41
+ * `Field` label points at it), clicking anywhere in the box opens the picker, the selection stays in the
42
+ * input so `name` submits it, and the props below apply.
43
+ */
44
+ mode?: "zone" | "field";
45
+ /**
46
+ * Accepted file types as the native `accept` attribute: MIME types, wildcards and extensions
47
+ * (".pdf,image/*"). Validated like `acceptedTypes`; both can be given.
48
+ */
49
+ accept?: string;
50
+ /** Field mode: id of the file input (`Field` sets it). */
51
+ id?: string;
52
+ /** Field mode: name the selected files are submitted under. */
53
+ name?: string;
54
+ /** Field mode: native change event of the input, after rejected files were dropped from it. */
55
+ onChange?: ChangeEventHandler<HTMLInputElement>;
56
+ /** Field mode: lists the selected files, each with a remove button. */
57
+ showFiles?: boolean;
58
+ disabled?: boolean;
59
+ required?: boolean;
60
+ invalid?: boolean;
61
+ "aria-label"?: string;
62
+ "aria-labelledby"?: string;
63
+ "aria-describedby"?: string;
64
+ "aria-invalid"?: boolean;
28
65
  className?: string;
29
66
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
30
67
  classNames?: ClassNames<DropzonePart>;
@@ -32,9 +69,23 @@ export interface DropzoneProps {
32
69
 
33
70
  function isTypeAllowed(file: File, acceptedTypes?: string[]) {
34
71
  if (!acceptedTypes || acceptedTypes.length === 0) return true;
35
- return acceptedTypes.some((type) =>
36
- type.endsWith("/*") ? file.type.startsWith(type.slice(0, -1)) : file.type === type,
37
- );
72
+ return acceptedTypes.some((type) => {
73
+ if (type.startsWith(".")) return file.name.toLowerCase().endsWith(type.toLowerCase());
74
+ return type.endsWith("/*") ? file.type.startsWith(type.slice(0, -1)) : file.type === type;
75
+ });
76
+ }
77
+
78
+ function formatBytes(bytes: number) {
79
+ if (bytes < 1024) return `${bytes} B`;
80
+ if (bytes < 1024 * 1024) return `${Math.round(bytes / 1024)} KB`;
81
+ return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
82
+ }
83
+
84
+ /** Puts `files` into a file input; browsers only accept a `FileList` built through a `DataTransfer`. */
85
+ function setInputFiles(input: HTMLInputElement, files: File[]) {
86
+ const transfer = new DataTransfer();
87
+ for (const file of files) transfer.items.add(file);
88
+ input.files = transfer.files;
38
89
  }
39
90
 
40
91
  function validateFiles(
@@ -67,42 +118,117 @@ export function Dropzone({
67
118
  title,
68
119
  hint,
69
120
  browseLabel,
121
+ mode = "zone",
122
+ accept,
123
+ id,
124
+ name,
125
+ onChange,
126
+ showFiles,
127
+ disabled,
128
+ required,
129
+ invalid,
130
+ "aria-label": ariaLabel,
131
+ "aria-labelledby": ariaLabelledBy,
132
+ "aria-describedby": ariaDescribedBy,
133
+ "aria-invalid": ariaInvalid,
70
134
  className,
71
135
  classNames,
72
136
  }: DropzoneProps) {
137
+ const strings = useUiStrings();
73
138
  const inputRef = useRef<HTMLInputElement>(null);
74
139
  const [dragging, setDragging] = useState(false);
140
+ const [selected, setSelected] = useState<File[]>([]);
141
+ const autoId = useId();
142
+ const inputId = id ?? autoId;
143
+ const field = mode === "field";
144
+ const types = [
145
+ ...(acceptedTypes ?? []),
146
+ ...(accept
147
+ ?.split(",")
148
+ .map((type) => type.trim())
149
+ .filter(Boolean) ?? []),
150
+ ];
151
+
152
+ // A form reset empties the input; keep the visible list in step.
153
+ useEffect(() => {
154
+ const form = inputRef.current?.form;
155
+ if (!field || !form) return;
156
+ const reset = () => setSelected([]);
157
+ form.addEventListener("reset", reset);
158
+ return () => form.removeEventListener("reset", reset);
159
+ }, [field]);
75
160
 
76
- function process(list: FileList | null) {
77
- if (!list || list.length === 0) return;
78
- const { accepted, rejected } = validateFiles(Array.from(list), acceptedTypes, maxSizeBytes);
161
+ function process(list: FileList | File[] | null) {
162
+ if (!list || list.length === 0) return [];
163
+ const { accepted, rejected } = validateFiles(Array.from(list), types, maxSizeBytes);
79
164
  if (rejected.length > 0) onReject?.(rejected);
80
165
  if (accepted.length > 0) onFiles(accepted);
166
+ return accepted;
167
+ }
168
+
169
+ /** Field mode: runs the change through the input so `onChange` and form submission see one state. */
170
+ function assign(files: File[]) {
171
+ const input = inputRef.current;
172
+ if (!input || disabled) return;
173
+ setInputFiles(input, multiple ? files : files.slice(0, 1));
174
+ input.dispatchEvent(new Event("change", { bubbles: true }));
81
175
  }
82
176
 
83
177
  function handleDrop(event: DragEvent<HTMLDivElement>) {
84
178
  event.preventDefault();
85
179
  setDragging(false);
86
- process(event.dataTransfer.files);
180
+ if (disabled) return;
181
+ if (field) assign(Array.from(event.dataTransfer.files));
182
+ else process(event.dataTransfer.files);
87
183
  }
88
184
 
89
185
  function handleInputChange(event: ChangeEvent<HTMLInputElement>) {
90
- process(event.target.files);
91
- event.target.value = "";
186
+ if (!field) {
187
+ process(event.target.files);
188
+ event.target.value = "";
189
+ return;
190
+ }
191
+ const accepted = process(event.target.files);
192
+ const picked = event.target.files?.length ?? 0;
193
+ // Rejected files leave the input too, so the form never submits them.
194
+ if (accepted.length !== picked) setInputFiles(event.target, accepted);
195
+ setSelected(accepted);
196
+ onChange?.(event);
197
+ }
198
+
199
+ function openPicker(event: MouseEvent<HTMLDivElement>) {
200
+ const target = event.target as HTMLElement;
201
+ if (!field || disabled || target === inputRef.current || target.closest("[data-dropzone-list]"))
202
+ return;
203
+ inputRef.current?.click();
92
204
  }
93
205
 
206
+ const titleId = `${inputId}-title`;
207
+ const hintId = `${inputId}-hint`;
208
+
209
+ const browse = cn(
210
+ "mt-1 inline-flex h-control-sm max-w-full items-center justify-center rounded-input border-control bg-surface-control px-3 font-semibold text-chip-text hover:bg-surface-2",
211
+ classNames?.browse,
212
+ );
213
+
94
214
  return (
95
- // biome-ignore lint/a11y/noStaticElementInteractions: the browse button is the keyboard-accessible path; dragging is an extra shortcut
215
+ // biome-ignore lint/a11y/useKeyWithClickEvents: the file input inside is the keyboard path; the click only forwards to it
216
+ // biome-ignore lint/a11y/noStaticElementInteractions: in zone mode the browse button is the keyboard path and in field mode the file input is; dragging and clicking the box are shortcuts
96
217
  <div
97
218
  className={cn(
98
219
  "@container/dropzone flex min-w-0 flex-col items-center gap-1.5 rounded-tile border-[1.5px] border-line-control border-dashed bg-surface-2 p-3 text-center text-ink-2 @min-[360px]/dropzone:p-5.5",
99
220
  dragging && "border-accent-ink bg-accent-soft",
221
+ field &&
222
+ "cursor-pointer has-[input:focus-visible]:outline-2 has-[input:focus-visible]:outline-offset-2 has-[input:focus-visible]:outline-accent-ink",
223
+ field && (invalid || ariaInvalid) && "border-danger",
224
+ field && disabled && "cursor-not-allowed opacity-50",
100
225
  classNames?.root,
101
226
  className,
102
227
  )}
228
+ onClick={openPicker}
103
229
  onDragOver={(event) => {
104
230
  event.preventDefault();
105
- setDragging(true);
231
+ if (!disabled) setDragging(true);
106
232
  }}
107
233
  onDragLeave={() => setDragging(false)}
108
234
  onDrop={handleDrop}
@@ -111,11 +237,15 @@ export function Dropzone({
111
237
  aria-hidden="true"
112
238
  className={cn("size-4.5 @min-[360px]/dropzone:size-5.5", classNames?.icon)}
113
239
  />
114
- <b className={cn("max-w-full text-control [overflow-wrap:anywhere]", classNames?.title)}>
240
+ <b
241
+ id={titleId}
242
+ className={cn("max-w-full text-control [overflow-wrap:anywhere]", classNames?.title)}
243
+ >
115
244
  {title}
116
245
  </b>
117
246
  {hint ? (
118
247
  <span
248
+ id={hintId}
119
249
  className={cn(
120
250
  "max-w-full text-meta text-ink-3 [overflow-wrap:anywhere]",
121
251
  classNames?.hint,
@@ -124,26 +254,78 @@ export function Dropzone({
124
254
  {hint}
125
255
  </span>
126
256
  ) : null}
127
- <button
128
- type="button"
129
- className={cn(
130
- "mt-1 inline-flex h-control-sm max-w-full items-center justify-center rounded-input border-control bg-surface-control px-3 font-semibold text-chip-text hover:bg-surface-2",
131
- classNames?.browse,
132
- )}
133
- onClick={() => inputRef.current?.click()}
134
- >
135
- {browseLabel}
136
- </button>
137
- <input
138
- ref={inputRef}
139
- type="file"
140
- multiple={multiple}
141
- accept={acceptedTypes?.join(",")}
142
- className="hidden"
143
- tabIndex={-1}
144
- aria-hidden="true"
145
- onChange={handleInputChange}
146
- />
257
+ {field ? (
258
+ <span aria-hidden="true" className={browse}>
259
+ {browseLabel}
260
+ </span>
261
+ ) : (
262
+ <button type="button" className={browse} onClick={() => inputRef.current?.click()}>
263
+ {browseLabel}
264
+ </button>
265
+ )}
266
+ {field && showFiles && selected.length > 0 ? (
267
+ <ul
268
+ data-dropzone-list=""
269
+ className={cn(
270
+ "flex w-full min-w-0 cursor-default flex-col gap-1 text-left",
271
+ classNames?.list,
272
+ )}
273
+ >
274
+ {selected.map((file, index) => (
275
+ <li
276
+ key={`${file.name}-${file.size}-${file.lastModified}`}
277
+ className={cn(
278
+ "flex min-w-0 items-center gap-2 rounded-input bg-surface-control px-2 py-1 text-meta text-ink",
279
+ classNames?.file,
280
+ )}
281
+ >
282
+ <span className="min-w-0 flex-1 truncate">{file.name}</span>
283
+ <span className="shrink-0 text-ink-3 tabular-nums">{formatBytes(file.size)}</span>
284
+ <button
285
+ type="button"
286
+ aria-label={`${strings.remove} ${file.name}`}
287
+ disabled={disabled}
288
+ className="grid size-6 shrink-0 place-items-center rounded-button text-ink-3 hover:bg-surface-2 hover:text-ink focus-visible:focus-ring"
289
+ onClick={() => assign(selected.filter((_, at) => at !== index))}
290
+ >
291
+ <X aria-hidden="true" className="size-3.5" />
292
+ </button>
293
+ </li>
294
+ ))}
295
+ </ul>
296
+ ) : null}
297
+ {field ? (
298
+ <input
299
+ ref={inputRef}
300
+ id={inputId}
301
+ name={name}
302
+ type="file"
303
+ className="sr-only"
304
+ multiple={multiple}
305
+ accept={types.join(",") || undefined}
306
+ disabled={disabled}
307
+ required={required}
308
+ aria-label={ariaLabel}
309
+ aria-labelledby={ariaLabelledBy}
310
+ aria-describedby={
311
+ [ariaDescribedBy, titleId, hint ? hintId : undefined].filter(Boolean).join(" ") ||
312
+ undefined
313
+ }
314
+ aria-invalid={ariaInvalid ?? (invalid || undefined)}
315
+ onChange={handleInputChange}
316
+ />
317
+ ) : (
318
+ <input
319
+ ref={inputRef}
320
+ type="file"
321
+ multiple={multiple}
322
+ accept={types.join(",") || undefined}
323
+ className="hidden"
324
+ tabIndex={-1}
325
+ aria-hidden="true"
326
+ onChange={handleInputChange}
327
+ />
328
+ )}
147
329
  </div>
148
330
  );
149
331
  }
@@ -79,7 +79,7 @@ export function EmojiPicker({
79
79
  return (
80
80
  <div
81
81
  className={cn(
82
- "@container/emoji flex w-full max-w-xs min-w-0 flex-col gap-density-sm rounded-popover border-card bg-surface-overlay p-card text-ink",
82
+ "@container/emoji flex w-full max-w-xs min-w-0 flex-col gap-density-sm rounded-popover border-card surface-overlay p-card text-ink",
83
83
  classNames?.root,
84
84
  className,
85
85
  )}
@@ -3,9 +3,14 @@
3
3
  import {
4
4
  type ComponentPropsWithoutRef,
5
5
  cloneElement,
6
+ Fragment,
6
7
  isValidElement,
7
8
  type ReactElement,
9
+ type ReactNode,
10
+ useEffect,
8
11
  useId,
12
+ useRef,
13
+ useState,
9
14
  } from "react";
10
15
  import { useUiStrings } from "../../i18n/index.js";
11
16
  import type { ClassNames } from "../../utils/class-names.js";
@@ -18,17 +23,34 @@ interface ControlProps {
18
23
  "aria-invalid"?: boolean;
19
24
  }
20
25
 
26
+ const FORM_TAGS = new Set(["input", "select", "textarea", "button"]);
27
+ const CONTROL =
28
+ 'input:not([type="hidden"]):not([disabled]), select, textarea, [role="combobox"], [role="spinbutton"], [role="slider"], [contenteditable="true"]';
29
+ const FALLBACK_CONTROL = 'button:not([tabindex="-1"]), [tabindex]:not([tabindex="-1"])';
30
+
21
31
  export type FieldPart = "root" | "label" | "optional" | "hint" | "error";
22
32
 
23
33
  export interface FieldProps extends Omit<ComponentPropsWithoutRef<"div">, "children" | "id"> {
24
- label: string;
34
+ /** The label content: text or any node (an icon, a tooltip trigger). */
35
+ label: ReactNode;
25
36
  hint?: string;
26
37
  /** Message under the control; `null` and `undefined` mean no error. */
27
38
  error?: string | null;
28
39
  /** Marks the field as optional by appending the localized marker to the label. */
29
40
  optional?: boolean;
41
+ /** Id of the control the label and messages belong to. Generated when omitted. */
30
42
  id?: string;
31
- children: ReactElement<ControlProps>;
43
+ /**
44
+ * Same as `id`, for fields with several children: the control carrying this id gets the
45
+ * description and invalid wiring and is what the label points at. Without it the first input,
46
+ * select, textarea or ARIA widget inside the field is used.
47
+ */
48
+ controlId?: string;
49
+ /**
50
+ * One control element (a component, or input, select, textarea) receives `id`, `aria-describedby` and `aria-invalid` directly. Several
51
+ * children (or a fragment, a plain wrapper element, or text) are rendered as given and the first control is wired after mount.
52
+ */
53
+ children: ReactNode;
32
54
  /** Per-part classes merged with `cn`; consumer classes win. `className` still targets the root and is merged last. */
33
55
  classNames?: ClassNames<FieldPart>;
34
56
  }
@@ -38,7 +60,8 @@ export function Field({
38
60
  hint,
39
61
  error,
40
62
  optional,
41
- id,
63
+ id: idProp,
64
+ controlId: controlIdProp,
42
65
  children,
43
66
  className,
44
67
  classNames,
@@ -46,19 +69,55 @@ export function Field({
46
69
  }: FieldProps) {
47
70
  const strings = useUiStrings();
48
71
  const generatedId = useId();
49
- const controlId = id ?? generatedId;
72
+ const baseId = controlIdProp ?? idProp ?? generatedId;
73
+ const [adoptedId, setAdoptedId] = useState<string | null>(null);
74
+ const controlId = adoptedId ?? baseId;
75
+ const bodyRef = useRef<HTMLDivElement | null>(null);
76
+ const single =
77
+ isValidElement<ControlProps>(children) &&
78
+ children.type !== Fragment &&
79
+ (typeof children.type !== "string" || FORM_TAGS.has(children.type));
50
80
  const hintId = hint ? `${controlId}-hint` : undefined;
51
81
  const errorId = error ? `${controlId}-error` : undefined;
52
82
  const describedBy = [hintId, errorId].filter(Boolean).join(" ") || undefined;
53
83
 
54
- const control = isValidElement(children)
55
- ? cloneElement(children, {
84
+ const control = single
85
+ ? cloneElement(children as ReactElement<ControlProps>, {
56
86
  id: controlId,
57
87
  "aria-describedby": describedBy,
58
88
  "aria-invalid": error ? true : undefined,
59
89
  })
60
90
  : children;
61
91
 
92
+ // Several children: wire the target control the way `cloneElement` does for a single one.
93
+ useEffect(() => {
94
+ const body = bodyRef.current;
95
+ if (single || !body) return;
96
+ const target =
97
+ (controlIdProp || idProp ? document.getElementById(baseId) : null) ??
98
+ body.querySelector<HTMLElement>(CONTROL) ??
99
+ body.querySelector<HTMLElement>(FALLBACK_CONTROL);
100
+ if (!target || !body.contains(target)) return;
101
+ if (!target.id) target.id = baseId;
102
+ setAdoptedId(target.id);
103
+ const before = {
104
+ describedby: target.getAttribute("aria-describedby"),
105
+ invalid: target.getAttribute("aria-invalid"),
106
+ };
107
+ const merged = [before.describedby, describedBy].filter(Boolean).join(" ");
108
+ if (merged) target.setAttribute("aria-describedby", merged);
109
+ if (error) target.setAttribute("aria-invalid", "true");
110
+ return () => {
111
+ for (const [name, value] of [
112
+ ["aria-describedby", before.describedby],
113
+ ["aria-invalid", before.invalid],
114
+ ] as const) {
115
+ if (value === null) target.removeAttribute(name);
116
+ else target.setAttribute(name, value);
117
+ }
118
+ };
119
+ }, [single, baseId, controlIdProp, idProp, describedBy, error]);
120
+
62
121
  return (
63
122
  <div {...props} className={cn("flex min-w-0 flex-col gap-1.25", classNames?.root, className)}>
64
123
  <Label htmlFor={controlId} className={classNames?.label}>
@@ -70,7 +129,13 @@ export function Field({
70
129
  </span>
71
130
  ) : null}
72
131
  </Label>
73
- {control}
132
+ {single ? (
133
+ control
134
+ ) : (
135
+ <div ref={bodyRef} className="contents">
136
+ {control}
137
+ </div>
138
+ )}
74
139
  {hint ? (
75
140
  <p id={hintId} className={cn("text-meta text-ink-3", classNames?.hint)}>
76
141
  {hint}
@@ -0,0 +1,46 @@
1
+ import type { ComponentPropsWithoutRef, ReactNode } from "react";
2
+ import { cn } from "../../utils/cn.js";
3
+
4
+ export type FormProps = ComponentPropsWithoutRef<"form">;
5
+
6
+ /** Vertical form layout; every `<form>` attribute and handler passes through. */
7
+ export function Form({ className, ...props }: FormProps) {
8
+ return <form className={cn("flex min-w-0 flex-col gap-4", className)} {...props} />;
9
+ }
10
+
11
+ interface FormMessageProps extends Omit<ComponentPropsWithoutRef<"p">, "role" | "children"> {
12
+ /** Message text; `null`, `undefined` and an empty string render nothing. */
13
+ message: ReactNode | null | undefined;
14
+ }
15
+
16
+ function hasMessage(message: ReactNode): boolean {
17
+ return message !== null && message !== undefined && message !== false && message !== "";
18
+ }
19
+
20
+ export type FormErrorProps = FormMessageProps;
21
+
22
+ /** Submit-level error. `role="alert"`, so assistive tech announces it as soon as it appears. */
23
+ export function FormError({ message, className, ...props }: FormErrorProps) {
24
+ if (!hasMessage(message)) return null;
25
+ return (
26
+ <p role="alert" className={cn("m-0 font-semibold text-danger text-meta", className)} {...props}>
27
+ {message}
28
+ </p>
29
+ );
30
+ }
31
+
32
+ export type FormStatusProps = FormMessageProps;
33
+
34
+ /** Submit-level confirmation. `role="status"`, a polite live region that does not interrupt. */
35
+ export function FormStatus({ message, className, ...props }: FormStatusProps) {
36
+ if (!hasMessage(message)) return null;
37
+ return (
38
+ <p
39
+ role="status"
40
+ className={cn("m-0 font-semibold text-meta text-success", className)}
41
+ {...props}
42
+ >
43
+ {message}
44
+ </p>
45
+ );
46
+ }
@@ -0,0 +1,8 @@
1
+ export {
2
+ Form,
3
+ FormError,
4
+ type FormErrorProps,
5
+ type FormProps,
6
+ FormStatus,
7
+ type FormStatusProps,
8
+ } from "./form.js";
@@ -1,9 +1,14 @@
1
1
  export * from "./accent-picker/index.js";
2
2
  export * from "./checkbox-button-group/index.js";
3
+ export * from "./chip-group/index.js";
4
+ export * from "./combobox/index.js";
5
+ export * from "./copy-field/index.js";
6
+ export * from "./date-picker/index.js";
3
7
  export * from "./dropzone/index.js";
4
8
  export * from "./emoji-picker/index.js";
5
9
  export * from "./emoji-reaction-button/index.js";
6
10
  export * from "./field/index.js";
11
+ export * from "./form/index.js";
7
12
  export * from "./form-grid/index.js";
8
13
  export * from "./inline-select/index.js";
9
14
  export * from "./input/index.js";
@@ -15,6 +20,7 @@ export * from "./pin-input/index.js";
15
20
  export * from "./radio-button-group/index.js";
16
21
  export * from "./rating/index.js";
17
22
  export * from "./select/index.js";
23
+ export * from "./select-menu/index.js";
18
24
  export * from "./slider/index.js";
19
25
  export * from "./textarea/index.js";
20
26
  export * from "./time-input/index.js";
@@ -1 +1,8 @@
1
- export { Input, type InputProps } from "./input.js";
1
+ export {
2
+ Input,
3
+ type InputPart,
4
+ type InputProps,
5
+ type InputSize,
6
+ type InputVariant,
7
+ inputSizeClasses,
8
+ } from "./input.js";