@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
@@ -3,9 +3,10 @@
3
3
  import * as React from "react";
4
4
  import * as SheetPrimitive from "@radix-ui/react-dialog";
5
5
  import { cva, type VariantProps } from "class-variance-authority";
6
- import { X } from "@brightlocal/icons";
6
+ import { ChevronDown, ChevronUp, X } from "@brightlocal/icons";
7
7
 
8
8
  import { cn } from "@brightlocal/ui-components/lib/utils";
9
+ import { Button } from "@brightlocal/ui-components/button";
9
10
  import { ScrollArea } from "@brightlocal/ui-components/scroll-area";
10
11
  import { useOverlayPointerLock } from "@brightlocal/ui-components/hooks/use-overlay-pointer-lock";
11
12
 
@@ -23,8 +24,10 @@ export type SheetSide = "top" | "right" | "bottom" | "left";
23
24
  * - default: Panel fills 75% of the viewport up to 384px
24
25
  * - sm: Panel hugs its content between 288 and 320px, keeping the page
25
26
  * partly visible behind it on phones (used by the Sidebar mobile nav)
27
+ * - lg: Panel fills 75% of the viewport up to 512px — detail panels with
28
+ * dense content (date pickers, thumbnail rows)
26
29
  */
27
- export type SheetSize = "default" | "sm";
30
+ export type SheetSize = "default" | "sm" | "lg";
28
31
 
29
32
  const sheetContentVariants = cva(
30
33
  [
@@ -86,6 +89,7 @@ const sheetContentVariants = cva(
86
89
  size: {
87
90
  default: [],
88
91
  sm: [],
92
+ lg: [],
89
93
  },
90
94
  },
91
95
  compoundVariants: [
@@ -108,6 +112,13 @@ const sheetContentVariants = cva(
108
112
  "max-w-(--ds-container-xs)",
109
113
  ],
110
114
  },
115
+ // lg side panels are the wider detail-panel width (DS-1206): same 75%
116
+ // phone fill as default, capped at 512px on larger viewports.
117
+ {
118
+ side: ["left", "right"],
119
+ size: "lg",
120
+ className: ["w-3/4", "sm:max-w-lg"],
121
+ },
111
122
  ],
112
123
  defaultVariants: {
113
124
  side: "right",
@@ -211,7 +222,8 @@ interface SheetContentProps
211
222
  side?: SheetSide;
212
223
  /**
213
224
  * Width preset for side panels. `sm` hugs the content between 288 and
214
- * 320px; `default` keeps the classic 75%-up-to-384px drawer width.
225
+ * 320px; `default` keeps the classic 75%-up-to-384px drawer width; `lg`
226
+ * widens to 75%-up-to-512px for dense detail panels.
215
227
  * Ignored for top/bottom sheets.
216
228
  * @default "default"
217
229
  */
@@ -273,9 +285,18 @@ const SheetContent = React.forwardRef<
273
285
  {...props}
274
286
  >
275
287
  {children}
276
- <SheetPrimitive.Close className="ring-offset-background focus-visible:ring-ring data-[state=open]:bg-accent data-[state=open]:text-muted-foreground duration-fast absolute top-4 right-4 rounded-xs opacity-70 outline-hidden transition-opacity ease-out hover:opacity-100 focus-visible:ring-2 focus-visible:ring-offset-2 disabled:pointer-events-none [&_svg]:pointer-events-none [&_svg]:shrink-0">
277
- <X />
278
- <span className="sr-only">{closeLabel ?? "Close"}</span>
288
+ {/* Ghost icon button (DS-1035) — standard hover/focus states, and its
289
+ 36px box at top-6 lines up with a SheetPagination row. */}
290
+ <SheetPrimitive.Close asChild>
291
+ <Button
292
+ iconOnly
293
+ className="absolute top-6 right-4"
294
+ dataHook="sheet-close"
295
+ variant="ghost"
296
+ >
297
+ <X />
298
+ <span className="sr-only">{closeLabel ?? "Close"}</span>
299
+ </Button>
279
300
  </SheetPrimitive.Close>
280
301
  </SheetPrimitive.Content>
281
302
  </SheetPortal>
@@ -301,6 +322,228 @@ const SheetHeader = React.forwardRef<
301
322
  ));
302
323
  SheetHeader.displayName = "SheetHeader";
303
324
 
