@brightlocal/ui-components 3.2.0 → 3.3.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 (428) hide show
  1. package/AI_USAGE.md +10 -0
  2. package/README.md +3 -1
  3. package/component-meta.json +1271 -428
  4. package/deprecations.json +44 -0
  5. package/dist/_virtual/_rolldown/runtime.cjs +1 -0
  6. package/dist/accordion.cjs +1 -1
  7. package/dist/accordion.js +73 -102
  8. package/dist/alert-dialog.cjs +1 -1
  9. package/dist/alert-dialog.d.ts +6 -4
  10. package/dist/alert-dialog.d.ts.map +1 -1
  11. package/dist/alert-dialog.js +85 -133
  12. package/dist/alert.cjs +1 -1
  13. package/dist/alert.d.ts +4 -4
  14. package/dist/alert.d.ts.map +1 -1
  15. package/dist/alert.js +106 -168
  16. package/dist/aspect-ratio.cjs +1 -1
  17. package/dist/aspect-ratio.js +13 -16
  18. package/dist/avatar.cjs +1 -1
  19. package/dist/avatar.js +30 -45
  20. package/dist/badge.cjs +1 -1
  21. package/dist/badge.d.ts +23 -1
  22. package/dist/badge.d.ts.map +1 -1
  23. package/dist/badge.js +90 -91
  24. package/dist/banner.cjs +1 -1
  25. package/dist/banner.js +102 -148
  26. package/dist/blocks/empty-state.cjs +1 -1
  27. package/dist/blocks/empty-state.d.ts +20 -3
  28. package/dist/blocks/empty-state.d.ts.map +1 -1
  29. package/dist/blocks/empty-state.js +73 -140
  30. package/dist/blocks/input-list.cjs +2 -2
  31. package/dist/blocks/input-list.d.ts +2 -2
  32. package/dist/blocks/input-list.d.ts.map +1 -1
  33. package/dist/blocks/input-list.js +136 -176
  34. package/dist/blocks/progress-state.cjs +1 -1
  35. package/dist/blocks/progress-state.js +223 -347
  36. package/dist/blocks/sidebar.cjs +1 -1
  37. package/dist/blocks/sidebar.d.ts +11 -6
  38. package/dist/blocks/sidebar.d.ts.map +1 -1
  39. package/dist/blocks/sidebar.js +763 -1092
  40. package/dist/brand-illustration-motif.cjs +1 -1
  41. package/dist/brand-illustration-motif.js +40 -61
  42. package/dist/breadcrumb.cjs +1 -1
  43. package/dist/breadcrumb.js +62 -102
  44. package/dist/button-group.cjs +1 -1
  45. package/dist/button-group.js +23 -31
  46. package/dist/button.cjs +1 -1
  47. package/dist/button.d.ts +4 -2
  48. package/dist/button.d.ts.map +1 -1
  49. package/dist/button.js +149 -189
  50. package/dist/calendar.cjs +1 -1
  51. package/dist/calendar.d.ts +87 -3
  52. package/dist/calendar.d.ts.map +1 -1
  53. package/dist/calendar.js +116 -173
  54. package/dist/callout.cjs +1 -1
  55. package/dist/callout.js +73 -96
  56. package/dist/card.cjs +1 -1
  57. package/dist/card.d.ts +10 -4
  58. package/dist/card.d.ts.map +1 -1
  59. package/dist/card.js +233 -316
  60. package/dist/carousel.cjs +1 -1
  61. package/dist/carousel.d.ts +3 -3
  62. package/dist/carousel.d.ts.map +1 -1
  63. package/dist/carousel.js +174 -268
  64. package/dist/centred-layout.cjs +1 -1
  65. package/dist/centred-layout.js +27 -48
  66. package/dist/chart-empty.cjs +1 -1
  67. package/dist/chart-empty.js +18 -27
  68. package/dist/chart.cjs +7 -7
  69. package/dist/chart.d.ts +23 -13
  70. package/dist/chart.d.ts.map +1 -1
  71. package/dist/chart.js +445 -651
  72. package/dist/checkbox.cjs +1 -1
  73. package/dist/checkbox.js +36 -69
  74. package/dist/chip.cjs +1 -1
  75. package/dist/chip.js +116 -173
  76. package/dist/collapsible.cjs +1 -1
  77. package/dist/collapsible.d.ts.map +1 -1
  78. package/dist/collapsible.js +35 -41
  79. package/dist/combobox.cjs +3 -3
  80. package/dist/combobox.d.ts +14 -4
  81. package/dist/combobox.d.ts.map +1 -1
  82. package/dist/combobox.js +439 -638
  83. package/dist/command.cjs +1 -1
  84. package/dist/command.d.ts.map +1 -1
  85. package/dist/command.js +273 -420
  86. package/dist/context-menu.cjs +1 -1
  87. package/dist/context-menu.d.ts +5 -5
  88. package/dist/context-menu.d.ts.map +1 -1
  89. package/dist/context-menu.js +121 -191
  90. package/dist/data-table.cjs +1 -1
  91. package/dist/data-table.d.ts +280 -129
  92. package/dist/data-table.d.ts.map +1 -1
  93. package/dist/data-table.js +687 -948
  94. package/dist/date-picker.cjs +1 -1
  95. package/dist/date-picker.d.ts +15 -4
  96. package/dist/date-picker.d.ts.map +1 -1
  97. package/dist/date-picker.js +156 -231
  98. package/dist/delta.cjs +1 -0
  99. package/dist/delta.d.ts +79 -0
  100. package/dist/delta.d.ts.map +1 -0
  101. package/dist/delta.js +62 -0
  102. package/dist/description.cjs +1 -1
  103. package/dist/description.js +11 -20
  104. package/dist/dialog.cjs +1 -1
  105. package/dist/dialog.d.ts +1 -1
  106. package/dist/dialog.d.ts.map +1 -1
  107. package/dist/dialog.js +76 -116
  108. package/dist/drawer.cjs +1 -1
  109. package/dist/drawer.d.ts +11 -11
  110. package/dist/drawer.d.ts.map +1 -1
  111. package/dist/drawer.js +76 -134
  112. package/dist/dropdown-menu.cjs +1 -1
  113. package/dist/dropdown-menu.d.ts +6 -6
  114. package/dist/dropdown-menu.d.ts.map +1 -1
  115. package/dist/dropdown-menu.js +179 -300
  116. package/dist/field.cjs +1 -1
  117. package/dist/field.d.ts +9 -9
  118. package/dist/field.d.ts.map +1 -1
  119. package/dist/field.js +166 -286
  120. package/dist/global-layout.cjs +1 -1
  121. package/dist/global-layout.js +203 -342
  122. package/dist/grid.cjs +1 -1
  123. package/dist/grid.js +16 -29
  124. package/dist/header.cjs +1 -1
  125. package/dist/header.js +21 -38
  126. package/dist/height-transition.cjs +1 -1
  127. package/dist/height-transition.js +38 -55
  128. package/dist/hooks/use-breakpoint.cjs +1 -1
  129. package/dist/hooks/use-breakpoint.js +9 -9
  130. package/dist/hooks/use-debounce.cjs +1 -1
  131. package/dist/hooks/use-debounce.js +12 -11
  132. package/dist/hooks/use-delayed-pending.cjs +1 -1
  133. package/dist/hooks/use-delayed-pending.js +8 -9
  134. package/dist/hooks/use-filter-search-params.cjs +1 -0
  135. package/dist/hooks/use-filter-search-params.d.ts +93 -0
  136. package/dist/hooks/use-filter-search-params.d.ts.map +1 -0
  137. package/dist/hooks/use-filter-search-params.js +122 -0
  138. package/dist/hooks/use-mobile.cjs +1 -1
  139. package/dist/hooks/use-mobile.js +6 -6
  140. package/dist/hooks/use-overlay-pointer-lock.cjs +1 -1
  141. package/dist/hooks/use-overlay-pointer-lock.js +8 -9
  142. package/dist/hooks/use-prefers-reduced-motion.cjs +1 -1
  143. package/dist/hooks/use-prefers-reduced-motion.js +5 -8
  144. package/dist/hover-card.cjs +1 -1
  145. package/dist/hover-card.d.ts +1 -1
  146. package/dist/hover-card.d.ts.map +1 -1
  147. package/dist/hover-card.js +30 -62
  148. package/dist/index.cjs +1 -1
  149. package/dist/index.d.ts +6 -0
  150. package/dist/index.d.ts.map +1 -1
  151. package/dist/index.js +630 -608
  152. package/dist/info-tooltip.cjs +1 -1
  153. package/dist/info-tooltip.js +22 -36
  154. package/dist/input-chip.cjs +1 -1
  155. package/dist/input-chip.d.ts +32 -3
  156. package/dist/input-chip.d.ts.map +1 -1
  157. package/dist/input-chip.js +181 -230
  158. package/dist/input-group.cjs +1 -1
  159. package/dist/input-group.js +174 -221
  160. package/dist/input-otp.cjs +1 -1
  161. package/dist/input-otp.d.ts +3 -3
  162. package/dist/input-otp.d.ts.map +1 -1
  163. package/dist/input-otp.js +102 -146
  164. package/dist/input-password.cjs +1 -1
  165. package/dist/input-password.d.ts +12 -16
  166. package/dist/input-password.d.ts.map +1 -1
  167. package/dist/input-password.js +139 -171
  168. package/dist/input.cjs +1 -1
  169. package/dist/input.d.ts.map +1 -1
  170. package/dist/input.js +51 -73
  171. package/dist/label.cjs +1 -1
  172. package/dist/label.js +20 -38
  173. package/dist/lib/block-illustration.cjs +1 -1
  174. package/dist/lib/block-illustration.d.ts +1 -1
  175. package/dist/lib/block-illustration.d.ts.map +1 -1
  176. package/dist/lib/block-illustration.js +16 -18
  177. package/dist/lib/compose-event-handlers.cjs +1 -0
  178. package/dist/lib/compose-event-handlers.d.ts +9 -0
  179. package/dist/lib/compose-event-handlers.d.ts.map +1 -0
  180. package/dist/lib/compose-event-handlers.js +8 -0
  181. package/dist/lib/download-file.cjs +1 -0
  182. package/dist/lib/download-file.d.ts +14 -0
  183. package/dist/lib/download-file.d.ts.map +1 -0
  184. package/dist/lib/download-file.js +40 -0
  185. package/dist/lib/empty-canvas.cjs +1 -1
  186. package/dist/lib/empty-canvas.js +28 -56
  187. package/dist/lib/empty-chip.cjs +1 -1
  188. package/dist/lib/empty-chip.d.ts +14 -3
  189. package/dist/lib/empty-chip.d.ts.map +1 -1
  190. package/dist/lib/empty-chip.js +15 -11
  191. package/dist/lib/field-aria.cjs +1 -0
  192. package/dist/lib/field-aria.d.ts +34 -0
  193. package/dist/lib/field-aria.d.ts.map +1 -0
  194. package/dist/lib/field-aria.js +52 -0
  195. package/dist/lib/image-file-info.cjs +1 -0
  196. package/dist/lib/image-file-info.d.ts +25 -0
  197. package/dist/lib/image-file-info.d.ts.map +1 -0
  198. package/dist/lib/image-file-info.js +67 -0
  199. package/dist/lib/media-viewer-content.cjs +1 -0
  200. package/dist/lib/media-viewer-content.d.ts +102 -0
  201. package/dist/lib/media-viewer-content.d.ts.map +1 -0
  202. package/dist/lib/media-viewer-content.js +650 -0
  203. package/dist/lib/media-viewer-internal.cjs +1 -0
  204. package/dist/lib/media-viewer-internal.d.ts +98 -0
  205. package/dist/lib/media-viewer-internal.d.ts.map +1 -0
  206. package/dist/lib/media-viewer-internal.js +61 -0
  207. package/dist/lib/media-viewer-motion.cjs +1 -0
  208. package/dist/lib/media-viewer-motion.d.ts +40 -0
  209. package/dist/lib/media-viewer-motion.d.ts.map +1 -0
  210. package/dist/lib/media-viewer-motion.js +37 -0
  211. package/dist/lib/motion.cjs +1 -1
  212. package/dist/lib/motion.d.ts +8 -0
  213. package/dist/lib/motion.d.ts.map +1 -1
  214. package/dist/lib/motion.js +11 -10
  215. package/dist/lib/optical-center.cjs +1 -1
  216. package/dist/lib/optical-center.d.ts +1 -1
  217. package/dist/lib/optical-center.d.ts.map +1 -1
  218. package/dist/lib/optical-center.js +12 -5
  219. package/dist/lib/spring-settle.cjs +1 -1
  220. package/dist/lib/spring-settle.js +1 -1
  221. package/dist/lib/table-internal.cjs +1 -0
  222. package/dist/lib/table-internal.d.ts +62 -0
  223. package/dist/lib/table-internal.d.ts.map +1 -0
  224. package/dist/lib/table-internal.js +18 -0
  225. package/dist/lib/use-controllable.cjs +1 -0
  226. package/dist/lib/use-controllable.d.ts +12 -0
  227. package/dist/lib/use-controllable.d.ts.map +1 -0
  228. package/dist/lib/use-controllable.js +15 -0
  229. package/dist/lib/use-dev-warning.cjs +1 -1
  230. package/dist/lib/utils.cjs +1 -1
  231. package/dist/lib/utils.js +26 -33
  232. package/dist/link.cjs +1 -1
  233. package/dist/link.d.ts +1 -1
  234. package/dist/link.js +78 -124
  235. package/dist/list.cjs +1 -1
  236. package/dist/list.d.ts +8 -0
  237. package/dist/list.d.ts.map +1 -1
  238. package/dist/list.js +94 -156
  239. package/dist/loading.cjs +1 -1
  240. package/dist/loading.js +124 -151
  241. package/dist/logo-mark.cjs +1 -0
  242. package/dist/logo-mark.d.ts +79 -0
  243. package/dist/logo-mark.d.ts.map +1 -0
  244. package/dist/logo-mark.js +219 -0
  245. package/dist/logo.cjs +1 -1
  246. package/dist/logo.d.ts +1 -1
  247. package/dist/logo.d.ts.map +1 -1
  248. package/dist/logo.js +51 -87
  249. package/dist/map.cjs +1 -1
  250. package/dist/map.d.ts.map +1 -1
  251. package/dist/map.js +390 -586
  252. package/dist/media-empty.cjs +1 -1
  253. package/dist/media-empty.js +27 -42
  254. package/dist/media-viewer.cjs +1 -0
  255. package/dist/media-viewer.d.ts +224 -0
  256. package/dist/media-viewer.d.ts.map +1 -0
  257. package/dist/media-viewer.js +295 -0
  258. package/dist/menubar.cjs +1 -1
  259. package/dist/menubar.d.ts +14 -14
  260. package/dist/menubar.d.ts.map +1 -1
  261. package/dist/menubar.js +130 -267
  262. package/dist/multi-select-filter.cjs +1 -1
  263. package/dist/multi-select-filter.d.ts +9 -1
  264. package/dist/multi-select-filter.d.ts.map +1 -1
  265. package/dist/multi-select-filter.js +357 -446
  266. package/dist/navigation-menu.cjs +1 -1
  267. package/dist/navigation-menu.js +108 -172
  268. package/dist/pagination.cjs +1 -1
  269. package/dist/pagination.d.ts +36 -12
  270. package/dist/pagination.d.ts.map +1 -1
  271. package/dist/pagination.js +208 -281
  272. package/dist/popover.cjs +1 -1
  273. package/dist/popover.d.ts +1 -1
  274. package/dist/popover.d.ts.map +1 -1
  275. package/dist/popover.js +34 -45
  276. package/dist/progress.cjs +1 -1
  277. package/dist/progress.d.ts +17 -2
  278. package/dist/progress.d.ts.map +1 -1
  279. package/dist/progress.js +116 -162
  280. package/dist/radio-group.cjs +1 -1
  281. package/dist/radio-group.js +90 -146
  282. package/dist/rating.cjs +1 -1
  283. package/dist/rating.d.ts +80 -13
  284. package/dist/rating.d.ts.map +1 -1
  285. package/dist/rating.js +70 -65
  286. package/dist/relative-date.cjs +1 -1
  287. package/dist/relative-date.d.ts.map +1 -1
  288. package/dist/relative-date.js +73 -89
  289. package/dist/resizable.cjs +1 -1
  290. package/dist/resizable.d.ts +39 -23
  291. package/dist/resizable.d.ts.map +1 -1
  292. package/dist/resizable.js +42 -44
  293. package/dist/result-count.cjs +1 -0
  294. package/dist/result-count.d.ts +110 -0
  295. package/dist/result-count.d.ts.map +1 -0
  296. package/dist/result-count.js +49 -0
  297. package/dist/route-progress.cjs +1 -1
  298. package/dist/route-progress.js +58 -102
  299. package/dist/scroll-area.cjs +1 -1
  300. package/dist/scroll-area.d.ts +9 -1
  301. package/dist/scroll-area.d.ts.map +1 -1
  302. package/dist/scroll-area.js +44 -79
  303. package/dist/select.cjs +2 -2
  304. package/dist/select.d.ts +10 -10
  305. package/dist/select.d.ts.map +1 -1
  306. package/dist/select.js +118 -238
  307. package/dist/separator.cjs +1 -1
  308. package/dist/separator.js +90 -78
  309. package/dist/sheet.cjs +1 -1
  310. package/dist/sheet.d.ts +8 -5
  311. package/dist/sheet.d.ts.map +1 -1
  312. package/dist/sheet.js +250 -317
  313. package/dist/single-select-filter.cjs +1 -1
  314. package/dist/single-select-filter.d.ts +32 -0
  315. package/dist/single-select-filter.d.ts.map +1 -1
  316. package/dist/single-select-filter.js +201 -203
  317. package/dist/skeleton.cjs +1 -1
  318. package/dist/skeleton.js +24 -38
  319. package/dist/slider.cjs +1 -1
  320. package/dist/slider.js +51 -81
  321. package/dist/sonner.cjs +1 -1
  322. package/dist/sonner.d.ts +1 -1
  323. package/dist/sonner.d.ts.map +1 -1
  324. package/dist/sonner.js +101 -125
  325. package/dist/spinner.cjs +1 -1
  326. package/dist/spinner.js +22 -31
  327. package/dist/split-layout.cjs +1 -1
  328. package/dist/split-layout.js +52 -101
  329. package/dist/status.cjs +1 -0
  330. package/dist/status.d.ts +51 -0
  331. package/dist/status.d.ts.map +1 -0
  332. package/dist/status.js +60 -0
  333. package/dist/stepper.cjs +1 -1
  334. package/dist/stepper.js +184 -316
  335. package/dist/switch.cjs +1 -1
  336. package/dist/switch.js +17 -32
  337. package/dist/table.cjs +1 -1
  338. package/dist/table.d.ts +103 -30
  339. package/dist/table.d.ts.map +1 -1
  340. package/dist/table.js +170 -209
  341. package/dist/tabs.cjs +1 -1
  342. package/dist/tabs.d.ts.map +1 -1
  343. package/dist/tabs.js +102 -147
  344. package/dist/text-reveal-motion.cjs +1 -1
  345. package/dist/text-reveal-motion.js +307 -363
  346. package/dist/textarea.cjs +1 -1
  347. package/dist/textarea.d.ts.map +1 -1
  348. package/dist/textarea.js +22 -35
  349. package/dist/toggle-group.cjs +1 -1
  350. package/dist/toggle-group.js +43 -62
  351. package/dist/toggle.cjs +1 -1
  352. package/dist/toggle.js +34 -46
  353. package/dist/tooltip.cjs +1 -1
  354. package/dist/tooltip.d.ts +2 -2
  355. package/dist/tooltip.d.ts.map +1 -1
  356. package/dist/tooltip.js +157 -249
  357. package/dist/typography-heading.cjs +1 -1
  358. package/dist/typography-heading.js +25 -61
  359. package/dist/typography-text.cjs +1 -1
  360. package/dist/typography-text.js +27 -57
  361. package/dist/typography.cjs +1 -1
  362. package/dist/typography.js +132 -340
  363. package/package.json +46 -46
  364. package/src/blocks/empty-state.tsx +34 -18
  365. package/src/blocks/sidebar.tsx +86 -31
  366. package/src/components/accordion.tsx +1 -1
  367. package/src/components/alert-dialog.tsx +4 -2
  368. package/src/components/badge.tsx +127 -15
  369. package/src/components/breadcrumb.tsx +1 -1
  370. package/src/components/button.tsx +8 -6
  371. package/src/components/calendar.tsx +155 -9
  372. package/src/components/card.tsx +63 -10
  373. package/src/components/carousel.tsx +4 -1
  374. package/src/components/chart.tsx +151 -17
  375. package/src/components/checkbox.tsx +1 -1
  376. package/src/components/collapsible.tsx +4 -1
  377. package/src/components/combobox.tsx +40 -7
  378. package/src/components/command.tsx +9 -10
  379. package/src/components/context-menu.tsx +4 -4
  380. package/src/components/data-table.tsx +619 -237
  381. package/src/components/date-picker.tsx +31 -4
  382. package/src/components/delta.tsx +217 -0
  383. package/src/components/drawer.tsx +5 -5
  384. package/src/components/dropdown-menu.tsx +4 -4
  385. package/src/components/field.tsx +36 -15
  386. package/src/components/global-layout.tsx +1 -1
  387. package/src/components/input-chip.tsx +51 -7
  388. package/src/components/input-group.tsx +1 -1
  389. package/src/components/input-password.tsx +15 -19
  390. package/src/components/input.tsx +10 -1
  391. package/src/components/list.tsx +14 -2
  392. package/src/components/logo-mark.tsx +345 -0
  393. package/src/components/map.tsx +18 -20
  394. package/src/components/media-viewer.tsx +908 -0
  395. package/src/components/multi-select-filter.tsx +255 -121
  396. package/src/components/navigation-menu.tsx +2 -2
  397. package/src/components/pagination.tsx +86 -26
  398. package/src/components/progress.tsx +91 -23
  399. package/src/components/rating.tsx +200 -74
  400. package/src/components/relative-date.tsx +19 -11
  401. package/src/components/resizable.tsx +86 -33
  402. package/src/components/result-count.tsx +253 -0
  403. package/src/components/scroll-area.tsx +31 -5
  404. package/src/components/select.tsx +2 -2
  405. package/src/components/sheet.tsx +14 -4
  406. package/src/components/single-select-filter.tsx +136 -41
  407. package/src/components/slider.tsx +2 -2
  408. package/src/components/status.tsx +162 -0
  409. package/src/components/switch.tsx +1 -1
  410. package/src/components/table.tsx +278 -106
  411. package/src/components/tabs.tsx +1 -0
  412. package/src/components/textarea.tsx +20 -2
  413. package/src/components/toggle.tsx +2 -2
  414. package/src/components/tooltip.tsx +11 -20
  415. package/src/hooks/use-filter-search-params.ts +302 -0
  416. package/src/index.ts +6 -0
  417. package/src/lib/compose-event-handlers.ts +14 -0
  418. package/src/lib/download-file.ts +61 -0
  419. package/src/lib/empty-chip.tsx +52 -0
  420. package/src/lib/field-aria.tsx +97 -0
  421. package/src/lib/image-file-info.ts +102 -0
  422. package/src/lib/media-viewer-content.tsx +1587 -0
  423. package/src/lib/media-viewer-internal.tsx +191 -0
  424. package/src/lib/media-viewer-motion.ts +120 -0
  425. package/src/lib/motion.ts +9 -0
  426. package/src/lib/table-internal.ts +74 -0
  427. package/src/lib/use-controllable.ts +43 -0
  428. package/src/lib/empty-chip.ts +0 -24
