@brightlocal/ui-components 3.1.0 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/AI_USAGE.md +10 -0
  2. package/README.md +8 -1
  3. package/component-meta.json +1591 -123
  4. package/deprecations.json +45 -1
  5. package/dist/_virtual/_rolldown/runtime.cjs +1 -0
  6. package/dist/accordion.cjs +1 -1
  7. package/dist/accordion.js +73 -102
  8. package/dist/alert-dialog.cjs +1 -1
  9. package/dist/alert-dialog.d.ts +36 -5
  10. package/dist/alert-dialog.d.ts.map +1 -1
  11. package/dist/alert-dialog.js +83 -128
  12. package/dist/alert.cjs +1 -1
  13. package/dist/alert.d.ts +4 -4
  14. package/dist/alert.d.ts.map +1 -1
  15. package/dist/alert.js +116 -177
  16. package/dist/aspect-ratio.cjs +1 -1
  17. package/dist/aspect-ratio.js +13 -16
  18. package/dist/avatar.cjs +1 -1
  19. package/dist/avatar.js +30 -45
  20. package/dist/badge.cjs +1 -1
  21. package/dist/badge.d.ts +32 -1
  22. package/dist/badge.d.ts.map +1 -1
  23. package/dist/badge.js +90 -71
  24. package/dist/banner.cjs +1 -0
  25. package/dist/banner.d.ts +81 -0
  26. package/dist/banner.d.ts.map +1 -0
  27. package/dist/banner.js +130 -0
  28. package/dist/blocks/empty-state.cjs +1 -1
  29. package/dist/blocks/empty-state.d.ts +24 -6
  30. package/dist/blocks/empty-state.d.ts.map +1 -1
  31. package/dist/blocks/empty-state.js +74 -140
  32. package/dist/blocks/input-list.cjs +2 -2
  33. package/dist/blocks/input-list.d.ts +2 -2
  34. package/dist/blocks/input-list.d.ts.map +1 -1
  35. package/dist/blocks/input-list.js +136 -176
  36. package/dist/blocks/progress-state.cjs +1 -1
  37. package/dist/blocks/progress-state.d.ts +2 -2
  38. package/dist/blocks/progress-state.js +223 -347
  39. package/dist/blocks/sidebar.cjs +1 -1
  40. package/dist/blocks/sidebar.d.ts +28 -6
  41. package/dist/blocks/sidebar.d.ts.map +1 -1
  42. package/dist/blocks/sidebar.js +763 -1086
  43. package/dist/brand-illustration-motif.cjs +1 -1
  44. package/dist/brand-illustration-motif.d.ts +1 -1
  45. package/dist/brand-illustration-motif.js +40 -61
  46. package/dist/breadcrumb.cjs +1 -1
  47. package/dist/breadcrumb.js +62 -102
  48. package/dist/button-group.cjs +1 -1
  49. package/dist/button-group.js +23 -31
  50. package/dist/button.cjs +1 -1
  51. package/dist/button.d.ts +4 -2
  52. package/dist/button.d.ts.map +1 -1
  53. package/dist/button.js +149 -189
  54. package/dist/calendar.cjs +1 -1
  55. package/dist/calendar.d.ts +87 -3
  56. package/dist/calendar.d.ts.map +1 -1
  57. package/dist/calendar.js +116 -173
  58. package/dist/callout.cjs +1 -1
  59. package/dist/callout.js +73 -96
  60. package/dist/card.cjs +1 -1
  61. package/dist/card.d.ts +92 -6
  62. package/dist/card.d.ts.map +1 -1
  63. package/dist/card.js +240 -234
  64. package/dist/carousel.cjs +1 -1
  65. package/dist/carousel.d.ts +3 -3
  66. package/dist/carousel.d.ts.map +1 -1
  67. package/dist/carousel.js +174 -268
  68. package/dist/centred-layout.cjs +1 -1
  69. package/dist/centred-layout.js +27 -48
  70. package/dist/chart-empty.cjs +1 -1
  71. package/dist/chart-empty.js +18 -27
  72. package/dist/chart.cjs +7 -7
  73. package/dist/chart.d.ts +253 -25
  74. package/dist/chart.d.ts.map +1 -1
  75. package/dist/chart.js +465 -511
  76. package/dist/checkbox.cjs +1 -1
  77. package/dist/checkbox.d.ts +1 -1
  78. package/dist/checkbox.d.ts.map +1 -1
  79. package/dist/checkbox.js +37 -69
  80. package/dist/chip.cjs +1 -1
  81. package/dist/chip.js +116 -173
  82. package/dist/collapsible.cjs +1 -1
  83. package/dist/collapsible.d.ts.map +1 -1
  84. package/dist/collapsible.js +35 -41
  85. package/dist/combobox.cjs +3 -3
  86. package/dist/combobox.d.ts +14 -4
  87. package/dist/combobox.d.ts.map +1 -1
  88. package/dist/combobox.js +440 -639
  89. package/dist/command.cjs +1 -1
  90. package/dist/command.d.ts.map +1 -1
  91. package/dist/command.js +273 -420
  92. package/dist/context-menu.cjs +1 -1
  93. package/dist/context-menu.d.ts +5 -5
  94. package/dist/context-menu.d.ts.map +1 -1
  95. package/dist/context-menu.js +121 -191
  96. package/dist/data-table.cjs +1 -1
  97. package/dist/data-table.d.ts +442 -144
  98. package/dist/data-table.d.ts.map +1 -1
  99. package/dist/data-table.js +708 -835
  100. package/dist/date-picker.cjs +1 -1
  101. package/dist/date-picker.d.ts +15 -4
  102. package/dist/date-picker.d.ts.map +1 -1
  103. package/dist/date-picker.js +156 -231
  104. package/dist/delta.cjs +1 -0
  105. package/dist/delta.d.ts +79 -0
  106. package/dist/delta.d.ts.map +1 -0
  107. package/dist/delta.js +62 -0
  108. package/dist/description.cjs +1 -1
  109. package/dist/description.js +11 -20
  110. package/dist/dialog.cjs +1 -1
  111. package/dist/dialog.d.ts +1 -1
  112. package/dist/dialog.d.ts.map +1 -1
  113. package/dist/dialog.js +76 -116
  114. package/dist/drawer.cjs +1 -1
  115. package/dist/drawer.d.ts +11 -11
  116. package/dist/drawer.d.ts.map +1 -1
  117. package/dist/drawer.js +76 -134
  118. package/dist/dropdown-menu.cjs +1 -1
  119. package/dist/dropdown-menu.d.ts +6 -6
  120. package/dist/dropdown-menu.d.ts.map +1 -1
  121. package/dist/dropdown-menu.js +179 -300
  122. package/dist/field.cjs +1 -1
  123. package/dist/field.d.ts +9 -9
  124. package/dist/field.d.ts.map +1 -1
  125. package/dist/field.js +166 -286
  126. package/dist/global-layout.cjs +1 -1
  127. package/dist/global-layout.js +203 -342
  128. package/dist/grid.cjs +1 -1
  129. package/dist/grid.d.ts +24 -1
  130. package/dist/grid.d.ts.map +1 -1
  131. package/dist/grid.js +16 -29
  132. package/dist/header.cjs +1 -1
  133. package/dist/header.js +21 -38
  134. package/dist/height-transition.cjs +1 -1
  135. package/dist/height-transition.js +38 -55
  136. package/dist/hooks/use-breakpoint.cjs +1 -1
  137. package/dist/hooks/use-breakpoint.d.ts +1 -1
  138. package/dist/hooks/use-breakpoint.d.ts.map +1 -1
  139. package/dist/hooks/use-breakpoint.js +10 -9
  140. package/dist/hooks/use-debounce.cjs +1 -1
  141. package/dist/hooks/use-debounce.js +12 -11
  142. package/dist/hooks/use-delayed-pending.cjs +1 -1
  143. package/dist/hooks/use-delayed-pending.js +8 -9
  144. package/dist/hooks/use-filter-search-params.cjs +1 -0
  145. package/dist/hooks/use-filter-search-params.d.ts +93 -0
  146. package/dist/hooks/use-filter-search-params.d.ts.map +1 -0
  147. package/dist/hooks/use-filter-search-params.js +122 -0
  148. package/dist/hooks/use-mobile.cjs +1 -1
  149. package/dist/hooks/use-mobile.js +6 -6
  150. package/dist/hooks/use-overlay-pointer-lock.cjs +1 -1
  151. package/dist/hooks/use-overlay-pointer-lock.js +8 -9
  152. package/dist/hooks/use-prefers-reduced-motion.cjs +1 -1
  153. package/dist/hooks/use-prefers-reduced-motion.js +5 -8
  154. package/dist/hover-card.cjs +1 -1
  155. package/dist/hover-card.d.ts +1 -1
  156. package/dist/hover-card.d.ts.map +1 -1
  157. package/dist/hover-card.js +30 -62
  158. package/dist/index.cjs +1 -1
  159. package/dist/index.d.ts +11 -0
  160. package/dist/index.d.ts.map +1 -1
  161. package/dist/index.js +636 -582
  162. package/dist/info-tooltip.cjs +1 -0
  163. package/dist/info-tooltip.d.ts +39 -0
  164. package/dist/info-tooltip.d.ts.map +1 -0
  165. package/dist/info-tooltip.js +27 -0
  166. package/dist/input-chip.cjs +1 -1
  167. package/dist/input-chip.d.ts +32 -3
  168. package/dist/input-chip.d.ts.map +1 -1
  169. package/dist/input-chip.js +182 -231
  170. package/dist/input-group.cjs +1 -1
  171. package/dist/input-group.d.ts +33 -2
  172. package/dist/input-group.d.ts.map +1 -1
  173. package/dist/input-group.js +188 -122
  174. package/dist/input-otp.cjs +1 -1
  175. package/dist/input-otp.d.ts +3 -3
  176. package/dist/input-otp.d.ts.map +1 -1
  177. package/dist/input-otp.js +102 -146
  178. package/dist/input-password.cjs +1 -1
  179. package/dist/input-password.d.ts +26 -8
  180. package/dist/input-password.d.ts.map +1 -1
  181. package/dist/input-password.js +139 -171
  182. package/dist/input.cjs +1 -1
  183. package/dist/input.d.ts.map +1 -1
  184. package/dist/input.js +51 -73
  185. package/dist/label.cjs +1 -1
  186. package/dist/label.js +20 -38
  187. package/dist/lib/block-illustration.cjs +1 -1
  188. package/dist/lib/block-illustration.d.ts +5 -2
  189. package/dist/lib/block-illustration.d.ts.map +1 -1
  190. package/dist/lib/block-illustration.js +16 -17
  191. package/dist/lib/compose-event-handlers.cjs +1 -0
  192. package/dist/lib/compose-event-handlers.d.ts +9 -0
  193. package/dist/lib/compose-event-handlers.d.ts.map +1 -0
  194. package/dist/lib/compose-event-handlers.js +8 -0
  195. package/dist/lib/download-file.cjs +1 -0
  196. package/dist/lib/download-file.d.ts +14 -0
  197. package/dist/lib/download-file.d.ts.map +1 -0
  198. package/dist/lib/download-file.js +40 -0
  199. package/dist/lib/empty-canvas.cjs +1 -1
  200. package/dist/lib/empty-canvas.js +28 -56
  201. package/dist/lib/empty-chip.cjs +1 -1
  202. package/dist/lib/empty-chip.d.ts +14 -3
  203. package/dist/lib/empty-chip.d.ts.map +1 -1
  204. package/dist/lib/empty-chip.js +15 -11
  205. package/dist/lib/field-aria.cjs +1 -0
  206. package/dist/lib/field-aria.d.ts +34 -0
  207. package/dist/lib/field-aria.d.ts.map +1 -0
  208. package/dist/lib/field-aria.js +52 -0
  209. package/dist/lib/image-file-info.cjs +1 -0
  210. package/dist/lib/image-file-info.d.ts +25 -0
  211. package/dist/lib/image-file-info.d.ts.map +1 -0
  212. package/dist/lib/image-file-info.js +67 -0
  213. package/dist/lib/media-viewer-content.cjs +1 -0
  214. package/dist/lib/media-viewer-content.d.ts +102 -0
  215. package/dist/lib/media-viewer-content.d.ts.map +1 -0
  216. package/dist/lib/media-viewer-content.js +650 -0
  217. package/dist/lib/media-viewer-internal.cjs +1 -0
  218. package/dist/lib/media-viewer-internal.d.ts +98 -0
  219. package/dist/lib/media-viewer-internal.d.ts.map +1 -0
  220. package/dist/lib/media-viewer-internal.js +61 -0
  221. package/dist/lib/media-viewer-motion.cjs +1 -0
  222. package/dist/lib/media-viewer-motion.d.ts +40 -0
  223. package/dist/lib/media-viewer-motion.d.ts.map +1 -0
  224. package/dist/lib/media-viewer-motion.js +37 -0
  225. package/dist/lib/motion.cjs +1 -1
  226. package/dist/lib/motion.d.ts +8 -0
  227. package/dist/lib/motion.d.ts.map +1 -1
  228. package/dist/lib/motion.js +11 -10
  229. package/dist/lib/optical-center.cjs +1 -1
  230. package/dist/lib/optical-center.d.ts +1 -1
  231. package/dist/lib/optical-center.d.ts.map +1 -1
  232. package/dist/lib/optical-center.js +12 -5
  233. package/dist/lib/spring-settle.cjs +1 -1
  234. package/dist/lib/spring-settle.js +1 -1
  235. package/dist/lib/table-internal.cjs +1 -0
  236. package/dist/lib/table-internal.d.ts +62 -0
  237. package/dist/lib/table-internal.d.ts.map +1 -0
  238. package/dist/lib/table-internal.js +18 -0
  239. package/dist/lib/use-controllable.cjs +1 -0
  240. package/dist/lib/use-controllable.d.ts +12 -0
  241. package/dist/lib/use-controllable.d.ts.map +1 -0
  242. package/dist/lib/use-controllable.js +15 -0
  243. package/dist/lib/use-dev-warning.cjs +1 -1
  244. package/dist/lib/utils.cjs +1 -1
  245. package/dist/lib/utils.d.ts.map +1 -1
  246. package/dist/lib/utils.js +29 -35
  247. package/dist/link.cjs +1 -1
  248. package/dist/link.d.ts +1 -1
  249. package/dist/link.js +78 -124
  250. package/dist/list.cjs +1 -1
  251. package/dist/list.d.ts +8 -0
  252. package/dist/list.d.ts.map +1 -1
  253. package/dist/list.js +94 -156
  254. package/dist/loading.cjs +1 -1
  255. package/dist/loading.js +124 -151
  256. package/dist/logo-mark.cjs +1 -0
  257. package/dist/logo-mark.d.ts +79 -0
  258. package/dist/logo-mark.d.ts.map +1 -0
  259. package/dist/logo-mark.js +219 -0
  260. package/dist/logo.cjs +1 -1
  261. package/dist/logo.d.ts +1 -1
  262. package/dist/logo.d.ts.map +1 -1
  263. package/dist/logo.js +51 -87
  264. package/dist/map.cjs +1 -1
  265. package/dist/map.d.ts.map +1 -1
  266. package/dist/map.js +390 -586
  267. package/dist/media-empty.cjs +1 -1
  268. package/dist/media-empty.js +27 -42
  269. package/dist/media-viewer.cjs +1 -0
  270. package/dist/media-viewer.d.ts +224 -0
  271. package/dist/media-viewer.d.ts.map +1 -0
  272. package/dist/media-viewer.js +295 -0
  273. package/dist/menubar.cjs +1 -1
  274. package/dist/menubar.d.ts +14 -14
  275. package/dist/menubar.d.ts.map +1 -1
  276. package/dist/menubar.js +130 -267
  277. package/dist/multi-select-filter.cjs +1 -0
  278. package/dist/multi-select-filter.d.ts +186 -0
  279. package/dist/multi-select-filter.d.ts.map +1 -0
  280. package/dist/multi-select-filter.js +374 -0
  281. package/dist/navigation-menu.cjs +1 -1
  282. package/dist/navigation-menu.js +108 -172
  283. package/dist/pagination.cjs +1 -1
  284. package/dist/pagination.d.ts +36 -12
  285. package/dist/pagination.d.ts.map +1 -1
  286. package/dist/pagination.js +208 -281
  287. package/dist/popover.cjs +1 -1
  288. package/dist/popover.d.ts +1 -1
  289. package/dist/popover.d.ts.map +1 -1
  290. package/dist/popover.js +34 -45
  291. package/dist/progress.cjs +1 -1
  292. package/dist/progress.d.ts +139 -17
  293. package/dist/progress.d.ts.map +1 -1
  294. package/dist/progress.js +116 -148
  295. package/dist/radio-group.cjs +1 -1
  296. package/dist/radio-group.js +90 -146
  297. package/dist/rating.cjs +1 -1
  298. package/dist/rating.d.ts +80 -13
  299. package/dist/rating.d.ts.map +1 -1
  300. package/dist/rating.js +70 -65
  301. package/dist/relative-date.cjs +1 -0
  302. package/dist/relative-date.d.ts +65 -0
  303. package/dist/relative-date.d.ts.map +1 -0
  304. package/dist/relative-date.js +112 -0
  305. package/dist/resizable.cjs +1 -1
  306. package/dist/resizable.d.ts +39 -23
  307. package/dist/resizable.d.ts.map +1 -1
  308. package/dist/resizable.js +42 -44
  309. package/dist/result-count.cjs +1 -0
  310. package/dist/result-count.d.ts +110 -0
  311. package/dist/result-count.d.ts.map +1 -0
  312. package/dist/result-count.js +49 -0
  313. package/dist/route-progress.cjs +1 -1
  314. package/dist/route-progress.js +58 -102
  315. package/dist/scroll-area.cjs +1 -1
  316. package/dist/scroll-area.d.ts +9 -1
  317. package/dist/scroll-area.d.ts.map +1 -1
  318. package/dist/scroll-area.js +44 -79
  319. package/dist/select.cjs +2 -2
  320. package/dist/select.d.ts +20 -10
  321. package/dist/select.d.ts.map +1 -1
  322. package/dist/select.js +132 -236
  323. package/dist/separator.cjs +1 -1
  324. package/dist/separator.js +90 -78
  325. package/dist/sheet.cjs +1 -1
  326. package/dist/sheet.d.ts +86 -7
  327. package/dist/sheet.d.ts.map +1 -1
  328. package/dist/sheet.js +275 -235
  329. package/dist/single-select-filter.cjs +1 -0
  330. package/dist/single-select-filter.d.ts +113 -0
  331. package/dist/single-select-filter.d.ts.map +1 -0
  332. package/dist/single-select-filter.js +224 -0
  333. package/dist/skeleton.cjs +1 -1
  334. package/dist/skeleton.js +24 -38
  335. package/dist/slider.cjs +1 -1
  336. package/dist/slider.js +51 -81
  337. package/dist/sonner.cjs +1 -1
  338. package/dist/sonner.d.ts +1 -1
  339. package/dist/sonner.d.ts.map +1 -1
  340. package/dist/sonner.js +113 -137
  341. package/dist/spinner.cjs +1 -1
  342. package/dist/spinner.js +22 -31
  343. package/dist/split-layout.cjs +1 -1
  344. package/dist/split-layout.d.ts +1 -1
  345. package/dist/split-layout.js +53 -102
  346. package/dist/status.cjs +1 -0
  347. package/dist/status.d.ts +51 -0
  348. package/dist/status.d.ts.map +1 -0
  349. package/dist/status.js +60 -0
  350. package/dist/stepper.cjs +1 -1
  351. package/dist/stepper.js +184 -316
  352. package/dist/switch.cjs +1 -1
  353. package/dist/switch.js +17 -32
  354. package/dist/table.cjs +1 -1
  355. package/dist/table.d.ts +127 -13
  356. package/dist/table.d.ts.map +1 -1
  357. package/dist/table.js +170 -192
  358. package/dist/tabs.cjs +1 -1
  359. package/dist/tabs.d.ts +12 -1
  360. package/dist/tabs.d.ts.map +1 -1
  361. package/dist/tabs.js +123 -146
  362. package/dist/text-reveal-motion.cjs +1 -1
  363. package/dist/text-reveal-motion.js +307 -363
  364. package/dist/textarea.cjs +1 -1
  365. package/dist/textarea.d.ts.map +1 -1
  366. package/dist/textarea.js +23 -36
  367. package/dist/toggle-group.cjs +1 -1
  368. package/dist/toggle-group.js +43 -62
  369. package/dist/toggle.cjs +1 -1
  370. package/dist/toggle.js +34 -46
  371. package/dist/tooltip.cjs +1 -1
  372. package/dist/tooltip.d.ts +38 -36
  373. package/dist/tooltip.d.ts.map +1 -1
  374. package/dist/tooltip.js +175 -78
  375. package/dist/typography-heading.cjs +1 -1
  376. package/dist/typography-heading.js +25 -61
  377. package/dist/typography-text.cjs +1 -1
  378. package/dist/typography-text.d.ts +1 -2
  379. package/dist/typography-text.d.ts.map +1 -1
  380. package/dist/typography-text.js +27 -57
  381. package/dist/typography.cjs +1 -1
  382. package/dist/typography.d.ts +1 -1
  383. package/dist/typography.js +132 -340
  384. package/package.json +45 -46
  385. package/src/blocks/empty-state.tsx +42 -21
  386. package/src/blocks/progress-state.tsx +2 -2
  387. package/src/blocks/sidebar.tsx +111 -32
  388. package/src/components/accordion.tsx +1 -1
  389. package/src/components/alert-dialog.tsx +52 -5
  390. package/src/components/alert.tsx +16 -8
  391. package/src/components/badge.tsx +152 -3
  392. package/src/components/banner.tsx +288 -0
  393. package/src/components/brand-illustration-motif.tsx +1 -1
  394. package/src/components/breadcrumb.tsx +1 -1
  395. package/src/components/button.tsx +8 -6
  396. package/src/components/calendar.tsx +155 -9
  397. package/src/components/card.tsx +266 -26
  398. package/src/components/carousel.tsx +4 -1
  399. package/src/components/chart.tsx +664 -42
  400. package/src/components/checkbox.tsx +2 -2
  401. package/src/components/collapsible.tsx +4 -1
  402. package/src/components/combobox.tsx +42 -9
  403. package/src/components/command.tsx +10 -11
  404. package/src/components/context-menu.tsx +4 -4
  405. package/src/components/data-table.tsx +1363 -398
  406. package/src/components/date-picker.tsx +31 -4
  407. package/src/components/delta.tsx +217 -0
  408. package/src/components/drawer.tsx +5 -5
  409. package/src/components/dropdown-menu.tsx +4 -4
  410. package/src/components/field.tsx +36 -15
  411. package/src/components/global-layout.tsx +1 -1
  412. package/src/components/grid.tsx +32 -1
  413. package/src/components/info-tooltip.tsx +94 -0
  414. package/src/components/input-chip.tsx +52 -8
  415. package/src/components/input-group.tsx +247 -12
  416. package/src/components/input-otp.tsx +1 -1
  417. package/src/components/input-password.tsx +29 -11
  418. package/src/components/input.tsx +11 -2
  419. package/src/components/list.tsx +15 -3
  420. package/src/components/logo-mark.tsx +345 -0
  421. package/src/components/map.tsx +18 -20
  422. package/src/components/media-viewer.tsx +908 -0
  423. package/src/components/multi-select-filter.tsx +1046 -0
  424. package/src/components/navigation-menu.tsx +2 -2
  425. package/src/components/pagination.tsx +86 -26
  426. package/src/components/progress.tsx +281 -54
  427. package/src/components/rating.tsx +200 -74
  428. package/src/components/relative-date.tsx +238 -0
  429. package/src/components/resizable.tsx +86 -33
  430. package/src/components/result-count.tsx +253 -0
  431. package/src/components/scroll-area.tsx +31 -5
  432. package/src/components/select.tsx +37 -7
  433. package/src/components/sheet.tsx +252 -6
  434. package/src/components/single-select-filter.tsx +538 -0
  435. package/src/components/slider.tsx +2 -2
  436. package/src/components/sonner.tsx +16 -5
  437. package/src/components/split-layout.tsx +2 -2
  438. package/src/components/status.tsx +162 -0
  439. package/src/components/switch.tsx +1 -1
  440. package/src/components/table.tsx +305 -73
  441. package/src/components/tabs.tsx +94 -46
  442. package/src/components/textarea.tsx +21 -3
  443. package/src/components/toggle.tsx +2 -2
  444. package/src/components/tooltip.tsx +431 -68
  445. package/src/components/typography-text.tsx +1 -2
  446. package/src/components/typography.tsx +1 -1
  447. package/src/hooks/use-breakpoint.ts +2 -1
  448. package/src/hooks/use-filter-search-params.ts +302 -0
  449. package/src/index.ts +11 -0
  450. package/src/lib/block-illustration.tsx +5 -1
  451. package/src/lib/compose-event-handlers.ts +14 -0
  452. package/src/lib/download-file.ts +61 -0
  453. package/src/lib/empty-chip.tsx +52 -0
  454. package/src/lib/field-aria.tsx +97 -0
  455. package/src/lib/image-file-info.ts +102 -0
  456. package/src/lib/media-viewer-content.tsx +1587 -0
  457. package/src/lib/media-viewer-internal.tsx +191 -0
  458. package/src/lib/media-viewer-motion.ts +120 -0
  459. package/src/lib/motion.ts +9 -0
  460. package/src/lib/table-internal.ts +74 -0
  461. package/src/lib/use-controllable.ts +43 -0
  462. package/src/lib/utils.ts +1 -0
  463. package/src/lib/empty-chip.ts +0 -24
