@brightlocal/ui-components 3.1.0 → 3.2.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 (176) hide show
  1. package/README.md +6 -1
  2. package/component-meta.json +663 -38
  3. package/deprecations.json +1 -1
  4. package/dist/alert-dialog.cjs +1 -1
  5. package/dist/alert-dialog.d.ts +32 -3
  6. package/dist/alert-dialog.d.ts.map +1 -1
  7. package/dist/alert-dialog.js +61 -58
  8. package/dist/alert.cjs +1 -1
  9. package/dist/alert.d.ts.map +1 -1
  10. package/dist/alert.js +58 -57
  11. package/dist/badge.cjs +1 -1
  12. package/dist/badge.d.ts +9 -0
  13. package/dist/badge.d.ts.map +1 -1
  14. package/dist/badge.js +50 -30
  15. package/dist/banner.cjs +1 -0
  16. package/dist/banner.d.ts +81 -0
  17. package/dist/banner.d.ts.map +1 -0
  18. package/dist/banner.js +176 -0
  19. package/dist/blocks/empty-state.cjs +1 -1
  20. package/dist/blocks/empty-state.d.ts +4 -3
  21. package/dist/blocks/empty-state.d.ts.map +1 -1
  22. package/dist/blocks/empty-state.js +21 -20
  23. package/dist/blocks/progress-state.d.ts +2 -2
  24. package/dist/blocks/sidebar.cjs +1 -1
  25. package/dist/blocks/sidebar.d.ts +17 -0
  26. package/dist/blocks/sidebar.d.ts.map +1 -1
  27. package/dist/blocks/sidebar.js +8 -2
  28. package/dist/brand-illustration-motif.d.ts +1 -1
  29. package/dist/card.cjs +1 -1
  30. package/dist/card.d.ts +86 -6
  31. package/dist/card.d.ts.map +1 -1
  32. package/dist/card.js +185 -96
  33. package/dist/chart.cjs +3 -3
  34. package/dist/chart.d.ts +231 -13
  35. package/dist/chart.d.ts.map +1 -1
  36. package/dist/chart.js +466 -306
  37. package/dist/checkbox.cjs +1 -1
  38. package/dist/checkbox.d.ts +1 -1
  39. package/dist/checkbox.d.ts.map +1 -1
  40. package/dist/checkbox.js +2 -1
  41. package/dist/combobox.cjs +1 -1
  42. package/dist/combobox.js +2 -2
  43. package/dist/command.cjs +1 -1
  44. package/dist/command.js +1 -1
  45. package/dist/data-table.cjs +1 -1
  46. package/dist/data-table.d.ts +169 -22
  47. package/dist/data-table.d.ts.map +1 -1
  48. package/dist/data-table.js +695 -561
  49. package/dist/grid.d.ts +24 -1
  50. package/dist/grid.d.ts.map +1 -1
  51. package/dist/hooks/use-breakpoint.cjs +1 -1
  52. package/dist/hooks/use-breakpoint.d.ts +1 -1
  53. package/dist/hooks/use-breakpoint.d.ts.map +1 -1
  54. package/dist/hooks/use-breakpoint.js +1 -0
  55. package/dist/index.cjs +1 -1
  56. package/dist/index.d.ts +5 -0
  57. package/dist/index.d.ts.map +1 -1
  58. package/dist/index.js +593 -561
  59. package/dist/info-tooltip.cjs +1 -0
  60. package/dist/info-tooltip.d.ts +39 -0
  61. package/dist/info-tooltip.d.ts.map +1 -0
  62. package/dist/info-tooltip.js +41 -0
  63. package/dist/input-chip.cjs +1 -1
  64. package/dist/input-chip.js +1 -1
  65. package/dist/input-group.cjs +1 -1
  66. package/dist/input-group.d.ts +33 -2
  67. package/dist/input-group.d.ts.map +1 -1
  68. package/dist/input-group.js +167 -54
  69. package/dist/input-otp.cjs +1 -1
  70. package/dist/input-otp.js +9 -9
  71. package/dist/input-password.cjs +1 -1
  72. package/dist/input-password.d.ts +28 -6
  73. package/dist/input-password.d.ts.map +1 -1
  74. package/dist/input-password.js +5 -5
  75. package/dist/input.cjs +1 -1
  76. package/dist/input.js +10 -10
  77. package/dist/lib/block-illustration.cjs +1 -1
  78. package/dist/lib/block-illustration.d.ts +4 -1
  79. package/dist/lib/block-illustration.d.ts.map +1 -1
  80. package/dist/lib/block-illustration.js +12 -11
  81. package/dist/lib/utils.cjs +1 -1
  82. package/dist/lib/utils.d.ts.map +1 -1
  83. package/dist/lib/utils.js +4 -3
  84. package/dist/list.cjs +1 -1
  85. package/dist/list.js +1 -1
  86. package/dist/multi-select-filter.cjs +1 -0
  87. package/dist/multi-select-filter.d.ts +178 -0
  88. package/dist/multi-select-filter.d.ts.map +1 -0
  89. package/dist/multi-select-filter.js +463 -0
  90. package/dist/progress.cjs +1 -1
  91. package/dist/progress.d.ts +123 -16
  92. package/dist/progress.d.ts.map +1 -1
  93. package/dist/progress.js +89 -75
  94. package/dist/rating.cjs +1 -1
  95. package/dist/rating.js +18 -18
  96. package/dist/relative-date.cjs +1 -0
  97. package/dist/relative-date.d.ts +65 -0
  98. package/dist/relative-date.d.ts.map +1 -0
  99. package/dist/relative-date.js +128 -0
  100. package/dist/select.cjs +2 -2
  101. package/dist/select.d.ts +11 -1
  102. package/dist/select.d.ts.map +1 -1
  103. package/dist/select.js +97 -81
  104. package/dist/sheet.cjs +1 -1
  105. package/dist/sheet.d.ts +78 -2
  106. package/dist/sheet.d.ts.map +1 -1
  107. package/dist/sheet.js +192 -85
  108. package/dist/single-select-filter.cjs +1 -0
  109. package/dist/single-select-filter.d.ts +81 -0
  110. package/dist/single-select-filter.d.ts.map +1 -0
  111. package/dist/single-select-filter.js +226 -0
  112. package/dist/sonner.cjs +1 -1
  113. package/dist/sonner.d.ts.map +1 -1
  114. package/dist/sonner.js +22 -22
  115. package/dist/split-layout.cjs +1 -1
  116. package/dist/split-layout.d.ts +1 -1
  117. package/dist/split-layout.js +13 -13
  118. package/dist/table.cjs +1 -1
  119. package/dist/table.d.ts +45 -4
  120. package/dist/table.d.ts.map +1 -1
  121. package/dist/table.js +90 -73
  122. package/dist/tabs.cjs +1 -1
  123. package/dist/tabs.d.ts +12 -1
  124. package/dist/tabs.d.ts.map +1 -1
  125. package/dist/tabs.js +148 -126
  126. package/dist/textarea.cjs +1 -1
  127. package/dist/textarea.js +1 -1
  128. package/dist/tooltip.cjs +1 -1
  129. package/dist/tooltip.d.ts +38 -36
  130. package/dist/tooltip.d.ts.map +1 -1
  131. package/dist/tooltip.js +262 -73
  132. package/dist/typography-text.d.ts +1 -2
  133. package/dist/typography-text.d.ts.map +1 -1
  134. package/dist/typography.d.ts +1 -1
  135. package/package.json +5 -6
  136. package/src/blocks/empty-state.tsx +8 -3
  137. package/src/blocks/progress-state.tsx +2 -2
  138. package/src/blocks/sidebar.tsx +26 -2
  139. package/src/components/alert-dialog.tsx +50 -5
  140. package/src/components/alert.tsx +16 -8
  141. package/src/components/badge.tsx +40 -3
  142. package/src/components/banner.tsx +288 -0
  143. package/src/components/brand-illustration-motif.tsx +1 -1
  144. package/src/components/card.tsx +211 -24
  145. package/src/components/chart.tsx +523 -35
  146. package/src/components/checkbox.tsx +1 -1
  147. package/src/components/combobox.tsx +2 -2
  148. package/src/components/command.tsx +1 -1
  149. package/src/components/data-table.tsx +778 -195
  150. package/src/components/grid.tsx +32 -1
  151. package/src/components/info-tooltip.tsx +94 -0
  152. package/src/components/input-chip.tsx +1 -1
  153. package/src/components/input-group.tsx +246 -11
  154. package/src/components/input-otp.tsx +1 -1
  155. package/src/components/input-password.tsx +33 -11
  156. package/src/components/input.tsx +1 -1
  157. package/src/components/list.tsx +1 -1
  158. package/src/components/multi-select-filter.tsx +912 -0
  159. package/src/components/progress.tsx +190 -31
  160. package/src/components/rating.tsx +1 -1
  161. package/src/components/relative-date.tsx +230 -0
  162. package/src/components/select.tsx +35 -5
  163. package/src/components/sheet.tsx +240 -4
  164. package/src/components/single-select-filter.tsx +443 -0
  165. package/src/components/sonner.tsx +16 -5
  166. package/src/components/split-layout.tsx +2 -2
  167. package/src/components/table.tsx +71 -11
  168. package/src/components/tabs.tsx +93 -46
  169. package/src/components/textarea.tsx +1 -1
  170. package/src/components/tooltip.tsx +440 -68
  171. package/src/components/typography-text.tsx +1 -2
  172. package/src/components/typography.tsx +1 -1
  173. package/src/hooks/use-breakpoint.ts +2 -1
  174. package/src/index.ts +5 -0
  175. package/src/lib/block-illustration.tsx +5 -1
  176. package/src/lib/utils.ts +1 -0
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brightlocal/ui-components",
3
- "version": "3.1.0",
3
+ "version": "3.2.0",
4
4
  "description": "Machine-readable registry of all components in the BrightLocal Design System",
