@brightlocal/ui-components 3.2.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (434) hide show
  1. package/AI_USAGE.md +10 -0
  2. package/README.md +3 -1
  3. package/component-meta.json +1458 -380
  4. package/deprecations.json +44 -0
  5. package/dist/_virtual/_rolldown/runtime.cjs +1 -0
  6. package/dist/accordion.cjs +1 -1
  7. package/dist/accordion.js +73 -102
  8. package/dist/alert-dialog.cjs +1 -1
  9. package/dist/alert-dialog.d.ts +6 -4
  10. package/dist/alert-dialog.d.ts.map +1 -1
  11. package/dist/alert-dialog.js +85 -133
  12. package/dist/alert.cjs +1 -1
  13. package/dist/alert.d.ts +4 -4
  14. package/dist/alert.d.ts.map +1 -1
  15. package/dist/alert.js +106 -168
  16. package/dist/aspect-ratio.cjs +1 -1
  17. package/dist/aspect-ratio.js +13 -16
  18. package/dist/avatar.cjs +1 -1
  19. package/dist/avatar.js +30 -45
  20. package/dist/badge.cjs +1 -1
  21. package/dist/badge.d.ts +23 -1
  22. package/dist/badge.d.ts.map +1 -1
  23. package/dist/badge.js +90 -91
  24. package/dist/banner.cjs +1 -1
  25. package/dist/banner.js +102 -148
  26. package/dist/blocks/empty-state.cjs +1 -1
  27. package/dist/blocks/empty-state.d.ts +20 -3
  28. package/dist/blocks/empty-state.d.ts.map +1 -1
  29. package/dist/blocks/empty-state.js +73 -140
  30. package/dist/blocks/input-list.cjs +2 -2
  31. package/dist/blocks/input-list.d.ts +2 -2
  32. package/dist/blocks/input-list.d.ts.map +1 -1
  33. package/dist/blocks/input-list.js +138 -178
  34. package/dist/blocks/progress-state.cjs +1 -1
  35. package/dist/blocks/progress-state.js +223 -347
  36. package/dist/blocks/sidebar.cjs +1 -1
  37. package/dist/blocks/sidebar.d.ts +11 -6
  38. package/dist/blocks/sidebar.d.ts.map +1 -1
  39. package/dist/blocks/sidebar.js +763 -1092
  40. package/dist/brand-illustration-motif.cjs +1 -1
  41. package/dist/brand-illustration-motif.js +40 -61
  42. package/dist/breadcrumb.cjs +1 -1
  43. package/dist/breadcrumb.js +62 -102
  44. package/dist/button-group.cjs +1 -1
  45. package/dist/button-group.js +23 -31
  46. package/dist/button.cjs +1 -1
  47. package/dist/button.d.ts +4 -2
  48. package/dist/button.d.ts.map +1 -1
  49. package/dist/button.js +149 -189
  50. package/dist/calendar.cjs +1 -1
  51. package/dist/calendar.d.ts +87 -3
  52. package/dist/calendar.d.ts.map +1 -1
  53. package/dist/calendar.js +116 -173
  54. package/dist/callout.cjs +1 -1
  55. package/dist/callout.js +73 -96
  56. package/dist/card.cjs +1 -1
  57. package/dist/card.d.ts +10 -4
  58. package/dist/card.d.ts.map +1 -1
  59. package/dist/card.js +233 -316
  60. package/dist/carousel.cjs +1 -1
  61. package/dist/carousel.d.ts +3 -3
  62. package/dist/carousel.d.ts.map +1 -1
  63. package/dist/carousel.js +174 -268
  64. package/dist/centred-layout.cjs +1 -1
  65. package/dist/centred-layout.js +27 -48
  66. package/dist/chart-empty.cjs +1 -1
  67. package/dist/chart-empty.js +18 -27
  68. package/dist/chart.cjs +7 -7
  69. package/dist/chart.d.ts +23 -13
  70. package/dist/chart.d.ts.map +1 -1
  71. package/dist/chart.js +445 -651
  72. package/dist/checkbox.cjs +1 -1
  73. package/dist/checkbox.js +36 -69
  74. package/dist/chip.cjs +1 -1
  75. package/dist/chip.js +116 -173
  76. package/dist/collapsible.cjs +1 -1
  77. package/dist/collapsible.d.ts.map +1 -1
  78. package/dist/collapsible.js +35 -41
  79. package/dist/combobox.cjs +3 -3
  80. package/dist/combobox.d.ts +14 -4
  81. package/dist/combobox.d.ts.map +1 -1
  82. package/dist/combobox.js +439 -638
  83. package/dist/command.cjs +1 -1
  84. package/dist/command.d.ts.map +1 -1
  85. package/dist/command.js +273 -420
  86. package/dist/context-menu.cjs +1 -1
  87. package/dist/context-menu.d.ts +5 -5
  88. package/dist/context-menu.d.ts.map +1 -1
  89. package/dist/context-menu.js +121 -191
  90. package/dist/data-table.cjs +1 -1
  91. package/dist/data-table.d.ts +280 -129
  92. package/dist/data-table.d.ts.map +1 -1
  93. package/dist/data-table.js +687 -948
  94. package/dist/date-picker.cjs +1 -1
  95. package/dist/date-picker.d.ts +15 -4
  96. package/dist/date-picker.d.ts.map +1 -1
  97. package/dist/date-picker.js +156 -231
  98. package/dist/delta.cjs +1 -0
  99. package/dist/delta.d.ts +79 -0
  100. package/dist/delta.d.ts.map +1 -0
  101. package/dist/delta.js +62 -0
  102. package/dist/description-list.cjs +1 -0
  103. package/dist/description-list.d.ts +142 -0
  104. package/dist/description-list.d.ts.map +1 -0
  105. package/dist/description-list.js +173 -0
  106. package/dist/description.cjs +1 -1
  107. package/dist/description.js +11 -20
  108. package/dist/dialog.cjs +1 -1
  109. package/dist/dialog.d.ts +1 -1
  110. package/dist/dialog.d.ts.map +1 -1
  111. package/dist/dialog.js +76 -116
  112. package/dist/drawer.cjs +1 -1
  113. package/dist/drawer.d.ts +11 -11
  114. package/dist/drawer.d.ts.map +1 -1
  115. package/dist/drawer.js +76 -134
  116. package/dist/dropdown-menu.cjs +1 -1
  117. package/dist/dropdown-menu.d.ts +6 -6
  118. package/dist/dropdown-menu.d.ts.map +1 -1
  119. package/dist/dropdown-menu.js +179 -300
  120. package/dist/field.cjs +1 -1
  121. package/dist/field.d.ts +9 -9
  122. package/dist/field.d.ts.map +1 -1
  123. package/dist/field.js +166 -286
  124. package/dist/global-layout.cjs +1 -1
  125. package/dist/global-layout.js +203 -342
  126. package/dist/grid.cjs +1 -1
  127. package/dist/grid.js +16 -29
  128. package/dist/header.cjs +1 -1
  129. package/dist/header.js +21 -38
  130. package/dist/height-transition.cjs +1 -1
  131. package/dist/height-transition.js +38 -55
  132. package/dist/hooks/use-breakpoint.cjs +1 -1
  133. package/dist/hooks/use-breakpoint.js +9 -9
  134. package/dist/hooks/use-debounce.cjs +1 -1
  135. package/dist/hooks/use-debounce.js +12 -11
  136. package/dist/hooks/use-delayed-pending.cjs +1 -1
  137. package/dist/hooks/use-delayed-pending.js +8 -9
  138. package/dist/hooks/use-filter-search-params.cjs +1 -0
  139. package/dist/hooks/use-filter-search-params.d.ts +93 -0
  140. package/dist/hooks/use-filter-search-params.d.ts.map +1 -0
  141. package/dist/hooks/use-filter-search-params.js +122 -0
  142. package/dist/hooks/use-mobile.cjs +1 -1
  143. package/dist/hooks/use-mobile.js +6 -6
  144. package/dist/hooks/use-overlay-pointer-lock.cjs +1 -1
  145. package/dist/hooks/use-overlay-pointer-lock.js +8 -9
  146. package/dist/hooks/use-prefers-reduced-motion.cjs +1 -1
  147. package/dist/hooks/use-prefers-reduced-motion.js +5 -8
  148. package/dist/hover-card.cjs +1 -1
  149. package/dist/hover-card.d.ts +1 -1
  150. package/dist/hover-card.d.ts.map +1 -1
  151. package/dist/hover-card.js +30 -62
  152. package/dist/index.cjs +1 -1
  153. package/dist/index.d.ts +7 -0
  154. package/dist/index.d.ts.map +1 -1
  155. package/dist/index.js +658 -614
  156. package/dist/info-tooltip.cjs +1 -1
  157. package/dist/info-tooltip.js +22 -36
  158. package/dist/input-chip.cjs +1 -1
  159. package/dist/input-chip.d.ts +32 -3
  160. package/dist/input-chip.d.ts.map +1 -1
  161. package/dist/input-chip.js +181 -230
  162. package/dist/input-group.cjs +1 -1
  163. package/dist/input-group.js +174 -221
  164. package/dist/input-otp.cjs +1 -1
  165. package/dist/input-otp.d.ts +3 -3
  166. package/dist/input-otp.d.ts.map +1 -1
  167. package/dist/input-otp.js +102 -146
  168. package/dist/input-password.cjs +1 -1
  169. package/dist/input-password.d.ts +12 -16
  170. package/dist/input-password.d.ts.map +1 -1
  171. package/dist/input-password.js +139 -171
  172. package/dist/input.cjs +1 -1
  173. package/dist/input.d.ts.map +1 -1
  174. package/dist/input.js +51 -73
  175. package/dist/label.cjs +1 -1
  176. package/dist/label.js +20 -38
  177. package/dist/lib/block-illustration.cjs +1 -1
  178. package/dist/lib/block-illustration.d.ts +1 -1
  179. package/dist/lib/block-illustration.d.ts.map +1 -1
  180. package/dist/lib/block-illustration.js +16 -18
  181. package/dist/lib/compose-event-handlers.cjs +1 -0
  182. package/dist/lib/compose-event-handlers.d.ts +9 -0
  183. package/dist/lib/compose-event-handlers.d.ts.map +1 -0
  184. package/dist/lib/compose-event-handlers.js +8 -0
  185. package/dist/lib/download-file.cjs +1 -0
  186. package/dist/lib/download-file.d.ts +14 -0
  187. package/dist/lib/download-file.d.ts.map +1 -0
  188. package/dist/lib/download-file.js +40 -0
  189. package/dist/lib/empty-canvas.cjs +1 -1
  190. package/dist/lib/empty-canvas.js +28 -56
  191. package/dist/lib/empty-chip.cjs +1 -1
  192. package/dist/lib/empty-chip.d.ts +14 -3
  193. package/dist/lib/empty-chip.d.ts.map +1 -1
  194. package/dist/lib/empty-chip.js +15 -11
  195. package/dist/lib/field-aria.cjs +1 -0
  196. package/dist/lib/field-aria.d.ts +34 -0
  197. package/dist/lib/field-aria.d.ts.map +1 -0
  198. package/dist/lib/field-aria.js +52 -0
  199. package/dist/lib/image-file-info.cjs +1 -0
  200. package/dist/lib/image-file-info.d.ts +25 -0
  201. package/dist/lib/image-file-info.d.ts.map +1 -0
  202. package/dist/lib/image-file-info.js +67 -0
  203. package/dist/lib/media-viewer-content.cjs +1 -0
  204. package/dist/lib/media-viewer-content.d.ts +102 -0
  205. package/dist/lib/media-viewer-content.d.ts.map +1 -0
  206. package/dist/lib/media-viewer-content.js +650 -0
  207. package/dist/lib/media-viewer-internal.cjs +1 -0
  208. package/dist/lib/media-viewer-internal.d.ts +98 -0
  209. package/dist/lib/media-viewer-internal.d.ts.map +1 -0
  210. package/dist/lib/media-viewer-internal.js +61 -0
  211. package/dist/lib/media-viewer-motion.cjs +1 -0
  212. package/dist/lib/media-viewer-motion.d.ts +40 -0
  213. package/dist/lib/media-viewer-motion.d.ts.map +1 -0
  214. package/dist/lib/media-viewer-motion.js +37 -0
  215. package/dist/lib/motion.cjs +1 -1
  216. package/dist/lib/motion.d.ts +8 -0
  217. package/dist/lib/motion.d.ts.map +1 -1
  218. package/dist/lib/motion.js +14 -8
  219. package/dist/lib/optical-center.cjs +1 -1
  220. package/dist/lib/optical-center.d.ts +1 -1
  221. package/dist/lib/optical-center.d.ts.map +1 -1
  222. package/dist/lib/optical-center.js +12 -5
  223. package/dist/lib/spring-settle.cjs +1 -1
  224. package/dist/lib/spring-settle.js +1 -1
  225. package/dist/lib/table-internal.cjs +1 -0
  226. package/dist/lib/table-internal.d.ts +62 -0
  227. package/dist/lib/table-internal.d.ts.map +1 -0
  228. package/dist/lib/table-internal.js +18 -0
  229. package/dist/lib/use-controllable.cjs +1 -0
  230. package/dist/lib/use-controllable.d.ts +12 -0
  231. package/dist/lib/use-controllable.d.ts.map +1 -0
  232. package/dist/lib/use-controllable.js +15 -0
  233. package/dist/lib/use-dev-warning.cjs +1 -1
  234. package/dist/lib/utils.cjs +1 -1
  235. package/dist/lib/utils.js +26 -33
  236. package/dist/link.cjs +1 -1
  237. package/dist/link.d.ts +1 -1
  238. package/dist/link.js +78 -124
  239. package/dist/list.cjs +1 -1
  240. package/dist/list.d.ts +224 -39
  241. package/dist/list.d.ts.map +1 -1
  242. package/dist/list.js +323 -171
  243. package/dist/loading.cjs +1 -1
  244. package/dist/loading.js +124 -151
  245. package/dist/logo-mark.cjs +1 -0
  246. package/dist/logo-mark.d.ts +79 -0
  247. package/dist/logo-mark.d.ts.map +1 -0
  248. package/dist/logo-mark.js +219 -0
  249. package/dist/logo.cjs +1 -1
  250. package/dist/logo.d.ts +1 -1
  251. package/dist/logo.d.ts.map +1 -1
  252. package/dist/logo.js +51 -87
  253. package/dist/map.cjs +1 -1
  254. package/dist/map.d.ts.map +1 -1
  255. package/dist/map.js +390 -586
  256. package/dist/media-empty.cjs +1 -1
  257. package/dist/media-empty.js +27 -42
  258. package/dist/media-viewer.cjs +1 -0
  259. package/dist/media-viewer.d.ts +224 -0
  260. package/dist/media-viewer.d.ts.map +1 -0
  261. package/dist/media-viewer.js +295 -0
  262. package/dist/menubar.cjs +1 -1
  263. package/dist/menubar.d.ts +14 -14
  264. package/dist/menubar.d.ts.map +1 -1
  265. package/dist/menubar.js +130 -267
  266. package/dist/multi-select-filter.cjs +1 -1
  267. package/dist/multi-select-filter.d.ts +9 -1
  268. package/dist/multi-select-filter.d.ts.map +1 -1
  269. package/dist/multi-select-filter.js +357 -446
  270. package/dist/navigation-menu.cjs +1 -1
  271. package/dist/navigation-menu.js +108 -172
  272. package/dist/pagination.cjs +1 -1
  273. package/dist/pagination.d.ts +36 -12
  274. package/dist/pagination.d.ts.map +1 -1
  275. package/dist/pagination.js +208 -281
  276. package/dist/popover.cjs +1 -1
  277. package/dist/popover.d.ts +1 -1
  278. package/dist/popover.d.ts.map +1 -1
  279. package/dist/popover.js +34 -45
  280. package/dist/progress.cjs +1 -1
  281. package/dist/progress.d.ts +17 -2
  282. package/dist/progress.d.ts.map +1 -1
  283. package/dist/progress.js +116 -162
  284. package/dist/radio-group.cjs +1 -1
  285. package/dist/radio-group.js +90 -146
  286. package/dist/rating.cjs +1 -1
  287. package/dist/rating.d.ts +80 -13
  288. package/dist/rating.d.ts.map +1 -1
  289. package/dist/rating.js +70 -65
  290. package/dist/relative-date.cjs +1 -1
  291. package/dist/relative-date.d.ts.map +1 -1
  292. package/dist/relative-date.js +73 -89
  293. package/dist/resizable.cjs +1 -1
  294. package/dist/resizable.d.ts +39 -23
  295. package/dist/resizable.d.ts.map +1 -1
  296. package/dist/resizable.js +42 -44
  297. package/dist/result-count.cjs +1 -0
  298. package/dist/result-count.d.ts +110 -0
  299. package/dist/result-count.d.ts.map +1 -0
  300. package/dist/result-count.js +49 -0
  301. package/dist/route-progress.cjs +1 -1
  302. package/dist/route-progress.js +59 -102
  303. package/dist/scroll-area.cjs +1 -1
  304. package/dist/scroll-area.d.ts +9 -1
  305. package/dist/scroll-area.d.ts.map +1 -1
  306. package/dist/scroll-area.js +44 -79
  307. package/dist/select.cjs +2 -2
  308. package/dist/select.d.ts +10 -10
  309. package/dist/select.d.ts.map +1 -1
  310. package/dist/select.js +118 -238
  311. package/dist/separator.cjs +1 -1
  312. package/dist/separator.js +90 -78
  313. package/dist/sheet.cjs +1 -1
  314. package/dist/sheet.d.ts +8 -5
  315. package/dist/sheet.d.ts.map +1 -1
  316. package/dist/sheet.js +250 -317
  317. package/dist/single-select-filter.cjs +1 -1
  318. package/dist/single-select-filter.d.ts +32 -0
  319. package/dist/single-select-filter.d.ts.map +1 -1
  320. package/dist/single-select-filter.js +201 -203
  321. package/dist/skeleton.cjs +1 -1
  322. package/dist/skeleton.js +24 -38
  323. package/dist/slider.cjs +1 -1
  324. package/dist/slider.js +51 -81
  325. package/dist/sonner.cjs +1 -1
  326. package/dist/sonner.d.ts +1 -1
  327. package/dist/sonner.d.ts.map +1 -1
  328. package/dist/sonner.js +101 -125
  329. package/dist/spinner.cjs +1 -1
  330. package/dist/spinner.js +22 -31
  331. package/dist/split-layout.cjs +1 -1
  332. package/dist/split-layout.js +52 -101
  333. package/dist/status.cjs +1 -0
  334. package/dist/status.d.ts +51 -0
  335. package/dist/status.d.ts.map +1 -0
  336. package/dist/status.js +60 -0
  337. package/dist/stepper.cjs +1 -1
  338. package/dist/stepper.js +184 -316
  339. package/dist/switch.cjs +1 -1
  340. package/dist/switch.js +17 -32
  341. package/dist/table.cjs +1 -1
  342. package/dist/table.d.ts +103 -30
  343. package/dist/table.d.ts.map +1 -1
  344. package/dist/table.js +170 -209
  345. package/dist/tabs.cjs +1 -1
  346. package/dist/tabs.d.ts.map +1 -1
  347. package/dist/tabs.js +102 -147
  348. package/dist/text-reveal-motion.cjs +1 -1
  349. package/dist/text-reveal-motion.js +307 -363
  350. package/dist/textarea.cjs +1 -1
  351. package/dist/textarea.d.ts.map +1 -1
  352. package/dist/textarea.js +22 -35
  353. package/dist/toggle-group.cjs +1 -1
  354. package/dist/toggle-group.js +43 -62
  355. package/dist/toggle.cjs +1 -1
  356. package/dist/toggle.js +34 -46
  357. package/dist/tooltip.cjs +1 -1
  358. package/dist/tooltip.d.ts +2 -2
  359. package/dist/tooltip.d.ts.map +1 -1
  360. package/dist/tooltip.js +157 -249
  361. package/dist/typography-heading.cjs +1 -1
  362. package/dist/typography-heading.js +25 -61
  363. package/dist/typography-text.cjs +1 -1
  364. package/dist/typography-text.js +27 -57
  365. package/dist/typography.cjs +1 -1
  366. package/dist/typography.js +132 -340
  367. package/package.json +47 -47
  368. package/src/blocks/empty-state.tsx +34 -18
  369. package/src/blocks/input-list.tsx +14 -9
  370. package/src/blocks/sidebar.tsx +86 -31
  371. package/src/components/accordion.tsx +1 -1
  372. package/src/components/alert-dialog.tsx +4 -2
  373. package/src/components/badge.tsx +127 -15
  374. package/src/components/breadcrumb.tsx +1 -1
  375. package/src/components/button.tsx +8 -6
  376. package/src/components/calendar.tsx +155 -9
  377. package/src/components/card.tsx +63 -10
  378. package/src/components/carousel.tsx +4 -1
  379. package/src/components/chart.tsx +151 -17
  380. package/src/components/checkbox.tsx +1 -1
  381. package/src/components/collapsible.tsx +4 -1
  382. package/src/components/combobox.tsx +40 -7
  383. package/src/components/command.tsx +9 -10
  384. package/src/components/context-menu.tsx +4 -4
  385. package/src/components/data-table.tsx +619 -237
  386. package/src/components/date-picker.tsx +31 -4
  387. package/src/components/delta.tsx +217 -0
  388. package/src/components/description-list.tsx +445 -0
  389. package/src/components/drawer.tsx +5 -5
  390. package/src/components/dropdown-menu.tsx +4 -4
  391. package/src/components/field.tsx +36 -15
  392. package/src/components/global-layout.tsx +1 -1
  393. package/src/components/input-chip.tsx +51 -7
  394. package/src/components/input-group.tsx +1 -1
  395. package/src/components/input-password.tsx +15 -19
  396. package/src/components/input.tsx +10 -1
  397. package/src/components/list.tsx +695 -72
  398. package/src/components/logo-mark.tsx +345 -0
  399. package/src/components/map.tsx +18 -20
  400. package/src/components/media-viewer.tsx +908 -0
  401. package/src/components/multi-select-filter.tsx +255 -121
  402. package/src/components/navigation-menu.tsx +2 -2
  403. package/src/components/pagination.tsx +86 -26
  404. package/src/components/progress.tsx +91 -23
  405. package/src/components/rating.tsx +200 -74
  406. package/src/components/relative-date.tsx +19 -11
  407. package/src/components/resizable.tsx +86 -33
  408. package/src/components/result-count.tsx +253 -0
  409. package/src/components/scroll-area.tsx +31 -5
  410. package/src/components/select.tsx +2 -2
  411. package/src/components/sheet.tsx +14 -4
  412. package/src/components/single-select-filter.tsx +136 -41
  413. package/src/components/slider.tsx +2 -2
  414. package/src/components/status.tsx +162 -0
  415. package/src/components/switch.tsx +1 -1
  416. package/src/components/table.tsx +278 -106
  417. package/src/components/tabs.tsx +1 -0
  418. package/src/components/textarea.tsx +20 -2
  419. package/src/components/toggle.tsx +2 -2
  420. package/src/components/tooltip.tsx +11 -20
  421. package/src/hooks/use-filter-search-params.ts +302 -0
  422. package/src/index.ts +7 -0
  423. package/src/lib/compose-event-handlers.ts +14 -0
  424. package/src/lib/download-file.ts +61 -0
  425. package/src/lib/empty-chip.tsx +52 -0
  426. package/src/lib/field-aria.tsx +97 -0
  427. package/src/lib/image-file-info.ts +102 -0
  428. package/src/lib/media-viewer-content.tsx +1587 -0
  429. package/src/lib/media-viewer-internal.tsx +191 -0
  430. package/src/lib/media-viewer-motion.ts +120 -0
  431. package/src/lib/motion.ts +9 -0
  432. package/src/lib/table-internal.ts +74 -0
  433. package/src/lib/use-controllable.ts +43 -0
  434. package/src/lib/empty-chip.ts +0 -24