@@ -247,6 +247,16 @@ const DatePickerRoot = DatePicker;
247
247
  */
248
248
  export type DatePickerRootProps = DatePickerProps;
249
249
 
250
+ /**
251
+ * Appends the text rendered inside a control to its aria-label so the
252
+ * accessible name contains the visible text (WCAG 2.5.3 Label in Name).
253
+ */
254
+ function withVisibleText(label: string, visibleText?: React.ReactNode) {
255
+ return typeof visibleText === "string" && visibleText.length > 0
256
+ ? `${label}: ${visibleText}`
257
+ : label;
258
+ }
259
+
250
260
  // ============================================================================
251
261
  // DatePickerTrigger
252
262
  // ============================================================================
@@ -265,7 +275,18 @@ export interface DatePickerTriggerProps extends Omit<
265
275
  */
266
276
  error?: boolean;
267
277
  /**
268
- * Accessible label for the trigger button.
278
+ * Marks this field as the one a calendar shown outside its popover is
279
+ * editing (e.g. a "from" / "to" pair sharing one inline calendar). Shows
280
+ * the same border as the open state without opening a popover, and sets
281
+ * `aria-current="true"` so screen readers know which field the calendar
282
+ * edits.
283
+ * @default false
284
+ */
285
+ active?: boolean;
286
+ /**
287
+ * Accessible label for the trigger button. The text shown inside the button
288
+ * (selected value or placeholder) is appended as `"<label>: <text>"` so the
289
+ * accessible name contains the visible text (WCAG 2.5.3).
269
290
  * @default "Select date" (single) or "Select date range" (range)
270
291
  */