5
5
  "components": [
6
6
  {
@@ -200,7 +200,12 @@
200
200
  ],
201
201
  "compound": true,
202
202
  "dataHookRequired": true,
203
- "variants": {},
203
+ "variants": {
204
+ "variant": [
205
+ "primary",
206
+ "destructive"
207
+ ]
208
+ },
204
209
  "props": [
205
210
  "open",
206
211
  "onOpenChange"
@@ -255,6 +260,12 @@
255
260
  "export": "AlertDialog",
256
261
  "note": "Draws the assembled dialog; all sub-parts are drawn inside",
257
262
  "axes": [
263
+ {
264
+ "figma": "Variant",
265
+ "code": "variant",
266
+ "export": "AlertDialogAction",
267
+ "note": "Prop lives on AlertDialogAction; the set swaps the confirm Button instance to Primary/Destructive (DS-818)"
268
+ },
258
269
  {
259
270
  "figma": "Breakpoint",
260
271
  "exempt": "figma-only-style",
@@ -290,7 +301,7 @@
290
301
  },
291
302
  {
292
303
  "export": "AlertDialogAction",
293
- "reason": "Drawn inside the set as a Button instance"
304
+ "reason": "Drawn inside the set as a Button instance; its variant prop is the set's Variant axis"
294
305
  },
295
306
  {
296
307
  "export": "AlertDialogCancel",
@@ -427,7 +438,8 @@
427
438
  ]
428
439
  },
429
440
  "props": [
430
- "asChild"
441
+ "asChild",
442
+ "srLabel"
431
443
  ],
432
444
  "description": "Status badges and labels",
433
445
  "aliases": [
@@ -488,8 +500,54 @@
488
500
  ],
489
501
  "unmappedExports": [],
490
502
  "figmaOnly": []
503
+ },
504
+ "i18nProps": {
505
+ "Badge": {
506
+ "srLabel": "string — no default; screen-reader phrase replacing a bare numeral (\"3 active\"); ignored with asChild"
507
+ }
491
508
  }
492
509
  },
510
+ {
511
+ "name": "Banner",
512
+ "import": "@brightlocal/ui-components/banner",
513
+ "category": "feedback",
514
+ "exports": [
515
+ "Banner",
516
+ "BannerIllustration",
517
+ "BannerContent",
518
+ "BannerTitle",
519
+ "BannerDescription",
520
+ "BannerActions"
521
+ ],
522
+ "compound": true,
523
+ "dataHookRequired": true,
524
+ "variants": {
525
+ "variant": [
526
+ "sky",
527
+ "violet"
528
+ ]
529
+ },
530
+ "props": [
531
+ "variant",
532
+ "onDismiss",
533
+ "dismissLabel"
534
+ ],
535
+ "description": "Branded, dismissible invitation to an optional step — composed from BannerIllustration, BannerContent (BannerTitle, BannerDescription) and BannerActions on a highlight sky/violet surface",
536
+ "i18nProps": {
537
+ "Banner": {
538
+ "dismissLabel": "string — default: \"Dismiss\""
539
+ }
540
+ },
541
+ "whenToUse": [
542
+ "Inviting the user to an optional step that improves the page (connect an account, turn on two-factor authentication)",
543
+ "A one-off, dismissible nudge tied to the current page"
544
+ ],
545
+ "doNotUseFor": [
546
+ "something that happened — a failure, a risk, a tip (use Alert)",
547
+ "brand statements or pull-quotes (use Callout)",
548
+ "feedback after an action (use a toast / Sonner)"
549
+ ]
550
+ },
493
551
  {
494
552
  "name": "BrandIllustrationMotif",
495
553
  "import": "@brightlocal/ui-components/brand-illustration-motif",
@@ -788,7 +846,7 @@
788
846
  ],
789
847
  "doNotUseFor": [
790
848
  "on/off or single-choice selection (use ToggleGroup — it owns the selected state and keyboard model)",
791
- "quick filters over a collection (use the Lab SegmentedControl)",
849
+ "quick filters over a collection (use ToggleGroup, or Tabs variant=\"underline\" for a promoted tab row)",
792
850
  "attaching icons or buttons to a text input (use InputGroup)"
793
851
  ],
794
852
  "states": [
@@ -921,7 +979,9 @@
921
979
  "CardTitle",
922
980
  "CardAction",
923
981
  "CardDescription",
982
+ "CardToolbar",
924
983
  "CardMedia",
984
+ "CardMetric",
925
985
  "CardContent"
926
986
  ],
927
987
  "compound": true,
@@ -935,7 +995,8 @@
935
995
  ],
936
996
  "density": [
937
997
  "default",
938
- "condensed"
998
+ "condensed",
999
+ "data"
939
1000
  ],
