@brightlocal/ui-components 2.27.0 → 3.0.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 +6 -1
- package/component-meta.json +480 -126
- package/deprecations.json +189 -2
- package/dist/accordion.cjs +1 -1
- package/dist/accordion.js +2 -2
- 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 +155 -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.cjs +1 -1
- package/dist/button.js +11 -11
- 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 +23 -2
- package/dist/card.d.ts.map +1 -1
- package/dist/card.js +94 -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 +6 -1
- package/dist/chart.d.ts.map +1 -1
- package/dist/chart.js +183 -183
- package/dist/chip.cjs +1 -1
- package/dist/chip.d.ts.map +1 -1
- package/dist/chip.js +5 -3
- 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.map +1 -1
- package/dist/command.js +74 -77
- 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 +44 -10
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +13 -11
- 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.map +1 -1
- package/dist/field.js +29 -25
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +27 -1
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +18 -16
- 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/hover-card.cjs +1 -1
- package/dist/hover-card.js +13 -13
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +8 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +512 -494
- 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.js +51 -51
- 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/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 +127 -1
- package/dist/pagination.d.ts.map +1 -1
- package/dist/pagination.js +189 -98
- 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/select.cjs +2 -2
- package/dist/select.d.ts.map +1 -1
- package/dist/select.js +19 -18
- 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 +116 -0
- package/dist/typography-heading.d.ts.map +1 -0
- package/dist/typography-heading.js +84 -0
- package/dist/typography-text.cjs +1 -0
- package/dist/typography-text.d.ts +113 -0
- package/dist/typography-text.d.ts.map +1 -0
- package/dist/typography-text.js +81 -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 +424 -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 +2 -2
- 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.tsx +3 -3
- package/src/components/calendar.tsx +5 -6
- package/src/components/callout.tsx +48 -15
- package/src/components/card.tsx +52 -17
- package/src/components/chart-empty.tsx +116 -0
- package/src/components/chart.tsx +43 -17
- package/src/components/chip.tsx +5 -3
- package/src/components/combobox.tsx +12 -10
- package/src/components/command.tsx +9 -10
- package/src/components/context-menu.tsx +6 -9
- package/src/components/data-table.tsx +72 -17
- 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 +8 -4
- package/src/components/global-layout.tsx +36 -3
- 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 +1 -1
- 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 +279 -1
- package/src/components/progress.tsx +35 -113
- package/src/components/select.tsx +5 -4
- 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 +229 -0
- package/src/components/typography-text.tsx +225 -0
- package/src/components/typography.tsx +13 -0
- package/src/hooks/use-delayed-pending.ts +60 -0
- package/src/index.ts +10 -1
- package/src/lib/block-illustration.tsx +88 -0
- package/src/lib/empty-canvas.tsx +128 -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.0.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": [
|
|
@@ -851,7 +852,10 @@
|
|
|
851
852
|
"none"
|
|
852
853
|
]
|
|
853
854
|
},
|
|
854
|
-
"props": [
|
|
855
|
+
"props": [
|
|
856
|
+
"level",
|
|
857
|
+
"asChild"
|
|
858
|
+
],
|
|
855
859
|
"description": "Speech bubble callout for highlighting key statements or quotes",
|
|
856
860
|
"whenToUse": [
|
|
857
861
|
"Bold pull-quotes or standout statements (marketing pages, testimonials, empty states)",
|
|
@@ -1222,7 +1226,8 @@
|
|
|
1222
1226
|
"ChartRadarLabelWrapper",
|
|
1223
1227
|
"ChartPieLabelList",
|
|
1224
1228
|
"ChartPieLabelWrapper",
|
|
1225
|
-
"ChartCenterLabel"
|
|
1229
|
+
"ChartCenterLabel",
|
|
1230
|
+
"ChartEmpty"
|
|
1226
1231
|
],
|
|
1227
1232
|
"compound": true,
|
|
1228
1233
|
"dataHookRequired": true,
|
|
@@ -1252,6 +1257,42 @@
|
|
|
1252
1257
|
"a simple horizontal progress indicator (use Progress, not Radial Bar)"
|
|
1253
1258
|
]
|
|
1254
1259
|
},
|
|
1260
|
+
{
|
|
1261
|
+
"name": "ChartEmpty",
|
|
1262
|
+
"import": "@brightlocal/ui-components/chart-empty",
|
|
1263
|
+
"category": "feedback",
|
|
1264
|
+
"exports": [
|
|
1265
|
+
"ChartEmpty"
|
|
1266
|
+
],
|
|
1267
|
+
"compound": false,
|
|
1268
|
+
"dataHookRequired": true,
|
|
1269
|
+
"props": [
|
|
1270
|
+
"className",
|
|
1271
|
+
"icon",
|
|
1272
|
+
"message"
|
|
1273
|
+
],
|
|
1274
|
+
"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.",
|
|
1275
|
+
"i18nProps": {
|
|
1276
|
+
"ChartEmpty": {
|
|
1277
|
+
"message": "string — default: \"No data yet\""
|
|
1278
|
+
}
|
|
1279
|
+
},
|
|
1280
|
+
"aliases": [
|
|
1281
|
+
"chart empty",
|
|
1282
|
+
"empty chart",
|
|
1283
|
+
"no chart data",
|
|
1284
|
+
"empty plot"
|
|
1285
|
+
],
|
|
1286
|
+
"whenToUse": [
|
|
1287
|
+
"A chart with no data for the current scope — a new account, a report that has not run, a filter with no matches",
|
|
1288
|
+
"One card in a grid of metric siblings, where each plot gets its own quiet line"
|
|
1289
|
+
],
|
|
1290
|
+
"doNotUseFor": [
|
|
1291
|
+
"a single large chart that is the whole section and needs a way forward (use EmptyState, with a title and a CTA)",
|
|
1292
|
+
"a map surface (use MapEmpty) or a photo/video slot (use MediaEmpty)",
|
|
1293
|
+
"data that is still loading (use Skeleton)"
|
|
1294
|
+
]
|
|
1295
|
+
},
|
|
1255
1296
|
{
|
|
1256
1297
|
"name": "Checkbox",
|
|
1257
1298
|
"import": "@brightlocal/ui-components/checkbox",
|
|
@@ -1278,7 +1319,7 @@
|
|
|
1278
1319
|
"turning a system feature or state on or off (use Switch)",
|
|
1279
1320
|
"single-choice selection from a list (use RadioGroup)",
|
|
1280
1321
|
"pressed-button toolbar controls (use Toggle)",
|
|
1281
|
-
"more than ~7 options (use
|
|
1322
|
+
"more than ~7 options (use the faceted multi-select from the Filtering pattern)"
|
|
1282
1323
|
],
|
|
1283
1324
|
"replaces": [
|
|
1284
1325
|
"native <input type='checkbox'>"
|
|
@@ -1496,13 +1537,13 @@
|
|
|
1496
1537
|
"whenToUse": [
|
|
1497
1538
|
"Picking one item from a long, searchable list (city, category, customer)",
|
|
1498
1539
|
"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"
|
|
1540
|
+
"Async data loaded from a server as the user types"
|
|
1501
1541
|
],
|
|
1502
1542
|
"doNotUseFor": [
|
|
1503
1543
|
"short lists under 10 items (use Select)",
|
|
1504
1544
|
"free-text values not on the list (use InputChip)",
|
|
1505
|
-
"options that should all be visible for comparison (use RadioGroup or ToggleGroup)"
|
|
1545
|
+
"options that should all be visible for comparison (use RadioGroup or ToggleGroup)",
|
|
1546
|
+
"picking several values at once — Combobox is single-value by design (use the faceted multi-select from the Filtering pattern)"
|
|
1506
1547
|
],
|
|
1507
1548
|
"alternatives": [
|
|
1508
1549
|
{
|
|
@@ -1999,7 +2040,7 @@
|
|
|
1999
2040
|
"children": "React.ReactNode | ((info: { selectedCount: number; totalCount: number }) => React.ReactNode) — default: \"{selectedCount} of {totalCount} row(s) selected.\""
|
|
2000
2041
|
}
|
|
2001
2042
|
},
|
|
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.",
|
|
2043
|
+
"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
2044
|
"figma": {
|
|
2004
2045
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2005
2046
|
"status": "code-only",
|
|
@@ -2681,15 +2722,22 @@
|
|
|
2681
2722
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2682
2723
|
"nodes": [
|
|
2683
2724
|
{
|
|
2684
|
-
"nodeId": "
|
|
2725
|
+
"nodeId": "31475:4268",
|
|
2685
2726
|
"figmaName": "Global Layout",
|
|
2686
|
-
"kind": "
|
|
2727
|
+
"kind": "componentSet",
|
|
2687
2728
|
"export": "GlobalLayout",
|
|
2688
|
-
"
|
|
2729
|
+
"axes": [
|
|
2730
|
+
{
|
|
2731
|
+
"figma": "Breakpoint",
|
|
2732
|
+
"exempt": "interaction-state",
|
|
2733
|
+
"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."
|
|
2734
|
+
}
|
|
2735
|
+
],
|
|
2736
|
+
"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
2737
|
},
|
|
2690
2738
|
{
|
|
2691
2739
|
"nodeId": "23470:101407",
|
|
2692
|
-
"figmaName": "Global Layout
|
|
2740
|
+
"figmaName": "Global Layout Content",
|
|
2693
2741
|
"kind": "componentSet",
|
|
2694
2742
|
"export": "GlobalLayoutContent",
|
|
2695
2743
|
"axes": [
|
|
@@ -2747,6 +2795,47 @@
|
|
|
2747
2795
|
"user-adjustable panel widths (pair with Resizable)"
|
|
2748
2796
|
]
|
|
2749
2797
|
},
|
|
2798
|
+
{
|
|
2799
|
+
"name": "Grid",
|
|
2800
|
+
"import": "@brightlocal/ui-components/grid",
|
|
2801
|
+
"category": "layout",
|
|
2802
|
+
"exports": [
|
|
2803
|
+
"Grid"
|
|
2804
|
+
],
|
|
2805
|
+
"compound": false,
|
|
2806
|
+
"dataHookRequired": true,
|
|
2807
|
+
"variants": {
|
|
2808
|
+
"GridVariant": [
|
|
2809
|
+
"centered"
|
|
2810
|
+
]
|
|
2811
|
+
},
|
|
2812
|
+
"props": [
|
|
2813
|
+
"variant",
|
|
2814
|
+
"className"
|
|
2815
|
+
],
|
|
2816
|
+
"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.",
|
|
2817
|
+
"aliases": [
|
|
2818
|
+
"grid",
|
|
2819
|
+
"layout",
|
|
2820
|
+
"center",
|
|
2821
|
+
"centered",
|
|
2822
|
+
"page center",
|
|
2823
|
+
"optical center",
|
|
2824
|
+
"layout primitive",
|
|
2825
|
+
"stack",
|
|
2826
|
+
"row"
|
|
2827
|
+
],
|
|
2828
|
+
"whenToUse": [
|
|
2829
|
+
"An empty page: EmptyState size=\"lg\" composed inside variant=\"centered\"",
|
|
2830
|
+
"Any other single-message page state that must sit where ProgressState sits",
|
|
2831
|
+
"A named layout instead of hand-rolled flex/grid classNames"
|
|
2832
|
+
],
|
|
2833
|
+
"doNotUseFor": [
|
|
2834
|
+
"a whole standalone page like login or invite (use CentredLayout — it owns the viewport)",
|
|
2835
|
+
"a section's empty frame (an md EmptyState fills the frame it is given, no centring wrapper)",
|
|
2836
|
+
"a layout the vocabulary lacks (request a new variant in the DS, never a className at the call site)"
|
|
2837
|
+
]
|
|
2838
|
+
},
|
|
2750
2839
|
{
|
|
2751
2840
|
"name": "Header",
|
|
2752
2841
|
"import": "@brightlocal/ui-components/header",
|
|
@@ -2766,7 +2855,7 @@
|
|
|
2766
2855
|
"props": [
|
|
2767
2856
|
"align"
|
|
2768
2857
|
],
|
|
2769
|
-
"description": "Top-level page header container",
|
|
2858
|
+
"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
2859
|
"figma": {
|
|
2771
2860
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2772
2861
|
"nodes": [
|
|
@@ -2794,11 +2883,13 @@
|
|
|
2794
2883
|
"whenToUse": [
|
|
2795
2884
|
"Page headers with logo and navigation (Left alignment for standard app pages)",
|
|
2796
2885
|
"Centered headers on login/signup screens or branded moments (Center)",
|
|
2797
|
-
"Right-to-left contexts or intentionally right-aligned layouts (Right)"
|
|
2886
|
+
"Right-to-left contexts or intentionally right-aligned layouts (Right)",
|
|
2887
|
+
"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
2888
|
],
|
|
2799
2889
|
"doNotUseFor": [
|
|
2800
2890
|
"centered or right alignment inside the main app shell (Left is the convention)",
|
|
2801
|
-
"complex multi-level navigation (pair with NavigationMenu or Sidebar)"
|
|
2891
|
+
"complex multi-level navigation (pair with NavigationMenu or Sidebar)",
|
|
2892
|
+
"a second title on the same screen — that is a section (TypographyHeading variant=\"section\")"
|
|
2802
2893
|
]
|
|
2803
2894
|
},
|
|
2804
2895
|
{
|
|
@@ -3516,11 +3607,13 @@
|
|
|
3516
3607
|
"MapClusterPin",
|
|
3517
3608
|
"mapGridPinColorMap",
|
|
3518
3609
|
"clusterPinHexColors",
|
|
3610
|
+
"resolveClusterPinColors",
|
|
3519
3611
|
"createClusterPinSvg",
|
|
3520
3612
|
"createClusterPinElement",
|
|
3521
3613
|
"MapControlButton",
|
|
3522
3614
|
"MapLoadingState",
|
|
3523
3615
|
"MapErrorState",
|
|
3616
|
+
"MapEmpty",
|
|
3524
3617
|
"MapLegend",
|
|
3525
3618
|
"MapLegendItem",
|
|
3526
3619
|
"MapPopover",
|
|
@@ -3549,16 +3642,17 @@
|
|
|
3549
3642
|
"useMapPopoverClick"
|
|
3550
3643
|
],
|
|
3551
3644
|
"props": [
|
|
3552
|
-
"variant",
|
|
3553
|
-
"value",
|
|
3554
|
-
"loading",
|
|
3555
3645
|
"animateIn",
|
|
3556
3646
|
"icon",
|
|
3557
3647
|
"iconOnly",
|
|
3648
|
+
"loading",
|
|
3649
|
+
"message",
|
|
3558
3650
|
"onRetry",
|
|
3559
|
-
"retryLoading"
|
|
3651
|
+
"retryLoading",
|
|
3652
|
+
"value",
|
|
3653
|
+
"variant"
|
|
3560
3654
|
],
|
|
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.",
|
|
3655
|
+
"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
3656
|
"aliases": [
|
|
3563
3657
|
"map pin",
|
|
3564
3658
|
"grid pin",
|
|
@@ -3568,7 +3662,10 @@
|
|
|
3568
3662
|
"map legend",
|
|
3569
3663
|
"map loading",
|
|
3570
3664
|
"map error",
|
|
3571
|
-
"local search grid"
|
|
3665
|
+
"local search grid",
|
|
3666
|
+
"map empty",
|
|
3667
|
+
"empty map",
|
|
3668
|
+
"no ranking data"
|
|
3572
3669
|
],
|
|
3573
3670
|
"whenToUse": [
|
|
3574
3671
|
"Showing locations, search-grid rankings, or map-based data with pins, clustering, and legends",
|
|
@@ -3612,6 +3709,9 @@
|
|
|
3612
3709
|
"title": "string — default: \"We couldn't load your map rankings.\"",
|
|
3613
3710
|
"message": "string — default: \"Reloading usually fixes it, and it won't use any credits\"",
|
|
3614
3711
|
"retryLabel": "string — default: \"Reload\""
|
|
3712
|
+
},
|
|
3713
|
+
"MapEmpty": {
|
|
3714
|
+
"message": "string — default: \"No data yet\""
|
|
3615
3715
|
}
|
|
3616
3716
|
},
|
|
3617
3717
|
"figma": {
|
|
@@ -3620,6 +3720,54 @@
|
|
|
3620
3720
|
"reason": "Structurally unmappable (DS-824 verdict): Google Maps runtime with pin/cluster exports; no Figma nodes exist (verified 2026-08-18)."
|
|
3621
3721
|
}
|
|
3622
3722
|
},
|
|
3723
|
+
{
|
|
3724
|
+
"name": "MediaEmpty",
|
|
3725
|
+
"import": "@brightlocal/ui-components/media-empty",
|
|
3726
|
+
"category": "feedback",
|
|
3727
|
+
"exports": [
|
|
3728
|
+
"MediaEmpty"
|
|
3729
|
+
],
|
|
3730
|
+
"compound": false,
|
|
3731
|
+
"dataHookRequired": true,
|
|
3732
|
+
"variants": {
|
|
3733
|
+
"MediaEmptyVariant": [
|
|
3734
|
+
"image",
|
|
3735
|
+
"video"
|
|
3736
|
+
]
|
|
3737
|
+
},
|
|
3738
|
+
"props": [
|
|
3739
|
+
"variant",
|
|
3740
|
+
"icon",
|
|
3741
|
+
"message",
|
|
3742
|
+
"className"
|
|
3743
|
+
],
|
|
3744
|
+
"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\".",
|
|
3745
|
+
"aliases": [
|
|
3746
|
+
"image empty",
|
|
3747
|
+
"image placeholder",
|
|
3748
|
+
"media empty",
|
|
3749
|
+
"media placeholder",
|
|
3750
|
+
"missing image",
|
|
3751
|
+
"no photo",
|
|
3752
|
+
"no video",
|
|
3753
|
+
"photo placeholder",
|
|
3754
|
+
"video empty",
|
|
3755
|
+
"video placeholder"
|
|
3756
|
+
],
|
|
3757
|
+
"whenToUse": [
|
|
3758
|
+
"A photo slot with no photo: a location without an uploaded image, a card whose media is unset"
|
|
3759
|
+
],
|
|
3760
|
+
"doNotUseFor": [
|
|
3761
|
+
"an image that failed to load (that is an error, and it should say so)",
|
|
3762
|
+
"a chart plot area (use ChartEmpty) or a map surface (use MapEmpty)",
|
|
3763
|
+
"a photo that is still on its way (use Skeleton inside the same frame)"
|
|
3764
|
+
],
|
|
3765
|
+
"i18nProps": {
|
|
3766
|
+
"MediaEmpty": {
|
|
3767
|
+
"message": "string — default: \"No photo available\""
|
|
3768
|
+
}
|
|
3769
|
+
}
|
|
3770
|
+
},
|
|
3623
3771
|
{
|
|
3624
3772
|
"name": "Menubar",
|
|
3625
3773
|
"import": "@brightlocal/ui-components/menubar",
|
|
@@ -3852,6 +4000,7 @@
|
|
|
3852
4000
|
"category": "navigation",
|
|
3853
4001
|
"exports": [
|
|
3854
4002
|
"Pagination",
|
|
4003
|
+
"PaginationControls",
|
|
3855
4004
|
"PaginationContent",
|
|
3856
4005
|
"PaginationItem",
|
|
3857
4006
|
"PaginationButton",
|
|
@@ -3865,7 +4014,11 @@
|
|
|
3865
4014
|
"variants": {},
|
|
3866
4015
|
"props": [
|
|
3867
4016
|
"page",
|
|
3868
|
-
"totalPages"
|
|
4017
|
+
"totalPages",
|
|
4018
|
+
"onPageChange",
|
|
4019
|
+
"totalItems",
|
|
4020
|
+
"pageSize",
|
|
4021
|
+
"renderCaption"
|
|
3869
4022
|
],
|
|
3870
4023
|
"hooks": [
|
|
3871
4024
|
"usePagination"
|
|
@@ -3874,6 +4027,14 @@
|
|
|
3874
4027
|
"Pagination": {
|
|
3875
4028
|
"ariaLabel": "string — default: \"Pagination\""
|
|
3876
4029
|
},
|
|
4030
|
+
"PaginationControls": {
|
|
4031
|
+
"ariaLabel": "string — default: \"Pagination\"",
|
|
4032
|
+
"prevAriaLabel": "string — default: \"Go to previous page\"",
|
|
4033
|
+
"nextAriaLabel": "string — default: \"Go to next page\"",
|
|
4034
|
+
"pageAriaLabel": "string — default: \"Go to page {page}\"",
|
|
4035
|
+
"ellipsisSrLabel": "string — default: \"More pages\"",
|
|
4036
|
+
"renderCaption": "render prop — default: \"Showing {from} to {to} of {total} results\""
|
|
4037
|
+
},
|
|
3877
4038
|
"PaginationPrevious": {
|
|
3878
4039
|
"ariaLabel": "string — default: \"Go to previous page\""
|
|
3879
4040
|
},
|
|
@@ -3927,6 +4088,10 @@
|
|
|
3927
4088
|
}
|
|
3928
4089
|
],
|
|
3929
4090
|
"unmappedExports": [
|
|
4091
|
+
{
|
|
4092
|
+
"export": "PaginationControls",
|
|
4093
|
+
"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."
|
|
4094
|
+
},
|
|
3930
4095
|
{
|
|
3931
4096
|
"export": "PaginationContent",
|
|
3932
4097
|
"reason": "Structural wrapper (the <ul>), no standalone Figma representation"
|
|
@@ -3939,9 +4104,10 @@
|
|
|
3939
4104
|
"figmaOnly": []
|
|
3940
4105
|
},
|
|
3941
4106
|
"whenToUse": [
|
|
3942
|
-
"Moving between pages of a large result set with page numbers or next/previous controls",
|
|
4107
|
+
"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
4108
|
"Standalone paginated views not backed by a Data Table",
|
|
3944
|
-
"Letting users jump directly to a specific page"
|
|
4109
|
+
"Letting users jump directly to a specific page",
|
|
4110
|
+
"Custom pagination layouts PaginationControls doesn't cover — compose the primitives with usePagination"
|
|
3945
4111
|
],
|
|
3946
4112
|
"doNotUseFor": [
|
|
3947
4113
|
"lists inside a Data Table (use its built-in pagination)",
|
|
@@ -4434,7 +4600,7 @@
|
|
|
4434
4600
|
],
|
|
4435
4601
|
"doNotUseFor": [
|
|
4436
4602
|
"long or searchable lists (use Combobox)",
|
|
4437
|
-
"picking more than one option (use
|
|
4603
|
+
"picking more than one option (use the faceted multi-select from the Filtering pattern)",
|
|
4438
4604
|
"showing every option at once (use RadioGroup)"
|
|
4439
4605
|
],
|
|
4440
4606
|
"replaces": [
|
|
@@ -4788,8 +4954,15 @@
|
|
|
4788
4954
|
"compound": false,
|
|
4789
4955
|
"dataHookRequired": false,
|
|
4790
4956
|
"variants": {},
|
|
4791
|
-
"props": [
|
|
4792
|
-
|
|
4957
|
+
"props": [
|
|
4958
|
+
"loadingLabel"
|
|
4959
|
+
],
|
|
4960
|
+
"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.",
|
|
4961
|
+
"i18nProps": {
|
|
4962
|
+
"Skeleton": {
|
|
4963
|
+
"loadingLabel": "string — no default; unset, the skeleton is aria-hidden and silent"
|
|
4964
|
+
}
|
|
4965
|
+
},
|
|
4793
4966
|
"figma": {
|
|
4794
4967
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4795
4968
|
"nodes": [
|
|
@@ -4817,7 +4990,8 @@
|
|
|
4817
4990
|
"doNotUseFor": [
|
|
4818
4991
|
"waits of unknown length or shape (a plain spinner is more honest)",
|
|
4819
4992
|
"near-instant loads (a brief flash feels jarring)",
|
|
4820
|
-
"error states (switch to a real error message)"
|
|
4993
|
+
"error states (switch to a real error message)",
|
|
4994
|
+
"announcing the wait per shape — the loading region owns aria-busy and the one announcement"
|
|
4821
4995
|
]
|
|
4822
4996
|
},
|
|
4823
4997
|
{
|
|
@@ -5260,7 +5434,7 @@
|
|
|
5260
5434
|
{
|
|
5261
5435
|
"description": "TableCaption is deprecated since 2.24.0 and will be removed in the next major version",
|
|
5262
5436
|
"ticket": "DS-779",
|
|
5263
|
-
"workaround": "Name the table with a heading (e.g.
|
|
5437
|
+
"workaround": "Name the table with a heading (e.g. TypographyHeading level={3}) and point Table at it with aria-labelledby"
|
|
5264
5438
|
},
|
|
5265
5439
|
{
|
|
5266
5440
|
"description": "No built-in sorting API — TableHead has no sortable or sortDirection prop",
|
|
@@ -5556,7 +5730,7 @@
|
|
|
5556
5730
|
"gradientFrom",
|
|
5557
5731
|
"gradientTo"
|
|
5558
5732
|
],
|
|
5559
|
-
"description": "
|
|
5733
|
+
"description": "Deprecated (DS-907): animated text reveal with rolling shape-morphing ball; removal planned once product usage is gone",
|
|
5560
5734
|
"i18nProps": {
|
|
5561
5735
|
"TextRevealMotion": {
|
|
5562
5736
|
"loadingLabel": "string — default: \"Loading\""
|
|
@@ -5568,14 +5742,11 @@
|
|
|
5568
5742
|
"reason": "Runtime text-shimmer animation — not representable as a static Figma component. Verified 2026-08-18: no Figma node exists."
|
|
5569
5743
|
},
|
|
5570
5744
|
"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"
|
|
5745
|
+
"Do not adopt: deprecated since 2.28.0 (DS-907); removal planned once product usage is gone"
|
|
5574
5746
|
],
|
|
5575
5747
|
"doNotUseFor": [
|
|
5576
|
-
"
|
|
5577
|
-
"
|
|
5578
|
-
"minimal-motion contexts (prefer a simpler static state)"
|
|
5748
|
+
"any new usage — cycling phrases on a timer violates the Loading pattern's Honesty principle",
|
|
5749
|
+
"loading states (use a section skeleton, or a named-stages running screen driven by real stage data — Patterns / Loading)"
|
|
5579
5750
|
]
|
|
5580
5751
|
},
|
|
5581
5752
|
{
|
|
@@ -5821,7 +5992,7 @@
|
|
|
5821
5992
|
"asChild",
|
|
5822
5993
|
"align"
|
|
5823
5994
|
],
|
|
5824
|
-
"description": "Semantic text components for headings, paragraphs, and inline styles",
|
|
5995
|
+
"description": "Semantic text components for headings, paragraphs, and inline styles. Deprecated (DS-714) - migrate to TypographyHeading/TypographyText",
|
|
5825
5996
|
"whenToUse": [
|
|
5826
5997
|
"Page and section headings that follow the design system type scale (H1-H4)",
|
|
5827
5998
|
"Body copy, intros, and secondary text (P, Lead, Large, Small, Muted)",
|
|
@@ -5839,101 +6010,277 @@
|
|
|
5839
6010
|
"rule": "Use Label for form input labels — Typography is for content headings and body text"
|
|
5840
6011
|
}
|
|
5841
6012
|
],
|
|
6013
|
+
"figma": {
|
|
6014
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
6015
|
+
"status": "deprecated-in-figma",
|
|
6016
|
+
"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)."
|
|
6017
|
+
}
|
|
6018
|
+
},
|
|
6019
|
+
{
|
|
6020
|
+
"name": "TypographyHeading",
|
|
6021
|
+
"import": "@brightlocal/ui-components/typography-heading",
|
|
5842
6022
|
"figma": {
|
|
5843
6023
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5844
6024
|
"nodes": [
|
|
5845
6025
|
{
|
|
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"
|
|
6026
|
+
"nodeId": "31658:2480",
|
|
6027
|
+
"figmaName": "TypographyHeading",
|
|
6028
|
+
"kind": "componentSet",
|
|
6029
|
+
"export": "TypographyHeading",
|
|
6030
|
+
"axes": [
|
|
6031
|
+
{
|
|
6032
|
+
"figma": "Variant",
|
|
6033
|
+
"code": "variant"
|
|
6034
|
+
},
|
|
6035
|
+
{
|
|
6036
|
+
"figma": "Color",
|
|
6037
|
+
"code": "color"
|
|
6038
|
+
},
|
|
6039
|
+
{
|
|
6040
|
+
"figma": "Align",
|
|
6041
|
+
"code": "align"
|
|
6042
|
+
},
|
|
6043
|
+
{
|
|
6044
|
+
"figma": "Tabular",
|
|
6045
|
+
"code": "tabular"
|
|
6046
|
+
}
|
|
6047
|
+
]
|
|
5923
6048
|
}
|
|
5924
6049
|
],
|
|
5925
6050
|
"unmappedExports": [],
|
|
5926
|
-
"figmaOnly": [
|
|
6051
|
+
"figmaOnly": [],
|
|
6052
|
+
"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."
|
|
6053
|
+
},
|
|
6054
|
+
"category": "display",
|
|
6055
|
+
"exports": [
|
|
6056
|
+
"TypographyHeading"
|
|
6057
|
+
],
|
|
6058
|
+
"compound": false,
|
|
6059
|
+
"dataHookRequired": true,
|
|
6060
|
+
"variants": {
|
|
6061
|
+
"variant": [
|
|
6062
|
+
"display",
|
|
6063
|
+
"page",
|
|
6064
|
+
"section",
|
|
6065
|
+
"subsection",
|
|
6066
|
+
"compact"
|
|
6067
|
+
],
|
|
6068
|
+
"color": [
|
|
6069
|
+
"default",
|
|
6070
|
+
"muted"
|
|
6071
|
+
],
|
|
6072
|
+
"align": [
|
|
6073
|
+
"left",
|
|
6074
|
+
"center",
|
|
6075
|
+
"right"
|
|
6076
|
+
]
|
|
6077
|
+
},
|
|
6078
|
+
"props": [
|
|
6079
|
+
"level",
|
|
6080
|
+
"variant",
|
|
6081
|
+
"color",
|
|
6082
|
+
"align",
|
|
6083
|
+
"tabular",
|
|
6084
|
+
"asChild"
|
|
6085
|
+
],
|
|
6086
|
+
"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)",
|
|
6087
|
+
"aliases": [
|
|
6088
|
+
"heading",
|
|
6089
|
+
"title",
|
|
6090
|
+
"page title",
|
|
6091
|
+
"section title",
|
|
6092
|
+
"subsection title",
|
|
6093
|
+
"display text"
|
|
6094
|
+
],
|
|
6095
|
+
"replaces": [
|
|
6096
|
+
"raw <h1>-<h6> tags",
|
|
6097
|
+
"TypographyH1-TypographyH4 (deprecated, DS-714)"
|
|
6098
|
+
],
|
|
6099
|
+
"whenToUse": [
|
|
6100
|
+
"Any heading: pick level from the document outline, variant from the type scale role",
|
|
6101
|
+
"Page titles (level 1, variant 'page' - exactly one per screen)",
|
|
6102
|
+
"Card/dialog/section titles that belong in the outline (variant 'section')",
|
|
6103
|
+
"Sections inside a card, alert titles, the smallest headings (variant 'subsection')"
|
|
6104
|
+
],
|
|
6105
|
+
"doNotUseFor": [
|
|
6106
|
+
"big numbers or KPIs (use TypographyText variant='metric' - loud text is not a heading)",
|
|
6107
|
+
"marketing display moments by default (variant 'display' is explicit, brand moments only)",
|
|
6108
|
+
"table column headers inside Table (th elements already carry the semantics; style as label-size text at 600, not a heading style)",
|
|
6109
|
+
"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)"
|
|
6110
|
+
],
|
|
6111
|
+
"alternatives": [
|
|
6112
|
+
{
|
|
6113
|
+
"component": "TypographyText",
|
|
6114
|
+
"rule": "Use TypographyText for anything that does not introduce a section - body copy, metrics, code"
|
|
6115
|
+
},
|
|
6116
|
+
{
|
|
6117
|
+
"component": "Card",
|
|
6118
|
+
"rule": "Inside Card, prefer the CardTitle export so the card owns its title slot"
|
|
6119
|
+
}
|
|
6120
|
+
]
|
|
6121
|
+
},
|
|
6122
|
+
{
|
|
6123
|
+
"name": "TypographyText",
|
|
6124
|
+
"import": "@brightlocal/ui-components/typography-text",
|
|
6125
|
+
"figma": {
|
|
6126
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
6127
|
+
"nodes": [
|
|
5927
6128
|
{
|
|
5928
|
-
"nodeId": "
|
|
5929
|
-
"figmaName": "
|
|
5930
|
-
"
|
|
6129
|
+
"nodeId": "31658:49394",
|
|
6130
|
+
"figmaName": "TypographyText",
|
|
6131
|
+
"kind": "componentSet",
|
|
6132
|
+
"export": "TypographyText",
|
|
6133
|
+
"axes": [
|
|
6134
|
+
{
|
|
6135
|
+
"figma": "Variant",
|
|
6136
|
+
"code": "variant"
|
|
6137
|
+
},
|
|
6138
|
+
{
|
|
6139
|
+
"figma": "Color",
|
|
6140
|
+
"code": "color"
|
|
6141
|
+
},
|
|
6142
|
+
{
|
|
6143
|
+
"figma": "Align",
|
|
6144
|
+
"code": "align"
|
|
6145
|
+
},
|
|
6146
|
+
{
|
|
6147
|
+
"figma": "Tabular",
|
|
6148
|
+
"code": "tabular"
|
|
6149
|
+
}
|
|
6150
|
+
]
|
|
5931
6151
|
}
|
|
6152
|
+
],
|
|
6153
|
+
"unmappedExports": [],
|
|
6154
|
+
"figmaOnly": [],
|
|
6155
|
+
"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)."
|
|
6156
|
+
},
|
|
6157
|
+
"category": "display",
|
|
6158
|
+
"exports": [
|
|
6159
|
+
"TypographyText"
|
|
6160
|
+
],
|
|
6161
|
+
"compound": false,
|
|
6162
|
+
"dataHookRequired": true,
|
|
6163
|
+
"variants": {
|
|
6164
|
+
"variant": [
|
|
6165
|
+
"body",
|
|
6166
|
+
"body-sm",
|
|
6167
|
+
"body-xs",
|
|
6168
|
+
"metric",
|
|
6169
|
+
"code"
|
|
6170
|
+
],
|
|
6171
|
+
"color": [
|
|
6172
|
+
"default",
|
|
6173
|
+
"muted",
|
|
6174
|
+
"destructive"
|
|
6175
|
+
],
|
|
6176
|
+
"align": [
|
|
6177
|
+
"left",
|
|
6178
|
+
"center",
|
|
6179
|
+
"right"
|
|
5932
6180
|
]
|
|
5933
|
-
}
|
|
6181
|
+
},
|
|
6182
|
+
"props": [
|
|
6183
|
+
"variant",
|
|
6184
|
+
"color",
|
|
6185
|
+
"tabular",
|
|
6186
|
+
"align",
|
|
6187
|
+
"asChild"
|
|
6188
|
+
],
|
|
6189
|
+
"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",
|
|
6190
|
+
"aliases": [
|
|
6191
|
+
"text",
|
|
6192
|
+
"paragraph",
|
|
6193
|
+
"body text",
|
|
6194
|
+
"caption",
|
|
6195
|
+
"helper text",
|
|
6196
|
+
"kpi",
|
|
6197
|
+
"stat value",
|
|
6198
|
+
"code text"
|
|
6199
|
+
],
|
|
6200
|
+
"replaces": [
|
|
6201
|
+
"raw <p>/<span> text",
|
|
6202
|
+
"TypographyP/Lead/Large/Small/Muted (deprecated, DS-714)"
|
|
6203
|
+
],
|
|
6204
|
+
"whenToUse": [
|
|
6205
|
+
"Body copy at any density (body / body-sm / body-xs)",
|
|
6206
|
+
"Large numbers only - KPIs and card scores (metric; add tabular where the figure must align or updates in place)",
|
|
6207
|
+
"IDs, keys, coordinates a user copies verbatim (code)"
|
|
6208
|
+
],
|
|
6209
|
+
"doNotUseFor": [
|
|
6210
|
+
"section titles (use TypographyHeading - text that introduces a section is a heading)",
|
|
6211
|
+
"form field labels, tabs, nav and other control text (use Label/Field for htmlFor semantics - there are no standalone label variants on purpose)",
|
|
6212
|
+
"badge/chip text (use the Badge / Chip components)"
|
|
6213
|
+
],
|
|
6214
|
+
"alternatives": [
|
|
6215
|
+
{
|
|
6216
|
+
"component": "TypographyHeading",
|
|
6217
|
+
"rule": "Use TypographyHeading when the text introduces a section of content"
|
|
6218
|
+
},
|
|
6219
|
+
{
|
|
6220
|
+
"component": "Label",
|
|
6221
|
+
"rule": "Use Label for labels tied to a form control via htmlFor"
|
|
6222
|
+
}
|
|
6223
|
+
]
|
|
5934
6224
|
}
|
|
5935
6225
|
],
|
|
5936
6226
|
"blocks": [
|
|
6227
|
+
{
|
|
6228
|
+
"name": "EmptyState",
|
|
6229
|
+
"import": "@brightlocal/ui-components/empty-state",
|
|
6230
|
+
"category": "block",
|
|
6231
|
+
"exports": [
|
|
6232
|
+
"EmptyState"
|
|
6233
|
+
],
|
|
6234
|
+
"compound": false,
|
|
6235
|
+
"dataHookRequired": true,
|
|
6236
|
+
"variants": {
|
|
6237
|
+
"EmptyStateSize": [
|
|
6238
|
+
"md",
|
|
6239
|
+
"lg"
|
|
6240
|
+
],
|
|
6241
|
+
"EmptyStateAlign": [
|
|
6242
|
+
"center",
|
|
6243
|
+
"left"
|
|
6244
|
+
]
|
|
6245
|
+
},
|
|
6246
|
+
"props": [
|
|
6247
|
+
"icon",
|
|
6248
|
+
"illustration",
|
|
6249
|
+
"title",
|
|
6250
|
+
"description",
|
|
6251
|
+
"size",
|
|
6252
|
+
"align",
|
|
6253
|
+
"titleLevel",
|
|
6254
|
+
"className"
|
|
6255
|
+
],
|
|
6256
|
+
"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 20/28 title. size=\"lg\" is for the moment the whole page has nothing to show: a 130px illustration and a 24/32 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.)",
|
|
6257
|
+
"aliases": [
|
|
6258
|
+
"empty state",
|
|
6259
|
+
"empty block",
|
|
6260
|
+
"empty screen",
|
|
6261
|
+
"empty page",
|
|
6262
|
+
"nothing here",
|
|
6263
|
+
"no data",
|
|
6264
|
+
"no results",
|
|
6265
|
+
"zero state",
|
|
6266
|
+
"blank state",
|
|
6267
|
+
"setup screen",
|
|
6268
|
+
"first use screen",
|
|
6269
|
+
"blocking screen"
|
|
6270
|
+
],
|
|
6271
|
+
"whenToUse": [
|
|
6272
|
+
"A collection with no rows yet, inside the table's own frame — a DataTable takes the block through noResultsMessage",
|
|
6273
|
+
"A section of a working page with nothing to show — keep the heading and frame, swap the body",
|
|
6274
|
+
"A gated feature: name it, sell it, and offer an action the reader can act on",
|
|
6275
|
+
"A first-use or blocked page: size=\"lg\" inside Grid variant=\"centered\", with an illustration"
|
|
6276
|
+
],
|
|
6277
|
+
"doNotUseFor": [
|
|
6278
|
+
"a chart, map, or media slot (use ChartEmpty, MapEmpty, or MediaEmpty — a canvas keeps quiet, and those are primitives)",
|
|
6279
|
+
"a page that is generating content (use ProgressState)",
|
|
6280
|
+
"data that is still on its way (use Skeleton, which mirrors the geometry that is coming)",
|
|
6281
|
+
"something that failed (an error state — 'nothing here' and 'we could not load this' are different sentences)"
|
|
6282
|
+
]
|
|
6283
|
+
},
|
|
5937
6284
|
{
|
|
5938
6285
|
"name": "InputList",
|
|
5939
6286
|
"import": "@brightlocal/ui-components/input-list",
|
|
@@ -5972,11 +6319,11 @@
|
|
|
5972
6319
|
]
|
|
5973
6320
|
},
|
|
5974
6321
|
{
|
|
5975
|
-
"name": "
|
|
5976
|
-
"import": "@brightlocal/ui-components/progress-
|
|
6322
|
+
"name": "ProgressState",
|
|
6323
|
+
"import": "@brightlocal/ui-components/progress-state",
|
|
5977
6324
|
"category": "block",
|
|
5978
6325
|
"exports": [
|
|
5979
|
-
"
|
|
6326
|
+
"ProgressState"
|
|
5980
6327
|
],
|
|
5981
6328
|
"compound": false,
|
|
5982
6329
|
"dataHookRequired": true,
|
|
@@ -5987,14 +6334,14 @@
|
|
|
5987
6334
|
"description",
|
|
5988
6335
|
"value",
|
|
5989
6336
|
"max",
|
|
5990
|
-
"
|
|
6337
|
+
"progressLabel",
|
|
5991
6338
|
"progressUnit",
|
|
5992
6339
|
"showProgressValue",
|
|
5993
6340
|
"className"
|
|
5994
6341
|
],
|
|
5995
|
-
"description": "Generation
|
|
6342
|
+
"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
6343
|
"i18nProps": {
|
|
5997
|
-
"
|
|
6344
|
+
"ProgressState": {
|
|
5998
6345
|
"progressLabel": "string — default: \"Generation progress\""
|
|
5999
6346
|
}
|
|
6000
6347
|
},
|
|
@@ -6007,6 +6354,13 @@
|
|
|
6007
6354
|
"fetching data for seconds (use Skeleton, which mirrors the geometry that is coming)",
|
|
6008
6355
|
"a re-run over content already on screen (keep the data at full contrast and use Button loading on the trigger)",
|
|
6009
6356
|
"a single control processing its own wait (use Button loading or Spinner)"
|
|
6357
|
+
],
|
|
6358
|
+
"aliases": [
|
|
6359
|
+
"generation screen",
|
|
6360
|
+
"progress screen"
|
|
6361
|
+
],
|
|
6362
|
+
"replaces": [
|
|
6363
|
+
"ProgressScreen"
|
|
6010
6364
|
]
|
|
6011
6365
|
},
|
|
6012
6366
|
{
|