@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
@@ -1,5 +1,5 @@
1
1
  import * as React from "react";
2
- import { StarRating } from "@brightlocal/icons";
2
+ import { StarRating, ThumbsDown, ThumbsUp } from "@brightlocal/icons";
3
3
 
4
4
  import { cn } from "@brightlocal/ui-components/lib/utils";
5
5
 
@@ -8,123 +8,249 @@ import { cn } from "@brightlocal/ui-components/lib/utils";
8
8
  */
9
9
  type RatingSize = "sm" | "md";
10
10
 
11
- const starSizeMap: Record<RatingSize, number> = {
11
+ /**
12
+ * Shape of the review score the Rating renders.
13
+ * - `stars` — a 0–5 star value (Google, Yelp, Tripadvisor, …)
14
+ * - `recommendation` — Facebook's binary Recommended / Not recommended verdict
15
+ */
16
+ type RatingVariant = "stars" | "recommendation";
17
+
18
+ const iconSizeMap: Record<RatingSize, number> = {
12
19
  sm: 16,
13
20
  md: 24,
14
21
  };
15
22
 
23
+ const recommendationStyles: Record<RatingSize, string> = {
24
+ sm: "gap-1.5 text-body-sm",
25
+ md: "gap-2 text-body",
26
+ };
27
+
16
28
  /**
17
- * Rating component displays a star-based rating indicator.
18
- * Supports full and half-star values for precise rating display.
29
+ * Props shared by every Rating variant.
19
30
  */
20
- export interface RatingProps extends React.HTMLAttributes<HTMLDivElement> {
21
- /**
22
- * The rating value (0-5, supports 0.5 increments)
23
- */
24
- value: number;
31
+ interface RatingBaseProps extends React.HTMLAttributes<HTMLDivElement> {
25
32
  /**
26
33
  * Data hook for testing
27
34
  */
28
35
  dataHook: string;
29
36
  /**
30
- * Size of the star icons.
37
+ * Size of the glyphs (stars or thumbs).
31
38
  * @default "sm"
32
39
  */
33
40
  size?: RatingSize;
41
+ /**
42
+ * Optional tracking element identifier
43
+ */
44
+ trackingEl?: string;
45
+ /**
46
+ * Optional tracking label
47
+ */
48
+ trackingLabel?: string;
49
+ }
50
+
51
+ /**
52
+ * Star-based score (the default variant).
53
+ */
54
+ export interface RatingStarsProps extends RatingBaseProps {
55
+ /**
56
+ * Shape of the score.
57
+ * @default "stars"
58
+ */
59
+ variant?: Extract<RatingVariant, "stars">;
60
+ /**
61
+ * The rating value (0-5, supports 0.5 increments)
62
+ */
63
+ value: number;
34
64
  /**
35
65
  * Accessible label for the rating.
36
66
  * Supports `{value}` placeholder for interpolation.
37
67
  * @default "Rating: {value} out of 5 stars"
38
68
  */
39
69
  ariaLabel?: string;
70
+ /** Recommendation-only — never combined with a star `value`. */
71
+ recommended?: never;
72
+ /** Recommendation-only. */
73
+ showLabel?: never;
74
+ /** Recommendation-only. */
75
+ recommendedLabel?: never;
76
+ /** Recommendation-only. */
77
+ notRecommendedLabel?: never;
78
+ }
79
+
80
+ /**
81
+ * Facebook-style binary verdict: thumbs-up "Recommended" or thumbs-down
82
+ * "Not recommended".
83
+ */
84
+ export interface RatingRecommendationProps extends RatingBaseProps {
40
85
  /**
41
- * Optional tracking element identifier
86
+ * Shape of the score.
42
87
  */
43
- trackingEl?: string;
88
+ variant: Extract<RatingVariant, "recommendation">;
44
89
  /**
45
- * Optional tracking label
90
+ * Whether the reviewer recommended the business.
46
91
  */
47
- trackingLabel?: string;
92
+ recommended: boolean;
93
+ /**
94
+ * Render the verdict text beside the thumb. When `false` the thumb stands
95
+ * alone and the text becomes the accessible name instead.
96
+ * @default true
97
+ */
98
+ showLabel?: boolean;
99
+ /**
100
+ * Label for the positive verdict (visible text, or accessible name when
101
+ * `showLabel` is `false`).
102
+ * @default "Recommended"
103
+ */
104
+ recommendedLabel?: string;
105
+ /**
106
+ * Label for the negative verdict (visible text, or accessible name when
107
+ * `showLabel` is `false`).
108
+ * @default "Not recommended"
109
+ */
110
+ notRecommendedLabel?: string;
111
+ /** Stars-only — never combined with a `recommended` verdict. */
112
+ value?: never;
113
+ /** Stars-only. */
114
+ ariaLabel?: never;
48
115
  }
49
116
 
50
- const Rating = React.forwardRef<HTMLDivElement, RatingProps>(
51
- (
52
- {
53
- value,
117
+ /**
118
+ * Rating displays a review score: a star-based value (full and half stars) or
119
+ * Facebook's binary Recommended / Not recommended verdict. The two shapes are a
120
+ * discriminated union on `variant`; each arm types the other arm's props as
121
+ * `never`, so a star `value` can never be combined with a `recommended`
122
+ * flag — not even through a spread of a non-literal object.
123
+ */
124
+ export type RatingProps = RatingStarsProps | RatingRecommendationProps;
125
+
126
+ const Rating = React.forwardRef<HTMLDivElement, RatingProps>((props, ref) => {
127
+ if (props.variant === "recommendation") {
128
+ const {
129
+ variant,
130
+ recommended,
131
+ showLabel = true,
132
+ recommendedLabel,
133
+ notRecommendedLabel,
54
134
  dataHook,
55
135
  size = "sm",
56
- ariaLabel,
57
136
  trackingEl,
58
137
  trackingLabel,
59
138
  className,
60
- ...props
61
- },
62
- ref
63
- ) => {
64
- // Clamp value between 0 and 5
65
- const clampedValue = Math.max(0, Math.min(5, value));
66
- const starSize = starSizeMap[size];
139
+ ...rest
140
+ } = props;
141
+ const label = recommended
142
+ ? (recommendedLabel ?? "Recommended")
143
+ : (notRecommendedLabel ?? "Not recommended");
144
+ const Icon = recommended ? ThumbsUp : ThumbsDown;
67
145
 
68
146
  return (
69
147
  <div
70
148
  ref={ref}
71
- aria-label={
72
- ariaLabel
73
- ? ariaLabel.replace("{value}", String(clampedValue))
74
- : `Rating: ${clampedValue} out of 5 stars`
75
- }
76
- className={cn("flex items-center gap-0.5", className)}
149
+ aria-label={showLabel ? undefined : label}
150
+ className={cn(
151
+ "flex items-center",
152
+ recommendationStyles[size],
153
+ className
154
+ )}
77
155
  data-hook={dataHook}
156
+ data-recommended={recommended}
78
157
  data-slot="rating"
79
158
  data-tracking-el={trackingEl}
80
159
  data-tracking-label={trackingLabel}
81
- role="img"
82
- {...props}
160
+ data-variant={variant}
161
+ role={showLabel ? undefined : "img"}
162
+ {...rest}
83
163
  >
84
- {[...Array(5)].map((_, index) => {
85
- const starValue = index + 1;
86
- const isFilled = clampedValue >= starValue;
87
- const isPartiallyFilled = !isFilled && clampedValue > index;
88
- const fillPercentage = isPartiallyFilled
89
- ? ((clampedValue - index) * 100).toFixed(0)
90
- : isFilled
91
- ? "100"
92
- : "0";
93
-
94
- return (
95
- <div key={index} className="relative" data-slot="rating-star">
96
- {/* Base star (empty/outline) */}
97
- <StarRating
98
- className="fill-muted stroke-muted"
99
- data-slot="rating-star-base"
100
- size={starSize}
101
- />
102
-
103
- {/* Filled overlay */}
104
- {(isFilled || isPartiallyFilled) && (
105
- <div
106
- aria-hidden="true"
107
- className="absolute inset-0 overflow-hidden"
108
- data-slot="rating-star-fill"
109
- style={{
110
- width: `${fillPercentage}%`,
111
- }}
112
- >
113
- <StarRating
114
- className="fill-yellow-400 stroke-yellow-400"
115
- size={starSize}
116
- />
117
- </div>
118
- )}
119
- </div>
120
- );
121
- })}
164
+ <Icon
165
+ aria-hidden="true"
166
+ // Outline lucide glyph in muted-foreground, like decorative icons
167
+ // elsewhere in the DS; the thumb direction carries the meaning.
168
+ className="text-muted-foreground shrink-0"
169
+ data-slot="rating-recommendation-icon"
170
+ size={iconSizeMap[size]}
171
+ />
172
+ {showLabel && (
173
+ <span data-slot="rating-recommendation-label">{label}</span>
174
+ )}
122
175
  </div>
123
176
  );
124
177
  }
125
- );
178
+
179
+ const {
180
+ variant,
181
+ value,
182
+ dataHook,
183
+ size = "sm",
184
+ ariaLabel,
185
+ trackingEl,
186
+ trackingLabel,
187
+ className,
188
+ ...rest
189
+ } = props;
190
+ // Clamp value between 0 and 5
191
+ const clampedValue = Math.max(0, Math.min(5, value));
192
+ const starSize = iconSizeMap[size];
193
+
194
+ return (
195
+ <div
196
+ ref={ref}
197
+ aria-label={
198
+ ariaLabel
199
+ ? ariaLabel.replace(/\{value\}/g, String(clampedValue))
200
+ : `Rating: ${clampedValue} out of 5 stars`
201
+ }
202
+ className={cn("flex items-center gap-0.5", className)}
203
+ data-hook={dataHook}
204
+ data-slot="rating"
205
+ data-tracking-el={trackingEl}
206
+ data-tracking-label={trackingLabel}
207
+ data-variant={variant ?? "stars"}
208
+ role="img"
209
+ {...rest}
210
+ >
211
+ {[...Array(5)].map((_, index) => {
212
+ const starValue = index + 1;
213
+ const isFilled = clampedValue >= starValue;
214
+ const isPartiallyFilled = !isFilled && clampedValue > index;
215
+ const fillPercentage = isPartiallyFilled
216
+ ? ((clampedValue - index) * 100).toFixed(0)
217
+ : isFilled
218
+ ? "100"
219
+ : "0";
220
+
221
+ return (
222
+ <div key={index} className="relative" data-slot="rating-star">
223
+ {/* Base star (empty/outline) */}
224
+ <StarRating
225
+ className="fill-muted stroke-muted"
226
+ data-slot="rating-star-base"
227
+ size={starSize}
228
+ />
229
+
230
+ {/* Filled overlay */}
231
+ {(isFilled || isPartiallyFilled) && (
232
+ <div
233
+ aria-hidden="true"
234
+ className="absolute inset-0 overflow-hidden"
235
+ data-slot="rating-star-fill"
236
+ style={{
237
+ width: `${fillPercentage}%`,
238
+ }}
239
+ >
240
+ <StarRating
241
+ className="fill-rating stroke-rating"
242
+ size={starSize}
243
+ />
244
+ </div>
245
+ )}
246
+ </div>
247
+ );
248
+ })}
249
+ </div>
250
+ );
251
+ });
126
252
 
127
253
  Rating.displayName = "Rating";
128
254
 
129
255
  export { Rating };
130
- export type { RatingSize };
256
+ export type { RatingSize, RatingVariant };
@@ -0,0 +1,238 @@
1
+ "use client";
2
+
3
+ import { forwardRef, useEffect, useState } from "react";
4
+ import { cn } from "@brightlocal/ui-components/lib/utils";
5
+ import {
6
+ Tooltip,
7
+ TooltipContent,
8
+ TooltipTrigger,
9
+ } from "@brightlocal/ui-components/tooltip";
10
+
11
+ export interface RelativeDateLabels {
12
+ /** @default "just now" */
13
+ justNow: string;
14
+ /** @default "1 minute ago" */
15
+ minuteAgo: string;
16
+ /**
17
+ * `{n}` is replaced with the count.
18
+ * @default "{n} minutes ago"
19
+ */
20
+ minutesAgo: string;
21
+ /** @default "1 hour ago" */
22
+ hourAgo: string;
23
+ /**
24
+ * `{n}` is replaced with the count.
25
+ * @default "{n} hours ago"
26
+ */
27
+ hoursAgo: string;
28
+ /** @default "today" */
29
+ today: string;
30
+ /** @default "yesterday" */
31
+ yesterday: string;
32
+ /**
33
+ * `{n}` is replaced with the count.
34
+ * @default "{n} days ago"
35
+ */
36
+ daysAgo: string;
37
+ /** @default "unknown" */
38
+ unknown: string;
39
+ }
40
+
41
+ export const DEFAULT_RELATIVE_DATE_LABELS: RelativeDateLabels = {
42
+ justNow: "just now",
43
+ minuteAgo: "1 minute ago",
44
+ minutesAgo: "{n} minutes ago",
45
+ hourAgo: "1 hour ago",
46
+ hoursAgo: "{n} hours ago",
47
+ today: "today",
48
+ yesterday: "yesterday",
49
+ daysAgo: "{n} days ago",
50
+ unknown: "unknown",
51
+ };
52
+
53
+ export interface RelativeDateProps {
54
+ /**
55
+ * When it happened. An ISO 8601 timestamp (UTC from the API) or a Date for
56
+ * a value with a time of day; a plain `YYYY-MM-DD` string for a calendar
57
+ * date with no time of day. `null` or `undefined` renders the `unknown`
58
+ * label, plain.
59
+ */
60
+ value: string | Date | null | undefined;
61
+ /**
62
+ * Contextual label rendered before the value (e.g. "Last updated").
63
+ * The component owns its styling — consumers never need to style it.
64
+ */
65
+ label?: string;
66
+ /**
67
+ * Translatable words. Each key defaults to its English value.
68
+ * @default DEFAULT_RELATIVE_DATE_LABELS
69
+ */
70
+ labels?: Partial<RelativeDateLabels>;
71
+ /** Outer layout only (margin, placement). The look is the component's. */
72
+ className?: string;
73
+ /** Required test hook identifier */
74
+ dataHook: string;
75
+ /** Analytics element identifier */
76
+ trackingEl?: string;
77
+ /** Analytics label */
78
+ trackingLabel?: string;
79
+ }
80
+
81
+ const SECOND = 1000;
82
+ const MINUTE = 60 * SECOND;
83
+ const HOUR = 60 * MINUTE;
84
+ const DAY = 24 * HOUR;
85
+ const DATE_ONLY = /^\d{4}-\d{2}-\d{2}$/;
86
+
87
+ export function isDateOnly(value: string | Date): boolean {
88
+ return typeof value === "string" && DATE_ONLY.test(value);
89
+ }
90
+
91
+ export function toDate(value: string | Date): Date {
92
+ if (value instanceof Date) return value;
93
+ return new Date(isDateOnly(value) ? `${value}T00:00:00` : value);
94
+ }
95
+
96
+ const startOfDay = (d: Date) =>
97
+ new Date(d.getFullYear(), d.getMonth(), d.getDate()).getTime();
98
+
99
+ const fill = (label: string, n: number) => label.replace("{n}", String(n));
100
+
101
+ export function dateLabel(date: Date, now = new Date()): string {
102
+ return date.toLocaleDateString("en-US", {
103
+ month: "long",
104
+ day: "numeric",
105
+ ...(date.getFullYear() === now.getFullYear() ? {} : { year: "numeric" }),
106
+ });
107
+ }
108
+
109
+ export function exactText(date: Date, dateOnly: boolean): string {
110
+ const day = date.toLocaleDateString("en-US", {
111
+ month: "long",
112
+ day: "numeric",
113
+ year: "numeric",
114
+ });
115
+ if (dateOnly) return day;
116
+ const time = date.toLocaleTimeString("en-US", {
117
+ hour: "numeric",
118
+ minute: "2-digit",
119
+ });
120
+ const offsetMinutes = -date.getTimezoneOffset();
121
+ const sign = offsetMinutes >= 0 ? "+" : "-";
122
+ const hours = Math.floor(Math.abs(offsetMinutes) / 60);
123
+ const minutes = Math.abs(offsetMinutes) % 60;
124
+ const offset = `${sign}${hours}${minutes ? `:${String(minutes).padStart(2, "0")}` : ""}`;
125
+ return `${day} at ${time} UTC${offset}`;
126
+ }
127
+
128
+ export function relativeWords(
129
+ value: string | Date,
130
+ now: Date,
131
+ labels: RelativeDateLabels = DEFAULT_RELATIVE_DATE_LABELS
132
+ ): string {
133
+ const date = toDate(value);
134
+ if (isDateOnly(value)) {
135
+ const days = Math.max(
136
+ 0,
137
+ Math.round((startOfDay(now) - startOfDay(date)) / DAY)
138
+ );
139
+ if (days === 0) return labels.today;
140
+ if (days === 1) return labels.yesterday;
141
+ if (days < 7) return fill(labels.daysAgo, days);
142
+ return dateLabel(date, now);
143
+ }
144
+ const distance = Math.max(0, now.getTime() - date.getTime());
145
+ const s = distance / SECOND;
146
+ const min = distance / MINUTE;
147
+ const h = distance / HOUR;
148
+ const d = distance / DAY;
149
+ if (s < 45) return labels.justNow;
150
+ if (s < 90) return labels.minuteAgo;
151
+ if (min < 45) return fill(labels.minutesAgo, Math.round(min));
152
+ if (min < 90) return labels.hourAgo;
153
+ if (h < 22) return fill(labels.hoursAgo, Math.round(h));
154
+ if (h < 36) return labels.yesterday;
155
+ if (d < 7) return fill(labels.daysAgo, Math.round(d));
156
+ return dateLabel(date, now);
157
+ }
158
+
159
+ export function useNow(every = 30 * SECOND): Date {
160
+ const [now, setNow] = useState(() => new Date());
161
+ useEffect(() => {
162
+ const tick = () => setNow(new Date());
163
+ const id = window.setInterval(tick, every);
164
+ const onVisible = () => {
165
+ if (document.visibilityState === "visible") tick();
166
+ };
167
+ document.addEventListener("visibilitychange", onVisible);
168
+ return () => {
169
+ window.clearInterval(id);
170
+ document.removeEventListener("visibilitychange", onVisible);
171
+ };
172
+ }, [every]);
173
+ return now;
174
+ }
175
+
176
+ export const RelativeDate = forwardRef<HTMLElement, RelativeDateProps>(
177
+ function RelativeDate(
178
+ { value, label, labels, className, dataHook, trackingEl, trackingLabel },
179
+ ref
180
+ ) {
181
+ const now = useNow();
182
+ const words = { ...DEFAULT_RELATIVE_DATE_LABELS, ...labels };
183
+
184
+ if (value === null || value === undefined) {
185
+ return (
186
+ <span
187
+ ref={ref as React.Ref<HTMLSpanElement>}
188
+ className={cn("text-body-xs text-muted-foreground", className)}
189
+ data-hook={dataHook}
190
+ data-slot="relative-date"
191
+ data-tracking-el={trackingEl}
192
+ data-tracking-label={trackingLabel}
193
+ >
194
+ {label && <>{label} </>}
195
+ {words.unknown}
196
+ </span>
197
+ );
198
+ }
199
+
200
+ const dateOnly = isDateOnly(value);
201
+ const date = toDate(value);
202
+ const iso = dateOnly
203
+ ? `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}`
204
+ : date.toISOString();
205
+ const shown = relativeWords(value, now, words);
206
+ const exact = exactText(date, dateOnly);
207
+
208
+ return (
209
+ <span
210
+ ref={ref as React.Ref<HTMLSpanElement>}
211
+ className={cn("text-body-xs text-muted-foreground", className)}
212
+ data-hook={dataHook}
213
+ data-slot="relative-date"
214
+ data-tracking-el={trackingEl}
215
+ data-tracking-label={trackingLabel}
216
+ >
217
+ {label && <>{label} </>}
218
+ {/* When the words already are the exact date (an older calendar
219
+ date), a tooltip would only repeat them: plain text then. */}
220
+ {shown === exact ? (
221
+ <time dateTime={iso}>{shown}</time>
222
+ ) : (
223
+ <Tooltip>
224
+ <TooltipTrigger
225
+ className="focus-visible:shadow-default cursor-help rounded-xs underline decoration-dotted decoration-1 underline-offset-4 focus-visible:outline-none"
226
+ dataHook={`${dataHook}-trigger`}
227
+ >
228
+ <time dateTime={iso}>{shown}</time>
229
+ </TooltipTrigger>
230
+ <TooltipContent dataHook={`${dataHook}-tooltip`} side="bottom">
231
+ {exact}
232
+ </TooltipContent>
233
+ </Tooltip>
234
+ )}
235
+ </span>
236
+ );
237
+ }
238
+ );