940
1001
  "align": [
941
1002
  "left",
@@ -946,7 +1007,7 @@
946
1007
  "props": [
947
1008
  "maxWidth"
948
1009
  ],
949
- "description": "Content container with consistent styling. Full-width by default — constrain width via className (e.g., className='max-w-sm'). Supports a density prop: 'default' uses generous spacing (gap-8, py-section-md, px-section-md) for standalone cards; 'condensed' uses compact spacing (gap-3, py-3, px-3) for cards nested inside other cards as sub-sections, inline stat panels, or dense dashboard widgets. CardHeader takes align ('left' | 'center' | 'right') for header layout; CardDescription takes its own align with the same values to pin the description's text alignment when it would otherwise inherit it (e.g. centred inside a button trigger) — omitted, it inherits as before.",
1010
+ "description": "Content container with consistent styling. Full-width by default — constrain width via className (e.g., className='max-w-sm'). Supports a density prop: 'default' uses generous spacing (gap-8, py-section-md, px-section-md) for standalone cards; 'condensed' uses compact spacing (gap-3, py-3, px-3) for cards nested inside other cards as sub-sections, inline stat panels, or dense dashboard widgets; 'data' uses the report-page scale (DS-989): fixed 24px horizontal padding, a header with 16px vertical padding, 24px section spacing below it (pair with CardTitle size='small'). CardHeader's divider prop closes the header with its own full-width bottom border in every density — the header pads its bottom by the density's spacing, and flush content right after sits on the line. variant='border' uses the card surface (bg-card: white in light mode, neutral-900 in dark) so it lifts off the off-white page; variant='filled' uses the muted fill (bg-muted). For cards carrying a filter row and a data view. CardContent accepts a flush prop for edge-to-edge tables/maps inside a filled or border card (the card keeps its surface and border). CardToolbar puts the filter row (search — Input, InputGroup or DataTableSearch — capped at 360px, then filters, 8px gap; styles direct children only) in the header, for everything that narrows what the card shows; pagination stays in a DataTableToolbar beside the table; CardMetric shows a value + trend badge opposite the title. CardHeader takes align ('left' | 'center' | 'right') for header layout; CardDescription takes its own align with the same values to pin the description's text alignment when it would otherwise inherit it (e.g. centred inside a button trigger) — omitted, it inherits as before. CardHeader's sticky prop pins the header while a tall card scrolls (top offset --ds-section-padding-y-sm: 16px mobile, 24px from xl), painting the card's surface so content never shows through.",
950
1011
  "aliases": [
951
1012
  "container",
952
1013
  "panel",
@@ -958,7 +1019,8 @@
958
1019
  "Putting a box around related content (form section, detail panel, stat summary)",
959
1020
  "Dashboard widgets or sections separated from the page background",
960
1021
  "Grouping content without a visible boundary (Transparent variant)",
961
- "Full-bleed edge-to-edge media (Transparent Flush variant)"
1022
+ "Full-bleed edge-to-edge media (Transparent Flush variant)",
1023
+ "Report-page cards with filter rows, header metrics and edge-to-edge data views (density='data', CardToolbar, CardMetric, CardContent flush)"
962
1024
  ],
963
1025
  "knownGaps": [],
964
1026
  "doNotUseFor": [
@@ -1046,6 +1108,14 @@
1046
1108
  {
1047
1109
  "export": "CardAction",
1048
1110
  "reason": "No Figma representation found (2026-08-13) — candidate designer task at rollout"
1111
+ },
1112
+ {
1113
+ "export": "CardToolbar",
1114
+ "reason": "Drawn as the 'Toolbar Slot' SLOT property on the Card set in the DS-989 Figma branch (gQkQkqVsqDRzJpkbMHR5S7); map via /figma-map Card after the branch merges (FIG-28)"
1115
+ },
1116
+ {
1117
+ "export": "CardMetric",
1118
+ "reason": "Drawn as the 'Card Metric' component on the DS-989 Figma branch; map via /figma-map Card after the branch merges (FIG-28)"
1049
1119
  }
1050
1120
  ],
1051
1121
  "figmaOnly": [
@@ -1261,6 +1331,8 @@
1261
1331
  "ChartTooltipContent",
1262
1332
  "ChartLegend",
1263
1333
  "ChartLegendContent",
1334
+ "ChartLegendList",
1335
+ "ChartLegendItem",
1264
1336
  "ChartStyle",
1265
1337
  "ChartDot",
1266
1338
  "ChartDotOnStroke",
@@ -1273,7 +1345,16 @@
1273
1345
  ],
1274
1346
  "compound": true,
1275
1347
  "dataHookRequired": true,
1276
- "variants": {},
1348
+ "variants": {
1349
+ "orientation": [
1350
+ "horizontal",
1351
+ "vertical"
1352
+ ],
1353
+ "size": [
1354
+ "sm",
1355
+ "md"
1356
+ ]
1357
+ },
1277
1358
  "props": [
1278
1359
  "config",
1279
1360
  "id"
@@ -1281,7 +1362,23 @@
1281
1362
  "hooks": [
1282
1363
  "useChart"
1283
1364
  ],
1284
- "description": "Data visualization wrapper for Recharts",
1365
+ "description": "Data visualization wrapper for Recharts. Legends are composable: ChartLegendContent renders Recharts' payload inside a chart (with sortBy, showValue/valueKey, renderItem); ChartLegendList + ChartLegendItem compose a legend beside a chart — vertical with values next to a donut, shared across charts, or a row of toggles/popover triggers via asChild. size sm (12px chart chrome, default) or md (14px key read as content, 10px swatch). Item states: muted = de-emphasised but still drawn (a filter focused elsewhere); hidden = switched off, faded + struck label, never colour alone.",
1366
+ "i18nProps": {
1367
+ "ChartLegendList": {
1368
+ "ariaLabel": "string — default: \"Chart legend\""
1369
+ },
1370
+ "ChartLegendContent": {
1371
+ "ariaLabel": "string — default: \"Chart legend\""
1372
+ }
1373
+ },
1374
+ "aliases": [
1375
+ "chart legend",
1376
+ "chart key",
1377
+ "vertical legend",
1378
+ "legend beside chart",
1379
+ "interactive legend",
1380
+ "legend with values"
1381
+ ],
1285
1382
  "figma": {
1286
1383
  "fileKey": "p3krmC8DBUgqpbq6cLzaal",
1287
1384
  "status": "code-only",
@@ -1291,7 +1388,8 @@
1291
1388
  "Trends over time (Line), or trends emphasizing total volume underneath (Area)",
1292
1389
  "Comparing a few categories or rankings (Bar)",
1293
1390
  "Part-of-whole proportions with 5 or fewer categories (Pie)",
1294
- "Multi-measure profiles of one or two items (Radar), or a single percentage/progress value as a circular tile (Radial Bar)"
1391
+ "Multi-measure profiles of one or two items (Radar), or a single percentage/progress value as a circular tile (Radial Bar)",
1392
+ "A legend beside the plot or shared by several charts: ChartLegendList + ChartLegendItem (orientation=\"vertical\" with values; asChild makes an item a popover trigger or an aria-pressed toggle)"
1295
1393
  ],
1296
1394
  "doNotUseFor": [
1297
1395
  "exact values users must read precisely (pair with or use Table/DataTable)",
@@ -1340,7 +1438,8 @@
1340
1438
  "import": "@brightlocal/ui-components/checkbox",
1341
1439
  "category": "form",
1342
1440
  "exports": [
1343
- "Checkbox"
1441
+ "Checkbox",
1442
+ "checkboxVariants"
1344
1443
  ],
1345
1444
  "compound": false,
1346
1445
  "dataHookRequired": true,
@@ -1361,7 +1460,7 @@
1361
1460
  "turning a system feature or state on or off (use Switch)",
1362
1461
  "single-choice selection from a list (use RadioGroup)",
1363
1462
  "pressed-button toolbar controls (use Toggle)",
1364
- "more than ~7 options (use the faceted multi-select from the Filtering pattern)"
1463
+ "more than ~7 options (use MultiSelectFilter)"
1365
1464
  ],
1366
1465
  "replaces": [
1367
1466
  "native <input type='checkbox'>"
@@ -1388,6 +1487,11 @@
1388
1487
  "kind": "componentSet",
1389
1488
  "export": "Checkbox",
1390
1489
  "axes": [
1490
+ {
1491
+ "figma": "Variant",
1492
+ "exempt": "figma-only-style",
1493
+ "note": "Simple|Box draws the Field variant=\"box\" composition (DS-572/DS-576) — `box` is a Field prop, not a Checkbox prop"
1494
+ },
1391
1495
  {
1392
1496
  "figma": "Status",
1393
1497
  "exempt": "interaction-state",
@@ -1408,7 +1512,12 @@
1408
1512
  ]
1409
1513
  }
1410
1514
  ],
1411
- "unmappedExports": [],
1515
+ "unmappedExports": [
1516
+ {
1517
+ "export": "checkboxVariants",
1518
+ "reason": "cva style helper (the Checkbox look for presentational check marks, e.g. MultiSelectFilter's option rows), not a component"
1519
+ }
1520
+ ],
1412
1521
  "figmaOnly": []
1413
1522
  },
1414
1523
  "whenToUse": [
@@ -1586,7 +1695,7 @@
1586
1695
  "short lists under 10 items (use Select)",
1587
1696
  "free-text values not on the list (use InputChip)",
1588
1697
  "options that should all be visible for comparison (use RadioGroup or ToggleGroup)",
1589
- "picking several values at once — Combobox is single-value by design (use the faceted multi-select from the Filtering pattern)"
1698
+ "picking several values at once — Combobox is single-value by design (use MultiSelectFilter)"
1590
1699
  ],
1591
1700
  "alternatives": [
1592
1701
  {
@@ -2034,6 +2143,8 @@
2034
2143
  "getRowClassName",
2035
2144
  "renderExpandedContent",
2036
2145
  "isLoading",
2146
+ "refetching",
2147
+ "refetchingLabel",
2037
2148
  "skeletonRowCount",
2038
2149
  "noResultsMessage",
2039
2150
  "layout",
@@ -2046,7 +2157,8 @@
2046
2157
  "i18nProps": {
2047
2158
  "DataTable": {
2048
2159
  "scrollRegionLabel": "string — default: \"Scrollable table\"",
2049
- "noResultsMessage": "string — default: \"No results.\""
2160
+ "noResultsMessage": "string — default: \"No results.\"",
2161
+ "refetchingLabel": "string — default: \"Loading results…\""
2050
2162
  },
2051
2163
  "DataTableColumnHeader": {
2052
2164
  "getSortLabel": "(title: string, direction: \"asc\" | \"desc\" | false) => string"
@@ -2083,7 +2195,7 @@
2083
2195
  "children": "React.ReactNode | ((info: { selectedCount: number; totalCount: number }) => React.ReactNode) — default: \"{selectedCount} of {totalCount} row(s) selected.\""
2084
2196
  }
2085
2197
  },
2086
- "description": "Composable data table built on TanStack Table. Exposes `useDataTable` hook + `DataTable` / `VirtualizedDataTable` renderers + toolbar layout + pagination and search helpers. Compose the table and its companions (DataTableToolbar rows, bulk actions) as ONE slot — a single flex-column wrapper — inside gapped parents like DialogContent or Card, so the parent's gap applies around the table block, not between the toolbars and the table; the toolbars' built-in padding provides the internal spacing. noResultsMessage accepts a ReactNode as well as a string: pass an EmptyState for a collection that is empty, and keep a one-line string for a collection that is merely filtered — the reader typed the query and wants its outcome, not an onboarding block. The cell is a polite live region either way.",
2198
+ "description": "Composable data table built on TanStack Table. Exposes `useDataTable` hook + `DataTable` / `VirtualizedDataTable` renderers + toolbar layout + pagination and search helpers. Compose the table and its companions (DataTableToolbar rows, bulk actions) as ONE slot — a single flex-column wrapper — inside gapped parents like DialogContent or Card, so the parent's gap applies around the table block, not between the toolbars and the table; the toolbars' built-in padding provides the internal spacing. noResultsMessage accepts a ReactNode as well as a string: pass an EmptyState for a collection that is empty, and keep a one-line string for a collection that is merely filtered — the reader typed the query and wants its outcome, not an onboarding block. The cell is a polite live region either way. The component's outer wrapper is its single scroll container for both axes (DS-912): bound the height through className (`max-h-*` for a fixed cap, `min-h-0 flex-1` inside a height-capped parent like a dialog body) and stickyHeader keeps the column headers pinned while the rows scroll — no internal slot targeting needed. With stickyHeader, minWidth, or scrollRegionLabel set (and always on VirtualizedDataTable) the wrapper is a focusable scroll region (role=region + tabIndex, labelled by scrollRegionLabel) so keyboard users can scroll the rows — pass scrollRegionLabel to opt in when the height is capped via className with the header deliberately left unpinned.",
2087
2199
  "figma": {
2088
2200
  "fileKey": "p3krmC8DBUgqpbq6cLzaal",
2089
2201
  "status": "code-only",
@@ -2099,6 +2211,13 @@
2099
2211
  "simple read-only data with no sorting/filtering (use Table)",
2100
2212
  "1,000+ rows with the standard renderer (use VirtualizedDataTable)",
2101
2213
  "simple visual lists of items with icons and actions (use List)"
2214
+ ],
2215
+ "knownGaps": [
2216
+ {
2217
+ "description": "A height bound set through className without stickyHeader scrolls vertically but is not keyboard-focusable — the component cannot inspect className, so the focusable scroll-region semantics are gated on stickyHeader (or minWidth)",
2218
+ "ticket": "DS-912",
2219
+ "workaround": "Set stickyHeader on height-capped tables (almost always wanted anyway); if the header must scroll away, own the scrolling yourself: wrap the table in your own max-h-* overflow-y-auto container carrying role=\"region\", an aria-label, and tabIndex={0} (arrow keys only scroll the focused element or an ancestor, so the semantics must sit on the element that scrolls), and leave className un-capped"
2220
+ }
2102
2221
  ]
2103
2222
  },
2104
2223
  {
@@ -2659,6 +2778,286 @@
2659
2778
  "Menus discoverable by clicking rather than right-click or hover"
2660
2779
  ]
2661
2780
  },
2781
+ {
2782
+ "name": "MultiSelectFilter",
2783
+ "import": "@brightlocal/ui-components/multi-select-filter",
2784
+ "category": "form",
2785
+ "exports": [
2786
+ "MultiSelectFilter",
2787
+ "multiSelectFilterTriggerVariants"
2788
+ ],
2789
+ "compound": false,
2790
+ "dataHookRequired": true,
2791
+ "variants": {
2792
+ "size": [
2793
+ "default",
2794
+ "sm"
2795
+ ]
2796
+ },
2797
+ "props": [
2798
+ "label",
2799
+ "options",
2800
+ "value",
2801
+ "defaultValue",
2802
+ "onValueChange",
2803
+ "open",
2804
+ "onOpenChange",
2805
+ "icon",
2806
+ "maxVisibleLabels",
2807
+ "allLabel",
2808
+ "allCount",
2809
+ "searchThreshold",
2810
+ "searchable",
2811
+ "disabled",
2812
+ "presentation",
2813
+ "collapseFullSelection",
2814
+ "allIcon"
2815
+ ],
2816
+ "description": "The Filtering pattern's faceted multi-select: one dimension, several values combining as OR, over a Popover + Command menu that stays open across picks. The trigger hugs its label in a toolbar and wears the Select field look (border, radius, focus ring, chevron) because a filter trigger holds a value, it does not act; stacked in a panel it takes className='w-full'. No error state — a filter does not validate. size='default' (h-9, text-field like Select: 14px desktop / 16px touch) or 'sm' (h-8, text-label, phone card headers). The trigger always reads its picks, like a Select shows its value: allLabel at zero (or the dimension's label, muted, as a placeholder), then the picked labels, collapsing past maxVisibleLabels (default 1) into summaryLabel ('Google +2' via the default '{labels} +{rest}'; '3 selected' via '{count} selected') — and it computes the accessible name itself with every pick spelled out. Glyphs are the consumer's, never a fixed funnel: option.icon shows before each label in the menu and drawer, allIcon marks the All row, and the trigger follows the selection (allIcon at zero, then the first pick's icon) unless icon pins one. No-match shows the compact empty form (muted chip, emptyLabel, emptyDescription) in both presentations. allLabel adds a leading reset row: 'All' means no narrowing, so it is checked when value is empty and picking it clears the selection; a pick that completes the set collapses to [] for the same reason (collapseFullSelection, default true). Picks read on the trigger in pick order. Selected values pin to the top on reopen; a zero-count option is disabled, never hidden; past searchThreshold (10) the menu grows an autofocused search input (searchable forces it) — a case-insensitive substring match on label and value, never on the count; while searching the All row and Clear step aside, and a no-match search shows emptyLabel alone. presentation='menu' (default) is the Popover + Command menu; 'drawer' is the phone form — the same trigger opens a bottom Drawer titled with the dimension, All row, options as Checkboxes in two columns, search past the threshold, Clear while something is picked, a Done button that only closes (ticks apply at once); 'auto' switches at the md breakpoint. Both render from one state. Per-filter commit model: onValueChange on every pick, run an expensive refetch on onOpenChange(false). multiSelectFilterTriggerVariants is exported for the 'Filters (n)' recipe — a trigger that opens a Sheet or Drawer of hidden filters, with a Badge srLabel count.",
2817
+ "i18nProps": {
2818
+ "MultiSelectFilter": {
2819
+ "clearLabel": "string — default: \"Clear filters\"",
2820
+ "summaryLabel": "string — default: \"{labels} +{rest}\" (placeholders: {labels}, {rest}, {count})",
2821
+ "searchPlaceholder": "string — default: \"Search options...\"",
2822
+ "emptyLabel": "string — default: \"No options found.\"",
2823
+ "doneLabel": "string — default: \"Done\" (the drawer's close button)",
2824
+ "drawerDescription": "string — default: \"Picks apply as you make them.\" (sr-only drawer description)",
2825
+ "emptyDescription": "string — default: \"Try another search.\" (hint under the no-match message)",
2826
+ "clearSearchAriaLabel": "string — default: \"Clear search\" (the menu search input's clear button; the drawer search has none)"
2827
+ }
2828
+ },
2829
+ "whenToUse": [
2830
+ "Picking several values from one dimension that combine as OR (status, source, city) in a filter bar",
2831
+ "A filter whose trigger reads its current picks ('All sources', 'Google +2') like a Select shows its value, with every pick in the accessible name",
2832
+ "Stacked in a filter panel or sidebar — className='w-full' takes the row's width; same component, no form-field variant",
2833
+ "Any option list past ~10 values — the menu's autofocused search input and pinned selections handle it",
2834
+ "Desktop: presentation='menu' (default), the Popover + Command menu beside a Select in a toolbar (size='default', h-9, text-field)",
2835
+ "Phone: presentation='drawer' opens the same picks as a bottom Drawer (Checkbox rows in two columns, search past the threshold, Clear, Done only closes); presentation='auto' switches at the md breakpoint; size='sm' (h-8) for card headers — no hand-rolled drawer per filter"
2836
+ ],
2837
+ "doNotUseFor": [
2838
+ "picking exactly one value from a filter dimension (use SingleSelectFilter — it shares the trigger look and the drawer, with a DS Select on desktop and RadioGroup in the drawer)",
2839
+ "2–5 values with room to show them all (use ToggleGroup, or the Lab SegmentedControl quick filter)",
2840
+ "typing new values into the selection (use InputChip)",
2841
+ "a form field that validates and submits — this is a filter and has no error state; a form multi-select is a separate component",
2842
+ "the 'Filters (n)' trigger that opens a panel of hidden filters — compose a button with multiSelectFilterTriggerVariants and a Badge srLabel count instead",
2843
+ "a batch drawer of several filters behind one Apply — the Filtering page's MobileFilterDrawer recipe (Drawer + the trigger style), not one MultiSelectFilter"
2844
+ ],
2845
+ "alternatives": [
2846
+ {
2847
+ "component": "Select",
2848
+ "rule": "Use Select for a single choice from a short, known list"
2849
+ },
2850
+ {
2851
+ "component": "Combobox",
2852
+ "rule": "Use Combobox for a single choice from a long, searchable list — it is single-value by design"
2853
+ },
2854
+ {
2855
+ "component": "ToggleGroup",
2856
+ "rule": "Use ToggleGroup (or the Lab SegmentedControl) for a quick filter kept visible in the bar"
2857
+ },
2858
+ {
2859
+ "component": "InputChip",
2860
+ "rule": "Use InputChip when the person types new values rather than picking existing ones"
2861
+ },
2862
+ {
2863
+ "component": "Drawer",
2864
+ "rule": "Use Drawer with multiSelectFilterTriggerVariants for a batch panel of several filters on a phone (MobileFilterDrawer recipe); a single filter's phone form is presentation='drawer' on MultiSelectFilter itself"
2865
+ },
2866
+ {
2867
+ "component": "Chip",
2868
+ "rule": "Use Chip for the applied-filter tokens that show what a MultiSelectFilter has picked"
2869
+ },
2870
+ {
2871
+ "component": "SingleSelectFilter",
2872
+ "rule": "Use SingleSelectFilter for one value from a dimension — it shares the trigger look and the drawer, with a DS Select on desktop"
2873
+ }
2874
+ ],
2875
+ "figma": {
2876
+ "fileKey": "p3krmC8DBUgqpbq6cLzaal",
2877
+ "nodes": [
2878
+ {
2879
+ "nodeId": "34233:70287",
2880
+ "figmaName": "Multi Select Filter",
2881
+ "kind": "componentSet",
2882
+ "export": "MultiSelectFilter",
2883
+ "note": "Built on branch task/DS-1023-faced-filter (2026-10-08); node ids persist on merge. Draws the trigger (Text, Show Icon + Icon swap); the menu is the figmaOnly sub-parts below.",
2884
+ "axes": [
2885
+ {
2886
+ "figma": "Size",
2887
+ "code": "size"
2888
+ },
2889
+ {
2890
+ "figma": "State",
2891
+ "exempt": "interaction-state",
2892
+ "valueToProp": {
2893
+ "Disabled": "disabled"
2894
+ },
2895
+ "note": "Focus and Open are runtime states"
2896
+ }
2897
+ ]
2898
+ }
2899
+ ],
2900
+ "unmappedExports": [
2901
+ {
2902
+ "export": "multiSelectFilterTriggerVariants",
2903
+ "reason": "cva style helper for the 'Filters (n)' recipe, not a component — the Multi Select Filter set's variants are its drawing"
2904
+ }
2905
+ ],
2906
+ "figmaOnly": [
2907
+ {
2908
+ "nodeId": "34233:70355",
2909
+ "figmaName": "Multi Select Filter / Menu Item",
2910
+ "reason": "The menu row MultiSelectFilter renders internally (CommandItem + Checkbox look + count); no sub-part export by design — one component, one engine. Checked/State are runtime states."
2911
+ },
2912
+ {
2913
+ "nodeId": "34233:70435",
2914
+ "figmaName": "Multi Select Filter / Menu",
2915
+ "reason": "The Popover + Command menu MultiSelectFilter renders internally (search, All row, options, empty, Clear); no sub-part export by design."
2916
+ }
2917
+ ]
2918
+ },
2919
+ "aliases": [
2920
+ "faceted filter",
2921
+ "facet filter",
2922
+ "multi-select",
2923
+ "multi select dropdown",
2924
+ "filter dropdown",
2925
+ "checkbox filter",
2926
+ "filter menu",
2927
+ "mobile filter drawer"
2928
+ ],
2929
+ "replaces": [
2930
+ "Lab FacetedFilter",
2931
+ "Lab SearchableMultiSelect",
2932
+ "Lab FilterTrigger (as multiSelectFilterTriggerVariants + Badge srLabel)",
2933
+ "per-app faceted-filter copies in the prototypes"
2934
+ ],
2935
+ "states": [
2936
+ "closed",
2937
+ "open (menu)",
2938
+ "open (drawer)",
2939
+ "searching",
2940
+ "no match",
2941
+ "disabled"
2942
+ ],
2943
+ "a11yContract": {
2944
+ "role": "button (trigger, aria-label computed: '{label}: {every pick}') → Popover with a cmdk listbox of aria-checked options, or a Drawer dialog titled with the dimension",
2945
+ "requiresLabel": true,
2946
+ "keyboardInteraction": [
2947
+ "Enter/Space opens",
2948
+ "Arrow keys move between options (cmdk root takes focus when there is no search input)",
2949
+ "Enter toggles the highlighted option; the menu stays open",
2950
+ "Type to narrow past the search threshold",
2951
+ "Escape closes and returns focus to the trigger"
2952
+ ]
2953
+ },
2954
+ "knownGaps": [
2955
+ {
2956
+ "description": "The trigger hugs its text, so its width moves with the reading ('All sources' → 'Google' → 'Google +2'); Select solves this with reserveValues, MultiSelectFilter does not yet",
2957
+ "workaround": "Keep maxVisibleLabels at its default of 1; where neighbours must not shift, add className='min-w-40' (a layout class) sized to the dimension's longest label"
2958
+ },
2959
+ {
2960
+ "description": "Picks apply at once in both presentations — there is no batch/Apply mode on a single filter",
2961
+ "workaround": "A batch drawer of several filters is the Filtering page's MobileFilterDrawer recipe (Drawer + multiSelectFilterTriggerVariants), to be packaged as a FilterDrawer block"
2962
+ }
2963
+ ]
2964
+ },
2965
+ {
2966
+ "name": "SingleSelectFilter",
2967
+ "import": "@brightlocal/ui-components/single-select-filter",
2968
+ "category": "form",
2969
+ "exports": [
2970
+ "SingleSelectFilter"
2971
+ ],
2972
+ "compound": false,
2973
+ "dataHookRequired": true,
2974
+ "variants": {
2975
+ "size": [
2976
+ "default",
2977
+ "sm"
2978
+ ],
2979
+ "presentation": [
2980
+ "menu",
2981
+ "drawer",
2982
+ "auto"
2983
+ ]
2984
+ },
2985
+ "props": [
2986
+ "label",
2987
+ "options",
2988
+ "value",
2989
+ "defaultValue",
2990
+ "onValueChange",
2991
+ "open",
2992
+ "onOpenChange",
2993
+ "icon",
2994
+ "disabled",
2995
+ "presentation"
2996
+ ],
2997
+ "description": "The Filtering pattern's single-value dropdown filter: one value from one dimension (time period, interval, source type). Shows a DS Select (native listbox, keyboard navigation, scroll indicators) on desktop and a bottom Drawer with RadioGroup in two columns on mobile. The trigger wears the same field look as MultiSelectFilter (multiSelectFilterTriggerVariants — border, radius, focus ring, chevron) so a SingleSelectFilter sits beside a MultiSelectFilter in a toolbar row without looking different. size='default' (h-9, text-field: 14px desktop / 16px touch like Select) or 'sm' (h-8, text-label, phone card headers). The trigger always reads the selected label, or the dimension's name when nothing is picked — both in foreground text, never muted. Options may carry their own icon (option.icon) shown before the label in the menu and the drawer; the trigger wears the picked option's icon unless the icon prop pins one. Counts render in the menu only, never in the trigger. Clear resets to defaultValue — unlike MultiSelectFilter which clears to []; a single-value filter always has a value, and 'no filter' is an explicit option in the list. Drawer anatomy matches MultiSelectFilter: DrawerTitle = label, sr-only DrawerDescription, RadioGroup in grid-cols-2, Clear when value ≠ defaultValue, Done button that only closes. Per-filter commit model: onValueChange fires on every pick. presentation='menu' (default) is the DS Select; 'drawer' is the phone form; 'auto' switches at the md breakpoint.",
2998
+ "i18nProps": {
2999
+ "SingleSelectFilter": {
3000
+ "clearLabel": "string — default: \"Clear filters\"",
3001
+ "doneLabel": "string — default: \"Done\" (the drawer's close button)",
3002
+ "drawerDescription": "string — default: \"Pick one option.\" (sr-only drawer description)"
3003
+ }
3004
+ },
3005
+ "whenToUse": [
3006
+ "One value from a dimension in a filter toolbar (time period, interval, source type) — the Filtering pattern's dropdown filter",
3007
+ "A responsive filter that shows a DS Select on desktop and a radio drawer on mobile: presentation='auto' switches at md",
3008
+ "Sitting beside MultiSelectFilter in a filter bar — the trigger look matches exactly"
3009
+ ],
3010
+ "doNotUseFor": [
3011
+ "picking more than one option (use MultiSelectFilter)",
3012
+ "a form field that validates (use Select — SingleSelectFilter has no error state)",
3013
+ "quick filters with 2–5 always-visible options (use ToggleGroup or SegmentedControl)",
3014
+ "a long, searchable single-value list in a form (use Combobox)"
3015
+ ],
3016
+ "alternatives": [
3017
+ {
3018
+ "component": "MultiSelectFilter",
3019
+ "rule": "Use MultiSelectFilter for several values from one dimension combining as OR"
3020
+ },
3021
+ {
3022
+ "component": "Select",
3023
+ "rule": "Use Select for a form field that validates — SingleSelectFilter is a filter, not a form field"
3024
+ },
3025
+ {
3026
+ "component": "ToggleGroup",
3027
+ "rule": "Use ToggleGroup for a quick filter with 2–5 always-visible options"
3028
+ },
3029
+ {
3030
+ "component": "Combobox",
3031
+ "rule": "Use Combobox for a long, searchable single-value list in a form"
3032
+ }
3033
+ ],
3034
+ "figma": {
3035
+ "fileKey": "p3krmC8DBUgqpbq6cLzaal",
3036
+ "nodes": [
3037
+ {
3038
+ "nodeId": "34438:81566",
3039
+ "figmaName": "Single Select Filter",
3040
+ "kind": "componentSet",
3041
+ "export": "SingleSelectFilter",
3042
+ "note": "Built on branch task/DS-1050-sigle-select-filter (2026-10-12); node ids persist on merge. Draws the trigger (Text, Show Icon + Icon swap). The desktop menu is the Select page's `Select / Menu` (the component wraps DS Select) and the phone drawer is a Playground composition of Drawer + Radio / Item — neither is a sub-part export. `presentation` is a runtime/responsive prop with no Figma axis.",
3043
+ "axes": [
3044
+ {
3045
+ "figma": "Size",
3046
+ "code": "size"
3047
+ },
3048
+ {
3049
+ "figma": "State",
3050
+ "exempt": "interaction-state",
3051
+ "valueToProp": {
3052
+ "Disabled": "disabled"
3053
+ },
3054
+ "note": "Focus and Open are runtime states; the CVA has no hover style, so there is no Hover variant"
3055
+ }
3056
+ ]
3057
+ }
3058
+ ]
3059
+ }
3060
+ },
2662
3061
  {
2663
3062
  "name": "Field",
2664
3063
  "import": "@brightlocal/ui-components/field",
@@ -2892,6 +3291,13 @@
2892
3291
  "a whole standalone page like login or invite (use CentredLayout — it owns the viewport)",
2893
3292
  "a section's empty frame (an md EmptyState fills the frame it is given, no centring wrapper)",
2894
3293
  "a layout the vocabulary lacks (request a new variant in the DS, never a className at the call site)"
3294
+ ],
3295
+ "knownGaps": [
3296
+ {
3297
+ "description": "variant=\"centered\" needs an unbroken flex chain: it stretches with flex-1, so a non-flex wrapper between the page body and the Grid collapses it to its content height — the 38/62 spacers shrink to zero and the message is centred horizontally only (it hugs the top of the body). Nothing warns about it.",
3298
+ "ticket": "DS-1058",
3299
+ "workaround": "Make every wrapper between the page body and the Grid a flex column that fills it (className=\"flex flex-1 flex-col\"), or render the Grid directly inside GlobalLayoutBody. Never compensate with a top margin (mt-*)."
3300
+ }
2895
3301
  ]
2896
3302
  },
