@brightlocal/ui-components 3.2.0 → 3.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 (434) hide show
  1. package/AI_USAGE.md +10 -0
  2. package/README.md +3 -1
  3. package/component-meta.json +1458 -380
  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 +138 -178
  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-list.cjs +1 -0
  103. package/dist/description-list.d.ts +142 -0
  104. package/dist/description-list.d.ts.map +1 -0
  105. package/dist/description-list.js +173 -0
  106. package/dist/description.cjs +1 -1
  107. package/dist/description.js +11 -20
  108. package/dist/dialog.cjs +1 -1
  109. package/dist/dialog.d.ts +1 -1
  110. package/dist/dialog.d.ts.map +1 -1
  111. package/dist/dialog.js +76 -116
  112. package/dist/drawer.cjs +1 -1
  113. package/dist/drawer.d.ts +11 -11
  114. package/dist/drawer.d.ts.map +1 -1
  115. package/dist/drawer.js +76 -134
  116. package/dist/dropdown-menu.cjs +1 -1
  117. package/dist/dropdown-menu.d.ts +6 -6
  118. package/dist/dropdown-menu.d.ts.map +1 -1
  119. package/dist/dropdown-menu.js +179 -300
  120. package/dist/field.cjs +1 -1
  121. package/dist/field.d.ts +9 -9
  122. package/dist/field.d.ts.map +1 -1
  123. package/dist/field.js +166 -286
  124. package/dist/global-layout.cjs +1 -1
  125. package/dist/global-layout.js +203 -342
  126. package/dist/grid.cjs +1 -1
  127. package/dist/grid.js +16 -29
  128. package/dist/header.cjs +1 -1
  129. package/dist/header.js +21 -38
  130. package/dist/height-transition.cjs +1 -1
  131. package/dist/height-transition.js +38 -55
  132. package/dist/hooks/use-breakpoint.cjs +1 -1
  133. package/dist/hooks/use-breakpoint.js +9 -9
  134. package/dist/hooks/use-debounce.cjs +1 -1
  135. package/dist/hooks/use-debounce.js +12 -11
  136. package/dist/hooks/use-delayed-pending.cjs +1 -1
  137. package/dist/hooks/use-delayed-pending.js +8 -9
  138. package/dist/hooks/use-filter-search-params.cjs +1 -0
  139. package/dist/hooks/use-filter-search-params.d.ts +93 -0
  140. package/dist/hooks/use-filter-search-params.d.ts.map +1 -0
  141. package/dist/hooks/use-filter-search-params.js +122 -0
  142. package/dist/hooks/use-mobile.cjs +1 -1
  143. package/dist/hooks/use-mobile.js +6 -6
  144. package/dist/hooks/use-overlay-pointer-lock.cjs +1 -1
  145. package/dist/hooks/use-overlay-pointer-lock.js +8 -9
  146. package/dist/hooks/use-prefers-reduced-motion.cjs +1 -1
  147. package/dist/hooks/use-prefers-reduced-motion.js +5 -8
  148. package/dist/hover-card.cjs +1 -1
  149. package/dist/hover-card.d.ts +1 -1
  150. package/dist/hover-card.d.ts.map +1 -1
  151. package/dist/hover-card.js +30 -62
  152. package/dist/index.cjs +1 -1
  153. package/dist/index.d.ts +7 -0
  154. package/dist/index.d.ts.map +1 -1
  155. package/dist/index.js +658 -614
  156. package/dist/info-tooltip.cjs +1 -1
  157. package/dist/info-tooltip.js +22 -36
  158. package/dist/input-chip.cjs +1 -1
  159. package/dist/input-chip.d.ts +32 -3
  160. package/dist/input-chip.d.ts.map +1 -1
  161. package/dist/input-chip.js +181 -230
  162. package/dist/input-group.cjs +1 -1
  163. package/dist/input-group.js +174 -221
  164. package/dist/input-otp.cjs +1 -1
  165. package/dist/input-otp.d.ts +3 -3
  166. package/dist/input-otp.d.ts.map +1 -1
  167. package/dist/input-otp.js +102 -146
  168. package/dist/input-password.cjs +1 -1
  169. package/dist/input-password.d.ts +12 -16
  170. package/dist/input-password.d.ts.map +1 -1
  171. package/dist/input-password.js +139 -171
  172. package/dist/input.cjs +1 -1
  173. package/dist/input.d.ts.map +1 -1
  174. package/dist/input.js +51 -73
  175. package/dist/label.cjs +1 -1
  176. package/dist/label.js +20 -38
  177. package/dist/lib/block-illustration.cjs +1 -1
  178. package/dist/lib/block-illustration.d.ts +1 -1
  179. package/dist/lib/block-illustration.d.ts.map +1 -1
  180. package/dist/lib/block-illustration.js +16 -18
  181. package/dist/lib/compose-event-handlers.cjs +1 -0
  182. package/dist/lib/compose-event-handlers.d.ts +9 -0
  183. package/dist/lib/compose-event-handlers.d.ts.map +1 -0
  184. package/dist/lib/compose-event-handlers.js +8 -0
  185. package/dist/lib/download-file.cjs +1 -0
  186. package/dist/lib/download-file.d.ts +14 -0
  187. package/dist/lib/download-file.d.ts.map +1 -0
  188. package/dist/lib/download-file.js +40 -0
  189. package/dist/lib/empty-canvas.cjs +1 -1
  190. package/dist/lib/empty-canvas.js +28 -56
  191. package/dist/lib/empty-chip.cjs +1 -1
  192. package/dist/lib/empty-chip.d.ts +14 -3
  193. package/dist/lib/empty-chip.d.ts.map +1 -1
  194. package/dist/lib/empty-chip.js +15 -11
  195. package/dist/lib/field-aria.cjs +1 -0
  196. package/dist/lib/field-aria.d.ts +34 -0
  197. package/dist/lib/field-aria.d.ts.map +1 -0
  198. package/dist/lib/field-aria.js +52 -0
  199. package/dist/lib/image-file-info.cjs +1 -0
  200. package/dist/lib/image-file-info.d.ts +25 -0
  201. package/dist/lib/image-file-info.d.ts.map +1 -0
  202. package/dist/lib/image-file-info.js +67 -0
  203. package/dist/lib/media-viewer-content.cjs +1 -0
  204. package/dist/lib/media-viewer-content.d.ts +102 -0
  205. package/dist/lib/media-viewer-content.d.ts.map +1 -0
  206. package/dist/lib/media-viewer-content.js +650 -0
  207. package/dist/lib/media-viewer-internal.cjs +1 -0
  208. package/dist/lib/media-viewer-internal.d.ts +98 -0
  209. package/dist/lib/media-viewer-internal.d.ts.map +1 -0
  210. package/dist/lib/media-viewer-internal.js +61 -0
  211. package/dist/lib/media-viewer-motion.cjs +1 -0
  212. package/dist/lib/media-viewer-motion.d.ts +40 -0
  213. package/dist/lib/media-viewer-motion.d.ts.map +1 -0
  214. package/dist/lib/media-viewer-motion.js +37 -0
  215. package/dist/lib/motion.cjs +1 -1
  216. package/dist/lib/motion.d.ts +8 -0
  217. package/dist/lib/motion.d.ts.map +1 -1
  218. package/dist/lib/motion.js +14 -8
  219. package/dist/lib/optical-center.cjs +1 -1
  220. package/dist/lib/optical-center.d.ts +1 -1
  221. package/dist/lib/optical-center.d.ts.map +1 -1
  222. package/dist/lib/optical-center.js +12 -5
  223. package/dist/lib/spring-settle.cjs +1 -1
  224. package/dist/lib/spring-settle.js +1 -1
  225. package/dist/lib/table-internal.cjs +1 -0
  226. package/dist/lib/table-internal.d.ts +62 -0
  227. package/dist/lib/table-internal.d.ts.map +1 -0
  228. package/dist/lib/table-internal.js +18 -0
  229. package/dist/lib/use-controllable.cjs +1 -0
  230. package/dist/lib/use-controllable.d.ts +12 -0
  231. package/dist/lib/use-controllable.d.ts.map +1 -0
  232. package/dist/lib/use-controllable.js +15 -0
  233. package/dist/lib/use-dev-warning.cjs +1 -1
  234. package/dist/lib/utils.cjs +1 -1
  235. package/dist/lib/utils.js +26 -33
  236. package/dist/link.cjs +1 -1
  237. package/dist/link.d.ts +1 -1
  238. package/dist/link.js +78 -124
  239. package/dist/list.cjs +1 -1
  240. package/dist/list.d.ts +224 -39
  241. package/dist/list.d.ts.map +1 -1
  242. package/dist/list.js +323 -171
  243. package/dist/loading.cjs +1 -1
  244. package/dist/loading.js +124 -151
  245. package/dist/logo-mark.cjs +1 -0
  246. package/dist/logo-mark.d.ts +79 -0
  247. package/dist/logo-mark.d.ts.map +1 -0
  248. package/dist/logo-mark.js +219 -0
  249. package/dist/logo.cjs +1 -1
  250. package/dist/logo.d.ts +1 -1
  251. package/dist/logo.d.ts.map +1 -1
  252. package/dist/logo.js +51 -87
  253. package/dist/map.cjs +1 -1
  254. package/dist/map.d.ts.map +1 -1
  255. package/dist/map.js +390 -586
  256. package/dist/media-empty.cjs +1 -1
  257. package/dist/media-empty.js +27 -42
  258. package/dist/media-viewer.cjs +1 -0
  259. package/dist/media-viewer.d.ts +224 -0
  260. package/dist/media-viewer.d.ts.map +1 -0
  261. package/dist/media-viewer.js +295 -0
  262. package/dist/menubar.cjs +1 -1
  263. package/dist/menubar.d.ts +14 -14
  264. package/dist/menubar.d.ts.map +1 -1
  265. package/dist/menubar.js +130 -267
  266. package/dist/multi-select-filter.cjs +1 -1
  267. package/dist/multi-select-filter.d.ts +9 -1
  268. package/dist/multi-select-filter.d.ts.map +1 -1
  269. package/dist/multi-select-filter.js +357 -446
  270. package/dist/navigation-menu.cjs +1 -1
  271. package/dist/navigation-menu.js +108 -172
  272. package/dist/pagination.cjs +1 -1
  273. package/dist/pagination.d.ts +36 -12
  274. package/dist/pagination.d.ts.map +1 -1
  275. package/dist/pagination.js +208 -281
  276. package/dist/popover.cjs +1 -1
  277. package/dist/popover.d.ts +1 -1
  278. package/dist/popover.d.ts.map +1 -1
  279. package/dist/popover.js +34 -45
  280. package/dist/progress.cjs +1 -1
  281. package/dist/progress.d.ts +17 -2
  282. package/dist/progress.d.ts.map +1 -1
  283. package/dist/progress.js +116 -162
  284. package/dist/radio-group.cjs +1 -1
  285. package/dist/radio-group.js +90 -146
  286. package/dist/rating.cjs +1 -1
  287. package/dist/rating.d.ts +80 -13
  288. package/dist/rating.d.ts.map +1 -1
  289. package/dist/rating.js +70 -65
  290. package/dist/relative-date.cjs +1 -1
  291. package/dist/relative-date.d.ts.map +1 -1
  292. package/dist/relative-date.js +73 -89
  293. package/dist/resizable.cjs +1 -1
  294. package/dist/resizable.d.ts +39 -23
  295. package/dist/resizable.d.ts.map +1 -1
  296. package/dist/resizable.js +42 -44
  297. package/dist/result-count.cjs +1 -0
  298. package/dist/result-count.d.ts +110 -0
  299. package/dist/result-count.d.ts.map +1 -0
  300. package/dist/result-count.js +49 -0
  301. package/dist/route-progress.cjs +1 -1
  302. package/dist/route-progress.js +59 -102
  303. package/dist/scroll-area.cjs +1 -1
  304. package/dist/scroll-area.d.ts +9 -1
  305. package/dist/scroll-area.d.ts.map +1 -1
  306. package/dist/scroll-area.js +44 -79
  307. package/dist/select.cjs +2 -2
  308. package/dist/select.d.ts +10 -10
  309. package/dist/select.d.ts.map +1 -1
  310. package/dist/select.js +118 -238
  311. package/dist/separator.cjs +1 -1
  312. package/dist/separator.js +90 -78
  313. package/dist/sheet.cjs +1 -1
  314. package/dist/sheet.d.ts +8 -5
  315. package/dist/sheet.d.ts.map +1 -1
  316. package/dist/sheet.js +250 -317
  317. package/dist/single-select-filter.cjs +1 -1
  318. package/dist/single-select-filter.d.ts +32 -0
  319. package/dist/single-select-filter.d.ts.map +1 -1
  320. package/dist/single-select-filter.js +201 -203
  321. package/dist/skeleton.cjs +1 -1
  322. package/dist/skeleton.js +24 -38
  323. package/dist/slider.cjs +1 -1
  324. package/dist/slider.js +51 -81
  325. package/dist/sonner.cjs +1 -1
  326. package/dist/sonner.d.ts +1 -1
  327. package/dist/sonner.d.ts.map +1 -1
  328. package/dist/sonner.js +101 -125
  329. package/dist/spinner.cjs +1 -1
  330. package/dist/spinner.js +22 -31
  331. package/dist/split-layout.cjs +1 -1
  332. package/dist/split-layout.js +52 -101
  333. package/dist/status.cjs +1 -0
  334. package/dist/status.d.ts +51 -0
  335. package/dist/status.d.ts.map +1 -0
  336. package/dist/status.js +60 -0
  337. package/dist/stepper.cjs +1 -1
  338. package/dist/stepper.js +184 -316
  339. package/dist/switch.cjs +1 -1
  340. package/dist/switch.js +17 -32
  341. package/dist/table.cjs +1 -1
  342. package/dist/table.d.ts +103 -30
  343. package/dist/table.d.ts.map +1 -1
  344. package/dist/table.js +170 -209
  345. package/dist/tabs.cjs +1 -1
  346. package/dist/tabs.d.ts.map +1 -1
  347. package/dist/tabs.js +102 -147
  348. package/dist/text-reveal-motion.cjs +1 -1
  349. package/dist/text-reveal-motion.js +307 -363
  350. package/dist/textarea.cjs +1 -1
  351. package/dist/textarea.d.ts.map +1 -1
  352. package/dist/textarea.js +22 -35
  353. package/dist/toggle-group.cjs +1 -1
  354. package/dist/toggle-group.js +43 -62
  355. package/dist/toggle.cjs +1 -1
  356. package/dist/toggle.js +34 -46
  357. package/dist/tooltip.cjs +1 -1
  358. package/dist/tooltip.d.ts +2 -2
  359. package/dist/tooltip.d.ts.map +1 -1
  360. package/dist/tooltip.js +157 -249
  361. package/dist/typography-heading.cjs +1 -1
  362. package/dist/typography-heading.js +25 -61
  363. package/dist/typography-text.cjs +1 -1
  364. package/dist/typography-text.js +27 -57
  365. package/dist/typography.cjs +1 -1
  366. package/dist/typography.js +132 -340
  367. package/package.json +47 -47
  368. package/src/blocks/empty-state.tsx +34 -18
  369. package/src/blocks/input-list.tsx +14 -9
  370. package/src/blocks/sidebar.tsx +86 -31
  371. package/src/components/accordion.tsx +1 -1
  372. package/src/components/alert-dialog.tsx +4 -2
  373. package/src/components/badge.tsx +127 -15
  374. package/src/components/breadcrumb.tsx +1 -1
  375. package/src/components/button.tsx +8 -6
  376. package/src/components/calendar.tsx +155 -9
  377. package/src/components/card.tsx +63 -10
  378. package/src/components/carousel.tsx +4 -1
  379. package/src/components/chart.tsx +151 -17
  380. package/src/components/checkbox.tsx +1 -1
  381. package/src/components/collapsible.tsx +4 -1
  382. package/src/components/combobox.tsx +40 -7
  383. package/src/components/command.tsx +9 -10
  384. package/src/components/context-menu.tsx +4 -4
  385. package/src/components/data-table.tsx +619 -237
  386. package/src/components/date-picker.tsx +31 -4
  387. package/src/components/delta.tsx +217 -0
  388. package/src/components/description-list.tsx +445 -0
  389. package/src/components/drawer.tsx +5 -5
  390. package/src/components/dropdown-menu.tsx +4 -4
  391. package/src/components/field.tsx +36 -15
  392. package/src/components/global-layout.tsx +1 -1
  393. package/src/components/input-chip.tsx +51 -7
  394. package/src/components/input-group.tsx +1 -1
  395. package/src/components/input-password.tsx +15 -19
  396. package/src/components/input.tsx +10 -1
  397. package/src/components/list.tsx +695 -72
  398. package/src/components/logo-mark.tsx +345 -0
  399. package/src/components/map.tsx +18 -20
  400. package/src/components/media-viewer.tsx +908 -0
  401. package/src/components/multi-select-filter.tsx +255 -121
  402. package/src/components/navigation-menu.tsx +2 -2
  403. package/src/components/pagination.tsx +86 -26
  404. package/src/components/progress.tsx +91 -23
  405. package/src/components/rating.tsx +200 -74
  406. package/src/components/relative-date.tsx +19 -11
  407. package/src/components/resizable.tsx +86 -33
  408. package/src/components/result-count.tsx +253 -0
  409. package/src/components/scroll-area.tsx +31 -5
  410. package/src/components/select.tsx +2 -2
  411. package/src/components/sheet.tsx +14 -4
  412. package/src/components/single-select-filter.tsx +136 -41
  413. package/src/components/slider.tsx +2 -2
  414. package/src/components/status.tsx +162 -0
  415. package/src/components/switch.tsx +1 -1
  416. package/src/components/table.tsx +278 -106
  417. package/src/components/tabs.tsx +1 -0
  418. package/src/components/textarea.tsx +20 -2
  419. package/src/components/toggle.tsx +2 -2
  420. package/src/components/tooltip.tsx +11 -20
  421. package/src/hooks/use-filter-search-params.ts +302 -0
  422. package/src/index.ts +7 -0
  423. package/src/lib/compose-event-handlers.ts +14 -0
  424. package/src/lib/download-file.ts +61 -0
  425. package/src/lib/empty-chip.tsx +52 -0
  426. package/src/lib/field-aria.tsx +97 -0
  427. package/src/lib/image-file-info.ts +102 -0
  428. package/src/lib/media-viewer-content.tsx +1587 -0
  429. package/src/lib/media-viewer-internal.tsx +191 -0
  430. package/src/lib/media-viewer-motion.ts +120 -0
  431. package/src/lib/motion.ts +9 -0
  432. package/src/lib/table-internal.ts +74 -0
  433. package/src/lib/use-controllable.ts +43 -0
  434. package/src/lib/empty-chip.ts +0 -24
