@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
@@ -4,19 +4,28 @@ import * as React from "react";
4
4
  import { cva, type VariantProps } from "class-variance-authority";
5
5
 
6
6
  import { cn } from "@brightlocal/ui-components/lib/utils";
7
+ import { useDevWarning } from "@brightlocal/ui-components/lib/use-dev-warning";
8
+ import {
9
+ TABLE_CONTAINER_INSET,
10
+ TableSizeContext,
11
+ scrollRegionProps,
12
+ type TableFrame,
13
+ type TableSize,
14
+ } from "../lib/table-internal";
7
15
 
8
16
  /* -------------------------------------------------------------------------------------------------
9
17
  * CVA Variants
10
18
  * -----------------------------------------------------------------------------------------------*/
11
19
 
12
20
  const tableCellVariants = cva(
13
- "align-middle bg-transparent text-body-sm text-foreground break-words",
21
+ // `h-*` on a table cell is a min-height: the row still grows with
22
+ // multi-line content, so the size axis is the floor, never a clamp.
23
+ "align-middle bg-transparent p-2 text-body-sm text-foreground break-words",
14
24
  {
15
25
  variants: {
16
26
  size: {
17
- default: "h-12 p-2",
18
- md: "h-16 p-2",
19
- lg: "h-24 p-2",
27
+ default: "h-12",
28
+ sm: "h-10",
20
29
  },
21
30
  align: {
22
31
  left: "text-left",
@@ -34,9 +43,15 @@ const tableCellVariants = cva(
34
43
  const tableHeadVariants = cva(
35
44
  // bg-muted only for column headers inside <thead> — a <TableHead
36
45
  // scope="row"> in the body must not paint over its row's state tint.
37
- "[thead_&]:bg-muted h-12 p-2 align-middle text-muted-foreground text-label font-semibold break-words outline-none focus-visible:shadow-default transition-[background-color,box-shadow] duration-fast ease-out",
46
+ // No focus ring here: a <th> is never focusable — the sort control inside
47
+ // it (DataTableColumnHeader's Button) carries its own.
48
+ "[thead_&]:bg-muted p-2 align-middle text-muted-foreground text-label font-semibold break-words transition-colors duration-fast ease-out",
38
49
  {
39
50
  variants: {
51
+ size: {
52
+ default: "h-12",
53
+ sm: "h-9",
54
+ },
40
55
  align: {
41
56
  left: "text-left",
42
57
  right: "text-right",
@@ -44,6 +59,7 @@ const tableHeadVariants = cva(
44
59
  },
45
60
  },
46
61
  defaultVariants: {
62
+ size: "default",
47
63
  align: "left",
48
64
  },
49
65
  }
@@ -53,7 +69,9 @@ const tableHeadVariants = cva(
53
69
  * Table
54
70
  * -----------------------------------------------------------------------------------------------*/
55
71
 
56
- interface TableProps extends React.ComponentProps<"table"> {
72
+ // `frame` shadows the legacy HTML `<table frame>` attribute (typed boolean in
73
+ // React); the DS prop replaces it and never reaches the DOM.
74
+ interface TableProps extends Omit<React.ComponentProps<"table">, "frame"> {
57
75
  /**
58
76
  * Data hook for automated testing (REQUIRED)
59
77
  */
@@ -66,6 +84,15 @@ interface TableProps extends React.ComponentProps<"table"> {
66
84
  * Tracking label for analytics context
67
85
  */
68
86
  trackingLabel?: string;
87
+ /**
88
+ * Row density for the whole table. Sets the min-height of every `TableCell`
89
+ * (`default` = `h-12` 48px, `sm` = `h-10` 40px) and `TableHead`
90
+ * (`default` = `h-12` 48px, `sm` = `h-9` 36px) beneath it. Rows still grow
91
+ * with multi-line content. Use `sm` for dense, scan-heavy tables inside
92
+ * cards, dialogs and side panels; keep `default` for page-level lists.
93
+ * @default "default"
94
+ */
95
+ size?: TableSize;
69
96
  /**
70
97
  * Table layout algorithm.
71
98
  * - `"auto"` (default) — browser sizes columns based on content.
@@ -81,16 +108,62 @@ interface TableProps extends React.ComponentProps<"table"> {
81
108
  * Minimum width for the table (e.g., "600px", "40rem").
82
109
  * Prevents columns from compressing on narrow viewports and enables
83
110
  * horizontal scroll via the built-in overflow container.
84
- * When set, the scroll container becomes a focusable region for
85
- * keyboard accessibility.
111
+ * With `scrollOwner="self"` (the default) the wrapper then becomes a
112
+ * focusable scroll region for keyboard accessibility; with
113
+ * `scrollOwner="parent"` the scrolling ancestor must carry those
114
+ * semantics itself (`DataTable` does).
86
115
  */
87
116
  minWidth?: string;
88
117
  /**
89
118
  * Accessible label for the scroll container region.
90
- * Used when `minWidth` is set to provide context for keyboard users.
119
+ * Used when `minWidth` is set with `scrollOwner="self"` (the default).
120
+ * Ignored with `scrollOwner="parent"` — the scrolling ancestor owns the
121
+ * region and its label there.
122
+ *
123
+ * Give each table on a page a distinct label — several region landmarks
124
+ * sharing the default name violate axe's landmark-unique rule.
91
125
  * @default "Scrollable table"
92
126
  */
93
127
  scrollRegionLabel?: string;
128
+ /**
129
+ * Which element owns the table's scrolling.
130
+ * - `"self"` (default) — the built-in `table-container` wrapper scrolls
131
+ * horizontally and (with `minWidth`) carries the focusable
132
+ * scroll-region semantics. Standalone Table behavior.
133
+ * - `"parent"` — no internal scroll container is created: the wrapper
134
+ * stays a plain positioned block, so the nearest scrolling ancestor
135
+ * owns both axes. A `sticky` header then sticks to that ancestor, and
136
+ * the ancestor must carry the scroll-region semantics itself when
137
+ * `minWidth` is set. `DataTable` / `VirtualizedDataTable` render Table
138
+ * this way — their outer wrapper is the single scroll container.
139
+ * @default "self"
140
+ */
141
+ scrollOwner?: "self" | "parent";
142
+ /**
143
+ * Where the frame comes from (DS-1103).
144
+ * - `"own"` — the table draws its own 1px `border-border`, `rounded-md`
145
+ * frame; cells keep `p-2`. The standalone table.
146
+ * - `"container"` — no border, square corners, and the first/last cell of
147
+ * every row (head, body, footer, empty, skeleton) pads to the container's
148
+ * gutter, `var(--content-inset)` — `Card` publishes it per density (24px
149
+ * for `data`); 24px outside any container. Use inside `CardContent flush`,
150
+ * a Sheet or a dialog body so the page shows one box and the columns line
151
+ * up with the title.
152
+ * With `scrollOwner="parent"` the scrolling ancestor draws the frame
153
+ * (`DataTable` has the same prop); the cell rule still applies.
154
+ * @default "own"
155
+ */
156
+ frame?: TableFrame;
157
+ /**
158
+ * Draw a faint `border-border` rule under every body row except the last
159
+ * (DS-1195), so a reader can follow one row across many columns. No zebra
160
+ * striping. Use it on long, dense tables with many numeric or grouped
161
+ * columns and on wide, horizontally scrolling tables; leave it off for
162
+ * short or simple tables, where the row height already separates rows.
163
+ * The header band and footer keep their own surfaces.
164
+ * @default false
165
+ */
166
+ rowDividers?: boolean;
94
167
  }
95
168
 
96
169
  const Table = React.forwardRef<HTMLTableElement, TableProps>(
@@ -100,47 +173,75 @@ const Table = React.forwardRef<HTMLTableElement, TableProps>(
100
173
  dataHook,
101
174
  trackingEl,
102
175
  trackingLabel,
176
+ size = "default",
103
177
  layout = "auto",
104
178
  minWidth,
105
179
  scrollRegionLabel,
180
+ scrollOwner = "self",
181
+ frame = "own",
182
+ rowDividers = false,
106
183
  style,
107
184
  ...props
108
185
  },
109
186
  ref
110
187
  ) => {
188
+ const ownsScroll = scrollOwner === "self";
189
+ const ownFrame = frame === "own";
111
190
  return (
112
- <div
113
- className={cn(
114
- "relative w-full overflow-x-auto",
115
- minWidth && "focus-visible:shadow-default rounded-md outline-none"
116
- )}
117
- data-slot="table-container"
118
- {...(minWidth
119
- ? {
120
- role: "region",
121
- "aria-label": scrollRegionLabel ?? "Scrollable table",
122
- tabIndex: 0,
123
- }
124
- : undefined)}
125
- >
126
- <table
127
- ref={ref}
191
+ <TableSizeContext.Provider value={size}>
192
+ <div
128
193
  className={cn(
129
- // tabular-nums inherits into every cell (and into DataTable, which
130
- // renders this root), so numeric columns align by default; a
131
- // prose-heavy column can opt out with proportional-nums.
132
- "text-body-sm w-full caption-bottom tabular-nums",
133
- layout === "fixed" && "table-fixed",
134
- className
194
+ "relative w-full",
195
+ // `overflow-x-auto` makes the wrapper a scroll container in BOTH
196
+ // axes (an `auto` axis forces the other out of `visible`), which
197
+ // would confine a sticky <thead> here. With a parent scroll owner
198
+ // the wrapper must stay overflow-visible so sticky positioning
199
+ // and height bounds resolve against that ancestor (DS-912).
200
+ // `scrollbar` themes the native scrollbar with DS colors — the
201
+ // Command/Combobox treatment for bounded scroll containers.
202
+ ownsScroll && "scrollbar overflow-x-auto",
203
+ // `own`: the 1px frame and the rounded clip (header corners, focus
204
+ // ring). `container`: square and frameless — the container is the
205
+ // frame (DS-1103).
206
+ ownsScroll && ownFrame && "border-border rounded-md border",
207
+ ownsScroll &&
208
+ minWidth &&
209
+ "focus-visible:shadow-default outline-none"
135
210
  )}
136
- data-hook={dataHook}
137
- data-slot="table"
138
- data-tracking-el={trackingEl}
139
- data-tracking-label={trackingLabel}
140
- style={{ minWidth, ...style }}
141
- {...props}
142
- />
143
- </div>
211
+ data-frame={ownsScroll ? frame : undefined}
212
+ data-slot="table-container"
213
+ {...(ownsScroll && minWidth
214
+ ? scrollRegionProps(scrollRegionLabel)
215
+ : undefined)}
216
+ >
217
+ <table
218
+ ref={ref}
219
+ className={cn(
220
+ // tabular-nums inherits into every cell (and into DataTable, which
221
+ // renders this root), so numeric columns align by default; a
222
+ // prose-heavy column can opt out with proportional-nums.
223
+ "text-body-sm w-full caption-bottom tabular-nums",
224
+ layout === "fixed" && "table-fixed",
225
+ // Edge cells pad to the container's gutter in both scroll modes.
226
+ !ownFrame && TABLE_CONTAINER_INSET,
227
+ // Rule under each body row but the last — the frame (or the
228
+ // container) closes the table, so the last row needs none.
229
+ rowDividers &&
230
+ "[&_[data-slot=table-body]>tr:not(:last-child)]:border-border [&_[data-slot=table-body]>tr:not(:last-child)]:border-b",
231
+ className
232
+ )}
233
+ data-frame={frame}
234
+ data-hook={dataHook}
235
+ data-row-dividers={rowDividers ? "true" : undefined}
236
+ data-size={size}
237
+ data-slot="table"
238
+ data-tracking-el={trackingEl}
239
+ data-tracking-label={trackingLabel}
240
+ style={{ minWidth, ...style }}
241
+ {...props}
242
+ />
243
+ </div>
244
+ </TableSizeContext.Provider>
144
245
  );
145
246
  }
146
247
  );
@@ -233,16 +334,16 @@ interface TableRowProps extends React.ComponentProps<"tr"> {
233
334
  dataHook?: string;
234
335
  }
235
336
 
337
+ // Selected rows share the table head's surface (bg-muted). Shared with
338
+ // TableEmpty, which renders its own <tr>.
339
+ const tableRowStyles =
340
+ "data-[state=selected]:bg-muted duration-fast transition-colors ease-out";
341
+
236
342
  const TableRow = React.forwardRef<HTMLTableRowElement, TableRowProps>(
237
343
  ({ className, dataHook, ...props }, ref) => (
238
344
  <tr
239
345
  ref={ref}
240
- className={cn(
241
- // Selected rows share the table head's surface (bg-muted).
242
- "data-[state=selected]:bg-muted",
243
- "duration-fast transition-colors ease-out",
244
- className
245
- )}
346
+ className={cn(tableRowStyles, className)}
246
347
  data-hook={dataHook}
247
348
  data-slot="table-row"
248
349
  {...props}
@@ -259,7 +360,7 @@ TableRow.displayName = "TableRow";
259
360
  interface TableHeadProps
260
361
  extends
261
362
  Omit<React.ComponentProps<"th">, "align">,
262
- VariantProps<typeof tableHeadVariants> {
363
+ Omit<VariantProps<typeof tableHeadVariants>, "size"> {
263
364
  /**
264
365
  * Data hook for automated testing
265
366
  */
@@ -292,17 +393,20 @@ const TableHead = React.forwardRef<HTMLTableCellElement, TableHeadProps>(
292
393
  ...props
293
394
  },
294
395
  ref
295
- ) => (
296
- <th
297
- ref={ref}
298
- className={cn(tableHeadVariants({ align }), className)}
299
- data-hook={dataHook}
300
- data-slot="table-head"
301
- scope={scope}
302
- style={{ width, minWidth, ...style }}
303
- {...props}
304
- />
305
- )
396
+ ) => {
397
+ const size = React.useContext(TableSizeContext);
398
+ return (
399
+ <th
400
+ ref={ref}
401
+ className={cn(tableHeadVariants({ size, align }), className)}
402
+ data-hook={dataHook}
403
+ data-slot="table-head"
404
+ scope={scope}
405
+ style={{ width, minWidth, ...style }}
406
+ {...props}
407
+ />
408
+ );
409
+ }
306
410
  );
307
411
 
308
412
  TableHead.displayName = "TableHead";
@@ -314,7 +418,7 @@ TableHead.displayName = "TableHead";
314
418
  interface TableCellProps
315
419
  extends
316
420
  Omit<React.ComponentProps<"td">, "align">,
317
- VariantProps<typeof tableCellVariants> {
421
+ Omit<VariantProps<typeof tableCellVariants>, "size"> {
318
422
  /**
319
423
  * Data hook for automated testing
320
424
  */
@@ -329,8 +433,10 @@ interface TableCellProps
329
433
  */
330
434
  minWidth?: string;
331
435
  /**
332
- * Size variant for cell height/padding
333
- * @default "default"
436
+ * @deprecated Since 3.3.0 — ignored. Row height is set once on the parent
437
+ * `Table` (`size="default" | "sm"`, DS-556); a per-cell size let one row
438
+ * disagree with its table and duplicated what sized content already does.
439
+ * Accepted so existing markup keeps compiling; removed in the next major.
334
440
  */
335
441
  size?: "default" | "md" | "lg";
336
442
  /**
@@ -338,26 +444,144 @@ interface TableCellProps
338
444
  * @default "left"
339
445
  */
340
446
  align?: "left" | "right" | "center";
447
+ /**
448
+ * Marks the cell as the first of a column group (DS-1195): draws a 1px
449
+ * `border-border` separator on its start edge. Set it on every body cell of
450
+ * the column that starts a group; the header band stays clean, so
451
+ * `TableHead` has no such prop. In `DataTable`, set `meta.groupStart` on the
452
+ * column instead.
453
+ * @default false
454
+ */
455
+ groupStart?: boolean;
341
456
  }
342
457
 
343
458
  const TableCell = React.forwardRef<HTMLTableCellElement, TableCellProps>(
344
459
  (
345
- { className, dataHook, size, align, width, minWidth, style, ...props },
460
+ {
461
+ className,
462
+ dataHook,
463
+ // Deprecated no-op — destructured so it never reaches the DOM; only
464
+ // the dev warning below reads it (DS-556).
465
+ size: _deprecatedSize,
466
+ align,
467
+ groupStart = false,
468
+ width,
469
+ minWidth,
470
+ style,
471
+ ...props
472
+ },
346
473
  ref
347
- ) => (
348
- <td
349
- ref={ref}
350
- className={cn(tableCellVariants({ size, align }), className)}
351
- data-hook={dataHook}
352
- data-slot="table-cell"
353
- style={{ width, minWidth, ...style }}
354
- {...props}
355
- />
356
- )
474
+ ) => {
475
+ const size = React.useContext(TableSizeContext);
476
+ useDevWarning(
477
+ () => _deprecatedSize !== undefined,
478
+ 'TableCell: the "size" prop is deprecated since 3.3.0 and ignored — set size="default" | "sm" on the Table root instead (DS-556).',
479
+ [_deprecatedSize]
480
+ );
481
+ return (
482
+ <td
483
+ ref={ref}
484
+ className={cn(
485
+ tableCellVariants({ size, align }),
486
+ groupStart && "border-border border-l",
487
+ className
488
+ )}
489
+ data-group-start={groupStart ? "true" : undefined}
490
+ data-hook={dataHook}
491
+ data-slot="table-cell"
492
+ style={{ width, minWidth, ...style }}
493
+ {...props}
494
+ />
495
+ );
496
+ }
357
497
  );
358
498
 
359
499
  TableCell.displayName = "TableCell";
360
500
 
501
+ /* -------------------------------------------------------------------------------------------------
502
+ * TableEmpty
503
+ * -----------------------------------------------------------------------------------------------*/
504
+
505
+ /**
506
+ * Props for the TableEmpty component.
507
+ */
508
+ interface TableEmptyProps extends Omit<React.ComponentProps<"tr">, "children"> {
509
+ /**
510
+ * Number of columns the empty row spans — the table's column count, so the
511
+ * message centres across the whole table.
512
+ * @example 5
513
+ */
514
+ colSpan: number;
515
+ /**
516
+ * What the table shows in place of rows.
517
+ *
518
+ * A string is a one-line message in an ordinary row at the table's `size`
519
+ * min-height — the bare fallback, announced politely.
520
+ *
521
+ * Pass an `<EmptyState size="md">` for the two designed states. A filtered
522
+ * or searched collection with nothing left (the Figma `No results` state):
523
+ * the `SearchX` icon, the echoed query as the title and one line of
524
+ * description — no action, the reader wants the outcome of their own query,
525
+ * not a CTA. An empty collection (the `Empty` state): a title, one line and
526
+ * the setup CTA. The row brings the block's breathing room (`py-6`) with
527
+ * it, so do not wrap it in a padding element; keep it to the standard
528
+ * anatomy — it sits in the same polite live region. Any non-string child is
529
+ * treated as a block and gets that padding.
530
+ * @default "No results."
531
+ */
532
+ children?: React.ReactNode;
533
+ /**
534
+ * Data hook for automated testing
535
+ */
536
+ dataHook?: string;
537
+ }
538
+
539
+ /**
540
+ * The single full-width row a table shows when it has no rows — the same row
541
+ * `DataTable` renders for `noResultsMessage`. Place it inside `TableBody`.
542
+ *
543
+ * ```tsx
544
+ * <TableBody>
545
+ * {rows.length > 0 ? rows.map(renderRow) : (
546
+ * <TableEmpty colSpan={columns.length}>No results.</TableEmpty>
547
+ * )}
548
+ * </TableBody>
549
+ * ```
550
+ */
551
+ const TableEmpty = React.forwardRef<HTMLTableRowElement, TableEmptyProps>(
552
+ ({ colSpan, children, dataHook, className, ...props }, ref) => {
553
+ const content = children ?? "No results.";
554
+ // A plain line sits in an ordinary row; a block gets 24 on top of the
555
+ // cell's own 8 — the 32 an EmptyState has anywhere else. A translated
556
+ // node (a fragment, <Trans>) counts as a block — pass a resolved string
557
+ // for the one-line row.
558
+ const isLine = typeof content === "string" || typeof content === "number";
559
+ return (
560
+ <tr
561
+ ref={ref}
562
+ className={cn(tableRowStyles, className)}
563
+ data-hook={dataHook}
564
+ data-slot="table-empty"
565
+ {...props}
566
+ >
567
+ <TableCell align="center" colSpan={colSpan}>
568
+ {/* Polite live region: the outcome of the reader's own query. */}
569
+ <div
570
+ aria-live="polite"
571
+ className={cn(!isLine && "py-6")}
572
+ data-slot="table-empty-message"
573
+ role="status"
574
+ >
575
+ {content}
576
+ </div>
577
+ </TableCell>
578
+ </tr>
579
+ );
580
+ }
581
+ );
582
+
583
+ TableEmpty.displayName = "TableEmpty";
584
+
361
585
  /* -------------------------------------------------------------------------------------------------
362
586
  * TableCaption
363
587
  * -----------------------------------------------------------------------------------------------*/
@@ -390,9 +614,9 @@ interface TableCaptionProps extends React.ComponentProps<"caption"> {
390
614
  * </Table>
391
615
  *
392
616
  * // After
393
- * <TypographyH3 dataHook="transactions-heading" id="transactions-heading">
617
+ * <TypographyHeading level={3} dataHook="transactions-heading" id="transactions-heading">
394
618
  * Recent transactions
395
- * </TypographyH3>
619
+ * </TypographyHeading>
396
620
  * <Table aria-labelledby="transactions-heading" dataHook="transactions">
397
621
  * ...
398
622
  * </Table>
@@ -425,10 +649,17 @@ export {
425
649
  TableHead,
426
650
  TableRow,
427
651
  TableCell,
652
+ TableEmpty,
428
653
  TableCaption,
654
+ // Kept only because it shipped from this entry in 3.1 (DS-912). It is an
655
+ // internal helper (now in lib/table-internal) and leaves the public entry
656
+ // in the next major — see deprecations.json.
657
+ scrollRegionProps,
429
658
  };
430
659
 
431
660
  export type {
661
+ TableFrame,
662
+ TableSize,
432
663
  TableProps,
433
664
  TableHeaderProps,
434
665
  TableBodyProps,
@@ -436,5 +667,6 @@ export type {
436
667
  TableRowProps,
437
668
  TableHeadProps,
438
669
  TableCellProps,
670
+ TableEmptyProps,
439
671
  TableCaptionProps,
440
672
  };