2897
3303
  {
@@ -3044,6 +3450,66 @@
3044
3450
  "single short lines of text (use Tooltip)"
3045
3451
  ]
3046
3452
  },
3453
+ {
3454
+ "name": "InfoTooltip",
3455
+ "import": "@brightlocal/ui-components/info-tooltip",
3456
+ "category": "feedback",
3457
+ "exports": [
3458
+ "InfoTooltip"
3459
+ ],
3460
+ "compound": false,
3461
+ "dataHookRequired": true,
3462
+ "variants": {},
3463
+ "props": [
3464
+ "content",
3465
+ "icon",
3466
+ "iconSize",
3467
+ "ariaLabel",
3468
+ "trackingEl",
3469
+ "trackingLabel"
3470
+ ],
3471
+ "description": "Muted info icon that opens a tooltip (hover/tap/focus) — the standard pattern for inline hints next to labels. Composes the Tooltip component.",
3472
+ "aliases": [
3473
+ "info icon",
3474
+ "help icon",
3475
+ "hint tooltip",
3476
+ "info tooltip",
3477
+ "muted tooltip trigger"
3478
+ ],
3479
+ "whenToUse": [
3480
+ "A small info/help icon next to a label that explains what it means",
3481
+ "Inline clarifications that should not take up permanent space"
3482
+ ],
3483
+ "doNotUseFor": [
3484
+ "Clickable tooltip content — use Popover",
3485
+ "Content longer than a sentence or two — use HoverCard or Popover",
3486
+ "A button or interactive control as trigger — use Tooltip directly with asChild"
3487
+ ],
3488
+ "i18nProps": {
3489
+ "InfoTooltip": {
3490
+ "ariaLabel": "string — default: \"More info\""
3491
+ }
3492
+ },
3493
+ "figma": {
3494
+ "fileKey": "p3krmC8DBUgqpbq6cLzaal",
3495
+ "nodes": [
3496
+ {
3497
+ "nodeId": "34112:2577",
3498
+ "figmaName": "Info Tooltip",
3499
+ "kind": "componentSet",
3500
+ "export": "InfoTooltip",
3501
+ "axes": [
3502
+ {
3503
+ "figma": "State",
3504
+ "exempt": "interaction-state"
3505
+ }
3506
+ ]
3507
+ }
3508
+ ],
3509
+ "unmappedExports": [],
3510
+ "figmaOnly": []
3511
+ }
3512
+ },
3047
3513
  {
3048
3514
  "name": "Input",
3049
3515
  "import": "@brightlocal/ui-components/input",
@@ -3205,7 +3671,8 @@
3205
3671
  "InputGroup",
3206
3672
  "InputGroupInput",
3207
3673
  "InputGroupAddon",
3208
- "InputGroupButton"
3674
+ "InputGroupButton",
3675
+ "InputGroupClear"
3209
3676
  ],
