@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
@@ -247,6 +247,16 @@ const DatePickerRoot = DatePicker;
247
247
  */
248
248
  export type DatePickerRootProps = DatePickerProps;
249
249
 
250
+ /**
251
+ * Appends the text rendered inside a control to its aria-label so the
252
+ * accessible name contains the visible text (WCAG 2.5.3 Label in Name).
253
+ */
254
+ function withVisibleText(label: string, visibleText?: React.ReactNode) {
255
+ return typeof visibleText === "string" && visibleText.length > 0
256
+ ? `${label}: ${visibleText}`
257
+ : label;
258
+ }
259
+
250
260
  // ============================================================================
251
261
  // DatePickerTrigger
252
262
  // ============================================================================
@@ -265,7 +275,18 @@ export interface DatePickerTriggerProps extends Omit<
265
275
  */
266
276
  error?: boolean;
267
277
  /**
268
- * Accessible label for the trigger button.
278
+ * Marks this field as the one a calendar shown outside its popover is
279
+ * editing (e.g. a "from" / "to" pair sharing one inline calendar). Shows
280
+ * the same border as the open state without opening a popover, and sets
281
+ * `aria-current="true"` so screen readers know which field the calendar
282
+ * edits.
283
+ * @default false
284
+ */
285
+ active?: boolean;
286
+ /**
287
+ * Accessible label for the trigger button. The text shown inside the button
288
+ * (selected value or placeholder) is appended as `"<label>: <text>"` so the
289
+ * accessible name contains the visible text (WCAG 2.5.3).
269
290
  * @default "Select date" (single) or "Select date range" (range)
270
291
  */
271
292
  triggerLabel?: string;
@@ -277,7 +298,7 @@ export interface DatePickerTriggerProps extends Omit<
277
298
  const DatePickerTrigger = React.forwardRef<
278
299
  HTMLButtonElement,
279
300
  DatePickerTriggerProps
