@brightlocal/ui-components 3.4.0 → 3.5.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/AI_USAGE.md +22 -3
- package/README.md +177 -109
- package/component-meta.json +1061 -102
- package/dist/alert-dialog.cjs +1 -1
- package/dist/alert-dialog.d.ts +13 -2
- package/dist/alert-dialog.d.ts.map +1 -1
- package/dist/alert-dialog.js +4 -3
- package/dist/banner.cjs +1 -1
- package/dist/banner.d.ts +47 -11
- package/dist/banner.d.ts.map +1 -1
- package/dist/banner.js +156 -79
- package/dist/blocks/empty-state.cjs +1 -1
- package/dist/blocks/empty-state.d.ts +40 -5
- package/dist/blocks/empty-state.d.ts.map +1 -1
- package/dist/blocks/empty-state.js +59 -52
- package/dist/blocks/input-list.d.ts +1 -0
- package/dist/blocks/input-list.d.ts.map +1 -1
- package/dist/blocks/sidebar.cjs +1 -1
- package/dist/blocks/sidebar.d.ts +12 -6
- package/dist/blocks/sidebar.d.ts.map +1 -1
- package/dist/blocks/sidebar.js +64 -63
- package/dist/button.cjs +1 -1
- package/dist/button.d.ts.map +1 -1
- package/dist/button.js +47 -43
- package/dist/card.cjs +1 -1
- package/dist/card.d.ts +12 -0
- package/dist/card.d.ts.map +1 -1
- package/dist/card.js +115 -97
- package/dist/chart.cjs +6 -6
- package/dist/chart.d.ts +6 -10
- package/dist/chart.d.ts.map +1 -1
- package/dist/chart.js +281 -296
- package/dist/combobox.cjs +3 -3
- package/dist/combobox.d.ts.map +1 -1
- package/dist/combobox.js +430 -343
- package/dist/command.cjs +1 -1
- package/dist/command.d.ts +23 -2
- package/dist/command.d.ts.map +1 -1
- package/dist/command.js +212 -207
- package/dist/count-indicator.cjs +1 -0
- package/dist/count-indicator.d.ts +85 -0
- package/dist/count-indicator.d.ts.map +1 -0
- package/dist/count-indicator.js +72 -0
- package/dist/data-table.cjs +1 -1
- package/dist/data-table.d.ts +101 -11
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +593 -523
- package/dist/dialog.cjs +1 -1
- package/dist/dialog.d.ts +26 -3
- package/dist/dialog.d.ts.map +1 -1
- package/dist/dialog.js +62 -47
- package/dist/drawer.cjs +1 -1
- package/dist/drawer.d.ts +8 -4
- package/dist/drawer.d.ts.map +1 -1
- package/dist/drawer.js +37 -38
- package/dist/file-upload.cjs +1 -0
- package/dist/file-upload.d.ts +546 -0
- package/dist/file-upload.d.ts.map +1 -0
- package/dist/file-upload.js +1103 -0
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +7 -2
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +52 -52
- package/dist/hooks/use-file-dropzone.cjs +1 -0
- package/dist/hooks/use-file-dropzone.d.ts +75 -0
- package/dist/hooks/use-file-dropzone.d.ts.map +1 -0
- package/dist/hooks/use-file-dropzone.js +133 -0
- package/dist/hover-card.cjs +1 -1
- package/dist/hover-card.d.ts +29 -16
- package/dist/hover-card.d.ts.map +1 -1
- package/dist/hover-card.js +153 -36
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +676 -640
- package/dist/input-chip.cjs +1 -1
- package/dist/input-chip.d.ts +30 -1
- package/dist/input-chip.d.ts.map +1 -1
- package/dist/input-chip.js +131 -115
- package/dist/input-group.cjs +1 -1
- package/dist/input-group.d.ts +37 -2
- package/dist/input-group.d.ts.map +1 -1
- package/dist/input-group.js +131 -114
- package/dist/input-password.cjs +1 -1
- package/dist/input-password.js +6 -6
- package/dist/lib/empty-canvas.cjs +1 -1
- package/dist/lib/empty-canvas.d.ts +27 -1
- package/dist/lib/empty-canvas.d.ts.map +1 -1
- package/dist/lib/empty-canvas.js +27 -23
- package/dist/lib/empty-chip.cjs +1 -1
- package/dist/lib/empty-chip.d.ts +19 -2
- package/dist/lib/empty-chip.d.ts.map +1 -1
- package/dist/lib/empty-chip.js +14 -9
- package/dist/lib/field-aria.cjs +1 -1
- package/dist/lib/field-aria.d.ts +4 -4
- package/dist/lib/field-aria.d.ts.map +1 -1
- package/dist/lib/field-aria.js +7 -5
- package/dist/lib/media-viewer-content.cjs +1 -1
- package/dist/lib/media-viewer-content.js +1 -1
- package/dist/lib/table-internal.cjs +1 -1
- package/dist/lib/table-internal.d.ts +19 -0
- package/dist/lib/table-internal.d.ts.map +1 -1
- package/dist/lib/table-internal.js +22 -7
- package/dist/list.cjs +1 -1
- package/dist/list.d.ts +13 -0
- package/dist/list.d.ts.map +1 -1
- package/dist/list.js +103 -82
- package/dist/logo-mark.cjs +1 -1
- package/dist/logo-mark.d.ts +18 -2
- package/dist/logo-mark.d.ts.map +1 -1
- package/dist/logo-mark.js +159 -79
- package/dist/media-empty.cjs +1 -1
- package/dist/media-empty.d.ts +50 -7
- package/dist/media-empty.d.ts.map +1 -1
- package/dist/media-empty.js +14 -13
- package/dist/media-viewer.cjs +1 -1
- package/dist/media-viewer.js +6 -6
- package/dist/multi-select-filter.cjs +1 -1
- package/dist/multi-select-filter.d.ts.map +1 -1
- package/dist/multi-select-filter.js +92 -101
- package/dist/pagination.cjs +1 -1
- package/dist/pagination.d.ts +11 -0
- package/dist/pagination.d.ts.map +1 -1
- package/dist/pagination.js +17 -17
- package/dist/relative-date.d.ts +6 -0
- package/dist/relative-date.d.ts.map +1 -1
- package/dist/resizable.d.ts +1 -1
- package/dist/result-count.cjs +1 -1
- package/dist/result-count.d.ts +13 -16
- package/dist/result-count.d.ts.map +1 -1
- package/dist/result-count.js +24 -33
- package/dist/sheet.cjs +1 -1
- package/dist/sheet.d.ts +22 -3
- package/dist/sheet.d.ts.map +1 -1
- package/dist/sheet.js +152 -125
- package/dist/single-select-filter.cjs +1 -1
- package/dist/single-select-filter.d.ts.map +1 -1
- package/dist/single-select-filter.js +67 -76
- package/dist/table.cjs +1 -1
- package/dist/table.d.ts.map +1 -1
- package/dist/table.js +77 -76
- package/dist/tabs.cjs +1 -1
- package/dist/tabs.d.ts +39 -3
- package/dist/tabs.d.ts.map +1 -1
- package/dist/tabs.js +127 -76
- package/dist/textarea.cjs +1 -1
- package/dist/textarea.d.ts +34 -0
- package/dist/textarea.d.ts.map +1 -1
- package/dist/textarea.js +115 -19
- package/dist/tooltip.cjs +1 -1
- package/dist/tooltip.d.ts.map +1 -1
- package/dist/tooltip.js +137 -131
- package/dist/typography-text.cjs +1 -1
- package/dist/typography-text.d.ts +6 -2
- package/dist/typography-text.d.ts.map +1 -1
- package/dist/typography-text.js +14 -13
- package/package.json +3 -4
- package/src/blocks/empty-state.tsx +108 -48
- package/src/blocks/input-list.tsx +1 -0
- package/src/blocks/sidebar.tsx +39 -16
- package/src/components/alert-dialog.tsx +18 -2
- package/src/components/banner.tsx +247 -68
- package/src/components/button.tsx +27 -10
- package/src/components/card.tsx +89 -7
- package/src/components/chart.tsx +47 -67
- package/src/components/combobox.tsx +221 -12
- package/src/components/command.tsx +83 -37
- package/src/components/count-indicator.tsx +188 -0
- package/src/components/data-table.tsx +506 -159
- package/src/components/dialog.tsx +74 -5
- package/src/components/drawer.tsx +52 -32
- package/src/components/file-upload.tsx +2574 -0
- package/src/components/global-layout.tsx +18 -5
- package/src/components/hover-card.tsx +395 -65
- package/src/components/input-chip.tsx +67 -2
- package/src/components/input-group.tsx +89 -6
- package/src/components/list.tsx +40 -3
- package/src/components/logo-mark.tsx +109 -25
- package/src/components/media-empty.tsx +62 -7
- package/src/components/multi-select-filter.tsx +9 -16
- package/src/components/pagination.tsx +15 -2
- package/src/components/relative-date.tsx +6 -0
- package/src/components/result-count.tsx +27 -54
- package/src/components/sheet.tsx +86 -8
- package/src/components/single-select-filter.tsx +9 -16
- package/src/components/table.tsx +16 -1
- package/src/components/tabs.tsx +223 -41
- package/src/components/textarea.tsx +271 -4
- package/src/components/tooltip.tsx +29 -2
- package/src/components/typography-text.tsx +7 -2
- package/src/hooks/use-file-dropzone.ts +325 -0
- package/src/index.ts +3 -0
- package/src/lib/empty-canvas.tsx +47 -20
- package/src/lib/empty-chip.tsx +38 -3
- package/src/lib/field-aria.tsx +11 -6
- package/src/lib/table-internal.ts +38 -0
package/component-meta.json
CHANGED
|
@@ -1,12 +1,84 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@brightlocal/ui-components",
|
|
3
|
-
"version": "3.
|
|
3
|
+
"version": "3.5.0",
|
|
4
4
|
"description": "Machine-readable registry of all components in the BrightLocal Design System",
|
|
5
|
+
"categories": [
|
|
6
|
+
{
|
|
7
|
+
"slug": "actions",
|
|
8
|
+
"label": "Actions",
|
|
9
|
+
"description": "Triggers an action: buttons, toggles and the menus that list actions"
|
|
10
|
+
},
|
|
11
|
+
{
|
|
12
|
+
"slug": "containers",
|
|
13
|
+
"label": "Containers",
|
|
14
|
+
"description": "Groups and contains content: cards, collapsible regions, scroll and resize containers"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"slug": "content",
|
|
18
|
+
"label": "Content",
|
|
19
|
+
"description": "Single values and content: avatars, ratings, dates and counts"
|
|
20
|
+
},
|
|
21
|
+
{
|
|
22
|
+
"slug": "data",
|
|
23
|
+
"label": "Data",
|
|
24
|
+
"description": "Data representation: tables, lists, charts, maps and progress bars"
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"slug": "feedback",
|
|
28
|
+
"label": "Feedback",
|
|
29
|
+
"description": "Tells the user something happened or needs attention, or highlights a message: alerts, banners, callouts, toasts"
|
|
30
|
+
},
|
|
31
|
+
{
|
|
32
|
+
"slug": "form",
|
|
33
|
+
"label": "Form",
|
|
34
|
+
"description": "Collects or describes user input: fields, selects, pickers, toggles that hold a value"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"slug": "indicators",
|
|
38
|
+
"label": "Indicators",
|
|
39
|
+
"description": "Compact status and change markers: badge, status dot, delta"
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
"slug": "loading",
|
|
43
|
+
"label": "Loading",
|
|
44
|
+
"description": "Communicates that work is in progress: spinners, skeletons, route progress"
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"slug": "media",
|
|
48
|
+
"label": "Media & brand",
|
|
49
|
+
"description": "Imagery, video and BrightLocal brand marks: frames, carousels, media viewer, logos and illustration motifs"
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"slug": "navigation",
|
|
53
|
+
"label": "Navigation",
|
|
54
|
+
"description": "Moves the user between places or commands: tabs, breadcrumbs, pagination, steppers, sidebar"
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
"slug": "overlay",
|
|
58
|
+
"label": "Overlay",
|
|
59
|
+
"description": "Content layered above the page: dialogs, sheets, popovers and tooltips"
|
|
60
|
+
},
|
|
61
|
+
{
|
|
62
|
+
"slug": "page-layout",
|
|
63
|
+
"label": "Page layout",
|
|
64
|
+
"description": "Structures the page itself: shells, headers, grids, split panes and dividers"
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
"slug": "states",
|
|
68
|
+
"label": "States",
|
|
69
|
+
"description": "Whole-surface states: empty and in-progress"
|
|
70
|
+
},
|
|
71
|
+
{
|
|
72
|
+
"slug": "typography",
|
|
73
|
+
"label": "Typography",
|
|
74
|
+
"description": "Text styles and semantic text elements"
|
|
75
|
+
}
|
|
76
|
+
],
|
|
5
77
|
"components": [
|
|
6
78
|
{
|
|
7
79
|
"name": "Accordion",
|
|
8
80
|
"import": "@brightlocal/ui-components/accordion",
|
|
9
|
-
"category": "
|
|
81
|
+
"category": "containers",
|
|
10
82
|
"exports": [
|
|
11
83
|
"Accordion",
|
|
12
84
|
"AccordionItem",
|
|
@@ -325,7 +397,7 @@
|
|
|
325
397
|
{
|
|
326
398
|
"name": "AspectRatio",
|
|
327
399
|
"import": "@brightlocal/ui-components/aspect-ratio",
|
|
328
|
-
"category": "
|
|
400
|
+
"category": "media",
|
|
329
401
|
"exports": [
|
|
330
402
|
"AspectRatio"
|
|
331
403
|
],
|
|
@@ -370,7 +442,7 @@
|
|
|
370
442
|
{
|
|
371
443
|
"name": "Avatar",
|
|
372
444
|
"import": "@brightlocal/ui-components/avatar",
|
|
373
|
-
"category": "
|
|
445
|
+
"category": "content",
|
|
374
446
|
"exports": [
|
|
375
447
|
"Avatar",
|
|
376
448
|
"AvatarImage",
|
|
@@ -434,7 +506,7 @@
|
|
|
434
506
|
{
|
|
435
507
|
"name": "Badge",
|
|
436
508
|
"import": "@brightlocal/ui-components/badge",
|
|
437
|
-
"category": "
|
|
509
|
+
"category": "indicators",
|
|
438
510
|
"exports": [
|
|
439
511
|
"Badge"
|
|
440
512
|
],
|
|
@@ -464,7 +536,7 @@
|
|
|
464
536
|
"label"
|
|
465
537
|
],
|
|
466
538
|
"whenToUse": [
|
|
467
|
-
"
|
|
539
|
+
"Labels for a fact that does not change by itself, like \"New\" or \"Beta\" — a lifecycle state such as Active, Draft or Failed is a Status",
|
|
468
540
|
"Numeric counts on icons or navigation items",
|
|
469
541
|
"Highlighting a plan tier or account type",
|
|
470
542
|
"A top or exceptional outcome (variant highlight-gold), e.g. the knowledge panel mark — icon-only via iconOnly + srLabel"
|
|
@@ -483,6 +555,10 @@
|
|
|
483
555
|
{
|
|
484
556
|
"component": "Button",
|
|
485
557
|
"rule": "Use Button for interactive status toggles"
|
|
558
|
+
},
|
|
559
|
+
{
|
|
560
|
+
"component": "Status",
|
|
561
|
+
"rule": "Use Status for where a tracked thing is in its lifecycle (Active, Syncing, Failed) — Badge is for facts and counts"
|
|
486
562
|
}
|
|
487
563
|
],
|
|
488
564
|
"replaces": [],
|
|
@@ -545,9 +621,11 @@
|
|
|
545
621
|
"Banner",
|
|
546
622
|
"BannerIllustration",
|
|
547
623
|
"BannerContent",
|
|
624
|
+
"BannerEyebrow",
|
|
548
625
|
"BannerTitle",
|
|
549
626
|
"BannerDescription",
|
|
550
|
-
"BannerActions"
|
|
627
|
+
"BannerActions",
|
|
628
|
+
"BannerDetails"
|
|
551
629
|
],
|
|
552
630
|
"compound": true,
|
|
553
631
|
"dataHookRequired": true,
|
|
@@ -555,14 +633,24 @@
|
|
|
555
633
|
"variant": [
|
|
556
634
|
"sky",
|
|
557
635
|
"violet"
|
|
636
|
+
],
|
|
637
|
+
"size": [
|
|
638
|
+
"sm",
|
|
639
|
+
"lg"
|
|
640
|
+
],
|
|
641
|
+
"flow": [
|
|
642
|
+
"horizontal",
|
|
643
|
+
"vertical"
|
|
558
644
|
]
|
|
559
645
|
},
|
|
560
646
|
"props": [
|
|
561
647
|
"variant",
|
|
648
|
+
"size",
|
|
649
|
+
"flow",
|
|
562
650
|
"onDismiss",
|
|
563
651
|
"dismissLabel"
|
|
564
652
|
],
|
|
565
|
-
"description": "Branded
|
|
653
|
+
"description": "Branded invitation to an optional step on a highlight sky/violet surface — composed from BannerIllustration, BannerContent (BannerEyebrow, BannerTitle, BannerDescription), BannerActions and, at lg, BannerDetails. sm is the compact strip (flow horizontal or vertical); lg is the hero",
|
|
566
654
|
"i18nProps": {
|
|
567
655
|
"Banner": {
|
|
568
656
|
"dismissLabel": "string — default: \"Dismiss\""
|
|
@@ -570,18 +658,34 @@
|
|
|
570
658
|
},
|
|
571
659
|
"whenToUse": [
|
|
572
660
|
"Inviting the user to an optional step that improves the page (connect an account, turn on two-factor authentication)",
|
|
573
|
-
"A one-off, dismissible nudge tied to the current page"
|
|
661
|
+
"A one-off, dismissible nudge tied to the current page",
|
|
662
|
+
"size lg: the banner is the page's content — introducing a feature, or a plan gate in place of a feature",
|
|
663
|
+
"flow vertical: an sm banner in a narrow container (sidebar, card column)"
|
|
574
664
|
],
|
|
575
665
|
"doNotUseFor": [
|
|
576
666
|
"something that happened — a failure, a risk, a tip (use Alert)",
|
|
577
667
|
"brand statements or pull-quotes (use Callout)",
|
|
578
668
|
"feedback after an action (use a toast / Sonner)"
|
|
669
|
+
],
|
|
670
|
+
"decisions": [
|
|
671
|
+
{
|
|
672
|
+
"date": "2026-11-06",
|
|
673
|
+
"decision": "Banner gains size (sm strip | lg hero), flow (horizontal | vertical, sm only) and the BannerEyebrow and BannerDetails parts, from the DS-1177 playground. Combinations are not blocked in types: lg banners should not be dismissible, BannerDetails is lg only and vertical flow is for narrow containers — documented rules, not type guards. The playground's promo tone (deep green surface, green CTA) is deferred, not part of this change.",
|
|
674
|
+
"why": "The plan-gate and feature-introduction screens need a hero-scale banner with supporting content; keeping variant (not renaming to tone) avoids a breaking change.",
|
|
675
|
+
"ticket": "DS-1177"
|
|
676
|
+
},
|
|
677
|
+
{
|
|
678
|
+
"date": "2026-11-10",
|
|
679
|
+
"decision": "The actions always sit under the text, in every layout — the sm horizontal strip no longer puts them on the right from md (the illustration moves to the left of the text column instead). A secondary action is a ghost Button after the outline one in the same BannerActions; no new part or prop.",
|
|
680
|
+
"why": "Design review (Ali): an action off to the right floats beside multi-line copy; plan and feature banners need a 'Learn more' next to the main action.",
|
|
681
|
+
"ticket": "DS-1177"
|
|
682
|
+
}
|
|
579
683
|
]
|
|
580
684
|
},
|
|
581
685
|
{
|
|
582
686
|
"name": "BrandIllustrationMotif",
|
|
583
687
|
"import": "@brightlocal/ui-components/brand-illustration-motif",
|
|
584
|
-
"category": "
|
|
688
|
+
"category": "media",
|
|
585
689
|
"exports": [
|
|
586
690
|
"BrandIllustrationMotif"
|
|
587
691
|
],
|
|
@@ -726,7 +830,7 @@
|
|
|
726
830
|
{
|
|
727
831
|
"name": "Button",
|
|
728
832
|
"import": "@brightlocal/ui-components/button",
|
|
729
|
-
"category": "
|
|
833
|
+
"category": "actions",
|
|
730
834
|
"exports": [
|
|
731
835
|
"Button"
|
|
732
836
|
],
|
|
@@ -760,6 +864,12 @@
|
|
|
760
864
|
"decision": "The warning variant is removed. Button has five variants: primary, secondary, destructive, outline, ghost. A moderate-risk action, such as discarding unsaved changes, uses secondary; destructive is for deleting what was saved.",
|
|
761
865
|
"why": "Design review: an orange or yellow button is unfamiliar and unnecessary next to primary, secondary, destructive, outline and ghost. Nothing used it: no greenfield code, no prototype and no Figma frame outside the Button page itself (DS-899).",
|
|
762
866
|
"ticket": "DS-899"
|
|
867
|
+
},
|
|
868
|
+
{
|
|
869
|
+
"date": "2026-11-09",
|
|
870
|
+
"decision": "Icon-only buttons respect the size axis: sm = 32px (size-8), default = 36px (size-9), lg = 40px (size-10). The ICON_ONLY_SIZE map replaces the former hardcoded size-9. DataTableExpandRowButton reads TableSizeContext and passes the density-aware size to Button, with a matching spacer.",
|
|
871
|
+
"why": "Icon-only buttons inside density-aware surfaces (Table size=\"sm\") were always 36px, breaking visual density. The size axis was already on Button but icon-only bypassed it.",
|
|
872
|
+
"ticket": "DS-1120"
|
|
763
873
|
}
|
|
764
874
|
],
|
|
765
875
|
"description": "Primary interactive button with variants",
|
|
@@ -859,7 +969,7 @@
|
|
|
859
969
|
{
|
|
860
970
|
"name": "ButtonGroup",
|
|
861
971
|
"import": "@brightlocal/ui-components/button-group",
|
|
862
|
-
"category": "
|
|
972
|
+
"category": "actions",
|
|
863
973
|
"exports": [
|
|
864
974
|
"ButtonGroup",
|
|
865
975
|
"ButtonGroupSeparator"
|
|
@@ -978,7 +1088,7 @@
|
|
|
978
1088
|
{
|
|
979
1089
|
"name": "Callout",
|
|
980
1090
|
"import": "@brightlocal/ui-components/callout",
|
|
981
|
-
"category": "
|
|
1091
|
+
"category": "feedback",
|
|
982
1092
|
"exports": [
|
|
983
1093
|
"Callout",
|
|
984
1094
|
"CalloutHeading",
|
|
@@ -1020,7 +1130,7 @@
|
|
|
1020
1130
|
{
|
|
1021
1131
|
"name": "Card",
|
|
1022
1132
|
"import": "@brightlocal/ui-components/card",
|
|
1023
|
-
"category": "
|
|
1133
|
+
"category": "containers",
|
|
1024
1134
|
"exports": [
|
|
1025
1135
|
"Card",
|
|
1026
1136
|
"CardHeader",
|
|
@@ -1054,9 +1164,10 @@
|
|
|
1054
1164
|
]
|
|
1055
1165
|
},
|
|
1056
1166
|
"props": [
|
|
1057
|
-
"maxWidth"
|
|
1167
|
+
"maxWidth",
|
|
1168
|
+
"icon"
|
|
1058
1169
|
],
|
|
1059
|
-
"description": "Content container with consistent styling. Full-width by default — constrain width via className (e.g., className='max-w-sm'). Supports a density prop: 'default' uses generous spacing (gap-8, py-section-md, px-section-md) for standalone cards; 'condensed' uses compact spacing (gap-3, py-3, px-3) for cards nested inside other cards as sub-sections, inline stat panels, or dense dashboard widgets; 'data' uses the report-page scale (DS-989): fixed 24px horizontal padding, a header with 16px vertical padding, 24px section spacing below it (pair with CardTitle size='small'). CardHeader's divider prop closes the header with its own full-width bottom border in every density — the header pads its bottom by the density's spacing, and flush content right after sits on the line. variant='border' uses the card surface (bg-card: white in light mode, neutral-900 in dark) so it lifts off the off-white page; variant='filled' uses the muted fill (bg-muted). For cards carrying a filter row and a data view. CardContent accepts a flush prop for edge-to-edge tables/maps inside a filled or border card (the card keeps its surface and border). CardToolbar puts the filter row (search — Input, InputGroup or DataTableSearch — capped at 360px, then filters, 8px gap; styles direct children only) in the header, for everything that narrows what the card shows; pagination stays in a DataTableToolbar beside the table; CardMetric shows a value + trend badge opposite the title. CardHeader takes align ('left' | 'center' | 'right') for header layout; CardDescription takes its own align with the same values to pin the description's text alignment when it would otherwise inherit it (e.g. centred inside a button trigger) — omitted, it inherits as before. CardHeader's sticky prop pins the header to the top edge of its scroll container (page, Sheet, Dialog or any scroll box) while a tall card scrolls, with no gap above it (DS-1211), painting the card's surface so content never shows through.",
|
|
1170
|
+
"description": "Content container with consistent styling. Full-width by default — constrain width via className (e.g., className='max-w-sm'). Supports a density prop: 'default' uses generous spacing (gap-8, py-section-md, px-section-md) for standalone cards; 'condensed' uses compact spacing (gap-3, py-3, px-3) for cards nested inside other cards as sub-sections, inline stat panels, or dense dashboard widgets; 'data' uses the report-page scale (DS-989): fixed 24px horizontal padding, a header with 16px vertical padding, 24px section spacing below it (pair with CardTitle size='small'). CardHeader's divider prop closes the header with its own full-width bottom border in every density — the header pads its bottom by the density's spacing, and flush content right after sits on the line. variant='border' uses the card surface (bg-card: white in light mode, neutral-900 in dark) so it lifts off the off-white page; variant='filled' uses the muted fill (bg-muted). For cards carrying a filter row and a data view. CardContent accepts a flush prop for edge-to-edge tables/maps inside a filled or border card (the card keeps its surface and border). CardToolbar puts the filter row (search — Input, InputGroup or DataTableSearch — capped at 360px, then filters, 8px gap; styles direct children only) in the header, for everything that narrows what the card shows; pagination stays in a DataTableToolbar beside the table; CardMetric shows a value + trend badge opposite the title. CardHeader takes align ('left' | 'center' | 'right') for header layout; CardDescription takes its own align with the same values to pin the description's text alignment when it would otherwise inherit it (e.g. centred inside a button trigger) — omitted, it inherits as before. CardHeader's sticky prop pins the header to the top edge of its scroll container (page, Sheet, Dialog or any scroll box) while a tall card scrolls, with no gap above it (DS-1211), painting the card's surface so content never shows through. CardTitle takes an icon (a DS icon, sized to 20px, or a 20px LogoMark) rendered before the text with an 8px gap and centred on the title's first line, so wrapping titles keep it beside their opening words (DS-1268).",
|
|
1060
1171
|
"aliases": [
|
|
1061
1172
|
"container",
|
|
1062
1173
|
"panel",
|
|
@@ -1186,6 +1297,12 @@
|
|
|
1186
1297
|
"decision": "Card follows shadcn roles: variant=\"border\" is bg-card (white), variant=\"filled\" is bg-muted. There is no surface-* token layer.",
|
|
1187
1298
|
"why": "A variant is a recipe of semantic roles; a new token is added only when no role fits.",
|
|
1188
1299
|
"ticket": "DS-989"
|
|
1300
|
+
},
|
|
1301
|
+
{
|
|
1302
|
+
"date": "2026-11-05",
|
|
1303
|
+
"decision": "CardTitle's icon is centred on the title's first line (a one-line-tall icon box, items-start), not on the whole title block.",
|
|
1304
|
+
"why": "Card titles wrap in narrow report cards; centring on the block (SheetTitle's items-center) drifts the icon to the middle of a two-line title, away from the words it labels.",
|
|
1305
|
+
"ticket": "DS-1268"
|
|
1189
1306
|
}
|
|
1190
1307
|
],
|
|
1191
1308
|
"ruledOut": [
|
|
@@ -1204,7 +1321,7 @@
|
|
|
1204
1321
|
{
|
|
1205
1322
|
"name": "Carousel",
|
|
1206
1323
|
"import": "@brightlocal/ui-components/carousel",
|
|
1207
|
-
"category": "
|
|
1324
|
+
"category": "media",
|
|
1208
1325
|
"exports": [
|
|
1209
1326
|
"Carousel",
|
|
1210
1327
|
"CarouselContent",
|
|
@@ -1329,7 +1446,7 @@
|
|
|
1329
1446
|
{
|
|
1330
1447
|
"name": "CentredLayout",
|
|
1331
1448
|
"import": "@brightlocal/ui-components/centred-layout",
|
|
1332
|
-
"category": "layout",
|
|
1449
|
+
"category": "page-layout",
|
|
1333
1450
|
"exports": [
|
|
1334
1451
|
"CentredLayout",
|
|
1335
1452
|
"CentredLayoutHeader",
|
|
@@ -1393,7 +1510,7 @@
|
|
|
1393
1510
|
{
|
|
1394
1511
|
"name": "Chart",
|
|
1395
1512
|
"import": "@brightlocal/ui-components/chart",
|
|
1396
|
-
"category": "
|
|
1513
|
+
"category": "data",
|
|
1397
1514
|
"exports": [
|
|
1398
1515
|
"ChartContainer",
|
|
1399
1516
|
"ChartTooltip",
|
|
@@ -1443,6 +1560,24 @@
|
|
|
1443
1560
|
"decision": "A numeric height prop auto-switches the wrapper from aspect-video to aspect-auto and sets the height on the wrapper div, so the container takes exactly the chart's height with no empty gap.",
|
|
1444
1561
|
"why": "A percent-string height keeps aspect-video because the wrapper needs intrinsic sizing from the aspect ratio.",
|
|
1445
1562
|
"ticket": "DS-1051"
|
|
1563
|
+
},
|
|
1564
|
+
{
|
|
1565
|
+
"date": "2026-11-06",
|
|
1566
|
+
"decision": "A trend-coloured line uses Delta's inks via ChartConfig.color: better score-strong-ink, worse score-poor-ink, none muted-foreground; trend derived as Delta does (greenWhen)",
|
|
1567
|
+
"why": "chart-green/red are fills and fail 3:1 as a 1.5px stroke on card in both modes; the inks clear it — no second trend vocabulary",
|
|
1568
|
+
"ticket": "DS-1237"
|
|
1569
|
+
}
|
|
1570
|
+
],
|
|
1571
|
+
"ruledOut": [
|
|
1572
|
+
{
|
|
1573
|
+
"option": "chart-positive/negative/neutral or trend-* tokens",
|
|
1574
|
+
"why": "second vocabulary for Delta's question, ink measures ≥ 3:1",
|
|
1575
|
+
"ticket": "DS-1237"
|
|
1576
|
+
},
|
|
1577
|
+
{
|
|
1578
|
+
"option": "re-tune chart-green/red for strokes",
|
|
1579
|
+
"why": "AC, dark loader alias, DS-1222 owns values",
|
|
1580
|
+
"ticket": "DS-1237"
|
|
1446
1581
|
}
|
|
1447
1582
|
],
|
|
1448
1583
|
"i18nProps": {
|
|
@@ -1611,7 +1746,7 @@
|
|
|
1611
1746
|
{
|
|
1612
1747
|
"name": "Chip",
|
|
1613
1748
|
"import": "@brightlocal/ui-components/chip",
|
|
1614
|
-
"category": "
|
|
1749
|
+
"category": "form",
|
|
1615
1750
|
"exports": [
|
|
1616
1751
|
"Chip"
|
|
1617
1752
|
],
|
|
@@ -1688,7 +1823,7 @@
|
|
|
1688
1823
|
{
|
|
1689
1824
|
"name": "Collapsible",
|
|
1690
1825
|
"import": "@brightlocal/ui-components/collapsible",
|
|
1691
|
-
"category": "
|
|
1826
|
+
"category": "containers",
|
|
1692
1827
|
"exports": [
|
|
1693
1828
|
"Collapsible",
|
|
1694
1829
|
"CollapsibleTrigger",
|
|
@@ -1799,6 +1934,27 @@
|
|
|
1799
1934
|
"workaround": "Use @ts-expect-error when passing onValueChange to Combobox until the API is updated"
|
|
1800
1935
|
}
|
|
1801
1936
|
],
|
|
1937
|
+
"decisions": [
|
|
1938
|
+
{
|
|
1939
|
+
"date": "2026-11-05",
|
|
1940
|
+
"decision": "Combobox opens at the selected value: the selected item is centred in the list and is the active item, so arrow keys and Enter start from it. With no value, or a value the list does not contain, the first item is active. Typing in the search resets the active item to the first match.",
|
|
1941
|
+
"why": "A long list (a 15-minute time picker set to 17:30) opened at the top made people scroll back to their own value.",
|
|
1942
|
+
"ticket": "DS-1266"
|
|
1943
|
+
},
|
|
1944
|
+
{
|
|
1945
|
+
"date": "2026-11-12",
|
|
1946
|
+
"decision": "ComboboxEmpty (and CommandEmpty) take an action the way EmptyState does: the message as `title`, the buttons as `children`. The compact form is EmptyState size=\"sm\" (16px from the text to the actions, body-sm message). Without `title`, `children` are still the message, so existing usages do not change. With actions, the empty state is role=group labelled by the EmptyState title instead of role=option, and Enter on an action stops before cmdk's Command root.",
|
|
1947
|
+
"why": "The location switcher needs Add location on a no-match search, and the full EmptyState title is too large for a popover. A button inside role=option fails axe nested-interactive, and cmdk prevents the default of every Enter, which would swallow the button's keyboard click.",
|
|
1948
|
+
"ticket": "DS-1301"
|
|
1949
|
+
}
|
|
1950
|
+
],
|
|
1951
|
+
"ruledOut": [
|
|
1952
|
+
{
|
|
1953
|
+
"option": "Keeping cmdk's `value` prop on Command controlled for the whole open",
|
|
1954
|
+
"why": "cmdk reads the active item's id and scroll target from the DOM before its items re-render, so in controlled mode aria-activedescendant and keyboard scrolling lag one key press behind. The value is seeded for the opening render only, then handed back to cmdk.",
|
|
1955
|
+
"ticket": "DS-1266"
|
|
1956
|
+
}
|
|
1957
|
+
],
|
|
1802
1958
|
"replaces": [],
|
|
1803
1959
|
"states": [
|
|
1804
1960
|
"open",
|
|
@@ -1936,7 +2092,7 @@
|
|
|
1936
2092
|
{
|
|
1937
2093
|
"name": "Command",
|
|
1938
2094
|
"import": "@brightlocal/ui-components/command",
|
|
1939
|
-
"category": "
|
|
2095
|
+
"category": "navigation",
|
|
1940
2096
|
"exports": [
|
|
1941
2097
|
"Command",
|
|
1942
2098
|
"CommandEmpty",
|
|
@@ -2074,7 +2230,7 @@
|
|
|
2074
2230
|
{
|
|
2075
2231
|
"name": "ContextMenu",
|
|
2076
2232
|
"import": "@brightlocal/ui-components/context-menu",
|
|
2077
|
-
"category": "
|
|
2233
|
+
"category": "actions",
|
|
2078
2234
|
"exports": [
|
|
2079
2235
|
"ContextMenu",
|
|
2080
2236
|
"ContextMenuTrigger",
|
|
@@ -2181,10 +2337,76 @@
|
|
|
2181
2337
|
"global page-level actions (use DropdownMenu)"
|
|
2182
2338
|
]
|
|
2183
2339
|
},
|
|
2340
|
+
{
|
|
2341
|
+
"name": "CountIndicator",
|
|
2342
|
+
"import": "@brightlocal/ui-components/count-indicator",
|
|
2343
|
+
"category": "form",
|
|
2344
|
+
"exports": [
|
|
2345
|
+
"CountIndicator"
|
|
2346
|
+
],
|
|
2347
|
+
"compound": false,
|
|
2348
|
+
"dataHookRequired": true,
|
|
2349
|
+
"variants": {},
|
|
2350
|
+
"props": [
|
|
2351
|
+
"count",
|
|
2352
|
+
"limit",
|
|
2353
|
+
"labels",
|
|
2354
|
+
"ready"
|
|
2355
|
+
],
|
|
2356
|
+
"description": "A small count against a limit, such as \"120 / 750\" (characters) or \"3 / 5\" (items), that turns red once it goes over the limit (exactly at the limit is not highlighted). The shared count for text fields: Textarea shows it with `limit`, InputGroupCount and InputChipCount place it inside an input group or a chip field. It never blocks typing; the consumer shows the error and stops the save. Screen readers hear the value with the field and a polite announcement only when the count goes over.",
|
|
2357
|
+
"i18nProps": {
|
|
2358
|
+
"CountIndicator": {
|
|
2359
|
+
"labels.value": "(count, limit) => string — default: \"{count} of {limit}\"; spoken with the field",
|
|
2360
|
+
"labels.over": "(excess) => string — default: \"{excess} over the limit\"; announced once on going over"
|
|
2361
|
+
}
|
|
2362
|
+
},
|
|
2363
|
+
"whenToUse": [
|
|
2364
|
+
"A text field with a character limit (use Textarea limit, or InputGroupCount for an Input)",
|
|
2365
|
+
"A chip field with an item limit (InputChipCount)",
|
|
2366
|
+
"Building another field that needs the same count"
|
|
2367
|
+
],
|
|
2368
|
+
"doNotUseFor": [
|
|
2369
|
+
"the count of results or rows on a page (use ResultCount)",
|
|
2370
|
+
"a line of text about a list, such as \"3 more to go\" (write it as text; it is a message about the list, not a field count)",
|
|
2371
|
+
"scores out of a maximum, such as 61 / 100"
|
|
2372
|
+
],
|
|
2373
|
+
"decisions": [
|
|
2374
|
+
{
|
|
2375
|
+
"date": "2026-11-05",
|
|
2376
|
+
"ticket": "DS-1165",
|
|
2377
|
+
"decision": "The count sits inside the field, at the bottom right (end of the row for an Input, end of the last row for a chip field). It is a simple count with no caption.",
|
|
2378
|
+
"why": "Decided for DS-1165 after the inventory of every counter in the prototypes and greenfield; every hand-built one sat under the field and each wrote its own copy and wiring."
|
|
2379
|
+
},
|
|
2380
|
+
{
|
|
2381
|
+
"date": "2026-11-05",
|
|
2382
|
+
"ticket": "DS-1165",
|
|
2383
|
+
"decision": "The count never blocks input. Over the limit it turns red and the field takes the error border; the consumer shows the message (FieldError) and stops the save in validation. The field does not set aria-invalid itself.",
|
|
2384
|
+
"why": "Blocking typing (maxLength) cuts off pasted text silently; letting the user exceed the limit, see the error and trim keeps their text. Validation already has to stop the save, so aria-invalid stays with it."
|
|
2385
|
+
},
|
|
2386
|
+
{
|
|
2387
|
+
"date": "2026-11-05",
|
|
2388
|
+
"ticket": "DS-1165",
|
|
2389
|
+
"decision": "Two states only: normal, and red once the count goes over the limit. There is no warning zone and no warnAt; exactly at the limit is not highlighted.",
|
|
2390
|
+
"why": "Reaching the limit is the count the user is allowed to reach. Red means error, and the only error is going over; a warning colour near the limit added a state and a prop without telling the user anything they could act on."
|
|
2391
|
+
}
|
|
2392
|
+
],
|
|
2393
|
+
"ruledOut": [
|
|
2394
|
+
{
|
|
2395
|
+
"option": "Count under the field, right-aligned (the hand-built LimitCount pattern)",
|
|
2396
|
+
"why": "The count belongs inside the field (DS-1165); the prototypes' LimitCount and greenfield's InputChipField counter string were interim solutions.",
|
|
2397
|
+
"ticket": "DS-1165"
|
|
2398
|
+
},
|
|
2399
|
+
{
|
|
2400
|
+
"option": "A list-status line (\"Three more to go\", \"N selected · M slots left\") as part of this component",
|
|
2401
|
+
"why": "It is a message about a list or table, not a field count; kept out of DS-1165.",
|
|
2402
|
+
"ticket": "DS-1165"
|
|
2403
|
+
}
|
|
2404
|
+
]
|
|
2405
|
+
},
|
|
2184
2406
|
{
|
|
2185
2407
|
"name": "DataTable",
|
|
2186
2408
|
"import": "@brightlocal/ui-components/data-table",
|
|
2187
|
-
"category": "
|
|
2409
|
+
"category": "data",
|
|
2188
2410
|
"exports": [
|
|
2189
2411
|
"DataTable",
|
|
2190
2412
|
"DataTableBulkActions",
|
|
@@ -2223,17 +2445,25 @@
|
|
|
2223
2445
|
"paginateExpandedRows",
|
|
2224
2446
|
"getRowId",
|
|
2225
2447
|
"getRowClassName",
|
|
2448
|
+
"onRowClick",
|
|
2449
|
+
"getRowAriaLabel",
|
|
2450
|
+
"activeRowId",
|
|
2226
2451
|
"renderExpandedContent",
|
|
2227
2452
|
"isLoading",
|
|
2228
2453
|
"refetching",
|
|
2454
|
+
"sortLoading",
|
|
2229
2455
|
"refetchingLabel",
|
|
2230
2456
|
"skeletonRowCount",
|
|
2231
2457
|
"noResultsMessage",
|
|
2458
|
+
"noResultsTitle",
|
|
2459
|
+
"noResultsDescription",
|
|
2232
2460
|
"layout",
|
|
2233
2461
|
"minWidth",
|
|
2234
2462
|
"scrollRegionLabel",
|
|
2235
2463
|
"stickyHeader",
|
|
2236
2464
|
"footer",
|
|
2465
|
+
"aria-label",
|
|
2466
|
+
"aria-labelledby",
|
|
2237
2467
|
"className"
|
|
2238
2468
|
],
|
|
2239
2469
|
"i18nProps": {
|
|
@@ -2331,6 +2561,54 @@
|
|
|
2331
2561
|
"decision": "stickyHeader=\"page\" pins the thead to the page scroller with CSS sticky at --content-sticky-top, which a sticky CardHeader publishes with its live height. The headings stick while the table fits; once it is measured wider than the view (minWidth, column meta.minWidth, wide content) and scrolls sideways the view becomes the horizontal scroll region and the headings scroll with the page.",
|
|
2332
2562
|
"why": "Any overflow:auto axis makes the view a scroll container that traps a sticky thead, and CSS cannot stick one element to two scrollers. CSS-only keeps scroll-linked JS out of the table.",
|
|
2333
2563
|
"ticket": "DS-1215"
|
|
2564
|
+
},
|
|
2565
|
+
{
|
|
2566
|
+
"date": "2026-11-05",
|
|
2567
|
+
"decision": "DataTable and VirtualizedDataTable accept aria-label and aria-labelledby, forwarded to the inner <Table> element.",
|
|
2568
|
+
"why": "Tables inside a dialog or section need a landmark label distinct from the dialog's title; forwarding the native ARIA attributes is the most composable approach.",
|
|
2569
|
+
"ticket": "DS-1064"
|
|
2570
|
+
},
|
|
2571
|
+
{
|
|
2572
|
+
"date": "2026-11-05",
|
|
2573
|
+
"decision": "DataTableColumnHeader records the clicked column on the SortOverrideStore (pendingFocusColumnId) only while its button holds focus; a layout effect in DataTableHeaderRows hands focus back to that column's new button after each sort-triggered header remount (the loading flag flipping on, then off). The record is dropped on the next focusin elsewhere or any pointerdown, so a stale target can never pull focus on a later unrelated re-render.",
|
|
2574
|
+
"why": "Server-side sort consumers rebuild the columns array on each sort (passing loading to every header), causing full header remounts that drop keyboard focus.",
|
|
2575
|
+
"ticket": "DS-1236"
|
|
2576
|
+
},
|
|
2577
|
+
{
|
|
2578
|
+
"date": "2026-11-09",
|
|
2579
|
+
"decision": "DataTable (and VirtualizedDataTable) take `sortLoading`, provided through a table-level context; a DataTableColumnHeader with no `loading` prop of its own reads it, and an explicit `loading` still wins. It is a separate flag from `refetching`, which also covers page, filter and search refetches that must not mark the sort headers busy.",
|
|
2580
|
+
"why": "Passing `loading` into every header meant rebuilding the columns array whenever the flag flipped, which remounted every header (the focus restore of 2026-11-05 only patched the symptom). Set once on the table, the columns stay stable and the headers never remount. Reusing `refetching` would spin the sorted column on every page change, because with no column mid-sort the spinner falls back to the sorted ones.",
|
|
2581
|
+
"ticket": "DS-1236"
|
|
2582
|
+
},
|
|
2583
|
+
{
|
|
2584
|
+
"date": "2026-11-05",
|
|
2585
|
+
"decision": "The table's empty-state message is `sticky left-0` and capped at the scroll container's visible width, which the container measures with a ResizeObserver and publishes as `--table-view-inline-size` (useTableViewInlineSize in lib/table-internal; written to the element's style, no re-render). Unset, the cap is `none`.",
|
|
2586
|
+
"why": "With minWidth the table can be wider than the screen, so a message centred across the whole table scrolls off-screen on a phone. Measuring keeps the table's intrinsic width intact — see the ruled-out container-query approach.",
|
|
2587
|
+
"ticket": "DS-1105"
|
|
2588
|
+
},
|
|
2589
|
+
{
|
|
2590
|
+
"date": "2026-11-05",
|
|
2591
|
+
"decision": "onRowClick makes a row clickable: cursor-pointer, hover tint (also mirrored into --dt-row-bg so pinned cells tint; skipped on selected and expanded-parent rows), focus ring, tabIndex=0, Enter/Space activation. An event only counts as the row's activation when its target is inside the row's DOM (React bubbles portaled Dialog/DropdownMenu content through the row) and no nested control matches INTERACTIVE_SELECTOR. getRowAriaLabel provides the accessible name; omitting it logs a dev warning.",
|
|
2592
|
+
"why": "The most common row action is navigating to a detail view; consumers should not need to wire tabIndex, keyboard handlers, and interactive-element exclusion on every row.",
|
|
2593
|
+
"ticket": "DS-1123"
|
|
2594
|
+
},
|
|
2595
|
+
{
|
|
2596
|
+
"date": "2026-11-06",
|
|
2597
|
+
"decision": "activeRowId marks the row whose sheet or detail view is open: data-active=\"true\" + aria-current=\"true\", the selected surface (bg-muted, mirrored into --dt-row-bg for pinned cells), and no hover tint. One id, not a per-row predicate: a detail view shows one record at a time. The open row and a selected row share the surface until the surfaces agreement decides whether \"current\" gets its own.",
|
|
2598
|
+
"why": "Rank Tracker and Review Manager both hold the open row highlighted while its sheet is open, and screen-reader users need to hear which row that is, not only see it. Sharing the selected surface avoids a new token before DS-1010 settles surfaces and state layers; aria-current and data-active tell the two states apart.",
|
|
2599
|
+
"ticket": "DS-1123"
|
|
2600
|
+
},
|
|
2601
|
+
{
|
|
2602
|
+
"date": "2026-11-06",
|
|
2603
|
+
"decision": "meta.pinned is live only while the table is wider than its view: the view measures overflow (ResizeObserver on view and table) whenever a visible column is pinned, and only then do the pinned cells get the sticky classes, the divider and data-pinned=\"left\". No breakpoint prop: the trigger is the overflow itself, not a screen size.",
|
|
2604
|
+
"why": "On a wide screen the always-on pin drew a divider after the first column of a table that never scrolls (Rank Tracker desktop). The workaround it replaced pinned on phones only; tying the pin to real overflow covers phones, narrow laptops and wide minWidth tables with no consumer configuration.",
|
|
2605
|
+
"ticket": "DS-1205"
|
|
2606
|
+
},
|
|
2607
|
+
{
|
|
2608
|
+
"date": "2026-11-09",
|
|
2609
|
+
"decision": "Where a refetching table shows its wait depends on what asked for it. An in-place refresh (page, sort, search) shows busy at the control that asked: the pagination button, or the sort header's or search field's loading. A scope change (a filter, tabs used as a filter) shows it on the list: the consumer dims the rows and the count holds its previous value until new data arrives; the control that changed the scope shows no busy state.",
|
|
2610
|
+
"why": "A scope change replaces the whole result set, so the list and its count are the surface that owns the wait; the filter control is done once clicked. Patterns/Filtering (DS-973) already put the dim and Updating results on the list; the refetching JSDoc and the Loading page still sent filter busy to the control, and Review Manager's tabs-as-filter asked for a tab spinner to match (DS-1213).",
|
|
2611
|
+
"ticket": "DS-1213"
|
|
2334
2612
|
}
|
|
2335
2613
|
],
|
|
2336
2614
|
"ruledOut": [
|
|
@@ -2343,6 +2621,16 @@
|
|
|
2343
2621
|
"option": "A JS scroll listener that translates the thead under the card header while the table scrolls sideways",
|
|
2344
2622
|
"why": "Scroll-linked positioning lags the compositor by a frame and jitters on fast scroll; the owner chose CSS-only.",
|
|
2345
2623
|
"ticket": "DS-1215"
|
|
2624
|
+
},
|
|
2625
|
+
{
|
|
2626
|
+
"option": "container-type: inline-size on the table's scroll container so the empty-state message can use 100cqi (DS-1105)",
|
|
2627
|
+
"why": "Inline-size containment zeroes the element's intrinsic width: a DataTable with minWidth inside any shrink-to-fit parent — a row flex item without flex-1, w-fit, a grid auto track — collapsed from its full width to 2px (verified in Chrome 156). The measured --table-view-inline-size variable gives the same cap with no layout side effect.",
|
|
2628
|
+
"ticket": "DS-1105"
|
|
2629
|
+
},
|
|
2630
|
+
{
|
|
2631
|
+
"option": "Highlight the open row through getRowClassName (bg-muted on the open row), or reuse row selection for it",
|
|
2632
|
+
"why": "getRowClassName restyles the DS from outside: the built-in hover tint lightens the row, pinned cells keep the old surface, and nothing announces the row. Selection is a different state (chosen for a bulk action) and fights the checkboxes. activeRowId covers it.",
|
|
2633
|
+
"ticket": "DS-1123"
|
|
2346
2634
|
}
|
|
2347
2635
|
]
|
|
2348
2636
|
},
|
|
@@ -2460,7 +2748,7 @@
|
|
|
2460
2748
|
{
|
|
2461
2749
|
"name": "Delta",
|
|
2462
2750
|
"import": "@brightlocal/ui-components/delta",
|
|
2463
|
-
"category": "
|
|
2751
|
+
"category": "indicators",
|
|
2464
2752
|
"exports": [
|
|
2465
2753
|
"Delta"
|
|
2466
2754
|
],
|
|
@@ -2540,7 +2828,7 @@
|
|
|
2540
2828
|
{
|
|
2541
2829
|
"name": "Description",
|
|
2542
2830
|
"import": "@brightlocal/ui-components/description",
|
|
2543
|
-
"category": "
|
|
2831
|
+
"category": "form",
|
|
2544
2832
|
"exports": [
|
|
2545
2833
|
"Description"
|
|
2546
2834
|
],
|
|
@@ -2569,7 +2857,7 @@
|
|
|
2569
2857
|
{
|
|
2570
2858
|
"name": "DescriptionList",
|
|
2571
2859
|
"import": "@brightlocal/ui-components/description-list",
|
|
2572
|
-
"category": "
|
|
2860
|
+
"category": "data",
|
|
2573
2861
|
"exports": [
|
|
2574
2862
|
"DescriptionList",
|
|
2575
2863
|
"DescriptionListItem",
|
|
@@ -2674,6 +2962,7 @@
|
|
|
2674
2962
|
"DialogOverlay",
|
|
2675
2963
|
"DialogContent",
|
|
2676
2964
|
"DialogHeader",
|
|
2965
|
+
"DialogBody",
|
|
2677
2966
|
"DialogFooter",
|
|
2678
2967
|
"DialogTitle",
|
|
2679
2968
|
"DialogDescription"
|
|
@@ -2774,12 +3063,16 @@
|
|
|
2774
3063
|
},
|
|
2775
3064
|
{
|
|
2776
3065
|
"export": "DialogContent",
|
|
2777
|
-
"reason": "Drawn by the Dialog set (the panel)"
|
|
3066
|
+
"reason": "Drawn by the Dialog set (the panel); the content-driven width is runtime in code (DS-1249)"
|
|
2778
3067
|
},
|
|
2779
3068
|
{
|
|
2780
3069
|
"export": "DialogHeader",
|
|
2781
3070
|
"reason": "Drawn inside the set, structural"
|
|
2782
3071
|
},
|
|
3072
|
+
{
|
|
3073
|
+
"export": "DialogBody",
|
|
3074
|
+
"reason": "Drawn inside the set as the content between header and footer; scrolling is runtime in code"
|
|
3075
|
+
},
|
|
2783
3076
|
{
|
|
2784
3077
|
"export": "DialogFooter",
|
|
2785
3078
|
"reason": "Drawn inside the set, structural"
|
|
@@ -2805,7 +3098,22 @@
|
|
|
2805
3098
|
"reason": "Close-icon part; code renders it inside DialogContent"
|
|
2806
3099
|
}
|
|
2807
3100
|
]
|
|
2808
|
-
}
|
|
3101
|
+
},
|
|
3102
|
+
"decisions": [
|
|
3103
|
+
{
|
|
3104
|
+
"date": "2026-11-05",
|
|
3105
|
+
"decision": "Width follows content: min 512, text wraps at 512, max min(1024, viewport-32). DialogContent is width: min-content between min-w min(32rem, 100% - 2rem) and max-w min(64rem, 100% - 2rem), centred with inset-x-0 + mx-auto, so only content with a real intrinsic width (a table with minWidth, an image, an explicit width) widens it while text wraps; the header and footer stretch to the full width. Every dialog is capped at max-h 85svh as a flex column; DialogBody (ScrollArea, like SheetBody) takes the leftover height and scrolls so the header, footer and close button stay in view. Without a DialogBody the panel itself scrolls. There is no maxHeight prop.",
|
|
3106
|
+
"why": "Prototypes hand-sized dialogs with sm:max-w-md/xl/2xl/3xl/5xl/6xl and max heights from 85svh to 100dvh, each re-building the flex column and inner scroll. The DS owners want the width to come from the content, like Card, rather than from a preset the consumer picks. min-content (not fit-content) keeps text from stretching the panel to the cap without per-part rules. A single built-in height cap removes the inconsistency a per-dialog max-height prop would bring back (DS-1249).",
|
|
3107
|
+
"ticket": "DS-1249"
|
|
3108
|
+
}
|
|
3109
|
+
],
|
|
3110
|
+
"ruledOut": [
|
|
3111
|
+
{
|
|
3112
|
+
"option": "Fixed size presets",
|
|
3113
|
+
"why": "Width comes from content, like Card.",
|
|
3114
|
+
"ticket": "DS-1249"
|
|
3115
|
+
}
|
|
3116
|
+
]
|
|
2809
3117
|
},
|
|
2810
3118
|
{
|
|
2811
3119
|
"name": "Drawer",
|
|
@@ -2819,6 +3127,7 @@
|
|
|
2819
3127
|
"DrawerOverlay",
|
|
2820
3128
|
"DrawerContent",
|
|
2821
3129
|
"DrawerHeader",
|
|
3130
|
+
"DrawerBody",
|
|
2822
3131
|
"DrawerFooter",
|
|
2823
3132
|
"DrawerTitle",
|
|
2824
3133
|
"DrawerDescription"
|
|
@@ -2829,7 +3138,8 @@
|
|
|
2829
3138
|
"props": [
|
|
2830
3139
|
"open",
|
|
2831
3140
|
"onOpenChange",
|
|
2832
|
-
"direction"
|
|
3141
|
+
"direction",
|
|
3142
|
+
"fullHeight"
|
|
2833
3143
|
],
|
|
2834
3144
|
"description": "Slide-out drawer panel",
|
|
2835
3145
|
"whenToUse": [
|
|
@@ -2851,6 +3161,20 @@
|
|
|
2851
3161
|
"rule": "Use Dialog when content should be centered and focused, not sliding from an edge"
|
|
2852
3162
|
}
|
|
2853
3163
|
],
|
|
3164
|
+
"decisions": [
|
|
3165
|
+
{
|
|
3166
|
+
"date": "2026-11-16",
|
|
3167
|
+
"ticket": "DS-1330",
|
|
3168
|
+
"decision": "fullHeight is a boolean on DrawerContent, not a size variant axis or vaul snapPoints",
|
|
3169
|
+
"why": "A boolean is sufficient for the binary 80svh vs 100svh choice — two prototypes prove the need and no third height has been requested; if one materialises, refactor to a size axis then"
|
|
3170
|
+
},
|
|
3171
|
+
{
|
|
3172
|
+
"date": "2026-11-16",
|
|
3173
|
+
"ticket": "DS-1330",
|
|
3174
|
+
"decision": "80svh default preserved — fullHeight is opt-in",
|
|
3175
|
+
"why": "Existing drawers are unaffected; full-height is only needed for tall-content panels like mobile filter sheets with 30+ options"
|
|
3176
|
+
}
|
|
3177
|
+
],
|
|
2854
3178
|
"figma": {
|
|
2855
3179
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2856
3180
|
"nodes": [
|
|
@@ -2894,6 +3218,10 @@
|
|
|
2894
3218
|
"export": "DrawerHeader",
|
|
2895
3219
|
"reason": "Drawn inside the set ('Show Header' toggle)"
|
|
2896
3220
|
},
|
|
3221
|
+
{
|
|
3222
|
+
"export": "DrawerBody",
|
|
3223
|
+
"reason": "Content area inside the set — scroll behaviour is runtime"
|
|
3224
|
+
},
|
|
2897
3225
|
{
|
|
2898
3226
|
"export": "DrawerFooter",
|
|
2899
3227
|
"reason": "Drawn inside the set ('Show Footer' toggle)"
|
|
@@ -2924,7 +3252,7 @@
|
|
|
2924
3252
|
{
|
|
2925
3253
|
"name": "DropdownMenu",
|
|
2926
3254
|
"import": "@brightlocal/ui-components/dropdown-menu",
|
|
2927
|
-
"category": "
|
|
3255
|
+
"category": "actions",
|
|
2928
3256
|
"exports": [
|
|
2929
3257
|
"DropdownMenu",
|
|
2930
3258
|
"DropdownMenuTrigger",
|
|
@@ -3079,6 +3407,21 @@
|
|
|
3079
3407
|
"Action menus opened from a button, icon, or avatar (row actions, account menu)",
|
|
3080
3408
|
"Grouping related actions under a single labeled trigger",
|
|
3081
3409
|
"Menus discoverable by clicking rather than right-click or hover"
|
|
3410
|
+
],
|
|
3411
|
+
"decisions": [
|
|
3412
|
+
{
|
|
3413
|
+
"date": "2026-11-06",
|
|
3414
|
+
"decision": "There is no busy state inside a menu item: no loading prop and no busy-item recipe. Choosing an action closes the menu (no preventDefault in onSelect); if it takes time, progress shows where the result lands (the row, the trigger, a dialog or the page), never inside the menu. A trigger that shows the wait follows DS-1125 busy, not disabled.",
|
|
3415
|
+
"why": "The menu is a transient overlay the action dismisses. When it closes, focus returns to the trigger, so progress is announced at the trigger or on the page. The only keep-open consumer (tools-app logout) is avoidable: services-app sends the same revoke without awaiting it and closes the menu at once.",
|
|
3416
|
+
"ticket": "DS-1122"
|
|
3417
|
+
}
|
|
3418
|
+
],
|
|
3419
|
+
"ruledOut": [
|
|
3420
|
+
{
|
|
3421
|
+
"option": "A loading/busy prop on DropdownMenuItem, or a recipe that keeps the menu open (preventDefault in onSelect) with a disabled item and a Spinner",
|
|
3422
|
+
"why": "Ruled out by the DS owner at the human gate on 2026-11-06: zero repeat consumers, and the one case is avoidable. Re-open only for a result that can only be shown inside the open menu, confirmed by the DS owner.",
|
|
3423
|
+
"ticket": "DS-1122"
|
|
3424
|
+
}
|
|
3082
3425
|
]
|
|
3083
3426
|
},
|
|
3084
3427
|
{
|
|
@@ -3159,10 +3502,396 @@
|
|
|
3159
3502
|
}
|
|
3160
3503
|
]
|
|
3161
3504
|
},
|
|
3505
|
+
{
|
|
3506
|
+
"name": "FileUpload",
|
|
3507
|
+
"import": "@brightlocal/ui-components/file-upload",
|
|
3508
|
+
"category": "media",
|
|
3509
|
+
"exports": [
|
|
3510
|
+
"FileUpload",
|
|
3511
|
+
"FileUploadAccept",
|
|
3512
|
+
"FileUploadCardItem",
|
|
3513
|
+
"FileUploadDropzone",
|
|
3514
|
+
"FileUploadDropzoneContent",
|
|
3515
|
+
"FileUploadGridItem",
|
|
3516
|
+
"FileUploadIdle",
|
|
3517
|
+
"FileUploadItem",
|
|
3518
|
+
"FileUploadItemPreview",
|
|
3519
|
+
"FileUploadItemProgress",
|
|
3520
|
+
"FileUploadItemRemove",
|
|
3521
|
+
"FileUploadList",
|
|
3522
|
+
"FileUploadReject",
|
|
3523
|
+
"FileUploadRejections",
|
|
3524
|
+
"FileUploadCount",
|
|
3525
|
+
"FileUploadSlot",
|
|
3526
|
+
"FileUploadTrigger",
|
|
3527
|
+
"PHOTO_UPLOAD_RULES",
|
|
3528
|
+
"FILE_UPLOAD_MESSAGES",
|
|
3529
|
+
"formatBytes",
|
|
3530
|
+
"getFileTypeIcon",
|
|
3531
|
+
"getImageDimensions",
|
|
3532
|
+
"useObjectUrl"
|
|
3533
|
+
],
|
|
3534
|
+
"compound": true,
|
|
3535
|
+
"dataHookRequired": true,
|
|
3536
|
+
"variants": {},
|
|
3537
|
+
"props": [
|
|
3538
|
+
"value",
|
|
3539
|
+
"onValueChange",
|
|
3540
|
+
"onFileReject",
|
|
3541
|
+
"onFileValidate",
|
|
3542
|
+
"multiple",
|
|
3543
|
+
"minImageSize",
|
|
3544
|
+
"acceptLabel",
|
|
3545
|
+
"onUpload",
|
|
3546
|
+
"messages"
|
|
3547
|
+
],
|
|
3548
|
+
"i18nProps": {
|
|
3549
|
+
"FileUploadDropzone": {
|
|
3550
|
+
"ariaLabel": "string — default: \"Upload file\""
|
|
3551
|
+
},
|
|
3552
|
+
"FileUploadList": {
|
|
3553
|
+
"ariaLabel": "string — default: \"Uploaded files\""
|
|
3554
|
+
},
|
|
3555
|
+
"FileUploadItemRemove": {
|
|
3556
|
+
"removeAriaLabel": "string — default: \"Remove {fileName}\""
|
|
3557
|
+
},
|
|
3558
|
+
"FileUploadRejections": {
|
|
3559
|
+
"title": "string — default: \"{n} files weren't added\"",
|
|
3560
|
+
"dismissLabel": "string — default: \"Dismiss\""
|
|
3561
|
+
},
|
|
3562
|
+
"FileUploadSlot": {
|
|
3563
|
+
"uploadLabel": "string — default: \"Upload / Replace\"",
|
|
3564
|
+
"removeLabel": "string — default: \"Remove\"",
|
|
3565
|
+
"uploadingLabel": "string — default: \"Uploading…\"",
|
|
3566
|
+
"messages": "Partial<FileUploadMessages> — default: FILE_UPLOAD_MESSAGES (rejection reasons, upload outcomes, announcements; {placeholders})"
|
|
3567
|
+
},
|
|
3568
|
+
"FileUploadItemProgress": {
|
|
3569
|
+
"uploadingLabel": "string — default: \"Uploading…\"",
|
|
3570
|
+
"successLabel": "string — default: \"Uploaded\"",
|
|
3571
|
+
"errorLabel": "string — default: \"Upload failed\""
|
|
3572
|
+
},
|
|
3573
|
+
"FileUpload": {
|
|
3574
|
+
"messages": "Partial<FileUploadMessages> — default: FILE_UPLOAD_MESSAGES (rejection reasons, upload outcomes, announcements; {placeholders})"
|
|
3575
|
+
},
|
|
3576
|
+
"FileUploadCount": {
|
|
3577
|
+
"labels": "Partial<CountIndicatorLabels> — default: { value: (count, limit) => `${count} of ${limit}`, over: (excess) => `${excess} over the limit` }"
|
|
3578
|
+
}
|
|
3579
|
+
},
|
|
3580
|
+
"description": "Drag-and-drop file upload with validation, image previews, upload progress tracking, rejection banners (Alert), and single-image slots. Supports grid and list layouts, per-file upload status (idle/uploading/success/error), focus management after removal, ARIA live region for announcements, a `messages` prop for every generated string, and the PHOTO_UPLOAD_RULES preset. FileUploadSlot accepts `layout` (`\"vertical\"` centres the image above the label and buttons; `\"horizontal\"` places the image beside a column of label, description and buttons — default `\"vertical\"`), `description` (hint text below the label), `emptyMessage` (text alongside the placeholder icon), and `actions` (extra content in the button row, shown when an image is present).",
|
|
3581
|
+
"mimeIconMap": [
|
|
3582
|
+
{
|
|
3583
|
+
"category": "Images",
|
|
3584
|
+
"mimeMatch": "image/*",
|
|
3585
|
+
"extensions": [],
|
|
3586
|
+
"icon": "FileImage",
|
|
3587
|
+
"note": "Renders actual image thumbnail preview"
|
|
3588
|
+
},
|
|
3589
|
+
{
|
|
3590
|
+
"category": "Spreadsheets",
|
|
3591
|
+
"mimeMatch": "text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
|
|
3592
|
+
"extensions": [
|
|
3593
|
+
".csv",
|
|
3594
|
+
".xlsx",
|
|
3595
|
+
".xls"
|
|
3596
|
+
],
|
|
3597
|
+
"icon": "FileSpreadsheet"
|
|
3598
|
+
},
|
|
3599
|
+
{
|
|
3600
|
+
"category": "JSON",
|
|
3601
|
+
"mimeMatch": "application/json",
|
|
3602
|
+
"extensions": [
|
|
3603
|
+
".json"
|
|
3604
|
+
],
|
|
3605
|
+
"icon": "FileJson"
|
|
3606
|
+
},
|
|
3607
|
+
{
|
|
3608
|
+
"category": "Code / Markup",
|
|
3609
|
+
"mimeMatch": "application/xml, text/xml",
|
|
3610
|
+
"extensions": [
|
|
3611
|
+
".xml",
|
|
3612
|
+
".html",
|
|
3613
|
+
".htm",
|
|
3614
|
+
".svg"
|
|
3615
|
+
],
|
|
3616
|
+
"icon": "FileCode"
|
|
3617
|
+
},
|
|
3618
|
+
{
|
|
3619
|
+
"category": "Documents",
|
|
3620
|
+
"mimeMatch": "application/pdf, text/*",
|
|
3621
|
+
"extensions": [
|
|
3622
|
+
".pdf",
|
|
3623
|
+
".txt",
|
|
3624
|
+
".md",
|
|
3625
|
+
".doc",
|
|
3626
|
+
".docx",
|
|
3627
|
+
".rtf"
|
|
3628
|
+
],
|
|
3629
|
+
"icon": "FileText"
|
|
3630
|
+
},
|
|
3631
|
+
{
|
|
3632
|
+
"category": "All other files",
|
|
3633
|
+
"mimeMatch": null,
|
|
3634
|
+
"extensions": [],
|
|
3635
|
+
"icon": "File",
|
|
3636
|
+
"note": "Generic fallback"
|
|
3637
|
+
}
|
|
3638
|
+
],
|
|
3639
|
+
"decisions": [
|
|
3640
|
+
{
|
|
3641
|
+
"decision": "Native HTML5 DnD over react-dropzone",
|
|
3642
|
+
"why": "DS adds deps only when the problem is genuinely hard to build (~100 lines custom hook vs 16KB dep). Avoids React version lag risk.",
|
|
3643
|
+
"date": "2026-11-06",
|
|
3644
|
+
"ticket": "DS-1137"
|
|
3645
|
+
},
|
|
3646
|
+
{
|
|
3647
|
+
"decision": "DS owns drag UI + validation only; upload lifecycle is consumer-owned",
|
|
3648
|
+
"why": "GBP Post Scheduler doesn't use progress at all, and Location Manager's upload state is consumer-side logic. DS should not simulate or track upload state. Superseded 2026-11-09 — see the onUpload decision.",
|
|
3649
|
+
"date": "2026-11-06",
|
|
3650
|
+
"ticket": "DS-1137"
|
|
3651
|
+
},
|
|
3652
|
+
{
|
|
3653
|
+
"decision": "Optional onUpload handler with per-file progress/status tracking (supersedes 2026-11-06 'DS owns drag UI + validation only')",
|
|
3654
|
+
"why": "Bulk import and file management need per-file idle/uploading/success/error UI and the same recipe across consumers; GBP Post Scheduler simply omits onUpload. Upload transport stays consumer-owned; the DS tracks status via the helpers and renders FileUploadItemProgress.",
|
|
3655
|
+
"date": "2026-11-09",
|
|
3656
|
+
"ticket": "DS-1137"
|
|
3657
|
+
},
|
|
3658
|
+
{
|
|
3659
|
+
"decision": "Compose with existing Chip for file items",
|
|
3660
|
+
"why": "Chip already has onRemove, loading state, and the right visual weight. No need for a dedicated FileUploadItem presentation. Superseded 2026-11-09: the file row is a consumer card recipe (FileUploadItemPreview + name/size + FileUploadItemRemove, Storybook ‘Dropzone Recipe’) — Chip’s single-line pill cannot hold a thumbnail, a size line and per-file progress.",
|
|
3661
|
+
"date": "2026-11-06",
|
|
3662
|
+
"ticket": "DS-1137"
|
|
3663
|
+
},
|
|
3664
|
+
{
|
|
3665
|
+
"decision": "Skip lab, ship directly in ui-components",
|
|
3666
|
+
"why": "Consumer need is immediate (DS-1054 GBP Post Scheduler, bulk import). API surface is well-understood from industry analysis.",
|
|
3667
|
+
"date": "2026-11-06",
|
|
3668
|
+
"ticket": "DS-1137"
|
|
3669
|
+
},
|
|
3670
|
+
{
|
|
3671
|
+
"decision": "Generated strings through one `messages` prop, not one label prop each",
|
|
3672
|
+
"why": "Rejection reasons, upload outcomes and announcements are ~14 templated strings produced by the root, not by a visible control; one Partial<FileUploadMessages> object keeps the sub-component APIs flat and lets consumers pass a whole translation bundle. Visible-control labels (ariaLabel, dismissLabel…) stay on the sub-component that renders them, per the i18n rule.",
|
|
3673
|
+
"date": "2026-11-09",
|
|
3674
|
+
"ticket": "DS-1137"
|
|
3675
|
+
},
|
|
3676
|
+
{
|
|
3677
|
+
"decision": "FileUploadSlot: `actions?: ReactNode` over `menu?: ReactNode`",
|
|
3678
|
+
"why": "Location Manager slots need an 'Edit description' button alongside Upload/Replace and Remove. `actions` is more flexible than `menu` — lets consumers inject buttons, dropdowns, or any content without forcing a specific UI pattern. Shown only when an image is present and not uploading.",
|
|
3679
|
+
"date": "2026-11-09",
|
|
3680
|
+
"ticket": "DS-1137"
|
|
3681
|
+
},
|
|
3682
|
+
{
|
|
3683
|
+
"decision": "FileUploadCardItem pre-composed row over FileUploadFileName/FileUploadFileDescription atoms",
|
|
3684
|
+
"why": "Individual name/description atoms fail the DS existence test — they own nothing beyond defaults that a <p> handles. FileUploadCardItem passes: it owns appearance (border card, truncation), layout (preview + text + remove + progress), and conditional behaviour (onRemove toggles the remove button, progress auto-hides when idle). Avoids every consumer re-assembling the same card boilerplate.",
|
|
3685
|
+
"date": "2026-11-10",
|
|
3686
|
+
"ticket": "DS-1137"
|
|
3687
|
+
},
|
|
3688
|
+
{
|
|
3689
|
+
"decision": "FileUploadGridItem pre-composed grid thumbnail with hover-reveal remove",
|
|
3690
|
+
"why": "The hover/focus-reveal overlay (translucent pill, opacity transition, focus-within) is fiddly CSS every grid consumer copies identically. FileUploadGridItem owns appearance (overlay styling), layout (absolute-positioned remove over lg preview), conditional behaviour (onRemove toggles remove, showName toggles caption, progress auto-renders). Same existence-test justification as FileUploadCardItem.",
|
|
3691
|
+
"date": "2026-11-10",
|
|
3692
|
+
"ticket": "DS-1137"
|
|
3693
|
+
},
|
|
3694
|
+
{
|
|
3695
|
+
"decision": "FileUploadDropzoneContent pre-composed idle/accept/reject interior",
|
|
3696
|
+
"why": "Every consumer copies the same dropzone layout (muted-circle icon + title + description + trigger button) and all three drag states (idle/accept/reject) with their colour mappings. Drift risk: a consumer forgets the reject state or uses wrong colours. The component owns appearance (circle tints, state colours), layout (centered stack), and semantics (correct drag-state-to-colour mapping). Consumer variation is just icon/title/description/triggerLabel — a clean props surface. Consumers who need a fully custom layout can still use Idle/Accept/Reject directly.",
|
|
3697
|
+
"date": "2026-11-10",
|
|
3698
|
+
"ticket": "DS-1137"
|
|
3699
|
+
},
|
|
3700
|
+
{
|
|
3701
|
+
"decision": "FileUploadCount wraps CountIndicator (DS-1165 pattern), no error-border propagation",
|
|
3702
|
+
"why": "CountIndicator is the DS count-against-limit primitive (text-body-xs, tabular-nums, data-state neutral/over, polite aria-live, Field aria-describedby). FileUploadCount wraps it (like InputChipCount, InputGroupCount) reading files.length and maxFiles from context. No error-border propagation because FileUpload rejects files at the limit — the user cannot go over, so the 'over' state and red styling only appear if count is injected above maxFiles.",
|
|
3703
|
+
"date": "2026-11-10",
|
|
3704
|
+
"ticket": "DS-1137"
|
|
3705
|
+
},
|
|
3706
|
+
{
|
|
3707
|
+
"decision": "The dropzone icon chip is LogoMark lg filled circle (the 40px circle EmptyState uses) in all three drag states, replacing the hand-rolled 48px tinted circle; idle is the muted chip, accept and reject use LogoMark variant success / destructive",
|
|
3708
|
+
"why": "The circle was the only circular icon mark in the DS and the dropzone's idle state has the same anatomy as EmptyState (chip, title, description, button). One shape in all three states so nothing changes shape mid-drag. A muted chip was too faint on the accept / reject tinted surfaces, so those states take LogoMark's success / destructive variant — a prop, not a background override on LogoMark (CLASSNAME_OVERRIDES). The whole accept state is on the success tokens (border and tint success-mark, the chip is LogoMark's success variant) and the accept and reject messages use the same ink as their chip's glyph (text-score-strong-ink, text-score-poor-ink); the single-image slot's accept ring follows (ring-success-mark).",
|
|
3709
|
+
"date": "2026-11-12",
|
|
3710
|
+
"ticket": "DS-1291"
|
|
3711
|
+
}
|
|
3712
|
+
],
|
|
3713
|
+
"ruledOut": [
|
|
3714
|
+
{
|
|
3715
|
+
"option": "FileUploadCount as a Badge (variant primary/secondary)",
|
|
3716
|
+
"why": "CountIndicator is the established DS primitive for count-against-limit display. Badge conveys a categorical label, not a live count. Wrapping CountIndicator gives free tabular-nums, aria-live announcer, Field registration, and data-state consistency across all count hosts.",
|
|
3717
|
+
"ticket": "DS-1137"
|
|
3718
|
+
},
|
|
3719
|
+
{
|
|
3720
|
+
"option": "FileUploadFileName / FileUploadFileDescription as separate sub-components",
|
|
3721
|
+
"why": "Fail the DS existence test — each is a styled <p> that owns nothing (no layout, no behaviour, no semantics a plain element can't provide). Defaults alone don't justify an export.",
|
|
3722
|
+
"ticket": "DS-1137"
|
|
3723
|
+
}
|
|
3724
|
+
],
|
|
3725
|
+
"figma": {
|
|
3726
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3727
|
+
"nodes": [
|
|
3728
|
+
{
|
|
3729
|
+
"nodeId": "35929:4472",
|
|
3730
|
+
"figmaName": "File Upload / Dropzone",
|
|
3731
|
+
"kind": "componentSet",
|
|
3732
|
+
"export": "FileUploadDropzone",
|
|
3733
|
+
"axes": [
|
|
3734
|
+
{
|
|
3735
|
+
"figma": "State",
|
|
3736
|
+
"exempt": "interaction-state",
|
|
3737
|
+
"note": "Idle/Accept/Reject are DnD drag states driven by the useFileDropzone hook, mapped to the CVA `state` variant"
|
|
3738
|
+
},
|
|
3739
|
+
{
|
|
3740
|
+
"figma": "Disabled",
|
|
3741
|
+
"exempt": "interaction-state",
|
|
3742
|
+
"valueToProp": {
|
|
3743
|
+
"True": "disabled"
|
|
3744
|
+
}
|
|
3745
|
+
}
|
|
3746
|
+
]
|
|
3747
|
+
},
|
|
3748
|
+
{
|
|
3749
|
+
"nodeId": "35929:4481",
|
|
3750
|
+
"figmaName": "File Upload / Item",
|
|
3751
|
+
"kind": "componentSet",
|
|
3752
|
+
"export": "FileUploadItem",
|
|
3753
|
+
"note": "Draws the consumer card recipe (Storybook 'Dropzone Recipe'): FileUploadItemPreview + name/size + FileUploadItemRemove, with FileUploadItemProgress below. Code's FileUploadItem itself is a bare <li>.",
|
|
3754
|
+
"axes": [
|
|
3755
|
+
{
|
|
3756
|
+
"figma": "Layout",
|
|
3757
|
+
"exempt": "export-discriminator",
|
|
3758
|
+
"note": "List = the row recipe inside FileUploadList variant=list; Grid = FileUploadItemPreview size=lg card inside variant=grid. Mirrors FileUploadList's `variant` values, not a prop of FileUploadItem."
|
|
3759
|
+
},
|
|
3760
|
+
{
|
|
3761
|
+
"figma": "Status",
|
|
3762
|
+
"exempt": "interaction-state",
|
|
3763
|
+
"note": "Idle/Uploading/Success/Error = FileUploadItemProgress `data-status` (FileUploadStatus), set at runtime by the onUpload helpers"
|
|
3764
|
+
}
|
|
3765
|
+
]
|
|
3766
|
+
},
|
|
3767
|
+
{
|
|
3768
|
+
"nodeId": "35953:303",
|
|
3769
|
+
"figmaName": "File Upload / Rejections",
|
|
3770
|
+
"kind": "componentSet",
|
|
3771
|
+
"export": "FileUploadRejections",
|
|
3772
|
+
"axes": [
|
|
3773
|
+
{
|
|
3774
|
+
"figma": "Count",
|
|
3775
|
+
"exempt": "figma-only-style",
|
|
3776
|
+
"note": "One / Many only switches the sample content (title singular/plural, list length); the banner is one code export with no variant axis"
|
|
3777
|
+
}
|
|
3778
|
+
]
|
|
3779
|
+
},
|
|
3780
|
+
{
|
|
3781
|
+
"nodeId": "35953:492",
|
|
3782
|
+
"figmaName": "File Upload / Slot",
|
|
3783
|
+
"kind": "componentSet",
|
|
3784
|
+
"export": "FileUploadSlot",
|
|
3785
|
+
"axes": [
|
|
3786
|
+
{
|
|
3787
|
+
"figma": "Shape",
|
|
3788
|
+
"code": "shape"
|
|
3789
|
+
},
|
|
3790
|
+
{
|
|
3791
|
+
"figma": "State",
|
|
3792
|
+
"exempt": "interaction-state",
|
|
3793
|
+
"valueToProp": {
|
|
3794
|
+
"Disabled": "disabled"
|
|
3795
|
+
},
|
|
3796
|
+
"note": "Empty/Filled/Uploading/Error are runtime states (src present, onUpload in flight, upload error or rejection shown)"
|
|
3797
|
+
}
|
|
3798
|
+
]
|
|
3799
|
+
},
|
|
3800
|
+
{
|
|
3801
|
+
"nodeId": "35953:327",
|
|
3802
|
+
"figmaName": "File Upload / Count",
|
|
3803
|
+
"kind": "componentSet",
|
|
3804
|
+
"export": "FileUploadCount",
|
|
3805
|
+
"axes": [
|
|
3806
|
+
{
|
|
3807
|
+
"figma": "At Limit",
|
|
3808
|
+
"exempt": "interaction-state",
|
|
3809
|
+
"note": "Figma-only visual state; code wraps CountIndicator whose data-state is neutral (at or under limit) or over (above limit). FileUpload rejects files at the limit, so over only appears when count is injected above maxFiles"
|
|
3810
|
+
}
|
|
3811
|
+
]
|
|
3812
|
+
}
|
|
3813
|
+
],
|
|
3814
|
+
"unmappedExports": [
|
|
3815
|
+
{
|
|
3816
|
+
"export": "FileUpload",
|
|
3817
|
+
"reason": "Root context provider, renders a plain flex container — not a Figma component"
|
|
3818
|
+
},
|
|
3819
|
+
{
|
|
3820
|
+
"export": "FileUploadTrigger",
|
|
3821
|
+
"reason": "Drawn inside the Idle dropzone variant as a Button instance, not a standalone Figma component"
|
|
3822
|
+
},
|
|
3823
|
+
{
|
|
3824
|
+
"export": "FileUploadIdle",
|
|
3825
|
+
"reason": "Code-only conditional render gate — shows children when state is idle"
|
|
3826
|
+
},
|
|
3827
|
+
{
|
|
3828
|
+
"export": "FileUploadAccept",
|
|
3829
|
+
"reason": "Code-only conditional render gate — shows children when state is accept"
|
|
3830
|
+
},
|
|
3831
|
+
{
|
|
3832
|
+
"export": "FileUploadReject",
|
|
3833
|
+
"reason": "Code-only conditional render gate — shows children when state is reject"
|
|
3834
|
+
},
|
|
3835
|
+
{
|
|
3836
|
+
"export": "FileUploadList",
|
|
3837
|
+
"reason": "Code-only <ul> list container; its `variant` (list / grid) is drawn as the `Layout` axis of the File Upload / Item set"
|
|
3838
|
+
},
|
|
3839
|
+
{
|
|
3840
|
+
"export": "PHOTO_UPLOAD_RULES",
|
|
3841
|
+
"reason": "Constant (preset validation rules) — not visual"
|
|
3842
|
+
},
|
|
3843
|
+
{
|
|
3844
|
+
"export": "formatBytes",
|
|
3845
|
+
"reason": "Utility function — not visual"
|
|
3846
|
+
},
|
|
3847
|
+
{
|
|
3848
|
+
"export": "getImageDimensions",
|
|
3849
|
+
"reason": "Utility function — not visual"
|
|
3850
|
+
},
|
|
3851
|
+
{
|
|
3852
|
+
"export": "useObjectUrl",
|
|
3853
|
+
"reason": "Utility hook — not visual"
|
|
3854
|
+
},
|
|
3855
|
+
{
|
|
3856
|
+
"export": "FileUploadItemPreview",
|
|
3857
|
+
"reason": "Drawn inside the File Upload / Item set (Thumbnail in Layout=List, Preview in Layout=Grid) — not a standalone Figma component"
|
|
3858
|
+
},
|
|
3859
|
+
{
|
|
3860
|
+
"export": "FileUploadItemProgress",
|
|
3861
|
+
"reason": "Drawn inside the File Upload / Item set as the `Status` axis (Uploading / Success / Error rows) — not a standalone Figma component"
|
|
3862
|
+
},
|
|
3863
|
+
{
|
|
3864
|
+
"export": "FileUploadItemRemove",
|
|
3865
|
+
"reason": "Drawn inside the File Upload / Item set (Remove button / grid overlay) — not a standalone Figma component"
|
|
3866
|
+
},
|
|
3867
|
+
{
|
|
3868
|
+
"export": "FILE_UPLOAD_MESSAGES",
|
|
3869
|
+
"reason": "Constant (default message templates) — not visual"
|
|
3870
|
+
},
|
|
3871
|
+
{
|
|
3872
|
+
"export": "FileUploadCardItem",
|
|
3873
|
+
"reason": "Pre-composed list-row recipe wrapping FileUploadItem + FileUploadItemPreview + FileUploadItemRemove + FileUploadItemProgress — drawn in Figma as File Upload / Item Layout=List"
|
|
3874
|
+
},
|
|
3875
|
+
{
|
|
3876
|
+
"export": "FileUploadGridItem",
|
|
3877
|
+
"reason": "Pre-composed grid-thumbnail recipe wrapping FileUploadItem + FileUploadItemPreview + hover-reveal remove — drawn in Figma as File Upload / Grid Item set (36037:745)"
|
|
3878
|
+
},
|
|
3879
|
+
{
|
|
3880
|
+
"export": "getFileTypeIcon",
|
|
3881
|
+
"reason": "Utility function (MIME→icon mapping) — not visual; the mapping is documented in the UX Guidance Preview Icons table"
|
|
3882
|
+
},
|
|
3883
|
+
{
|
|
3884
|
+
"export": "FileUploadDropzoneContent",
|
|
3885
|
+
"reason": "Pre-composed idle/accept/reject interior — drawn inside the Dropzone set's State axis variants (Idle, Accept, Reject)"
|
|
3886
|
+
}
|
|
3887
|
+
],
|
|
3888
|
+
"figmaOnly": []
|
|
3889
|
+
}
|
|
3890
|
+
},
|
|
3162
3891
|
{
|
|
3163
3892
|
"name": "GlobalLayout",
|
|
3164
3893
|
"import": "@brightlocal/ui-components/global-layout",
|
|
3165
|
-
"category": "layout",
|
|
3894
|
+
"category": "page-layout",
|
|
3166
3895
|
"exports": [
|
|
3167
3896
|
"GlobalLayout",
|
|
3168
3897
|
"GlobalLayoutSidebar",
|
|
@@ -3189,6 +3918,14 @@
|
|
|
3189
3918
|
"maxWidth",
|
|
3190
3919
|
"width"
|
|
3191
3920
|
],
|
|
3921
|
+
"decisions": [
|
|
3922
|
+
{
|
|
3923
|
+
"date": "2026-11-05",
|
|
3924
|
+
"decision": "GlobalLayoutContent's maxWidth sets the column for every region: the page header (GlobalLayoutContentHeader), a standalone GlobalLayoutActions row and GlobalLayoutBody all read --content-max-width. Outside GlobalLayoutContent the header and actions row fall back to the lg breakpoint. Region padding stays full width, so a border or sticky treatment under the header can still span the page.",
|
|
3925
|
+
"why": "The header was pinned to the lg breakpoint whatever maxWidth was set, so at md width the title ran 256px past the cards and settings prototypes overrode it inline. The header and the body are one column (DS-1248).",
|
|
3926
|
+
"ticket": "DS-1248"
|
|
3927
|
+
}
|
|
3928
|
+
],
|
|
3192
3929
|
"i18nProps": {
|
|
3193
3930
|
"GlobalLayoutMobileHeader": {
|
|
3194
3931
|
"ariaLabel": "string — default: \"Mobile navigation\""
|
|
@@ -3286,7 +4023,7 @@
|
|
|
3286
4023
|
{
|
|
3287
4024
|
"name": "Grid",
|
|
3288
4025
|
"import": "@brightlocal/ui-components/grid",
|
|
3289
|
-
"category": "layout",
|
|
4026
|
+
"category": "page-layout",
|
|
3290
4027
|
"exports": [
|
|
3291
4028
|
"Grid"
|
|
3292
4029
|
],
|
|
@@ -3334,7 +4071,7 @@
|
|
|
3334
4071
|
{
|
|
3335
4072
|
"name": "Header",
|
|
3336
4073
|
"import": "@brightlocal/ui-components/header",
|
|
3337
|
-
"category": "layout",
|
|
4074
|
+
"category": "page-layout",
|
|
3338
4075
|
"exports": [
|
|
3339
4076
|
"Header"
|
|
3340
4077
|
],
|
|
@@ -3390,7 +4127,7 @@
|
|
|
3390
4127
|
{
|
|
3391
4128
|
"name": "HeightTransition",
|
|
3392
4129
|
"import": "@brightlocal/ui-components/height-transition",
|
|
3393
|
-
"category": "
|
|
4130
|
+
"category": "containers",
|
|
3394
4131
|
"exports": [
|
|
3395
4132
|
"HeightTransition"
|
|
3396
4133
|
],
|
|
@@ -3422,7 +4159,7 @@
|
|
|
3422
4159
|
"closeDelay",
|
|
3423
4160
|
"disabled"
|
|
3424
4161
|
],
|
|
3425
|
-
"description": "
|
|
4162
|
+
"description": "Card that appears on hover; tap toggles on touch",
|
|
3426
4163
|
"figma": {
|
|
3427
4164
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3428
4165
|
"nodes": [
|
|
@@ -3473,18 +4210,25 @@
|
|
|
3473
4210
|
"whenToUse": [
|
|
3474
4211
|
"Rich previews on hover (profile summary on a user's name)",
|
|
3475
4212
|
"Extra context without requiring a click",
|
|
3476
|
-
"
|
|
4213
|
+
"Mixed input experiences — hover opens with a mouse, tap toggles on touch"
|
|
3477
4214
|
],
|
|
3478
4215
|
"doNotUseFor": [
|
|
3479
4216
|
"previews with clickable content (use Popover)",
|
|
3480
|
-
"touch-heavy products (hover doesn't work there)",
|
|
3481
4217
|
"single short lines of text (use Tooltip)"
|
|
4218
|
+
],
|
|
4219
|
+
"decisions": [
|
|
4220
|
+
{
|
|
4221
|
+
"decision": "Rebuilt on @radix-ui/react-popover with custom state machine (mirrors Tooltip pattern from DS-994)",
|
|
4222
|
+
"why": "Radix HoverCard intentionally blocks touch events; Popover primitives give full pointer-type control",
|
|
4223
|
+
"date": "2026-11-11",
|
|
4224
|
+
"ticket": "DS-1068"
|
|
4225
|
+
}
|
|
3482
4226
|
]
|
|
3483
4227
|
},
|
|
3484
4228
|
{
|
|
3485
4229
|
"name": "InfoTooltip",
|
|
3486
4230
|
"import": "@brightlocal/ui-components/info-tooltip",
|
|
3487
|
-
"category": "
|
|
4231
|
+
"category": "overlay",
|
|
3488
4232
|
"exports": [
|
|
3489
4233
|
"InfoTooltip"
|
|
3490
4234
|
],
|
|
@@ -3631,7 +4375,8 @@
|
|
|
3631
4375
|
"exports": [
|
|
3632
4376
|
"InputChip",
|
|
3633
4377
|
"InputChipInput",
|
|
3634
|
-
"InputChipItems"
|
|
4378
|
+
"InputChipItems",
|
|
4379
|
+
"InputChipCount"
|
|
3635
4380
|
],
|
|
3636
4381
|
"compound": true,
|
|
3637
4382
|
"dataHookRequired": true,
|
|
@@ -3680,6 +4425,10 @@
|
|
|
3680
4425
|
{
|
|
3681
4426
|
"export": "InputChipItems",
|
|
3682
4427
|
"reason": "Drawn inside the Input Chip set (the chip row), not a standalone Figma component"
|
|
4428
|
+
},
|
|
4429
|
+
{
|
|
4430
|
+
"export": "InputChipCount",
|
|
4431
|
+
"reason": "The item count inside the field; drawn as the count part of the Input Chip set once the Figma page lands (DS-1165)"
|
|
3683
4432
|
}
|
|
3684
4433
|
],
|
|
3685
4434
|
"figmaOnly": []
|
|
@@ -3718,7 +4467,8 @@
|
|
|
3718
4467
|
"InputGroupInput",
|
|
3719
4468
|
"InputGroupAddon",
|
|
3720
4469
|
"InputGroupButton",
|
|
3721
|
-
"InputGroupClear"
|
|
4470
|
+
"InputGroupClear",
|
|
4471
|
+
"InputGroupCount"
|
|
3722
4472
|
],
|
|
3723
4473
|
"compound": true,
|
|
3724
4474
|
"dataHookRequired": true,
|
|
@@ -3753,7 +4503,15 @@
|
|
|
3753
4503
|
"InputGroupClear": {
|
|
3754
4504
|
"clearSearchAriaLabel": "string — default: \"Clear search\""
|
|
3755
4505
|
}
|
|
3756
|
-
}
|
|
4506
|
+
},
|
|
4507
|
+
"decisions": [
|
|
4508
|
+
{
|
|
4509
|
+
"date": "2026-11-05",
|
|
4510
|
+
"decision": "InputGroupAddon owns its inner padding: align=\"inline-start\" is pl-3 and align=\"inline-end\" is pr-3 (12px, the same as Input's own px-3). An addon whose direct child is a button or an InputGroupButton (asChild links included, matched by data-slot) gets 4px instead, so an icon-sm button's icon (8px inside its 32px box) lands on the same 12px line as a bare icon. The inset is a CSS variable read by a plain pl-/pr- utility, so a consumer pl-*/pr-* replaces it rather than losing to the :has() selector. Block addons are unchanged.",
|
|
4511
|
+
"why": "With no padding the icon or prefix sat on the border, and every consumer added pl-3/pr-3 by hand. Plain 12px on a button addon would put its icon 20px in, out of line with icon addons (DS-1264).",
|
|
4512
|
+
"ticket": "DS-1264"
|
|
4513
|
+
}
|
|
4514
|
+
]
|
|
3757
4515
|
},
|
|
3758
4516
|
{
|
|
3759
4517
|
"name": "InputOTP",
|
|
@@ -3956,7 +4714,7 @@
|
|
|
3956
4714
|
{
|
|
3957
4715
|
"name": "Link",
|
|
3958
4716
|
"import": "@brightlocal/ui-components/link",
|
|
3959
|
-
"category": "
|
|
4717
|
+
"category": "navigation",
|
|
3960
4718
|
"exports": [
|
|
3961
4719
|
"Link"
|
|
3962
4720
|
],
|
|
@@ -4025,7 +4783,7 @@
|
|
|
4025
4783
|
{
|
|
4026
4784
|
"name": "List",
|
|
4027
4785
|
"import": "@brightlocal/ui-components/list",
|
|
4028
|
-
"category": "
|
|
4786
|
+
"category": "data",
|
|
4029
4787
|
"exports": [
|
|
4030
4788
|
"List",
|
|
4031
4789
|
"ListItem",
|
|
@@ -4209,6 +4967,12 @@
|
|
|
4209
4967
|
"decision": "truncate on ListItemTitle and ListItemDescription wraps to two lines and clamps the rest (line-clamp-2). The full text appears in a Tooltip only when the text is clamped: on hover, or on keyboard focus of the row's ListItemButton / ListItemLink. The text is never its own tab stop, and a touch tap inside a button, link or label is left to that control.",
|
|
4210
4968
|
"why": "Rows need a predictable height, but a clamped name or address must still be readable. Two lines cover most real text with no tooltip; opening it from the row's own focus keeps the row a single interactive target.",
|
|
4211
4969
|
"ticket": "DS-1166"
|
|
4970
|
+
},
|
|
4971
|
+
{
|
|
4972
|
+
"date": "2026-11-06",
|
|
4973
|
+
"decision": "List `bordered` wraps the whole group in one rounded border (rows inside stay plain); ListItem `outline` is for separate bordered rows. Inside a bordered list the rows lose their own border and radius, so an outline row never doubles the border; pair bordered with divided for a 1px line between rows.",
|
|
4974
|
+
"why": "Location Manager sheets and dialogs need a grouped list in one box, which prototypes were hand-building with a bordered div round the List.",
|
|
4975
|
+
"ticket": "DS-1082"
|
|
4212
4976
|
}
|
|
4213
4977
|
],
|
|
4214
4978
|
"ruledOut": [
|
|
@@ -4244,7 +5008,7 @@
|
|
|
4244
5008
|
{
|
|
4245
5009
|
"name": "Loading",
|
|
4246
5010
|
"import": "@brightlocal/ui-components/loading",
|
|
4247
|
-
"category": "
|
|
5011
|
+
"category": "loading",
|
|
4248
5012
|
"exports": [
|
|
4249
5013
|
"Loading"
|
|
4250
5014
|
],
|
|
@@ -4267,7 +5031,7 @@
|
|
|
4267
5031
|
{
|
|
4268
5032
|
"name": "Logo",
|
|
4269
5033
|
"import": "@brightlocal/ui-components/logo",
|
|
4270
|
-
"category": "
|
|
5034
|
+
"category": "media",
|
|
4271
5035
|
"exports": [
|
|
4272
5036
|
"Logo"
|
|
4273
5037
|
],
|
|
@@ -4318,7 +5082,7 @@
|
|
|
4318
5082
|
{
|
|
4319
5083
|
"name": "LogoMark",
|
|
4320
5084
|
"import": "@brightlocal/ui-components/logo-mark",
|
|
4321
|
-
"category": "
|
|
5085
|
+
"category": "media",
|
|
4322
5086
|
"exports": [
|
|
4323
5087
|
"LogoMark",
|
|
4324
5088
|
"SOURCE_ICON_ALIASES"
|
|
@@ -4329,7 +5093,9 @@
|
|
|
4329
5093
|
"variant": [
|
|
4330
5094
|
"transparent",
|
|
4331
5095
|
"filled",
|
|
4332
|
-
"border"
|
|
5096
|
+
"border",
|
|
5097
|
+
"success",
|
|
5098
|
+
"destructive"
|
|
4333
5099
|
],
|
|
4334
5100
|
"size": [
|
|
4335
5101
|
"xs",
|
|
@@ -4340,6 +5106,10 @@
|
|
|
4340
5106
|
"colorScheme": [
|
|
4341
5107
|
"original",
|
|
4342
5108
|
"neutral"
|
|
5109
|
+
],
|
|
5110
|
+
"shape": [
|
|
5111
|
+
"square",
|
|
5112
|
+
"circle"
|
|
4343
5113
|
]
|
|
4344
5114
|
},
|
|
4345
5115
|
"props": [
|
|
@@ -4347,10 +5117,11 @@
|
|
|
4347
5117
|
"size",
|
|
4348
5118
|
"variant",
|
|
4349
5119
|
"colorScheme",
|
|
5120
|
+
"shape",
|
|
4350
5121
|
"fallback",
|
|
4351
5122
|
"ariaLabel"
|
|
4352
5123
|
],
|
|
4353
|
-
"description": "Displays a brand logo, any lucide icon (globe, star, map-pin, building-2, phone, mail, etc.), or a letter-initial fallback in a consistent mark. Resolves the name against the DS social-media icon registry first, then lucide, loading each icon as its own chunk via iconImports from @brightlocal/icons/dynamic. Variants: filled (bg-muted surface, default), border (border ring), transparent (bare icon). Four sizes: xs, sm, md, lg. colorScheme toggles original/neutral for social-media icons.",
|
|
5124
|
+
"description": "Displays a brand logo, any lucide icon (globe, star, map-pin, building-2, phone, mail, etc.), or a letter-initial fallback in a consistent mark. Resolves the name against the DS social-media icon registry first, then lucide, loading each icon as its own chunk via iconImports from @brightlocal/icons/dynamic. Variants: filled (bg-muted surface, default), border (border ring), transparent (bare icon), success (bg-score-strong/15 with text-score-strong-ink) and destructive (bg-score-poor/15 with text-score-poor-ink) — the last two use the Delta pill's tint and ink for outcome glyphs, not brand logos. Four sizes: xs, sm, md, lg. colorScheme toggles original/neutral for social-media icons. shape controls the container's border-radius: square (default, stepped rounded-md/rounded-lg) or circle (rounded-full); ignored on transparent, which has no container to round. Empty-state chips and file-upload dropzone feedback use the circle shape.",
|
|
4354
5125
|
"knownGaps": [
|
|
4355
5126
|
{
|
|
4356
5127
|
"description": "LogoMark inside Radix Select (SingleSelectFilter) fails in Storybook multiview: the dynamic import's async setState destabilises Radix's scroll-lock lifecycle when many variants render simultaneously. Popover-based filters (MultiSelectFilter) are unaffected. This is a Storybook test limitation, not a production bug.",
|
|
@@ -4404,6 +5175,24 @@
|
|
|
4404
5175
|
"why": "Importing the social-media barrel pulled every registered icon into one chunk on first render",
|
|
4405
5176
|
"date": "2026-10-28",
|
|
4406
5177
|
"ticket": "DS-1060"
|
|
5178
|
+
},
|
|
5179
|
+
{
|
|
5180
|
+
"decision": "Google Business Profile (formerly Google My Business) uses the standard coloured Google G: the names google-business-profile, gbp, google-my-business and gmb resolve to the google mark. There is no separate GBP icon.",
|
|
5181
|
+
"why": "The shopfront mark is the retired pre-rebrand Google My Business icon; Google now shows GBP with the single coloured G, and product chose to follow it (DS-1262).",
|
|
5182
|
+
"date": "2026-11-06",
|
|
5183
|
+
"ticket": "DS-1262"
|
|
5184
|
+
},
|
|
5185
|
+
{
|
|
5186
|
+
"decision": "variant gains success and destructive values (the former tone prop is folded into variant); LogoMark is extended rather than a separate StatusIcon component being added",
|
|
5187
|
+
"why": "Owner's call (Oksana, 2026-11-12/13): no new component for an icon in a tinted chip — LogoMark already owns the shape, sizes and icon handling. tone was merged into variant (2026-11-13) because it only mattered on filled, so a single axis is simpler. Consumers: the FileUpload dropzone (accept / reject) and the 2FA on/off card. The value names follow Alert (success / destructive), not 'primary'. Tokens: both variants use the Delta pill's tint and ink (success: bg-score-strong/15 + text-score-strong-ink; destructive: bg-score-poor/15 + text-score-poor-ink), so a tinted mark and a Delta pill read as the same green and red. This knowingly uses score tokens for an outcome, not only for a graded value. The colour never carries the meaning alone; the glyph and the adjacent text do. warning / info are not added until something needs them. Supersedes the 2026-11-04 prototype note that LogoMark is identity-only.",
|
|
5188
|
+
"date": "2026-11-12",
|
|
5189
|
+
"ticket": "DS-1291"
|
|
5190
|
+
},
|
|
5191
|
+
{
|
|
5192
|
+
"decision": "shape (square | circle) added to LogoMark; circle is the default for empty-state chips and file-upload dropzone feedback",
|
|
5193
|
+
"why": "Owner's call (Oksana, 2026-11-12): reverses the earlier ruledOut of 2026-11-12. The circle shape is needed for empty-state chips and dropzone marks so the mark distinguishes identity (square, brand logos) from status/state (circle, glyphs). EmptyChip defaults shape to circle; FileUpload dropzone hard-codes circle. Ignored on transparent (no container). The prior reasoning — 'circle already means a person (Avatar)' — does not hold because the circle mark has a muted fill / border, not an image, so it reads as a chip not a face.",
|
|
5194
|
+
"date": "2026-11-12",
|
|
5195
|
+
"ticket": "DS-1291"
|
|
4407
5196
|
}
|
|
4408
5197
|
],
|
|
4409
5198
|
"ruledOut": [
|
|
@@ -4411,14 +5200,19 @@
|
|
|
4411
5200
|
"option": "Hand-drawn or AI-generated approximations of brand marks",
|
|
4412
5201
|
"why": "Not the brand's logo; see decision of 2026-10-28",
|
|
4413
5202
|
"ticket": "DS-1060"
|
|
5203
|
+
},
|
|
5204
|
+
{
|
|
5205
|
+
"option": "A separate Google Business Profile shopfront mark",
|
|
5206
|
+
"why": "Retired pre-rebrand Google My Business icon; GBP uses the Google G (see decision of 2026-11-06)",
|
|
5207
|
+
"ticket": "DS-1262"
|
|
4414
5208
|
}
|
|
4415
5209
|
],
|
|
4416
5210
|
"figma": {
|
|
4417
5211
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4418
|
-
"note": "
|
|
5212
|
+
"note": "Rebuilt on DS-1291 Figma branch riJNFsT4v01WsgzKGh7kdY; node IDs valid after branch merge.",
|
|
4419
5213
|
"nodes": [
|
|
4420
5214
|
{
|
|
4421
|
-
"nodeId": "
|
|
5215
|
+
"nodeId": "36309:108982",
|
|
4422
5216
|
"figmaName": "Logo Mark",
|
|
4423
5217
|
"kind": "componentSet",
|
|
4424
5218
|
"export": "LogoMark",
|
|
@@ -4436,9 +5230,8 @@
|
|
|
4436
5230
|
"code": "colorScheme"
|
|
4437
5231
|
},
|
|
4438
5232
|
{
|
|
4439
|
-
"figma": "
|
|
4440
|
-
"
|
|
4441
|
-
"note": "Known/Fallback is a runtime resolution outcome (not a consumer prop); demonstrates the two visual states"
|
|
5233
|
+
"figma": "Shape",
|
|
5234
|
+
"code": "shape"
|
|
4442
5235
|
}
|
|
4443
5236
|
]
|
|
4444
5237
|
}
|
|
@@ -4454,7 +5247,7 @@
|
|
|
4454
5247
|
{
|
|
4455
5248
|
"name": "Map",
|
|
4456
5249
|
"import": "@brightlocal/ui-components/map",
|
|
4457
|
-
"category": "
|
|
5250
|
+
"category": "data",
|
|
4458
5251
|
"exports": [
|
|
4459
5252
|
"MAP_STYLES",
|
|
4460
5253
|
"MapTypeId",
|
|
@@ -4579,7 +5372,7 @@
|
|
|
4579
5372
|
{
|
|
4580
5373
|
"name": "MediaEmpty",
|
|
4581
5374
|
"import": "@brightlocal/ui-components/media-empty",
|
|
4582
|
-
"category": "
|
|
5375
|
+
"category": "media",
|
|
4583
5376
|
"exports": [
|
|
4584
5377
|
"MediaEmpty"
|
|
4585
5378
|
],
|
|
@@ -4589,15 +5382,28 @@
|
|
|
4589
5382
|
"MediaEmptyVariant": [
|
|
4590
5383
|
"image",
|
|
4591
5384
|
"video"
|
|
5385
|
+
],
|
|
5386
|
+
"MediaEmptySize": [
|
|
5387
|
+
"md",
|
|
5388
|
+
"sm"
|
|
4592
5389
|
]
|
|
4593
5390
|
},
|
|
4594
5391
|
"props": [
|
|
4595
5392
|
"variant",
|
|
5393
|
+
"size",
|
|
4596
5394
|
"icon",
|
|
4597
5395
|
"message",
|
|
4598
5396
|
"className"
|
|
4599
5397
|
],
|
|
4600
|
-
"
|
|
5398
|
+
"decisions": [
|
|
5399
|
+
{
|
|
5400
|
+
"date": "2026-11-05",
|
|
5401
|
+
"decision": "MediaEmpty has a compact size=\"sm\" for slots under 48px: a 20px glyph alone, centred, no line, same muted surface and glyph colour. message is a discriminated-union prop that exists only at md. Only MediaEmpty exposes it; ChartEmpty and MapEmpty stay one size.",
|
|
5402
|
+
"why": "A 32px glyph plus a reserved line cannot centre in a 40px thumbnail (GBP Post Scheduler posts table), so the prototype hand-built a bg-muted tile. A sub-48px thumbnail sits next to the row that names it, so it is decorative and has no room for a line. Chart plots and map wells are never that small.",
|
|
5403
|
+
"ticket": "DS-1257"
|
|
5404
|
+
}
|
|
5405
|
+
],
|
|
5406
|
+
"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\". size=\"md\" (default) is for a content box; size=\"sm\" is for slots under 48px (table thumbnails, list avatars) and draws a 20px glyph alone, centred, with no line. The props are a discriminated union on size: message exists only at md.",
|
|
4601
5407
|
"aliases": [
|
|
4602
5408
|
"image empty",
|
|
4603
5409
|
"image placeholder",
|
|
@@ -4611,7 +5417,8 @@
|
|
|
4611
5417
|
"video placeholder"
|
|
4612
5418
|
],
|
|
4613
5419
|
"whenToUse": [
|
|
4614
|
-
"A photo slot with no photo: a location without an uploaded image, a card whose media is unset"
|
|
5420
|
+
"A photo slot with no photo: a location without an uploaded image, a card whose media is unset",
|
|
5421
|
+
"A table thumbnail, list avatar or any media slot under 48px with no media: size=\"sm\""
|
|
4615
5422
|
],
|
|
4616
5423
|
"doNotUseFor": [
|
|
4617
5424
|
"an image that failed to load (that is an error, and it should say so)",
|
|
@@ -4627,7 +5434,7 @@
|
|
|
4627
5434
|
{
|
|
4628
5435
|
"name": "MediaViewer",
|
|
4629
5436
|
"import": "@brightlocal/ui-components/media-viewer",
|
|
4630
|
-
"category": "
|
|
5437
|
+
"category": "media",
|
|
4631
5438
|
"exports": [
|
|
4632
5439
|
"MediaViewer",
|
|
4633
5440
|
"MediaViewerTrigger",
|
|
@@ -4783,7 +5590,7 @@
|
|
|
4783
5590
|
{
|
|
4784
5591
|
"name": "Menubar",
|
|
4785
5592
|
"import": "@brightlocal/ui-components/menubar",
|
|
4786
|
-
"category": "
|
|
5593
|
+
"category": "actions",
|
|
4787
5594
|
"exports": [
|
|
4788
5595
|
"Menubar",
|
|
4789
5596
|
"MenubarMenu",
|
|
@@ -5416,7 +6223,7 @@
|
|
|
5416
6223
|
{
|
|
5417
6224
|
"name": "Progress",
|
|
5418
6225
|
"import": "@brightlocal/ui-components/progress",
|
|
5419
|
-
"category": "
|
|
6226
|
+
"category": "data",
|
|
5420
6227
|
"exports": [
|
|
5421
6228
|
"Progress"
|
|
5422
6229
|
],
|
|
@@ -5613,7 +6420,7 @@
|
|
|
5613
6420
|
{
|
|
5614
6421
|
"name": "Rating",
|
|
5615
6422
|
"import": "@brightlocal/ui-components/rating",
|
|
5616
|
-
"category": "
|
|
6423
|
+
"category": "content",
|
|
5617
6424
|
"exports": [
|
|
5618
6425
|
"Rating"
|
|
5619
6426
|
],
|
|
@@ -5688,7 +6495,7 @@
|
|
|
5688
6495
|
{
|
|
5689
6496
|
"name": "RelativeDate",
|
|
5690
6497
|
"import": "@brightlocal/ui-components/relative-date",
|
|
5691
|
-
"category": "
|
|
6498
|
+
"category": "content",
|
|
5692
6499
|
"exports": [
|
|
5693
6500
|
"RelativeDate",
|
|
5694
6501
|
"useNow",
|
|
@@ -5787,7 +6594,7 @@
|
|
|
5787
6594
|
{
|
|
5788
6595
|
"name": "Resizable",
|
|
5789
6596
|
"import": "@brightlocal/ui-components/resizable",
|
|
5790
|
-
"category": "
|
|
6597
|
+
"category": "containers",
|
|
5791
6598
|
"exports": [
|
|
5792
6599
|
"ResizablePanelGroup",
|
|
5793
6600
|
"ResizablePanel",
|
|
@@ -5822,7 +6629,7 @@
|
|
|
5822
6629
|
{
|
|
5823
6630
|
"name": "ResultCount",
|
|
5824
6631
|
"import": "@brightlocal/ui-components/result-count",
|
|
5825
|
-
"category": "
|
|
6632
|
+
"category": "content",
|
|
5826
6633
|
"exports": [
|
|
5827
6634
|
"ResultCount"
|
|
5828
6635
|
],
|
|
@@ -5834,9 +6641,10 @@
|
|
|
5834
6641
|
"total",
|
|
5835
6642
|
"from",
|
|
5836
6643
|
"to",
|
|
5837
|
-
"updating"
|
|
6644
|
+
"updating (deprecated, no-op)",
|
|
6645
|
+
"updatingLabel (deprecated, no-op)"
|
|
5838
6646
|
],
|
|
5839
|
-
"description": "The one count text the DS renders for a collection, as the screen's one role=\"status\" live region (Patterns/Filtering, Where controls live). Plain form (`count` + optional `total`): \"4 of 24 locations\" — the toolbar count of a filtered list. Range form (`from` + `to` + `total`): \"1 to 20 of 45 locations\" — what DataTablePagination and PaginationControls render, so a paged collection shows the count once, in the toolbar or the pagination row, never both. At zero the visible text hides (the empty state says it) and the region keeps the screen-reader-only emptyLabel
|
|
6647
|
+
"description": "The one count text the DS renders for a collection, as the screen's one role=\"status\" live region (Patterns/Filtering, Where controls live). Plain form (`count` + optional `total`): \"4 of 24 locations\" — the toolbar count of a filtered list. Range form (`from` + `to` + `total`): \"1 to 20 of 45 locations\" — what DataTablePagination and PaginationControls render, so a paged collection shows the count once, in the toolbar or the pagination row, never both. At zero the visible text hides (the empty state says it) and the region keeps the screen-reader-only emptyLabel. During a scope-change refetch the count holds its previous value until new data arrives — no dimming, no spinner. The `updating` and `updatingLabel` props are deprecated no-ops since 3.5.0 and will be removed in the next major version. Name the records in the product's words through the label templates.",
|
|
5840
6648
|
"i18nProps": {
|
|
5841
6649
|
"ResultCount": {
|
|
5842
6650
|
"label": "string — default: \"{count} of {total} results\"",
|
|
@@ -5845,7 +6653,6 @@
|
|
|
5845
6653
|
"noTotalLabelOne": "string — default: \"{count} result\"; used at count === 1, falls back to noTotalLabel",
|
|
5846
6654
|
"rangeLabel": "string — default: \"{from} to {to} of {total} results\"",
|
|
5847
6655
|
"rangeLabelOne": "string — default: \"{from} to {to} of {total} result\"; used at total === 1, falls back to rangeLabel",
|
|
5848
|
-
"updatingLabel": "string — default: \"Updating results\"",
|
|
5849
6656
|
"emptyLabel": "string — default: \"No results\""
|
|
5850
6657
|
}
|
|
5851
6658
|
},
|
|
@@ -5881,6 +6688,12 @@
|
|
|
5881
6688
|
"decision": "Each template has one singular counterpart (labelOne, noTotalLabelOne, rangeLabelOne), picked by the number the noun follows — the total when there is one, the count otherwise — and falling back to the plural template so a noun is never swapped for the English default.",
|
|
5882
6689
|
"why": "A single template read \"1 results\" and \"1 to 1 of 1 invoices\"; the prototypes had hand-rolled the singular in renderText and lost it on the move to the template. One `_one` form mirrors i18next's plural keys, so t(\"key_one\") / t(\"key_other\") map straight onto the two props; ICU plural syntax in the template was more than English and the team's locales need.",
|
|
5883
6690
|
"ticket": "DS-973"
|
|
6691
|
+
},
|
|
6692
|
+
{
|
|
6693
|
+
"date": "2026-11-13",
|
|
6694
|
+
"decision": "ResultCount's `updating` / `updatingLabel` props are deprecated no-ops since 3.5.0 (removed in the next major). During a scope-change refetch the count holds its previous value unchanged until new data arrives — no dimming, no spinner, no SR-only updating announcement. The DataTable's own `refetching` live region handles the wait announcement for all refetch types. The same deprecation applies to the passthrough wrappers: DataTablePagination (`rowCountUpdating` / `rowCountUpdatingLabel`), DataTablePaginationRowCount (`updating` / `updatingLabel`), and PaginationControls (`updating` / `updatingLabel`).",
|
|
6695
|
+
"why": "Cross-DS research (Polaris, Atlassian, Ant Design, MUI, Carbon, Primer, Semrush) shows no major system dims, spinners or announces the count text during a refetch — the count stays unchanged until new data arrives. The props shipped in 3.4.0 but the behaviour was dead weight; deprecating rather than removing avoids a breaking change for consumers who may already pass them.",
|
|
6696
|
+
"ticket": "DS-1285"
|
|
5884
6697
|
}
|
|
5885
6698
|
],
|
|
5886
6699
|
"ruledOut": [
|
|
@@ -5894,7 +6707,7 @@
|
|
|
5894
6707
|
{
|
|
5895
6708
|
"name": "RouteProgress",
|
|
5896
6709
|
"import": "@brightlocal/ui-components/route-progress",
|
|
5897
|
-
"category": "
|
|
6710
|
+
"category": "loading",
|
|
5898
6711
|
"exports": [
|
|
5899
6712
|
"RouteProgress"
|
|
5900
6713
|
],
|
|
@@ -5986,7 +6799,7 @@
|
|
|
5986
6799
|
{
|
|
5987
6800
|
"name": "ScrollArea",
|
|
5988
6801
|
"import": "@brightlocal/ui-components/scroll-area",
|
|
5989
|
-
"category": "
|
|
6802
|
+
"category": "containers",
|
|
5990
6803
|
"exports": [
|
|
5991
6804
|
"ScrollArea",
|
|
5992
6805
|
"ScrollAreaScrollbar",
|
|
@@ -6190,7 +7003,7 @@
|
|
|
6190
7003
|
{
|
|
6191
7004
|
"name": "Separator",
|
|
6192
7005
|
"import": "@brightlocal/ui-components/separator",
|
|
6193
|
-
"category": "
|
|
7006
|
+
"category": "page-layout",
|
|
6194
7007
|
"exports": [
|
|
6195
7008
|
"Separator",
|
|
6196
7009
|
"SeparatorWithText"
|
|
@@ -6286,7 +7099,8 @@
|
|
|
6286
7099
|
"size": [
|
|
6287
7100
|
"default",
|
|
6288
7101
|
"sm",
|
|
6289
|
-
"lg"
|
|
7102
|
+
"lg",
|
|
7103
|
+
"xl"
|
|
6290
7104
|
]
|
|
6291
7105
|
},
|
|
6292
7106
|
"props": [
|
|
@@ -6301,7 +7115,8 @@
|
|
|
6301
7115
|
"ariaLabel": "string — default: \"Item navigation\"",
|
|
6302
7116
|
"prevAriaLabel": "string — default: \"Previous item\"",
|
|
6303
7117
|
"nextAriaLabel": "string — default: \"Next item\"",
|
|
6304
|
-
"renderPosition": "(info) => ReactNode — default: \"{current} of {total}\""
|
|
7118
|
+
"renderPosition": "(info) => ReactNode — default: \"{current} of {total}\"",
|
|
7119
|
+
"loadingLabel": "string — default: \"Loading item\""
|
|
6305
7120
|
}
|
|
6306
7121
|
},
|
|
6307
7122
|
"description": "Side panel overlay",
|
|
@@ -6338,7 +7153,29 @@
|
|
|
6338
7153
|
"replaces": [],
|
|
6339
7154
|
"states": [
|
|
6340
7155
|
"open",
|
|
6341
|
-
"closed"
|
|
7156
|
+
"closed",
|
|
7157
|
+
"loading (SheetPagination)"
|
|
7158
|
+
],
|
|
7159
|
+
"decisions": [
|
|
7160
|
+
{
|
|
7161
|
+
"date": "2026-11-05",
|
|
7162
|
+
"decision": "SheetPagination takes one boolean `loading` (pass the fetching flag). The button that requested the step — tracked internally, so an arrow key pressed on Previous that asks for Next spins Next — swaps its chevron for the shared Spinner in its own footprint and sets aria-busy; both buttons ignore clicks and arrow keys while it is true but are not disabled, and a polite sr-only status announces `loadingLabel` (\"Loading item\"). hasPrevious / hasNext keep describing the list.",
|
|
7163
|
+
"why": "Follows the Loading pattern's refetch rule and the DataTableColumnHeader `loading` precedent: the control that requested the change owns the wait. Disabling the buttons (the Review Manager workaround) dropped focus to <body> and hid which step was working (DS-1125).",
|
|
7164
|
+
"ticket": "DS-1125"
|
|
7165
|
+
},
|
|
7166
|
+
{
|
|
7167
|
+
"date": "2026-11-05",
|
|
7168
|
+
"decision": "The form width is a new size=\"xl\": full width on phones, 480px from the sm breakpoint, 640px from xl. size=\"lg\" stays 75% of the viewport up to 512px.",
|
|
7169
|
+
"why": "lg shipped in 3.3.0 as the 512px detail-panel width (DS-1206) and rank-tracker keyword sheets are written against it, so widening lg would silently resize published consumers. Forms with a table or a row of selects need the wider, two-step width (Tool Settings and Location Manager edit sheets), and on a phone 75% is too narrow for fields (DS-1245).",
|
|
7170
|
+
"ticket": "DS-1245"
|
|
7171
|
+
}
|
|
7172
|
+
],
|
|
7173
|
+
"ruledOut": [
|
|
7174
|
+
{
|
|
7175
|
+
"option": "A direction-valued loading prop (`loading=\"next\" | \"previous\"`) or per-button loading booleans",
|
|
7176
|
+
"why": "The component already knows which button requested the step, including arrow keys that step the other way; making the consumer repeat it adds a way to point the spinner at the wrong button.",
|
|
7177
|
+
"ticket": "DS-1125"
|
|
7178
|
+
}
|
|
6342
7179
|
],
|
|
6343
7180
|
"a11yContract": {
|
|
6344
7181
|
"role": "dialog",
|
|
@@ -6555,7 +7392,7 @@
|
|
|
6555
7392
|
{
|
|
6556
7393
|
"name": "Skeleton",
|
|
6557
7394
|
"import": "@brightlocal/ui-components/skeleton",
|
|
6558
|
-
"category": "
|
|
7395
|
+
"category": "loading",
|
|
6559
7396
|
"exports": [
|
|
6560
7397
|
"Skeleton"
|
|
6561
7398
|
],
|
|
@@ -6743,7 +7580,7 @@
|
|
|
6743
7580
|
{
|
|
6744
7581
|
"name": "Spinner",
|
|
6745
7582
|
"import": "@brightlocal/ui-components/spinner",
|
|
6746
|
-
"category": "
|
|
7583
|
+
"category": "loading",
|
|
6747
7584
|
"exports": [
|
|
6748
7585
|
"Spinner"
|
|
6749
7586
|
],
|
|
@@ -6776,7 +7613,7 @@
|
|
|
6776
7613
|
{
|
|
6777
7614
|
"name": "SplitLayout",
|
|
6778
7615
|
"import": "@brightlocal/ui-components/split-layout",
|
|
6779
|
-
"category": "layout",
|
|
7616
|
+
"category": "page-layout",
|
|
6780
7617
|
"exports": [
|
|
6781
7618
|
"SplitLayout",
|
|
6782
7619
|
"SplitLayoutHeader",
|
|
@@ -6848,7 +7685,7 @@
|
|
|
6848
7685
|
{
|
|
6849
7686
|
"name": "Status",
|
|
6850
7687
|
"import": "@brightlocal/ui-components/status",
|
|
6851
|
-
"category": "
|
|
7688
|
+
"category": "indicators",
|
|
6852
7689
|
"exports": [
|
|
6853
7690
|
"Status"
|
|
6854
7691
|
],
|
|
@@ -6887,7 +7724,8 @@
|
|
|
6887
7724
|
"A fact or label about the thing (plan tier, count, \"New\") — use Badge",
|
|
6888
7725
|
"A message the user should read or act on — use Alert",
|
|
6889
7726
|
"A lone problem on an otherwise healthy row — use an icon, not a dotOnly Status",
|
|
6890
|
-
"The change between two values — use Delta"
|
|
7727
|
+
"The change between two values — use Delta",
|
|
7728
|
+
"A state that needs nothing from anyone and is not worth noticing — write it as plain text"
|
|
6891
7729
|
],
|
|
6892
7730
|
"alternatives": [
|
|
6893
7731
|
{
|
|
@@ -6925,6 +7763,22 @@
|
|
|
6925
7763
|
"why": "One axis for every state of the mark, named like Button's loading so the DS speaks one word for in-progress",
|
|
6926
7764
|
"date": "2026-11-02",
|
|
6927
7765
|
"ticket": "DS-1235"
|
|
7766
|
+
},
|
|
7767
|
+
{
|
|
7768
|
+
"decision": "A summary of several statuses shows the most urgent level among its parts",
|
|
7769
|
+
"why": "Following Carbon status indicators: a roll-up that averages or shows the healthiest part hides the one that needs action",
|
|
7770
|
+
"date": "2026-11-12",
|
|
7771
|
+
"ticket": "DS-1014"
|
|
7772
|
+
}
|
|
7773
|
+
],
|
|
7774
|
+
"open": [
|
|
7775
|
+
{
|
|
7776
|
+
"question": "Should each level get its own shape or icon, not one circle in four colours? Carbon asks for two of colour, shape and symbol, and against one shape in several colours.",
|
|
7777
|
+
"owner": "Alastair Driver"
|
|
7778
|
+
},
|
|
7779
|
+
{
|
|
7780
|
+
"question": "Should dotOnly stay? With the word hidden only colour is left on screen, and the light-mode success, warning and info dots are under 3:1 against white.",
|
|
7781
|
+
"owner": "Alastair Driver"
|
|
6928
7782
|
}
|
|
6929
7783
|
]
|
|
6930
7784
|
},
|
|
@@ -7079,7 +7933,7 @@
|
|
|
7079
7933
|
{
|
|
7080
7934
|
"name": "Table",
|
|
7081
7935
|
"import": "@brightlocal/ui-components/table",
|
|
7082
|
-
"category": "
|
|
7936
|
+
"category": "data",
|
|
7083
7937
|
"exports": [
|
|
7084
7938
|
"Table",
|
|
7085
7939
|
"TableHeader",
|
|
@@ -7292,12 +8146,61 @@
|
|
|
7292
8146
|
},
|
|
7293
8147
|
"props": [
|
|
7294
8148
|
"variant",
|
|
8149
|
+
"fullWidth",
|
|
7295
8150
|
"value",
|
|
7296
8151
|
"defaultValue",
|
|
7297
8152
|
"onValueChange",
|
|
7298
8153
|
"lazyMount",
|
|
7299
8154
|
"unmountOnExit"
|
|
7300
8155
|
],
|
|
8156
|
+
"decisions": [
|
|
8157
|
+
{
|
|
8158
|
+
"date": "2026-11-05",
|
|
8159
|
+
"decision": "With unmountOnExit off (the default), TabsContent passes forceMount to Radix and hides inactive panels with data-[state=inactive]:hidden (display: none), so every visited panel stays mounted. lazyMount still defers a panel until its first visit and then keeps it; unmountOnExit still unmounts on leave.",
|
|
8160
|
+
"why": "unmountOnExit defaulting to false reads as 'inactive panels stay mounted', but Radix unmounted them anyway, so edits in a form tab were lost on switch and Location Manager added forceMount + data-[state=inactive]:hidden to every TabsContent. display: none keeps hidden panels out of the accessibility tree and tab order. Cost: effects in hidden panels stay alive and every panel mounts up front; a panel that is heavy or must not keep running opts into lazyMount or unmountOnExit (DS-1267).",
|
|
8161
|
+
"ticket": "DS-1267"
|
|
8162
|
+
},
|
|
8163
|
+
{
|
|
8164
|
+
"date": "2026-11-05",
|
|
8165
|
+
"decision": "TabsList takes fullWidth (both variants): the list stretches to its container, every trigger gets an equal share (flex-1 basis-0 min-w-0) and long labels wrap inside their trigger, centred; they never truncate. The default pill list grows past 36px when a label wraps. The triggers stay in one row at every width; the list does not reflow into a two-column grid.",
|
|
8166
|
+
"why": "Prototypes hand-rolled the same row with className=\"grid h-auto w-full grid-cols-2 sm:grid-cols-4\" on TabsList and w-full on every trigger, which no-unsafe-style-overrides flags. One row keeps the arrow-key order and the underline reading as one tab strip; a 2x2 tab grid has no active-row semantics (DS-1246).",
|
|
8167
|
+
"ticket": "DS-1246"
|
|
8168
|
+
},
|
|
8169
|
+
{
|
|
8170
|
+
"date": "2026-11-13",
|
|
8171
|
+
"decision": "Underline TabsList defaults to left-aligned (justify-start); pill TabsList defaults to centred (justify-center-safe). The previous shared justify-center-safe base was accidental inheritance from the pill variant.",
|
|
8172
|
+
"why": "Underline tabs sit inside report cards at the start of a data table or list; centring three short labels wastes the left edge and looks misaligned next to a left-aligned card title. Two independent consumers overrode it to start (DS-1209).",
|
|
8173
|
+
"ticket": "DS-1209"
|
|
8174
|
+
},
|
|
8175
|
+
{
|
|
8176
|
+
"date": "2026-11-13",
|
|
8177
|
+
"decision": "The Tabs root gap is variant-aware: gap-6 (24px) for underline, gap-2 (8px) for pill. No prop — the root reads the variant from context.",
|
|
8178
|
+
"why": "Two independent consumers (KeywordSheet, platform-editors) converged on the same gap-6 override for underline tabs. The 8px default made the content panel look disconnected from the underline row. Zero API surface (DS-1209).",
|
|
8179
|
+
"ticket": "DS-1209"
|
|
8180
|
+
}
|
|
8181
|
+
],
|
|
8182
|
+
"ruledOut": [
|
|
8183
|
+
{
|
|
8184
|
+
"option": "A loading/busy state on Tabs or TabsTrigger (a spinner in the tab, or disabling the tabs while their list refetches)",
|
|
8185
|
+
"why": "Tabs used as a filter change the list's scope, so the wait goes on the list: the consumer dims the rows and the count holds its previous value (Patterns/Filtering). The tab is active the moment it is clicked and is never disabled. Ruled out by the DS owner on 2026-11-09; one consumer (Review Manager), and the list already owns the wait.",
|
|
8186
|
+
"ticket": "DS-1213"
|
|
8187
|
+
},
|
|
8188
|
+
{
|
|
8189
|
+
"option": "A spacing prop on Tabs to control the gap between TabsList and TabsContent",
|
|
8190
|
+
"why": "Looks strange and highly customized. The gap is a consequence of the variant, not a consumer choice — underline tabs always want 24px, pill tabs always want 8px. Making it variant-aware on the root is zero API surface and matches both consumer overrides (DS-1209).",
|
|
8191
|
+
"ticket": "DS-1209"
|
|
8192
|
+
},
|
|
8193
|
+
{
|
|
8194
|
+
"option": "A bleed prop on TabsList to opt into edge-to-edge rendering inside a Card",
|
|
8195
|
+
"why": "The bleed is automatic via var(--content-inset, 0px) — inside a Card the variable is set, outside it falls back to 0px. A prop would force every consumer inside a Card to remember to pass it. The same pattern already exists for DataTable frame='container' (DS-1209).",
|
|
8196
|
+
"ticket": "DS-1209"
|
|
8197
|
+
},
|
|
8198
|
+
{
|
|
8199
|
+
"option": "An align prop on TabsList to override the variant-aware default alignment",
|
|
8200
|
+
"why": "Deprecated — zero consumer usage across the greenfield repo (4 Tabs usages, none pass align). The variant-aware defaults (underline → start, pill → center) cover every real case. The prop remains in code as deprecated; use className if an override is ever needed (DS-1209).",
|
|
8201
|
+
"ticket": "DS-1209"
|
|
8202
|
+
}
|
|
8203
|
+
],
|
|
7301
8204
|
"description": "Tabbed interface for switching between views",
|
|
7302
8205
|
"aliases": [
|
|
7303
8206
|
"tab bar",
|
|
@@ -7337,6 +8240,10 @@
|
|
|
7337
8240
|
{
|
|
7338
8241
|
"figma": "Variant",
|
|
7339
8242
|
"code": "variant"
|
|
8243
|
+
},
|
|
8244
|
+
{
|
|
8245
|
+
"figma": "Full Width",
|
|
8246
|
+
"code": "fullWidth"
|
|
7340
8247
|
}
|
|
7341
8248
|
]
|
|
7342
8249
|
},
|
|
@@ -7396,7 +8303,12 @@
|
|
|
7396
8303
|
"dataHookRequired": true,
|
|
7397
8304
|
"variants": {},
|
|
7398
8305
|
"props": [
|
|
7399
|
-
"error"
|
|
8306
|
+
"error",
|
|
8307
|
+
"limit",
|
|
8308
|
+
"countLabels",
|
|
8309
|
+
"autosize",
|
|
8310
|
+
"minRows",
|
|
8311
|
+
"maxRows"
|
|
7400
8312
|
],
|
|
7401
8313
|
"description": "Multi-line text input",
|
|
7402
8314
|
"figma": {
|
|
@@ -7433,12 +8345,31 @@
|
|
|
7433
8345
|
"text that fits on one line (use Input)",
|
|
7434
8346
|
"lists of separate short items (use InputList or InputChip)",
|
|
7435
8347
|
"content needing strict formatting or structure (use a structured input)"
|
|
8348
|
+
],
|
|
8349
|
+
"i18nProps": {
|
|
8350
|
+
"Textarea": {
|
|
8351
|
+
"countLabels": "{ value, over } functions — defaults: \"{count} of {limit}\", \"{excess} over the limit\" (only with limit)"
|
|
8352
|
+
}
|
|
8353
|
+
},
|
|
8354
|
+
"decisions": [
|
|
8355
|
+
{
|
|
8356
|
+
"date": "2026-11-05",
|
|
8357
|
+
"decision": "Textarea uses rounded-sm, the same radius as Input, instead of rounded-md.",
|
|
8358
|
+
"why": "Textarea and Input sit in the same forms; two radii side by side read as two different field styles (DS-1265).",
|
|
8359
|
+
"ticket": "DS-1265"
|
|
8360
|
+
},
|
|
8361
|
+
{
|
|
8362
|
+
"date": "2026-11-05",
|
|
8363
|
+
"decision": "autosize grows the box with its content from minRows (default 3) to maxRows (default 10), then scrolls. CSS field-sizing: content does the growing where supported (feature-detected with CSS.supports); elsewhere the height is measured on input, on controlled value changes and on width changes. Min and max heights come from the computed line height, padding and border, so the touch font bump and className padding stay correct. The resize handle is off and rows is ignored while autosize is on.",
|
|
8364
|
+
"why": "Products faked a growing box with field-sizing on a data-hook, which does not grow in browsers without field-sizing. A manual resize handle fights the automatic height, and rows would contradict minRows (DS-1265).",
|
|
8365
|
+
"ticket": "DS-1265"
|
|
8366
|
+
}
|
|
7436
8367
|
]
|
|
7437
8368
|
},
|
|
7438
8369
|
{
|
|
7439
8370
|
"name": "TextRevealMotion",
|
|
7440
8371
|
"import": "@brightlocal/ui-components/text-reveal-motion",
|
|
7441
|
-
"category": "
|
|
8372
|
+
"category": "loading",
|
|
7442
8373
|
"exports": [
|
|
7443
8374
|
"TextRevealMotion"
|
|
7444
8375
|
],
|
|
@@ -7473,7 +8404,7 @@
|
|
|
7473
8404
|
{
|
|
7474
8405
|
"name": "Toggle",
|
|
7475
8406
|
"import": "@brightlocal/ui-components/toggle",
|
|
7476
|
-
"category": "
|
|
8407
|
+
"category": "actions",
|
|
7477
8408
|
"exports": [
|
|
7478
8409
|
"Toggle"
|
|
7479
8410
|
],
|
|
@@ -7541,7 +8472,7 @@
|
|
|
7541
8472
|
{
|
|
7542
8473
|
"name": "ToggleGroup",
|
|
7543
8474
|
"import": "@brightlocal/ui-components/toggle-group",
|
|
7544
|
-
"category": "
|
|
8475
|
+
"category": "actions",
|
|
7545
8476
|
"exports": [
|
|
7546
8477
|
"ToggleGroup",
|
|
7547
8478
|
"ToggleGroupItem"
|
|
@@ -7600,7 +8531,7 @@
|
|
|
7600
8531
|
{
|
|
7601
8532
|
"name": "Tooltip",
|
|
7602
8533
|
"import": "@brightlocal/ui-components/tooltip",
|
|
7603
|
-
"category": "
|
|
8534
|
+
"category": "overlay",
|
|
7604
8535
|
"exports": [
|
|
7605
8536
|
"Tooltip",
|
|
7606
8537
|
"TooltipProvider",
|
|
@@ -7674,6 +8605,14 @@
|
|
|
7674
8605
|
],
|
|
7675
8606
|
"figmaOnly": []
|
|
7676
8607
|
},
|
|
8608
|
+
"decisions": [
|
|
8609
|
+
{
|
|
8610
|
+
"date": "2026-11-09",
|
|
8611
|
+
"decision": "TooltipContent suppresses aria-describedby when the tooltip text (string children) exactly matches the trigger's aria-label, so screen readers do not double-announce the same phrase.",
|
|
8612
|
+
"why": "Icon-only buttons with a tooltip that repeats the aria-label caused 'Settings — Settings' announcements. The tooltip stays visible for sighted users; only the ARIA binding is dropped.",
|
|
8613
|
+
"ticket": "DS-1233"
|
|
8614
|
+
}
|
|
8615
|
+
],
|
|
7677
8616
|
"whenToUse": [
|
|
7678
8617
|
"Short hints on hover or keyboard focus (icon-only buttons)",
|
|
7679
8618
|
"Clarifying abbreviations or truncated text without taking up space",
|
|
@@ -7683,7 +8622,7 @@
|
|
|
7683
8622
|
{
|
|
7684
8623
|
"name": "Typography",
|
|
7685
8624
|
"import": "@brightlocal/ui-components/typography",
|
|
7686
|
-
"category": "
|
|
8625
|
+
"category": "typography",
|
|
7687
8626
|
"exports": [
|
|
7688
8627
|
"TypographyH1",
|
|
7689
8628
|
"TypographyH2",
|
|
@@ -7779,7 +8718,7 @@
|
|
|
7779
8718
|
"figmaOnly": [],
|
|
7780
8719
|
"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."
|
|
7781
8720
|
},
|
|
7782
|
-
"category": "
|
|
8721
|
+
"category": "typography",
|
|
7783
8722
|
"exports": [
|
|
7784
8723
|
"TypographyHeading"
|
|
7785
8724
|
],
|
|
@@ -7889,9 +8828,9 @@
|
|
|
7889
8828
|
],
|
|
7890
8829
|
"unmappedExports": [],
|
|
7891
8830
|
"figmaOnly": [],
|
|
7892
|
-
"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)."
|
|
8831
|
+
"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 | Primary) 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). Color=Primary renamed to Color=Success 2026-11-12 (DS-1299): the green text role uses text-success-foreground (green-900 light / green-200 dark), matching Alert; the old Primary value was text-primary-foreground (white on-surface text), which was wrong for standalone green text."
|
|
7893
8832
|
},
|
|
7894
|
-
"category": "
|
|
8833
|
+
"category": "typography",
|
|
7895
8834
|
"exports": [
|
|
7896
8835
|
"TypographyText"
|
|
7897
8836
|
],
|
|
@@ -7908,7 +8847,8 @@
|
|
|
7908
8847
|
"color": [
|
|
7909
8848
|
"default",
|
|
7910
8849
|
"muted",
|
|
7911
|
-
"destructive"
|
|
8850
|
+
"destructive",
|
|
8851
|
+
"success"
|
|
7912
8852
|
],
|
|
7913
8853
|
"align": [
|
|
7914
8854
|
"left",
|
|
@@ -7924,7 +8864,7 @@
|
|
|
7924
8864
|
"align",
|
|
7925
8865
|
"asChild"
|
|
7926
8866
|
],
|
|
7927
|
-
"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",
|
|
8867
|
+
"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, success is for positive/confirmation text (same family as Alert success tokens)",
|
|
7928
8868
|
"aliases": [
|
|
7929
8869
|
"text",
|
|
7930
8870
|
"paragraph",
|
|
@@ -7965,7 +8905,7 @@
|
|
|
7965
8905
|
{
|
|
7966
8906
|
"name": "EmptyState",
|
|
7967
8907
|
"import": "@brightlocal/ui-components/empty-state",
|
|
7968
|
-
"category": "
|
|
8908
|
+
"category": "states",
|
|
7969
8909
|
"exports": [
|
|
7970
8910
|
"EmptyState"
|
|
7971
8911
|
],
|
|
@@ -7973,6 +8913,7 @@
|
|
|
7973
8913
|
"dataHookRequired": true,
|
|
7974
8914
|
"variants": {
|
|
7975
8915
|
"EmptyStateSize": [
|
|
8916
|
+
"sm",
|
|
7976
8917
|
"md",
|
|
7977
8918
|
"lg"
|
|
7978
8919
|
],
|
|
@@ -7984,6 +8925,10 @@
|
|
|
7984
8925
|
"filled",
|
|
7985
8926
|
"border",
|
|
7986
8927
|
"transparent"
|
|
8928
|
+
],
|
|
8929
|
+
"EmptyStateIconShape": [
|
|
8930
|
+
"circle",
|
|
8931
|
+
"square"
|
|
7987
8932
|
]
|
|
7988
8933
|
},
|
|
7989
8934
|
"props": [
|
|
@@ -7994,12 +8939,13 @@
|
|
|
7994
8939
|
"size",
|
|
7995
8940
|
"align",
|
|
7996
8941
|
"iconVariant",
|
|
8942
|
+
"iconShape",
|
|
7997
8943
|
"titleLevel",
|
|
7998
8944
|
"className"
|
|
7999
8945
|
],
|
|
8000
8946
|
"decisions": [
|
|
8001
8947
|
{
|
|
8002
|
-
"decision": "The icon chip is the DS LogoMark at lg (40px
|
|
8948
|
+
"decision": "The icon chip is the DS LogoMark at lg (40px circle by default), shared with CommandEmpty / ComboboxEmpty and the filter no-match forms via lib/empty-chip",
|
|
8003
8949
|
"why": "The hand-rolled 40px bg-muted circle drifted from every other icon mark; one mark keeps the empty chip and the rest of the product on one shape",
|
|
8004
8950
|
"date": "2026-10-30",
|
|
8005
8951
|
"ticket": "DS-1208"
|
|
@@ -8009,9 +8955,15 @@
|
|
|
8009
8955
|
"why": "The filled chip disappears on a bg-muted panel; the surface, not the block, decides the container",
|
|
8010
8956
|
"date": "2026-10-30",
|
|
8011
8957
|
"ticket": "DS-1208"
|
|
8958
|
+
},
|
|
8959
|
+
{
|
|
8960
|
+
"date": "2026-11-12",
|
|
8961
|
+
"decision": "EmptyState has a compact size=\"sm\" for popover, menu and drawer lists, and it is the one implementation of the compact no-match form: CommandEmpty / ComboboxEmpty render EmptyState size=\"sm\" inside cmdk's Empty (keeping only the show-when-no-match behaviour and the option/group role), and the Single/MultiSelectFilter drawers render it directly. Canvas empties (ChartEmpty, MapEmpty, MediaEmpty) stay separate.",
|
|
8962
|
+
"why": "Owner's call (Yurii, 2026-11-12): one empty-state component wherever the empty state looks the same is easier to maintain. The compact form was hand-built three times (CommandEmpty and both filter drawers) around a shared chip, so spacing and actions drifted. No public prop was removed; only the inner data-slots of the compact form changed to EmptyState's.",
|
|
8963
|
+
"ticket": "DS-1301"
|
|
8012
8964
|
}
|
|
8013
8965
|
],
|
|
8014
|
-
"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 LogoMark chip (lg,
|
|
8966
|
+
"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 LogoMark chip (lg, circle by default; iconShape picks circle / square, iconVariant picks filled / border / transparent for the surface — border or transparent on a bg-muted panel, where the filled chip vanishes) 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. size=\"sm\" is the compact form for a popover, menu or drawer list that found nothing: the same chip, the title as one body-sm line (never a heading, so it can sit inside a listbox option), one quiet hint, and the actions 16px under it. CommandEmpty / ComboboxEmpty and the Single/MultiSelectFilter drawers render it; titleLevel, align and illustration do not exist at sm.",
|
|
8015
8967
|
"aliases": [
|
|
8016
8968
|
"empty state",
|
|
8017
8969
|
"empty block",
|
|
@@ -8030,7 +8982,8 @@
|
|
|
8030
8982
|
"A collection with no rows yet, inside the table's own frame — a DataTable takes the block through noResultsMessage",
|
|
8031
8983
|
"A section of a working page with nothing to show — keep the heading and frame, swap the body",
|
|
8032
8984
|
"A gated feature: name it, sell it, and offer an action the reader can act on",
|
|
8033
|
-
"A first-use or blocked page: size=\"lg\" inside Grid variant=\"centered\", with an illustration"
|
|
8985
|
+
"A first-use or blocked page: size=\"lg\" inside Grid variant=\"centered\", with an illustration",
|
|
8986
|
+
"A popover, menu or drawer list that found nothing: size=\"sm\" (CommandEmpty / ComboboxEmpty render it for you inside a Command or Combobox)"
|
|
8034
8987
|
],
|
|
8035
8988
|
"doNotUseFor": [
|
|
8036
8989
|
"a chart, map, or media slot (use ChartEmpty, MapEmpty, or MediaEmpty — a canvas keeps quiet, and those are primitives)",
|
|
@@ -8042,7 +8995,7 @@
|
|
|
8042
8995
|
{
|
|
8043
8996
|
"name": "InputList",
|
|
8044
8997
|
"import": "@brightlocal/ui-components/input-list",
|
|
8045
|
-
"category": "
|
|
8998
|
+
"category": "form",
|
|
8046
8999
|
"exports": [
|
|
8047
9000
|
"InputList",
|
|
8048
9001
|
"InputListItems",
|
|
@@ -8079,7 +9032,7 @@
|
|
|
8079
9032
|
{
|
|
8080
9033
|
"name": "ProgressState",
|
|
8081
9034
|
"import": "@brightlocal/ui-components/progress-state",
|
|
8082
|
-
"category": "
|
|
9035
|
+
"category": "states",
|
|
8083
9036
|
"exports": [
|
|
8084
9037
|
"ProgressState"
|
|
8085
9038
|
],
|
|
@@ -8124,7 +9077,7 @@
|
|
|
8124
9077
|
{
|
|
8125
9078
|
"name": "Sidebar",
|
|
8126
9079
|
"import": "@brightlocal/ui-components/sidebar",
|
|
8127
|
-
"category": "
|
|
9080
|
+
"category": "navigation",
|
|
8128
9081
|
"exports": [
|
|
8129
9082
|
"Sidebar",
|
|
8130
9083
|
"SidebarAccountDropdown",
|
|
@@ -8193,17 +9146,17 @@
|
|
|
8193
9146
|
"toggleAriaLabel": "string — default: \"Toggle sidebar\""
|
|
8194
9147
|
},
|
|
8195
9148
|
"SidebarPopoverTrigger": {
|
|
8196
|
-
"triggerAriaLabel": "string — default
|
|
9149
|
+
"triggerAriaLabel": "string — no default; unset, the button is named by its visible text (WCAG 2.5.3). An override must contain that text"
|
|
8197
9150
|
},
|
|
8198
9151
|
"SidebarPopoverMenu": {
|
|
8199
9152
|
"groupTitle": "string — default: \"Teams\"",
|
|
8200
9153
|
"addActionLabel": "string — default: \"Add team\""
|
|
8201
9154
|
},
|
|
8202
9155
|
"SidebarSwitcher": {
|
|
8203
|
-
"triggerAriaLabel": "string — default
|
|
9156
|
+
"triggerAriaLabel": "string — no default; unset, the button is named by its visible text (WCAG 2.5.3). An override must contain that text"
|
|
8204
9157
|
},
|
|
8205
9158
|
"SidebarAccountDropdown": {
|
|
8206
|
-
"triggerAriaLabel": "string — default
|
|
9159
|
+
"triggerAriaLabel": "string — no default; unset, the button is named by its visible name and email (kept sr-only when collapsed to icons; WCAG 2.5.3). An override must contain that text"
|
|
8207
9160
|
}
|
|
8208
9161
|
},
|
|
8209
9162
|
"description": "Complex sidebar navigation with collapsible support",
|
|
@@ -8524,10 +9477,16 @@
|
|
|
8524
9477
|
],
|
|
8525
9478
|
"decisions": [
|
|
8526
9479
|
{
|
|
8527
|
-
"decision": "SidebarAccountDropdown children replaces only the items area, not the name/email header — composition with DropdownMenuItem for links, disabled,
|
|
9480
|
+
"decision": "SidebarAccountDropdown children replaces only the items area, not the name/email header — composition with DropdownMenuItem for links, disabled, per-item dataHook instead of extending the menuGroups data type",
|
|
8528
9481
|
"ticket": "DS-1212",
|
|
8529
9482
|
"date": "2026-11-02",
|
|
8530
9483
|
"why": "The underlying DropdownMenuItem already supports asChild (links), disabled, dataHook, and onSelect with preventDefault (stay open for loading). Extending menuGroups would couple the data type to every primitive feature and still not cover router links (which need asChild composition). The shadcn NavUser follows this exact composition pattern."
|
|
9484
|
+
},
|
|
9485
|
+
{
|
|
9486
|
+
"decision": "SidebarAccountDropdown and SidebarSwitcher/SidebarPopoverTrigger triggers have no default aria-label: they are named by their visible text (name + email; workspace label). triggerAriaLabel stays as an override. Collapsed to icons (collapsible=\"icon\"), the name/email column becomes sr-only instead of display:none, so the avatar-only button keeps its name.",
|
|
9487
|
+
"ticket": "DS-1269",
|
|
9488
|
+
"date": "2026-11-05",
|
|
9489
|
+
"why": "A fixed \"Account menu\" / \"Switch workspace\" label replaced a name that shows the user's name or the workspace, so the accessible name did not contain the visible text (WCAG 2.5.3 Label in Name, axe label-content-name-mismatch) and speech users could not say what they see. Radix already exposes aria-haspopup/aria-expanded, so the menu role needs no extra wording."
|
|
8531
9490
|
}
|
|
8532
9491
|
]
|
|
8533
9492
|
}
|