3210
3677
  "compound": true,
3211
3678
  "dataHookRequired": true,
@@ -3219,7 +3686,7 @@
3219
3686
  "props": [
3220
3687
  "error"
3221
3688
  ],
3222
- "description": "Input with addon text or button",
3689
+ "description": "Input with addon text or button, and an opt-in built-in clear X",
3223
3690
  "figma": {
3224
3691
  "fileKey": "p3krmC8DBUgqpbq6cLzaal",
3225
3692
  "status": "represented-inline",
@@ -3227,6 +3694,7 @@
3227
3694
  },
3228
3695
  "whenToUse": [
3229
3696
  "A text box with something extra attached (search icon, clear button, unit prefix)",
3697
+ "Search fields needing the Filtering pattern’s in-field clear X — add InputGroupClear, no hand-wiring",
3230
3698
  "Attachments that should feel like part of the same control, not a separate element",
3231
3699
  "Ghost variant for search fields in toolbars or dense filter bars where a border feels heavy"
3232
3700
  ],
@@ -3234,7 +3702,12 @@
3234
3702
  "inputs with nothing attached (use Input)",
3235
3703
  "password visibility toggle with strength meter (use InputPassword)",
3236
3704
  "ghost variant on plain backgrounds with no surrounding context (can look non-interactive)"