271
292
  triggerLabel?: string;
@@ -277,7 +298,7 @@ export interface DatePickerTriggerProps extends Omit<
277
298
  const DatePickerTrigger = React.forwardRef<
278
299
  HTMLButtonElement,
279
300
  DatePickerTriggerProps
280
- >(({ className, children, id, error, triggerLabel, ...props }, ref) => {
301
+ >(({ className, children, id, error, active, triggerLabel, ...props }, ref) => {
281
302
  const {
282
303
  mode,
283
304
  date,
@@ -328,19 +349,25 @@ const DatePickerTrigger = React.forwardRef<
328
349
  <PopoverTrigger asChild>
329
350
  <button
330
351
  ref={combinedRef}
352
+ aria-current={active ? "true" : undefined}
331
353
  aria-label={
332
354
  props["aria-label"] ??
333
- triggerLabel ??
334
- (mode === "single" ? "Select date" : "Select date range")
355
+ withVisibleText(
356
+ triggerLabel ??
357
+ (mode === "single" ? "Select date" : "Select date range"),
358
+ children === undefined ? (displayValue ?? placeholder) : undefined
359
+ )
335
360
  }
336
361
  className={cn(
337
362
  inputVariants({ hasIcon: true }),
338
363
  "group-hover/field:bg-accent dark:group-hover/field:bg-input/50 relative cursor-pointer justify-start pb-0 text-left",
339
364
  !hasValue && "text-muted-foreground",
365
+ active && "border-ring shadow-default",
340
366
  hasError &&
341
367
  "border-destructive-40 focus-visible:border-destructive-40 focus-visible:shadow-destructive",
342
368
  className
343
369
  )}
370
+ data-active={active || undefined}
344
371
  data-error={hasError || undefined}
345
372
  data-hook={`${dataHook}-trigger`}
346
373
  data-slot="date-picker-trigger"
@@ -0,0 +1,217 @@
1
+ import * as React from "react";
2
+ import { cva } from "class-variance-authority";
3
+
4
+ import { ArrowDown, ArrowUp, Minus } from "@brightlocal/icons";
5
+
6
+ import { cn } from "@brightlocal/ui-components/lib/utils";
7
+
8
+ /**
9
+ * Which direction of the change shows green (good news); the other shows red.
10
+ * `"up"` when more is better (views, reviews, a rank phrased as places
11
+ * gained); `"down"` when less is better (cost, response time).
12
+ */
13
+ type DeltaGreenWhen = "up" | "down";
14
+
15
+ /**
16
+ * How the delta sits on the page: bare text in a line or a cell (`inline`),
17
+ * or on a tinted pill next to a metric (`pill`).
18
+ */
19
+ type DeltaVariant = "inline" | "pill";
20
+
21
+ /** Direction of the change, from the sign of `value`. */
22
+ type DeltaDirection = "increase" | "decrease" | "none";
23
+
24
+ /** Whether the change is good news, from the direction and `greenWhen`. */
25
+ type DeltaTrend = "better" | "worse" | "none";
26
+
27
+ const deltaVariants = cva(
28
+ "relative inline-flex items-center gap-0.5 tabular-nums",
29
+ {
30
+ variants: {
31
+ variant: {
32
+ inline: "text-label [&>svg]:size-4",
33
+ pill: "text-label-sm rounded-full px-1.5 py-0.5 [&>svg]:size-3",
34
+ },
35
+ },
36
+ defaultVariants: {
37
+ variant: "inline",
38
+ },
39
+ }
40
+ );
41
+
42
+ /* Trend is derived from `value` + `greenWhen`, never passed in, so it stays
43
+ out of the CVA axes (which the registry reads as props). */
44
+ const TREND_INK: Record<DeltaTrend, string> = {
45
+ better: "text-score-strong-ink",
46
+ worse: "text-score-poor-ink",
47
+ none: "text-muted-foreground",
48
+ };
49
+
50
+ const PILL_TINT: Record<DeltaTrend, string> = {
51
+ better: "bg-score-strong/15",
52
+ worse: "bg-score-poor/15",
53
+ none: "bg-muted",
54
+ };
55
+
56
+ /**
57
+ * Props for the Delta component.
58
+ */
59
+ interface DeltaProps extends Omit<
60
+ React.ComponentPropsWithoutRef<"span">,
61
+ "children"
62
+ > {
63
+ /**
64
+ * Required test hook identifier.
65
+ * @example "visibility-delta"
66
+ */
67
+ dataHook: string;
68
+ /**
69
+ * The signed change, as the product phrases it. Rank up 8 places is
70
+ * `value={8}` — the arrow follows the phrasing, the colour follows
71
+ * `greenWhen`.
72
+ * @example 8
73
+ */
74
+ value: number;
75
+ /**
76
+ * Which direction shows green: `"up"` when more is better, `"down"` when
77
+ * less is better (cost, response time). The other direction shows red.
78
+ * @default "up"
79
+ */
80
+ greenWhen?: DeltaGreenWhen;
81
+ /**
82
+ * Inline text, or a tinted pill.
83
+ * @default "inline"
84
+ */
85
+ variant?: DeltaVariant;
86
+ /**
87
+ * Overrides the displayed amount (e.g. "12%"). Pass the magnitude only —
88
+ * the arrow carries the sign.
89
+ * @default the magnitude in en-US format, up to 2 decimals ("<0.01" for a tiny non-zero change)
90
+ */
91
+ children?: React.ReactNode;
92
+ /**
93
+ * Screen-reader phrase before the amount when `value` is positive.
94
+ * @default "Increased by"
95
+ */
96
+ increasedLabel?: string;
97
+ /**
98
+ * Screen-reader phrase before the amount when `value` is negative.
99
+ * @default "Decreased by"
100
+ */
101
+ decreasedLabel?: string;
102
+ /**
103
+ * Screen-reader phrase when `value` is zero (read on its own).
104
+ * @default "Unchanged"
105
+ */
106
+ unchangedLabel?: string;
107
+ /** Analytics element identifier */
108
+ trackingEl?: string;
109
+ /** Analytics label */
110
+ trackingLabel?: string;
111
+ }
112
+
113
+ /**
114
+ * The default amount: the magnitude in a fixed en-US format (up to two
115
+ * decimals), so server and browser render the same string whatever the
116
+ * runtime locale. A non-zero change that would round to 0 shows "<0.01",
117
+ * so the arrow never sits next to a 0. Consumers pass a localized amount
118
+ * through `children`.
119
+ */
120
+ const AMOUNT_FORMAT = new Intl.NumberFormat("en-US", {
121
+ maximumFractionDigits: 2,
122
+ });
123
+
124
+ function formatAmount(value: number): string {
125
+ const magnitude = Math.abs(value);
126
+ if (magnitude > 0 && magnitude < 0.005) return "<0.01";
127
+ return AMOUNT_FORMAT.format(magnitude);
128
+ }
129
+
130
+ const DIRECTION_ICONS = {
131
+ increase: ArrowUp,
132
+ decrease: ArrowDown,
133
+ none: Minus,
134
+ } as const;
135
+
136
+ /**
137
+ * Delta — how much a value moved between two points.
138
+ * The arrow follows the sign of the change; the colour comes from whether
139
+ * that direction is good (`greenWhen`). Screen readers hear a phrase
140
+ * ("Increased by 8") instead of the arrow and number.
141
+ */
142
+ const Delta = React.forwardRef<HTMLSpanElement, DeltaProps>(
143
+ (
144
+ {
145
+ className,
146
+ value,
147
+ greenWhen = "up",
148
+ variant = "inline",
149
+ increasedLabel,
150
+ decreasedLabel,
151
+ unchangedLabel,
152
+ dataHook,
153
+ trackingEl,
154
+ trackingLabel,
155
+ children,
156
+ ...props
157
+ },
158
+ ref
159
+ ) => {
160
+ const direction: DeltaDirection =
161
+ value > 0 ? "increase" : value < 0 ? "decrease" : "none";
162
+ const trend: DeltaTrend =
163
+ direction === "none"
164
+ ? "none"
165
+ : (direction === "increase") === (greenWhen === "up")
166
+ ? "better"
167
+ : "worse";
168
+ const amount = children ?? formatAmount(value);
169
+ const Icon = DIRECTION_ICONS[direction];
170
+
171
+ return (
172
+ <span
173
+ ref={ref}
174
+ className={cn(
175
+ deltaVariants({ variant }),
176
+ TREND_INK[trend],
177
+ variant === "pill" && PILL_TINT[trend],
178
+ className
179
+ )}
180
+ data-direction={direction}
181
+ data-hook={dataHook}
182
+ data-slot="delta"
183
+ data-tracking-el={trackingEl}
184
+ data-tracking-label={trackingLabel}
185
+ data-trend={trend}
186
+ data-variant={variant}
187
+ {...props}
188
+ >
189
+ <Icon aria-hidden />
190
+ <span aria-hidden>{amount}</span>
191
+ <span className="sr-only">
192
+ {direction === "none" ? (
193
+ (unchangedLabel ?? "Unchanged")
194
+ ) : (
195
+ <>
196
+ {direction === "increase"
197
+ ? (increasedLabel ?? "Increased by")
198
+ : (decreasedLabel ?? "Decreased by")}{" "}
199
+ {amount}
200
+ </>
201
+ )}
202
+ </span>
203
+ </span>
204
+ );
205
+ }
206
+ );
207
+
208
+ Delta.displayName = "Delta";
209
+
210
+ export { Delta };
211
+ export type {
212
+ DeltaProps,
213
+ DeltaGreenWhen,
214
+ DeltaVariant,
215
+ DeltaDirection,
216
+ DeltaTrend,
217
+ };
@@ -111,8 +111,8 @@ function DrawerContent({
111
111
  <DrawerPrimitive.Content
112
112
  className={cn(
113
113
  "group/drawer-content bg-background border-border fixed z-50 flex h-auto flex-col",
114
- "data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80vh] data-[vaul-drawer-direction=top]:rounded-b-[10px] data-[vaul-drawer-direction=top]:border-b",
115
- "data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80vh] data-[vaul-drawer-direction=bottom]:rounded-t-[10px] data-[vaul-drawer-direction=bottom]:border-t",
114
+ "data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80svh] data-[vaul-drawer-direction=top]:rounded-b-[10px] data-[vaul-drawer-direction=top]:border-b",
115
+ "data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80svh] data-[vaul-drawer-direction=bottom]:rounded-t-[10px] data-[vaul-drawer-direction=bottom]:border-t",
116
116
  "data-[vaul-drawer-direction=right]:inset-y-0 data-[vaul-drawer-direction=right]:right-0 data-[vaul-drawer-direction=right]:w-3/4 data-[vaul-drawer-direction=right]:border-l data-[vaul-drawer-direction=right]:sm:max-w-sm",
117
117
  "data-[vaul-drawer-direction=left]:inset-y-0 data-[vaul-drawer-direction=left]:left-0 data-[vaul-drawer-direction=left]:w-3/4 data-[vaul-drawer-direction=left]:border-r data-[vaul-drawer-direction=left]:sm:max-w-sm",
118
118
  className
@@ -139,7 +139,7 @@ function DrawerHeader({ className, ...props }: React.ComponentProps<"div">) {
139
139
  return (
140
140
  <div
141
141
  className={cn(
142
- "mx-auto flex w-full max-w-sm flex-col gap-1.5 p-4 text-center sm:text-left",
142
+ "flex w-full shrink-0 flex-col gap-1.5 p-4 text-center sm:text-left",
143
143
  className
144
144
  )}
145
145
  data-slot="drawer-header"
@@ -157,7 +157,7 @@ function DrawerBody({ className, ...props }: React.ComponentProps<"div">) {
157
157
  return (
158
158
  <div
159
159
  className={cn(
160
- "mx-auto w-full max-w-sm px-4",
160
+ "min-h-0 w-full flex-1 overflow-x-hidden overflow-y-auto px-4",
161
161
  "mt-4 group-has-[[data-slot=drawer-header]]/drawer-content:mt-0",
162
162
  className
163
163
  )}
@@ -176,7 +176,7 @@ function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) {
176
176
  return (
177
177
  <div
178
178
  className={cn(
179
- "mx-auto mt-auto flex w-full max-w-sm flex-col gap-2 p-4",
179
+ "mt-auto flex w-full shrink-0 flex-col gap-2 p-4",
180
180
  className
181
181
  )}
182
182
  data-slot="drawer-footer"
@@ -194,7 +194,7 @@ const DropdownMenuItem = React.forwardRef<
194
194
  ref={ref}
195
195
  className={cn(
196
196
  [
197
- "relative flex cursor-default items-center gap-2 self-stretch select-none",
197
+ "relative flex cursor-pointer items-center gap-2 self-stretch select-none",
198
198
  "text-label rounded-sm px-2 py-1.5 outline-hidden",
199
199
  // Text truncation for child text elements
200
200
  "[&>span]:overflow-hidden [&>span]:text-ellipsis [&>span]:whitespace-nowrap",
@@ -262,7 +262,7 @@ const DropdownMenuCheckboxItem = React.forwardRef<
262
262
  checked={checked}
263
263
  className={cn(
264
264
  [
265
- "relative flex cursor-default items-center gap-2 select-none",
265
+ "relative flex cursor-pointer items-center gap-2 select-none",
266
266
  "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
267
267
  "focus:bg-accent focus:text-accent-foreground",
268
268
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
@@ -334,7 +334,7 @@ const DropdownMenuRadioItem = React.forwardRef<
334
334
  ref={ref}
335
335
  className={cn(
336
336
  [
337
- "relative flex cursor-default items-center gap-2 select-none",
337
+ "relative flex cursor-pointer items-center gap-2 select-none",
338
338
  "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
339
339
  "focus:bg-accent focus:text-accent-foreground",
340
340
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
@@ -496,7 +496,7 @@ const DropdownMenuSubTrigger = React.forwardRef<
496
496
  ref={ref}
497
497
  className={cn(
498
498
  [
499
- "flex cursor-default items-center gap-2 select-none",
499
+ "flex cursor-pointer items-center gap-2 select-none data-[disabled]:cursor-not-allowed",
500
500
  "text-label rounded-sm px-2 py-1.5 outline-hidden",
501
501
  "focus:bg-accent focus:text-accent-foreground",
502
502
  "data-[state=open]:bg-accent data-[state=open]:text-accent-foreground",
@@ -7,6 +7,7 @@ import { AlertCircle, type LucideProps } from "@brightlocal/icons";
7
7
  import { cn } from "@brightlocal/ui-components/lib/utils";
8
8
  import { Description } from "./description";
9
9
  import { Label, type LabelProps } from "@brightlocal/ui-components/label";
10
+ import { FieldAriaProvider, useFieldAriaRegistration } from "../lib/field-aria";
10
11
 
11
12
  function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
12
13
  return (
@@ -188,21 +189,23 @@ function Field({
188
189
  ...props
189
190
  }: FieldProps) {
190
191
  return (
191
- <div
192
- className={cn(
193
- fieldVariants({ orientation, variant }),
194
- align === "end" &&
195
- orientation === "horizontal" &&
196
- "grid-cols-[1fr_auto]",
197
- className
198
- )}
199
- data-hook={dataHook}
200
- data-orientation={orientation}
201
- data-slot="field"
202
- data-variant={variant}
203
- role="group"
204
- {...props}
205
- />
192
+ <FieldAriaProvider>
193
+ <div
194
+ className={cn(
195
+ fieldVariants({ orientation, variant }),
196
+ align === "end" &&
197
+ orientation === "horizontal" &&
198
+ "grid-cols-[1fr_auto]",
199
+ className
200
+ )}
201
+ data-hook={dataHook}
202
+ data-orientation={orientation}
203
+ data-slot="field"
204
+ data-variant={variant}
205
+ role="group"
206
+ {...props}
207
+ />
208
+ </FieldAriaProvider>
206
209
  );
207
210
  }
208
211
 
@@ -277,8 +280,15 @@ interface FieldDescriptionProps extends React.ComponentProps<"p"> {
277
280
  function FieldDescription({
278
281
  className,
279
282
  dataHook,
283
+ id: idProp,
280
284
  ...props
281
285
  }: FieldDescriptionProps) {
286
+ // The hint registers its id with the enclosing Field so a text control can
287
+ // point aria-describedby at it without the consumer wiring it by hand.
288
+ const generatedId = React.useId();
289
+ const id = idProp ?? generatedId;
290
+ useFieldAriaRegistration("description", id, true);
291
+
282
292
  return (
283
293
  <Description
284
294
  className={cn(
@@ -290,6 +300,7 @@ function FieldDescription({
290
300
  )}
291
301
  data-hook={dataHook}
292
302
  data-slot="field-description"
303
+ id={id}
293
304
  {...props}
294
305
  />
295
306
  );
@@ -427,6 +438,7 @@ function FieldError({
427
438
  dataHook,
428
439
  children,
429
440
  errors,
441
+ id: idProp,
430
442
  ...props
431
443
  }: FieldErrorProps) {
432
444
  // Filter out undefined errors and those without messages
@@ -436,6 +448,13 @@ function FieldError({
436
448
 
437
449
  const hasMessage = Boolean(children) || Boolean(errorMessages?.length);
438
450
 
451
+ // While a message is on screen its id is registered with the enclosing
452
+ // Field, so a text control points aria-describedby at it automatically. An
453
+ // explicit `id` is kept, so existing hand-wiring keeps working.
454
+ const generatedId = React.useId();
455
+ const id = idProp ?? generatedId;
456
+ useFieldAriaRegistration("error", id, hasMessage);
457
+
439
458
  // Screen readers only announce live-region content that arrives *after* the
440
459
  // region is in the accessibility tree. Consumers typically mount FieldError
441
460
  // together with the message, so when a message appears client-side the
@@ -454,6 +473,7 @@ function FieldError({
454
473
 
455
474
  React.useEffect(() => {
456
475
  if (!hasMessage) {
476
+ // eslint-disable-next-line react-hooks/set-state-in-effect -- derived live-region latch; refactor tracked in DS-1070
457
477
  setDefer(true);
458
478
  setAnnounced(false);
459
479
  } else if (defer) {
@@ -486,6 +506,7 @@ function FieldError({
486
506
  className={baseStyles}
487
507
  data-hook={dataHook}
488
508
  data-slot="field-error"
509
+ id={id}
489
510
  role="status"
490
511
  {...props}
491
512
  >
@@ -54,7 +54,7 @@ const GlobalLayout = React.forwardRef<HTMLDivElement, GlobalLayoutProps>(
54
54
  // sidebar from the viewport edge and make its 100dvh height
55
55
  // overflow, so the page-level scroll region drops it.
56
56
  className={cn(
57
- "h-dvh w-full [&>[data-radix-scroll-area-viewport]]:p-0! [&>[data-radix-scroll-area-viewport]>div]:block! [&>[data-radix-scroll-area-viewport]>div]:min-w-0!",
57
+ "h-dvh w-full [&>[data-radix-scroll-area-viewport]]:p-0!",
58
58
  className
59
59
  )}
60
60
  dataHook={`${dataHook}-scroll`}
@@ -103,6 +103,13 @@ export interface InputChipProps {
103
103
  defaultValue?: string[];
104
104
  /** Callback when value changes */
105
105
  onValueChange?: (value: string[]) => void;
106
+ /**
107
+ * Synchronous validation hook called before a typed value is added.
108
+ * Return `false` to reject the add — the typed text stays in the input
109
+ * so the user can correct it. Any other return (including `undefined`)
110
+ * lets the add proceed.
111
+ */
112
+ onBeforeAdd?: (item: string) => boolean | void;
106
113
  /** Disabled state */
107
114
  disabled?: boolean;
108
115
  /** Allow duplicate values (default: false) */
@@ -136,6 +143,7 @@ function InputChip({
136
143
  value: controlledValue,
137
144
  defaultValue = [],
138
145
  onValueChange: controlledOnValueChange,
146
+ onBeforeAdd,
139
147
  disabled = false,
140
148
  allowDuplicates = false,
141
149
  children,
@@ -152,10 +160,12 @@ function InputChip({
152
160
 
153
161
  const valueRef = React.useRef(value);
154
162
  const controlledOnValueChangeRef = React.useRef(controlledOnValueChange);
163
+ const onBeforeAddRef = React.useRef(onBeforeAdd);
155
164
  const disabledRef = React.useRef(disabled);
156
165
  React.useLayoutEffect(() => {
157
166
  valueRef.current = value;
158
167
  controlledOnValueChangeRef.current = controlledOnValueChange;
168
+ onBeforeAddRef.current = onBeforeAdd;
159
169
  disabledRef.current = disabled;
160
170
  });
161
171
 
@@ -165,6 +175,7 @@ function InputChip({
165
175
  chipRefs.current.length = value.length;
166
176
  }
167
177
  if (focusedChipIndex >= value.length) {
178
+ // eslint-disable-next-line react-hooks/set-state-in-effect -- reset stale focus index; refactor tracked in DS-1070
168
179
  setFocusedChipIndex(-1);
169
180
  }
170
181
  }, [value.length, focusedChipIndex]);
@@ -183,10 +194,11 @@ function InputChip({
183
194
  (item: string) => {
184
195
  if (disabledRef.current) return;
185
196
  const trimmed = item.trim();
186
- if (trimmed && (allowDuplicates || !valueRef.current.includes(trimmed))) {
187
- onValueChange([...valueRef.current, trimmed]);
188
- setInputValue("");
189
- }
197
+ if (!trimmed) return;
198
+ if (onBeforeAddRef.current?.(trimmed) === false) return;
199
+ if (!allowDuplicates && valueRef.current.includes(trimmed)) return;
200
+ onValueChange([...valueRef.current, trimmed]);
201
+ setInputValue("");
190
202
  },
191
203
  [allowDuplicates, onValueChange]
192
204
  );
@@ -325,13 +337,35 @@ export interface InputChipInputProps
325
337
  * ID of element that labels the input
326
338
  */
327
339
  "aria-labelledby"?: string;
340
+ /**
341
+ * ID(s) of elements that describe the input (hint text, error message).
342
+ * Passed to the inner text input for screen-reader announcement.
343
+ */
344
+ "aria-describedby"?: string;
345
+ /**
346
+ * Marks the input as invalid for assistive technology.
347
+ * Also derived from the `error` prop — either source triggers the
348
+ * invalid state on the inner text input.
349
+ */
350
+ "aria-invalid"?: boolean | "true" | "false";
351
+ /**
352
+ * Ref to the wrapper div (the bordered container).
353
+ * Use when you need to anchor a Popover or measure the container box.
354
+ * The primary `ref` now points to the inner text input for form
355
+ * integration (focus, ARIA).
356
+ */
357
+ wrapperRef?: React.Ref<HTMLDivElement>;
328
358
  }
329
359
 
330
360
  /**
331
361
  * Input container with bordered styling.
332
362
  * Place Chip components or InputChipItems inside as children.
363
+ *
364
+ * The forwarded `ref` points to the inner text input (for focus, ARIA
365
+ * wiring, and form integration). Use `wrapperRef` when you need the
366
+ * bordered container element (e.g. for Popover anchoring).
333
367
  */
334
- const InputChipInput = React.forwardRef<HTMLDivElement, InputChipInputProps>(
368
+ const InputChipInput = React.forwardRef<HTMLInputElement, InputChipInputProps>(
335
369
  (
336
370
  {
337
371
  className,
@@ -343,6 +377,9 @@ const InputChipInput = React.forwardRef<HTMLDivElement, InputChipInputProps>(
343
377
  inputId,
344
378
  "aria-label": ariaLabel,
345
379
  "aria-labelledby": ariaLabelledby,
380
+ "aria-describedby": ariaDescribedby,
381
+ "aria-invalid": ariaInvalid,
382
+ wrapperRef,
346
383
  children,
347
384
  ...props
348
385
  },
@@ -353,6 +390,11 @@ const InputChipInput = React.forwardRef<HTMLDivElement, InputChipInputProps>(
353
390
  const { value, disabled } = useInputChipValue();
354
391
  const { inputValue } = useInputChipInput();
355
392
 
393
+ // Expose the inner text input through the consumer's ref
394
+ React.useImperativeHandle(ref, () => inputRef.current!, [inputRef]);
395
+
396
+ const hasError = error || ariaInvalid === true || ariaInvalid === "true";
397
+
356
398
  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
357
399
  setInputValue(e.target.value);
358
400
  };
@@ -382,8 +424,8 @@ const InputChipInput = React.forwardRef<HTMLDivElement, InputChipInputProps>(
382
424
 
383
425
  return (
384
426
  <div
385
- ref={ref}
386
- className={cn(inputChipInputVariants({ error }), className)}
427
+ ref={wrapperRef}
428
+ className={cn(inputChipInputVariants({ error: hasError }), className)}
387
429
  data-hook={dataHook}
388
430
  data-slot="input-chip"
389
431
  data-tracking-el={trackingEl}
@@ -393,6 +435,8 @@ const InputChipInput = React.forwardRef<HTMLDivElement, InputChipInputProps>(
393
435
  {children}
394
436
  <input
395
437
  ref={inputRef as React.RefObject<HTMLInputElement>}
438
+ aria-describedby={ariaDescribedby || undefined}
439
+ aria-invalid={hasError ? "true" : undefined}
396
440
  aria-label={ariaLabel}
397
441
  aria-labelledby={ariaLabelledby}
398
442
  className={cn(inputStyles)}
@@ -285,7 +285,7 @@ const inputGroupButtonVariants = cva(
285
285
  "inline-flex items-center justify-center gap-2",
286
286
  "text-label transition-colors duration-fast ease-out",
287
287
  "outline-none focus-visible:shadow-default rounded-sm",
288
- "disabled:pointer-events-none disabled:opacity-50",
288
+ "cursor-pointer disabled:pointer-events-none disabled:opacity-50",
289
289
  "text-muted-foreground hover:text-foreground",
290
290
  "[&_svg]:pointer-events-none [&_svg]:shrink-0",
291
291
  ],