@@ -0,0 +1,445 @@
1
+ "use client";
2
+
3
+ import * as React from "react";
4
+ import { cva } from "class-variance-authority";
5
+
6
+ import { cn } from "@brightlocal/ui-components/lib/utils";
7
+
8
+ /* -------------------------------------------------------------------------------------------------
9
+ * Context
10
+ * -----------------------------------------------------------------------------------------------*/
11
+
12
+ /**
13
+ * How each term sits against its value.
14
+ * - `inline` — term column beside the value, every value starts on the same line
15
+ * - `stacked` — term above the value
16
+ * - `responsive` — stacked below the `sm` breakpoint, inline from `sm` up
17
+ * - `container` — stacked until the nearest `@container` is `@md` (28rem) wide,
18
+ * for lists in narrow panels on wide screens
19
+ * - `grid` — stacked items flowing into as many columns as fit (facts, plan limits)
20
+ */
21
+ export type DescriptionListLayout =
22
+ "inline" | "stacked" | "responsive" | "container" | "grid";
23
+
24
+ /**
25
+ * Where the value sits in an `inline` row (other layouts ignore it).
26
+ * - `start` — values line up in a column after the term
27
+ * - `end` — values pushed to the row's end (receipts, totals, counts)
28
+ */
29
+ export type DescriptionListAlign = "start" | "end";
30
+
31
+ type DescriptionListContextValue = {
32
+ layout: DescriptionListLayout;
33
+ align: DescriptionListAlign;
34
+ /** Rows share one auto-sized term column (subgrid). */
35
+ autoTerm: boolean;
36
+ };
37
+
38
+ const DescriptionListContext = React.createContext<DescriptionListContextValue>(
39
+ { layout: "inline", align: "start", autoTerm: false }
40
+ );
41
+
42
+ /* -------------------------------------------------------------------------------------------------
43
+ * Variants
44
+ * -----------------------------------------------------------------------------------------------*/
45
+
46
+ const descriptionListVariants = cva("min-w-0", {
47
+ variants: {
48
+ layout: {
49
+ inline: "flex flex-col",
50
+ stacked: "flex flex-col",
51
+ responsive: "flex flex-col",
52
+ container: "flex flex-col",
53
+ // Columns at least 8rem wide, as many as fit: a plan's limits or a record's
54
+ // facts reflow from one column on a phone to a full row on desktop.
55
+ grid: "grid grid-cols-[repeat(auto-fill,minmax(8rem,1fr))] gap-x-6 gap-y-4",
56
+ },
57
+ divided: {
58
+ // Lines between rows only: no padding above the first row or below the
59
+ // last, so the list sits at its container's own spacing.
60
+ true: [
61
+ "divide-border divide-y",
62
+ "[&>[data-slot=description-list-item]]:py-3",
63
+ "[&>[data-slot=description-list-item]:first-child]:pt-0",
64
+ "[&>[data-slot=description-list-item]:last-child]:pb-0",
65
+ ],
66
+ false: "",
67
+ },
68
+ },
69
+ compoundVariants: [
70
+ { layout: "inline", divided: false, className: "gap-3" },
71
+ { layout: "stacked", divided: false, className: "gap-3" },
72
+ { layout: "responsive", divided: false, className: "gap-3" },
73
+ { layout: "container", divided: false, className: "gap-3" },
74
+ ],
75
+ defaultVariants: {
76
+ layout: "inline",
77
+ divided: false,
78
+ },
79
+ });
80
+
81
+ const descriptionListItemVariants = cva("flex min-w-0", {
82
+ variants: {
83
+ layout: {
84
+ inline: "flex-row items-baseline gap-4",
85
+ stacked: "flex-col gap-1",
86
+ responsive: "flex-col gap-1 sm:flex-row sm:items-baseline sm:gap-4",
87
+ container: "flex-col gap-1 @md:flex-row @md:items-baseline @md:gap-4",
88
+ grid: "flex-col gap-1",
89
+ },
90
+ },
91
+ defaultVariants: {
92
+ layout: "inline",
93
+ },
94
+ });
95
+
96
+ const descriptionListTermVariants = cva(
97
+ "text-muted-foreground text-body-sm shrink-0",
98
+ {
99
+ variants: {
100
+ layout: {
101
+ inline: "w-(--dl-term-width)",
102
+ stacked: "",
103
+ responsive: "sm:w-(--dl-term-width)",
104
+ container: "@md:w-(--dl-term-width)",
105
+ grid: "",
106
+ },
107
+ },
108
+ defaultVariants: {
109
+ layout: "inline",
110
+ },
111
+ }
112
+ );
113
+
114
+ /* An auto-width term column has to be shared by every row, so the list
115
+ becomes a two-column grid and each row a subgrid of it. Only where the term
116
+ sits beside its value: below the breakpoint the row still stacks. */
117
+ const autoTermListClasses: Partial<Record<DescriptionListLayout, string>> = {
118
+ inline: "grid grid-cols-[max-content_1fr] gap-x-4",
119
+ responsive: "sm:grid sm:grid-cols-[max-content_1fr] sm:gap-x-4",
120
+ container: "@md:grid @md:grid-cols-[max-content_1fr] @md:gap-x-4",
121
+ };
122
+
123
+ const autoTermItemClasses: Partial<Record<DescriptionListLayout, string>> = {
124
+ inline: "col-span-2 grid grid-cols-subgrid",
125
+ responsive: "sm:col-span-2 sm:grid sm:grid-cols-subgrid",
126
+ container: "@md:col-span-2 @md:grid @md:grid-cols-subgrid",
127
+ };
128
+
129
+ /** Layouts where the term can sit beside its value. */
130
+ const SIDE_BY_SIDE: ReadonlyArray<DescriptionListLayout> = [
131
+ "inline",
132
+ "responsive",
133
+ "container",
134
+ ];
135
+
136
+ /* -------------------------------------------------------------------------------------------------
137
+ * DescriptionList
138
+ * -----------------------------------------------------------------------------------------------*/
139
+
140
+ /**
141
+ * Props for the DescriptionList root.
142
+ * Extends native `<dl>` props with layout options and testing/analytics attributes.
143
+ */
144
+ export interface DescriptionListProps extends React.ComponentProps<"dl"> {
145
+ /**
146
+ * Data hook for automated testing (required).
147
+ * @example "review-details", "plan-limits"
148
+ */
149
+ dataHook: string;
150
+ /**
151
+ * Tracking element identifier for analytics.
152
+ * @default "description-list"
153
+ */
154
+ trackingEl?: string;
155
+ /**
156
+ * Tracking label for analytics context.
157
+ */
158
+ trackingLabel?: string;
159
+ /**
160
+ * How each term sits against its value.
161
+ * @default "inline"
162
+ */
163
+ layout?: DescriptionListLayout;
164
+ /**
165
+ * Width of the term column when the term sits beside its value. A number is
166
+ * pixels; `"auto"` sizes the column to the longest term.
167
+ * Ignored by `stacked` and `grid`, and by `align="end"` on `inline`.
168
+ * @default 128
169
+ */
170
+ termWidth?: number | "auto";
171
+ /**
172
+ * Where the value sits in an `inline` row. `end` pushes values to the row's
173
+ * end, for receipts and totals; other layouts ignore it.
174
+ * @default "start"
175
+ */
176
+ align?: DescriptionListAlign;
177
+ /**
178
+ * Draw a hairline between items. Not used by the `grid` layout.
179
+ * @default false
180
+ */
181
+ divided?: boolean;
182
+ }
183
+
184
+ /**
185
+ * Label-and-value pairs describing one record: the details of a review, the
186
+ * read view of a settings card, a receipt. Renders a semantic `<dl>`.
187
+ *
188
+ * For several records compared by the same attributes, use Table instead.
189
+ *
190
+ * @example
191
+ * ```tsx
192
+ * <DescriptionList dataHook="review-details">
193
+ * <DescriptionListItem>
194
+ * <DescriptionListTerm>Source</DescriptionListTerm>
195
+ * <DescriptionListDetails>Google</DescriptionListDetails>
196
+ * </DescriptionListItem>
197
+ * </DescriptionList>
198
+ * ```
199
+ */
200
+ const DescriptionList = React.forwardRef<
201
+ HTMLDListElement,
202
+ DescriptionListProps
203
+ >(
204
+ (
205
+ {
206
+ className,
207
+ style,
208
+ layout = "inline",
209
+ termWidth = 128,
210
+ align = "start",
211
+ divided = false,
212
+ dataHook,
213
+ trackingEl,
214
+ trackingLabel,
215
+ ...props
216
+ },
217
+ ref
218
+ ) => {
219
+ const sideBySide =
220
+ SIDE_BY_SIDE.includes(layout) &&
221
+ !(align === "end" && layout === "inline");
222
+ const autoTerm = sideBySide && termWidth === "auto";
223
+ const context = React.useMemo(
224
+ () => ({ layout, align, autoTerm }),
225
+ [layout, align, autoTerm]
226
+ );
227
+
228
+ return (
229
+ <DescriptionListContext.Provider value={context}>
230
+ <dl
231
+ ref={ref}
232
+ className={cn(
233
+ descriptionListVariants({
234
+ layout,
235
+ divided: layout === "grid" ? false : divided,
236
+ }),
237
+ autoTerm && autoTermListClasses[layout],
238
+ className
239
+ )}
240
+ data-align={align}
241
+ data-hook={dataHook}
242
+ data-layout={layout}
243
+ data-slot="description-list"
244
+ data-tracking-el={trackingEl || "description-list"}
245
+ data-tracking-label={trackingLabel}
246
+ style={
247
+ {
248
+ ...(typeof termWidth === "number" && {
249
+ "--dl-term-width": `${termWidth}px`,
250
+ }),
251
+ ...style,
252
+ } as React.CSSProperties
253
+ }
254
+ {...props}
255
+ />
256
+ </DescriptionListContext.Provider>
257
+ );
258
+ }
259
+ );
260
+ DescriptionList.displayName = "DescriptionList";
261
+
262
+ /* -------------------------------------------------------------------------------------------------
263
+ * DescriptionListItem
264
+ * -----------------------------------------------------------------------------------------------*/
265
+
266
+ /**
267
+ * Props for DescriptionListItem — one term and its value.
268
+ */
269
+ export interface DescriptionListItemProps extends React.ComponentProps<"div"> {
270
+ /**
271
+ * Data hook for automated testing.
272
+ */
273
+ dataHook?: string;
274
+ }
275
+
276
+ /**
277
+ * One term and its value. Renders a `<div>`, the grouping element HTML allows
278
+ * inside a `<dl>`.
279
+ */
280
+ const DescriptionListItem = React.forwardRef<
281
+ HTMLDivElement,
282
+ DescriptionListItemProps
283
+ >(({ className, dataHook, ...props }, ref) => {
284
+ const { layout, align, autoTerm } = React.useContext(DescriptionListContext);
285
+ const endAligned = align === "end" && layout === "inline";
286
+
287
+ return (
288
+ <div
289
+ ref={ref}
290
+ className={cn(
291
+ descriptionListItemVariants({ layout }),
292
+ endAligned && "justify-between",
293
+ autoTerm && autoTermItemClasses[layout],
294
+ className
295
+ )}
296
+ data-hook={dataHook}
297
+ data-slot="description-list-item"
298
+ {...props}
299
+ />
300
+ );
301
+ });
302
+ DescriptionListItem.displayName = "DescriptionListItem";
303
+
304
+ /* -------------------------------------------------------------------------------------------------
305
+ * DescriptionListTerm
306
+ * -----------------------------------------------------------------------------------------------*/
307
+
308
+ /**
309
+ * Props for DescriptionListTerm — the label.
310
+ */
311
+ export interface DescriptionListTermProps extends React.ComponentProps<"dt"> {
312
+ /**
313
+ * Data hook for automated testing.
314
+ */
315
+ dataHook?: string;
316
+ }
317
+
318
+ /**
319
+ * The label of a pair. Muted, `text-body-sm`.
320
+ */
321
+ const DescriptionListTerm = React.forwardRef<
322
+ HTMLElement,
323
+ DescriptionListTermProps
324
+ >(({ className, dataHook, ...props }, ref) => {
325
+ const { layout, align, autoTerm } = React.useContext(DescriptionListContext);
326
+
327
+ return (
328
+ <dt
329
+ ref={ref}
330
+ className={cn(
331
+ // The fixed width applies only when the term sits beside its value in
332
+ // a fixed column; an end-aligned or auto-width term sizes to its text.
333
+ descriptionListTermVariants({
334
+ layout: align === "end" || autoTerm ? "stacked" : layout,
335
+ }),
336
+ className
337
+ )}
338
+ data-hook={dataHook}
339
+ data-slot="description-list-term"
340
+ {...props}
341
+ />
342
+ );
343
+ });
344
+ DescriptionListTerm.displayName = "DescriptionListTerm";
345
+
346
+ /* -------------------------------------------------------------------------------------------------
347
+ * DescriptionListDetails
348
+ * -----------------------------------------------------------------------------------------------*/
349
+
350
+ /**
351
+ * Props for DescriptionListDetails — the value.
352
+ */
353
+ export interface DescriptionListDetailsProps extends React.ComponentProps<"dd"> {
354
+ /**
355
+ * Data hook for automated testing.
356
+ */
357
+ dataHook?: string;
358
+ /**
359
+ * Text colour of the value. Use `muted` for an empty value ("Not set").
360
+ * @default "foreground"
361
+ */
362
+ color?: "foreground" | "muted";
363
+ }
364
+
365
+ /**
366
+ * The value of a pair: text, a Badge, a Rating, a Link or an icon with text.
367
+ * Long values wrap.
368
+ */
369
+ const DescriptionListDetails = React.forwardRef<
370
+ HTMLElement,
371
+ DescriptionListDetailsProps
372
+ >(({ className, color = "foreground", dataHook, ...props }, ref) => {
373
+ const { layout, align } = React.useContext(DescriptionListContext);
374
+ const endAligned = align === "end" && layout === "inline";
375
+
376
+ return (
377
+ <dd
378
+ ref={ref}
379
+ className={cn(
380
+ "text-body-sm min-w-0 flex-1 break-words",
381
+ color === "muted" ? "text-muted-foreground" : "text-foreground",
382
+ endAligned && "text-right tabular-nums",
383
+ className
384
+ )}
385
+ data-hook={dataHook}
386
+ data-slot="description-list-details"
387
+ {...props}
388
+ />
389
+ );
390
+ });
391
+ DescriptionListDetails.displayName = "DescriptionListDetails";
392
+
393
+ /* -------------------------------------------------------------------------------------------------
394
+ * DescriptionListIconText
395
+ * -----------------------------------------------------------------------------------------------*/
396
+
397
+ /**
398
+ * Props for DescriptionListIconText — an icon or logo beside a text value.
399
+ */
400
+ export interface DescriptionListIconTextProps extends React.ComponentProps<"span"> {
401
+ /**
402
+ * The icon or logo, sized to 16px.
403
+ */
404
+ icon: React.ReactNode;
405
+ }
406
+
407
+ /**
408
+ * An icon or logo beside a text value, such as a review source and its name.
409
+ */
410
+ const DescriptionListIconText = React.forwardRef<
411
+ HTMLSpanElement,
412
+ DescriptionListIconTextProps
413
+ >(({ className, icon, children, ...props }, ref) => (
414
+ <span
415
+ ref={ref}
416
+ className={cn(
417
+ "inline-flex max-w-full items-center gap-2 align-bottom [&_svg:not([class*='size-'])]:size-4",
418
+ className
419
+ )}
420
+ data-slot="description-list-icon-text"
421
+ {...props}
422
+ >
423
+ <span
424
+ aria-hidden="true"
425
+ className="inline-flex size-4 shrink-0 items-center justify-center"
426
+ >
427
+ {icon}
428
+ </span>
429
+ <span className="min-w-0">{children}</span>
430
+ </span>
431
+ ));
432
+ DescriptionListIconText.displayName = "DescriptionListIconText";
433
+
434
+ /* -------------------------------------------------------------------------------------------------
435
+ * Exports
436
+ * -----------------------------------------------------------------------------------------------*/
437
+
438
+ export {
439
+ DescriptionList,
440
+ DescriptionListItem,
441
+ DescriptionListTerm,
442
+ DescriptionListDetails,
443
+ DescriptionListIconText,
444
+ descriptionListVariants,
445
+ };
@@ -111,8 +111,8 @@ function DrawerContent({
111
111
  <DrawerPrimitive.Content
112
112
  className={cn(
113
113
  "group/drawer-content bg-background border-border fixed z-50 flex h-auto flex-col",
114
- "data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80vh] data-[vaul-drawer-direction=top]:rounded-b-[10px] data-[vaul-drawer-direction=top]:border-b",
115
- "data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80vh] data-[vaul-drawer-direction=bottom]:rounded-t-[10px] data-[vaul-drawer-direction=bottom]:border-t",
114
+ "data-[vaul-drawer-direction=top]:inset-x-0 data-[vaul-drawer-direction=top]:top-0 data-[vaul-drawer-direction=top]:mb-24 data-[vaul-drawer-direction=top]:max-h-[80svh] data-[vaul-drawer-direction=top]:rounded-b-[10px] data-[vaul-drawer-direction=top]:border-b",
115
+ "data-[vaul-drawer-direction=bottom]:inset-x-0 data-[vaul-drawer-direction=bottom]:bottom-0 data-[vaul-drawer-direction=bottom]:mt-24 data-[vaul-drawer-direction=bottom]:max-h-[80svh] data-[vaul-drawer-direction=bottom]:rounded-t-[10px] data-[vaul-drawer-direction=bottom]:border-t",
116
116
  "data-[vaul-drawer-direction=right]:inset-y-0 data-[vaul-drawer-direction=right]:right-0 data-[vaul-drawer-direction=right]:w-3/4 data-[vaul-drawer-direction=right]:border-l data-[vaul-drawer-direction=right]:sm:max-w-sm",
117
117
  "data-[vaul-drawer-direction=left]:inset-y-0 data-[vaul-drawer-direction=left]:left-0 data-[vaul-drawer-direction=left]:w-3/4 data-[vaul-drawer-direction=left]:border-r data-[vaul-drawer-direction=left]:sm:max-w-sm",
118
118
  className
@@ -139,7 +139,7 @@ function DrawerHeader({ className, ...props }: React.ComponentProps<"div">) {
139
139
  return (
140
140
  <div
141
141
  className={cn(
142
- "mx-auto flex w-full max-w-sm flex-col gap-1.5 p-4 text-center sm:text-left",
142
+ "flex w-full shrink-0 flex-col gap-1.5 p-4 text-center sm:text-left",
143
143
  className
144
144
  )}
145
145
  data-slot="drawer-header"
@@ -157,7 +157,7 @@ function DrawerBody({ className, ...props }: React.ComponentProps<"div">) {
157
157
  return (
158
158
  <div
159
159
  className={cn(
160
- "mx-auto w-full max-w-sm px-4",
160
+ "min-h-0 w-full flex-1 overflow-x-hidden overflow-y-auto px-4",
161
161
  "mt-4 group-has-[[data-slot=drawer-header]]/drawer-content:mt-0",
162
162
  className
163
163
  )}
@@ -176,7 +176,7 @@ function DrawerFooter({ className, ...props }: React.ComponentProps<"div">) {
176
176
  return (
177
177
  <div
178
178
  className={cn(
179
- "mx-auto mt-auto flex w-full max-w-sm flex-col gap-2 p-4",
179
+ "mt-auto flex w-full shrink-0 flex-col gap-2 p-4",
180
180
  className
181
181
  )}
182
182
  data-slot="drawer-footer"
@@ -194,7 +194,7 @@ const DropdownMenuItem = React.forwardRef<
194
194
  ref={ref}
195
195
  className={cn(
196
196
  [
197
- "relative flex cursor-default items-center gap-2 self-stretch select-none",
197
+ "relative flex cursor-pointer items-center gap-2 self-stretch select-none",
198
198
  "text-label rounded-sm px-2 py-1.5 outline-hidden",
199
199
  // Text truncation for child text elements
200
200
  "[&>span]:overflow-hidden [&>span]:text-ellipsis [&>span]:whitespace-nowrap",
@@ -262,7 +262,7 @@ const DropdownMenuCheckboxItem = React.forwardRef<
262
262
  checked={checked}
263
263
  className={cn(
264
264
  [
265
- "relative flex cursor-default items-center gap-2 select-none",
265
+ "relative flex cursor-pointer items-center gap-2 select-none",
266
266
  "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
267
267
  "focus:bg-accent focus:text-accent-foreground",
268
268
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
@@ -334,7 +334,7 @@ const DropdownMenuRadioItem = React.forwardRef<
334
334
  ref={ref}
335
335
  className={cn(
336
336
  [
337
- "relative flex cursor-default items-center gap-2 select-none",
337
+ "relative flex cursor-pointer items-center gap-2 select-none",
338
338
  "text-label rounded-sm py-1.5 pr-2 pl-8 outline-hidden",
339
339
  "focus:bg-accent focus:text-accent-foreground",
340
340
  "data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
@@ -496,7 +496,7 @@ const DropdownMenuSubTrigger = React.forwardRef<
496
496
  ref={ref}
497
497
  className={cn(
498
498
  [
499
- "flex cursor-default items-center gap-2 select-none",
499
+ "flex cursor-pointer items-center gap-2 select-none data-[disabled]:cursor-not-allowed",
500
500
  "text-label rounded-sm px-2 py-1.5 outline-hidden",
501
501
  "focus:bg-accent focus:text-accent-foreground",
502
502
  "data-[state=open]:bg-accent data-[state=open]:text-accent-foreground",
@@ -7,6 +7,7 @@ import { AlertCircle, type LucideProps } from "@brightlocal/icons";
7
7
  import { cn } from "@brightlocal/ui-components/lib/utils";
8
8
  import { Description } from "./description";
9
9
  import { Label, type LabelProps } from "@brightlocal/ui-components/label";
10
+ import { FieldAriaProvider, useFieldAriaRegistration } from "../lib/field-aria";
10
11
 
11
12
  function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
12
13
  return (
@@ -188,21 +189,23 @@ function Field({
188
189
  ...props
189
190
  }: FieldProps) {
190
191
  return (
191
- <div
192
- className={cn(
193
- fieldVariants({ orientation, variant }),
194
- align === "end" &&
195
- orientation === "horizontal" &&
196
- "grid-cols-[1fr_auto]",
197
- className
198
- )}
199
- data-hook={dataHook}
200
- data-orientation={orientation}
201
- data-slot="field"
202
- data-variant={variant}
203
- role="group"
204
- {...props}
205
- />
192
+ <FieldAriaProvider>
193
+ <div
194
+ className={cn(
195
+ fieldVariants({ orientation, variant }),
196
+ align === "end" &&
197
+ orientation === "horizontal" &&
198
+ "grid-cols-[1fr_auto]",
199
+ className
200
+ )}
201
+ data-hook={dataHook}
202
+ data-orientation={orientation}
203
+ data-slot="field"
204
+ data-variant={variant}
205
+ role="group"
206
+ {...props}
207
+ />
208
+ </FieldAriaProvider>
206
209
  );
207
210
  }
208
211
 
@@ -277,8 +280,15 @@ interface FieldDescriptionProps extends React.ComponentProps<"p"> {
277
280
  function FieldDescription({
278
281
  className,
279
282
  dataHook,
283
+ id: idProp,
280
284
  ...props
281
285
  }: FieldDescriptionProps) {
286
+ // The hint registers its id with the enclosing Field so a text control can
287
+ // point aria-describedby at it without the consumer wiring it by hand.
288
+ const generatedId = React.useId();
289
+ const id = idProp ?? generatedId;
290
+ useFieldAriaRegistration("description", id, true);
291
+
282
292
  return (
283
293
  <Description
284
294
  className={cn(
@@ -290,6 +300,7 @@ function FieldDescription({
290
300
  )}
291
301
  data-hook={dataHook}
292
302
  data-slot="field-description"
303
+ id={id}
293
304
  {...props}
294
305
  />
295
306
  );
@@ -427,6 +438,7 @@ function FieldError({
427
438
  dataHook,
428
439
  children,
429
440
  errors,
441
+ id: idProp,
430
442
  ...props
431
443
  }: FieldErrorProps) {
432
444
  // Filter out undefined errors and those without messages
@@ -436,6 +448,13 @@ function FieldError({
436
448
 
437
449
  const hasMessage = Boolean(children) || Boolean(errorMessages?.length);
438
450
 
451
+ // While a message is on screen its id is registered with the enclosing
452
+ // Field, so a text control points aria-describedby at it automatically. An
453
+ // explicit `id` is kept, so existing hand-wiring keeps working.
454
+ const generatedId = React.useId();
455
+ const id = idProp ?? generatedId;
456
+ useFieldAriaRegistration("error", id, hasMessage);
457
+
439
458
  // Screen readers only announce live-region content that arrives *after* the
440
459
  // region is in the accessibility tree. Consumers typically mount FieldError
441
460
  // together with the message, so when a message appears client-side the
@@ -454,6 +473,7 @@ function FieldError({
454
473
 
455
474
  React.useEffect(() => {
456
475
  if (!hasMessage) {
476
+ // eslint-disable-next-line react-hooks/set-state-in-effect -- derived live-region latch; refactor tracked in DS-1070
457
477
  setDefer(true);
458
478
  setAnnounced(false);
459
479
  } else if (defer) {
@@ -486,6 +506,7 @@ function FieldError({
486
506
  className={baseStyles}
487
507
  data-hook={dataHook}
488
508
  data-slot="field-error"
509
+ id={id}
489
510
  role="status"
490
511
  {...props}
491
512
  >
@@ -54,7 +54,7 @@ const GlobalLayout = React.forwardRef<HTMLDivElement, GlobalLayoutProps>(
54
54
  // sidebar from the viewport edge and make its 100dvh height
55
55
  // overflow, so the page-level scroll region drops it.
56
56
  className={cn(
57
- "h-dvh w-full [&>[data-radix-scroll-area-viewport]]:p-0! [&>[data-radix-scroll-area-viewport]>div]:block! [&>[data-radix-scroll-area-viewport]>div]:min-w-0!",
57
+ "h-dvh w-full [&>[data-radix-scroll-area-viewport]]:p-0!",
58
58
  className
59
59
  )}
60
60
  dataHook={`${dataHook}-scroll`}