3237
- ]
3705
+ ],
3706
+ "i18nProps": {
3707
+ "InputGroupClear": {
3708
+ "clearSearchAriaLabel": "string — default: \"Clear search\""
3709
+ }
3710
+ }
3238
3711
  },
3239
3712
  {
3240
3713
  "name": "InputOTP",
@@ -4286,6 +4759,7 @@
4286
4759
  "size",
4287
4760
  "showValue",
4288
4761
  "unit",
4762
+ "valueFormatter",
4289
4763
  "ariaLabel",
4290
4764
  "label",
4291
4765
  "statusDescription",
@@ -4294,7 +4768,12 @@
4294
4768
  "indicatorClassName",
4295
4769
  "disabled"
4296
4770
  ],
4297
- "description": "Progress bar indicator with optional inline label, numeric value, and brand color options",
4771
+ "description": "Progress bar indicator with optional inline label (text, or a node such as a Rating or icon), numeric value with optional custom formatting, and brand color options",
4772
+ "i18nProps": {
4773
+ "Progress": {
4774
+ "ariaLabel": "string — default: \"Progress\" (required when `label` is an element)"
4775
+ }
4776
+ },
4298
4777
  "figma": {
4299
4778
  "fileKey": "p3krmC8DBUgqpbq6cLzaal",
4300
4779
  "nodes": [
@@ -4303,7 +4782,7 @@
4303
4782
  "figmaName": "Progress",
4304
4783
  "kind": "componentSet",
4305
4784
  "export": "Progress",
4306
- "note": "Show label / Label text (TEXT) ↔ `label`; Show value ↔ `showValue`; `disabled` has no variant by decision — shown as a 50%-opacity instance in the Playground; Fill ↔ `value` (fill + Number text); Fraction form (BOOLEAN) / Max (TEXT) / Unit (TEXT) ↔ `unit !== \"%\"` / `max` / `unit`. Label column is the exposed nested set Progress / Label — Width Auto | 20% | 30% | 40% | 50% (default 40%) + Label text = code labelWidth (\"auto\" | \"20%\"–\"50%\", default \"40%\") + label; % values are fixed px at the 364 base since Figma has no % sizing; long labels wrap (never truncate); Value layer hugs with a 40px minimum, right-aligned (code sizes it to the widest value automatically). Indicator/Track use the brand palette by decision (green-400, brand-primary-foreground/20, brand-red/orange/yellow + /20) — Figma binds the same variables; not the chart-* tokens. Text style text-xs/leading-normal = 16px = Tailwind text-xs default line-height. DS-773.",
4785
+ "note": "Show label / Label text (TEXT) ↔ `label`; Show value ↔ `showValue`; `disabled` has no variant by decision — shown as a 50%-opacity instance in the Playground; Fill ↔ `value` (fill + Number text); Fraction form (BOOLEAN) / Max (TEXT) / Unit (TEXT) ↔ `unit !== \"%\"` / `max` / `unit`. Label column is the exposed nested set Progress / Label — Width Auto | 20% | 30% | 40% | 50% (default 40%) + Label text = code labelWidth (\"auto\" | \"20%\"–\"50%\", default \"40%\") + label; % values are fixed px at the 364 base since Figma has no % sizing; long labels wrap (never truncate); Value layer hugs with a 40px minimum, right-aligned (code sizes it to the widest value automatically). Indicator/Track use the brand palette by decision (green-400, brand-primary-foreground/20, brand-red/orange/yellow + /20) — Figma binds the same variables; not the chart-* tokens. Text style text-xs/leading-normal = 16px = Tailwind text-xs default line-height. DS-773. DS-1024: `label` also accepts an element (Rating, icon) with a required `ariaLabel` ↔ Progress / Label `Type = Text | Element` VARIANT (the code's two label shapes; an export-discriminator axis if the Label set is ever mapped) + `Element` INSTANCE_SWAP (default Rating Size=Small; preferred Rating, Progress / Element / Thumbs Up, Progress / Element / Thumbs Down — 16px icons in hugging frames); drawn on the DS-1024 branch (FIG-29, mapping after merge); `valueFormatter` output (e.g. a raw count) maps to the overridable Number text.",
4307
4786
  "axes": [
4308
4787
  {
4309
4788
  "figma": "Colour",
@@ -4474,6 +4953,105 @@
4474
4953
  "non-star scores or counts (use plain text or Badge)"
4475
4954
  ]
4476
4955
  },
4956
+ {
4957
+ "name": "RelativeDate",
4958
+ "import": "@brightlocal/ui-components/relative-date",
4959
+ "category": "display",
4960
+ "exports": [
4961
+ "RelativeDate",
4962
+ "useNow",
4963
+ "relativeWords",
4964
+ "exactText",
4965
+ "isDateOnly",
4966
+ "toDate",
4967
+ "dateLabel",
4968
+ "DEFAULT_RELATIVE_DATE_LABELS"
4969
+ ],
4970
+ "compound": false,
4971
+ "dataHookRequired": true,
4972
+ "variants": {},
4973
+ "props": [
4974
+ "value",
4975
+ "label",
4976
+ "labels",
4977
+ "className"
4978
+ ],
4979
+ "description": "When something happened, in words people read at a glance (\"1 hour ago\"), with the exact date and time in a tooltip. Handles ISO timestamps, calendar dates, and null/unknown.",
4980
+ "aliases": [
4981
+ "last updated",
4982
+ "time ago",
4983
+ "timestamp",
4984
+ "freshness",
4985
+ "relative time",
4986
+ "date ago"
4987
+ ],
4988
+ "whenToUse": [
4989
+ "Report page headers showing how fresh the data is (\"Last updated 1 hour ago\")",
4990
+ "Any line where users need a glanceable sense of how recent something is",
4991
+ "Calendar dates where the reader cares about recency, not the date itself (\"today\", \"yesterday\", \"3 days ago\")"
4992
+ ],
4993
+ "doNotUseFor": [
4994
+ "Picking or entering a date (use DatePicker)",
4995
+ "Displaying a fixed, absolute date that does not need relative context",
4996
+ "Countdown timers or future dates"
4997
+ ],
4998
+ "i18nProps": {
4999
+ "RelativeDate": {
5000
+ "labels.justNow": "string — default: \"just now\"",
5001
+ "labels.minuteAgo": "string — default: \"1 minute ago\"",
5002
+ "labels.minutesAgo": "string — default: \"{n} minutes ago\"",
5003
+ "labels.hourAgo": "string — default: \"1 hour ago\"",
5004
+ "labels.hoursAgo": "string — default: \"{n} hours ago\"",
5005
+ "labels.today": "string — default: \"today\"",
5006
+ "labels.yesterday": "string — default: \"yesterday\"",
5007
+ "labels.daysAgo": "string — default: \"{n} days ago\"",
5008
+ "labels.unknown": "string — default: \"unknown\""
5009
+ }
5010
+ },
5011
+ "figma": {
5012
+ "fileKey": "p3krmC8DBUgqpbq6cLzaal",
5013
+ "nodes": [
5014
+ {
5015
+ "nodeId": "34279:1059",
5016
+ "figmaName": "Relative Date",
5017
+ "kind": "componentSet",
5018
+ "export": "RelativeDate",
5019
+ "axes": []
5020
+ }
5021
+ ],
5022
+ "unmappedExports": [
5023
+ {
5024
+ "export": "useNow",
5025
+ "reason": "Hook — no Figma representation"
5026
+ },
5027
+ {
5028
+ "export": "relativeWords",
5029
+ "reason": "Utility function — no Figma representation"
5030
+ },
5031
+ {
5032
+ "export": "exactText",
5033
+ "reason": "Utility function — no Figma representation"
5034
+ },
5035
+ {
5036
+ "export": "isDateOnly",
5037
+ "reason": "Utility function — no Figma representation"
5038
+ },
5039
+ {
5040
+ "export": "toDate",
5041
+ "reason": "Utility function — no Figma representation"
5042
+ },
5043
+ {
5044
+ "export": "dateLabel",
5045
+ "reason": "Utility function — no Figma representation"
5046
+ },
5047
+ {
5048
+ "export": "DEFAULT_RELATIVE_DATE_LABELS",
5049
+ "reason": "Default labels constant — no Figma representation"
5050
+ }
5051
+ ],
5052
+ "figmaOnly": []
5053
+ }
5054
+ },
4477
5055
  {
4478
5056
  "name": "Resizable",
4479
5057
  "import": "@brightlocal/ui-components/resizable",
@@ -4659,7 +5237,8 @@
4659
5237
  "onClose",
4660
5238
  "disabled",
4661
5239
  "error",
4662
- "hint"
5240
+ "hint",
5241
+ "reserveValues"
4663
5242
  ],
4664
5243
  "description": "Dropdown select input",
4665
5244
  "aliases": [
@@ -4669,8 +5248,9 @@
4669
5248
  ],
4670
5249
  "doNotUseFor": [
4671
5250
  "long or searchable lists (use Combobox)",
4672
- "picking more than one option (use the faceted multi-select from the Filtering pattern)",
4673
- "showing every option at once (use RadioGroup)"
5251
+ "picking more than one option (use MultiSelectFilter)",
5252
+ "showing every option at once (use RadioGroup)",
5253
+ "a single-value filter in a toolbar (use SingleSelectFilter — it wraps Select on desktop and adds a radio drawer on mobile)"
4674
5254
  ],
4675
5255
  "replaces": [
4676
5256
  "native <select>"
@@ -4862,6 +5442,7 @@
4862
5442
  "SheetClose",
4863
5443
  "SheetOverlay",
4864
5444
  "SheetContent",
5445
+ "SheetPagination",
4865
5446
  "SheetHeader",
4866
5447
  "SheetBody",
4867
5448
  "SheetFooter",
@@ -4889,6 +5470,12 @@
4889
5470
  "i18nProps": {
4890
5471
  "SheetContent": {
4891
5472
  "closeLabel": "string — default: \"Close\""
5473
+ },
5474
+ "SheetPagination": {
5475
+ "ariaLabel": "string — default: \"Item navigation\"",
5476
+ "prevAriaLabel": "string — default: \"Previous item\"",
5477
+ "nextAriaLabel": "string — default: \"Next item\"",
5478
+ "renderPosition": "(info) => ReactNode — default: \"{current} of {total}\""
4892
5479
  }
4893
5480
  },
4894
5481
  "description": "Side panel overlay",
@@ -4932,7 +5519,9 @@
4932
5519
  "requiresLabel": true,
4933
5520
  "keyboardInteraction": [
4934
5521
  "Escape",
4935
- "Tab"
5522
+ "Tab",
5523
+ "ArrowUp/ArrowLeft (SheetPagination: previous item)",
5524
+ "ArrowDown/ArrowRight (SheetPagination: next item)"
4936
5525
  ]
4937
5526
  },
4938
5527
  "figma": {
@@ -4978,6 +5567,10 @@
4978
5567
  "export": "SheetContent",
4979
5568
  "reason": "Drawn by the Sheet set (the panel); its side variant is declared on the set's Position axis"
4980
5569
  },
5570
+ {
5571
+ "export": "SheetPagination",
5572
+ "reason": "Drawn as the SheetPagination component on Figma branch b5xlDa4Z8KpgCwho15fOcM (DS-1035); map with /figma-map after the branch merges"
5573
+ },
4981
5574
  {
4982
5575
  "export": "SheetHeader",
4983
5576
  "reason": "Drawn inside the set ('Show Header' toggle)"
@@ -5484,6 +6077,10 @@
5484
6077
  "layout": [
5485
6078
  "auto",
5486
6079
  "fixed"
6080
+ ],
6081
+ "scrollOwner": [
6082
+ "self",
6083
+ "parent"
5487
6084
  ]
5488
6085
  },
5489
6086
  "props": [
@@ -5492,7 +6089,8 @@
5492
6089
  "trackingLabel",
5493
6090
  "layout",
5494
6091
  "minWidth",
5495
- "scrollRegionLabel"
6092
+ "scrollRegionLabel",
6093
+ "scrollOwner"
5496
6094
  ],
5497
6095
  "i18nProps": {
5498
6096
  "Table": {
@@ -5510,7 +6108,7 @@
5510
6108
  "workaround": "Use DataTableColumnHeader from DataTable for sortable headers"
5511
6109
  }
5512
6110
  ],
5513
- "description": "Semantic HTML table with accessibility features. Text alignment is physical (left/right/center). Set layout=\"fixed\" with width on TableHead for stable columns.",
6111
+ "description": "Semantic HTML table with accessibility features. Text alignment is physical (left/right/center). Set layout=\"fixed\" with width on TableHead for stable columns. scrollOwner=\"parent\" keeps the table-container wrapper in the DOM as a plain positioned block but strips its scroll behavior, so a scrolling ancestor owns both axes (how DataTable renders it); default \"self\" makes the wrapper the horizontal scroll container.",
5514
6112
  "aliases": [
5515
6113
  "data grid",
5516
6114
  "grid",
@@ -5653,8 +6251,14 @@
5653
6251
  ],
5654
6252
  "compound": true,
5655
6253
  "dataHookRequired": true,
5656
- "variants": {},
6254
+ "variants": {
6255
+ "variant": [
6256
+ "default",
6257
+ "underline"
6258
+ ]
6259
+ },
5657
6260
  "props": [
6261
+ "variant",
5658
6262
  "value",
5659
6263
  "defaultValue",
5660
6264
  "onValueChange",
@@ -5665,7 +6269,10 @@
5665
6269
  "aliases": [
5666
6270
  "tab bar",
5667
6271
  "tab group",
5668
- "tabbed interface"
6272
+ "tabbed interface",
6273
+ "underline tabs",
6274
+ "promoted tab row",
6275
+ "promoted filter tabs"
5669
6276
  ],
5670
6277
  "doNotUseFor": [
5671
6278
  "sections that must be completed in order (use Stepper)",
@@ -5688,18 +6295,30 @@
5688
6295
  "fileKey": "p3krmC8DBUgqpbq6cLzaal",
5689
6296
  "nodes": [
5690
6297
  {
5691
- "nodeId": "183:539",
6298
+ "nodeId": "34619:82902",
5692
6299
  "figmaName": "Tabs",
5693
- "kind": "component",
6300
+ "kind": "componentSet",
5694
6301
  "export": "Tabs",
5695
- "note": "Figma node is a demo composition"
6302
+ "note": "Rebuilt on Figma branch task/DS-946-tab-variant (DS-946); the set draws the TabsList row with four Tabs / Trigger instances",
6303
+ "axes": [
6304
+ {
6305
+ "figma": "Variant",
6306
+ "code": "variant"
6307
+ }
6308
+ ]
5696
6309
  },
5697
6310
  {
5698
- "nodeId": "183:532",
6311
+ "nodeId": "34619:82769",
5699
6312
  "figmaName": "Tabs / Trigger",
5700
6313
  "kind": "componentSet",
5701
6314
  "export": "TabsTrigger",
6315
+ "note": "Rebuilt on Figma branch task/DS-946-tab-variant (DS-946)",
5702
6316
  "axes": [
6317
+ {
6318
+ "figma": "Variant",
6319
+ "code": "variant",
6320
+ "note": "Inherited from the Tabs root via context; the trigger has no variant prop of its own"
6321
+ },
5703
6322
  {
5704
6323
  "figma": "Active",
5705
6324
  "exempt": "interaction-state",
@@ -5718,7 +6337,7 @@
5718
6337
  "unmappedExports": [
5719
6338
  {
5720
6339
  "export": "TabsList",
5721
- "reason": "Drawn implicitly as the trigger row in the Tabs demo node"
6340
+ "reason": "Drawn as the Tabs component set itself (Variant=Default pill list / Variant=Underline bordered row)"
5722
6341
  },
5723
6342
  {
5724
6343
  "export": "TabsContent",
@@ -5965,7 +6584,7 @@
5965
6584
  "align",
5966
6585
  "sideOffset"
5967
6586
  ],
5968
- "description": "Hover tooltip with configurable positioning",
6587
+ "description": "Toggletip: hover on desktop, tap to toggle on touch (stays open for copying text), dismiss via click-outside or Escape",
5969
6588
  "aliases": [
5970
6589
  "hover tip",
5971
6590
  "info tip",
@@ -5973,8 +6592,7 @@
5973
6592
  ],
5974
6593
  "doNotUseFor": [
5975
6594
  "clickable content like links or buttons (use Popover)",
5976
- "content longer than a sentence (use HoverCard or Popover)",
5977
- "critical info for touch-only users (hover has no touch equivalent)"
6595
+ "content longer than a sentence (use HoverCard or Popover)"
5978
6596
  ],
5979
6597
  "replaces": [
5980
6598
  "title attribute"
@@ -6827,6 +7445,13 @@
6827
7445
  "doNotUseFor": [
6828
7446
  "simple, shallow navigation (a plain nav list may be simpler)",
6829
7447
  "small screens with a permanently visible sidebar (prefer Offcanvas over None)"
7448
+ ],
7449
+ "knownGaps": [
7450
+ {
7451
+ "description": "SidebarMenuCollapsibleContent already renders the SidebarMenuSub list; nesting another SidebarMenuSub inside it stacks both indents and leaves ~100px for labels at the default 288px width, so sub-items wrap",
7452
+ "ticket": "DS-1029",
7453
+ "workaround": "Place SidebarMenuSubItem directly inside SidebarMenuCollapsibleContent and pass variant on it; use a standalone SidebarMenuSub only outside a collapsible"
7454
+ }
6830
7455
  ]
6831
7456
  }
6832
7457
  ],