@brightlocal/ui-components 3.1.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 (463) hide show
  1. package/AI_USAGE.md +10 -0
  2. package/README.md +8 -1
  3. package/component-meta.json +1591 -123
  4. package/deprecations.json +45 -1
  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 +36 -5
  10. package/dist/alert-dialog.d.ts.map +1 -1
  11. package/dist/alert-dialog.js +83 -128
  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 +116 -177
  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 +32 -1
  22. package/dist/badge.d.ts.map +1 -1
  23. package/dist/badge.js +90 -71
  24. package/dist/banner.cjs +1 -0
  25. package/dist/banner.d.ts +81 -0
  26. package/dist/banner.d.ts.map +1 -0
  27. package/dist/banner.js +130 -0
  28. package/dist/blocks/empty-state.cjs +1 -1
  29. package/dist/blocks/empty-state.d.ts +24 -6
  30. package/dist/blocks/empty-state.d.ts.map +1 -1
  31. package/dist/blocks/empty-state.js +74 -140
  32. package/dist/blocks/input-list.cjs +2 -2
  33. package/dist/blocks/input-list.d.ts +2 -2
  34. package/dist/blocks/input-list.d.ts.map +1 -1
  35. package/dist/blocks/input-list.js +136 -176
  36. package/dist/blocks/progress-state.cjs +1 -1
  37. package/dist/blocks/progress-state.d.ts +2 -2
  38. package/dist/blocks/progress-state.js +223 -347
  39. package/dist/blocks/sidebar.cjs +1 -1
  40. package/dist/blocks/sidebar.d.ts +28 -6
  41. package/dist/blocks/sidebar.d.ts.map +1 -1
  42. package/dist/blocks/sidebar.js +763 -1086
  43. package/dist/brand-illustration-motif.cjs +1 -1
  44. package/dist/brand-illustration-motif.d.ts +1 -1
  45. package/dist/brand-illustration-motif.js +40 -61
  46. package/dist/breadcrumb.cjs +1 -1
  47. package/dist/breadcrumb.js +62 -102
  48. package/dist/button-group.cjs +1 -1
  49. package/dist/button-group.js +23 -31
  50. package/dist/button.cjs +1 -1
  51. package/dist/button.d.ts +4 -2
  52. package/dist/button.d.ts.map +1 -1
  53. package/dist/button.js +149 -189
  54. package/dist/calendar.cjs +1 -1
  55. package/dist/calendar.d.ts +87 -3
  56. package/dist/calendar.d.ts.map +1 -1
  57. package/dist/calendar.js +116 -173
  58. package/dist/callout.cjs +1 -1
  59. package/dist/callout.js +73 -96
  60. package/dist/card.cjs +1 -1
  61. package/dist/card.d.ts +92 -6
  62. package/dist/card.d.ts.map +1 -1
  63. package/dist/card.js +240 -234
  64. package/dist/carousel.cjs +1 -1
  65. package/dist/carousel.d.ts +3 -3
  66. package/dist/carousel.d.ts.map +1 -1
  67. package/dist/carousel.js +174 -268
  68. package/dist/centred-layout.cjs +1 -1
  69. package/dist/centred-layout.js +27 -48
  70. package/dist/chart-empty.cjs +1 -1
  71. package/dist/chart-empty.js +18 -27
  72. package/dist/chart.cjs +7 -7
  73. package/dist/chart.d.ts +253 -25
  74. package/dist/chart.d.ts.map +1 -1
  75. package/dist/chart.js +465 -511
  76. package/dist/checkbox.cjs +1 -1
  77. package/dist/checkbox.d.ts +1 -1
  78. package/dist/checkbox.d.ts.map +1 -1
  79. package/dist/checkbox.js +37 -69
  80. package/dist/chip.cjs +1 -1
  81. package/dist/chip.js +116 -173
  82. package/dist/collapsible.cjs +1 -1
  83. package/dist/collapsible.d.ts.map +1 -1
  84. package/dist/collapsible.js +35 -41
  85. package/dist/combobox.cjs +3 -3
  86. package/dist/combobox.d.ts +14 -4
  87. package/dist/combobox.d.ts.map +1 -1
  88. package/dist/combobox.js +440 -639
  89. package/dist/command.cjs +1 -1
  90. package/dist/command.d.ts.map +1 -1
  91. package/dist/command.js +273 -420
  92. package/dist/context-menu.cjs +1 -1
  93. package/dist/context-menu.d.ts +5 -5
  94. package/dist/context-menu.d.ts.map +1 -1
  95. package/dist/context-menu.js +121 -191
  96. package/dist/data-table.cjs +1 -1
  97. package/dist/data-table.d.ts +442 -144
  98. package/dist/data-table.d.ts.map +1 -1
  99. package/dist/data-table.js +708 -835
  100. package/dist/date-picker.cjs +1 -1
  101. package/dist/date-picker.d.ts +15 -4
  102. package/dist/date-picker.d.ts.map +1 -1
  103. package/dist/date-picker.js +156 -231
  104. package/dist/delta.cjs +1 -0
  105. package/dist/delta.d.ts +79 -0
  106. package/dist/delta.d.ts.map +1 -0
  107. package/dist/delta.js +62 -0
  108. package/dist/description.cjs +1 -1
  109. package/dist/description.js +11 -20
  110. package/dist/dialog.cjs +1 -1
  111. package/dist/dialog.d.ts +1 -1
  112. package/dist/dialog.d.ts.map +1 -1
  113. package/dist/dialog.js +76 -116
  114. package/dist/drawer.cjs +1 -1
  115. package/dist/drawer.d.ts +11 -11
  116. package/dist/drawer.d.ts.map +1 -1
  117. package/dist/drawer.js +76 -134
  118. package/dist/dropdown-menu.cjs +1 -1
  119. package/dist/dropdown-menu.d.ts +6 -6
  120. package/dist/dropdown-menu.d.ts.map +1 -1
  121. package/dist/dropdown-menu.js +179 -300
  122. package/dist/field.cjs +1 -1
  123. package/dist/field.d.ts +9 -9
  124. package/dist/field.d.ts.map +1 -1
  125. package/dist/field.js +166 -286
  126. package/dist/global-layout.cjs +1 -1
  127. package/dist/global-layout.js +203 -342
  128. package/dist/grid.cjs +1 -1
  129. package/dist/grid.d.ts +24 -1
  130. package/dist/grid.d.ts.map +1 -1
  131. package/dist/grid.js +16 -29
  132. package/dist/header.cjs +1 -1
  133. package/dist/header.js +21 -38
  134. package/dist/height-transition.cjs +1 -1
  135. package/dist/height-transition.js +38 -55
  136. package/dist/hooks/use-breakpoint.cjs +1 -1
  137. package/dist/hooks/use-breakpoint.d.ts +1 -1
  138. package/dist/hooks/use-breakpoint.d.ts.map +1 -1
  139. package/dist/hooks/use-breakpoint.js +10 -9
  140. package/dist/hooks/use-debounce.cjs +1 -1
  141. package/dist/hooks/use-debounce.js +12 -11
  142. package/dist/hooks/use-delayed-pending.cjs +1 -1
  143. package/dist/hooks/use-delayed-pending.js +8 -9
  144. package/dist/hooks/use-filter-search-params.cjs +1 -0
  145. package/dist/hooks/use-filter-search-params.d.ts +93 -0
  146. package/dist/hooks/use-filter-search-params.d.ts.map +1 -0
  147. package/dist/hooks/use-filter-search-params.js +122 -0
  148. package/dist/hooks/use-mobile.cjs +1 -1
  149. package/dist/hooks/use-mobile.js +6 -6
  150. package/dist/hooks/use-overlay-pointer-lock.cjs +1 -1
  151. package/dist/hooks/use-overlay-pointer-lock.js +8 -9
  152. package/dist/hooks/use-prefers-reduced-motion.cjs +1 -1
  153. package/dist/hooks/use-prefers-reduced-motion.js +5 -8
  154. package/dist/hover-card.cjs +1 -1
  155. package/dist/hover-card.d.ts +1 -1
  156. package/dist/hover-card.d.ts.map +1 -1
  157. package/dist/hover-card.js +30 -62
  158. package/dist/index.cjs +1 -1
  159. package/dist/index.d.ts +11 -0
  160. package/dist/index.d.ts.map +1 -1
  161. package/dist/index.js +636 -582
  162. package/dist/info-tooltip.cjs +1 -0
  163. package/dist/info-tooltip.d.ts +39 -0
  164. package/dist/info-tooltip.d.ts.map +1 -0
  165. package/dist/info-tooltip.js +27 -0
  166. package/dist/input-chip.cjs +1 -1
  167. package/dist/input-chip.d.ts +32 -3
  168. package/dist/input-chip.d.ts.map +1 -1
  169. package/dist/input-chip.js +182 -231
  170. package/dist/input-group.cjs +1 -1
  171. package/dist/input-group.d.ts +33 -2
  172. package/dist/input-group.d.ts.map +1 -1
  173. package/dist/input-group.js +188 -122
  174. package/dist/input-otp.cjs +1 -1
  175. package/dist/input-otp.d.ts +3 -3
  176. package/dist/input-otp.d.ts.map +1 -1
  177. package/dist/input-otp.js +102 -146
  178. package/dist/input-password.cjs +1 -1
  179. package/dist/input-password.d.ts +26 -8
  180. package/dist/input-password.d.ts.map +1 -1
  181. package/dist/input-password.js +139 -171
  182. package/dist/input.cjs +1 -1
  183. package/dist/input.d.ts.map +1 -1
  184. package/dist/input.js +51 -73
  185. package/dist/label.cjs +1 -1
  186. package/dist/label.js +20 -38
  187. package/dist/lib/block-illustration.cjs +1 -1
  188. package/dist/lib/block-illustration.d.ts +5 -2
  189. package/dist/lib/block-illustration.d.ts.map +1 -1
  190. package/dist/lib/block-illustration.js +16 -17
  191. package/dist/lib/compose-event-handlers.cjs +1 -0
  192. package/dist/lib/compose-event-handlers.d.ts +9 -0
  193. package/dist/lib/compose-event-handlers.d.ts.map +1 -0
  194. package/dist/lib/compose-event-handlers.js +8 -0
  195. package/dist/lib/download-file.cjs +1 -0
  196. package/dist/lib/download-file.d.ts +14 -0
  197. package/dist/lib/download-file.d.ts.map +1 -0
  198. package/dist/lib/download-file.js +40 -0
  199. package/dist/lib/empty-canvas.cjs +1 -1
  200. package/dist/lib/empty-canvas.js +28 -56
  201. package/dist/lib/empty-chip.cjs +1 -1
  202. package/dist/lib/empty-chip.d.ts +14 -3
  203. package/dist/lib/empty-chip.d.ts.map +1 -1
  204. package/dist/lib/empty-chip.js +15 -11
  205. package/dist/lib/field-aria.cjs +1 -0
  206. package/dist/lib/field-aria.d.ts +34 -0
  207. package/dist/lib/field-aria.d.ts.map +1 -0
  208. package/dist/lib/field-aria.js +52 -0
  209. package/dist/lib/image-file-info.cjs +1 -0
  210. package/dist/lib/image-file-info.d.ts +25 -0
  211. package/dist/lib/image-file-info.d.ts.map +1 -0
  212. package/dist/lib/image-file-info.js +67 -0
  213. package/dist/lib/media-viewer-content.cjs +1 -0
  214. package/dist/lib/media-viewer-content.d.ts +102 -0
  215. package/dist/lib/media-viewer-content.d.ts.map +1 -0
  216. package/dist/lib/media-viewer-content.js +650 -0
  217. package/dist/lib/media-viewer-internal.cjs +1 -0
  218. package/dist/lib/media-viewer-internal.d.ts +98 -0
  219. package/dist/lib/media-viewer-internal.d.ts.map +1 -0
  220. package/dist/lib/media-viewer-internal.js +61 -0
  221. package/dist/lib/media-viewer-motion.cjs +1 -0
  222. package/dist/lib/media-viewer-motion.d.ts +40 -0
  223. package/dist/lib/media-viewer-motion.d.ts.map +1 -0
  224. package/dist/lib/media-viewer-motion.js +37 -0
  225. package/dist/lib/motion.cjs +1 -1
  226. package/dist/lib/motion.d.ts +8 -0
  227. package/dist/lib/motion.d.ts.map +1 -1
  228. package/dist/lib/motion.js +11 -10
  229. package/dist/lib/optical-center.cjs +1 -1
  230. package/dist/lib/optical-center.d.ts +1 -1
  231. package/dist/lib/optical-center.d.ts.map +1 -1
  232. package/dist/lib/optical-center.js +12 -5
  233. package/dist/lib/spring-settle.cjs +1 -1
  234. package/dist/lib/spring-settle.js +1 -1
  235. package/dist/lib/table-internal.cjs +1 -0
  236. package/dist/lib/table-internal.d.ts +62 -0
  237. package/dist/lib/table-internal.d.ts.map +1 -0
  238. package/dist/lib/table-internal.js +18 -0
  239. package/dist/lib/use-controllable.cjs +1 -0
  240. package/dist/lib/use-controllable.d.ts +12 -0
  241. package/dist/lib/use-controllable.d.ts.map +1 -0
  242. package/dist/lib/use-controllable.js +15 -0
  243. package/dist/lib/use-dev-warning.cjs +1 -1
  244. package/dist/lib/utils.cjs +1 -1
  245. package/dist/lib/utils.d.ts.map +1 -1
  246. package/dist/lib/utils.js +29 -35
  247. package/dist/link.cjs +1 -1
  248. package/dist/link.d.ts +1 -1
  249. package/dist/link.js +78 -124
  250. package/dist/list.cjs +1 -1
  251. package/dist/list.d.ts +8 -0
  252. package/dist/list.d.ts.map +1 -1
  253. package/dist/list.js +94 -156
  254. package/dist/loading.cjs +1 -1
  255. package/dist/loading.js +124 -151
  256. package/dist/logo-mark.cjs +1 -0
  257. package/dist/logo-mark.d.ts +79 -0
  258. package/dist/logo-mark.d.ts.map +1 -0
  259. package/dist/logo-mark.js +219 -0
  260. package/dist/logo.cjs +1 -1
  261. package/dist/logo.d.ts +1 -1
  262. package/dist/logo.d.ts.map +1 -1
  263. package/dist/logo.js +51 -87
  264. package/dist/map.cjs +1 -1
  265. package/dist/map.d.ts.map +1 -1
  266. package/dist/map.js +390 -586
  267. package/dist/media-empty.cjs +1 -1
  268. package/dist/media-empty.js +27 -42
  269. package/dist/media-viewer.cjs +1 -0
  270. package/dist/media-viewer.d.ts +224 -0
  271. package/dist/media-viewer.d.ts.map +1 -0
  272. package/dist/media-viewer.js +295 -0
  273. package/dist/menubar.cjs +1 -1
  274. package/dist/menubar.d.ts +14 -14
  275. package/dist/menubar.d.ts.map +1 -1
  276. package/dist/menubar.js +130 -267
  277. package/dist/multi-select-filter.cjs +1 -0
  278. package/dist/multi-select-filter.d.ts +186 -0
  279. package/dist/multi-select-filter.d.ts.map +1 -0
  280. package/dist/multi-select-filter.js +374 -0
  281. package/dist/navigation-menu.cjs +1 -1
  282. package/dist/navigation-menu.js +108 -172
  283. package/dist/pagination.cjs +1 -1
  284. package/dist/pagination.d.ts +36 -12
  285. package/dist/pagination.d.ts.map +1 -1
  286. package/dist/pagination.js +208 -281
  287. package/dist/popover.cjs +1 -1
  288. package/dist/popover.d.ts +1 -1
  289. package/dist/popover.d.ts.map +1 -1
  290. package/dist/popover.js +34 -45
  291. package/dist/progress.cjs +1 -1
  292. package/dist/progress.d.ts +139 -17
  293. package/dist/progress.d.ts.map +1 -1
  294. package/dist/progress.js +116 -148
  295. package/dist/radio-group.cjs +1 -1
  296. package/dist/radio-group.js +90 -146
  297. package/dist/rating.cjs +1 -1
  298. package/dist/rating.d.ts +80 -13
  299. package/dist/rating.d.ts.map +1 -1
  300. package/dist/rating.js +70 -65
  301. package/dist/relative-date.cjs +1 -0
  302. package/dist/relative-date.d.ts +65 -0
  303. package/dist/relative-date.d.ts.map +1 -0
  304. package/dist/relative-date.js +112 -0
  305. package/dist/resizable.cjs +1 -1
  306. package/dist/resizable.d.ts +39 -23
  307. package/dist/resizable.d.ts.map +1 -1
  308. package/dist/resizable.js +42 -44
  309. package/dist/result-count.cjs +1 -0
  310. package/dist/result-count.d.ts +110 -0
  311. package/dist/result-count.d.ts.map +1 -0
  312. package/dist/result-count.js +49 -0
  313. package/dist/route-progress.cjs +1 -1
  314. package/dist/route-progress.js +58 -102
  315. package/dist/scroll-area.cjs +1 -1
  316. package/dist/scroll-area.d.ts +9 -1
  317. package/dist/scroll-area.d.ts.map +1 -1
  318. package/dist/scroll-area.js +44 -79
  319. package/dist/select.cjs +2 -2
  320. package/dist/select.d.ts +20 -10
  321. package/dist/select.d.ts.map +1 -1
  322. package/dist/select.js +132 -236
  323. package/dist/separator.cjs +1 -1
  324. package/dist/separator.js +90 -78
  325. package/dist/sheet.cjs +1 -1
  326. package/dist/sheet.d.ts +86 -7
  327. package/dist/sheet.d.ts.map +1 -1
  328. package/dist/sheet.js +275 -235
  329. package/dist/single-select-filter.cjs +1 -0
  330. package/dist/single-select-filter.d.ts +113 -0
  331. package/dist/single-select-filter.d.ts.map +1 -0
  332. package/dist/single-select-filter.js +224 -0
  333. package/dist/skeleton.cjs +1 -1
  334. package/dist/skeleton.js +24 -38
  335. package/dist/slider.cjs +1 -1
  336. package/dist/slider.js +51 -81
  337. package/dist/sonner.cjs +1 -1
  338. package/dist/sonner.d.ts +1 -1
  339. package/dist/sonner.d.ts.map +1 -1
  340. package/dist/sonner.js +113 -137
  341. package/dist/spinner.cjs +1 -1
  342. package/dist/spinner.js +22 -31
  343. package/dist/split-layout.cjs +1 -1
  344. package/dist/split-layout.d.ts +1 -1
  345. package/dist/split-layout.js +53 -102
  346. package/dist/status.cjs +1 -0
  347. package/dist/status.d.ts +51 -0
  348. package/dist/status.d.ts.map +1 -0
  349. package/dist/status.js +60 -0
  350. package/dist/stepper.cjs +1 -1
  351. package/dist/stepper.js +184 -316
  352. package/dist/switch.cjs +1 -1
  353. package/dist/switch.js +17 -32
  354. package/dist/table.cjs +1 -1
  355. package/dist/table.d.ts +127 -13
  356. package/dist/table.d.ts.map +1 -1
  357. package/dist/table.js +170 -192
  358. package/dist/tabs.cjs +1 -1
  359. package/dist/tabs.d.ts +12 -1
  360. package/dist/tabs.d.ts.map +1 -1
  361. package/dist/tabs.js +123 -146
  362. package/dist/text-reveal-motion.cjs +1 -1
  363. package/dist/text-reveal-motion.js +307 -363
  364. package/dist/textarea.cjs +1 -1
  365. package/dist/textarea.d.ts.map +1 -1
  366. package/dist/textarea.js +23 -36
  367. package/dist/toggle-group.cjs +1 -1
  368. package/dist/toggle-group.js +43 -62
  369. package/dist/toggle.cjs +1 -1
  370. package/dist/toggle.js +34 -46
  371. package/dist/tooltip.cjs +1 -1
  372. package/dist/tooltip.d.ts +38 -36
  373. package/dist/tooltip.d.ts.map +1 -1
  374. package/dist/tooltip.js +175 -78
  375. package/dist/typography-heading.cjs +1 -1
  376. package/dist/typography-heading.js +25 -61
  377. package/dist/typography-text.cjs +1 -1
  378. package/dist/typography-text.d.ts +1 -2
  379. package/dist/typography-text.d.ts.map +1 -1
  380. package/dist/typography-text.js +27 -57
  381. package/dist/typography.cjs +1 -1
  382. package/dist/typography.d.ts +1 -1
  383. package/dist/typography.js +132 -340
  384. package/package.json +45 -46
  385. package/src/blocks/empty-state.tsx +42 -21
  386. package/src/blocks/progress-state.tsx +2 -2
  387. package/src/blocks/sidebar.tsx +111 -32
  388. package/src/components/accordion.tsx +1 -1
  389. package/src/components/alert-dialog.tsx +52 -5
  390. package/src/components/alert.tsx +16 -8
  391. package/src/components/badge.tsx +152 -3
  392. package/src/components/banner.tsx +288 -0
  393. package/src/components/brand-illustration-motif.tsx +1 -1
  394. package/src/components/breadcrumb.tsx +1 -1
  395. package/src/components/button.tsx +8 -6
  396. package/src/components/calendar.tsx +155 -9
  397. package/src/components/card.tsx +266 -26
  398. package/src/components/carousel.tsx +4 -1
  399. package/src/components/chart.tsx +664 -42
  400. package/src/components/checkbox.tsx +2 -2
  401. package/src/components/collapsible.tsx +4 -1
  402. package/src/components/combobox.tsx +42 -9
  403. package/src/components/command.tsx +10 -11
  404. package/src/components/context-menu.tsx +4 -4
  405. package/src/components/data-table.tsx +1363 -398
  406. package/src/components/date-picker.tsx +31 -4
  407. package/src/components/delta.tsx +217 -0
  408. package/src/components/drawer.tsx +5 -5
  409. package/src/components/dropdown-menu.tsx +4 -4
  410. package/src/components/field.tsx +36 -15
  411. package/src/components/global-layout.tsx +1 -1
  412. package/src/components/grid.tsx +32 -1
  413. package/src/components/info-tooltip.tsx +94 -0
  414. package/src/components/input-chip.tsx +52 -8
  415. package/src/components/input-group.tsx +247 -12
  416. package/src/components/input-otp.tsx +1 -1
  417. package/src/components/input-password.tsx +29 -11
  418. package/src/components/input.tsx +11 -2
  419. package/src/components/list.tsx +15 -3
  420. package/src/components/logo-mark.tsx +345 -0
  421. package/src/components/map.tsx +18 -20
  422. package/src/components/media-viewer.tsx +908 -0
  423. package/src/components/multi-select-filter.tsx +1046 -0
  424. package/src/components/navigation-menu.tsx +2 -2
  425. package/src/components/pagination.tsx +86 -26
  426. package/src/components/progress.tsx +281 -54
  427. package/src/components/rating.tsx +200 -74
  428. package/src/components/relative-date.tsx +238 -0
  429. package/src/components/resizable.tsx +86 -33
  430. package/src/components/result-count.tsx +253 -0
  431. package/src/components/scroll-area.tsx +31 -5
  432. package/src/components/select.tsx +37 -7
  433. package/src/components/sheet.tsx +252 -6
  434. package/src/components/single-select-filter.tsx +538 -0
  435. package/src/components/slider.tsx +2 -2
  436. package/src/components/sonner.tsx +16 -5
  437. package/src/components/split-layout.tsx +2 -2
  438. package/src/components/status.tsx +162 -0
  439. package/src/components/switch.tsx +1 -1
  440. package/src/components/table.tsx +305 -73
  441. package/src/components/tabs.tsx +94 -46
  442. package/src/components/textarea.tsx +21 -3
  443. package/src/components/toggle.tsx +2 -2
  444. package/src/components/tooltip.tsx +431 -68
  445. package/src/components/typography-text.tsx +1 -2
  446. package/src/components/typography.tsx +1 -1
  447. package/src/hooks/use-breakpoint.ts +2 -1
  448. package/src/hooks/use-filter-search-params.ts +302 -0
  449. package/src/index.ts +11 -0
  450. package/src/lib/block-illustration.tsx +5 -1
  451. package/src/lib/compose-event-handlers.ts +14 -0
  452. package/src/lib/download-file.ts +61 -0
  453. package/src/lib/empty-chip.tsx +52 -0
  454. package/src/lib/field-aria.tsx +97 -0
  455. package/src/lib/image-file-info.ts +102 -0
  456. package/src/lib/media-viewer-content.tsx +1587 -0
  457. package/src/lib/media-viewer-internal.tsx +191 -0
  458. package/src/lib/media-viewer-motion.ts +120 -0
  459. package/src/lib/motion.ts +9 -0
  460. package/src/lib/table-internal.ts +74 -0
  461. package/src/lib/use-controllable.ts +43 -0
  462. package/src/lib/utils.ts +1 -0
  463. 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
  },