@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,20 +1,43 @@
1
1
  "use client";
2
2
 
3
3
  import * as React from "react";
4
- import * as TooltipPrimitive from "@radix-ui/react-tooltip";
4
+ import * as PopoverPrimitive from "@radix-ui/react-popover";
5
+ import { Slot } from "@radix-ui/react-slot";
5
6
 
7
+ import { composeEventHandlers } from "../lib/compose-event-handlers";
6
8
  import {
7
9
  cn,
8
10
  FLOATING_CONTENT_ANIMATION,
9
11
  } from "@brightlocal/ui-components/lib/utils";
10
12
 
11
- interface TooltipProviderProps extends React.ComponentProps<
12
- typeof TooltipPrimitive.Provider
13
- > {
13
+ /* -------------------------------- Provider -------------------------------- */
14
+
15
+ interface TooltipProviderProps {
16
+ /**
17
+ * The duration in ms to wait before showing the tooltip.
18
+ * @default 0
19
+ */
14
20
  delayDuration?: number;
21
+ /**
22
+ * The duration in ms to skip the delay when moving between tooltips.
23
+ * @default 0
24
+ */
15
25
  skipDelayDuration?: number;
26
+ children: React.ReactNode;
27
+ }
28
+
29
+ interface TooltipProviderContextValue {
30
+ delayDuration: number;
31
+ skipDelayDuration: number;
16
32
  }
17
33
 
34
+ const TooltipProviderContext = React.createContext<TooltipProviderContextValue>(
35
+ {
36
+ delayDuration: 0,
37
+ skipDelayDuration: 0,
38
+ }
39
+ );
40
+
18
41
  /**
19
42
  * TooltipProvider - Wraps your application or a section of it to provide shared tooltip configuration.
20
43
  *
@@ -34,22 +57,83 @@ interface TooltipProviderProps extends React.ComponentProps<
34
57
  function TooltipProvider({
35
58
  delayDuration = 0,
36
59
  skipDelayDuration = 0,
37
- ...props
60
+ children,
38
61
  }: TooltipProviderProps) {
62
+ const value = React.useMemo(
63
+ () => ({ delayDuration, skipDelayDuration }),
64
+ [delayDuration, skipDelayDuration]
65
+ );
39
66
  return (
40
- <TooltipPrimitive.Provider
41
- delayDuration={delayDuration}
42
- skipDelayDuration={skipDelayDuration}
43
- {...props}
44
- />
67
+ <TooltipProviderContext.Provider value={value}>
68
+ {children}
69
+ </TooltipProviderContext.Provider>
45
70
  );
46
71
  }
47
72
 
73
+ /* -------------------------------- Helpers --------------------------------- */
74
+
75
+ /** Grace period (ms) before a hover-opened tooltip closes after the pointer leaves. */
76
+ const HOVER_CLOSE_GRACE_MS = 200;
77
+
78
+ /* ----------------------------- Tooltip context ----------------------------- */
79
+
80
+ /**
81
+ * How the currently open tooltip was opened. Decides which signals may close it:
82
+ * - `hover` — pointer enter/leave, keyboard focus/blur, the hover grace timer.
83
+ * - `touch` — opened by a tap; stays open (so its text can be selected and
84
+ * copied) until the trigger is tapped again, something outside is
85
+ * tapped, or Escape is pressed.
86
+ */
87
+ type TooltipInteractionMode = "hover" | "touch";
88
+
89
+ interface TooltipContextValue {
90
+ open: boolean;
91
+ tooltipId: string;
92
+ triggerRef: React.RefObject<HTMLElement | null>;
93
+ onTriggerPointerEnter: (e: React.PointerEvent) => void;
94
+ onTriggerPointerLeave: (e: React.PointerEvent) => void;
95
+ onTriggerPointerDown: (e: React.PointerEvent) => void;
96
+ onTriggerPointerCancel: () => void;
97
+ onTriggerClick: () => void;
98
+ onTriggerFocus: () => void;
99
+ onTriggerBlur: () => void;
100
+ onContentPointerEnter: () => void;
101
+ onContentPointerLeave: (e: React.PointerEvent) => void;
102
+ onContentInteractOutside: (
103
+ e: Parameters<
104
+ NonNullable<
105
+ React.ComponentProps<
106
+ typeof PopoverPrimitive.Content
107
+ >["onInteractOutside"]
108
+ >
109
+ >[0]
110
+ ) => void;
111
+ }
112
+
113
+ const TooltipContext = React.createContext<TooltipContextValue | null>(null);
114
+
115
+ function useTooltipContext() {
116
+ const ctx = React.useContext(TooltipContext);
117
+ if (!ctx) {
118
+ throw new Error("Tooltip components must be used within <Tooltip>");
119
+ }
120
+ return ctx;
121
+ }
122
+
123
+ /* ------------------------------ Tooltip root ------------------------------- */
124
+
48
125
  /**
49
- * Tooltip - Displays a popup with additional information when hovering over an element.
126
+ * Tooltip - Displays a popup with additional information.
127
+ *
128
+ * Toggletip behaviour by input type:
129
+ * - **Mouse / pen / keyboard**: opens on hover or focus, closes when the pointer
130
+ * leaves (after a short grace period so the pointer can move onto the content)
131
+ * or focus moves away.
132
+ * - **Touch**: a tap toggles it. While open it ignores hover/blur signals so the
133
+ * text can be long-pressed and copied; it closes on a second tap of the
134
+ * trigger, a tap outside, or Escape.
50
135
  *
51
136
  * @example
52
- * // Basic usage (requires TooltipProvider wrapper):
53
137
  * <Tooltip>
54
138
  * <TooltipTrigger asChild>
55
139
  * <Button>Hover me</Button>
@@ -60,97 +144,358 @@ function TooltipProvider({
60
144
  * </Tooltip>
61
145
  *
62
146
  * @remarks
63
- * This component must be used within a TooltipProvider. Wrap your app or component tree
64
- * with TooltipProvider once at the top level for optimal performance and UX when using
65
- * multiple tooltips.
147
+ * Wrap your app once in a TooltipProvider to share `delayDuration` across all
148
+ * tooltips. Without one the provider defaults (no delay) apply.
66
149
  */
67
150
  function Tooltip({
68
- ...props
69
- }: React.ComponentProps<typeof TooltipPrimitive.Root>) {
70
- return <TooltipPrimitive.Root {...props} />;
151
+ open: controlledOpen,
152
+ defaultOpen = false,
153
+ onOpenChange,
154
+ children,
155
+ }: React.ComponentProps<typeof PopoverPrimitive.Root>) {
156
+ const { delayDuration } = React.useContext(TooltipProviderContext);
157
+ const [uncontrolledOpen, setUncontrolledOpen] = React.useState(
158
+ defaultOpen ?? false
159
+ );
160
+ const isControlled = controlledOpen !== undefined;
161
+ const open = isControlled ? controlledOpen : uncontrolledOpen;
162
+
163
+ const hoverTimeout = React.useRef<ReturnType<typeof setTimeout>>(undefined);
164
+ const delayTimer = React.useRef<ReturnType<typeof setTimeout>>(undefined);
165
+ const triggerRef = React.useRef<HTMLElement | null>(null);
166
+ /** Input mode of the current (or most recent) open; reset to hover on close. */
167
+ const mode = React.useRef<TooltipInteractionMode>("hover");
168
+ /**
169
+ * Pointer type of a press on the trigger that hasn't produced its click yet.
170
+ * Focus fired by that press must not open the tooltip (touch: the click
171
+ * toggles; mouse: hover already did), only a real keyboard focus may.
172
+ */
173
+ const pendingPress = React.useRef<"touch" | "mouse" | null>(null);
174
+ const tooltipId = React.useId();
175
+
176
+ const setOpen = React.useCallback(
177
+ (value: boolean) => {
178
+ if (!value) mode.current = "hover";
179
+ if (!isControlled) setUncontrolledOpen(value);
180
+ onOpenChange?.(value);
181
+ },
182
+ [isControlled, onOpenChange]
183
+ );
184
+
185
+ const clearTimers = React.useCallback(() => {
186
+ if (hoverTimeout.current !== undefined) {
187
+ clearTimeout(hoverTimeout.current);
188
+ hoverTimeout.current = undefined;
189
+ }
190
+ if (delayTimer.current !== undefined) {
191
+ clearTimeout(delayTimer.current);
192
+ delayTimer.current = undefined;
193
+ }
194
+ }, []);
195
+
196
+ React.useEffect(() => clearTimers, [clearTimers]);
197
+
198
+ const openFromHover = React.useCallback(() => {
199
+ clearTimers();
200
+ if (mode.current === "touch") {
201
+ // A tap already owns this tooltip; hover/focus must not restart its timers.
202
+ if (open) return;
203
+ // A tap that never opened it (a controlled `open` held it shut) leaves no
204
+ // owner behind — hover/focus take over again.
205
+ mode.current = "hover";
206
+ }
207
+ if (delayDuration > 0) {
208
+ delayTimer.current = setTimeout(() => setOpen(true), delayDuration);
209
+ } else {
210
+ setOpen(true);
211
+ }
212
+ }, [clearTimers, delayDuration, open, setOpen]);
213
+
214
+ const closeFromHover = React.useCallback(() => {
215
+ clearTimers();
216
+ if (mode.current === "touch" && open) return;
217
+ hoverTimeout.current = setTimeout(
218
+ () => setOpen(false),
219
+ HOVER_CLOSE_GRACE_MS
220
+ );
221
+ }, [clearTimers, open, setOpen]);
222
+
223
+ const onTriggerPointerEnter = React.useCallback(
224
+ (e: React.PointerEvent) => {
225
+ if (e.pointerType === "touch") return;
226
+ openFromHover();
227
+ },
228
+ [openFromHover]
229
+ );
230
+
231
+ const onTriggerPointerLeave = React.useCallback(
232
+ (e: React.PointerEvent) => {
233
+ if (e.pointerType === "touch") return;
234
+ // A mouse press dragged off the trigger never clicks; forget it.
235
+ pendingPress.current = null;
236
+ closeFromHover();
237
+ },
238
+ [closeFromHover]
239
+ );
240
+
241
+ // A mouse press leaves a hover-open tooltip alone (the hover is still on);
242
+ // it only matters for the focus/click that follow it.
243
+ const onTriggerPointerDown = React.useCallback((e: React.PointerEvent) => {
244
+ pendingPress.current = e.pointerType === "touch" ? "touch" : "mouse";
245
+ }, []);
246
+
247
+ // A touch that turns into a scroll never produces a click; forget it so the
248
+ // next keyboard focus isn't swallowed.
249
+ const onTriggerPointerCancel = React.useCallback(() => {
250
+ pendingPress.current = null;
251
+ }, []);
252
+
253
+ const onTriggerClick = React.useCallback(() => {
254
+ const press = pendingPress.current;
255
+ pendingPress.current = null;
256
+ if (press !== "touch") return;
257
+ clearTimers();
258
+ if (open) {
259
+ setOpen(false);
260
+ } else {
261
+ mode.current = "touch";
262
+ setOpen(true);
263
+ }
264
+ }, [clearTimers, open, setOpen]);
265
+
266
+ // Focus fired by a press (between pointerdown and click) is not an intent to
267
+ // open: on touch the click toggles, with a mouse hover already did.
268
+ const onTriggerFocus = React.useCallback(() => {
269
+ if (pendingPress.current) return;
270
+ openFromHover();
271
+ }, [openFromHover]);
272
+
273
+ const onTriggerBlur = React.useCallback(() => {
274
+ closeFromHover();
275
+ }, [closeFromHover]);
276
+
277
+ const onContentPointerEnter = React.useCallback(() => {
278
+ clearTimers();
279
+ }, [clearTimers]);
280
+
281
+ const onContentPointerLeave = React.useCallback(
282
+ (e: React.PointerEvent) => {
283
+ // A long-press to select text ends with pointercancel + pointerleave.
284
+ if (e.pointerType === "touch") return;
285
+ closeFromHover();
286
+ },
287
+ [closeFromHover]
288
+ );
289
+
290
+ // Radix treats the trigger (a Popover Anchor) as "outside" — leave trigger
291
+ // taps/focus to our own handlers so a second tap toggles instead of racing.
292
+ const onContentInteractOutside = React.useCallback<
293
+ TooltipContextValue["onContentInteractOutside"]
294
+ >((e) => {
295
+ const target = e.target;
296
+ if (target instanceof Node && triggerRef.current?.contains(target)) {
297
+ e.preventDefault();
298
+ }
299
+ }, []);
300
+
301
+ const handlePopoverOpenChange = React.useCallback(
302
+ (newOpen: boolean) => {
303
+ if (!newOpen) {
304
+ clearTimers();
305
+ setOpen(false);
306
+ }
307
+ },
308
+ [clearTimers, setOpen]
309
+ );
310
+
311
+ const contextValue = React.useMemo<TooltipContextValue>(
312
+ () => ({
313
+ open,
314
+ tooltipId,
315
+ triggerRef,
316
+ onTriggerPointerEnter,
317
+ onTriggerPointerLeave,
318
+ onTriggerPointerDown,
319
+ onTriggerPointerCancel,
320
+ onTriggerClick,
321
+ onTriggerFocus,
322
+ onTriggerBlur,
323
+ onContentPointerEnter,
324
+ onContentPointerLeave,
325
+ onContentInteractOutside,
326
+ }),
327
+ [
328
+ open,
329
+ tooltipId,
330
+ onTriggerPointerEnter,
331
+ onTriggerPointerLeave,
332
+ onTriggerPointerDown,
333
+ onTriggerPointerCancel,
334
+ onTriggerClick,
335
+ onTriggerFocus,
336
+ onTriggerBlur,
337
+ onContentPointerEnter,
338
+ onContentPointerLeave,
339
+ onContentInteractOutside,
340
+ ]
341
+ );
342
+
343
+ return (
344
+ <TooltipContext.Provider value={contextValue}>
345
+ <PopoverPrimitive.Root open={open} onOpenChange={handlePopoverOpenChange}>
346
+ {children}
347
+ </PopoverPrimitive.Root>
348
+ </TooltipContext.Provider>
349
+ );
71
350
  }