@@ -1,16 +1,28 @@
1
1
  "use client";
2
2
  import * as React from "react";
3
3
  import { GripVertical } from "@brightlocal/icons";
4
- import * as ResizablePrimitive from "react-resizable-panels";
4
+ import {
5
+ Group,
6
+ Panel,
7
+ Separator,
8
+ type PanelProps,
9
+ } from "react-resizable-panels";
5
10
 
6
11
  import { cn } from "@brightlocal/ui-components/lib/utils";
7
12
 
8
13
  /**
9
14
  * Props for the ResizablePanelGroup component.
10
15
  */
11
- interface ResizablePanelGroupProps extends React.ComponentProps<
12
- typeof ResizablePrimitive.PanelGroup
16
+ interface ResizablePanelGroupProps extends Omit<
17
+ React.ComponentProps<typeof Group>,
18
+ "orientation" | "elementRef"
13
19
  > {
20
+ /**
21
+ * Layout direction of the panels. Maps to `orientation` in
22
+ * react-resizable-panels 4.
23
+ * @default "horizontal"
24
+ */
25
+ direction?: "horizontal" | "vertical";
14
26
  /**
15
27
  * Data hook for automated testing
16
28
  */
@@ -27,52 +39,91 @@ interface ResizablePanelGroupProps extends React.ComponentProps<
27
39
 
28
40
  /**
29
41
  * Container for resizable panels. Manages layout direction and panel sizing.
42
+ * `ref` is the root element; use the `groupRef` prop for the imperative handle.
30
43
  */
31
44
  const ResizablePanelGroup = React.forwardRef<
32
- React.ComponentRef<typeof ResizablePrimitive.PanelGroup>,
45
+ HTMLDivElement,
33
46
  ResizablePanelGroupProps
34
- >(({ className, dataHook, trackingEl, trackingLabel, ...props }, ref) => (
35
- <ResizablePrimitive.PanelGroup
36
- ref={ref}
37
- className={cn(
38
- "flex h-full w-full data-[panel-group-direction=vertical]:flex-col",
39
- className
40
- )}
41
- data-hook={dataHook}
42
- data-slot="resizable-panel-group"
43
- data-tracking-el={trackingEl}
44
- data-tracking-label={trackingLabel}
45
- {...props}
46
- />
47
- ));
47
+ >(
48
+ (
49
+ {
50
+ className,
51
+ direction = "horizontal",
52
+ dataHook,
53
+ trackingEl,
54
+ trackingLabel,
55
+ ...props
56
+ },
57
+ ref
58
+ ) => (
59
+ <Group
60
+ className={cn("h-full w-full", className)}
61
+ data-hook={dataHook}
62
+ // v3 stamped this attribute; consumer selectors may still key off it.
63
+ data-panel-group-direction={direction}
64
+ data-slot="resizable-panel-group"
65
+ data-tracking-el={trackingEl}
66
+ data-tracking-label={trackingLabel}
67
+ elementRef={ref}
68
+ orientation={direction}
69
+ {...props}
70
+ />
71
+ )
72
+ );
48
73
 
49
74
  ResizablePanelGroup.displayName = "ResizablePanelGroup";
50
75
 
76
+ /**
77
+ * react-resizable-panels 4 reads a bare number as pixels. The DS keeps the
78
+ * previous contract: a number is a percentage of the group, a string passes
79
+ * through with its own unit ("240px", "20rem").
80
+ */
81
+ type PanelSize = number | string;
82
+
83
+ const toPercent = (size: PanelSize | undefined) =>
84
+ typeof size === "number" ? `${size}%` : size;
85
+
51
86
  /**
52
87
  * Props for the ResizablePanel component.
53
88
  */
54
- type ResizablePanelProps = React.ComponentProps<
55
- typeof ResizablePrimitive.Panel
56
- >;
89
+ type ResizablePanelProps = Omit<
90
+ PanelProps,
91
+ "defaultSize" | "minSize" | "maxSize" | "collapsedSize" | "elementRef"
92
+ > & {
93
+ /** Initial size. A number is a percentage of the group. */
94
+ defaultSize?: PanelSize;
95
+ /** Minimum size. A number is a percentage of the group. */
96
+ minSize?: PanelSize;
97
+ /** Maximum size. A number is a percentage of the group. */
98
+ maxSize?: PanelSize;
99
+ /** Size when collapsed. A number is a percentage of the group. */
100
+ collapsedSize?: PanelSize;
101
+ };
57
102
 
58
103
  /**
59
104
  * Individual resizable panel within a panel group.
105
+ * `ref` is the root element; use the `panelRef` prop for the imperative handle.
60
106
  */
61
- const ResizablePanel = React.forwardRef<
62
- React.ComponentRef<typeof ResizablePrimitive.Panel>,
63
- ResizablePanelProps
64
- >(({ ...props }, ref) => (
65
- <ResizablePrimitive.Panel ref={ref} data-slot="resizable-panel" {...props} />
66
- ));
107
+ const ResizablePanel = React.forwardRef<HTMLDivElement, ResizablePanelProps>(
108
+ ({ defaultSize, minSize, maxSize, collapsedSize, ...props }, ref) => (
109
+ <Panel
110
+ collapsedSize={toPercent(collapsedSize)}
111
+ data-slot="resizable-panel"
112
+ defaultSize={toPercent(defaultSize)}
113
+ elementRef={ref}
114
+ maxSize={toPercent(maxSize)}
115
+ minSize={toPercent(minSize)}
116
+ {...props}
117
+ />
118
+ )
119
+ );
67
120
 
68
121
  ResizablePanel.displayName = "ResizablePanel";
69
122
 
70
123
  /**
71
124
  * Props for the ResizableHandle component.
72
125
  */
73
- interface ResizableHandleProps extends React.ComponentProps<
74
- typeof ResizablePrimitive.PanelResizeHandle
75
- > {
126
+ interface ResizableHandleProps extends React.ComponentProps<typeof Separator> {
76
127
  /**
77
128
  * Show a visible drag handle indicator
78
129
  */
@@ -88,9 +139,11 @@ function ResizableHandle({
88
139
  ...props
89
140
  }: ResizableHandleProps) {
90
141
  return (
91
- <ResizablePrimitive.PanelResizeHandle
142
+ // A separator reports the axis it divides: aria-orientation="horizontal"
143
+ // is a bar across a vertical group.
144
+ <Separator
92
145
  className={cn(
93
- "bg-border focus-visible:ring-ring relative flex w-px items-center justify-center after:absolute after:inset-y-0 after:left-1/2 after:w-1 after:-translate-x-1/2 focus-visible:ring-1 focus-visible:ring-offset-1 focus-visible:outline-none data-[panel-group-direction=vertical]:h-px data-[panel-group-direction=vertical]:w-full data-[panel-group-direction=vertical]:after:left-0 data-[panel-group-direction=vertical]:after:h-1 data-[panel-group-direction=vertical]:after:w-full data-[panel-group-direction=vertical]:after:translate-x-0 data-[panel-group-direction=vertical]:after:-translate-y-1/2 [&[data-panel-group-direction=vertical]>div]:rotate-90",
146
+ "bg-border focus-visible:ring-ring relative flex w-px items-center justify-center after:absolute after:inset-y-0 after:left-1/2 after:w-1 after:-translate-x-1/2 focus-visible:ring-1 focus-visible:ring-offset-1 focus-visible:outline-none aria-[orientation=horizontal]:h-px aria-[orientation=horizontal]:w-full aria-[orientation=horizontal]:after:left-0 aria-[orientation=horizontal]:after:h-1 aria-[orientation=horizontal]:after:w-full aria-[orientation=horizontal]:after:translate-x-0 aria-[orientation=horizontal]:after:-translate-y-1/2 aria-[orientation=horizontal]:[&>div]:rotate-90",
94
147
  className
95
148
  )}
96
149
  data-slot="resizable-handle"
@@ -101,7 +154,7 @@ function ResizableHandle({
101
154
  <GripVertical size={10} />
102
155
  </div>
103
156
  )}
104
- </ResizablePrimitive.PanelResizeHandle>
157
+ </Separator>
105
158
  );
106
159
  }
107
160
 
@@ -0,0 +1,253 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+
5
+ import { Spinner } from "@brightlocal/ui-components/spinner";
6
+ import { cn } from "@brightlocal/ui-components/lib/utils";
7
+
8
+ /* ResultCount — the one count text the DS renders for a collection
9
+ (Patterns/Filtering → Where controls live, part 4). It is the screen's
10
+ ONE live region: role="status", announced once per change — the rows
11
+ themselves announce nothing. During a refetch it pairs the count with a
12
+ spinner so a change is never dimming alone; the text swap is what
13
+ announces "Updating results", then the new count — once each.
14
+
15
+ Two forms, one component: the plain form ("4 of 24 locations")
16
+ says what the filters left; the range form ("1 to 20 of 45
17
+ locations") adds where the page sits in that set. DataTablePagination and
18
+ PaginationControls render the range form, so a paged collection shows the
19
+ count once — in the toolbar or in the pagination row, never both. */
20
+
21
+ interface ResultCountBaseProps extends Omit<
22
+ React.ComponentPropsWithoutRef<"p">,
23
+ "children"
24
+ > {
25
+ /**
26
+ * Data hook for automated testing (REQUIRED)
27
+ * @example "locations-result-count"
28
+ */
29
+ dataHook: string;
30
+ /**
31
+ * Refetch in flight — the live region announces the updating message
32
+ * alone, while the previous count stays on screen (aria-hidden) beside
33
+ * the spinner. Dimming the rows is the consumer's job; this indicator is
34
+ * what makes dimming never the only signal.
35
+ * @default false
36
+ */
37
+ updating?: boolean;
38
+ /**
39
+ * Text shown beside the spinner during a refetch — and, on its own, the
40
+ * whole of what the live region announces while it is in flight.
41
+ * @default "Updating results"
42
+ */
43
+ updatingLabel?: string;
44
+ /**
45
+ * Screen-reader-only text while the collection is empty. The visible
46
+ * count hides at zero — the empty state already says it — but the live
47
+ * region still announces the result.
48
+ * @default "No results"
49
+ */
50
+ emptyLabel?: string;
51
+ /** Analytics element identifier. @default "result-count" */
52
+ trackingEl?: string;
53
+ /** Analytics label */
54
+ trackingLabel?: string;
55
+ }
56
+
57
+ /** Plain form: how many records the filters left, out of an optional total. */
58
+ interface ResultCountPlainProps extends ResultCountBaseProps {
59
+ /** How many records the collection currently shows. */
60
+ count: number;
61
+ /** The unfiltered total. Omit when it isn't cheap to know. */
62
+ total?: number;
63
+ from?: never;
64
+ to?: never;
65
+ /**
66
+ * Count text while `total` is present. Supports the `{count}` and
67
+ * `{total}` placeholders — name the records in the product's words
68
+ * ("{count} of {total} locations"). i18next's `{{count}}` form is
69
+ * accepted too, so the untranslated `t()` string can be passed straight in.
70
+ * @default "{count} of {total} results"
71
+ */
72
+ label?: string;
73
+ /**
74
+ * `label` for a total of exactly 1 — the noun follows the total ("1 of 1
75
+ * location"). Falls back to `label`, so a template without a singular keeps
76
+ * its own noun. Pair with i18next's `_one` key: `labelOne={t("count_one")}`.
77
+ * @default "{count} of {total} result"
78
+ */
79
+ labelOne?: string;
80
+ /**
81
+ * Count text while `total` is omitted. Supports the `{count}`
82
+ * placeholder.
83
+ * @default "{count} results"
84
+ */
85
+ noTotalLabel?: string;
86
+ /**
87
+ * `noTotalLabel` for a count of exactly 1 ("1 location"). Falls back to
88
+ * `noTotalLabel`.
89
+ * @default "{count} result"
90
+ */
91
+ noTotalLabelOne?: string;
92
+ rangeLabel?: never;
93
+ rangeLabelOne?: never;
94
+ }
95
+
96
+ /** Range form: which slice of the (filtered) set the current page shows. */
97
+ interface ResultCountRangeProps extends ResultCountBaseProps {
98
+ /** First record on this page (1-based). */
99
+ from: number;
100
+ /** Last record on this page. */
101
+ to: number;
102
+ /** Size of the set being paged — the filtered count, not the unfiltered one. */
103
+ total: number;
104
+ count?: never;
105
+ /**
106
+ * Range text. Supports the `{from}`, `{to}` and `{total}` placeholders —
107
+ * name the records in the product's words
108
+ * ("{from} to {to} of {total} locations"). i18next's `{{from}}` form
109
+ * is accepted too, so the untranslated `t()` string can be passed straight in.
110
+ * @default "{from} to {to} of {total} results"
111
+ */
112
+ rangeLabel?: string;
113
+ /**
114
+ * `rangeLabel` for a total of exactly 1 — the noun follows the total ("1 to
115
+ * 1 of 1 location"). Falls back to `rangeLabel`. Pair with i18next's `_one`
116
+ * key: `rangeLabelOne={t("range_one")}`.
117
+ * @default "{from} to {to} of {total} result"
118
+ */
119
+ rangeLabelOne?: string;
120
+ label?: never;
121
+ labelOne?: never;
122
+ noTotalLabel?: never;
123
+ noTotalLabelOne?: never;
124
+ }
125
+
126
+ type ResultCountProps = ResultCountPlainProps | ResultCountRangeProps;
127
+
128
+ /* `{count}` is the DS placeholder; `{{count}}` is accepted too, so an i18next
129
+ string can be handed over as-is (`label={t("locations.count")}`) and the
130
+ count fills it in, instead of a render-prop per table. Every occurrence is
131
+ replaced. */
132
+ function format(template: string, values: Record<string, number>): string {
133
+ return Object.entries(values).reduce(
134
+ (text, [key, value]) =>
135
+ text
136
+ .replaceAll(`{{${key}}}`, String(value))
137
+ .replaceAll(`{${key}}`, String(value)),
138
+ template
139
+ );
140
+ }
141
+
142
+ /**
143
+ * The collection's count as a `role="status"` live region — one per
144
+ * screen. Announces the new count once per change, "Updating results" once
145
+ * per refetch, and the empty label (screen-reader only) at zero.
146
+ */
147
+ const ResultCount = React.forwardRef<HTMLParagraphElement, ResultCountProps>(
148
+ (
149
+ {
150
+ className,
151
+ dataHook,
152
+ count,
153
+ from,
154
+ to,
155
+ total,
156
+ updating = false,
157
+ label,
158
+ labelOne,
159
+ noTotalLabel,
160
+ noTotalLabelOne,
161
+ rangeLabel,
162
+ rangeLabelOne,
163
+ updatingLabel,
164
+ emptyLabel,
165
+ trackingEl,
166
+ trackingLabel,
167
+ ...props
168
+ },
169
+ ref
170
+ ) => {
171
+ const isRange = typeof from === "number" && typeof to === "number";
172
+ const isEmpty = isRange ? total === 0 : count === 0;
173
+
174
+ /* The noun follows the last number in the sentence — the total when
175
+ there is one, the count otherwise — so that is the number that picks
176
+ the singular template. A template given without its singular keeps its
177
+ own noun rather than falling back to the English default. */
178
+ let text: string;
179
+ if (isRange) {
180
+ const template =
181
+ total === 1
182
+ ? (rangeLabelOne ?? rangeLabel ?? "{from} to {to} of {total} result")
183
+ : (rangeLabel ?? "{from} to {to} of {total} results");
184
+ text = format(template, { from, to, total: total ?? 0 });
185
+ } else if (total !== undefined) {
186
+ const template =
187
+ total === 1
188
+ ? (labelOne ?? label ?? "{count} of {total} result")
189
+ : (label ?? "{count} of {total} results");
190
+ text = format(template, { count: count ?? 0, total });
191
+ } else {
192
+ const template =
193
+ count === 1
194
+ ? (noTotalLabelOne ?? noTotalLabel ?? "{count} result")
195
+ : (noTotalLabel ?? "{count} results");
196
+ text = format(template, { count: count ?? 0 });
197
+ }
198
+
199
+ return (
200
+ <p
201
+ ref={ref}
202
+ className={cn(
203
+ "text-muted-foreground text-body-sm relative flex items-center gap-2",
204
+ className
205
+ )}
206
+ data-hook={dataHook}
207
+ data-slot="result-count"
208
+ data-tracking-el={trackingEl ?? "result-count"}
209
+ data-tracking-label={trackingLabel}
210
+ role="status"
211
+ {...props}
212
+ >
213
+ {/* The accessibility contract is "Updating results, then the new
214
+ count — once each", so while a refetch is in flight the live
215
+ region's ENTIRE accessible text is the updating message. The
216
+ previous count stays visible for continuity but is aria-hidden:
217
+ leaving it in the announced text made a screen reader re-read the
218
+ stale count with a suffix ("40 of 128 results Updating…")
219
+ instead of the documented message. */}
220
+ {updating ? (
221
+ <>
222
+ {!isEmpty && (
223
+ <span aria-hidden="true" data-slot="result-count-text">
224
+ {text}
225
+ </span>
226
+ )}
227
+ <span
228
+ className="inline-flex items-center gap-1.5"
229
+ data-slot="result-count-updating"
230
+ >
231
+ {/* No loadingLabel: the spinner stays decorative
232
+ (aria-hidden) — the region's text change is the one
233
+ announcement. */}
234
+ <Spinner size="sm" />
235
+ {updatingLabel ?? "Updating results"}
236
+ </span>
237
+ </>
238
+ ) : isEmpty ? (
239
+ <span className="sr-only" data-slot="result-count-empty">
240
+ {emptyLabel ?? "No results"}
241
+ </span>
242
+ ) : (
243
+ <span data-slot="result-count-text">{text}</span>
244
+ )}
245
+ </p>
246
+ );
247
+ }
248
+ );
249
+
250
+ ResultCount.displayName = "ResultCount";
251
+
252
+ export { ResultCount };
253
+ export type { ResultCountProps, ResultCountPlainProps, ResultCountRangeProps };
@@ -27,11 +27,19 @@ interface ScrollAreaProps extends React.ComponentProps<
27
27
  * @default "vertical"
28
28
  */
29
29
  scrollOrientation?: "vertical" | "both";
30
+ /**
31
+ * Reserves room for the vertical scrollbar beside the content once it
32
+ * overflows, so the scrollbar never draws over it.
33
+ * @default false
34
+ */
35
+ reserveScrollbarSpace?: boolean;
30
36
  }
31
37
 
32
38
  /**
33
39
  * ScrollArea provides a styled scrollable viewport with custom scrollbars.
34
- * Built on Radix UI ScrollArea primitive.
40
+ * Built on Radix UI ScrollArea primitive. Give it a fixed height (`h-72`) to
41
+ * fill a box, or a max height (`max-h-64`) to grow with its content and
42
+ * scroll once it reaches that height.
35
43
  */
36
44
  const ScrollArea = React.forwardRef<
37
45
  React.ComponentRef<typeof ScrollAreaPrimitive.Root>,
@@ -45,6 +53,7 @@ const ScrollArea = React.forwardRef<
45
53
  trackingEl,
46
54
  trackingLabel,
47
55
  scrollOrientation = "vertical",
56
+ reserveScrollbarSpace = false,
48
57
  ...props
49
58
  },
50
59
  ref
@@ -52,7 +61,14 @@ const ScrollArea = React.forwardRef<
52
61
  return (
53
62
  <ScrollAreaPrimitive.Root
54
63
  ref={ref}
55
- className={cn("relative", className)}
64
+ className={cn(
65
+ "relative",
66
+ // Pads the viewport only while the vertical scrollbar is mounted,
67
+ // which Radix does only when the content overflows
68
+ reserveScrollbarSpace &&
69
+ "[&:has(>[data-slot=scroll-area-scrollbar][data-orientation=vertical])>[data-slot=scroll-area-viewport]]:pr-3",
70
+ className
71
+ )}
56
72
  data-hook={dataHook}
57
73
  data-slot="scroll-area"
58
74
  data-tracking-el={trackingEl}
@@ -60,13 +76,23 @@ const ScrollArea = React.forwardRef<
60
76
  {...props}
61
77
  >
62
78
  <ScrollAreaPrimitive.Viewport
63
- className="focus-visible:shadow-default duration-fast size-full rounded-[inherit] p-1 transition-[color,box-shadow] ease-out outline-none"
79
+ // max-h-[inherit] lets a max height on the root bound the viewport,
80
+ // which a percentage height can't do without a fixed root height.
81
+ // Radix wraps the children in an inline `display: table; min-width:
82
+ // 100%` div, which sizes to the content's min-content and so widens
83
+ // past the container for anything with an intrinsic width (a chart
84
+ // frame, a long URL). Forcing it to a full-width block lets that
85
+ // content shrink to the container; content that is genuinely wider
86
+ // (a fixed-width table) still overflows and scrolls sideways.
87
+ className="focus-visible:shadow-default duration-fast size-full max-h-[inherit] rounded-[inherit] p-1 transition-[color,box-shadow] ease-out outline-none [&>div]:block! [&>div]:w-full [&>div]:min-w-0!"
64
88
  data-slot="scroll-area-viewport"
65
89
  tabIndex={0}
66
90
  >
67
91
  {children}
68
92
  </ScrollAreaPrimitive.Viewport>
69
- <ScrollAreaScrollbar />
93
+ {/* forceMount keeps the scrollbar mounted while the pointer is away,
94
+ so the reserved space doesn't come and go on hover */}
95
+ <ScrollAreaScrollbar forceMount={reserveScrollbarSpace || undefined} />
70
96
  {scrollOrientation === "both" && (
71
97
  <ScrollAreaScrollbar orientation="horizontal" />
72
98
  )}
@@ -125,7 +151,7 @@ const ScrollAreaScrollbar = React.forwardRef<
125
151
  <ScrollAreaPrimitive.ScrollAreaScrollbar
126
152
  ref={ref}
127
153
  className={cn(
128
- "duration-fast flex touch-none p-px transition-colors ease-out select-none",
154
+ "duration-fast flex touch-none p-px transition-[color,opacity] ease-out select-none data-[state=hidden]:opacity-0",
129
155
  orientation === "vertical" &&
130
156
  "h-full w-2.5 border-l border-l-transparent",
131
157
  orientation === "horizontal" &&
@@ -184,9 +184,9 @@ const selectTriggerVariants = cva([
184
184
  "bg-neutral-50 border-neutral-300",
185
185
  "dark:bg-white/5 dark:border-white/15",
186
186
 
187
- // Typography — text-body (16px) per the Figma form-field example: the select
188
- // sits beside inputs and both are values, so both are body (DS-921).
189
- "text-body text-foreground",
187
+ // Typography — text-field (DS-992): label-sized like every field value, with
188
+ // the built-in 16px touch bump that keeps iOS Safari from zooming on focus.
189
+ "text-field text-foreground",
190
190
 
191
191
  // Text truncation for long content (shadcn default behavior)
192
192
  "[&>span]:block [&>span]:truncate",
@@ -202,7 +202,7 @@ const selectTriggerVariants = cva([
202
202
  "data-[state=open]:border-ring",
203
203
 
204
204
  // Disabled state
205
- "disabled:cursor-not-allowed disabled:opacity-50",
205
+ "cursor-pointer disabled:cursor-not-allowed disabled:opacity-50",
206
206
 
207
207
  // Icon styles (chevron and custom icons)
208
208
  "[&_svg]:pointer-events-none [&_svg]:shrink-0",
@@ -223,6 +223,16 @@ interface SelectTriggerProps extends React.ComponentProps<
223
223
  * @default "Select an option"
224
224
  */
225
225
  selectLabel?: string;
226
+ /**
227
+ * The visible labels this select can show, rendered invisibly inside the
228
+ * trigger so it always reserves the width of the widest one. Keeps the
229
+ * trigger — and the row around it, e.g. a CardToolbar filter row — from
230
+ * resizing and reflowing when the selection changes (DS-989). Include the
231
+ * placeholder if it can be the longest. For long option lists pass just a
232
+ * handful of the longest labels — every entry renders a hidden span.
233
+ * @example <SelectTrigger reserveValues={["All ratings", "4 stars and up"]}>
234
+ */
235
+ reserveValues?: React.ReactNode[];
226
236
  }
227
237
 
228
238
  // ============================================================================
@@ -239,6 +249,7 @@ function SelectTrigger({
239
249
  dataHook,
240
250
  error,
241
251
  selectLabel,
252
+ reserveValues,
242
253
  ...props
243
254
  }: SelectTriggerProps) {
244
255
  // Support both error prop and aria-invalid for backwards compatibility
@@ -267,8 +278,27 @@ function SelectTrigger({
267
278
  data-hook={dataHook}
268
279
  data-slot="select-trigger"
269
280
  >
270
- {/* Select value or placeholder */}
271
- {children}
281
+ {/* Select value or placeholder. With reserveValues, every possible
282
+ label is stacked invisibly in the same grid cell, so the trigger
283
+ keeps the width of the widest one and never reflows its row. */}
284
+ {reserveValues?.length ? (
285
+ // The base [&>span]:block would beat .grid on specificity, flowing the
286
+ // sizer spans inline and summing their widths — hence !grid.
287
+ <span className="!grid min-w-0 text-left" data-slot="select-reserve">
288
+ {reserveValues.map((value, i) => (
289
+ <span
290
+ key={i}
291
+ aria-hidden="true"
292
+ className="invisible col-start-1 row-start-1 truncate"
293
+ >
294
+ {value}
295
+ </span>
296
+ ))}
297
+ <span className="col-start-1 row-start-1 truncate">{children}</span>
298
+ </span>
299
+ ) : (
300
+ children
301
+ )}
272
302
 
273
303
  {/* Dropdown chevron (right side) */}
274
304
  <SelectPrimitive.Icon asChild>
@@ -420,7 +450,7 @@ interface SelectItemProps extends React.ComponentProps<
420
450
  function SelectItem({ className, children, hint, ...props }: SelectItemProps) {
421
451
  const itemStyles = cn(
422
452
  // Base layout
423
- "relative flex w-full cursor-default select-none items-center gap-2",
453
+ "relative flex w-full cursor-pointer select-none items-center gap-2",
424
454
  "rounded py-1.5 pl-2 pr-8",
425
455
 
426
456
  // Typography