@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
@@ -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
  },