@brightlocal/ui-components 3.3.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 +1307 -113
- 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.cjs +1 -1
- package/dist/blocks/input-list.d.ts +1 -0
- package/dist/blocks/input-list.d.ts.map +1 -1
- package/dist/blocks/input-list.js +39 -39
- 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/description-list.cjs +1 -0
- package/dist/description-list.d.ts +142 -0
- package/dist/description-list.d.ts.map +1 -0
- package/dist/description-list.js +173 -0
- 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 +4 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +681 -623
- 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/motion.cjs +1 -1
- package/dist/lib/motion.js +15 -10
- 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 +230 -40
- package/dist/list.d.ts.map +1 -1
- package/dist/list.js +301 -66
- 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/route-progress.cjs +1 -1
- package/dist/route-progress.js +24 -23
- 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 +2 -3
- package/src/blocks/empty-state.tsx +108 -48
- package/src/blocks/input-list.tsx +15 -9
- 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/description-list.tsx +445 -0
- 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 +720 -72
- 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 +4 -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
|
],
|
|
@@ -2562,7 +2850,104 @@
|
|
|
2562
2850
|
"doNotUseFor": [
|
|
2563
2851
|
"form field descriptions (use Field's built-in description)",
|
|
2564
2852
|
"heading or body-copy weight text (use Typography)",
|
|
2565
|
-
"validation errors (use Field's error text)"
|
|
2853
|
+
"validation errors (use Field's error text)",
|
|
2854
|
+
"label-value pairs describing a record (use DescriptionList)"
|
|
2855
|
+
]
|
|
2856
|
+
},
|
|
2857
|
+
{
|
|
2858
|
+
"name": "DescriptionList",
|
|
2859
|
+
"import": "@brightlocal/ui-components/description-list",
|
|
2860
|
+
"category": "data",
|
|
2861
|
+
"exports": [
|
|
2862
|
+
"DescriptionList",
|
|
2863
|
+
"DescriptionListItem",
|
|
2864
|
+
"DescriptionListTerm",
|
|
2865
|
+
"DescriptionListDetails",
|
|
2866
|
+
"DescriptionListIconText"
|
|
2867
|
+
],
|
|
2868
|
+
"compound": true,
|
|
2869
|
+
"dataHookRequired": true,
|
|
2870
|
+
"variants": {
|
|
2871
|
+
"layout": [
|
|
2872
|
+
"inline",
|
|
2873
|
+
"stacked",
|
|
2874
|
+
"responsive",
|
|
2875
|
+
"container",
|
|
2876
|
+
"grid"
|
|
2877
|
+
],
|
|
2878
|
+
"align": [
|
|
2879
|
+
"start",
|
|
2880
|
+
"end"
|
|
2881
|
+
]
|
|
2882
|
+
},
|
|
2883
|
+
"props": [
|
|
2884
|
+
"termWidth",
|
|
2885
|
+
"divided",
|
|
2886
|
+
"color"
|
|
2887
|
+
],
|
|
2888
|
+
"description": "Label-and-value pairs describing one record, rendered as a semantic <dl>",
|
|
2889
|
+
"aliases": [
|
|
2890
|
+
"description list",
|
|
2891
|
+
"definition list",
|
|
2892
|
+
"key value",
|
|
2893
|
+
"key-value pairs",
|
|
2894
|
+
"label value",
|
|
2895
|
+
"details list",
|
|
2896
|
+
"metadata list",
|
|
2897
|
+
"summary list",
|
|
2898
|
+
"dl"
|
|
2899
|
+
],
|
|
2900
|
+
"whenToUse": [
|
|
2901
|
+
"Properties of one record: the details of a review, a location's business details",
|
|
2902
|
+
"The read view of a settings card (the card header owns the Edit action)",
|
|
2903
|
+
"Receipts and totals in a popover or dialog (align=\"end\")",
|
|
2904
|
+
"A plan's limits or a record's facts as stacked items in columns (layout=\"grid\")"
|
|
2905
|
+
],
|
|
2906
|
+
"doNotUseFor": [
|
|
2907
|
+
"several records compared by the same attributes (use Table or DataTable)",
|
|
2908
|
+
"rows the user acts on: navigation, drill-down, toggles (use List with ItemButton/ItemLink)",
|
|
2909
|
+
"headline numbers with a trend (use CardMetric)",
|
|
2910
|
+
"form inputs (use Field)"
|
|
2911
|
+
],
|
|
2912
|
+
"states": [
|
|
2913
|
+
"default"
|
|
2914
|
+
],
|
|
2915
|
+
"a11yContract": [
|
|
2916
|
+
"renders <dl> with each <dt>/<dd> pair grouped in a <div> (allowed inside dl)",
|
|
2917
|
+
"no interactive role; links and buttons inside values keep their own semantics",
|
|
2918
|
+
"DescriptionListIconText hides its icon from assistive tech; the text names the value"
|
|
2919
|
+
],
|
|
2920
|
+
"decisions": [
|
|
2921
|
+
{
|
|
2922
|
+
"date": "2026-11-03",
|
|
2923
|
+
"decision": "DescriptionList is its own component, not a Table variant. One record's properties are a dl; several records compared by the same attributes are a Table.",
|
|
2924
|
+
"why": "A table announces rows and columns that a list of one record's fields does not have, and a variant would have overridden Table's header, borders, density and hover, plus added stacked and grid layouts a table cannot do without losing its semantics.",
|
|
2925
|
+
"ticket": "DS-1124"
|
|
2926
|
+
},
|
|
2927
|
+
{
|
|
2928
|
+
"date": "2026-11-03",
|
|
2929
|
+
"decision": "Promoted from the local DescriptionList that Tool Settings, Location Manager and Review Manager carried (inline/stacked/responsive/container layouts, termWidth 128px default, divided, IconText), adding termWidth=\"auto\", align=\"end\" and layout=\"grid\".",
|
|
2930
|
+
"why": "The three prototype copies were identical and already matched the Figma Description List anatomy; the additions cover the auto-width read views (account settings, greenfield ReviewDetails), popover receipts and the plan facts grid found in the prototypes.",
|
|
2931
|
+
"ticket": "DS-1124"
|
|
2932
|
+
},
|
|
2933
|
+
{
|
|
2934
|
+
"date": "2026-11-03",
|
|
2935
|
+
"decision": "An empty value is DescriptionListDetails color=\"muted\" (\"Not set\"), not a className.",
|
|
2936
|
+
"why": "Colour on a DS component through className is lint-blocked outside ui-components, and empty values appear in most read views.",
|
|
2937
|
+
"ticket": "DS-1124"
|
|
2938
|
+
}
|
|
2939
|
+
],
|
|
2940
|
+
"ruledOut": [
|
|
2941
|
+
{
|
|
2942
|
+
"option": "A key-value variant of Table",
|
|
2943
|
+
"why": "Different semantics (2D grid vs one record's properties) and the variant would replace almost all of Table's styling; see decisions.",
|
|
2944
|
+
"ticket": "DS-1124"
|
|
2945
|
+
},
|
|
2946
|
+
{
|
|
2947
|
+
"option": "Per-row edit actions inside DescriptionList",
|
|
2948
|
+
"why": "Every read view in the prototypes edits from the container header; an action on the row turns it into a List row (DS-1166).",
|
|
2949
|
+
"ticket": "DS-1124"
|
|
2950
|
+
}
|
|
2566
2951
|
]
|
|
2567
2952
|
},
|
|
2568
2953
|
{
|
|
@@ -2577,6 +2962,7 @@
|
|
|
2577
2962
|
"DialogOverlay",
|
|
2578
2963
|
"DialogContent",
|
|
2579
2964
|
"DialogHeader",
|
|
2965
|
+
"DialogBody",
|
|
2580
2966
|
"DialogFooter",
|
|
2581
2967
|
"DialogTitle",
|
|
2582
2968
|
"DialogDescription"
|
|
@@ -2677,12 +3063,16 @@
|
|
|
2677
3063
|
},
|
|
2678
3064
|
{
|
|
2679
3065
|
"export": "DialogContent",
|
|
2680
|
-
"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)"
|
|
2681
3067
|
},
|
|
2682
3068
|
{
|
|
2683
3069
|
"export": "DialogHeader",
|
|
2684
3070
|
"reason": "Drawn inside the set, structural"
|
|
2685
3071
|
},
|
|
3072
|
+
{
|
|
3073
|
+
"export": "DialogBody",
|
|
3074
|
+
"reason": "Drawn inside the set as the content between header and footer; scrolling is runtime in code"
|
|
3075
|
+
},
|
|
2686
3076
|
{
|
|
2687
3077
|
"export": "DialogFooter",
|
|
2688
3078
|
"reason": "Drawn inside the set, structural"
|
|
@@ -2708,7 +3098,22 @@
|
|
|
2708
3098
|
"reason": "Close-icon part; code renders it inside DialogContent"
|
|
2709
3099
|
}
|
|
2710
3100
|
]
|
|
2711
|
-
}
|
|
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
|
+
]
|
|
2712
3117
|
},
|
|
2713
3118
|
{
|
|
2714
3119
|
"name": "Drawer",
|
|
@@ -2722,6 +3127,7 @@
|
|
|
2722
3127
|
"DrawerOverlay",
|
|
2723
3128
|
"DrawerContent",
|
|
2724
3129
|
"DrawerHeader",
|
|
3130
|
+
"DrawerBody",
|
|
2725
3131
|
"DrawerFooter",
|
|
2726
3132
|
"DrawerTitle",
|
|
2727
3133
|
"DrawerDescription"
|
|
@@ -2732,7 +3138,8 @@
|
|
|
2732
3138
|
"props": [
|
|
2733
3139
|
"open",
|
|
2734
3140
|
"onOpenChange",
|
|
2735
|
-
"direction"
|
|
3141
|
+
"direction",
|
|
3142
|
+
"fullHeight"
|
|
2736
3143
|
],
|
|
2737
3144
|
"description": "Slide-out drawer panel",
|
|
2738
3145
|
"whenToUse": [
|
|
@@ -2754,6 +3161,20 @@
|
|
|
2754
3161
|
"rule": "Use Dialog when content should be centered and focused, not sliding from an edge"
|
|
2755
3162
|
}
|
|
2756
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
|
+
],
|
|
2757
3178
|
"figma": {
|
|
2758
3179
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2759
3180
|
"nodes": [
|
|
@@ -2797,6 +3218,10 @@
|
|
|
2797
3218
|
"export": "DrawerHeader",
|
|
2798
3219
|
"reason": "Drawn inside the set ('Show Header' toggle)"
|
|
2799
3220
|
},
|
|
3221
|
+
{
|
|
3222
|
+
"export": "DrawerBody",
|
|
3223
|
+
"reason": "Content area inside the set — scroll behaviour is runtime"
|
|
3224
|
+
},
|
|
2800
3225
|
{
|
|
2801
3226
|
"export": "DrawerFooter",
|
|
2802
3227
|
"reason": "Drawn inside the set ('Show Footer' toggle)"
|
|
@@ -2827,7 +3252,7 @@
|
|
|
2827
3252
|
{
|
|
2828
3253
|
"name": "DropdownMenu",
|
|
2829
3254
|
"import": "@brightlocal/ui-components/dropdown-menu",
|
|
2830
|
-
"category": "
|
|
3255
|
+
"category": "actions",
|
|
2831
3256
|
"exports": [
|
|
2832
3257
|
"DropdownMenu",
|
|
2833
3258
|
"DropdownMenuTrigger",
|
|
@@ -2982,6 +3407,21 @@
|
|
|
2982
3407
|
"Action menus opened from a button, icon, or avatar (row actions, account menu)",
|
|
2983
3408
|
"Grouping related actions under a single labeled trigger",
|
|
2984
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
|
+
}
|
|
2985
3425
|
]
|
|
2986
3426
|
},
|
|
2987
3427
|
{
|
|
@@ -3062,10 +3502,396 @@
|
|
|
3062
3502
|
}
|
|
3063
3503
|
]
|
|
3064
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
|
+
},
|
|
3065
3891
|
{
|
|
3066
3892
|
"name": "GlobalLayout",
|
|
3067
3893
|
"import": "@brightlocal/ui-components/global-layout",
|
|
3068
|
-
"category": "layout",
|
|
3894
|
+
"category": "page-layout",
|
|
3069
3895
|
"exports": [
|
|
3070
3896
|
"GlobalLayout",
|
|
3071
3897
|
"GlobalLayoutSidebar",
|
|
@@ -3092,6 +3918,14 @@
|
|
|
3092
3918
|
"maxWidth",
|
|
3093
3919
|
"width"
|
|
3094
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
|
+
],
|
|
3095
3929
|
"i18nProps": {
|
|
3096
3930
|
"GlobalLayoutMobileHeader": {
|
|
3097
3931
|
"ariaLabel": "string — default: \"Mobile navigation\""
|
|
@@ -3189,7 +4023,7 @@
|
|
|
3189
4023
|
{
|
|
3190
4024
|
"name": "Grid",
|
|
3191
4025
|
"import": "@brightlocal/ui-components/grid",
|
|
3192
|
-
"category": "layout",
|
|
4026
|
+
"category": "page-layout",
|
|
3193
4027
|
"exports": [
|
|
3194
4028
|
"Grid"
|
|
3195
4029
|
],
|
|
@@ -3237,7 +4071,7 @@
|
|
|
3237
4071
|
{
|
|
3238
4072
|
"name": "Header",
|
|
3239
4073
|
"import": "@brightlocal/ui-components/header",
|
|
3240
|
-
"category": "layout",
|
|
4074
|
+
"category": "page-layout",
|
|
3241
4075
|
"exports": [
|
|
3242
4076
|
"Header"
|
|
3243
4077
|
],
|
|
@@ -3293,7 +4127,7 @@
|
|
|
3293
4127
|
{
|
|
3294
4128
|
"name": "HeightTransition",
|
|
3295
4129
|
"import": "@brightlocal/ui-components/height-transition",
|
|
3296
|
-
"category": "
|
|
4130
|
+
"category": "containers",
|
|
3297
4131
|
"exports": [
|
|
3298
4132
|
"HeightTransition"
|
|
3299
4133
|
],
|
|
@@ -3325,7 +4159,7 @@
|
|
|
3325
4159
|
"closeDelay",
|
|
3326
4160
|
"disabled"
|
|
3327
4161
|
],
|
|
3328
|
-
"description": "
|
|
4162
|
+
"description": "Card that appears on hover; tap toggles on touch",
|
|
3329
4163
|
"figma": {
|
|
3330
4164
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3331
4165
|
"nodes": [
|
|
@@ -3376,18 +4210,25 @@
|
|
|
3376
4210
|
"whenToUse": [
|
|
3377
4211
|
"Rich previews on hover (profile summary on a user's name)",
|
|
3378
4212
|
"Extra context without requiring a click",
|
|
3379
|
-
"
|
|
4213
|
+
"Mixed input experiences — hover opens with a mouse, tap toggles on touch"
|
|
3380
4214
|
],
|
|
3381
4215
|
"doNotUseFor": [
|
|
3382
4216
|
"previews with clickable content (use Popover)",
|
|
3383
|
-
"touch-heavy products (hover doesn't work there)",
|
|
3384
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
|
+
}
|
|
3385
4226
|
]
|
|
3386
4227
|
},
|
|
3387
4228
|
{
|
|
3388
4229
|
"name": "InfoTooltip",
|
|
3389
4230
|
"import": "@brightlocal/ui-components/info-tooltip",
|
|
3390
|
-
"category": "
|
|
4231
|
+
"category": "overlay",
|
|
3391
4232
|
"exports": [
|
|
3392
4233
|
"InfoTooltip"
|
|
3393
4234
|
],
|
|
@@ -3534,7 +4375,8 @@
|
|
|
3534
4375
|
"exports": [
|
|
3535
4376
|
"InputChip",
|
|
3536
4377
|
"InputChipInput",
|
|
3537
|
-
"InputChipItems"
|
|
4378
|
+
"InputChipItems",
|
|
4379
|
+
"InputChipCount"
|
|
3538
4380
|
],
|
|
3539
4381
|
"compound": true,
|
|
3540
4382
|
"dataHookRequired": true,
|
|
@@ -3583,6 +4425,10 @@
|
|
|
3583
4425
|
{
|
|
3584
4426
|
"export": "InputChipItems",
|
|
3585
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)"
|
|
3586
4432
|
}
|
|
3587
4433
|
],
|
|
3588
4434
|
"figmaOnly": []
|
|
@@ -3621,7 +4467,8 @@
|
|
|
3621
4467
|
"InputGroupInput",
|
|
3622
4468
|
"InputGroupAddon",
|
|
3623
4469
|
"InputGroupButton",
|
|
3624
|
-
"InputGroupClear"
|
|
4470
|
+
"InputGroupClear",
|
|
4471
|
+
"InputGroupCount"
|
|
3625
4472
|
],
|
|
3626
4473
|
"compound": true,
|
|
3627
4474
|
"dataHookRequired": true,
|
|
@@ -3656,7 +4503,15 @@
|
|
|
3656
4503
|
"InputGroupClear": {
|
|
3657
4504
|
"clearSearchAriaLabel": "string — default: \"Clear search\""
|
|
3658
4505
|
}
|
|
3659
|
-
}
|
|
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
|
+
]
|
|
3660
4515
|
},
|
|
3661
4516
|
{
|
|
3662
4517
|
"name": "InputOTP",
|
|
@@ -3859,7 +4714,7 @@
|
|
|
3859
4714
|
{
|
|
3860
4715
|
"name": "Link",
|
|
3861
4716
|
"import": "@brightlocal/ui-components/link",
|
|
3862
|
-
"category": "
|
|
4717
|
+
"category": "navigation",
|
|
3863
4718
|
"exports": [
|
|
3864
4719
|
"Link"
|
|
3865
4720
|
],
|
|
@@ -3928,9 +4783,21 @@
|
|
|
3928
4783
|
{
|
|
3929
4784
|
"name": "List",
|
|
3930
4785
|
"import": "@brightlocal/ui-components/list",
|
|
3931
|
-
"category": "
|
|
4786
|
+
"category": "data",
|
|
3932
4787
|
"exports": [
|
|
3933
4788
|
"List",
|
|
4789
|
+
"ListItem",
|
|
4790
|
+
"ListItemButton",
|
|
4791
|
+
"ListItemLink",
|
|
4792
|
+
"ListItemMedia",
|
|
4793
|
+
"ListItemContent",
|
|
4794
|
+
"ListItemTitle",
|
|
4795
|
+
"ListItemDescription",
|
|
4796
|
+
"ListItemValue",
|
|
4797
|
+
"ListItemChevron",
|
|
4798
|
+
"ListItemActions",
|
|
4799
|
+
"ListSubheader",
|
|
4800
|
+
"ListSeparator",
|
|
3934
4801
|
"Item",
|
|
3935
4802
|
"ItemMedia",
|
|
3936
4803
|
"ItemContent",
|
|
@@ -3951,10 +4818,17 @@
|
|
|
3951
4818
|
"align": [
|
|
3952
4819
|
"center",
|
|
3953
4820
|
"start"
|
|
4821
|
+
],
|
|
4822
|
+
"mediaVariant": [
|
|
4823
|
+
"default",
|
|
4824
|
+
"icon",
|
|
4825
|
+
"image"
|
|
3954
4826
|
]
|
|
3955
4827
|
},
|
|
3956
|
-
"props": [
|
|
3957
|
-
|
|
4828
|
+
"props": [
|
|
4829
|
+
"truncate"
|
|
4830
|
+
],
|
|
4831
|
+
"description": "Vertical list of rows: static, pressable (button or link), drill-down with a value and chevron, toggle and media rows, with section headings and separators",
|
|
3958
4832
|
"figma": {
|
|
3959
4833
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3960
4834
|
"nodes": [
|
|
@@ -3969,33 +4843,81 @@
|
|
|
3969
4843
|
"nodeId": "28298:5025",
|
|
3970
4844
|
"figmaName": "Item Subheader",
|
|
3971
4845
|
"kind": "component",
|
|
3972
|
-
"export": "
|
|
4846
|
+
"export": "ListSubheader"
|
|
3973
4847
|
}
|
|
3974
4848
|
],
|
|
3975
4849
|
"unmappedExports": [
|
|
3976
4850
|
{
|
|
3977
|
-
"export": "
|
|
4851
|
+
"export": "ListItem",
|
|
3978
4852
|
"reason": "Drawn inside the List composition"
|
|
3979
4853
|
},
|
|
3980
4854
|
{
|
|
3981
|
-
"export": "
|
|
4855
|
+
"export": "ListItemMedia",
|
|
3982
4856
|
"reason": "Drawn inside the List composition"
|
|
3983
4857
|
},
|
|
3984
4858
|
{
|
|
3985
|
-
"export": "
|
|
4859
|
+
"export": "ListItemContent",
|
|
3986
4860
|
"reason": "Drawn inside the List composition"
|
|
3987
4861
|
},
|
|
3988
4862
|
{
|
|
3989
|
-
"export": "
|
|
4863
|
+
"export": "ListItemTitle",
|
|
3990
4864
|
"reason": "Drawn inside the List composition"
|
|
3991
4865
|
},
|
|
3992
4866
|
{
|
|
3993
|
-
"export": "
|
|
4867
|
+
"export": "ListItemDescription",
|
|
3994
4868
|
"reason": "Drawn inside the List composition"
|
|
3995
4869
|
},
|
|
3996
4870
|
{
|
|
3997
|
-
"export": "
|
|
4871
|
+
"export": "ListItemActions",
|
|
4872
|
+
"reason": "Drawn inside the List composition"
|
|
4873
|
+
},
|
|
4874
|
+
{
|
|
4875
|
+
"export": "ListItemButton",
|
|
4876
|
+
"reason": "Drawn inside the List composition"
|
|
4877
|
+
},
|
|
4878
|
+
{
|
|
4879
|
+
"export": "ListItemLink",
|
|
4880
|
+
"reason": "Drawn inside the List composition"
|
|
4881
|
+
},
|
|
4882
|
+
{
|
|
4883
|
+
"export": "ListItemValue",
|
|
4884
|
+
"reason": "Drawn inside the List composition"
|
|
4885
|
+
},
|
|
4886
|
+
{
|
|
4887
|
+
"export": "ListItemChevron",
|
|
3998
4888
|
"reason": "Drawn inside the List composition"
|
|
4889
|
+
},
|
|
4890
|
+
{
|
|
4891
|
+
"export": "ListSeparator",
|
|
4892
|
+
"reason": "Drawn inside the List composition"
|
|
4893
|
+
},
|
|
4894
|
+
{
|
|
4895
|
+
"export": "Item",
|
|
4896
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4897
|
+
},
|
|
4898
|
+
{
|
|
4899
|
+
"export": "ItemMedia",
|
|
4900
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4901
|
+
},
|
|
4902
|
+
{
|
|
4903
|
+
"export": "ItemContent",
|
|
4904
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4905
|
+
},
|
|
4906
|
+
{
|
|
4907
|
+
"export": "ItemTitle",
|
|
4908
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4909
|
+
},
|
|
4910
|
+
{
|
|
4911
|
+
"export": "ItemDescription",
|
|
4912
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4913
|
+
},
|
|
4914
|
+
{
|
|
4915
|
+
"export": "ItemActions",
|
|
4916
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
4917
|
+
},
|
|
4918
|
+
{
|
|
4919
|
+
"export": "ItemSubheader",
|
|
4920
|
+
"reason": "Deprecated alias of the ListItem/ListSubheader name; removed in 4.0"
|
|
3999
4921
|
}
|
|
4000
4922
|
],
|
|
4001
4923
|
"figmaOnly": []
|
|
@@ -4003,17 +4925,90 @@
|
|
|
4003
4925
|
"whenToUse": [
|
|
4004
4926
|
"Rows with media, title, description, and trailing actions (filled)",
|
|
4005
4927
|
"Settings or form-related rows needing a visible border (outline)",
|
|
4006
|
-
"Lightweight lists inside popovers or dropdowns (default)"
|
|
4928
|
+
"Lightweight lists inside popovers or dropdowns (default)",
|
|
4929
|
+
"A row that navigates or opens something: ListItemLink or ListItemButton inside the ListItem, with ListItemChevron",
|
|
4930
|
+
"A drill-down list (label, current value, chevron) such as a phone filters drawer: <List divided> + ListItemButton + ListItemValue + ListItemChevron",
|
|
4931
|
+
"A row whose trailing part is a Switch, Badge, Status, text Button or two actions: put them in ListItemActions",
|
|
4932
|
+
"Logo or icon tiles in front of a row: ListItemMedia variant=\"icon\""
|
|
4007
4933
|
],
|
|
4008
4934
|
"doNotUseFor": [
|
|
4009
4935
|
"tabular data with sortable columns (use Table or DataTable)",
|
|
4010
|
-
"main page content with the default variant (use filled)"
|
|
4936
|
+
"main page content with the default variant (use filled)",
|
|
4937
|
+
"read-only label and value pairs describing one record (use DescriptionList, DS-1124)",
|
|
4938
|
+
"choosing one or several options in a form (use Field, RadioGroup variant=\"box\" or Checkbox)"
|
|
4939
|
+
],
|
|
4940
|
+
"decisions": [
|
|
4941
|
+
{
|
|
4942
|
+
"date": "2026-11-03",
|
|
4943
|
+
"decision": "List follows shadcn's Item anatomy (media with variant default|icon|image, content, title, description, actions, separator) under List-prefixed names: ListItem, ListItemMedia, ListItemContent, ListItemTitle, ListItemDescription, ListItemValue, ListItemChevron, ListItemActions, ListItemButton, ListItemLink for row parts, and ListSubheader, ListSeparator for parts that sit in the list beside rows. The shipped Item, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions and ItemSubheader stay as deprecated aliases, removed in 4.0. This settles DS-850.",
|
|
4944
|
+
"why": "Structure agreed in refinement on 28 October; the names follow the family-prefix rule (components.md: ListItem, not Item) so every part says which component it belongs to.",
|
|
4945
|
+
"ticket": "DS-1166"
|
|
4946
|
+
},
|
|
4947
|
+
{
|
|
4948
|
+
"date": "2026-11-03",
|
|
4949
|
+
"decision": "A pressable row is an ListItemButton or ListItemLink inside the ListItem. The ListItem stays the <li> and hands its padding to the pressable part, which carries hover and focus-visible.",
|
|
4950
|
+
"why": "Our List renders ul > li. Replacing the li with a link or button would break the list semantics, and the prototypes already hand-built drill-down rows as li > button.",
|
|
4951
|
+
"ticket": "DS-1166"
|
|
4952
|
+
},
|
|
4953
|
+
{
|
|
4954
|
+
"date": "2026-11-03",
|
|
4955
|
+
"decision": "ListItemActions takes any trailing content (min 36px square, gap-2) instead of a fixed 36px circle.",
|
|
4956
|
+
"why": "Switches, Badges, Status, text Buttons and pairs of actions overflowed the circle in six prototype screens.",
|
|
4957
|
+
"ticket": "DS-1166"
|
|
4958
|
+
},
|
|
4959
|
+
{
|
|
4960
|
+
"date": "2026-11-03",
|
|
4961
|
+
"decision": "The drill-down value is its own part, ListItemValue: muted body-sm, right-aligned, truncated past half the row.",
|
|
4962
|
+
"why": "shadcn has no value slot; the Rank Tracker filters drawer needs the current value before the chevron.",
|
|
4963
|
+
"ticket": "DS-1166"
|
|
4964
|
+
},
|
|
4965
|
+
{
|
|
4966
|
+
"date": "2026-11-03",
|
|
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.",
|
|
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.",
|
|
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"
|
|
4976
|
+
}
|
|
4977
|
+
],
|
|
4978
|
+
"ruledOut": [
|
|
4979
|
+
{
|
|
4980
|
+
"option": "ListItem asChild rendering an <a> or <button> as the row (shadcn's Item asChild pattern)",
|
|
4981
|
+
"why": "Swaps out the <li>, so a ul would hold links instead of list items. shadcn's list is div-based; ours is ul > li.",
|
|
4982
|
+
"ticket": "DS-1166"
|
|
4983
|
+
},
|
|
4984
|
+
{
|
|
4985
|
+
"option": "Renaming the ListItem variants (default|filled|outline) to shadcn's names in this change",
|
|
4986
|
+
"why": "Breaking change; kept out of DS-1166 so the new row types ship as a minor. Rename is a separate decision for 4.0.",
|
|
4987
|
+
"ticket": "DS-1166"
|
|
4988
|
+
},
|
|
4989
|
+
{
|
|
4990
|
+
"option": "shadcn's bare Item naming with an ItemGroup alias for List",
|
|
4991
|
+
"why": "The names didn't say which component they belong to; the DS family-prefix rule asks for ListItem, not Item.",
|
|
4992
|
+
"ticket": "DS-1166"
|
|
4993
|
+
}
|
|
4994
|
+
],
|
|
4995
|
+
"knownGaps": [
|
|
4996
|
+
{
|
|
4997
|
+
"description": "Item, ItemMedia, ItemContent, ItemTitle, ItemDescription, ItemActions and ItemSubheader are deprecated since the DS-1166 release and will be removed in 4.0",
|
|
4998
|
+
"ticket": "DS-1166",
|
|
4999
|
+
"workaround": "Use ListItem, ListItemMedia, ListItemContent, ListItemTitle, ListItemDescription, ListItemActions and ListSubheader (same components)"
|
|
5000
|
+
},
|
|
5001
|
+
{
|
|
5002
|
+
"description": "truncate on a non-pressable ListItem shows its tooltip on hover and tap only; a keyboard user cannot open it because the text is not focusable. TypographyText / TypographyHeading truncate (DS-988) clamp to one line and have no tooltip at all.",
|
|
5003
|
+
"ticket": "DS-1166",
|
|
5004
|
+
"workaround": "Put the full text where the row leads (sheet or page), or make the row a ListItemButton / ListItemLink so its focus opens the tooltip."
|
|
5005
|
+
}
|
|
4011
5006
|
]
|
|
4012
5007
|
},
|
|
4013
5008
|
{
|
|
4014
5009
|
"name": "Loading",
|
|
4015
5010
|
"import": "@brightlocal/ui-components/loading",
|
|
4016
|
-
"category": "
|
|
5011
|
+
"category": "loading",
|
|
4017
5012
|
"exports": [
|
|
4018
5013
|
"Loading"
|
|
4019
5014
|
],
|
|
@@ -4036,7 +5031,7 @@
|
|
|
4036
5031
|
{
|
|
4037
5032
|
"name": "Logo",
|
|
4038
5033
|
"import": "@brightlocal/ui-components/logo",
|
|
4039
|
-
"category": "
|
|
5034
|
+
"category": "media",
|
|
4040
5035
|
"exports": [
|
|
4041
5036
|
"Logo"
|
|
4042
5037
|
],
|
|
@@ -4087,7 +5082,7 @@
|
|
|
4087
5082
|
{
|
|
4088
5083
|
"name": "LogoMark",
|
|
4089
5084
|
"import": "@brightlocal/ui-components/logo-mark",
|
|
4090
|
-
"category": "
|
|
5085
|
+
"category": "media",
|
|
4091
5086
|
"exports": [
|
|
4092
5087
|
"LogoMark",
|
|
4093
5088
|
"SOURCE_ICON_ALIASES"
|
|
@@ -4098,7 +5093,9 @@
|
|
|
4098
5093
|
"variant": [
|
|
4099
5094
|
"transparent",
|
|
4100
5095
|
"filled",
|
|
4101
|
-
"border"
|
|
5096
|
+
"border",
|
|
5097
|
+
"success",
|
|
5098
|
+
"destructive"
|
|
4102
5099
|
],
|
|
4103
5100
|
"size": [
|
|
4104
5101
|
"xs",
|
|
@@ -4109,6 +5106,10 @@
|
|
|
4109
5106
|
"colorScheme": [
|
|
4110
5107
|
"original",
|
|
4111
5108
|
"neutral"
|
|
5109
|
+
],
|
|
5110
|
+
"shape": [
|
|
5111
|
+
"square",
|
|
5112
|
+
"circle"
|
|
4112
5113
|
]
|
|
4113
5114
|
},
|
|
4114
5115
|
"props": [
|
|
@@ -4116,10 +5117,11 @@
|
|
|
4116
5117
|
"size",
|
|
4117
5118
|
"variant",
|
|
4118
5119
|
"colorScheme",
|
|
5120
|
+
"shape",
|
|
4119
5121
|
"fallback",
|
|
4120
5122
|
"ariaLabel"
|
|
4121
5123
|
],
|
|
4122
|
-
"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.",
|
|
4123
5125
|
"knownGaps": [
|
|
4124
5126
|
{
|
|
4125
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.",
|
|
@@ -4173,6 +5175,24 @@
|
|
|
4173
5175
|
"why": "Importing the social-media barrel pulled every registered icon into one chunk on first render",
|
|
4174
5176
|
"date": "2026-10-28",
|
|
4175
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"
|
|
4176
5196
|
}
|
|
4177
5197
|
],
|
|
4178
5198
|
"ruledOut": [
|
|
@@ -4180,14 +5200,19 @@
|
|
|
4180
5200
|
"option": "Hand-drawn or AI-generated approximations of brand marks",
|
|
4181
5201
|
"why": "Not the brand's logo; see decision of 2026-10-28",
|
|
4182
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"
|
|
4183
5208
|
}
|
|
4184
5209
|
],
|
|
4185
5210
|
"figma": {
|
|
4186
5211
|
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4187
|
-
"note": "
|
|
5212
|
+
"note": "Rebuilt on DS-1291 Figma branch riJNFsT4v01WsgzKGh7kdY; node IDs valid after branch merge.",
|
|
4188
5213
|
"nodes": [
|
|
4189
5214
|
{
|
|
4190
|
-
"nodeId": "
|
|
5215
|
+
"nodeId": "36309:108982",
|
|
4191
5216
|
"figmaName": "Logo Mark",
|
|
4192
5217
|
"kind": "componentSet",
|
|
4193
5218
|
"export": "LogoMark",
|
|
@@ -4205,9 +5230,8 @@
|
|
|
4205
5230
|
"code": "colorScheme"
|
|
4206
5231
|
},
|
|
4207
5232
|
{
|
|
4208
|
-
"figma": "
|
|
4209
|
-
"
|
|
4210
|
-
"note": "Known/Fallback is a runtime resolution outcome (not a consumer prop); demonstrates the two visual states"
|
|
5233
|
+
"figma": "Shape",
|
|
5234
|
+
"code": "shape"
|
|
4211
5235
|
}
|
|
4212
5236
|
]
|
|
4213
5237
|
}
|
|
@@ -4223,7 +5247,7 @@
|
|
|
4223
5247
|
{
|
|
4224
5248
|
"name": "Map",
|
|
4225
5249
|
"import": "@brightlocal/ui-components/map",
|
|
4226
|
-
"category": "
|
|
5250
|
+
"category": "data",
|
|
4227
5251
|
"exports": [
|
|
4228
5252
|
"MAP_STYLES",
|
|
4229
5253
|
"MapTypeId",
|
|
@@ -4348,7 +5372,7 @@
|
|
|
4348
5372
|
{
|
|
4349
5373
|
"name": "MediaEmpty",
|
|
4350
5374
|
"import": "@brightlocal/ui-components/media-empty",
|
|
4351
|
-
"category": "
|
|
5375
|
+
"category": "media",
|
|
4352
5376
|
"exports": [
|
|
4353
5377
|
"MediaEmpty"
|
|
4354
5378
|
],
|
|
@@ -4358,15 +5382,28 @@
|
|
|
4358
5382
|
"MediaEmptyVariant": [
|
|
4359
5383
|
"image",
|
|
4360
5384
|
"video"
|
|
5385
|
+
],
|
|
5386
|
+
"MediaEmptySize": [
|
|
5387
|
+
"md",
|
|
5388
|
+
"sm"
|
|
4361
5389
|
]
|
|
4362
5390
|
},
|
|
4363
5391
|
"props": [
|
|
4364
5392
|
"variant",
|
|
5393
|
+
"size",
|
|
4365
5394
|
"icon",
|
|
4366
5395
|
"message",
|
|
4367
5396
|
"className"
|
|
4368
5397
|
],
|
|
4369
|
-
"
|
|
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.",
|
|
4370
5407
|
"aliases": [
|
|
4371
5408
|
"image empty",
|
|
4372
5409
|
"image placeholder",
|
|
@@ -4380,7 +5417,8 @@
|
|
|
4380
5417
|
"video placeholder"
|
|
4381
5418
|
],
|
|
4382
5419
|
"whenToUse": [
|
|
4383
|
-
"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\""
|
|
4384
5422
|
],
|
|
4385
5423
|
"doNotUseFor": [
|
|
4386
5424
|
"an image that failed to load (that is an error, and it should say so)",
|
|
@@ -4396,7 +5434,7 @@
|
|
|
4396
5434
|
{
|
|
4397
5435
|
"name": "MediaViewer",
|
|
4398
5436
|
"import": "@brightlocal/ui-components/media-viewer",
|
|
4399
|
-
"category": "
|
|
5437
|
+
"category": "media",
|
|
4400
5438
|
"exports": [
|
|
4401
5439
|
"MediaViewer",
|
|
4402
5440
|
"MediaViewerTrigger",
|
|
@@ -4552,7 +5590,7 @@
|
|
|
4552
5590
|
{
|
|
4553
5591
|
"name": "Menubar",
|
|
4554
5592
|
"import": "@brightlocal/ui-components/menubar",
|
|
4555
|
-
"category": "
|
|
5593
|
+
"category": "actions",
|
|
4556
5594
|
"exports": [
|
|
4557
5595
|
"Menubar",
|
|
4558
5596
|
"MenubarMenu",
|
|
@@ -5185,7 +6223,7 @@
|
|
|
5185
6223
|
{
|
|
5186
6224
|
"name": "Progress",
|
|
5187
6225
|
"import": "@brightlocal/ui-components/progress",
|
|
5188
|
-
"category": "
|
|
6226
|
+
"category": "data",
|
|
5189
6227
|
"exports": [
|
|
5190
6228
|
"Progress"
|
|
5191
6229
|
],
|
|
@@ -5382,7 +6420,7 @@
|
|
|
5382
6420
|
{
|
|
5383
6421
|
"name": "Rating",
|
|
5384
6422
|
"import": "@brightlocal/ui-components/rating",
|
|
5385
|
-
"category": "
|
|
6423
|
+
"category": "content",
|
|
5386
6424
|
"exports": [
|
|
5387
6425
|
"Rating"
|
|
5388
6426
|
],
|
|
@@ -5457,7 +6495,7 @@
|
|
|
5457
6495
|
{
|
|
5458
6496
|
"name": "RelativeDate",
|
|
5459
6497
|
"import": "@brightlocal/ui-components/relative-date",
|
|
5460
|
-
"category": "
|
|
6498
|
+
"category": "content",
|
|
5461
6499
|
"exports": [
|
|
5462
6500
|
"RelativeDate",
|
|
5463
6501
|
"useNow",
|
|
@@ -5556,7 +6594,7 @@
|
|
|
5556
6594
|
{
|
|
5557
6595
|
"name": "Resizable",
|
|
5558
6596
|
"import": "@brightlocal/ui-components/resizable",
|
|
5559
|
-
"category": "
|
|
6597
|
+
"category": "containers",
|
|
5560
6598
|
"exports": [
|
|
5561
6599
|
"ResizablePanelGroup",
|
|
5562
6600
|
"ResizablePanel",
|
|
@@ -5591,7 +6629,7 @@
|
|
|
5591
6629
|
{
|
|
5592
6630
|
"name": "ResultCount",
|
|
5593
6631
|
"import": "@brightlocal/ui-components/result-count",
|
|
5594
|
-
"category": "
|
|
6632
|
+
"category": "content",
|
|
5595
6633
|
"exports": [
|
|
5596
6634
|
"ResultCount"
|
|
5597
6635
|
],
|
|
@@ -5603,9 +6641,10 @@
|
|
|
5603
6641
|
"total",
|
|
5604
6642
|
"from",
|
|
5605
6643
|
"to",
|
|
5606
|
-
"updating"
|
|
6644
|
+
"updating (deprecated, no-op)",
|
|
6645
|
+
"updatingLabel (deprecated, no-op)"
|
|
5607
6646
|
],
|
|
5608
|
-
"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.",
|
|
5609
6648
|
"i18nProps": {
|
|
5610
6649
|
"ResultCount": {
|
|
5611
6650
|
"label": "string — default: \"{count} of {total} results\"",
|
|
@@ -5614,7 +6653,6 @@
|
|
|
5614
6653
|
"noTotalLabelOne": "string — default: \"{count} result\"; used at count === 1, falls back to noTotalLabel",
|
|
5615
6654
|
"rangeLabel": "string — default: \"{from} to {to} of {total} results\"",
|
|
5616
6655
|
"rangeLabelOne": "string — default: \"{from} to {to} of {total} result\"; used at total === 1, falls back to rangeLabel",
|
|
5617
|
-
"updatingLabel": "string — default: \"Updating results\"",
|
|
5618
6656
|
"emptyLabel": "string — default: \"No results\""
|
|
5619
6657
|
}
|
|
5620
6658
|
},
|
|
@@ -5650,6 +6688,12 @@
|
|
|
5650
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.",
|
|
5651
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.",
|
|
5652
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"
|
|
5653
6697
|
}
|
|
5654
6698
|
],
|
|
5655
6699
|
"ruledOut": [
|
|
@@ -5663,7 +6707,7 @@
|
|
|
5663
6707
|
{
|
|
5664
6708
|
"name": "RouteProgress",
|
|
5665
6709
|
"import": "@brightlocal/ui-components/route-progress",
|
|
5666
|
-
"category": "
|
|
6710
|
+
"category": "loading",
|
|
5667
6711
|
"exports": [
|
|
5668
6712
|
"RouteProgress"
|
|
5669
6713
|
],
|
|
@@ -5755,7 +6799,7 @@
|
|
|
5755
6799
|
{
|
|
5756
6800
|
"name": "ScrollArea",
|
|
5757
6801
|
"import": "@brightlocal/ui-components/scroll-area",
|
|
5758
|
-
"category": "
|
|
6802
|
+
"category": "containers",
|
|
5759
6803
|
"exports": [
|
|
5760
6804
|
"ScrollArea",
|
|
5761
6805
|
"ScrollAreaScrollbar",
|
|
@@ -5959,7 +7003,7 @@
|
|
|
5959
7003
|
{
|
|
5960
7004
|
"name": "Separator",
|
|
5961
7005
|
"import": "@brightlocal/ui-components/separator",
|
|
5962
|
-
"category": "
|
|
7006
|
+
"category": "page-layout",
|
|
5963
7007
|
"exports": [
|
|
5964
7008
|
"Separator",
|
|
5965
7009
|
"SeparatorWithText"
|
|
@@ -6055,7 +7099,8 @@
|
|
|
6055
7099
|
"size": [
|
|
6056
7100
|
"default",
|
|
6057
7101
|
"sm",
|
|
6058
|
-
"lg"
|
|
7102
|
+
"lg",
|
|
7103
|
+
"xl"
|
|
6059
7104
|
]
|
|
6060
7105
|
},
|
|
6061
7106
|
"props": [
|
|
@@ -6070,7 +7115,8 @@
|
|
|
6070
7115
|
"ariaLabel": "string — default: \"Item navigation\"",
|
|
6071
7116
|
"prevAriaLabel": "string — default: \"Previous item\"",
|
|
6072
7117
|
"nextAriaLabel": "string — default: \"Next item\"",
|
|
6073
|
-
"renderPosition": "(info) => ReactNode — default: \"{current} of {total}\""
|
|
7118
|
+
"renderPosition": "(info) => ReactNode — default: \"{current} of {total}\"",
|
|
7119
|
+
"loadingLabel": "string — default: \"Loading item\""
|
|
6074
7120
|
}
|
|
6075
7121
|
},
|
|
6076
7122
|
"description": "Side panel overlay",
|
|
@@ -6107,7 +7153,29 @@
|
|
|
6107
7153
|
"replaces": [],
|
|
6108
7154
|
"states": [
|
|
6109
7155
|
"open",
|
|
6110
|
-
"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
|
+
}
|
|
6111
7179
|
],
|
|
6112
7180
|
"a11yContract": {
|
|
6113
7181
|
"role": "dialog",
|
|
@@ -6324,7 +7392,7 @@
|
|
|
6324
7392
|
{
|
|
6325
7393
|
"name": "Skeleton",
|
|
6326
7394
|
"import": "@brightlocal/ui-components/skeleton",
|
|
6327
|
-
"category": "
|
|
7395
|
+
"category": "loading",
|
|
6328
7396
|
"exports": [
|
|
6329
7397
|
"Skeleton"
|
|
6330
7398
|
],
|
|
@@ -6512,7 +7580,7 @@
|
|
|
6512
7580
|
{
|
|
6513
7581
|
"name": "Spinner",
|
|
6514
7582
|
"import": "@brightlocal/ui-components/spinner",
|
|
6515
|
-
"category": "
|
|
7583
|
+
"category": "loading",
|
|
6516
7584
|
"exports": [
|
|
6517
7585
|
"Spinner"
|
|
6518
7586
|
],
|
|
@@ -6545,7 +7613,7 @@
|
|
|
6545
7613
|
{
|
|
6546
7614
|
"name": "SplitLayout",
|
|
6547
7615
|
"import": "@brightlocal/ui-components/split-layout",
|
|
6548
|
-
"category": "layout",
|
|
7616
|
+
"category": "page-layout",
|
|
6549
7617
|
"exports": [
|
|
6550
7618
|
"SplitLayout",
|
|
6551
7619
|
"SplitLayoutHeader",
|
|
@@ -6617,7 +7685,7 @@
|
|
|
6617
7685
|
{
|
|
6618
7686
|
"name": "Status",
|
|
6619
7687
|
"import": "@brightlocal/ui-components/status",
|
|
6620
|
-
"category": "
|
|
7688
|
+
"category": "indicators",
|
|
6621
7689
|
"exports": [
|
|
6622
7690
|
"Status"
|
|
6623
7691
|
],
|
|
@@ -6656,7 +7724,8 @@
|
|
|
6656
7724
|
"A fact or label about the thing (plan tier, count, \"New\") — use Badge",
|
|
6657
7725
|
"A message the user should read or act on — use Alert",
|
|
6658
7726
|
"A lone problem on an otherwise healthy row — use an icon, not a dotOnly Status",
|
|
6659
|
-
"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"
|
|
6660
7729
|
],
|
|
6661
7730
|
"alternatives": [
|
|
6662
7731
|
{
|
|
@@ -6694,6 +7763,22 @@
|
|
|
6694
7763
|
"why": "One axis for every state of the mark, named like Button's loading so the DS speaks one word for in-progress",
|
|
6695
7764
|
"date": "2026-11-02",
|
|
6696
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"
|
|
6697
7782
|
}
|
|
6698
7783
|
]
|
|
6699
7784
|
},
|
|
@@ -6848,7 +7933,7 @@
|
|
|
6848
7933
|
{
|
|
6849
7934
|
"name": "Table",
|
|
6850
7935
|
"import": "@brightlocal/ui-components/table",
|
|
6851
|
-
"category": "
|
|
7936
|
+
"category": "data",
|
|
6852
7937
|
"exports": [
|
|
6853
7938
|
"Table",
|
|
6854
7939
|
"TableHeader",
|
|
@@ -6926,6 +8011,10 @@
|
|
|
6926
8011
|
{
|
|
6927
8012
|
"component": "DataTable",
|
|
6928
8013
|
"rule": "Use DataTable for sortable, filterable, paginated tables with row selection — it wraps TanStack Table"
|
|
8014
|
+
},
|
|
8015
|
+
{
|
|
8016
|
+
"component": "DescriptionList",
|
|
8017
|
+
"rule": "Use DescriptionList for the label-value properties of one record; Table is for several records compared by the same columns"
|
|
6929
8018
|
}
|
|
6930
8019
|
],
|
|
6931
8020
|
"replaces": [
|
|
@@ -7057,12 +8146,61 @@
|
|
|
7057
8146
|
},
|
|
7058
8147
|
"props": [
|
|
7059
8148
|
"variant",
|
|
8149
|
+
"fullWidth",
|
|
7060
8150
|
"value",
|
|
7061
8151
|
"defaultValue",
|
|
7062
8152
|
"onValueChange",
|
|
7063
8153
|
"lazyMount",
|
|
7064
8154
|
"unmountOnExit"
|
|
7065
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
|
+
],
|
|
7066
8204
|
"description": "Tabbed interface for switching between views",
|
|
7067
8205
|
"aliases": [
|
|
7068
8206
|
"tab bar",
|
|
@@ -7102,6 +8240,10 @@
|
|
|
7102
8240
|
{
|
|
7103
8241
|
"figma": "Variant",
|
|
7104
8242
|
"code": "variant"
|
|
8243
|
+
},
|
|
8244
|
+
{
|
|
8245
|
+
"figma": "Full Width",
|
|
8246
|
+
"code": "fullWidth"
|
|
7105
8247
|
}
|
|
7106
8248
|
]
|
|
7107
8249
|
},
|
|
@@ -7161,7 +8303,12 @@
|
|
|
7161
8303
|
"dataHookRequired": true,
|
|
7162
8304
|
"variants": {},
|
|
7163
8305
|
"props": [
|
|
7164
|
-
"error"
|
|
8306
|
+
"error",
|
|
8307
|
+
"limit",
|
|
8308
|
+
"countLabels",
|
|
8309
|
+
"autosize",
|
|
8310
|
+
"minRows",
|
|
8311
|
+
"maxRows"
|
|
7165
8312
|
],
|
|
7166
8313
|
"description": "Multi-line text input",
|
|
7167
8314
|
"figma": {
|
|
@@ -7198,12 +8345,31 @@
|
|
|
7198
8345
|
"text that fits on one line (use Input)",
|
|
7199
8346
|
"lists of separate short items (use InputList or InputChip)",
|
|
7200
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
|
+
}
|
|
7201
8367
|
]
|
|
7202
8368
|
},
|
|
7203
8369
|
{
|
|
7204
8370
|
"name": "TextRevealMotion",
|
|
7205
8371
|
"import": "@brightlocal/ui-components/text-reveal-motion",
|
|
7206
|
-
"category": "
|
|
8372
|
+
"category": "loading",
|
|
7207
8373
|
"exports": [
|
|
7208
8374
|
"TextRevealMotion"
|
|
7209
8375
|
],
|
|
@@ -7238,7 +8404,7 @@
|
|
|
7238
8404
|
{
|
|
7239
8405
|
"name": "Toggle",
|
|
7240
8406
|
"import": "@brightlocal/ui-components/toggle",
|
|
7241
|
-
"category": "
|
|
8407
|
+
"category": "actions",
|
|
7242
8408
|
"exports": [
|
|
7243
8409
|
"Toggle"
|
|
7244
8410
|
],
|
|
@@ -7306,7 +8472,7 @@
|
|
|
7306
8472
|
{
|
|
7307
8473
|
"name": "ToggleGroup",
|
|
7308
8474
|
"import": "@brightlocal/ui-components/toggle-group",
|
|
7309
|
-
"category": "
|
|
8475
|
+
"category": "actions",
|
|
7310
8476
|
"exports": [
|
|
7311
8477
|
"ToggleGroup",
|
|
7312
8478
|
"ToggleGroupItem"
|
|
@@ -7365,7 +8531,7 @@
|
|
|
7365
8531
|
{
|
|
7366
8532
|
"name": "Tooltip",
|
|
7367
8533
|
"import": "@brightlocal/ui-components/tooltip",
|
|
7368
|
-
"category": "
|
|
8534
|
+
"category": "overlay",
|
|
7369
8535
|
"exports": [
|
|
7370
8536
|
"Tooltip",
|
|
7371
8537
|
"TooltipProvider",
|
|
@@ -7439,6 +8605,14 @@
|
|
|
7439
8605
|
],
|
|
7440
8606
|
"figmaOnly": []
|
|
7441
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
|
+
],
|
|
7442
8616
|
"whenToUse": [
|
|
7443
8617
|
"Short hints on hover or keyboard focus (icon-only buttons)",
|
|
7444
8618
|
"Clarifying abbreviations or truncated text without taking up space",
|
|
@@ -7448,7 +8622,7 @@
|
|
|
7448
8622
|
{
|
|
7449
8623
|
"name": "Typography",
|
|
7450
8624
|
"import": "@brightlocal/ui-components/typography",
|
|
7451
|
-
"category": "
|
|
8625
|
+
"category": "typography",
|
|
7452
8626
|
"exports": [
|
|
7453
8627
|
"TypographyH1",
|
|
7454
8628
|
"TypographyH2",
|
|
@@ -7544,7 +8718,7 @@
|
|
|
7544
8718
|
"figmaOnly": [],
|
|
7545
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."
|
|
7546
8720
|
},
|
|
7547
|
-
"category": "
|
|
8721
|
+
"category": "typography",
|
|
7548
8722
|
"exports": [
|
|
7549
8723
|
"TypographyHeading"
|
|
7550
8724
|
],
|
|
@@ -7654,9 +8828,9 @@
|
|
|
7654
8828
|
],
|
|
7655
8829
|
"unmappedExports": [],
|
|
7656
8830
|
"figmaOnly": [],
|
|
7657
|
-
"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."
|
|
7658
8832
|
},
|
|
7659
|
-
"category": "
|
|
8833
|
+
"category": "typography",
|
|
7660
8834
|
"exports": [
|
|
7661
8835
|
"TypographyText"
|
|
7662
8836
|
],
|
|
@@ -7673,7 +8847,8 @@
|
|
|
7673
8847
|
"color": [
|
|
7674
8848
|
"default",
|
|
7675
8849
|
"muted",
|
|
7676
|
-
"destructive"
|
|
8850
|
+
"destructive",
|
|
8851
|
+
"success"
|
|
7677
8852
|
],
|
|
7678
8853
|
"align": [
|
|
7679
8854
|
"left",
|
|
@@ -7689,7 +8864,7 @@
|
|
|
7689
8864
|
"align",
|
|
7690
8865
|
"asChild"
|
|
7691
8866
|
],
|
|
7692
|
-
"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)",
|
|
7693
8868
|
"aliases": [
|
|
7694
8869
|
"text",
|
|
7695
8870
|
"paragraph",
|
|
@@ -7730,7 +8905,7 @@
|
|
|
7730
8905
|
{
|
|
7731
8906
|
"name": "EmptyState",
|
|
7732
8907
|
"import": "@brightlocal/ui-components/empty-state",
|
|
7733
|
-
"category": "
|
|
8908
|
+
"category": "states",
|
|
7734
8909
|
"exports": [
|
|
7735
8910
|
"EmptyState"
|
|
7736
8911
|
],
|
|
@@ -7738,6 +8913,7 @@
|
|
|
7738
8913
|
"dataHookRequired": true,
|
|
7739
8914
|
"variants": {
|
|
7740
8915
|
"EmptyStateSize": [
|
|
8916
|
+
"sm",
|
|
7741
8917
|
"md",
|
|
7742
8918
|
"lg"
|
|
7743
8919
|
],
|
|
@@ -7749,6 +8925,10 @@
|
|
|
7749
8925
|
"filled",
|
|
7750
8926
|
"border",
|
|
7751
8927
|
"transparent"
|
|
8928
|
+
],
|
|
8929
|
+
"EmptyStateIconShape": [
|
|
8930
|
+
"circle",
|
|
8931
|
+
"square"
|
|
7752
8932
|
]
|
|
7753
8933
|
},
|
|
7754
8934
|
"props": [
|
|
@@ -7759,12 +8939,13 @@
|
|
|
7759
8939
|
"size",
|
|
7760
8940
|
"align",
|
|
7761
8941
|
"iconVariant",
|
|
8942
|
+
"iconShape",
|
|
7762
8943
|
"titleLevel",
|
|
7763
8944
|
"className"
|
|
7764
8945
|
],
|
|
7765
8946
|
"decisions": [
|
|
7766
8947
|
{
|
|
7767
|
-
"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",
|
|
7768
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",
|
|
7769
8950
|
"date": "2026-10-30",
|
|
7770
8951
|
"ticket": "DS-1208"
|
|
@@ -7774,9 +8955,15 @@
|
|
|
7774
8955
|
"why": "The filled chip disappears on a bg-muted panel; the surface, not the block, decides the container",
|
|
7775
8956
|
"date": "2026-10-30",
|
|
7776
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"
|
|
7777
8964
|
}
|
|
7778
8965
|
],
|
|
7779
|
-
"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.",
|
|
7780
8967
|
"aliases": [
|
|
7781
8968
|
"empty state",
|
|
7782
8969
|
"empty block",
|
|
@@ -7795,7 +8982,8 @@
|
|
|
7795
8982
|
"A collection with no rows yet, inside the table's own frame — a DataTable takes the block through noResultsMessage",
|
|
7796
8983
|
"A section of a working page with nothing to show — keep the heading and frame, swap the body",
|
|
7797
8984
|
"A gated feature: name it, sell it, and offer an action the reader can act on",
|
|
7798
|
-
"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)"
|
|
7799
8987
|
],
|
|
7800
8988
|
"doNotUseFor": [
|
|
7801
8989
|
"a chart, map, or media slot (use ChartEmpty, MapEmpty, or MediaEmpty — a canvas keeps quiet, and those are primitives)",
|
|
@@ -7807,7 +8995,7 @@
|
|
|
7807
8995
|
{
|
|
7808
8996
|
"name": "InputList",
|
|
7809
8997
|
"import": "@brightlocal/ui-components/input-list",
|
|
7810
|
-
"category": "
|
|
8998
|
+
"category": "form",
|
|
7811
8999
|
"exports": [
|
|
7812
9000
|
"InputList",
|
|
7813
9001
|
"InputListItems",
|
|
@@ -7844,7 +9032,7 @@
|
|
|
7844
9032
|
{
|
|
7845
9033
|
"name": "ProgressState",
|
|
7846
9034
|
"import": "@brightlocal/ui-components/progress-state",
|
|
7847
|
-
"category": "
|
|
9035
|
+
"category": "states",
|
|
7848
9036
|
"exports": [
|
|
7849
9037
|
"ProgressState"
|
|
7850
9038
|
],
|
|
@@ -7889,7 +9077,7 @@
|
|
|
7889
9077
|
{
|
|
7890
9078
|
"name": "Sidebar",
|
|
7891
9079
|
"import": "@brightlocal/ui-components/sidebar",
|
|
7892
|
-
"category": "
|
|
9080
|
+
"category": "navigation",
|
|
7893
9081
|
"exports": [
|
|
7894
9082
|
"Sidebar",
|
|
7895
9083
|
"SidebarAccountDropdown",
|
|
@@ -7958,17 +9146,17 @@
|
|
|
7958
9146
|
"toggleAriaLabel": "string — default: \"Toggle sidebar\""
|
|
7959
9147
|
},
|
|
7960
9148
|
"SidebarPopoverTrigger": {
|
|
7961
|
-
"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"
|
|
7962
9150
|
},
|
|
7963
9151
|
"SidebarPopoverMenu": {
|
|
7964
9152
|
"groupTitle": "string — default: \"Teams\"",
|
|
7965
9153
|
"addActionLabel": "string — default: \"Add team\""
|
|
7966
9154
|
},
|
|
7967
9155
|
"SidebarSwitcher": {
|
|
7968
|
-
"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"
|
|
7969
9157
|
},
|
|
7970
9158
|
"SidebarAccountDropdown": {
|
|
7971
|
-
"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"
|
|
7972
9160
|
}
|
|
7973
9161
|
},
|
|
7974
9162
|
"description": "Complex sidebar navigation with collapsible support",
|
|
@@ -8289,10 +9477,16 @@
|
|
|
8289
9477
|
],
|
|
8290
9478
|
"decisions": [
|
|
8291
9479
|
{
|
|
8292
|
-
"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",
|
|
8293
9481
|
"ticket": "DS-1212",
|
|
8294
9482
|
"date": "2026-11-02",
|
|
8295
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."
|
|
8296
9490
|
}
|
|
8297
9491
|
]
|
|
8298
9492
|
}
|