@brightlocal/ui-components 2.27.0 → 3.1.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.
- package/README.md +7 -1
- package/component-meta.json +568 -143
- package/deprecations.json +298 -1
- package/dist/accordion.cjs +1 -1
- package/dist/accordion.d.ts +36 -0
- package/dist/accordion.d.ts.map +1 -1
- package/dist/accordion.js +74 -61
- package/dist/alert-dialog.cjs +1 -1
- package/dist/alert-dialog.js +18 -18
- package/dist/alert.cjs +1 -1
- package/dist/alert.d.ts +11 -1
- package/dist/alert.d.ts.map +1 -1
- package/dist/alert.js +31 -28
- package/dist/avatar.cjs +1 -1
- package/dist/avatar.js +4 -4
- package/dist/badge.cjs +1 -1
- package/dist/badge.d.ts.map +1 -1
- package/dist/badge.js +15 -11
- package/dist/blocks/empty-state.cjs +1 -0
- package/dist/blocks/empty-state.d.ts +172 -0
- package/dist/blocks/empty-state.d.ts.map +1 -0
- package/dist/blocks/empty-state.js +147 -0
- package/dist/blocks/input-list.cjs +2 -2
- package/dist/blocks/input-list.d.ts.map +1 -1
- package/dist/blocks/input-list.js +124 -108
- package/dist/blocks/progress-state.cjs +1 -0
- package/dist/blocks/{progress-screen.d.ts → progress-state.d.ts} +30 -18
- package/dist/blocks/progress-state.d.ts.map +1 -0
- package/dist/blocks/{progress-screen.js → progress-state.js} +100 -71
- package/dist/blocks/sidebar.cjs +1 -1
- package/dist/blocks/sidebar.d.ts.map +1 -1
- package/dist/blocks/sidebar.js +160 -161
- package/dist/breadcrumb.cjs +1 -1
- package/dist/breadcrumb.js +1 -1
- package/dist/button-group.cjs +1 -0
- package/dist/button-group.d.ts +36 -0
- package/dist/button-group.d.ts.map +1 -0
- package/dist/button-group.js +47 -0
- package/dist/button.cjs +1 -1
- package/dist/button.js +12 -12
- package/dist/calendar.cjs +1 -1
- package/dist/calendar.d.ts.map +1 -1
- package/dist/calendar.js +37 -38
- package/dist/callout.cjs +1 -1
- package/dist/callout.d.ts +24 -2
- package/dist/callout.d.ts.map +1 -1
- package/dist/callout.js +57 -55
- package/dist/card.cjs +1 -1
- package/dist/card.d.ts +42 -3
- package/dist/card.d.ts.map +1 -1
- package/dist/card.js +102 -91
- package/dist/chart-empty.cjs +1 -0
- package/dist/chart-empty.d.ts +59 -0
- package/dist/chart-empty.d.ts.map +1 -0
- package/dist/chart-empty.js +29 -0
- package/dist/chart.cjs +6 -6
- package/dist/chart.d.ts +46 -13
- package/dist/chart.d.ts.map +1 -1
- package/dist/chart.js +172 -157
- package/dist/chip.cjs +1 -1
- package/dist/chip.d.ts +38 -4
- package/dist/chip.d.ts.map +1 -1
- package/dist/chip.js +100 -84
- package/dist/combobox.cjs +2 -2
- package/dist/combobox.d.ts.map +1 -1
- package/dist/combobox.js +81 -79
- package/dist/command.cjs +1 -1
- package/dist/command.d.ts +23 -1
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +248 -225
- package/dist/context-menu.cjs +1 -1
- package/dist/context-menu.d.ts.map +1 -1
- package/dist/context-menu.js +26 -29
- package/dist/data-table.cjs +1 -1
- package/dist/data-table.d.ts +75 -10
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +346 -334
- package/dist/date-picker.cjs +1 -1
- package/dist/date-picker.d.ts +13 -5
- package/dist/date-picker.d.ts.map +1 -1
- package/dist/date-picker.js +54 -53
- package/dist/description.cjs +1 -1
- package/dist/description.js +5 -5
- package/dist/dialog.cjs +1 -1
- package/dist/dialog.js +20 -20
- package/dist/drawer.cjs +1 -1
- package/dist/drawer.d.ts.map +1 -1
- package/dist/drawer.js +8 -11
- package/dist/dropdown-menu.cjs +1 -1
- package/dist/dropdown-menu.d.ts.map +1 -1
- package/dist/dropdown-menu.js +17 -20
- package/dist/field.cjs +1 -1
- package/dist/field.d.ts +8 -1
- package/dist/field.d.ts.map +1 -1
- package/dist/field.js +96 -65
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +130 -12
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +146 -127
- package/dist/grid.cjs +1 -0
- package/dist/grid.d.ts +56 -0
- package/dist/grid.d.ts.map +1 -0
- package/dist/grid.js +32 -0
- package/dist/header.d.ts +13 -0
- package/dist/header.d.ts.map +1 -1
- package/dist/hooks/use-delayed-pending.cjs +1 -0
- package/dist/hooks/use-delayed-pending.d.ts +34 -0
- package/dist/hooks/use-delayed-pending.d.ts.map +1 -0
- package/dist/hooks/use-delayed-pending.js +17 -0
- package/dist/hooks/use-mobile.cjs +1 -0
- package/dist/hooks/use-mobile.js +8 -0
- package/dist/hover-card.cjs +1 -1
- package/dist/hover-card.js +13 -13
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +9 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +554 -527
- package/dist/input-chip.cjs +1 -1
- package/dist/input-chip.js +25 -25
- package/dist/input-group.cjs +1 -1
- package/dist/input-group.js +9 -9
- package/dist/input-otp.cjs +1 -1
- package/dist/input-otp.js +9 -9
- package/dist/input-password.cjs +1 -1
- package/dist/input-password.d.ts +17 -9
- package/dist/input-password.d.ts.map +1 -1
- package/dist/input-password.js +73 -72
- package/dist/input.cjs +1 -1
- package/dist/input.js +9 -9
- package/dist/label.cjs +1 -1
- package/dist/label.d.ts.map +1 -1
- package/dist/label.js +25 -28
- package/dist/lib/block-illustration.cjs +1 -0
- package/dist/lib/block-illustration.d.ts +28 -0
- package/dist/lib/block-illustration.d.ts.map +1 -0
- package/dist/lib/block-illustration.js +21 -0
- package/dist/lib/empty-canvas.cjs +1 -0
- package/dist/lib/empty-canvas.d.ts +27 -0
- package/dist/lib/empty-canvas.d.ts.map +1 -0
- package/dist/lib/empty-canvas.js +62 -0
- package/dist/lib/empty-chip.cjs +1 -0
- package/dist/lib/empty-chip.d.ts +4 -0
- package/dist/lib/empty-chip.d.ts.map +1 -0
- package/dist/lib/empty-chip.js +13 -0
- package/dist/lib/optical-center.cjs +1 -0
- package/dist/lib/optical-center.d.ts +12 -0
- package/dist/lib/optical-center.d.ts.map +1 -0
- package/dist/lib/optical-center.js +11 -0
- package/dist/lib/utils.cjs +1 -1
- package/dist/lib/utils.d.ts.map +1 -1
- package/dist/lib/utils.js +28 -5
- package/dist/list.cjs +1 -1
- package/dist/list.d.ts.map +1 -1
- package/dist/list.js +62 -58
- package/dist/map.cjs +1 -1
- package/dist/map.d.ts +60 -2
- package/dist/map.d.ts.map +1 -1
- package/dist/map.js +187 -164
- package/dist/media-empty.cjs +1 -0
- package/dist/media-empty.d.ts +72 -0
- package/dist/media-empty.d.ts.map +1 -0
- package/dist/media-empty.js +45 -0
- package/dist/menubar.cjs +1 -1
- package/dist/menubar.d.ts.map +1 -1
- package/dist/menubar.js +17 -20
- package/dist/navigation-menu.cjs +1 -1
- package/dist/navigation-menu.js +7 -7
- package/dist/pagination.cjs +1 -1
- package/dist/pagination.d.ts +130 -1
- package/dist/pagination.d.ts.map +1 -1
- package/dist/pagination.js +193 -102
- package/dist/progress.cjs +1 -1
- package/dist/progress.d.ts +2 -26
- package/dist/progress.d.ts.map +1 -1
- package/dist/progress.js +79 -118
- package/dist/scroll-area.cjs +1 -1
- package/dist/scroll-area.d.ts +15 -6
- package/dist/scroll-area.d.ts.map +1 -1
- package/dist/scroll-area.js +38 -36
- package/dist/select.cjs +2 -2
- package/dist/select.d.ts +13 -2
- package/dist/select.d.ts.map +1 -1
- package/dist/select.js +92 -87
- package/dist/separator.cjs +1 -1
- package/dist/separator.js +8 -8
- package/dist/sheet.cjs +1 -1
- package/dist/sheet.js +2 -2
- package/dist/skeleton.cjs +1 -1
- package/dist/skeleton.d.ts +38 -3
- package/dist/skeleton.d.ts.map +1 -1
- package/dist/skeleton.js +43 -20
- package/dist/sonner.cjs +1 -1
- package/dist/sonner.js +26 -26
- package/dist/stepper.cjs +1 -1
- package/dist/stepper.js +40 -40
- package/dist/table.cjs +1 -1
- package/dist/table.d.ts.map +1 -1
- package/dist/table.js +31 -28
- package/dist/tabs.cjs +1 -1
- package/dist/tabs.js +1 -1
- package/dist/text-reveal-motion.d.ts +10 -0
- package/dist/text-reveal-motion.d.ts.map +1 -1
- package/dist/textarea.cjs +1 -1
- package/dist/textarea.js +11 -11
- package/dist/toggle.cjs +1 -1
- package/dist/toggle.js +8 -8
- package/dist/tooltip.cjs +1 -1
- package/dist/tooltip.js +8 -8
- package/dist/typography-heading.cjs +1 -0
- package/dist/typography-heading.d.ts +129 -0
- package/dist/typography-heading.d.ts.map +1 -0
- package/dist/typography-heading.js +95 -0
- package/dist/typography-text.cjs +1 -0
- package/dist/typography-text.d.ts +127 -0
- package/dist/typography-text.d.ts.map +1 -0
- package/dist/typography-text.js +92 -0
- package/dist/typography.d.ts +13 -0
- package/dist/typography.d.ts.map +1 -1
- package/package.json +35 -7
- package/src/blocks/empty-state.tsx +412 -0
- package/src/blocks/input-list.tsx +66 -36
- package/src/blocks/{progress-screen.tsx → progress-state.tsx} +154 -93
- package/src/blocks/sidebar.tsx +25 -26
- package/src/components/accordion.tsx +82 -27
- package/src/components/alert-dialog.tsx +2 -2
- package/src/components/alert.tsx +27 -13
- package/src/components/avatar.tsx +1 -1
- package/src/components/badge.tsx +8 -4
- package/src/components/breadcrumb.tsx +1 -1
- package/src/components/button-group.tsx +112 -0
- package/src/components/button.tsx +4 -4
- package/src/components/calendar.tsx +5 -6
- package/src/components/callout.tsx +48 -15
- package/src/components/card.tsx +89 -19
- package/src/components/chart-empty.tsx +116 -0
- package/src/components/chart.tsx +103 -32
- package/src/components/chip.tsx +88 -13
- package/src/components/combobox.tsx +12 -10
- package/src/components/command.tsx +64 -13
- package/src/components/context-menu.tsx +6 -9
- package/src/components/data-table.tsx +135 -20
- package/src/components/date-picker.tsx +18 -7
- package/src/components/description.tsx +1 -1
- package/src/components/dialog.tsx +2 -2
- package/src/components/drawer.tsx +2 -5
- package/src/components/dropdown-menu.tsx +8 -11
- package/src/components/field.tsx +89 -16
- package/src/components/global-layout.tsx +210 -39
- package/src/components/grid.tsx +130 -0
- package/src/components/header.tsx +13 -0
- package/src/components/hover-card.tsx +1 -1
- package/src/components/input-chip.tsx +1 -1
- package/src/components/input-group.tsx +1 -1
- package/src/components/input-otp.tsx +1 -1
- package/src/components/input-password.tsx +24 -12
- package/src/components/input.tsx +1 -1
- package/src/components/label.tsx +10 -13
- package/src/components/list.tsx +13 -9
- package/src/components/map.tsx +101 -5
- package/src/components/media-empty.tsx +156 -0
- package/src/components/menubar.tsx +7 -10
- package/src/components/navigation-menu.tsx +1 -1
- package/src/components/pagination.tsx +286 -1
- package/src/components/progress.tsx +35 -113
- package/src/components/scroll-area.tsx +23 -10
- package/src/components/select.tsx +35 -10
- package/src/components/separator.tsx +1 -1
- package/src/components/sheet.tsx +2 -2
- package/src/components/skeleton.tsx +78 -7
- package/src/components/sonner.tsx +2 -2
- package/src/components/stepper.tsx +3 -3
- package/src/components/table.tsx +6 -3
- package/src/components/tabs.tsx +1 -1
- package/src/components/text-reveal-motion.tsx +10 -0
- package/src/components/textarea.tsx +1 -1
- package/src/components/toggle.tsx +1 -1
- package/src/components/tooltip.tsx +1 -1
- package/src/components/typography-heading.tsx +253 -0
- package/src/components/typography-text.tsx +250 -0
- package/src/components/typography.tsx +13 -0
- package/src/hooks/use-delayed-pending.ts +60 -0
- package/src/index.ts +11 -1
- package/src/lib/block-illustration.tsx +88 -0
- package/src/lib/empty-canvas.tsx +128 -0
- package/src/lib/empty-chip.ts +24 -0
- package/src/lib/optical-center.tsx +45 -0
- package/src/lib/utils.ts +26 -0
- package/dist/blocks/progress-screen.cjs +0 -1
- package/dist/blocks/progress-screen.d.ts.map +0 -1
package/component-meta.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@brightlocal/ui-components",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "3.1.0",
|
|
4
4
|
"description": "Machine-readable registry of all components in the BrightLocal Design System",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
@@ -104,7 +104,8 @@
|
|
|
104
104
|
"props": [
|
|
105
105
|
"title",
|
|
106
106
|
"description",
|
|
107
|
-
"action"
|
|
107
|
+
"action",
|
|
108
|
+
"asChild"
|
|
108
109
|
],
|
|
109
110
|
"description": "Status alert messages with semantic variants",
|
|
110
111
|
"aliases": [
|
|
@@ -760,6 +761,48 @@
|
|
|
760
761
|
"figmaOnly": []
|
|
761
762
|
}
|
|
762
763
|
},
|
|
764
|
+
{
|
|
765
|
+
"name": "ButtonGroup",
|
|
766
|
+
"import": "@brightlocal/ui-components/button-group",
|
|
767
|
+
"category": "interactive",
|
|
768
|
+
"exports": [
|
|
769
|
+
"ButtonGroup",
|
|
770
|
+
"ButtonGroupSeparator"
|
|
771
|
+
],
|
|
772
|
+
"compound": true,
|
|
773
|
+
"dataHookRequired": true,
|
|
774
|
+
"variants": {},
|
|
775
|
+
"props": [],
|
|
776
|
+
"description": "Joins Buttons and a Select trigger into one attached control with merged borders",
|
|
777
|
+
"aliases": [
|
|
778
|
+
"button group",
|
|
779
|
+
"attached buttons",
|
|
780
|
+
"split button",
|
|
781
|
+
"segmented actions",
|
|
782
|
+
"run navigator"
|
|
783
|
+
],
|
|
784
|
+
"whenToUse": [
|
|
785
|
+
"Prev/next steppers attached around a Select (RunNavigator recipe)",
|
|
786
|
+
"A primary action with an attached menu trigger (SplitButton recipe)",
|
|
787
|
+
"A row of related actions that should read as one control"
|
|
788
|
+
],
|
|
789
|
+
"doNotUseFor": [
|
|
790
|
+
"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)",
|
|
792
|
+
"attaching icons or buttons to a text input (use InputGroup)"
|
|
793
|
+
],
|
|
794
|
+
"states": [
|
|
795
|
+
"default",
|
|
796
|
+
"hover",
|
|
797
|
+
"focus",
|
|
798
|
+
"disabled"
|
|
799
|
+
],
|
|
800
|
+
"a11yContract": [
|
|
801
|
+
"role=group on the container",
|
|
802
|
+
"icon-only child Buttons need aria-label",
|
|
803
|
+
"children keep their own focus order — no roving focus"
|
|
804
|
+
]
|
|
805
|
+
},
|
|
763
806
|
{
|
|
764
807
|
"name": "Calendar",
|
|
765
808
|
"import": "@brightlocal/ui-components/calendar",
|
|
@@ -851,7 +894,10 @@
|
|
|
851
894
|
"none"
|
|
852
895
|
]
|
|
853
896
|
},
|
|
854
|
-
"props": [
|
|
897
|
+
"props": [
|
|
898
|
+
"level",
|
|
899
|
+
"asChild"
|
|
900
|
+
],
|
|
855
901
|
"description": "Speech bubble callout for highlighting key statements or quotes",
|
|
856
902
|
"whenToUse": [
|
|
857
903
|
"Bold pull-quotes or standout statements (marketing pages, testimonials, empty states)",
|
|
@@ -900,7 +946,7 @@
|
|
|
900
946
|
"props": [
|
|
901
947
|
"maxWidth"
|
|
902
948
|
],
|
|
903
|
-
"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.",
|
|
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.",
|
|
904
950
|
"aliases": [
|
|
905
951
|
"container",
|
|
906
952
|
"panel",
|
|
@@ -1222,7 +1268,8 @@
|
|
|
1222
1268
|
"ChartRadarLabelWrapper",
|
|
1223
1269
|
"ChartPieLabelList",
|
|
1224
1270
|
"ChartPieLabelWrapper",
|
|
1225
|
-
"ChartCenterLabel"
|
|
1271
|
+
"ChartCenterLabel",
|
|
1272
|
+
"ChartEmpty"
|
|
1226
1273
|
],
|
|
1227
1274
|
"compound": true,
|
|
1228
1275
|
"dataHookRequired": true,
|
|
@@ -1252,6 +1299,42 @@
|
|
|
1252
1299
|
"a simple horizontal progress indicator (use Progress, not Radial Bar)"
|
|
1253
1300
|
]
|
|
1254
1301
|
},
|
|
1302
|
+
{
|
|
1303
|
+
"name": "ChartEmpty",
|
|
1304
|
+
"import": "@brightlocal/ui-components/chart-empty",
|
|
1305
|
+
"category": "feedback",
|
|
1306
|
+
"exports": [
|
|
1307
|
+
"ChartEmpty"
|
|
1308
|
+
],
|
|
1309
|
+
"compound": false,
|
|
1310
|
+
"dataHookRequired": true,
|
|
1311
|
+
"props": [
|
|
1312
|
+
"className",
|
|
1313
|
+
"icon",
|
|
1314
|
+
"message"
|
|
1315
|
+
],
|
|
1316
|
+
"description": "The empty-canvas treatment for a chart's plot area: a muted surface at the height the consumer reserves, a bare 32px glyph, and one quiet line — no title, no CTA, and no circle chip, because a circle on a flat surface reads as a button. Coherence contract: sibling KPIs must show an em-dash and drop their trend badges. Exported from @brightlocal/ui-components/chart-empty and from /chart; the standalone path avoids pulling Recharts in.",
|
|
1317
|
+
"i18nProps": {
|
|
1318
|
+
"ChartEmpty": {
|
|
1319
|
+
"message": "string — default: \"No data yet\""
|
|
1320
|
+
}
|
|
1321
|
+
},
|
|
1322
|
+
"aliases": [
|
|
1323
|
+
"chart empty",
|
|
1324
|
+
"empty chart",
|
|
1325
|
+
"no chart data",
|
|
1326
|
+
"empty plot"
|
|
1327
|
+
],
|
|
1328
|
+
"whenToUse": [
|
|
1329
|
+
"A chart with no data for the current scope — a new account, a report that has not run, a filter with no matches",
|
|
1330
|
+
"One card in a grid of metric siblings, where each plot gets its own quiet line"
|
|
1331
|
+
],
|
|
1332
|
+
"doNotUseFor": [
|
|
1333
|
+
"a single large chart that is the whole section and needs a way forward (use EmptyState, with a title and a CTA)",
|
|
1334
|
+
"a map surface (use MapEmpty) or a photo/video slot (use MediaEmpty)",
|
|
1335
|
+
"data that is still loading (use Skeleton)"
|
|
1336
|
+
]
|
|
1337
|
+
},
|
|
1255
1338
|
{
|
|
1256
1339
|
"name": "Checkbox",
|
|
1257
1340
|
"import": "@brightlocal/ui-components/checkbox",
|
|
@@ -1278,7 +1361,7 @@
|
|
|
1278
1361
|
"turning a system feature or state on or off (use Switch)",
|
|
1279
1362
|
"single-choice selection from a list (use RadioGroup)",
|
|
1280
1363
|
"pressed-button toolbar controls (use Toggle)",
|
|
1281
|
-
"more than ~7 options (use
|
|
1364
|
+
"more than ~7 options (use the faceted multi-select from the Filtering pattern)"
|
|
1282
1365
|
],
|
|
1283
1366
|
"replaces": [
|
|
1284
1367
|
"native <input type='checkbox'>"
|
|
@@ -1358,7 +1441,8 @@
|
|
|
1358
1441
|
"i18nProps": {
|
|
1359
1442
|
"Chip": {
|
|
1360
1443
|
"loadingLabel": "string — default: \"Loading\"",
|
|
1361
|
-
"removeAriaLabel": "string — default: \"Remove {name}\""
|
|
1444
|
+
"removeAriaLabel": "string — default: \"Remove {name}\"",
|
|
1445
|
+
"removableAriaLabel": "string — default: \"{name}, press Delete to remove\""
|
|
1362
1446
|
}
|
|
1363
1447
|
},
|
|
1364
1448
|
"description": "Removable chip/tag element",
|
|
@@ -1496,13 +1580,13 @@
|
|
|
1496
1580
|
"whenToUse": [
|
|
1497
1581
|
"Picking one item from a long, searchable list (city, category, customer)",
|
|
1498
1582
|
"Filtering options by typing, with autocomplete-style suggestions",
|
|
1499
|
-
"Async data loaded from a server as the user types"
|
|
1500
|
-
"Multi-select mode for picking several items shown as removable tags"
|
|
1583
|
+
"Async data loaded from a server as the user types"
|
|
1501
1584
|
],
|
|
1502
1585
|
"doNotUseFor": [
|
|
1503
1586
|
"short lists under 10 items (use Select)",
|
|
1504
1587
|
"free-text values not on the list (use InputChip)",
|
|
1505
|
-
"options that should all be visible for comparison (use RadioGroup or ToggleGroup)"
|
|
1588
|
+
"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)"
|
|
1506
1590
|
],
|
|
1507
1591
|
"alternatives": [
|
|
1508
1592
|
{
|
|
@@ -1999,7 +2083,7 @@
|
|
|
1999
2083
|
"children": "React.ReactNode | ((info: { selectedCount: number; totalCount: number }) => React.ReactNode) — default: \"{selectedCount} of {totalCount} row(s) selected.\""
|
|
2000
2084
|
}
|
|
2001
2085
|
},
|
|
2002
|
-
"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.",
|
|
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.",
|
|
2003
2087
|
"figma": {
|
|
2004
2088
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2005
2089
|
"status": "code-only",
|
|
@@ -2022,11 +2106,12 @@
|
|
|
2022
2106
|
"import": "@brightlocal/ui-components/date-picker",
|
|
2023
2107
|
"category": "form",
|
|
2024
2108
|
"exports": [
|
|
2025
|
-
"
|
|
2109
|
+
"DatePicker",
|
|
2026
2110
|
"DatePickerTrigger",
|
|
2027
2111
|
"DatePickerContent",
|
|
2028
2112
|
"DatePickerCalendar",
|
|
2029
|
-
"DatePickerPresets"
|
|
2113
|
+
"DatePickerPresets",
|
|
2114
|
+
"DatePickerRoot"
|
|
2030
2115
|
],
|
|
2031
2116
|
"compound": true,
|
|
2032
2117
|
"dataHookRequired": true,
|
|
@@ -2060,7 +2145,7 @@
|
|
|
2060
2145
|
"nodeId": "334:4051",
|
|
2061
2146
|
"figmaName": "Date Picker",
|
|
2062
2147
|
"kind": "componentSet",
|
|
2063
|
-
"export": "
|
|
2148
|
+
"export": "DatePicker",
|
|
2064
2149
|
"note": "Draws the closed field with label/description scaffolding. Code's `mode` variant (single|range) has no axis here — the range panel is drawn as the separate 'Date Picker / Range' set (see figmaOnly).",
|
|
2065
2150
|
"axes": [
|
|
2066
2151
|
{
|
|
@@ -2096,13 +2181,17 @@
|
|
|
2096
2181
|
{
|
|
2097
2182
|
"export": "DatePickerCalendar",
|
|
2098
2183
|
"reason": "An instance of the Calendar component inside the panel (Calendar is mapped separately)"
|
|
2184
|
+
},
|
|
2185
|
+
{
|
|
2186
|
+
"export": "DatePickerRoot",
|
|
2187
|
+
"reason": "Deprecated alias of DatePicker (DS-853)"
|
|
2099
2188
|
}
|
|
2100
2189
|
],
|
|
2101
2190
|
"figmaOnly": [
|
|
2102
2191
|
{
|
|
2103
2192
|
"nodeId": "247:3751",
|
|
2104
2193
|
"figmaName": "Date Picker / Range",
|
|
2105
|
-
"reason": "Range-mode panel drawn as a separate set (code expresses mode=range on
|
|
2194
|
+
"reason": "Range-mode panel drawn as a separate set (code expresses mode=range on DatePicker); its Size md|sm axis is Figma-only"
|
|
2106
2195
|
},
|
|
2107
2196
|
{
|
|
2108
2197
|
"nodeId": "244:3640",
|
|
@@ -2648,12 +2737,14 @@
|
|
|
2648
2737
|
"GlobalLayout",
|
|
2649
2738
|
"GlobalLayoutSidebar",
|
|
2650
2739
|
"GlobalLayoutContent",
|
|
2651
|
-
"
|
|
2740
|
+
"GlobalLayoutActions",
|
|
2652
2741
|
"GlobalLayoutContentHeader",
|
|
2653
2742
|
"GlobalLayoutBackLink",
|
|
2654
2743
|
"GlobalLayoutSubtitle",
|
|
2655
|
-
"
|
|
2656
|
-
"GlobalLayoutMobileHeader"
|
|
2744
|
+
"GlobalLayoutBody",
|
|
2745
|
+
"GlobalLayoutMobileHeader",
|
|
2746
|
+
"GlobalLayoutContentActions",
|
|
2747
|
+
"GlobalLayoutContentBody"
|
|
2657
2748
|
],
|
|
2658
2749
|
"compound": true,
|
|
2659
2750
|
"dataHookRequired": true,
|
|
@@ -2681,15 +2772,22 @@
|
|
|
2681
2772
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2682
2773
|
"nodes": [
|
|
2683
2774
|
{
|
|
2684
|
-
"nodeId": "
|
|
2775
|
+
"nodeId": "31475:4268",
|
|
2685
2776
|
"figmaName": "Global Layout",
|
|
2686
|
-
"kind": "
|
|
2777
|
+
"kind": "componentSet",
|
|
2687
2778
|
"export": "GlobalLayout",
|
|
2688
|
-
"
|
|
2779
|
+
"axes": [
|
|
2780
|
+
{
|
|
2781
|
+
"figma": "Breakpoint",
|
|
2782
|
+
"exempt": "interaction-state",
|
|
2783
|
+
"note": "Desktop | Tablet | Mobile — responsive rendering, expressed in code by CSS/container queries and the useIsMobile hook (the Sidebar becomes a Sheet at mobile), never by a prop. Figma must draw the three widths; code has no breakpoint axis."
|
|
2784
|
+
}
|
|
2785
|
+
],
|
|
2786
|
+
"note": "Assembled page template; 'Show Sheet' is a composition toggle. Was the standalone component 22951:38617 until a designer wrapped it in this set — 22951:38617 is now its Breakpoint=Desktop variant child (repointed 2026-09-11)."
|
|
2689
2787
|
},
|
|
2690
2788
|
{
|
|
2691
2789
|
"nodeId": "23470:101407",
|
|
2692
|
-
"figmaName": "Global Layout
|
|
2790
|
+
"figmaName": "Global Layout Content",
|
|
2693
2791
|
"kind": "componentSet",
|
|
2694
2792
|
"export": "GlobalLayoutContent",
|
|
2695
2793
|
"axes": [
|
|
@@ -2710,7 +2808,7 @@
|
|
|
2710
2808
|
"reason": "Drawn as a Sidebar instance inside the Global Layout composition"
|
|
2711
2809
|
},
|
|
2712
2810
|
{
|
|
2713
|
-
"export": "
|
|
2811
|
+
"export": "GlobalLayoutActions",
|
|
2714
2812
|
"reason": "Drawn inside the Content set, structural slot"
|
|
2715
2813
|
},
|
|
2716
2814
|
{
|
|
@@ -2726,12 +2824,20 @@
|
|
|
2726
2824
|
"reason": "Drawn inside the Content header composition"
|
|
2727
2825
|
},
|
|
2728
2826
|
{
|
|
2729
|
-
"export": "
|
|
2827
|
+
"export": "GlobalLayoutBody",
|
|
2730
2828
|
"reason": "Structural slot, drawn implicitly as the content area"
|
|
2731
2829
|
},
|
|
2732
2830
|
{
|
|
2733
2831
|
"export": "GlobalLayoutMobileHeader",
|
|
2734
2832
|
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
2833
|
+
},
|
|
2834
|
+
{
|
|
2835
|
+
"export": "GlobalLayoutContentActions",
|
|
2836
|
+
"reason": "Deprecated alias of GlobalLayoutActions (DS-855)"
|
|
2837
|
+
},
|
|
2838
|
+
{
|
|
2839
|
+
"export": "GlobalLayoutContentBody",
|
|
2840
|
+
"reason": "Deprecated alias of GlobalLayoutBody (DS-855)"
|
|
2735
2841
|
}
|
|
2736
2842
|
],
|
|
2737
2843
|
"figmaOnly": []
|
|
@@ -2747,6 +2853,47 @@
|
|
|
2747
2853
|
"user-adjustable panel widths (pair with Resizable)"
|
|
2748
2854
|
]
|
|
2749
2855
|
},
|
|
2856
|
+
{
|
|
2857
|
+
"name": "Grid",
|
|
2858
|
+
"import": "@brightlocal/ui-components/grid",
|
|
2859
|
+
"category": "layout",
|
|
2860
|
+
"exports": [
|
|
2861
|
+
"Grid"
|
|
2862
|
+
],
|
|
2863
|
+
"compound": false,
|
|
2864
|
+
"dataHookRequired": true,
|
|
2865
|
+
"variants": {
|
|
2866
|
+
"GridVariant": [
|
|
2867
|
+
"centered"
|
|
2868
|
+
]
|
|
2869
|
+
},
|
|
2870
|
+
"props": [
|
|
2871
|
+
"variant",
|
|
2872
|
+
"className"
|
|
2873
|
+
],
|
|
2874
|
+
"description": "The layout primitive (DS-970): one component, one closed variant axis, and the modifiers each variant actually has — a discriminated union, so a prop that does not belong to a variant does not compile. variant=\"centered\" holds one message at the page body's OPTICAL centre (38/62, not 50/50 — the page header biases the reader's eye and the ratio cancels it); every single-message screen (EmptyState size=\"lg\", ProgressState, an error page) uses the same spot, so switching between them never shifts the furniture. The ratio is deliberately not a prop. Reserved variants stack/row/cards (vertical rhythm, inline cluster, responsive collections) arrive with DS-970. Not CentredLayout: that one owns the whole viewport (min-h-screen, background, padding) for pages outside the app shell — Grid owns nothing but the position inside whatever box it is given.",
|
|
2875
|
+
"aliases": [
|
|
2876
|
+
"grid",
|
|
2877
|
+
"layout",
|
|
2878
|
+
"center",
|
|
2879
|
+
"centered",
|
|
2880
|
+
"page center",
|
|
2881
|
+
"optical center",
|
|
2882
|
+
"layout primitive",
|
|
2883
|
+
"stack",
|
|
2884
|
+
"row"
|
|
2885
|
+
],
|
|
2886
|
+
"whenToUse": [
|
|
2887
|
+
"An empty page: EmptyState size=\"lg\" composed inside variant=\"centered\"",
|
|
2888
|
+
"Any other single-message page state that must sit where ProgressState sits",
|
|
2889
|
+
"A named layout instead of hand-rolled flex/grid classNames"
|
|
2890
|
+
],
|
|
2891
|
+
"doNotUseFor": [
|
|
2892
|
+
"a whole standalone page like login or invite (use CentredLayout — it owns the viewport)",
|
|
2893
|
+
"a section's empty frame (an md EmptyState fills the frame it is given, no centring wrapper)",
|
|
2894
|
+
"a layout the vocabulary lacks (request a new variant in the DS, never a className at the call site)"
|
|
2895
|
+
]
|
|
2896
|
+
},
|
|
2750
2897
|
{
|
|
2751
2898
|
"name": "Header",
|
|
2752
2899
|
"import": "@brightlocal/ui-components/header",
|
|
@@ -2766,7 +2913,7 @@
|
|
|
2766
2913
|
"props": [
|
|
2767
2914
|
"align"
|
|
2768
2915
|
],
|
|
2769
|
-
"description": "Top-level page header container",
|
|
2916
|
+
"description": "Top-level page header container; compose the page title from TypographyHeading level={1} variant=\"page\" (text-heading-page) rather than hand-styling it",
|
|
2770
2917
|
"figma": {
|
|
2771
2918
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2772
2919
|
"nodes": [
|
|
@@ -2794,11 +2941,13 @@
|
|
|
2794
2941
|
"whenToUse": [
|
|
2795
2942
|
"Page headers with logo and navigation (Left alignment for standard app pages)",
|
|
2796
2943
|
"Centered headers on login/signup screens or branded moments (Center)",
|
|
2797
|
-
"Right-to-left contexts or intentionally right-aligned layouts (Right)"
|
|
2944
|
+
"Right-to-left contexts or intentionally right-aligned layouts (Right)",
|
|
2945
|
+
"The page title — compose TypographyHeading level={1} variant=\"page\" as a child (text-heading-page); use a lower level when the page's h1 is owned elsewhere"
|
|
2798
2946
|
],
|
|
2799
2947
|
"doNotUseFor": [
|
|
2800
2948
|
"centered or right alignment inside the main app shell (Left is the convention)",
|
|
2801
|
-
"complex multi-level navigation (pair with NavigationMenu or Sidebar)"
|
|
2949
|
+
"complex multi-level navigation (pair with NavigationMenu or Sidebar)",
|
|
2950
|
+
"a second title on the same screen — that is a section (TypographyHeading variant=\"section\")"
|
|
2802
2951
|
]
|
|
2803
2952
|
},
|
|
2804
2953
|
{
|
|
@@ -3167,10 +3316,11 @@
|
|
|
3167
3316
|
"import": "@brightlocal/ui-components/input-password",
|
|
3168
3317
|
"category": "form",
|
|
3169
3318
|
"exports": [
|
|
3170
|
-
"
|
|
3319
|
+
"InputPassword",
|
|
3171
3320
|
"InputPasswordField",
|
|
3172
3321
|
"InputPasswordToggle",
|
|
3173
|
-
"InputPasswordStrength"
|
|
3322
|
+
"InputPasswordStrength",
|
|
3323
|
+
"InputPasswordRoot"
|
|
3174
3324
|
],
|
|
3175
3325
|
"compound": false,
|
|
3176
3326
|
"dataHookRequired": true,
|
|
@@ -3194,7 +3344,7 @@
|
|
|
3194
3344
|
"nodeId": "25242:1860",
|
|
3195
3345
|
"figmaName": "Input Password",
|
|
3196
3346
|
"kind": "componentSet",
|
|
3197
|
-
"export": "
|
|
3347
|
+
"export": "InputPassword",
|
|
3198
3348
|
"note": "Draws the assembled password field; the 'Progress' BOOLEAN corresponds to the showMeter prop (booleans are globally exempt)",
|
|
3199
3349
|
"axes": [
|
|
3200
3350
|
{
|
|
@@ -3219,6 +3369,10 @@
|
|
|
3219
3369
|
{
|
|
3220
3370
|
"export": "InputPasswordStrength",
|
|
3221
3371
|
"reason": "Drawn inside the Input Password set ('Progress' BOOLEAN toggle)"
|
|
3372
|
+
},
|
|
3373
|
+
{
|
|
3374
|
+
"export": "InputPasswordRoot",
|
|
3375
|
+
"reason": "Deprecated alias of InputPassword (DS-853)"
|
|
3222
3376
|
}
|
|
3223
3377
|
],
|
|
3224
3378
|
"figmaOnly": []
|
|
@@ -3516,11 +3670,13 @@
|
|
|
3516
3670
|
"MapClusterPin",
|
|
3517
3671
|
"mapGridPinColorMap",
|
|
3518
3672
|
"clusterPinHexColors",
|
|
3673
|
+
"resolveClusterPinColors",
|
|
3519
3674
|
"createClusterPinSvg",
|
|
3520
3675
|
"createClusterPinElement",
|
|
3521
3676
|
"MapControlButton",
|
|
3522
3677
|
"MapLoadingState",
|
|
3523
3678
|
"MapErrorState",
|
|
3679
|
+
"MapEmpty",
|
|
3524
3680
|
"MapLegend",
|
|
3525
3681
|
"MapLegendItem",
|
|
3526
3682
|
"MapPopover",
|
|
@@ -3549,16 +3705,17 @@
|
|
|
3549
3705
|
"useMapPopoverClick"
|
|
3550
3706
|
],
|
|
3551
3707
|
"props": [
|
|
3552
|
-
"variant",
|
|
3553
|
-
"value",
|
|
3554
|
-
"loading",
|
|
3555
3708
|
"animateIn",
|
|
3556
3709
|
"icon",
|
|
3557
3710
|
"iconOnly",
|
|
3711
|
+
"loading",
|
|
3712
|
+
"message",
|
|
3558
3713
|
"onRetry",
|
|
3559
|
-
"retryLoading"
|
|
3714
|
+
"retryLoading",
|
|
3715
|
+
"value",
|
|
3716
|
+
"variant"
|
|
3560
3717
|
],
|
|
3561
|
-
"description": "Vendor-agnostic map UI primitives: pins, controls, popover, loading/error states. Pattern: Recipe, not a component — the DS ships map UI primitives but not a Google Maps wrapper. Includes useMapStyles(variant) hook for built-in map style presets ('default' and 'muted') with automatic dark mode support, and useMapPopoverClick for click-to-open popover state management. MapLoadingState and MapErrorState include a border-border border. When the map has loaded, the consumer owns the container — add 'border border-border rounded-lg' to your map wrapper for consistency.",
|
|
3718
|
+
"description": "Vendor-agnostic map UI primitives: pins, controls, popover, loading/error states. Pattern: Recipe, not a component — the DS ships map UI primitives but not a Google Maps wrapper. Includes useMapStyles(variant) hook for built-in map style presets ('default' and 'muted') with automatic dark mode support, and useMapPopoverClick for click-to-open popover state management. MapLoadingState and MapErrorState include a border-border border. MapEmpty is the empty-canvas state — a muted surface, a bare glyph and one line — and deliberately does NOT draw the map background: a pinless map behind 'no data' recreates the confusion the message exists to clear up. The rule it enforces: a map never renders pinless with no message. When the map has loaded, the consumer owns the container — add 'border border-border rounded-lg' to your map wrapper for consistency.",
|
|
3562
3719
|
"aliases": [
|
|
3563
3720
|
"map pin",
|
|
3564
3721
|
"grid pin",
|
|
@@ -3568,7 +3725,10 @@
|
|
|
3568
3725
|
"map legend",
|
|
3569
3726
|
"map loading",
|
|
3570
3727
|
"map error",
|
|
3571
|
-
"local search grid"
|
|
3728
|
+
"local search grid",
|
|
3729
|
+
"map empty",
|
|
3730
|
+
"empty map",
|
|
3731
|
+
"no ranking data"
|
|
3572
3732
|
],
|
|
3573
3733
|
"whenToUse": [
|
|
3574
3734
|
"Showing locations, search-grid rankings, or map-based data with pins, clustering, and legends",
|
|
@@ -3612,6 +3772,9 @@
|
|
|
3612
3772
|
"title": "string — default: \"We couldn't load your map rankings.\"",
|
|
3613
3773
|
"message": "string — default: \"Reloading usually fixes it, and it won't use any credits\"",
|
|
3614
3774
|
"retryLabel": "string — default: \"Reload\""
|
|
3775
|
+
},
|
|
3776
|
+
"MapEmpty": {
|
|
3777
|
+
"message": "string — default: \"No data yet\""
|
|
3615
3778
|
}
|
|
3616
3779
|
},
|
|
3617
3780
|
"figma": {
|
|
@@ -3620,6 +3783,54 @@
|
|
|
3620
3783
|
"reason": "Structurally unmappable (DS-824 verdict): Google Maps runtime with pin/cluster exports; no Figma nodes exist (verified 2026-08-18)."
|
|
3621
3784
|
}
|
|
3622
3785
|
},
|
|
3786
|
+
{
|
|
3787
|
+
"name": "MediaEmpty",
|
|
3788
|
+
"import": "@brightlocal/ui-components/media-empty",
|
|
3789
|
+
"category": "feedback",
|
|
3790
|
+
"exports": [
|
|
3791
|
+
"MediaEmpty"
|
|
3792
|
+
],
|
|
3793
|
+
"compound": false,
|
|
3794
|
+
"dataHookRequired": true,
|
|
3795
|
+
"variants": {
|
|
3796
|
+
"MediaEmptyVariant": [
|
|
3797
|
+
"image",
|
|
3798
|
+
"video"
|
|
3799
|
+
]
|
|
3800
|
+
},
|
|
3801
|
+
"props": [
|
|
3802
|
+
"variant",
|
|
3803
|
+
"icon",
|
|
3804
|
+
"message",
|
|
3805
|
+
"className"
|
|
3806
|
+
],
|
|
3807
|
+
"description": "The missing-media placeholder for a media slot — location photos, card media, video wells. Same canvas family as ChartEmpty and MapEmpty: it fills the reserved frame (usually AspectRatio) with a muted surface, a bare 32px glyph, and one quiet line — no title, no actions, no chip. variant=\"image\" (default) | \"video\" picks the glyph and the default line (\"No photo available\" / \"No video available\"); icon and message stay as overrides. It owns its own background, so the frame needs no bg-muted override, and overlays on the frame (a status Badge in a corner) keep rendering above it. The glyph is the plain Image/Video icon, never ImageOff/VideoOff — this state is \"media goes here\", not \"the media is broken\".",
|
|
3808
|
+
"aliases": [
|
|
3809
|
+
"image empty",
|
|
3810
|
+
"image placeholder",
|
|
3811
|
+
"media empty",
|
|
3812
|
+
"media placeholder",
|
|
3813
|
+
"missing image",
|
|
3814
|
+
"no photo",
|
|
3815
|
+
"no video",
|
|
3816
|
+
"photo placeholder",
|
|
3817
|
+
"video empty",
|
|
3818
|
+
"video placeholder"
|
|
3819
|
+
],
|
|
3820
|
+
"whenToUse": [
|
|
3821
|
+
"A photo slot with no photo: a location without an uploaded image, a card whose media is unset"
|
|
3822
|
+
],
|
|
3823
|
+
"doNotUseFor": [
|
|
3824
|
+
"an image that failed to load (that is an error, and it should say so)",
|
|
3825
|
+
"a chart plot area (use ChartEmpty) or a map surface (use MapEmpty)",
|
|
3826
|
+
"a photo that is still on its way (use Skeleton inside the same frame)"
|
|
3827
|
+
],
|
|
3828
|
+
"i18nProps": {
|
|
3829
|
+
"MediaEmpty": {
|
|
3830
|
+
"message": "string — default: \"No photo available\""
|
|
3831
|
+
}
|
|
3832
|
+
}
|
|
3833
|
+
},
|
|
3623
3834
|
{
|
|
3624
3835
|
"name": "Menubar",
|
|
3625
3836
|
"import": "@brightlocal/ui-components/menubar",
|
|
@@ -3852,6 +4063,7 @@
|
|
|
3852
4063
|
"category": "navigation",
|
|
3853
4064
|
"exports": [
|
|
3854
4065
|
"Pagination",
|
|
4066
|
+
"PaginationControls",
|
|
3855
4067
|
"PaginationContent",
|
|
3856
4068
|
"PaginationItem",
|
|
3857
4069
|
"PaginationButton",
|
|
@@ -3865,7 +4077,11 @@
|
|
|
3865
4077
|
"variants": {},
|
|
3866
4078
|
"props": [
|
|
3867
4079
|
"page",
|
|
3868
|
-
"totalPages"
|
|
4080
|
+
"totalPages",
|
|
4081
|
+
"onPageChange",
|
|
4082
|
+
"totalItems",
|
|
4083
|
+
"pageSize",
|
|
4084
|
+
"renderCaption"
|
|
3869
4085
|
],
|
|
3870
4086
|
"hooks": [
|
|
3871
4087
|
"usePagination"
|
|
@@ -3874,6 +4090,14 @@
|
|
|
3874
4090
|
"Pagination": {
|
|
3875
4091
|
"ariaLabel": "string — default: \"Pagination\""
|
|
3876
4092
|
},
|
|
4093
|
+
"PaginationControls": {
|
|
4094
|
+
"ariaLabel": "string — default: \"Pagination\"",
|
|
4095
|
+
"prevAriaLabel": "string — default: \"Go to previous page\"",
|
|
4096
|
+
"nextAriaLabel": "string — default: \"Go to next page\"",
|
|
4097
|
+
"pageAriaLabel": "string — default: \"Go to page {page}\"",
|
|
4098
|
+
"ellipsisSrLabel": "string — default: \"More pages\"",
|
|
4099
|
+
"renderCaption": "render prop — default: \"Showing {from} to {to} of {total} results\""
|
|
4100
|
+
},
|
|
3877
4101
|
"PaginationPrevious": {
|
|
3878
4102
|
"ariaLabel": "string — default: \"Go to previous page\""
|
|
3879
4103
|
},
|
|
@@ -3927,6 +4151,10 @@
|
|
|
3927
4151
|
}
|
|
3928
4152
|
],
|
|
3929
4153
|
"unmappedExports": [
|
|
4154
|
+
{
|
|
4155
|
+
"export": "PaginationControls",
|
|
4156
|
+
"reason": "Drawn 2026-09-11 as 'Pagination / PaginationControls' (32736:183) on Figma branch n86E50CSgP4s1hLq3z4rJp — left unmapped on purpose until that branch merges, because a figma entry pointing at a branch-only node reports node-missing every night (FIG-15/FIG-21 precedent). On merge: /figma-map Pagination, pnpm figma:drift --capture, publish Code Connect. Tracked as FIG-25. NOT the same drawing as the Pagination node (208:1701): that one is the bare nav, this one adds the results caption and the full-width caption-left/nav-right layout."
|
|
4157
|
+
},
|
|
3930
4158
|
{
|
|
3931
4159
|
"export": "PaginationContent",
|
|
3932
4160
|
"reason": "Structural wrapper (the <ul>), no standalone Figma representation"
|
|
@@ -3939,9 +4167,10 @@
|
|
|
3939
4167
|
"figmaOnly": []
|
|
3940
4168
|
},
|
|
3941
4169
|
"whenToUse": [
|
|
3942
|
-
"Moving between pages of a large result set with page numbers or next/previous controls",
|
|
4170
|
+
"Moving between pages of a large result set with page numbers or next/previous controls — reach for PaginationControls first, it owns the item loop, the disabled bounds and the results caption",
|
|
3943
4171
|
"Standalone paginated views not backed by a Data Table",
|
|
3944
|
-
"Letting users jump directly to a specific page"
|
|
4172
|
+
"Letting users jump directly to a specific page",
|
|
4173
|
+
"Custom pagination layouts PaginationControls doesn't cover — compose the primitives with usePagination"
|
|
3945
4174
|
],
|
|
3946
4175
|
"doNotUseFor": [
|
|
3947
4176
|
"lists inside a Data Table (use its built-in pagination)",
|
|
@@ -4358,6 +4587,7 @@
|
|
|
4358
4587
|
"category": "layout",
|
|
4359
4588
|
"exports": [
|
|
4360
4589
|
"ScrollArea",
|
|
4590
|
+
"ScrollAreaScrollbar",
|
|
4361
4591
|
"ScrollBar"
|
|
4362
4592
|
],
|
|
4363
4593
|
"compound": true,
|
|
@@ -4378,13 +4608,17 @@
|
|
|
4378
4608
|
"figmaName": "Scroll Area",
|
|
4379
4609
|
"kind": "component",
|
|
4380
4610
|
"export": "ScrollArea",
|
|
4381
|
-
"note": "Code's orientation variant (on
|
|
4611
|
+
"note": "Code's orientation variant (on ScrollAreaScrollbar) has no Figma axis — the scrollbar is drawn vertically only"
|
|
4382
4612
|
}
|
|
4383
4613
|
],
|
|
4384
4614
|
"unmappedExports": [
|
|
4385
4615
|
{
|
|
4386
|
-
"export": "
|
|
4616
|
+
"export": "ScrollAreaScrollbar",
|
|
4387
4617
|
"reason": "Drawn implicitly inside the Scroll Area node, not a standalone Figma component"
|
|
4618
|
+
},
|
|
4619
|
+
{
|
|
4620
|
+
"export": "ScrollBar",
|
|
4621
|
+
"reason": "Deprecated alias of ScrollAreaScrollbar (DS-853)"
|
|
4388
4622
|
}
|
|
4389
4623
|
],
|
|
4390
4624
|
"figmaOnly": []
|
|
@@ -4424,7 +4658,8 @@
|
|
|
4424
4658
|
"onOpenChange",
|
|
4425
4659
|
"onClose",
|
|
4426
4660
|
"disabled",
|
|
4427
|
-
"error"
|
|
4661
|
+
"error",
|
|
4662
|
+
"hint"
|
|
4428
4663
|
],
|
|
4429
4664
|
"description": "Dropdown select input",
|
|
4430
4665
|
"aliases": [
|
|
@@ -4434,7 +4669,7 @@
|
|
|
4434
4669
|
],
|
|
4435
4670
|
"doNotUseFor": [
|
|
4436
4671
|
"long or searchable lists (use Combobox)",
|
|
4437
|
-
"picking more than one option (use
|
|
4672
|
+
"picking more than one option (use the faceted multi-select from the Filtering pattern)",
|
|
4438
4673
|
"showing every option at once (use RadioGroup)"
|
|
4439
4674
|
],
|
|
4440
4675
|
"replaces": [
|
|
@@ -4788,8 +5023,15 @@
|
|
|
4788
5023
|
"compound": false,
|
|
4789
5024
|
"dataHookRequired": false,
|
|
4790
5025
|
"variants": {},
|
|
4791
|
-
"props": [
|
|
4792
|
-
|
|
5026
|
+
"props": [
|
|
5027
|
+
"loadingLabel"
|
|
5028
|
+
],
|
|
5029
|
+
"description": "Loading placeholder with a travelling shimmer wave. Silent by default: aria-hidden with no screen-reader text, because a loading layout is many skeletons and one announcement per shape reads the whole wait out dozens of times — the region being loaded carries aria-busy and makes the single announcement. Pass loadingLabel to opt a standalone skeleton back in.",
|
|
5030
|
+
"i18nProps": {
|
|
5031
|
+
"Skeleton": {
|
|
5032
|
+
"loadingLabel": "string — no default; unset, the skeleton is aria-hidden and silent"
|
|
5033
|
+
}
|
|
5034
|
+
},
|
|
4793
5035
|
"figma": {
|
|
4794
5036
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4795
5037
|
"nodes": [
|
|
@@ -4817,7 +5059,8 @@
|
|
|
4817
5059
|
"doNotUseFor": [
|
|
4818
5060
|
"waits of unknown length or shape (a plain spinner is more honest)",
|
|
4819
5061
|
"near-instant loads (a brief flash feels jarring)",
|
|
4820
|
-
"error states (switch to a real error message)"
|
|
5062
|
+
"error states (switch to a real error message)",
|
|
5063
|
+
"announcing the wait per shape — the loading region owns aria-busy and the one announcement"
|
|
4821
5064
|
]
|
|
4822
5065
|
},
|
|
4823
5066
|
{
|
|
@@ -5260,7 +5503,7 @@
|
|
|
5260
5503
|
{
|
|
5261
5504
|
"description": "TableCaption is deprecated since 2.24.0 and will be removed in the next major version",
|
|
5262
5505
|
"ticket": "DS-779",
|
|
5263
|
-
"workaround": "Name the table with a heading (e.g.
|
|
5506
|
+
"workaround": "Name the table with a heading (e.g. TypographyHeading level={3}) and point Table at it with aria-labelledby"
|
|
5264
5507
|
},
|
|
5265
5508
|
{
|
|
5266
5509
|
"description": "No built-in sorting API — TableHead has no sortable or sortDirection prop",
|
|
@@ -5556,7 +5799,7 @@
|
|
|
5556
5799
|
"gradientFrom",
|
|
5557
5800
|
"gradientTo"
|
|
5558
5801
|
],
|
|
5559
|
-
"description": "
|
|
5802
|
+
"description": "Deprecated (DS-907): animated text reveal with rolling shape-morphing ball; removal planned once product usage is gone",
|
|
5560
5803
|
"i18nProps": {
|
|
5561
5804
|
"TextRevealMotion": {
|
|
5562
5805
|
"loadingLabel": "string — default: \"Loading\""
|
|
@@ -5568,14 +5811,11 @@
|
|
|
5568
5811
|
"reason": "Runtime text-shimmer animation — not representable as a static Figma component. Verified 2026-08-18: no Figma node exists."
|
|
5569
5812
|
},
|
|
5570
5813
|
"whenToUse": [
|
|
5571
|
-
"
|
|
5572
|
-
"Marketing or product moments where delight during a wait state is desired",
|
|
5573
|
-
"Cycling through a few short status phrases with a distinctive animated treatment"
|
|
5814
|
+
"Do not adopt: deprecated since 2.28.0 (DS-907); removal planned once product usage is gone"
|
|
5574
5815
|
],
|
|
5575
5816
|
"doNotUseFor": [
|
|
5576
|
-
"
|
|
5577
|
-
"
|
|
5578
|
-
"minimal-motion contexts (prefer a simpler static state)"
|
|
5817
|
+
"any new usage — cycling phrases on a timer violates the Loading pattern's Honesty principle",
|
|
5818
|
+
"loading states (use a section skeleton, or a named-stages running screen driven by real stage data — Patterns / Loading)"
|
|
5579
5819
|
]
|
|
5580
5820
|
},
|
|
5581
5821
|
{
|
|
@@ -5821,7 +6061,7 @@
|
|
|
5821
6061
|
"asChild",
|
|
5822
6062
|
"align"
|
|
5823
6063
|
],
|
|
5824
|
-
"description": "Semantic text components for headings, paragraphs, and inline styles",
|
|
6064
|
+
"description": "Semantic text components for headings, paragraphs, and inline styles. Deprecated (DS-714) - migrate to TypographyHeading/TypographyText",
|
|
5825
6065
|
"whenToUse": [
|
|
5826
6066
|
"Page and section headings that follow the design system type scale (H1-H4)",
|
|
5827
6067
|
"Body copy, intros, and secondary text (P, Lead, Large, Small, Muted)",
|
|
@@ -5839,101 +6079,279 @@
|
|
|
5839
6079
|
"rule": "Use Label for form input labels — Typography is for content headings and body text"
|
|
5840
6080
|
}
|
|
5841
6081
|
],
|
|
6082
|
+
"figma": {
|
|
6083
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
6084
|
+
"status": "deprecated-in-figma",
|
|
6085
|
+
"reason": "Every export in this file is @deprecated in code (DS-714 replaced the tag-coupled parts with TypographyHeading + TypographyText on the semantic type scale), and design is retiring the drawings in step: of the 13 mapped nodes, 6 were already deleted from the library by 2026-09-11 (H1 30021:14432, H4 26:234, InlineCode 37:58, Large 26:319, Small 26:324, Muted 36:56) while H2/H3/P/Blockquote/List/Code/Lead still resolve. Per-node parity on a family both sides are removing buys nothing but nightly node-missing noise, so the entry is exempted wholesale rather than trimmed node-by-node. Drop this entry outright when the deprecated exports are removed from code (FIG-26)."
|
|
6086
|
+
}
|
|
6087
|
+
},
|
|
6088
|
+
{
|
|
6089
|
+
"name": "TypographyHeading",
|
|
6090
|
+
"import": "@brightlocal/ui-components/typography-heading",
|
|
5842
6091
|
"figma": {
|
|
5843
6092
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5844
6093
|
"nodes": [
|
|
5845
6094
|
{
|
|
5846
|
-
"nodeId": "
|
|
5847
|
-
"figmaName": "
|
|
5848
|
-
"kind": "
|
|
5849
|
-
"export": "
|
|
5850
|
-
"
|
|
5851
|
-
|
|
5852
|
-
|
|
5853
|
-
|
|
5854
|
-
|
|
5855
|
-
|
|
5856
|
-
|
|
5857
|
-
|
|
5858
|
-
|
|
5859
|
-
|
|
5860
|
-
|
|
5861
|
-
|
|
5862
|
-
|
|
5863
|
-
|
|
5864
|
-
|
|
5865
|
-
|
|
5866
|
-
|
|
5867
|
-
|
|
5868
|
-
"export": "TypographyH4"
|
|
5869
|
-
},
|
|
5870
|
-
{
|
|
5871
|
-
"nodeId": "26:239",
|
|
5872
|
-
"figmaName": "Typography / P",
|
|
5873
|
-
"kind": "component",
|
|
5874
|
-
"export": "TypographyP"
|
|
5875
|
-
},
|
|
5876
|
-
{
|
|
5877
|
-
"nodeId": "26:245",
|
|
5878
|
-
"figmaName": "Typography / Blockquote",
|
|
5879
|
-
"kind": "component",
|
|
5880
|
-
"export": "TypographyBlockquote"
|
|
5881
|
-
},
|
|
5882
|
-
{
|
|
5883
|
-
"nodeId": "26:281",
|
|
5884
|
-
"figmaName": "Typography / List",
|
|
5885
|
-
"kind": "component",
|
|
5886
|
-
"export": "TypographyList"
|
|
5887
|
-
},
|
|
5888
|
-
{
|
|
5889
|
-
"nodeId": "37:58",
|
|
5890
|
-
"figmaName": "Typography / InlineCode",
|
|
5891
|
-
"kind": "component",
|
|
5892
|
-
"export": "TypographyInlineCode"
|
|
5893
|
-
},
|
|
5894
|
-
{
|
|
5895
|
-
"nodeId": "40:330",
|
|
5896
|
-
"figmaName": "Typography / Code",
|
|
5897
|
-
"kind": "component",
|
|
5898
|
-
"export": "TypographyCode"
|
|
5899
|
-
},
|
|
5900
|
-
{
|
|
5901
|
-
"nodeId": "26:314",
|
|
5902
|
-
"figmaName": "Typography / Lead",
|
|
5903
|
-
"kind": "component",
|
|
5904
|
-
"export": "TypographyLead"
|
|
5905
|
-
},
|
|
5906
|
-
{
|
|
5907
|
-
"nodeId": "26:319",
|
|
5908
|
-
"figmaName": "Typography / Large",
|
|
5909
|
-
"kind": "component",
|
|
5910
|
-
"export": "TypographyLarge"
|
|
5911
|
-
},
|
|
5912
|
-
{
|
|
5913
|
-
"nodeId": "26:324",
|
|
5914
|
-
"figmaName": "Typography / Small",
|
|
5915
|
-
"kind": "component",
|
|
5916
|
-
"export": "TypographySmall"
|
|
5917
|
-
},
|
|
5918
|
-
{
|
|
5919
|
-
"nodeId": "36:56",
|
|
5920
|
-
"figmaName": "Typography / Muted",
|
|
5921
|
-
"kind": "component",
|
|
5922
|
-
"export": "TypographyMuted"
|
|
6095
|
+
"nodeId": "31658:2480",
|
|
6096
|
+
"figmaName": "TypographyHeading",
|
|
6097
|
+
"kind": "componentSet",
|
|
6098
|
+
"export": "TypographyHeading",
|
|
6099
|
+
"axes": [
|
|
6100
|
+
{
|
|
6101
|
+
"figma": "Variant",
|
|
6102
|
+
"code": "variant"
|
|
6103
|
+
},
|
|
6104
|
+
{
|
|
6105
|
+
"figma": "Color",
|
|
6106
|
+
"code": "color"
|
|
6107
|
+
},
|
|
6108
|
+
{
|
|
6109
|
+
"figma": "Align",
|
|
6110
|
+
"code": "align"
|
|
6111
|
+
},
|
|
6112
|
+
{
|
|
6113
|
+
"figma": "Tabular",
|
|
6114
|
+
"code": "tabular"
|
|
6115
|
+
}
|
|
6116
|
+
]
|
|
5923
6117
|
}
|
|
5924
6118
|
],
|
|
5925
6119
|
"unmappedExports": [],
|
|
5926
|
-
"figmaOnly": [
|
|
6120
|
+
"figmaOnly": [],
|
|
6121
|
+
"note": "Nodes created on Figma branch Mh07XBnFfBwTDtAmxJs1kj (DS-714), since merged. The level prop is code-only (document outline). Align renamed Default->Left with Right added; Color (Default | Muted — no destructive, error text is TypographyText's role) mirrors the code color prop. Variant draws all five code values incl. Compact (DS-920) — verified 2026-09-11. Tabular is declared here but NOT drawn in the merged file (the set is 5x2x3 = 30 variants, no Tabular axis): code ships the tabular prop, Figma never got the drawings, tracked as FIG-24 and allowlisted as known drift. Tabular=True variants need the OpenType 'tabular figures' toggle applied manually by a designer (plugin API cannot set it). The toggle only matters on the Inter styles (Section/Subsection): Poppins ships no tabular figures, so on Display/Page the toggle — like the code prop — is a harmless visual no-op; a number that must align is TypographyText Metric, not a heading."
|
|
6122
|
+
},
|
|
6123
|
+
"category": "display",
|
|
6124
|
+
"exports": [
|
|
6125
|
+
"TypographyHeading"
|
|
6126
|
+
],
|
|
6127
|
+
"compound": false,
|
|
6128
|
+
"dataHookRequired": true,
|
|
6129
|
+
"variants": {
|
|
6130
|
+
"variant": [
|
|
6131
|
+
"display",
|
|
6132
|
+
"page",
|
|
6133
|
+
"section",
|
|
6134
|
+
"subsection",
|
|
6135
|
+
"compact"
|
|
6136
|
+
],
|
|
6137
|
+
"color": [
|
|
6138
|
+
"default",
|
|
6139
|
+
"muted"
|
|
6140
|
+
],
|
|
6141
|
+
"align": [
|
|
6142
|
+
"left",
|
|
6143
|
+
"center",
|
|
6144
|
+
"right"
|
|
6145
|
+
]
|
|
6146
|
+
},
|
|
6147
|
+
"props": [
|
|
6148
|
+
"level",
|
|
6149
|
+
"variant",
|
|
6150
|
+
"color",
|
|
6151
|
+
"align",
|
|
6152
|
+
"tabular",
|
|
6153
|
+
"truncate",
|
|
6154
|
+
"asChild"
|
|
6155
|
+
],
|
|
6156
|
+
"description": "Semantic heading with decoupled axes: level sets the h1-h6 tag (document outline), variant sets the visual style from the semantic type scale, color carries the colour role (DS-714)",
|
|
6157
|
+
"aliases": [
|
|
6158
|
+
"heading",
|
|
6159
|
+
"title",
|
|
6160
|
+
"page title",
|
|
6161
|
+
"section title",
|
|
6162
|
+
"subsection title",
|
|
6163
|
+
"display text"
|
|
6164
|
+
],
|
|
6165
|
+
"replaces": [
|
|
6166
|
+
"raw <h1>-<h6> tags",
|
|
6167
|
+
"TypographyH1-TypographyH4 (deprecated, DS-714)"
|
|
6168
|
+
],
|
|
6169
|
+
"whenToUse": [
|
|
6170
|
+
"Any heading: pick level from the document outline, variant from the type scale role",
|
|
6171
|
+
"Page titles (level 1, variant 'page' - exactly one per screen)",
|
|
6172
|
+
"Card/dialog/section titles that belong in the outline (variant 'section')",
|
|
6173
|
+
"Sections inside a card, alert titles, the smallest headings (variant 'subsection')"
|
|
6174
|
+
],
|
|
6175
|
+
"doNotUseFor": [
|
|
6176
|
+
"big numbers or KPIs (use TypographyText variant='metric' - loud text is not a heading)",
|
|
6177
|
+
"marketing display moments by default (variant 'display' is explicit, brand moments only)",
|
|
6178
|
+
"table column headers inside Table (th elements already carry the semantics; style as label-size text at 600, not a heading style)",
|
|
6179
|
+
"aligning numbers via tabular on display/page (Poppins ships no tabular figures - the prop is a harmless no-op there; a number that must align is an Inter style with tabular, e.g. TypographyText variant='metric' tabular)"
|
|
6180
|
+
],
|
|
6181
|
+
"alternatives": [
|
|
6182
|
+
{
|
|
6183
|
+
"component": "TypographyText",
|
|
6184
|
+
"rule": "Use TypographyText for anything that does not introduce a section - body copy, metrics, code"
|
|
6185
|
+
},
|
|
6186
|
+
{
|
|
6187
|
+
"component": "Card",
|
|
6188
|
+
"rule": "Inside Card, prefer the CardTitle export so the card owns its title slot"
|
|
6189
|
+
}
|
|
6190
|
+
]
|
|
6191
|
+
},
|
|
6192
|
+
{
|
|
6193
|
+
"name": "TypographyText",
|
|
6194
|
+
"import": "@brightlocal/ui-components/typography-text",
|
|
6195
|
+
"figma": {
|
|
6196
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
6197
|
+
"nodes": [
|
|
5927
6198
|
{
|
|
5928
|
-
"nodeId": "
|
|
5929
|
-
"figmaName": "
|
|
5930
|
-
"
|
|
6199
|
+
"nodeId": "31658:49394",
|
|
6200
|
+
"figmaName": "TypographyText",
|
|
6201
|
+
"kind": "componentSet",
|
|
6202
|
+
"export": "TypographyText",
|
|
6203
|
+
"axes": [
|
|
6204
|
+
{
|
|
6205
|
+
"figma": "Variant",
|
|
6206
|
+
"code": "variant"
|
|
6207
|
+
},
|
|
6208
|
+
{
|
|
6209
|
+
"figma": "Color",
|
|
6210
|
+
"code": "color"
|
|
6211
|
+
},
|
|
6212
|
+
{
|
|
6213
|
+
"figma": "Align",
|
|
6214
|
+
"code": "align"
|
|
6215
|
+
},
|
|
6216
|
+
{
|
|
6217
|
+
"figma": "Tabular",
|
|
6218
|
+
"code": "tabular"
|
|
6219
|
+
}
|
|
6220
|
+
]
|
|
5931
6221
|
}
|
|
6222
|
+
],
|
|
6223
|
+
"unmappedExports": [],
|
|
6224
|
+
"figmaOnly": [],
|
|
6225
|
+
"note": "Nodes created on Figma branch Mh07XBnFfBwTDtAmxJs1kj (DS-714); re-run drift + publisher after the branch merges to main. Figma Align was renamed Default->Left and Right added; Muted axis became Color (Default | Muted | Destructive) mirrored by the code color prop; Tabular (True | False) axis added 2026-09-02 mirroring the tabular prop — Tabular=True variants need the OpenType 'tabular figures' toggle applied manually by a designer (plugin API cannot set it). The standalone 'label' variant was dropped from the code API 2026-09-02 and 'label-sm' followed 2026-09-03 (the text-label / text-label-sm tokens are reserved for control-owning components: Label/Field, tabs, nav, badges, chips); the Variant=Label and Variant=Label-sm variants were removed from the Figma set on those dates — parity restored. The 'figure' variant was renamed 'metric' (utility text-figure -> text-metric) 2026-09-03, mirrored as Variant=Figure -> Variant=Metric in the Figma set. Built-in tabular figures were removed from text-metric 2026-09-10 (DS-926): metric renders proportional figures and the tabular prop is its opt-in like every other variant. Figma executed as a style swap (OpenType features are read-only in every Figma API): the old typography/text-metric style was renamed typography/text-metric-tabular keeping its tabular setting and style key 3d07b4310427df053623a4b2398f7f49fd191a5a (remote usages keep rendering tabular until relinked), a new proportional typography/text-metric was created (key 44b5dfbdde71a7a66f5bceaaf73a2f42e8aea16b) with the same variable bindings, and all consumers were relinked — Tabular=False Metric variants and page samples to the new style, the nine Tabular=True Metric variants to text-metric-tabular (matching the text-body-*-tabular pattern)."
|
|
6226
|
+
},
|
|
6227
|
+
"category": "display",
|
|
6228
|
+
"exports": [
|
|
6229
|
+
"TypographyText"
|
|
6230
|
+
],
|
|
6231
|
+
"compound": false,
|
|
6232
|
+
"dataHookRequired": true,
|
|
6233
|
+
"variants": {
|
|
6234
|
+
"variant": [
|
|
6235
|
+
"body",
|
|
6236
|
+
"body-sm",
|
|
6237
|
+
"body-xs",
|
|
6238
|
+
"metric",
|
|
6239
|
+
"code"
|
|
6240
|
+
],
|
|
6241
|
+
"color": [
|
|
6242
|
+
"default",
|
|
6243
|
+
"muted",
|
|
6244
|
+
"destructive"
|
|
6245
|
+
],
|
|
6246
|
+
"align": [
|
|
6247
|
+
"left",
|
|
6248
|
+
"center",
|
|
6249
|
+
"right"
|
|
5932
6250
|
]
|
|
5933
|
-
}
|
|
6251
|
+
},
|
|
6252
|
+
"props": [
|
|
6253
|
+
"variant",
|
|
6254
|
+
"color",
|
|
6255
|
+
"tabular",
|
|
6256
|
+
"truncate",
|
|
6257
|
+
"align",
|
|
6258
|
+
"asChild"
|
|
6259
|
+
],
|
|
6260
|
+
"description": "Semantic text styled by the type scale (DS-714): variant chooses family/size/line-height/weight together; color carries the colour role - muted de-emphasises with colour only, destructive marks error text",
|
|
6261
|
+
"aliases": [
|
|
6262
|
+
"text",
|
|
6263
|
+
"paragraph",
|
|
6264
|
+
"body text",
|
|
6265
|
+
"caption",
|
|
6266
|
+
"helper text",
|
|
6267
|
+
"kpi",
|
|
6268
|
+
"stat value",
|
|
6269
|
+
"code text"
|
|
6270
|
+
],
|
|
6271
|
+
"replaces": [
|
|
6272
|
+
"raw <p>/<span> text",
|
|
6273
|
+
"TypographyP/Lead/Large/Small/Muted (deprecated, DS-714)"
|
|
6274
|
+
],
|
|
6275
|
+
"whenToUse": [
|
|
6276
|
+
"Body copy at any density (body / body-sm / body-xs)",
|
|
6277
|
+
"Large numbers only - KPIs and card scores (metric; add tabular where the figure must align or updates in place)",
|
|
6278
|
+
"IDs, keys, coordinates a user copies verbatim (code)"
|
|
6279
|
+
],
|
|
6280
|
+
"doNotUseFor": [
|
|
6281
|
+
"section titles (use TypographyHeading - text that introduces a section is a heading)",
|
|
6282
|
+
"form field labels, tabs, nav and other control text (use Label/Field for htmlFor semantics - there are no standalone label variants on purpose)",
|
|
6283
|
+
"badge/chip text (use the Badge / Chip components)"
|
|
6284
|
+
],
|
|
6285
|
+
"alternatives": [
|
|
6286
|
+
{
|
|
6287
|
+
"component": "TypographyHeading",
|
|
6288
|
+
"rule": "Use TypographyHeading when the text introduces a section of content"
|
|
6289
|
+
},
|
|
6290
|
+
{
|
|
6291
|
+
"component": "Label",
|
|
6292
|
+
"rule": "Use Label for labels tied to a form control via htmlFor"
|
|
6293
|
+
}
|
|
6294
|
+
]
|
|
5934
6295
|
}
|
|
5935
6296
|
],
|
|
5936
6297
|
"blocks": [
|
|
6298
|
+
{
|
|
6299
|
+
"name": "EmptyState",
|
|
6300
|
+
"import": "@brightlocal/ui-components/empty-state",
|
|
6301
|
+
"category": "block",
|
|
6302
|
+
"exports": [
|
|
6303
|
+
"EmptyState"
|
|
6304
|
+
],
|
|
6305
|
+
"compound": false,
|
|
6306
|
+
"dataHookRequired": true,
|
|
6307
|
+
"variants": {
|
|
6308
|
+
"EmptyStateSize": [
|
|
6309
|
+
"md",
|
|
6310
|
+
"lg"
|
|
6311
|
+
],
|
|
6312
|
+
"EmptyStateAlign": [
|
|
6313
|
+
"center",
|
|
6314
|
+
"left"
|
|
6315
|
+
]
|
|
6316
|
+
},
|
|
6317
|
+
"props": [
|
|
6318
|
+
"icon",
|
|
6319
|
+
"illustration",
|
|
6320
|
+
"title",
|
|
6321
|
+
"description",
|
|
6322
|
+
"size",
|
|
6323
|
+
"align",
|
|
6324
|
+
"titleLevel",
|
|
6325
|
+
"className"
|
|
6326
|
+
],
|
|
6327
|
+
"description": "The empty block. Four parts in reading order: a visual, a real heading, one supporting line, and the actions row — children render in source order, so the primary action goes last and lands rightmost. size sets visual prominence and nothing else — the block is pure content and owns no page layout, so position is always the consumer's composition. size=\"md\" (default) is for the box a working page gives it (a card, a panel, a zero-row table): an icon in a 40px muted chip and a 16/24 title. size=\"lg\" is for the moment the whole page has nothing to show: a 130px illustration and a 20/28 title, composed inside Grid variant=\"centered\" for the page body's optical centre — the same spot ProgressState uses. The props are a discriminated union on size: illustration exists only at lg and align only at md, so a 130px drawing inside a card will not compile. Pass the illustration without a size; the block sets it. titleLevel stays the consumer's, for the document outline. (sm is reserved — a compact row-level tier is not designed yet.)",
|
|
6328
|
+
"aliases": [
|
|
6329
|
+
"empty state",
|
|
6330
|
+
"empty block",
|
|
6331
|
+
"empty screen",
|
|
6332
|
+
"empty page",
|
|
6333
|
+
"nothing here",
|
|
6334
|
+
"no data",
|
|
6335
|
+
"no results",
|
|
6336
|
+
"zero state",
|
|
6337
|
+
"blank state",
|
|
6338
|
+
"setup screen",
|
|
6339
|
+
"first use screen",
|
|
6340
|
+
"blocking screen"
|
|
6341
|
+
],
|
|
6342
|
+
"whenToUse": [
|
|
6343
|
+
"A collection with no rows yet, inside the table's own frame — a DataTable takes the block through noResultsMessage",
|
|
6344
|
+
"A section of a working page with nothing to show — keep the heading and frame, swap the body",
|
|
6345
|
+
"A gated feature: name it, sell it, and offer an action the reader can act on",
|
|
6346
|
+
"A first-use or blocked page: size=\"lg\" inside Grid variant=\"centered\", with an illustration"
|
|
6347
|
+
],
|
|
6348
|
+
"doNotUseFor": [
|
|
6349
|
+
"a chart, map, or media slot (use ChartEmpty, MapEmpty, or MediaEmpty — a canvas keeps quiet, and those are primitives)",
|
|
6350
|
+
"a page that is generating content (use ProgressState)",
|
|
6351
|
+
"data that is still on its way (use Skeleton, which mirrors the geometry that is coming)",
|
|
6352
|
+
"something that failed (an error state — 'nothing here' and 'we could not load this' are different sentences)"
|
|
6353
|
+
]
|
|
6354
|
+
},
|
|
5937
6355
|
{
|
|
5938
6356
|
"name": "InputList",
|
|
5939
6357
|
"import": "@brightlocal/ui-components/input-list",
|
|
@@ -5972,11 +6390,11 @@
|
|
|
5972
6390
|
]
|
|
5973
6391
|
},
|
|
5974
6392
|
{
|
|
5975
|
-
"name": "
|
|
5976
|
-
"import": "@brightlocal/ui-components/progress-
|
|
6393
|
+
"name": "ProgressState",
|
|
6394
|
+
"import": "@brightlocal/ui-components/progress-state",
|
|
5977
6395
|
"category": "block",
|
|
5978
6396
|
"exports": [
|
|
5979
|
-
"
|
|
6397
|
+
"ProgressState"
|
|
5980
6398
|
],
|
|
5981
6399
|
"compound": false,
|
|
5982
6400
|
"dataHookRequired": true,
|
|
@@ -5987,14 +6405,14 @@
|
|
|
5987
6405
|
"description",
|
|
5988
6406
|
"value",
|
|
5989
6407
|
"max",
|
|
5990
|
-
"
|
|
6408
|
+
"progressLabel",
|
|
5991
6409
|
"progressUnit",
|
|
5992
6410
|
"showProgressValue",
|
|
5993
6411
|
"className"
|
|
5994
6412
|
],
|
|
5995
|
-
"description": "Generation
|
|
6413
|
+
"description": "Generation state: an illustration, title and description in a column — the tool's illustration over a determinate bar when the backend reports a percentage, and a built-in cel animation with neither bar nor status line when it does not. Pure content: compose it inside Grid variant=\"centered\" for the page body's optical centre — the same spot an empty page uses",
|
|
5996
6414
|
"i18nProps": {
|
|
5997
|
-
"
|
|
6415
|
+
"ProgressState": {
|
|
5998
6416
|
"progressLabel": "string — default: \"Generation progress\""
|
|
5999
6417
|
}
|
|
6000
6418
|
},
|
|
@@ -6007,6 +6425,13 @@
|
|
|
6007
6425
|
"fetching data for seconds (use Skeleton, which mirrors the geometry that is coming)",
|
|
6008
6426
|
"a re-run over content already on screen (keep the data at full contrast and use Button loading on the trigger)",
|
|
6009
6427
|
"a single control processing its own wait (use Button loading or Spinner)"
|
|
6428
|
+
],
|
|
6429
|
+
"aliases": [
|
|
6430
|
+
"generation screen",
|
|
6431
|
+
"progress screen"
|
|
6432
|
+
],
|
|
6433
|
+
"replaces": [
|
|
6434
|
+
"ProgressScreen"
|
|
6010
6435
|
]
|
|
6011
6436
|
},
|
|
6012
6437
|
{
|