@@ -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
  ],
@@ -32,7 +32,7 @@ interface StrengthLevelConfig {
32
32
  value: number;
33
33
  /**
34
34
  * Background utility for the bar fill. Use the Progress bar palette
35
- * (`bg-green-400`, `bg-brand-red`, `bg-brand-orange`, `bg-brand-yellow`,
35
+ * (`bg-score-strong`, `bg-score-poor`, `bg-score-weak`, `bg-score-moderate`,
36
36
  * `bg-muted`) so custom levels stay consistent with Progress (DS-773).
37
37
  */
38
38
  color: string;
@@ -48,23 +48,19 @@ interface StrengthLevelConfig {
48
48
  * in light, green-950 in dark) — tints tuned as a backdrop, which read as a
49
49
  * washed-out or near-black 8px bar.
50
50
  *
51
- * The fill is `green-400` — the same fill the green Progress bar uses, a
52
- * documented palette-step-by-choice with Figma parity (DS-773, see
53
- * progress.tsx). The meter IS a Progress, so its green must match; the track
54
- * beneath stays Progress's own `brand-primary-foreground/20`. The token-first
55
- * alternative (`bg-brand-primary-foreground`) was tried in DS-666 and rejected
56
- * in review: its dark value (#00851E) renders a dim bar that diverges from
57
- * every other green Progress on the page.
51
+ * The fill is `score-strong` — the same fill the green Progress bar uses
52
+ * (the score scale, DS-774). The meter IS a Progress, so its green must match,
53
+ * and the track beneath is Progress's own `score-strong/20`.
58
54
  */
59
55
  const DEFAULT_STRENGTH_LEVELS: Record<
60
56
  DefaultPasswordStrength,
61
57
  StrengthLevelConfig
62
58
  > = {
63
- meter: { label: "Meter", value: 0, color: "bg-green-400" },
64
- weak: { label: "Weak", value: 25, color: "bg-green-400" },
65
- ok: { label: "Ok", value: 50, color: "bg-green-400" },
66
- good: { label: "Good", value: 75, color: "bg-green-400" },
67
- great: { label: "Great", value: 100, color: "bg-green-400" },
59
+ meter: { label: "Meter", value: 0, color: "bg-score-strong" },
60
+ weak: { label: "Weak", value: 25, color: "bg-score-strong" },
61
+ ok: { label: "Ok", value: 50, color: "bg-score-strong" },
62
+ good: { label: "Good", value: 75, color: "bg-score-strong" },
63
+ great: { label: "Great", value: 100, color: "bg-score-strong" },
68
64
  };
69
65
 
70
66
  /**
@@ -183,9 +179,9 @@ export interface InputPasswordProps<
183
179
  * @example
184
180
  * strengthLevels={{
185
181
  * empty: { label: "Enter password", value: 0, color: "bg-muted" },
186
- * slow: { label: "Slow", value: 33, color: "bg-brand-red" },
187
- * medium: { label: "Medium", value: 66, color: "bg-brand-yellow" },
188
- * fast: { label: "Fast", value: 100, color: "bg-green-400" },
182
+ * slow: { label: "Slow", value: 33, color: "bg-score-poor" },
183
+ * medium: { label: "Medium", value: 66, color: "bg-score-moderate" },
184
+ * fast: { label: "Fast", value: 100, color: "bg-score-strong" },
189
185
  * }}
190
186
  */
191
187
  strengthLevels?: Record<T, StrengthLevelConfig>;
@@ -227,9 +223,9 @@ export interface InputPasswordProps<
227
223
  * dataHook="password"
228
224
  * strengthLevels={{
229
225
  * empty: { label: "Enter password", value: 0, color: "bg-muted" },
230
- * slow: { label: "Slow", value: 33, color: "bg-brand-red" },
231
- * medium: { label: "Medium", value: 66, color: "bg-brand-yellow" },
232
- * fast: { label: "Fast", value: 100, color: "bg-green-400" },
226
+ * slow: { label: "Slow", value: 33, color: "bg-score-poor" },
227
+ * medium: { label: "Medium", value: 66, color: "bg-score-moderate" },
228
+ * fast: { label: "Fast", value: 100, color: "bg-score-strong" },
233
229
  * }}
234
230
  * calculateStrength={(password) => {
235
231
  * if (!password) return "empty";
@@ -3,6 +3,7 @@
3
3
  import * as React from "react";
4
4
  import { cva, type VariantProps } from "class-variance-authority";
5
5
  import { cn } from "@brightlocal/ui-components/lib/utils";
6
+ import { useFieldDescribedBy } from "../lib/field-aria";
6
7
 
7
8
  /**
8
9
  * Shared input variant styles
@@ -101,6 +102,7 @@ export const Input = React.forwardRef<HTMLInputElement, InputProps>(
101
102
  error,
102
103
  trackingEl,
103
104
  trackingLabel,
105
+ "aria-describedby": ariaDescribedBy,
104
106
  ...props
105
107
  },
106
108
  ref
@@ -111,14 +113,21 @@ export const Input = React.forwardRef<HTMLInputElement, InputProps>(
111
113
  props["aria-invalid"] === true ||
112
114
  props["aria-invalid"] === "true";
113
115
 
116
+ // Inside a Field, point aria-describedby at the FieldError and
117
+ // FieldDescription automatically; a hand-wired value is kept and merged.
118
+ const describedBy = useFieldDescribedBy(ariaDescribedBy);
119
+
114
120
  return (
115
121
  <input
116
122
  ref={ref}
123
+ aria-describedby={describedBy}
117
124
  aria-invalid={hasError ? "true" : undefined}
118
125
  className={cn(
119
126
  inputVariants({ hasIcon, hasSecondaryIcon }),
127
+ // scroll-mb-16 reserves room for a two-line error message under the
128
+ // field, so a phone keyboard scrolls the message into view with it
120
129
  hasError &&
121
- "border-destructive-40 focus-visible:border-destructive-40 focus-visible:shadow-destructive",
130
+ "border-destructive-40 focus-visible:border-destructive-40 focus-visible:shadow-destructive scroll-mb-16",
122
131
  className
123
132
  )}
124
133
  data-hook={dataHook}