@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
@@ -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}
@@ -12,7 +12,6 @@ import { Skeleton } from "@brightlocal/ui-components/skeleton";
12
12
  const itemVariants = cva(
13
13
  [
14
14
  "flex",
15
- "items-center",
16
15
  "gap-4",
17
16
  "rounded-lg",
18
17
  "py-2",
@@ -30,9 +29,14 @@ const itemVariants = cva(
30
29
  outline: ["bg-background", "border", "border-border"],
31
30
  loading: ["p-0"],
32
31
  },
32
+ align: {
33
+ center: ["items-center"],
34
+ start: ["items-start"],
35
+ },
33
36
  },
34
37
  defaultVariants: {
35
38
  variant: "filled",
39
+ align: "center",
36
40
  },
37
41
  }
38
42
  );
@@ -115,6 +119,13 @@ export type ItemProps = React.ComponentProps<"li"> & {
115
119
  * @default "filled"
116
120
  */
117
121
  variant?: "default" | "filled" | "outline" | "loading";
122
+ /**
123
+ * Cross-axis alignment of the row's children (media, content, actions).
124
+ * Use `"start"` when ItemMedia (icon, avatar, step number) should pin to the
125
+ * first line of multi-line content instead of centering vertically.
126
+ * @default "center"
127
+ */
128
+ align?: "center" | "start";
118
129
  /**
119
130
  * Data hook for automated testing.
120
131
  */
@@ -139,6 +150,7 @@ const Item = React.forwardRef<HTMLLIElement, ItemProps>(
139
150
  asChild = false,
140
151
  className,
141
152
  variant,
153
+ align,
142
154
  dataHook,
143
155
  trackingEl,
144
156
  trackingLabel,
@@ -152,7 +164,7 @@ const Item = React.forwardRef<HTMLLIElement, ItemProps>(
152
164
  return (
153
165
  <Comp
154
166
  ref={ref}
155
- className={cn(itemVariants({ variant }), className)}
167
+ className={cn(itemVariants({ variant, align }), className)}
156
168
  data-hook={dataHook}
157
169
  data-slot="item"
158
170
  data-tracking-el={trackingEl}
@@ -0,0 +1,345 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+
5
+ import { cva, type VariantProps } from "class-variance-authority";
6
+
7
+ import { cn } from "@brightlocal/ui-components/lib/utils";
8
+
9
+ const SOURCE_ICON_ALIASES: Record<string, string> = {
10
+ twitter: "x-ex-twitter",
11
+ "x-twitter": "x-ex-twitter",
12
+ x: "x-ex-twitter",
13
+ playgoogle: "google-play",
14
+ googleseller: "google",
15
+ "google-seller": "google",
16
+ googleaimode: "gemini",
17
+ "google-ai-mode": "gemini",
18
+ googleaio: "gemini",
19
+ "google-ai-overviews": "gemini",
20
+ ypnetwork: "yellowpages",
21
+ superpagesaus: "superpages",
22
+ "192": "oneninetwo",
23
+ "2findlocal": "twofindlocal",
24
+ "118118": "oneoneeight",
25
+ };
26
+
27
+ type IconComponent = React.ComponentType<
28
+ React.SVGProps<SVGSVGElement> & { size?: number | string }
29
+ >;
30
+
31
+ /**
32
+ * Icons that have already been loaded, keyed by `${stem}:${colorScheme}`.
33
+ * A mark that resolved once renders synchronously on every later mount, so
34
+ * the letter fallback only ever shows while a chunk is loading for the first
35
+ * time. `null` records a name that resolves to nothing.
36
+ */
37
+ const resolvedIcons = new Map<string, IconComponent | null>();
38
+
39
+ /** Strip file extensions, domain TLDs and trailing dots → bare brand stem. */
40
+ function normalizeName(raw: string): string {
41
+ let s = raw.trim().toLowerCase();
42
+ s = s.replace(/\.+$/, "");
43
+ s = s.replace(/\.(ico|png|svg|jpe?g|gif|webp|bmp|avif)$/, "");
44
+ const dot = s.indexOf(".");
45
+ if (dot > 0) s = s.substring(0, dot);
46
+ return s;
47
+ }
48
+
49
+ /** Mirrors `toPascalCase` in `@brightlocal/icons` scripts/generate-icons.ts. */
50
+ function stemToPascal(stem: string): string {
51
+ return stem
52
+ .split("-")
53
+ .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
54
+ .join("");
55
+ }
56
+
57
+ let iconImportsPromise: Promise<
58
+ Record<string, () => Promise<{ default: React.ComponentType }>>
59
+ > | null = null;
60
+
61
+ function getIconImports() {
62
+ if (!iconImportsPromise) {
63
+ iconImportsPromise = import("@brightlocal/icons/dynamic").then(
64
+ (mod) => mod.iconImports
65
+ );
66
+ }
67
+ return iconImportsPromise;
68
+ }
69
+
70
+ const logoMarkStyles = cva(
71
+ "relative inline-flex shrink-0 items-center justify-center",
72
+ {
73
+ variants: {
74
+ size: {
75
+ xs: "",
76
+ sm: "",
77
+ md: "",
78
+ lg: "",
79
+ },
80
+ variant: {
81
+ transparent: "",
82
+ filled: "overflow-hidden bg-muted",
83
+ border: "border border-border",
84
+ },
85
+ },
86
+ compoundVariants: [
87
+ { variant: "filled", size: "xs", className: "size-5 rounded-md" },
88
+ { variant: "filled", size: "sm", className: "size-6 rounded-md" },
89
+ { variant: "filled", size: "md", className: "size-8 rounded-lg" },
90
+ { variant: "filled", size: "lg", className: "size-10 rounded-lg" },
91
+ { variant: "transparent", size: "xs", className: "size-4" },
92
+ { variant: "transparent", size: "sm", className: "size-5" },
93
+ { variant: "transparent", size: "md", className: "size-6" },
94
+ { variant: "transparent", size: "lg", className: "size-8" },
95
+ { variant: "border", size: "xs", className: "size-5 rounded-md" },
96
+ { variant: "border", size: "sm", className: "size-6 rounded-md" },
97
+ { variant: "border", size: "md", className: "size-8 rounded-lg" },
98
+ { variant: "border", size: "lg", className: "size-10 rounded-lg" },
99
+ ],
100
+ defaultVariants: {
101
+ size: "md",
102
+ variant: "filled",
103
+ },
104
+ }
105
+ );
106
+
107
+ const iconSizeMap = {
108
+ xs: { contained: 12, bare: 16 },
109
+ sm: { contained: 14, bare: 20 },
110
+ md: { contained: 18, bare: 24 },
111
+ lg: { contained: 22, bare: 32 },
112
+ } as const;
113
+
114
+ const fallbackTextStyles = cva(
115
+ "select-none font-semibold text-muted-foreground",
116
+ {
117
+ variants: {
118
+ size: {
119
+ xs: "text-label-sm leading-none",
120
+ sm: "text-label-sm leading-none",
121
+ md: "text-label-sm leading-none",
122
+ lg: "text-body-sm",
123
+ },
124
+ },
125
+ defaultVariants: {
126
+ size: "md",
127
+ },
128
+ }
129
+ );
130
+
131
+ export type LogoMarkSize = "xs" | "sm" | "md" | "lg";
132
+ export type LogoMarkVariant = "transparent" | "filled" | "border";
133
+ export type LogoMarkColorScheme = "original" | "neutral";
134
+
135
+ export interface LogoMarkProps
136
+ extends
137
+ Omit<React.ComponentPropsWithoutRef<"span">, "children">,
138
+ VariantProps<typeof logoMarkStyles> {
139
+ /** Data hook for automated testing (REQUIRED) */
140
+ dataHook: string;
141
+ /**
142
+ * Brand/icon key or a custom icon element.
143
+ *
144
+ * **String** — resolved through: social-media registry (`"yelp"`,
145
+ * `"google"`) → lucide icon stem (`"globe"`, `"map-pin"`) → letter
146
+ * fallback. Domain-like inputs (`"yelp.com.au"`) and file extensions
147
+ * (`.ico`, `.png`) are stripped automatically.
148
+ *
149
+ * **ReactNode** — rendered directly inside the container at the correct
150
+ * size. The resolution pipeline is skipped entirely.
151
+ *
152
+ * @example
153
+ * ```tsx
154
+ * <LogoMark name="yelp" dataHook="source-yelp" />
155
+ * <LogoMark name={<AcmeLogo />} dataHook="source-acme" />
156
+ * ```
157
+ */
158
+ name: string | React.ReactNode;
159
+ /**
160
+ * Container and icon size.
161
+ * @default "md"
162
+ */
163
+ size?: LogoMarkSize;
164
+ /**
165
+ * Visual container variant.
166
+ * - `filled` — bg-muted rounded surface (default, safe for brand-colour icons)
167
+ * - `border` — border ring with transparent background
168
+ * - `transparent` — bare icon with no container
169
+ * @default "filled"
170
+ */
171
+ variant?: LogoMarkVariant;
172
+ /**
173
+ * Icon colour scheme resolved from the social-media registry.
174
+ * - `original` — full brand colours (default)
175
+ * - `neutral` — monochrome/greyscale variant
176
+ * @default "original"
177
+ */
178
+ colorScheme?: LogoMarkColorScheme;
179
+ /**
180
+ * Override the fallback initial letter shown when no icon resolves.
181
+ * Defaults to the first character of `name`.
182
+ */
183
+ fallback?: string;
184
+ /** Analytics element identifier. @default "logo-mark" */
185
+ trackingEl?: string;
186
+ /** Analytics label */
187
+ trackingLabel?: string;
188
+ /**
189
+ * Accessible label. When provided, the mark is announced to screen
190
+ * readers; otherwise it is treated as decorative.
191
+ * @default undefined (decorative)
192
+ */
193
+ ariaLabel?: string;
194
+ }
195
+
196
+ /**
197
+ * Displays a brand logo or icon in a consistent mark, with three container
198
+ * styles.
199
+ *
200
+ * Resolution order: social-media icon registry → lucide icon →
201
+ * letter-initial fallback. Each icon is loaded as its own chunk through
202
+ * `iconImports` from `@brightlocal/icons/dynamic`, so a page pays only for
203
+ * the marks it renders.
204
+ */
205
+ const LogoMark = React.forwardRef<HTMLSpanElement, LogoMarkProps>(
206
+ (
207
+ {
208
+ className,
209
+ dataHook,
210
+ name,
211
+ size = "md",
212
+ variant = "filled",
213
+ colorScheme = "original",
214
+ fallback,
215
+ trackingEl,
216
+ trackingLabel,
217
+ ariaLabel,
218
+ ...props
219
+ },
220
+ ref
221
+ ) => {
222
+ const isStringName = typeof name === "string";
223
+ const key = isStringName ? normalizeName(name) : "";
224
+ const stem = isStringName
225
+ ? Object.hasOwn(SOURCE_ICON_ALIASES, key)
226
+ ? SOURCE_ICON_ALIASES[key]
227
+ : key
228
+ : "";
229
+ const cacheKey = `${stem}:${colorScheme}`;
230
+
231
+ const [IconComponent, setIconComponent] =
232
+ React.useState<IconComponent | null>(() =>
233
+ isStringName ? (resolvedIcons.get(cacheKey) ?? null) : null
234
+ );
235
+
236
+ React.useEffect(() => {
237
+ if (!isStringName) return;
238
+
239
+ const cached = resolvedIcons.get(cacheKey);
240
+ if (cached !== undefined) {
241
+ setIconComponent(() => cached);
242
+ return;
243
+ }
244
+
245
+ if (!stem) {
246
+ resolvedIcons.set(cacheKey, null);
247
+ setIconComponent(null);
248
+ return;
249
+ }
250
+
251
+ let ignore = false;
252
+ setIconComponent(null);
253
+
254
+ const neutral = colorScheme === "neutral";
255
+ const socialKey = stemToPascal(stem) + (neutral ? "Neutral" : "Original");
256
+
257
+ getIconImports()
258
+ .then((imports) => {
259
+ if (ignore) return;
260
+ const importKey = Object.hasOwn(imports, socialKey)
261
+ ? socialKey
262
+ : Object.hasOwn(imports, stem)
263
+ ? stem
264
+ : null;
265
+ const load = importKey ? imports[importKey] : undefined;
266
+ if (!load) {
267
+ resolvedIcons.set(cacheKey, null);
268
+ setIconComponent(null);
269
+ return;
270
+ }
271
+ return load();
272
+ })
273
+ .then((mod) => {
274
+ if (ignore || !mod) return;
275
+ const d = mod.default;
276
+ const Icon =
277
+ d != null &&
278
+ (typeof d === "function" ||
279
+ (typeof d === "object" && "$$typeof" in d))
280
+ ? (d as IconComponent)
281
+ : null;
282
+ resolvedIcons.set(cacheKey, Icon);
283
+ if (!ignore) setIconComponent(() => Icon);
284
+ })
285
+ .catch(() => {
286
+ if (!ignore) setIconComponent(null);
287
+ });
288
+
289
+ return () => {
290
+ ignore = true;
291
+ };
292
+ }, [cacheKey, stem, colorScheme, isStringName]);
293
+
294
+ const sizeKey = size ?? "md";
295
+ const isContained = variant !== "transparent";
296
+ const iconSize = isContained
297
+ ? iconSizeMap[sizeKey].contained
298
+ : iconSizeMap[sizeKey].bare;
299
+ const initial = isStringName
300
+ ? (fallback || name.charAt(0) || "?").toUpperCase()
301
+ : "?";
302
+
303
+ const isDecorative = !ariaLabel;
304
+
305
+ return (
306
+ <span
307
+ ref={ref}
308
+ aria-hidden={isDecorative ? "true" : undefined}
309
+ aria-label={ariaLabel}
310
+ className={cn(logoMarkStyles({ size, variant }), className)}
311
+ data-hook={dataHook}
312
+ data-slot="logo-mark"
313
+ data-tracking-el={trackingEl ?? "logo-mark"}
314
+ data-tracking-label={trackingLabel}
315
+ role={isDecorative ? "presentation" : "img"}
316
+ {...props}
317
+ >
318
+ {!isStringName ? (
319
+ <span
320
+ aria-hidden="true"
321
+ className="[&>img]:h-full [&>img]:w-full [&>svg]:h-full [&>svg]:w-full"
322
+ data-slot="logo-mark-icon"
323
+ style={{ width: iconSize, height: iconSize }}
324
+ >
325
+ {name}
326
+ </span>
327
+ ) : IconComponent ? (
328
+ <IconComponent aria-hidden="true" size={iconSize} />
329
+ ) : (
330
+ <span
331
+ aria-hidden="true"
332
+ className={fallbackTextStyles({ size })}
333
+ data-slot="logo-mark-fallback"
334
+ >
335
+ {initial}
336
+ </span>
337
+ )}
338
+ </span>
339
+ );
340
+ }
341
+ );
342
+
343
+ LogoMark.displayName = "LogoMark";
344
+
345
+ export { LogoMark, SOURCE_ICON_ALIASES };
@@ -225,11 +225,7 @@ type ResolvedVariant = "strong" | "moderate" | "weak" | "unranked" | "error";
225
225
 
226
226
  /** @deprecated Legacy variant names kept for backward compatibility. */
227
227
  type LegacyVariant =
228
- | "primary"
229
- | "secondary"
230
- | "destructive"
231
- | "outline"
232
- | "warning";
228
+ "primary" | "secondary" | "destructive" | "outline" | "warning";
233
229
 
234
230
  type MapGridPinVariant = ResolvedVariant | LegacyVariant;
235
231
 
@@ -251,8 +247,9 @@ function resolveVariant(variant: MapGridPinVariant): ResolvedVariant {
251
247
  }
252
248
 
253
249
  /**
254
- * Single source of truth for ranking variant colors.
255
- * Tailwind classes power MapGridPin / MapLegendItem; CSS vars + hex
250
+ * Single source of truth for ranking variant colors: the score scale
251
+ * (`score-*`, DS-774) — strong → poor. `error` is not a grade, so it keeps the
252
+ * warning surface. Tailwind classes power MapGridPin / MapLegendItem; CSS vars + hex
256
253
  * fallbacks power the cluster-pin SVG renderer.
257
254
  */
258
255
  const RANKING_COLORS: Record<
@@ -260,24 +257,24 @@ const RANKING_COLORS: Record<
260
257
  { className: string; cssVar: string; fallback: string }
261
258
  > = {
262
259
  strong: {
263
- className: "bg-primary dark:bg-green-400",
264
- cssVar: "--ds-tailwind-colors-green-400",
260
+ className: "bg-score-strong",
261
+ cssVar: "--score-strong",
265
262
  fallback: "#2ae855",
266
263
  },
267
264
  moderate: {
268
- className: "bg-chart-4",
269
- cssVar: "--ds-tailwind-colors-yellow-400",
265
+ className: "bg-score-moderate",
266
+ cssVar: "--score-moderate",
270
267
  fallback: "#facc15",
271
268
  },
272
269
  weak: {
273
- className: "bg-orange-400",
274
- cssVar: "--ds-tailwind-colors-orange-400",
270
+ className: "bg-score-weak",
271
+ cssVar: "--score-weak",
275
272
  fallback: "#fb923c",
276
273
  },
277
274
  unranked: {
278
- className: "bg-red-600",
279
- cssVar: "--ds-tailwind-colors-red-600",
280
- fallback: "#dc2626",
275
+ className: "bg-score-poor",
276
+ cssVar: "--score-poor",
277
+ fallback: "#f87171",
281
278
  },
282
279
  error: {
283
280
  className: "bg-warning-background dark:bg-orange-200",
@@ -299,10 +296,11 @@ const mapGridPinVariants = cva(
299
296
  {
300
297
  variants: {
301
298
  variant: {
302
- strong: `${mapGridPinColorMap.strong}`,
303
- moderate: `${mapGridPinColorMap.moderate}`,
304
- weak: `${mapGridPinColorMap.weak}`,
305
- unranked: `${mapGridPinColorMap.unranked} text-white dark:text-white`,
299
+ // Each grade's own -foreground on its fill (≥ 5.8:1 in both themes).
300
+ strong: `${mapGridPinColorMap.strong} text-score-strong-foreground dark:text-score-strong-foreground`,
301
+ moderate: `${mapGridPinColorMap.moderate} text-score-moderate-foreground dark:text-score-moderate-foreground`,
302
+ weak: `${mapGridPinColorMap.weak} text-score-weak-foreground dark:text-score-weak-foreground`,
303
+ unranked: `${mapGridPinColorMap.unranked} text-score-poor-foreground dark:text-score-poor-foreground`,
306
304
  error: `${mapGridPinColorMap.error}`,
307
305
  },
308
306
  },