325
+ /**
326
+ * Numbers a `SheetPagination` position indicator is built from.
327
+ */
328
+ interface SheetPaginationPositionInfo {
329
+ /** 1-based position of the item shown in the sheet. */
330
+ current: number;
331
+ /** Total number of items in the list being stepped through. */
332
+ total: number;
333
+ }
334
+
335
+ /**
336
+ * Props for the SheetPagination component
337
+ */
338
+ interface SheetPaginationProps extends Omit<
339
+ React.ComponentProps<"div">,
340
+ "children"
341
+ > {
342
+ /** Called when the user steps to the previous item. */
343
+ onPrevious: () => void;
344
+ /** Called when the user steps to the next item. */
345
+ onNext: () => void;
346
+ /**
347
+ * 1-based position of the item shown in the sheet. Together with `total`,
348
+ * drives the position indicator and the default boundary state.
349
+ */
350
+ current?: number;
351
+ /** Total number of items in the list being stepped through. */
352
+ total?: number;
353
+ /**
354
+ * Whether a previous item exists. Disables the previous button when false.
355
+ * @default current > 1 (true when `current` is not set)
356
+ */
357
+ hasPrevious?: boolean;
358
+ /**
359
+ * Whether a next item exists. Disables the next button when false.
360
+ * @default current < total (true when either is not set)
361
+ */
362
+ hasNext?: boolean;
363
+ /**
364
+ * Render the position indicator. Receives the current position and total;
365
+ * you own the wording. Return `null` to hide it.
366
+ * @default Renders "{current} of {total}", or nothing when either is unset.
367
+ */
368
+ renderPosition?:
369
+ ((info: SheetPaginationPositionInfo) => React.ReactNode) | null;
370
+ /**
371
+ * Accessible label for the item navigation group.
372
+ * @default "Item navigation"
373
+ */
374
+ ariaLabel?: string;
375
+ /**
376
+ * Accessible label for the previous button.
377
+ * @default "Previous item"
378
+ */
379
+ prevAriaLabel?: string;
380
+ /**
381
+ * Accessible label for the next button.
382
+ * @default "Next item"
383
+ */
384
+ nextAriaLabel?: string;
385
+ /**
386
+ * Data hook for automated testing. The buttons get `{dataHook}-previous`
387
+ * and `{dataHook}-next`.
388
+ */
389
+ dataHook: string;
390
+ /**
391
+ * Tracking element identifier for analytics
392
+ */
393
+ trackingEl?: string;
394
+ /**
395
+ * Tracking label for analytics context
396
+ */
397
+ trackingLabel?: string;
398
+ }
399
+
400
+ /**
401
+ * Previous/next controls for stepping through a list of items without
402
+ * closing the sheet — e.g. a detail sheet drilled into from a table row.
403
+ * Place it as the first child of SheetContent, above SheetHeader; it shares
404
+ * the close button's row. The arrow keys step while focus is on the controls.
405
+ */
406
+ const SheetPagination = React.forwardRef<HTMLDivElement, SheetPaginationProps>(
407
+ (
408
+ {
409
+ className,
410
+ onPrevious,
411
+ onNext,
412
+ current,
413
+ total,
414
+ hasPrevious,
415
+ hasNext,
416
+ renderPosition,
417
+ ariaLabel,
418
+ prevAriaLabel,
419
+ nextAriaLabel,
420
+ dataHook,
421
+ trackingEl,
422
+ trackingLabel,
423
+ ...props
424
+ },
425
+ ref
426
+ ) => {
427
+ const canPrevious = hasPrevious ?? (current == null || current > 1);
428
+ const canNext =
429
+ hasNext ?? (current == null || total == null || current < total);
430
+
431
+ const prevRef = React.useRef<HTMLButtonElement>(null);
432
+ const nextRef = React.useRef<HTMLButtonElement>(null);
433
+ // The button that just triggered a step. Set only by our own
434
+ // navigation, consumed on the next commit.
435
+ const pendingRef = React.useRef<HTMLButtonElement | null>(null);
436
+
437
+ // Reaching a boundary disables the button that was just pressed, which
438
+ // drops focus to <body>. Hand it to the sibling instead so keyboard users
439
+ // stay in the control.
440
+ React.useEffect(() => {
441
+ const pending = pendingRef.current;
442
+ pendingRef.current = null;
443
+ if (!pending) return;
444
+ const active = document.activeElement;
445
+ if (active !== pending && active !== document.body) return;
446
+ if (!canPrevious && pending === prevRef.current && canNext) {
447
+ nextRef.current?.focus();
448
+ } else if (!canNext && pending === nextRef.current && canPrevious) {
449
+ prevRef.current?.focus();
450
+ }
451
+ });
452
+
453
+ const handleBlur = (event: React.FocusEvent<HTMLButtonElement>) => {
454
+ // Focus left on purpose (to anything but the sibling) — drop any
455
+ // pending hand-off. A disabled button blurs with a null relatedTarget.
456
+ const next = event.relatedTarget;
457
+ if (next && next !== prevRef.current && next !== nextRef.current) {
458
+ pendingRef.current = null;
459
+ }
460
+ };
461
+
462
+ const step = (
463
+ direction: "previous" | "next",
464
+ trigger: HTMLButtonElement
465
+ ) => {
466
+ if (direction === "previous") {
467
+ if (!canPrevious) return;
468
+ pendingRef.current = trigger;
469
+ onPrevious();
470
+ } else {
471
+ if (!canNext) return;
472
+ pendingRef.current = trigger;
473
+ onNext();
474
+ }
475
+ };
476
+
477
+ const handleKeyDown = (event: React.KeyboardEvent<HTMLButtonElement>) => {
478
+ if (event.key === "ArrowUp" || event.key === "ArrowLeft") {
479
+ event.preventDefault();
480
+ step("previous", event.currentTarget);
481
+ } else if (event.key === "ArrowDown" || event.key === "ArrowRight") {
482
+ event.preventDefault();
483
+ step("next", event.currentTarget);
484
+ }
485
+ };
486
+
487
+ let position: React.ReactNode = null;
488
+ if (renderPosition !== null && current != null && total != null) {
489
+ position = renderPosition
490
+ ? renderPosition({ current, total })
491
+ : `${current} of ${total}`;
492
+ }
493
+
494
+ return (
495
+ <div
496
+ ref={ref}
497
+ aria-label={ariaLabel ?? "Item navigation"}
498
+ // mb-2 on top of SheetContent's gap-4 gives the 24px Figma gap to
499
+ // the header below.
500
+ className={cn("mb-2 flex items-center gap-1", className)}
501
+ data-hook={dataHook}
502
+ data-slot="sheet-pagination"
503
+ data-tracking-el={trackingEl}
504
+ data-tracking-label={trackingLabel}
505
+ role="group"
506
+ {...props}
507
+ >
508
+ <Button
509
+ ref={prevRef}
510
+ ariaLabel={prevAriaLabel ?? "Previous item"}
511
+ dataHook={`${dataHook}-previous`}
512
+ disabled={!canPrevious}
513
+ variant="ghost"
514
+ onBlur={handleBlur}
515
+ onClick={(event) => step("previous", event.currentTarget)}
516
+ onKeyDown={handleKeyDown}
517
+ >
518
+ <ChevronUp />
519
+ </Button>
520
+ <Button
521
+ ref={nextRef}
522
+ ariaLabel={nextAriaLabel ?? "Next item"}
523
+ dataHook={`${dataHook}-next`}
524
+ disabled={!canNext}
525
+ variant="ghost"
526
+ onBlur={handleBlur}
527
+ onClick={(event) => step("next", event.currentTarget)}
528
+ onKeyDown={handleKeyDown}
529
+ >
530
+ <ChevronDown />
531
+ </Button>
532
+ {position != null && (
533
+ <span
534
+ aria-live="polite"
535
+ className="text-body-sm text-muted-foreground"
536
+ data-slot="sheet-pagination-position"
537
+ >
538
+ {position}
539
+ </span>
540
+ )}
541
+ </div>
542
+ );
543
+ }
544
+ );
545
+ SheetPagination.displayName = "SheetPagination";
546
+
304
547
  /**
305
548
  * Props for the SheetBody component
306
549
  */
@@ -450,6 +693,7 @@ export {
450
693
  SheetFooter,
451
694
  SheetHeader,
452
695
  SheetOverlay,
696
+ SheetPagination,
453
697
  SheetPortal,
454
698
  SheetTitle,
455
699
  SheetTrigger,
@@ -459,6 +703,8 @@ export type {
459
703
  SheetBodyProps,
460
704
  SheetContentProps,
461
705
  SheetDescriptionProps,
706
+ SheetPaginationPositionInfo,
707
+ SheetPaginationProps,
462
708
  SheetTitleProps,
463
709
  SheetTriggerProps,
464
710
  };