72
351
 
73
- interface TooltipTriggerProps extends React.ComponentProps<
74
- typeof TooltipPrimitive.Trigger
75
- > {
352
+ /* -------------------------------- Trigger --------------------------------- */
353
+
354
+ interface TooltipTriggerProps extends React.ComponentPropsWithoutRef<"button"> {
76
355
  /**
77
- * Data hook for automated testing, rendered as the `data-hook` attribute
78
- * (the platform test-selector contract).
79
- *
356
+ * Data hook for automated testing, rendered as the `data-hook` attribute.
80
357
  * Optional because `TooltipTrigger` is commonly used with `asChild`, where the
81
- * child element (e.g. a `Button`) already carries its own `dataHook`. When
82
- * `asChild` is set, the child's `data-hook` wins over this one.
358
+ * child element already carries its own `dataHook`.
83
359
  */
84
360
  dataHook?: string;
85
- /**
86
- * Optional analytics element identifier
87
- */
361
+ /** Optional analytics element identifier */
88
362
  trackingEl?: string;
89
- /**
90
- * Optional analytics label context
91
- */
363
+ /** Optional analytics label context */
92
364
  trackingLabel?: string;
365
+ /** Render as child element using Radix Slot */
366
+ asChild?: boolean;
93
367
  }
94
368
 
95
- const TooltipTrigger = React.forwardRef<
96
- React.ElementRef<typeof TooltipPrimitive.Trigger>,
97
- TooltipTriggerProps
98
- >(({ dataHook, trackingEl, trackingLabel, ...props }, ref) => {
99
- return (
100
- <TooltipPrimitive.Trigger
101
- ref={ref}
102
- data-hook={dataHook}
103
- data-slot="tooltip-trigger"
104
- data-tracking-el={trackingEl}
105
- data-tracking-label={trackingLabel}
106
- {...props}
107
- />
108
- );
109
- });
369
+ const TooltipTrigger = React.forwardRef<HTMLButtonElement, TooltipTriggerProps>(
370
+ (
371
+ {
372
+ dataHook,
373
+ trackingEl,
374
+ trackingLabel,
375
+ asChild,
376
+ children,
377
+ onBlur,
378
+ onClick,
379
+ onFocus,
380
+ onPointerCancel,
381
+ onPointerDown,
382
+ onPointerEnter,
383
+ onPointerLeave,
384
+ ...props
385
+ },
386
+ ref
387
+ ) => {
388
+ const {
389
+ open,
390
+ tooltipId,
391
+ triggerRef,
392
+ onTriggerPointerEnter,
393
+ onTriggerPointerLeave,
394
+ onTriggerPointerDown,
395
+ onTriggerPointerCancel,
396
+ onTriggerClick,
397
+ onTriggerFocus,
398
+ onTriggerBlur,
399
+ } = useTooltipContext();
400
+
401
+ const setRefs = React.useCallback(
402
+ (node: HTMLButtonElement | null) => {
403
+ triggerRef.current = node;
404
+ if (typeof ref === "function") ref(node);
405
+ else if (ref) ref.current = node;
406
+ },
407
+ [ref, triggerRef]
408
+ );
409
+
410
+ const Comp = asChild ? Slot : "button";
411
+
412
+ return (
413
+ <PopoverPrimitive.Anchor asChild>
414
+ <Comp
415
+ ref={setRefs}
416
+ data-slot="tooltip-trigger"
417
+ {...props}
418
+ aria-describedby={open ? tooltipId : undefined}
419
+ data-hook={dataHook}
420
+ data-tracking-el={trackingEl}
421
+ data-tracking-label={trackingLabel}
422
+ type={asChild ? undefined : "button"}
423
+ onBlur={composeEventHandlers(onBlur, onTriggerBlur)}
424
+ onClick={composeEventHandlers(onClick, onTriggerClick)}
425
+ onFocus={composeEventHandlers(onFocus, onTriggerFocus)}
426
+ onPointerCancel={composeEventHandlers(
427
+ onPointerCancel,
428
+ onTriggerPointerCancel
429
+ )}
430
+ onPointerDown={composeEventHandlers(
431
+ onPointerDown,
432
+ onTriggerPointerDown
433
+ )}
434
+ onPointerEnter={composeEventHandlers(
435
+ onPointerEnter,
436
+ onTriggerPointerEnter
437
+ )}
438
+ onPointerLeave={composeEventHandlers(
439
+ onPointerLeave,
440
+ onTriggerPointerLeave
441
+ )}
442
+ >
443
+ {children}
444
+ </Comp>
445
+ </PopoverPrimitive.Anchor>
446
+ );
447
+ }
448
+ );
110
449
 
111
450
  TooltipTrigger.displayName = "TooltipTrigger";
112
451
 
113
- interface TooltipContentProps extends React.ComponentProps<
114
- typeof TooltipPrimitive.Content
452
+ /* -------------------------------- Content --------------------------------- */
453
+
454
+ interface TooltipContentProps extends Omit<
455
+ React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>,
456
+ "onOpenAutoFocus" | "onCloseAutoFocus"
115
457
  > {
116
- /**
117
- * Required data-hook attribute for testing and analytics
118
- */
458
+ /** Required data-hook attribute for testing and analytics */
119
459
  dataHook: string;
120
- /**
121
- * Optional analytics element identifier
122
- */
460
+ /** Optional analytics element identifier */
123
461
  trackingEl?: string;
124
- /**
125
- * Optional analytics label context
126
- */
462
+ /** Optional analytics label context */
127
463
  trackingLabel?: string;
128
- /**
129
- * Hide the tooltip arrow
130
- */
464
+ /** Hide the tooltip arrow */
131
465
  hideArrow?: boolean;
132
466
  }
133
467
 
134
468
  const TooltipContent = React.forwardRef<
135
- React.ElementRef<typeof TooltipPrimitive.Content>,
469
+ React.ElementRef<typeof PopoverPrimitive.Content>,
136
470
  TooltipContentProps
137
471
  >(
138
472
  (
139
473
  {
140
474
  className,
475
+ side = "top",
141
476
  sideOffset = 0,
142
477
  dataHook,
143
478
  trackingEl,
144
479
  trackingLabel,
145
480
  hideArrow = false,
146
481
  children,
482
+ onInteractOutside,
483
+ onPointerEnter,
484
+ onPointerLeave,
147
485
  ...props
148
486
  },
149
487
  ref
150
488
  ) => {
489
+ const {
490
+ tooltipId,
491
+ onContentPointerEnter,
492
+ onContentPointerLeave,
493
+ onContentInteractOutside,
494
+ } = useTooltipContext();
495
+
151
496
  return (
152
- <TooltipPrimitive.Portal>
153
- <TooltipPrimitive.Content
497
+ <PopoverPrimitive.Portal>
498
+ <PopoverPrimitive.Content
154
499
  ref={ref}
155
500
  className={cn(
156
501
  "bg-secondary text-secondary-foreground text-body-xs z-50 w-max max-w-sm rounded-md px-3 py-1.5",
@@ -162,20 +507,38 @@ const TooltipContent = React.forwardRef<
162
507
  data-slot="tooltip-content"
163
508
  data-tracking-el={trackingEl}
164
509
  data-tracking-label={trackingLabel}
510
+ side={side}
165
511
  sideOffset={sideOffset}
512
+ onCloseAutoFocus={(e) => e.preventDefault()}
513
+ onOpenAutoFocus={(e) => e.preventDefault()}
166
514
  {...props}
515
+ role="none"
516
+ onInteractOutside={composeEventHandlers(
517
+ onInteractOutside,
518
+ onContentInteractOutside
519
+ )}
520
+ onPointerEnter={composeEventHandlers(
521
+ onPointerEnter,
522
+ onContentPointerEnter
523
+ )}
524
+ onPointerLeave={composeEventHandlers(
525
+ onPointerLeave,
526
+ onContentPointerLeave
527
+ )}
167
528
  >
168
- {children}
529
+ <span id={tooltipId} role="tooltip">
530
+ {children}
531
+ </span>
169
532
  {!hideArrow && (
170
- <TooltipPrimitive.Arrow
533
+ <PopoverPrimitive.Arrow
171
534
  className="fill-secondary"
172
535
  data-slot="tooltip-arrow"
173
536
  height={7}
174
537
  width={14}
175
538
  />
176
539
  )}
177
- </TooltipPrimitive.Content>
178
- </TooltipPrimitive.Portal>
540
+ </PopoverPrimitive.Content>
541
+ </PopoverPrimitive.Portal>
179
542
  );
180
543
  }
181
544
  );
@@ -14,8 +14,7 @@ import { cn } from "@brightlocal/ui-components/lib/utils";
14
14
  * proportional; add `tabular` where metrics sit in a column or the value
15
15
  * updates in place.
16
16
  * - `code` — Geist Mono 400 · 16/24. IDs, keys, coordinates a user copies verbatim.
17
- * Inside a sentence use the `text-code-inline` utility on a `code` element instead
18
- * (0.9em, inherits the line's height).
17
+ * Inside a sentence use `text-code-inline` on a `code` element instead (deprecated alias — 0.9em, inherits the line's height).
19
18
  *
20
19
  * There are no standalone label variants on purpose: the `text-label` /
21
20
  * `text-label-sm` tokens are reserved for control-owning components
@@ -431,7 +431,7 @@ interface TypographyInlineCodeProps
431
431
  /**
432
432
  * Inline code component for code snippets within text.
433
433
  * Displays with monospace font and muted background.
434
- * @deprecated Use `<code className="text-code-inline">` inside a sentence (0.9em, inherits the line's height — semantic type scale, DS-714).
434
+ * @deprecated Use `<code className="text-code-inline">` inside a sentence (semantic type scale, DS-714).
435
435
  */
436
436
  const TypographyInlineCode = React.forwardRef<
437
437
  HTMLElement,
@@ -3,10 +3,11 @@ import * as React from "react";
3
3
  /**
4
4
  * Breakpoint name matching design token keys from `@brightlocal/tokens/breakpoints`.
5
5
  */
6
- type Breakpoint = "sm" | "md" | "lg" | "xl" | "2xl";
6
+ type Breakpoint = "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
7
7
 
8
8
  /** Fallback values when CSS variables are not available (e.g. SSR) */
9
9
  const BREAKPOINT_FALLBACKS: Record<Breakpoint, number> = {
10
+ xs: 480,
10
11
  sm: 640,
11
12
  md: 768,
12
13
  lg: 1024,