280
- >(({ className, children, id, error, triggerLabel, ...props }, ref) => {
301
+ >(({ className, children, id, error, active, triggerLabel, ...props }, ref) => {
281
302
  const {
282
303
  mode,
283
304
  date,
@@ -328,19 +349,25 @@ const DatePickerTrigger = React.forwardRef<
328
349
  <PopoverTrigger asChild>
329
350
  <button
330
351
  ref={combinedRef}
352
+ aria-current={active ? "true" : undefined}
331
353
  aria-label={
332
354
  props["aria-label"] ??
333
- triggerLabel ??
334
- (mode === "single" ? "Select date" : "Select date range")
355
+ withVisibleText(
356
+ triggerLabel ??
357
+ (mode === "single" ? "Select date" : "Select date range"),
358
+ children === undefined ? (displayValue ?? placeholder) : undefined
359
+ )
335
360
  }
336
361
  className={cn(
337
362
  inputVariants({ hasIcon: true }),
338
363
  "group-hover/field:bg-accent dark:group-hover/field:bg-input/50 relative cursor-pointer justify-start pb-0 text-left",
339
364
  !hasValue && "text-muted-foreground",
365
+ active && "border-ring shadow-default",
340
366
  hasError &&
341
367
  "border-destructive-40 focus-visible:border-destructive-40 focus-visible:shadow-destructive",
342
368
  className
343
369
  )}
370
+ data-active={active || undefined}
344
371
  data-error={hasError || undefined}
345
372
  data-hook={`${dataHook}-trigger`}
346
373
  data-slot="date-picker-trigger"
@@ -0,0 +1,217 @@
1
+ import * as React from "react";
2
+ import { cva } from "class-variance-authority";
3
+
4
+ import { ArrowDown, ArrowUp, Minus } from "@brightlocal/icons";
5
+
6
+ import { cn } from "@brightlocal/ui-components/lib/utils";
7
+
8
+ /**
9
+ * Which direction of the change shows green (good news); the other shows red.
10
+ * `"up"` when more is better (views, reviews, a rank phrased as places
11
+ * gained); `"down"` when less is better (cost, response time).
12
+ */
13
+ type DeltaGreenWhen = "up" | "down";
14
+
15
+ /**
16
+ * How the delta sits on the page: bare text in a line or a cell (`inline`),
17
+ * or on a tinted pill next to a metric (`pill`).
18
+ */
19
+ type DeltaVariant = "inline" | "pill";
20
+
21
+ /** Direction of the change, from the sign of `value`. */
22
+ type DeltaDirection = "increase" | "decrease" | "none";
23
+
24
+ /** Whether the change is good news, from the direction and `greenWhen`. */
25
+ type DeltaTrend = "better" | "worse" | "none";
26
+
27
+ const deltaVariants = cva(
28
+ "relative inline-flex items-center gap-0.5 tabular-nums",
29
+ {
30
+ variants: {
31
+ variant: {
32
+ inline: "text-label [&>svg]:size-4",
33
+ pill: "text-label-sm rounded-full px-1.5 py-0.5 [&>svg]:size-3",
34
+ },
35
+ },
36
+ defaultVariants: {
37
+ variant: "inline",
38
+ },
39
+ }
40
+ );
41
+
42
+ /* Trend is derived from `value` + `greenWhen`, never passed in, so it stays
43
+ out of the CVA axes (which the registry reads as props). */
44
+ const TREND_INK: Record<DeltaTrend, string> = {
45
+ better: "text-score-strong-ink",
46
+ worse: "text-score-poor-ink",
47
+ none: "text-muted-foreground",
48
+ };
49
+
50
+ const PILL_TINT: Record<DeltaTrend, string> = {
51
+ better: "bg-score-strong/15",
52
+ worse: "bg-score-poor/15",
53
+ none: "bg-muted",
54
+ };
55
+
56
+ /**
57
+ * Props for the Delta component.
58
+ */
59
+ interface DeltaProps extends Omit<
60
+ React.ComponentPropsWithoutRef<"span">,
61
+ "children"
62
+ > {
63
+ /**
64
+ * Required test hook identifier.
65
+ * @example "visibility-delta"
66
+ */
67
+ dataHook: string;
68
+ /**
69
+ * The signed change, as the product phrases it. Rank up 8 places is
70
+ * `value={8}` — the arrow follows the phrasing, the colour follows
71
+ * `greenWhen`.
72
+ * @example 8
73
+ */
74
+ value: number;
75
+ /**
76
+ * Which direction shows green: `"up"` when more is better, `"down"` when
77
+ * less is better (cost, response time). The other direction shows red.
78
+ * @default "up"
79
+ */
80
+ greenWhen?: DeltaGreenWhen;
81
+ /**
82
+ * Inline text, or a tinted pill.
83
+ * @default "inline"
84
+ */
85
+ variant?: DeltaVariant;
86
+ /**
87
+ * Overrides the displayed amount (e.g. "12%"). Pass the magnitude only —
88
+ * the arrow carries the sign.
89
+ * @default the magnitude in en-US format, up to 2 decimals ("<0.01" for a tiny non-zero change)
90
+ */
91
+ children?: React.ReactNode;
92
+ /**
93
+ * Screen-reader phrase before the amount when `value` is positive.
94
+ * @default "Increased by"
95
+ */
96
+ increasedLabel?: string;
97
+ /**
98
+ * Screen-reader phrase before the amount when `value` is negative.
99
+ * @default "Decreased by"
100
+ */
101
+ decreasedLabel?: string;
102
+ /**
103
+ * Screen-reader phrase when `value` is zero (read on its own).
104
+ * @default "Unchanged"
105
+ */
106
+ unchangedLabel?: string;
107
+ /** Analytics element identifier */
108
+ trackingEl?: string;
109
+ /** Analytics label */
110
+ trackingLabel?: string;
111
+ }
112
+
113
+ /**
114
+ * The default amount: the magnitude in a fixed en-US format (up to two
115
+ * decimals), so server and browser render the same string whatever the
116
+ * runtime locale. A non-zero change that would round to 0 shows "<0.01",
117
+ * so the arrow never sits next to a 0. Consumers pass a localized amount
118
+ * through `children`.
119
+ */
120
+ const AMOUNT_FORMAT = new Intl.NumberFormat("en-US", {
121
+ maximumFractionDigits: 2,
122
+ });
123
+
124
+ function formatAmount(value: number): string {
125
+ const magnitude = Math.abs(value);
126
+ if (magnitude > 0 && magnitude < 0.005) return "<0.01";
127
+ return AMOUNT_FORMAT.format(magnitude);
128
+ }
129
+
130
+ const DIRECTION_ICONS = {
131
+ increase: ArrowUp,
132
+ decrease: ArrowDown,
133
+ none: Minus,
134
+ } as const;
135
+
136
+ /**
137
+ * Delta — how much a value moved between two points.
138
+ * The arrow follows the sign of the change; the colour comes from whether
139
+ * that direction is good (`greenWhen`). Screen readers hear a phrase
140
+ * ("Increased by 8") instead of the arrow and number.
141
+ */
142
+ const Delta = React.forwardRef<HTMLSpanElement, DeltaProps>(
143
+ (
144
+ {
145
+ className,
146
+ value,
147
+ greenWhen = "up",
148
+ variant = "inline",
149
+ increasedLabel,
150
+ decreasedLabel,
151
+ unchangedLabel,
152
+ dataHook,
153
+ trackingEl,
154
+ trackingLabel,
155
+ children,
156
+ ...props
157
+ },
158
+ ref
159
+ ) => {
160
+ const direction: DeltaDirection =
161
+ value > 0 ? "increase" : value < 0 ? "decrease" : "none";
162
+ const trend: DeltaTrend =
163
+ direction === "none"
164
+ ? "none"
165
+ : (direction === "increase") === (greenWhen === "up")
166
+ ? "better"
167
+ : "worse";
168
+ const amount = children ?? formatAmount(value);
169
+ const Icon = DIRECTION_ICONS[direction];
170
+
171
+ return (
172
+ <span
173
+ ref={ref}
174
+ className={cn(
175
+ deltaVariants({ variant }),
176
+ TREND_INK[trend],
177
+ variant === "pill" && PILL_TINT[trend],
178
+ className
179
+ )}
180
+ data-direction={direction}
181
+ data-hook={dataHook}
182
+ data-slot="delta"
183
+ data-tracking-el={trackingEl}
184
+ data-tracking-label={trackingLabel}
185
+ data-trend={trend}
186
+ data-variant={variant}
187
+ {...props}
188
+ >
189
+ <Icon aria-hidden />
190
+ <span aria-hidden>{amount}</span>
191
+ <span className="sr-only">
192
+ {direction === "none" ? (
193
+ (unchangedLabel ?? "Unchanged")
194
+ ) : (
195
+ <>
196
+ {direction === "increase"
197
+ ? (increasedLabel ?? "Increased by")
198
+ : (decreasedLabel ?? "Decreased by")}{" "}
199
+ {amount}
200
+ </>
201
+ )}
202
+ </span>
203
+ </span>
204
+ );
205
+ }
206
+ );
207
+
208
+ Delta.displayName = "Delta";
209
+
210
+ export { Delta };
211
+ export type {
212
+ DeltaProps,
213
+ DeltaGreenWhen,
214
+ DeltaVariant,
215
+ DeltaDirection,
216
+ DeltaTrend,
217
+ };