@brightlocal/ui-components 2.26.0 → 2.27.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -2
- package/component-meta.json +3761 -360
- package/dist/blocks/progress-screen.cjs +1 -0
- package/dist/blocks/progress-screen.d.ts +109 -0
- package/dist/blocks/progress-screen.d.ts.map +1 -0
- package/dist/blocks/progress-screen.js +339 -0
- package/dist/blocks/sidebar.cjs +1 -1
- package/dist/blocks/sidebar.d.ts.map +1 -1
- package/dist/blocks/sidebar.js +155 -153
- package/dist/brand-illustration-motif.d.ts +1 -1
- package/dist/breadcrumb.cjs +1 -1
- package/dist/breadcrumb.d.ts.map +1 -1
- package/dist/breadcrumb.js +44 -40
- package/dist/button.cjs +1 -1
- package/dist/button.d.ts.map +1 -1
- package/dist/button.js +28 -28
- package/dist/chip.cjs +1 -1
- package/dist/chip.d.ts +1 -1
- package/dist/chip.d.ts.map +1 -1
- package/dist/chip.js +42 -41
- package/dist/combobox.cjs +3 -3
- package/dist/combobox.d.ts +4 -2
- package/dist/combobox.d.ts.map +1 -1
- package/dist/combobox.js +161 -161
- package/dist/data-table.cjs +1 -1
- package/dist/data-table.d.ts +138 -3
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +455 -309
- package/dist/global-layout.cjs +1 -1
- package/dist/global-layout.d.ts +31 -5
- package/dist/global-layout.d.ts.map +1 -1
- package/dist/global-layout.js +276 -194
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +3 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +462 -451
- package/dist/lib/motion.cjs +1 -1
- package/dist/lib/motion.js +10 -8
- package/dist/link.cjs +1 -1
- package/dist/link.d.ts +8 -6
- package/dist/link.d.ts.map +1 -1
- package/dist/link.js +52 -20
- package/dist/list.cjs +1 -1
- package/dist/list.js +65 -63
- package/dist/progress.cjs +1 -1
- package/dist/progress.d.ts +61 -3
- package/dist/progress.d.ts.map +1 -1
- package/dist/progress.js +142 -65
- package/dist/route-progress.cjs +1 -0
- package/dist/route-progress.d.ts +103 -0
- package/dist/route-progress.d.ts.map +1 -0
- package/dist/route-progress.js +106 -0
- package/dist/sheet.cjs +1 -1
- package/dist/sheet.d.ts +35 -2
- package/dist/sheet.d.ts.map +1 -1
- package/dist/sheet.js +102 -65
- package/dist/sonner.cjs +1 -1
- package/dist/sonner.d.ts.map +1 -1
- package/dist/sonner.js +11 -15
- package/dist/spinner.cjs +1 -0
- package/dist/spinner.d.ts +57 -0
- package/dist/spinner.d.ts.map +1 -0
- package/dist/spinner.js +35 -0
- package/dist/stepper.cjs +1 -1
- package/dist/stepper.d.ts.map +1 -1
- package/dist/stepper.js +26 -25
- package/dist/table.cjs +1 -1
- package/dist/table.d.ts +1 -1
- package/dist/table.d.ts.map +1 -1
- package/dist/table.js +6 -2
- package/package.json +14 -2
- package/src/blocks/progress-screen.tsx +481 -0
- package/src/blocks/sidebar.tsx +22 -15
- package/src/components/breadcrumb.tsx +9 -4
- package/src/components/button.tsx +2 -5
- package/src/components/chip.tsx +4 -3
- package/src/components/combobox.tsx +15 -8
- package/src/components/data-table.tsx +333 -14
- package/src/components/global-layout.tsx +228 -62
- package/src/components/link.tsx +39 -5
- package/src/components/list.tsx +5 -5
- package/src/components/progress.tsx +217 -30
- package/src/components/route-progress.tsx +354 -0
- package/src/components/sheet.tsx +87 -5
- package/src/components/sonner.tsx +3 -12
- package/src/components/spinner.tsx +94 -0
- package/src/components/stepper.tsx +3 -4
- package/src/components/table.tsx +6 -2
- package/src/index.ts +3 -0
package/component-meta.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@brightlocal/ui-components",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.27.0",
|
|
4
4
|
"description": "Machine-readable registry of all components in the BrightLocal Design System",
|
|
5
5
|
"components": [
|
|
6
6
|
{
|
|
@@ -26,7 +26,56 @@
|
|
|
26
26
|
"value",
|
|
27
27
|
"onValueChange"
|
|
28
28
|
],
|
|
29
|
-
"description": "Expandable/collapsible content sections"
|
|
29
|
+
"description": "Expandable/collapsible content sections",
|
|
30
|
+
"figma": {
|
|
31
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
32
|
+
"nodes": [
|
|
33
|
+
{
|
|
34
|
+
"nodeId": "22:1330",
|
|
35
|
+
"figmaName": "Accordion",
|
|
36
|
+
"kind": "component",
|
|
37
|
+
"export": "Accordion",
|
|
38
|
+
"note": "Code's `type` variant (single|multiple) is behavioral (how many items may be open at once) — not drawable in a static mock, intentionally no Figma axis. 'Item 3'–'Item 8' BOOLEAN props are composition toggles (globally exempt)."
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"nodeId": "22:516",
|
|
42
|
+
"figmaName": "Accordion / AccordionItem",
|
|
43
|
+
"kind": "componentSet",
|
|
44
|
+
"export": "AccordionItem",
|
|
45
|
+
"axes": [
|
|
46
|
+
{
|
|
47
|
+
"figma": "Active",
|
|
48
|
+
"exempt": "interaction-state"
|
|
49
|
+
},
|
|
50
|
+
{
|
|
51
|
+
"figma": "State",
|
|
52
|
+
"exempt": "interaction-state"
|
|
53
|
+
}
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
],
|
|
57
|
+
"unmappedExports": [
|
|
58
|
+
{
|
|
59
|
+
"export": "AccordionTrigger",
|
|
60
|
+
"reason": "Drawn inside the AccordionItem set variants (trigger row + chevron, 'Trigger Text' TEXT prop), not a standalone Figma component"
|
|
61
|
+
},
|
|
62
|
+
{
|
|
63
|
+
"export": "AccordionContent",
|
|
64
|
+
"reason": "Drawn inside the AccordionItem set variants ('Content Text' TEXT prop), not a standalone Figma component"
|
|
65
|
+
}
|
|
66
|
+
],
|
|
67
|
+
"figmaOnly": []
|
|
68
|
+
},
|
|
69
|
+
"whenToUse": [
|
|
70
|
+
"Expandable/collapsible content sections like FAQs or grouped settings",
|
|
71
|
+
"Reducing page density by letting users scan titles and open only what's relevant",
|
|
72
|
+
"Help documentation where each section is self-contained"
|
|
73
|
+
],
|
|
74
|
+
"doNotUseFor": [
|
|
75
|
+
"a single show/hide section (use Collapsible)",
|
|
76
|
+
"switching between complete views of the same content (use Tabs)",
|
|
77
|
+
"content that must be read in order as a process (use Stepper)"
|
|
78
|
+
]
|
|
30
79
|
},
|
|
31
80
|
{
|
|
32
81
|
"name": "Alert",
|
|
@@ -65,8 +114,9 @@
|
|
|
65
114
|
"status message"
|
|
66
115
|
],
|
|
67
116
|
"doNotUseFor": [
|
|
68
|
-
"
|
|
69
|
-
"
|
|
117
|
+
"passing confirmations that can auto-dismiss (use Sonner)",
|
|
118
|
+
"single-field validation errors (use Field/FieldError)",
|
|
119
|
+
"messages needing a decision before continuing (use AlertDialog)"
|
|
70
120
|
],
|
|
71
121
|
"replaces": [],
|
|
72
122
|
"states": [
|
|
@@ -78,7 +128,59 @@
|
|
|
78
128
|
"keyboardInteraction": [
|
|
79
129
|
"Tab"
|
|
80
130
|
]
|
|
81
|
-
}
|
|
131
|
+
},
|
|
132
|
+
"figma": {
|
|
133
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
134
|
+
"nodes": [
|
|
135
|
+
{
|
|
136
|
+
"nodeId": "26:160",
|
|
137
|
+
"figmaName": "Alert",
|
|
138
|
+
"kind": "componentSet",
|
|
139
|
+
"export": "Alert",
|
|
140
|
+
"note": "Title/Description/Icon/Button props are composition toggles",
|
|
141
|
+
"axes": [
|
|
142
|
+
{
|
|
143
|
+
"figma": "Variant",
|
|
144
|
+
"code": "variant",
|
|
145
|
+
"note": "Figma draws no Default variant while code ships one — FIG-11 (allowlisted)"
|
|
146
|
+
}
|
|
147
|
+
]
|
|
148
|
+
}
|
|
149
|
+
],
|
|
150
|
+
"unmappedExports": [
|
|
151
|
+
{
|
|
152
|
+
"export": "AlertTitle",
|
|
153
|
+
"reason": "Represented as 'Title Text' TEXT prop on the Alert set"
|
|
154
|
+
},
|
|
155
|
+
{
|
|
156
|
+
"export": "AlertDescription",
|
|
157
|
+
"reason": "Represented as 'Description Text' TEXT prop on the Alert set"
|
|
158
|
+
},
|
|
159
|
+
{
|
|
160
|
+
"export": "AlertSuccess",
|
|
161
|
+
"reason": "Convenience wrapper for variant='success' — the set's Variant axis covers it"
|
|
162
|
+
},
|
|
163
|
+
{
|
|
164
|
+
"export": "AlertInfo",
|
|
165
|
+
"reason": "Convenience wrapper for variant='info'"
|
|
166
|
+
},
|
|
167
|
+
{
|
|
168
|
+
"export": "AlertDestructive",
|
|
169
|
+
"reason": "Convenience wrapper for variant='destructive'"
|
|
170
|
+
},
|
|
171
|
+
{
|
|
172
|
+
"export": "AlertWarning",
|
|
173
|
+
"reason": "Convenience wrapper for variant='warning'"
|
|
174
|
+
}
|
|
175
|
+
],
|
|
176
|
+
"figmaOnly": []
|
|
177
|
+
},
|
|
178
|
+
"whenToUse": [
|
|
179
|
+
"Page- or form-level errors and failures that must stay visible (Destructive)",
|
|
180
|
+
"Cautionary heads-ups before anything fails (Warning)",
|
|
181
|
+
"Helpful, neutral information tied to the page (Info)",
|
|
182
|
+
"Persistent success confirmation that stays until no longer true (Success)"
|
|
183
|
+
]
|
|
82
184
|
},
|
|
83
185
|
{
|
|
84
186
|
"name": "AlertDialog",
|
|
@@ -109,13 +211,15 @@
|
|
|
109
211
|
"destructive action dialog"
|
|
110
212
|
],
|
|
111
213
|
"whenToUse": [
|
|
112
|
-
"
|
|
113
|
-
"
|
|
114
|
-
"
|
|
214
|
+
"Confirming irreversible actions (permanent delete of an account or location)",
|
|
215
|
+
"Serious consequences needing an explicit confirm-or-cancel choice",
|
|
216
|
+
"Forcing a deliberate pause before something irreversible happens"
|
|
115
217
|
],
|
|
116
218
|
"doNotUseFor": [
|
|
117
|
-
"
|
|
118
|
-
"
|
|
219
|
+
"easily undoable actions (use Sonner with an Undo action)",
|
|
220
|
+
"forms or complex content (use Dialog)",
|
|
221
|
+
"routine low-risk confirmations (trains click-through)",
|
|
222
|
+
"status messages with no decision (use Alert)"
|
|
119
223
|
],
|
|
120
224
|
"alternatives": [
|
|
121
225
|
{
|
|
@@ -139,6 +243,60 @@
|
|
|
139
243
|
"Escape",
|
|
140
244
|
"Tab"
|
|
141
245
|
]
|
|
246
|
+
},
|
|
247
|
+
"figma": {
|
|
248
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
249
|
+
"nodes": [
|
|
250
|
+
{
|
|
251
|
+
"nodeId": "83:122",
|
|
252
|
+
"figmaName": "Alert Dialog",
|
|
253
|
+
"kind": "componentSet",
|
|
254
|
+
"export": "AlertDialog",
|
|
255
|
+
"note": "Draws the assembled dialog; all sub-parts are drawn inside",
|
|
256
|
+
"axes": [
|
|
257
|
+
{
|
|
258
|
+
"figma": "Breakpoint",
|
|
259
|
+
"exempt": "figma-only-style",
|
|
260
|
+
"note": "Responsive breakpoint drawings — sizing is runtime in code"
|
|
261
|
+
}
|
|
262
|
+
]
|
|
263
|
+
}
|
|
264
|
+
],
|
|
265
|
+
"unmappedExports": [
|
|
266
|
+
{
|
|
267
|
+
"export": "AlertDialogTrigger",
|
|
268
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
269
|
+
},
|
|
270
|
+
{
|
|
271
|
+
"export": "AlertDialogContent",
|
|
272
|
+
"reason": "Drawn by the Alert Dialog set (the panel)"
|
|
273
|
+
},
|
|
274
|
+
{
|
|
275
|
+
"export": "AlertDialogHeader",
|
|
276
|
+
"reason": "Drawn inside the set, structural"
|
|
277
|
+
},
|
|
278
|
+
{
|
|
279
|
+
"export": "AlertDialogFooter",
|
|
280
|
+
"reason": "Drawn inside the set, structural"
|
|
281
|
+
},
|
|
282
|
+
{
|
|
283
|
+
"export": "AlertDialogTitle",
|
|
284
|
+
"reason": "Drawn inside the set as the heading text"
|
|
285
|
+
},
|
|
286
|
+
{
|
|
287
|
+
"export": "AlertDialogDescription",
|
|
288
|
+
"reason": "Drawn inside the set as the body text"
|
|
289
|
+
},
|
|
290
|
+
{
|
|
291
|
+
"export": "AlertDialogAction",
|
|
292
|
+
"reason": "Drawn inside the set as a Button instance"
|
|
293
|
+
},
|
|
294
|
+
{
|
|
295
|
+
"export": "AlertDialogCancel",
|
|
296
|
+
"reason": "Drawn inside the set as a Button instance"
|
|
297
|
+
}
|
|
298
|
+
],
|
|
299
|
+
"figmaOnly": []
|
|
142
300
|
}
|
|
143
301
|
},
|
|
144
302
|
{
|
|
@@ -154,7 +312,37 @@
|
|
|
154
312
|
"props": [
|
|
155
313
|
"ratio"
|
|
156
314
|
],
|
|
157
|
-
"description": "Maintains consistent aspect ratios for content"
|
|
315
|
+
"description": "Maintains consistent aspect ratios for content",
|
|
316
|
+
"figma": {
|
|
317
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
318
|
+
"nodes": [
|
|
319
|
+
{
|
|
320
|
+
"nodeId": "28:1540",
|
|
321
|
+
"figmaName": "Aspect Ratio",
|
|
322
|
+
"kind": "componentSet",
|
|
323
|
+
"export": "AspectRatio",
|
|
324
|
+
"axes": [
|
|
325
|
+
{
|
|
326
|
+
"figma": "Ratio",
|
|
327
|
+
"exempt": "figma-only-style",
|
|
328
|
+
"note": "17 discrete ratio drawings — the ratio prop is a continuous number in code"
|
|
329
|
+
}
|
|
330
|
+
]
|
|
331
|
+
}
|
|
332
|
+
],
|
|
333
|
+
"unmappedExports": [],
|
|
334
|
+
"figmaOnly": []
|
|
335
|
+
},
|
|
336
|
+
"whenToUse": [
|
|
337
|
+
"Keeping an image, video, or map a fixed shape (like 16:9) while loading",
|
|
338
|
+
"Grids of media tiles that should share the same proportions",
|
|
339
|
+
"Reserving space for async-loading content so the page doesn't jump"
|
|
340
|
+
],
|
|
341
|
+
"doNotUseFor": [
|
|
342
|
+
"non-media content (not a general-purpose layout tool)",
|
|
343
|
+
"content with its own natural size, like a long screenshot",
|
|
344
|
+
"containers already fully sized by their parent, like a small avatar"
|
|
345
|
+
]
|
|
158
346
|
},
|
|
159
347
|
{
|
|
160
348
|
"name": "Avatar",
|
|
@@ -172,7 +360,53 @@
|
|
|
172
360
|
"src",
|
|
173
361
|
"alt"
|
|
174
362
|
],
|
|
175
|
-
"description": "User avatar images with fallback"
|
|
363
|
+
"description": "User avatar images with fallback",
|
|
364
|
+
"figma": {
|
|
365
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
366
|
+
"nodes": [
|
|
367
|
+
{
|
|
368
|
+
"nodeId": "17100:29935",
|
|
369
|
+
"figmaName": "Avatar",
|
|
370
|
+
"kind": "componentSet",
|
|
371
|
+
"export": "Avatar",
|
|
372
|
+
"alsoRepresents": [
|
|
373
|
+
"AvatarImage",
|
|
374
|
+
"AvatarFallback"
|
|
375
|
+
],
|
|
376
|
+
"axes": [
|
|
377
|
+
{
|
|
378
|
+
"figma": "Type",
|
|
379
|
+
"exempt": "export-discriminator",
|
|
380
|
+
"note": "Image|Fallback selects AvatarImage vs AvatarFallback"
|
|
381
|
+
},
|
|
382
|
+
{
|
|
383
|
+
"figma": "Size",
|
|
384
|
+
"exempt": "figma-only-style",
|
|
385
|
+
"note": "Tailwind size classes in code (className), no size variant"
|
|
386
|
+
}
|
|
387
|
+
]
|
|
388
|
+
}
|
|
389
|
+
],
|
|
390
|
+
"unmappedExports": [],
|
|
391
|
+
"figmaOnly": [
|
|
392
|
+
{
|
|
393
|
+
"nodeId": "17100:83077",
|
|
394
|
+
"figmaName": "Avatar Group",
|
|
395
|
+
"reason": "No code AvatarGroup export — consumer composition"
|
|
396
|
+
}
|
|
397
|
+
]
|
|
398
|
+
},
|
|
399
|
+
"whenToUse": [
|
|
400
|
+
"Showing a person's photo or initials (customer, team member, comment author)",
|
|
401
|
+
"Account switchers, assignment pickers, and activity feeds",
|
|
402
|
+
"Identifying a specific human at a glance"
|
|
403
|
+
],
|
|
404
|
+
"doNotUseFor": [
|
|
405
|
+
"brand representation (use Logo)",
|
|
406
|
+
"companies or locations with no photo convention (use an icon or Badge)",
|
|
407
|
+
"ratings or scores next to a name (use Rating or Badge)",
|
|
408
|
+
"clickable images that open a menu (pair Avatar with DropdownMenu)"
|
|
409
|
+
]
|
|
176
410
|
},
|
|
177
411
|
{
|
|
178
412
|
"name": "Badge",
|
|
@@ -203,13 +437,14 @@
|
|
|
203
437
|
"status indicator"
|
|
204
438
|
],
|
|
205
439
|
"whenToUse": [
|
|
206
|
-
"
|
|
207
|
-
"
|
|
208
|
-
"
|
|
440
|
+
"Status labels like \"New,\" \"Active,\" \"Draft,\" or \"Error\"",
|
|
441
|
+
"Numeric counts on icons or navigation items",
|
|
442
|
+
"Highlighting a plan tier or account type"
|
|
209
443
|
],
|
|
210
444
|
"doNotUseFor": [
|
|
211
|
-
"removable tags (use Chip)",
|
|
212
|
-
"
|
|
445
|
+
"removable tags or filter values (use Chip)",
|
|
446
|
+
"neutral or positive statuses styled as Destructive",
|
|
447
|
+
"page-level cautions rather than failures (use Alert's Warning variant)"
|
|
213
448
|
],
|
|
214
449
|
"alternatives": [
|
|
215
450
|
{
|
|
@@ -229,6 +464,29 @@
|
|
|
229
464
|
"role": "status",
|
|
230
465
|
"requiresLabel": false,
|
|
231
466
|
"keyboardInteraction": []
|
|
467
|
+
},
|
|
468
|
+
"figma": {
|
|
469
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
470
|
+
"nodes": [
|
|
471
|
+
{
|
|
472
|
+
"nodeId": "26:169",
|
|
473
|
+
"figmaName": "Badge",
|
|
474
|
+
"kind": "componentSet",
|
|
475
|
+
"export": "Badge",
|
|
476
|
+
"axes": [
|
|
477
|
+
{
|
|
478
|
+
"figma": "Variant",
|
|
479
|
+
"code": "variant"
|
|
480
|
+
},
|
|
481
|
+
{
|
|
482
|
+
"figma": "State",
|
|
483
|
+
"exempt": "interaction-state"
|
|
484
|
+
}
|
|
485
|
+
]
|
|
486
|
+
}
|
|
487
|
+
],
|
|
488
|
+
"unmappedExports": [],
|
|
489
|
+
"figmaOnly": []
|
|
232
490
|
}
|
|
233
491
|
},
|
|
234
492
|
{
|
|
@@ -258,7 +516,35 @@
|
|
|
258
516
|
"size",
|
|
259
517
|
"children"
|
|
260
518
|
],
|
|
261
|
-
"description": "Brand illustration composed over a decorative motif backdrop (lg) or a standalone green motif mark (sm/md); sunrise + lg slowly rotates"
|
|
519
|
+
"description": "Brand illustration composed over a decorative motif backdrop (lg) or a standalone green motif mark (sm/md); sunrise + lg slowly rotates",
|
|
520
|
+
"figma": {
|
|
521
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
522
|
+
"nodes": [
|
|
523
|
+
{
|
|
524
|
+
"nodeId": "30231:736",
|
|
525
|
+
"figmaName": "BrandIllustrationsMotifs",
|
|
526
|
+
"kind": "componentSet",
|
|
527
|
+
"export": "BrandIllustrationMotif",
|
|
528
|
+
"axes": [
|
|
529
|
+
{
|
|
530
|
+
"figma": "Shape",
|
|
531
|
+
"code": "motif"
|
|
532
|
+
},
|
|
533
|
+
{
|
|
534
|
+
"figma": "Size",
|
|
535
|
+
"code": "size",
|
|
536
|
+
"valueAliases": {
|
|
537
|
+
"Large": "lg",
|
|
538
|
+
"Medium": "md",
|
|
539
|
+
"Small": "sm"
|
|
540
|
+
}
|
|
541
|
+
}
|
|
542
|
+
]
|
|
543
|
+
}
|
|
544
|
+
],
|
|
545
|
+
"unmappedExports": [],
|
|
546
|
+
"figmaOnly": []
|
|
547
|
+
}
|
|
262
548
|
},
|
|
263
549
|
{
|
|
264
550
|
"name": "Breadcrumb",
|
|
@@ -285,7 +571,68 @@
|
|
|
285
571
|
"srLabel": "string — default: \"More\""
|
|
286
572
|
}
|
|
287
573
|
},
|
|
288
|
-
"description": "Hierarchical navigation trail"
|
|
574
|
+
"description": "Hierarchical navigation trail",
|
|
575
|
+
"figma": {
|
|
576
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
577
|
+
"nodes": [
|
|
578
|
+
{
|
|
579
|
+
"nodeId": "109:947",
|
|
580
|
+
"figmaName": "Breadcrumb",
|
|
581
|
+
"kind": "componentSet",
|
|
582
|
+
"export": "Breadcrumb",
|
|
583
|
+
"axes": [
|
|
584
|
+
{
|
|
585
|
+
"figma": "Size",
|
|
586
|
+
"exempt": "figma-only-style",
|
|
587
|
+
"note": "md|sm size style with no code counterpart (FIG-13)"
|
|
588
|
+
}
|
|
589
|
+
]
|
|
590
|
+
},
|
|
591
|
+
{
|
|
592
|
+
"nodeId": "195:1993",
|
|
593
|
+
"figmaName": "Breadcrumb / BreadcrumbItem",
|
|
594
|
+
"kind": "componentSet",
|
|
595
|
+
"export": "BreadcrumbItem",
|
|
596
|
+
"alsoRepresents": [
|
|
597
|
+
"BreadcrumbLink",
|
|
598
|
+
"BreadcrumbPage",
|
|
599
|
+
"BreadcrumbEllipsis"
|
|
600
|
+
],
|
|
601
|
+
"axes": [
|
|
602
|
+
{
|
|
603
|
+
"figma": "Variant",
|
|
604
|
+
"exempt": "export-discriminator",
|
|
605
|
+
"note": "Link/Link Current/Ellipsis select BreadcrumbLink, BreadcrumbPage and BreadcrumbEllipsis; Dropdown is a composition with DropdownMenu"
|
|
606
|
+
},
|
|
607
|
+
{
|
|
608
|
+
"figma": "State",
|
|
609
|
+
"exempt": "interaction-state"
|
|
610
|
+
}
|
|
611
|
+
]
|
|
612
|
+
}
|
|
613
|
+
],
|
|
614
|
+
"unmappedExports": [
|
|
615
|
+
{
|
|
616
|
+
"export": "BreadcrumbList",
|
|
617
|
+
"reason": "Structural wrapper (the <ol>), no standalone Figma representation"
|
|
618
|
+
},
|
|
619
|
+
{
|
|
620
|
+
"export": "BreadcrumbSeparator",
|
|
621
|
+
"reason": "Drawn between items inside the Breadcrumb set, not a standalone Figma component"
|
|
622
|
+
}
|
|
623
|
+
],
|
|
624
|
+
"figmaOnly": []
|
|
625
|
+
},
|
|
626
|
+
"whenToUse": [
|
|
627
|
+
"Showing where the user is in a multi-level app, with quick links back up",
|
|
628
|
+
"Deep sections (3+ levels) where users frequently drill down and need an easy way back out",
|
|
629
|
+
"Helping users retrace their steps without relying on the browser back button"
|
|
630
|
+
],
|
|
631
|
+
"doNotUseFor": [
|
|
632
|
+
"apps only one or two levels deep (adds clutter with no benefit)",
|
|
633
|
+
"progress through a sequence (use Stepper)",
|
|
634
|
+
"sections already made obvious by a persistent Sidebar or tab bar"
|
|
635
|
+
]
|
|
289
636
|
},
|
|
290
637
|
{
|
|
291
638
|
"name": "Button",
|
|
@@ -329,12 +676,15 @@
|
|
|
329
676
|
],
|
|
330
677
|
"whenToUse": [
|
|
331
678
|
"Triggering an action (submit, save, delete, open)",
|
|
332
|
-
"
|
|
333
|
-
"
|
|
679
|
+
"The single most important action on a screen or dialog (Primary)",
|
|
680
|
+
"Supporting or low-emphasis actions (Secondary, Outline, Ghost)",
|
|
681
|
+
"Risky or destructive actions signaled by color (Warning, Destructive)"
|
|
334
682
|
],
|
|
335
683
|
"doNotUseFor": [
|
|
336
|
-
"navigation
|
|
337
|
-
"
|
|
684
|
+
"navigation to another page (use Link)",
|
|
685
|
+
"several competing primary actions in one section",
|
|
686
|
+
"red styling on safe, routine actions",
|
|
687
|
+
"destructive actions without a confirmation step (pair with AlertDialog)"
|
|
338
688
|
],
|
|
339
689
|
"alternatives": [
|
|
340
690
|
{
|
|
@@ -427,7 +777,53 @@
|
|
|
427
777
|
"onSelect",
|
|
428
778
|
"disabled"
|
|
429
779
|
],
|
|
430
|
-
"description": "Date selection calendar (wraps react-day-picker)"
|
|
780
|
+
"description": "Date selection calendar (wraps react-day-picker)",
|
|
781
|
+
"figma": {
|
|
782
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
783
|
+
"nodes": [
|
|
784
|
+
{
|
|
785
|
+
"nodeId": "17179:197284",
|
|
786
|
+
"figmaName": "Calendar",
|
|
787
|
+
"kind": "componentSet",
|
|
788
|
+
"export": "Calendar",
|
|
789
|
+
"axes": [
|
|
790
|
+
{
|
|
791
|
+
"figma": "Type",
|
|
792
|
+
"exempt": "figma-only-style",
|
|
793
|
+
"note": "1/2/3 Columns correspond to the numberOfMonths prop; With Presets/With Time/Custom Days are composition demos (DatePickerPresets etc.)"
|
|
794
|
+
}
|
|
795
|
+
]
|
|
796
|
+
}
|
|
797
|
+
],
|
|
798
|
+
"unmappedExports": [],
|
|
799
|
+
"figmaOnly": [
|
|
800
|
+
{
|
|
801
|
+
"nodeId": "234:196",
|
|
802
|
+
"figmaName": "Calendar / Arrow Button",
|
|
803
|
+
"reason": "Internal navigation part — no code export (react-day-picker internals)"
|
|
804
|
+
},
|
|
805
|
+
{
|
|
806
|
+
"nodeId": "234:27",
|
|
807
|
+
"figmaName": "Calendar / Day Button",
|
|
808
|
+
"reason": "Internal day-cell part — no code export"
|
|
809
|
+
},
|
|
810
|
+
{
|
|
811
|
+
"nodeId": "17921:42281",
|
|
812
|
+
"figmaName": "Calendar / Custom Day Button",
|
|
813
|
+
"reason": "Internal day-cell part — no code export"
|
|
814
|
+
}
|
|
815
|
+
]
|
|
816
|
+
},
|
|
817
|
+
"whenToUse": [
|
|
818
|
+
"Picking or displaying dates on a full, always-visible calendar grid",
|
|
819
|
+
"Range mode for a start and end date seen across the month",
|
|
820
|
+
"Multiple mode for scattered, non-continuous dates",
|
|
821
|
+
"Booking or scheduling interfaces where seeing the whole month helps"
|
|
822
|
+
],
|
|
823
|
+
"doNotUseFor": [
|
|
824
|
+
"a compact field in a form (use DatePicker)",
|
|
825
|
+
"space-constrained layouts where a full grid won't fit (use DatePicker)"
|
|
826
|
+
]
|
|
431
827
|
},
|
|
432
828
|
{
|
|
433
829
|
"name": "Callout",
|
|
@@ -456,7 +852,17 @@
|
|
|
456
852
|
]
|
|
457
853
|
},
|
|
458
854
|
"props": [],
|
|
459
|
-
"description": "Speech bubble callout for highlighting key statements or quotes"
|
|
855
|
+
"description": "Speech bubble callout for highlighting key statements or quotes",
|
|
856
|
+
"whenToUse": [
|
|
857
|
+
"Bold pull-quotes or standout statements (marketing pages, testimonials, empty states)",
|
|
858
|
+
"Onboarding or hero moments needing a strong visual statement",
|
|
859
|
+
"Color-matching a section's theme with purple/blue/green without implying status"
|
|
860
|
+
],
|
|
861
|
+
"doNotUseFor": [
|
|
862
|
+
"routine product status (use Alert; Callout is decorative)",
|
|
863
|
+
"form-field validation messages (use Field/FieldError)",
|
|
864
|
+
"colors that must carry status meaning (use Alert)"
|
|
865
|
+
]
|
|
460
866
|
},
|
|
461
867
|
{
|
|
462
868
|
"name": "Card",
|
|
@@ -503,14 +909,15 @@
|
|
|
503
909
|
"content card"
|
|
504
910
|
],
|
|
505
911
|
"whenToUse": [
|
|
506
|
-
"
|
|
507
|
-
"
|
|
508
|
-
"
|
|
912
|
+
"Putting a box around related content (form section, detail panel, stat summary)",
|
|
913
|
+
"Dashboard widgets or sections separated from the page background",
|
|
914
|
+
"Grouping content without a visible boundary (Transparent variant)",
|
|
915
|
+
"Full-bleed edge-to-edge media (Transparent Flush variant)"
|
|
509
916
|
],
|
|
510
917
|
"knownGaps": [],
|
|
511
918
|
"doNotUseFor": [
|
|
512
|
-
"
|
|
513
|
-
"
|
|
919
|
+
"laying out an entire page (use GlobalLayout)",
|
|
920
|
+
"text-heavy content in the flush variant (padding is needed for reading)"
|
|
514
921
|
],
|
|
515
922
|
"replaces": [
|
|
516
923
|
"raw div containers"
|
|
@@ -651,10 +1058,91 @@
|
|
|
651
1058
|
"slideAriaLabel": "string — default: \"Go to slide {slide}\""
|
|
652
1059
|
}
|
|
653
1060
|
},
|
|
654
|
-
"description": "Image/content carousel slider"
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
1061
|
+
"description": "Image/content carousel slider",
|
|
1062
|
+
"figma": {
|
|
1063
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1064
|
+
"nodes": [
|
|
1065
|
+
{
|
|
1066
|
+
"nodeId": "241:1368",
|
|
1067
|
+
"figmaName": "Carousel",
|
|
1068
|
+
"kind": "componentSet",
|
|
1069
|
+
"export": "Carousel",
|
|
1070
|
+
"axes": [
|
|
1071
|
+
{
|
|
1072
|
+
"figma": "Orientation",
|
|
1073
|
+
"code": "orientation"
|
|
1074
|
+
},
|
|
1075
|
+
{
|
|
1076
|
+
"figma": "Breakpoint",
|
|
1077
|
+
"exempt": "figma-only-style",
|
|
1078
|
+
"note": "Responsive drawings — sizing is runtime in code"
|
|
1079
|
+
}
|
|
1080
|
+
]
|
|
1081
|
+
},
|
|
1082
|
+
{
|
|
1083
|
+
"nodeId": "239:851",
|
|
1084
|
+
"figmaName": "Carousel / Arrow Button",
|
|
1085
|
+
"kind": "componentSet",
|
|
1086
|
+
"export": "CarouselPrevious",
|
|
1087
|
+
"alsoRepresents": [
|
|
1088
|
+
"CarouselNext"
|
|
1089
|
+
],
|
|
1090
|
+
"axes": [
|
|
1091
|
+
{
|
|
1092
|
+
"figma": "Variant",
|
|
1093
|
+
"exempt": "export-discriminator",
|
|
1094
|
+
"note": "Previous|Next selects CarouselPrevious vs CarouselNext"
|
|
1095
|
+
},
|
|
1096
|
+
{
|
|
1097
|
+
"figma": "Orientation",
|
|
1098
|
+
"code": "orientation"
|
|
1099
|
+
},
|
|
1100
|
+
{
|
|
1101
|
+
"figma": "State",
|
|
1102
|
+
"exempt": "interaction-state",
|
|
1103
|
+
"valueToProp": {
|
|
1104
|
+
"Disabled": "disabled"
|
|
1105
|
+
}
|
|
1106
|
+
}
|
|
1107
|
+
]
|
|
1108
|
+
},
|
|
1109
|
+
{
|
|
1110
|
+
"nodeId": "239:1214",
|
|
1111
|
+
"figmaName": "Carousel / CarouselItem",
|
|
1112
|
+
"kind": "component",
|
|
1113
|
+
"export": "CarouselItem"
|
|
1114
|
+
}
|
|
1115
|
+
],
|
|
1116
|
+
"unmappedExports": [
|
|
1117
|
+
{
|
|
1118
|
+
"export": "CarouselContent",
|
|
1119
|
+
"reason": "Structural viewport wrapper, no standalone Figma representation"
|
|
1120
|
+
},
|
|
1121
|
+
{
|
|
1122
|
+
"export": "CarouselDots",
|
|
1123
|
+
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
1124
|
+
}
|
|
1125
|
+
],
|
|
1126
|
+
"figmaOnly": [
|
|
1127
|
+
{
|
|
1128
|
+
"nodeId": "239:1300",
|
|
1129
|
+
"figmaName": "Carousel / Basic",
|
|
1130
|
+
"reason": "Figma demo composition"
|
|
1131
|
+
}
|
|
1132
|
+
]
|
|
1133
|
+
},
|
|
1134
|
+
"whenToUse": [
|
|
1135
|
+
"Swiping or clicking through a small set of images or cards",
|
|
1136
|
+
"Featured content or testimonials on a marketing page",
|
|
1137
|
+
"Feed-style content in tall, narrow spaces (vertical orientation)"
|
|
1138
|
+
],
|
|
1139
|
+
"doNotUseFor": [
|
|
1140
|
+
"browsing many items (use a grid or list)",
|
|
1141
|
+
"data- or text-heavy content (use Table or List)"
|
|
1142
|
+
]
|
|
1143
|
+
},
|
|
1144
|
+
{
|
|
1145
|
+
"name": "CentredLayout",
|
|
658
1146
|
"import": "@brightlocal/ui-components/centred-layout",
|
|
659
1147
|
"category": "layout",
|
|
660
1148
|
"exports": [
|
|
@@ -668,12 +1156,14 @@
|
|
|
668
1156
|
"props": [],
|
|
669
1157
|
"description": "Full-page centered content layout",
|
|
670
1158
|
"whenToUse": [
|
|
671
|
-
"
|
|
672
|
-
"Pages
|
|
1159
|
+
"A single centered page with no sidebar (login, signup, password reset)",
|
|
1160
|
+
"Pages built around one centered Card with a branded header above it",
|
|
1161
|
+
"Standalone pages with no competing content beside the main form"
|
|
673
1162
|
],
|
|
674
1163
|
"doNotUseFor": [
|
|
675
|
-
"
|
|
676
|
-
"
|
|
1164
|
+
"app shells with a persistent sidebar (use GlobalLayout)",
|
|
1165
|
+
"two-column pages with marketing content (use SplitLayout)",
|
|
1166
|
+
"pages with multiple independent sections (one centered column feels cramped)"
|
|
677
1167
|
],
|
|
678
1168
|
"alternatives": [
|
|
679
1169
|
{
|
|
@@ -684,7 +1174,36 @@
|
|
|
684
1174
|
"component": "GlobalLayout",
|
|
685
1175
|
"rule": "Use GlobalLayout for full app shells with sidebar navigation"
|
|
686
1176
|
}
|
|
687
|
-
]
|
|
1177
|
+
],
|
|
1178
|
+
"figma": {
|
|
1179
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1180
|
+
"nodes": [
|
|
1181
|
+
{
|
|
1182
|
+
"nodeId": "23024:2815",
|
|
1183
|
+
"figmaName": "Centred Layout",
|
|
1184
|
+
"kind": "componentSet",
|
|
1185
|
+
"export": "CentredLayout",
|
|
1186
|
+
"axes": [
|
|
1187
|
+
{
|
|
1188
|
+
"figma": "Variant",
|
|
1189
|
+
"exempt": "figma-only-style",
|
|
1190
|
+
"note": "Single-value placeholder axis (Default only)"
|
|
1191
|
+
}
|
|
1192
|
+
]
|
|
1193
|
+
}
|
|
1194
|
+
],
|
|
1195
|
+
"unmappedExports": [
|
|
1196
|
+
{
|
|
1197
|
+
"export": "CentredLayoutHeader",
|
|
1198
|
+
"reason": "Drawn inside the layout composition"
|
|
1199
|
+
},
|
|
1200
|
+
{
|
|
1201
|
+
"export": "CentredLayoutContent",
|
|
1202
|
+
"reason": "Structural slot, drawn implicitly as the content area"
|
|
1203
|
+
}
|
|
1204
|
+
],
|
|
1205
|
+
"figmaOnly": []
|
|
1206
|
+
}
|
|
688
1207
|
},
|
|
689
1208
|
{
|
|
690
1209
|
"name": "Chart",
|
|
@@ -715,7 +1234,23 @@
|
|
|
715
1234
|
"hooks": [
|
|
716
1235
|
"useChart"
|
|
717
1236
|
],
|
|
718
|
-
"description": "Data visualization wrapper for Recharts"
|
|
1237
|
+
"description": "Data visualization wrapper for Recharts",
|
|
1238
|
+
"figma": {
|
|
1239
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1240
|
+
"status": "code-only",
|
|
1241
|
+
"reason": "Structurally unmappable (DS-824 verdict): Figma draws per-chart-type examples (Chart / Line Chart, Area Chart, Pie …) with no node-level correspondence to the code API (ChartContainer + recharts composition)."
|
|
1242
|
+
},
|
|
1243
|
+
"whenToUse": [
|
|
1244
|
+
"Trends over time (Line), or trends emphasizing total volume underneath (Area)",
|
|
1245
|
+
"Comparing a few categories or rankings (Bar)",
|
|
1246
|
+
"Part-of-whole proportions with 5 or fewer categories (Pie)",
|
|
1247
|
+
"Multi-measure profiles of one or two items (Radar), or a single percentage/progress value as a circular tile (Radial Bar)"
|
|
1248
|
+
],
|
|
1249
|
+
"doNotUseFor": [
|
|
1250
|
+
"exact values users must read precisely (pair with or use Table/DataTable)",
|
|
1251
|
+
"part-of-whole with more than 5-6 categories (use Bar, not Pie)",
|
|
1252
|
+
"a simple horizontal progress indicator (use Progress, not Radial Bar)"
|
|
1253
|
+
]
|
|
719
1254
|
},
|
|
720
1255
|
{
|
|
721
1256
|
"name": "Checkbox",
|
|
@@ -740,8 +1275,10 @@
|
|
|
740
1275
|
"tick box"
|
|
741
1276
|
],
|
|
742
1277
|
"doNotUseFor": [
|
|
743
|
-
"on
|
|
744
|
-
"
|
|
1278
|
+
"turning a system feature or state on or off (use Switch)",
|
|
1279
|
+
"single-choice selection from a list (use RadioGroup)",
|
|
1280
|
+
"pressed-button toolbar controls (use Toggle)",
|
|
1281
|
+
"more than ~7 options (use Combobox multi-select)"
|
|
745
1282
|
],
|
|
746
1283
|
"replaces": [
|
|
747
1284
|
"native <input type='checkbox'>"
|
|
@@ -758,7 +1295,44 @@
|
|
|
758
1295
|
"keyboardInteraction": [
|
|
759
1296
|
"Space"
|
|
760
1297
|
]
|
|
761
|
-
}
|
|
1298
|
+
},
|
|
1299
|
+
"figma": {
|
|
1300
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1301
|
+
"nodes": [
|
|
1302
|
+
{
|
|
1303
|
+
"nodeId": "46:112",
|
|
1304
|
+
"figmaName": "Checkbox",
|
|
1305
|
+
"kind": "componentSet",
|
|
1306
|
+
"export": "Checkbox",
|
|
1307
|
+
"axes": [
|
|
1308
|
+
{
|
|
1309
|
+
"figma": "Status",
|
|
1310
|
+
"exempt": "interaction-state",
|
|
1311
|
+
"valueToProp": {
|
|
1312
|
+
"Active": "checked"
|
|
1313
|
+
},
|
|
1314
|
+
"note": "Status=Active doubles as the data-state=checked drawing — lifted to `checked`. No Indeterminate value drawn in Figma while code ships it (FIG-8)."
|
|
1315
|
+
},
|
|
1316
|
+
{
|
|
1317
|
+
"figma": "State",
|
|
1318
|
+
"exempt": "interaction-state",
|
|
1319
|
+
"valueToProp": {
|
|
1320
|
+
"Disabled": "disabled",
|
|
1321
|
+
"Error": "error"
|
|
1322
|
+
},
|
|
1323
|
+
"note": "'Error (Focus)' is a combination state — stays under the exempt axis"
|
|
1324
|
+
}
|
|
1325
|
+
]
|
|
1326
|
+
}
|
|
1327
|
+
],
|
|
1328
|
+
"unmappedExports": [],
|
|
1329
|
+
"figmaOnly": []
|
|
1330
|
+
},
|
|
1331
|
+
"whenToUse": [
|
|
1332
|
+
"A selection or single boolean choice in a form (terms acceptance)",
|
|
1333
|
+
"Picking multiple options where any combination is valid",
|
|
1334
|
+
"Selecting multiple table rows for bulk actions"
|
|
1335
|
+
]
|
|
762
1336
|
},
|
|
763
1337
|
{
|
|
764
1338
|
"name": "Chip",
|
|
@@ -789,13 +1363,14 @@
|
|
|
789
1363
|
},
|
|
790
1364
|
"description": "Removable chip/tag element",
|
|
791
1365
|
"whenToUse": [
|
|
792
|
-
"
|
|
793
|
-
"
|
|
794
|
-
"
|
|
1366
|
+
"Removable tags like selected filters or dismissible keywords",
|
|
1367
|
+
"Currently-selected filter values that can be removed individually",
|
|
1368
|
+
"A multi-select's chosen values as removable tokens"
|
|
795
1369
|
],
|
|
796
1370
|
"doNotUseFor": [
|
|
797
|
-
"non-
|
|
798
|
-
"
|
|
1371
|
+
"non-removable labels (use Badge)",
|
|
1372
|
+
"typing new values (use InputChip)",
|
|
1373
|
+
"mutually-exclusive selection (use ToggleGroup)"
|
|
799
1374
|
],
|
|
800
1375
|
"alternatives": [
|
|
801
1376
|
{
|
|
@@ -806,7 +1381,34 @@
|
|
|
806
1381
|
"component": "InputChip",
|
|
807
1382
|
"rule": "Use InputChip when users need to both add and remove tags via an input field"
|
|
808
1383
|
}
|
|
809
|
-
]
|
|
1384
|
+
],
|
|
1385
|
+
"figma": {
|
|
1386
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1387
|
+
"nodes": [
|
|
1388
|
+
{
|
|
1389
|
+
"nodeId": "25019:19",
|
|
1390
|
+
"figmaName": "Chip",
|
|
1391
|
+
"kind": "componentSet",
|
|
1392
|
+
"export": "Chip",
|
|
1393
|
+
"axes": [
|
|
1394
|
+
{
|
|
1395
|
+
"figma": "Size",
|
|
1396
|
+
"code": "size"
|
|
1397
|
+
},
|
|
1398
|
+
{
|
|
1399
|
+
"figma": "State",
|
|
1400
|
+
"exempt": "interaction-state",
|
|
1401
|
+
"valueToProp": {
|
|
1402
|
+
"Disabled": "disabled",
|
|
1403
|
+
"Loading": "loading"
|
|
1404
|
+
}
|
|
1405
|
+
}
|
|
1406
|
+
]
|
|
1407
|
+
}
|
|
1408
|
+
],
|
|
1409
|
+
"unmappedExports": [],
|
|
1410
|
+
"figmaOnly": []
|
|
1411
|
+
}
|
|
810
1412
|
},
|
|
811
1413
|
{
|
|
812
1414
|
"name": "Collapsible",
|
|
@@ -826,7 +1428,22 @@
|
|
|
826
1428
|
"defaultOpen",
|
|
827
1429
|
"disabled"
|
|
828
1430
|
],
|
|
829
|
-
"description": "Collapsible content sections"
|
|
1431
|
+
"description": "Collapsible content sections",
|
|
1432
|
+
"figma": {
|
|
1433
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1434
|
+
"status": "code-only",
|
|
1435
|
+
"reason": "Behavioral show/hide primitive with no intrinsic appearance — Figma draws expand/collapse states inside the consuming components (Sidebar, Accordion). Verified 2026-08-18: no standalone node."
|
|
1436
|
+
},
|
|
1437
|
+
"whenToUse": [
|
|
1438
|
+
"Showing or hiding one single block of extra content ('Show more', advanced options)",
|
|
1439
|
+
"Reducing clutter for content most users won't need, kept one click away",
|
|
1440
|
+
"Simple expand/collapse with no multiple independently-tracked sections"
|
|
1441
|
+
],
|
|
1442
|
+
"doNotUseFor": [
|
|
1443
|
+
"several related sections with one open at a time (use Accordion)",
|
|
1444
|
+
"content that should always be visible",
|
|
1445
|
+
"primary navigation or tabbed switching (use Tabs)"
|
|
1446
|
+
]
|
|
830
1447
|
},
|
|
831
1448
|
{
|
|
832
1449
|
"name": "Combobox",
|
|
@@ -858,14 +1475,15 @@
|
|
|
858
1475
|
"shouldFilter",
|
|
859
1476
|
"side",
|
|
860
1477
|
"sideOffset",
|
|
861
|
-
"avoidCollisions"
|
|
1478
|
+
"avoidCollisions",
|
|
1479
|
+
"error"
|
|
862
1480
|
],
|
|
863
1481
|
"i18nProps": {
|
|
864
1482
|
"ComboboxContent": {
|
|
865
1483
|
"ariaLabel": "string — default: \"Options\""
|
|
866
1484
|
},
|
|
867
1485
|
"ComboboxLoading": {
|
|
868
|
-
"loadingText": "string — default: \"Loading
|
|
1486
|
+
"loadingText": "string — default: \"Loading suggestions\" (visually hidden — announced to screen readers only)"
|
|
869
1487
|
}
|
|
870
1488
|
},
|
|
871
1489
|
"description": "Searchable select dropdown with filtering",
|
|
@@ -876,13 +1494,15 @@
|
|
|
876
1494
|
"filterable dropdown"
|
|
877
1495
|
],
|
|
878
1496
|
"whenToUse": [
|
|
879
|
-
"
|
|
880
|
-
"
|
|
881
|
-
"
|
|
1497
|
+
"Picking one item from a long, searchable list (city, category, customer)",
|
|
1498
|
+
"Filtering options by typing, with autocomplete-style suggestions",
|
|
1499
|
+
"Async data loaded from a server as the user types",
|
|
1500
|
+
"Multi-select mode for picking several items shown as removable tags"
|
|
882
1501
|
],
|
|
883
1502
|
"doNotUseFor": [
|
|
884
|
-
"
|
|
885
|
-
"
|
|
1503
|
+
"short lists under 10 items (use Select)",
|
|
1504
|
+
"free-text values not on the list (use InputChip)",
|
|
1505
|
+
"options that should all be visible for comparison (use RadioGroup or ToggleGroup)"
|
|
886
1506
|
],
|
|
887
1507
|
"alternatives": [
|
|
888
1508
|
{
|
|
@@ -919,6 +1539,123 @@
|
|
|
919
1539
|
"Enter",
|
|
920
1540
|
"Escape"
|
|
921
1541
|
]
|
|
1542
|
+
},
|
|
1543
|
+
"figma": {
|
|
1544
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1545
|
+
"nodes": [
|
|
1546
|
+
{
|
|
1547
|
+
"nodeId": "430:4114",
|
|
1548
|
+
"figmaName": "Combobox",
|
|
1549
|
+
"kind": "componentSet",
|
|
1550
|
+
"export": "Combobox",
|
|
1551
|
+
"note": "Draws the closed field with label/description scaffolding",
|
|
1552
|
+
"axes": [
|
|
1553
|
+
{
|
|
1554
|
+
"figma": "Type",
|
|
1555
|
+
"exempt": "figma-only-style",
|
|
1556
|
+
"note": "With/Without Group Label is menu composition — ComboboxGroup children in code"
|
|
1557
|
+
},
|
|
1558
|
+
{
|
|
1559
|
+
"figma": "State",
|
|
1560
|
+
"exempt": "interaction-state",
|
|
1561
|
+
"valueToProp": {
|
|
1562
|
+
"Disabled": "disabled",
|
|
1563
|
+
"Error": "error"
|
|
1564
|
+
}
|
|
1565
|
+
}
|
|
1566
|
+
]
|
|
1567
|
+
},
|
|
1568
|
+
{
|
|
1569
|
+
"nodeId": "25433:4597",
|
|
1570
|
+
"figmaName": "Combobox / Input",
|
|
1571
|
+
"kind": "componentSet",
|
|
1572
|
+
"export": "ComboboxInput",
|
|
1573
|
+
"axes": [
|
|
1574
|
+
{
|
|
1575
|
+
"figma": "State",
|
|
1576
|
+
"exempt": "interaction-state",
|
|
1577
|
+
"note": "Filled = has-value runtime state"
|
|
1578
|
+
}
|
|
1579
|
+
]
|
|
1580
|
+
},
|
|
1581
|
+
{
|
|
1582
|
+
"nodeId": "17379:199232",
|
|
1583
|
+
"figmaName": "Combobox / Menu Item",
|
|
1584
|
+
"kind": "componentSet",
|
|
1585
|
+
"export": "ComboboxItem",
|
|
1586
|
+
"axes": [
|
|
1587
|
+
{
|
|
1588
|
+
"figma": "Type",
|
|
1589
|
+
"exempt": "figma-only-style",
|
|
1590
|
+
"note": "Simple|Icon|Avatar are content-slot compositions; Checkbox has no code counterpart — single-select (FIG-10)"
|
|
1591
|
+
},
|
|
1592
|
+
{
|
|
1593
|
+
"figma": "State",
|
|
1594
|
+
"exempt": "interaction-state"
|
|
1595
|
+
}
|
|
1596
|
+
]
|
|
1597
|
+
}
|
|
1598
|
+
],
|
|
1599
|
+
"unmappedExports": [
|
|
1600
|
+
{
|
|
1601
|
+
"export": "ComboboxTrigger",
|
|
1602
|
+
"reason": "Drawn inside the Combobox set — the closed field IS the trigger"
|
|
1603
|
+
},
|
|
1604
|
+
{
|
|
1605
|
+
"export": "ComboboxContent",
|
|
1606
|
+
"reason": "Composed in Figma inside the Command Menu demos (see figmaOnly)"
|
|
1607
|
+
},
|
|
1608
|
+
{
|
|
1609
|
+
"export": "ComboboxList",
|
|
1610
|
+
"reason": "Structural scroll container, no standalone Figma representation"
|
|
1611
|
+
},
|
|
1612
|
+
{
|
|
1613
|
+
"export": "ComboboxVirtualList",
|
|
1614
|
+
"reason": "Behavioral (virtualization) — visually identical to ComboboxList"
|
|
1615
|
+
},
|
|
1616
|
+
{
|
|
1617
|
+
"export": "ComboboxEmpty",
|
|
1618
|
+
"reason": "No Figma representation found (2026-08-18)"
|
|
1619
|
+
},
|
|
1620
|
+
{
|
|
1621
|
+
"export": "ComboboxGroup",
|
|
1622
|
+
"reason": "Represented as the 'Group Label' TEXT prop / Type axis on the Combobox set"
|
|
1623
|
+
},
|
|
1624
|
+
{
|
|
1625
|
+
"export": "ComboboxSeparator",
|
|
1626
|
+
"reason": "No Figma representation found (2026-08-18)"
|
|
1627
|
+
},
|
|
1628
|
+
{
|
|
1629
|
+
"export": "ComboboxValue",
|
|
1630
|
+
"reason": "Represented as placeholder/value text inside the Combobox set"
|
|
1631
|
+
},
|
|
1632
|
+
{
|
|
1633
|
+
"export": "ComboboxLoading",
|
|
1634
|
+
"reason": "No Figma representation found (2026-08-18)"
|
|
1635
|
+
}
|
|
1636
|
+
],
|
|
1637
|
+
"figmaOnly": [
|
|
1638
|
+
{
|
|
1639
|
+
"nodeId": "17379:199778",
|
|
1640
|
+
"figmaName": "Combobox / Command Menu - Simple",
|
|
1641
|
+
"reason": "Assembled menu demo"
|
|
1642
|
+
},
|
|
1643
|
+
{
|
|
1644
|
+
"nodeId": "17379:199775",
|
|
1645
|
+
"figmaName": "Combobox / Command Menu - Groups",
|
|
1646
|
+
"reason": "Assembled menu demo"
|
|
1647
|
+
},
|
|
1648
|
+
{
|
|
1649
|
+
"nodeId": "17379:199776",
|
|
1650
|
+
"figmaName": "Combobox / Command Menu - Avatars",
|
|
1651
|
+
"reason": "Assembled menu demo"
|
|
1652
|
+
},
|
|
1653
|
+
{
|
|
1654
|
+
"nodeId": "17379:199777",
|
|
1655
|
+
"figmaName": "Combobox / Command Menu - Multiselect",
|
|
1656
|
+
"reason": "Assembled menu demo (multi-select — FIG-10)"
|
|
1657
|
+
}
|
|
1658
|
+
]
|
|
922
1659
|
}
|
|
923
1660
|
},
|
|
924
1661
|
{
|
|
@@ -952,53 +1689,248 @@
|
|
|
952
1689
|
"clearSearchAriaLabel": "string — default: \"Clear search\""
|
|
953
1690
|
}
|
|
954
1691
|
},
|
|
955
|
-
"description": "Command palette and search interface"
|
|
956
|
-
|
|
957
|
-
|
|
958
|
-
|
|
959
|
-
|
|
960
|
-
|
|
961
|
-
|
|
962
|
-
|
|
963
|
-
|
|
964
|
-
|
|
965
|
-
|
|
966
|
-
|
|
967
|
-
|
|
968
|
-
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
976
|
-
|
|
977
|
-
|
|
978
|
-
|
|
979
|
-
|
|
980
|
-
|
|
981
|
-
|
|
982
|
-
|
|
983
|
-
|
|
984
|
-
|
|
985
|
-
|
|
986
|
-
|
|
987
|
-
|
|
988
|
-
|
|
989
|
-
|
|
990
|
-
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
998
|
-
|
|
999
|
-
|
|
1000
|
-
|
|
1001
|
-
|
|
1692
|
+
"description": "Command palette and search interface",
|
|
1693
|
+
"figma": {
|
|
1694
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1695
|
+
"nodes": [
|
|
1696
|
+
{
|
|
1697
|
+
"nodeId": "204:1144",
|
|
1698
|
+
"figmaName": "Command",
|
|
1699
|
+
"kind": "componentSet",
|
|
1700
|
+
"export": "Command",
|
|
1701
|
+
"note": "Item 1–9 INSTANCE_SWAP/BOOLEAN props are composition slots",
|
|
1702
|
+
"axes": [
|
|
1703
|
+
{
|
|
1704
|
+
"figma": "Variant",
|
|
1705
|
+
"exempt": "export-discriminator",
|
|
1706
|
+
"note": "Suggestions/Empty selects between the populated menu and the CommandEmpty state"
|
|
1707
|
+
}
|
|
1708
|
+
]
|
|
1709
|
+
},
|
|
1710
|
+
{
|
|
1711
|
+
"nodeId": "260:4100",
|
|
1712
|
+
"figmaName": "Command / Input",
|
|
1713
|
+
"kind": "componentSet",
|
|
1714
|
+
"export": "CommandInput",
|
|
1715
|
+
"axes": [
|
|
1716
|
+
{
|
|
1717
|
+
"figma": "State",
|
|
1718
|
+
"exempt": "interaction-state",
|
|
1719
|
+
"valueToProp": {
|
|
1720
|
+
"Disabled": "disabled"
|
|
1721
|
+
}
|
|
1722
|
+
}
|
|
1723
|
+
]
|
|
1724
|
+
},
|
|
1725
|
+
{
|
|
1726
|
+
"nodeId": "345:8657",
|
|
1727
|
+
"figmaName": "Command / Item / Default",
|
|
1728
|
+
"kind": "componentSet",
|
|
1729
|
+
"export": "CommandItem",
|
|
1730
|
+
"axes": [
|
|
1731
|
+
{
|
|
1732
|
+
"figma": "Variant",
|
|
1733
|
+
"exempt": "figma-only-style",
|
|
1734
|
+
"note": "Default|Icon is icon-slot composition (children in code)"
|
|
1735
|
+
},
|
|
1736
|
+
{
|
|
1737
|
+
"figma": "State",
|
|
1738
|
+
"exempt": "interaction-state",
|
|
1739
|
+
"valueToProp": {
|
|
1740
|
+
"Disabled": "disabled"
|
|
1741
|
+
}
|
|
1742
|
+
},
|
|
1743
|
+
{
|
|
1744
|
+
"figma": "Selected",
|
|
1745
|
+
"exempt": "interaction-state",
|
|
1746
|
+
"note": "aria-selected runtime state"
|
|
1747
|
+
}
|
|
1748
|
+
]
|
|
1749
|
+
},
|
|
1750
|
+
{
|
|
1751
|
+
"nodeId": "345:8658",
|
|
1752
|
+
"figmaName": "Command / Input/Command/Menu Heading",
|
|
1753
|
+
"kind": "component",
|
|
1754
|
+
"export": "CommandGroup",
|
|
1755
|
+
"note": "Draws the group heading; the group itself is structural"
|
|
1756
|
+
},
|
|
1757
|
+
{
|
|
1758
|
+
"nodeId": "345:8826",
|
|
1759
|
+
"figmaName": "Command / Input/Command/Item/Separator",
|
|
1760
|
+
"kind": "component",
|
|
1761
|
+
"export": "CommandSeparator"
|
|
1762
|
+
}
|
|
1763
|
+
],
|
|
1764
|
+
"unmappedExports": [
|
|
1765
|
+
{
|
|
1766
|
+
"export": "CommandEmpty",
|
|
1767
|
+
"reason": "Drawn as the Command set's 'Variant=Empty' child (export-discriminator axis)"
|
|
1768
|
+
},
|
|
1769
|
+
{
|
|
1770
|
+
"export": "CommandList",
|
|
1771
|
+
"reason": "Structural scroll container, no standalone Figma representation"
|
|
1772
|
+
},
|
|
1773
|
+
{
|
|
1774
|
+
"export": "CommandShortcut",
|
|
1775
|
+
"reason": "Represented as 'Shortcut Text' TEXT prop on the Item set"
|
|
1776
|
+
},
|
|
1777
|
+
{
|
|
1778
|
+
"export": "CommandVirtualItem",
|
|
1779
|
+
"reason": "Behavioral (virtualization) — visually identical to CommandItem"
|
|
1780
|
+
},
|
|
1781
|
+
{
|
|
1782
|
+
"export": "CommandVirtualList",
|
|
1783
|
+
"reason": "Behavioral (virtualization) — visually identical to CommandList"
|
|
1784
|
+
}
|
|
1785
|
+
],
|
|
1786
|
+
"figmaOnly": []
|
|
1787
|
+
},
|
|
1788
|
+
"whenToUse": [
|
|
1789
|
+
"Searchable command palettes (Cmd+K) for jumping to pages or running actions",
|
|
1790
|
+
"Power-user workflows where keyboard-first navigation speeds up common tasks",
|
|
1791
|
+
"Aggregating actions and destinations from across the app into one searchable list"
|
|
1792
|
+
],
|
|
1793
|
+
"doNotUseFor": [
|
|
1794
|
+
"a simple dropdown of a few options (use Select or DropdownMenu)",
|
|
1795
|
+
"filtering rows inside a data table (use its own search field)",
|
|
1796
|
+
"small item sets where a full palette is overkill (use Combobox)"
|
|
1797
|
+
]
|
|
1798
|
+
},
|
|
1799
|
+
{
|
|
1800
|
+
"name": "ContextMenu",
|
|
1801
|
+
"import": "@brightlocal/ui-components/context-menu",
|
|
1802
|
+
"category": "navigation",
|
|
1803
|
+
"exports": [
|
|
1804
|
+
"ContextMenu",
|
|
1805
|
+
"ContextMenuTrigger",
|
|
1806
|
+
"ContextMenuContent",
|
|
1807
|
+
"ContextMenuItem",
|
|
1808
|
+
"ContextMenuCheckboxItem",
|
|
1809
|
+
"ContextMenuRadioGroup",
|
|
1810
|
+
"ContextMenuLabel",
|
|
1811
|
+
"ContextMenuSeparator",
|
|
1812
|
+
"ContextMenuShortcut",
|
|
1813
|
+
"ContextMenuSub"
|
|
1814
|
+
],
|
|
1815
|
+
"compound": true,
|
|
1816
|
+
"dataHookRequired": false,
|
|
1817
|
+
"variants": {},
|
|
1818
|
+
"props": [],
|
|
1819
|
+
"description": "Right-click context menu",
|
|
1820
|
+
"figma": {
|
|
1821
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
1822
|
+
"nodes": [
|
|
1823
|
+
{
|
|
1824
|
+
"nodeId": "249:5013",
|
|
1825
|
+
"figmaName": "ContextMenu",
|
|
1826
|
+
"kind": "component",
|
|
1827
|
+
"export": "ContextMenu",
|
|
1828
|
+
"note": "Figma node is a demo composition (DropdownMenu precedent)"
|
|
1829
|
+
},
|
|
1830
|
+
{
|
|
1831
|
+
"nodeId": "419:4521",
|
|
1832
|
+
"figmaName": "ContextMenu / Item / Default",
|
|
1833
|
+
"kind": "componentSet",
|
|
1834
|
+
"export": "ContextMenuItem",
|
|
1835
|
+
"alsoRepresents": [
|
|
1836
|
+
"ContextMenuCheckboxItem",
|
|
1837
|
+
"ContextMenuRadioGroup"
|
|
1838
|
+
],
|
|
1839
|
+
"axes": [
|
|
1840
|
+
{
|
|
1841
|
+
"figma": "Variant",
|
|
1842
|
+
"exempt": "export-discriminator",
|
|
1843
|
+
"note": "Default/Checkbox/Radio select between ContextMenuItem, ContextMenuCheckboxItem and ContextMenuRadioGroup"
|
|
1844
|
+
},
|
|
1845
|
+
{
|
|
1846
|
+
"figma": "Level",
|
|
1847
|
+
"exempt": "figma-only-style",
|
|
1848
|
+
"note": "Level 1/2 has no code counterpart (CODE-4 class)"
|
|
1849
|
+
},
|
|
1850
|
+
{
|
|
1851
|
+
"figma": "State",
|
|
1852
|
+
"exempt": "interaction-state",
|
|
1853
|
+
"valueToProp": {
|
|
1854
|
+
"Disabled": "disabled"
|
|
1855
|
+
}
|
|
1856
|
+
}
|
|
1857
|
+
]
|
|
1858
|
+
},
|
|
1859
|
+
{
|
|
1860
|
+
"nodeId": "419:4517",
|
|
1861
|
+
"figmaName": "ContextMenu / Item / Title",
|
|
1862
|
+
"kind": "component",
|
|
1863
|
+
"export": "ContextMenuLabel"
|
|
1864
|
+
},
|
|
1865
|
+
{
|
|
1866
|
+
"nodeId": "249:5008",
|
|
1867
|
+
"figmaName": "ContextMenu / Item / Separator",
|
|
1868
|
+
"kind": "component",
|
|
1869
|
+
"export": "ContextMenuSeparator"
|
|
1870
|
+
}
|
|
1871
|
+
],
|
|
1872
|
+
"unmappedExports": [
|
|
1873
|
+
{
|
|
1874
|
+
"export": "ContextMenuTrigger",
|
|
1875
|
+
"reason": "Unstyled right-click area — the consumer's element is the trigger"
|
|
1876
|
+
},
|
|
1877
|
+
{
|
|
1878
|
+
"export": "ContextMenuContent",
|
|
1879
|
+
"reason": "Composed in Figma inside the ContextMenu demo node"
|
|
1880
|
+
},
|
|
1881
|
+
{
|
|
1882
|
+
"export": "ContextMenuShortcut",
|
|
1883
|
+
"reason": "Represented as shortcut text inside the Item set variants"
|
|
1884
|
+
},
|
|
1885
|
+
{
|
|
1886
|
+
"export": "ContextMenuSub",
|
|
1887
|
+
"reason": "Structural wrapper with no visual representation in Figma"
|
|
1888
|
+
}
|
|
1889
|
+
],
|
|
1890
|
+
"figmaOnly": [
|
|
1891
|
+
{
|
|
1892
|
+
"nodeId": "419:4534",
|
|
1893
|
+
"figmaName": "ContextMenu / Item / SubTrigger",
|
|
1894
|
+
"reason": "Sub-trigger row drawn in Figma but code exports no ContextMenuSubTrigger (only structural ContextMenuSub) — CODE-16"
|
|
1895
|
+
}
|
|
1896
|
+
]
|
|
1897
|
+
},
|
|
1898
|
+
"whenToUse": [
|
|
1899
|
+
"Right-click menus with actions for the specific item clicked (table row, file)",
|
|
1900
|
+
"Power-user or desktop-oriented workflows where right-click is expected",
|
|
1901
|
+
"Actions that differ depending on exactly which item was clicked"
|
|
1902
|
+
],
|
|
1903
|
+
"doNotUseFor": [
|
|
1904
|
+
"menus opened from a visible button (use DropdownMenu)",
|
|
1905
|
+
"touch/mobile-first interfaces (right-click has no mobile equivalent)",
|
|
1906
|
+
"global page-level actions (use DropdownMenu)"
|
|
1907
|
+
]
|
|
1908
|
+
},
|
|
1909
|
+
{
|
|
1910
|
+
"name": "DataTable",
|
|
1911
|
+
"import": "@brightlocal/ui-components/data-table",
|
|
1912
|
+
"category": "display",
|
|
1913
|
+
"exports": [
|
|
1914
|
+
"DataTable",
|
|
1915
|
+
"DataTableBulkActions",
|
|
1916
|
+
"DataTableBulkActionsActions",
|
|
1917
|
+
"DataTableBulkActionsSummary",
|
|
1918
|
+
"DataTableColumnHeader",
|
|
1919
|
+
"DataTableExpandRowButton",
|
|
1920
|
+
"DataTableExpandedSkeleton",
|
|
1921
|
+
"DataTablePagination",
|
|
1922
|
+
"DataTablePaginationNav",
|
|
1923
|
+
"DataTablePaginationRowCount",
|
|
1924
|
+
"DataTableSearch",
|
|
1925
|
+
"DataTableSelectAllCheckbox",
|
|
1926
|
+
"DataTableSelectRowCheckbox",
|
|
1927
|
+
"DataTableToolbar",
|
|
1928
|
+
"DataTableToolbarLeft",
|
|
1929
|
+
"DataTableToolbarRight",
|
|
1930
|
+
"VirtualizedDataTable",
|
|
1931
|
+
"useDataTable",
|
|
1932
|
+
"useDataTableBulkActionsContext"
|
|
1933
|
+
],
|
|
1002
1934
|
"compound": true,
|
|
1003
1935
|
"dataHookRequired": true,
|
|
1004
1936
|
"variants": {},
|
|
@@ -1010,6 +1942,13 @@
|
|
|
1010
1942
|
"enableRowSelection",
|
|
1011
1943
|
"enablePagination",
|
|
1012
1944
|
"pageSize",
|
|
1945
|
+
"enableExpanding",
|
|
1946
|
+
"getSubRows",
|
|
1947
|
+
"getRowCanExpand",
|
|
1948
|
+
"paginateExpandedRows",
|
|
1949
|
+
"getRowId",
|
|
1950
|
+
"getRowClassName",
|
|
1951
|
+
"renderExpandedContent",
|
|
1013
1952
|
"isLoading",
|
|
1014
1953
|
"skeletonRowCount",
|
|
1015
1954
|
"noResultsMessage",
|
|
@@ -1049,11 +1988,34 @@
|
|
|
1049
1988
|
"DataTableSelectRowCheckbox": {
|
|
1050
1989
|
"selectRowAriaLabel": "string — default: \"Select row\""
|
|
1051
1990
|
},
|
|
1991
|
+
"DataTableExpandRowButton": {
|
|
1992
|
+
"expandLabel": "string — supports {name} placeholder — default: \"Expand details for {name}\" when rowName is set, \"Expand row\" otherwise",
|
|
1993
|
+
"collapseLabel": "string — supports {name} placeholder — default: \"Collapse details for {name}\" when rowName is set, \"Collapse row\" otherwise"
|
|
1994
|
+
},
|
|
1995
|
+
"DataTableExpandedSkeleton": {
|
|
1996
|
+
"loadingLabel": "string — default: \"Loading details\""
|
|
1997
|
+
},
|
|
1052
1998
|
"DataTableBulkActionsSummary": {
|
|
1053
1999
|
"children": "React.ReactNode | ((info: { selectedCount: number; totalCount: number }) => React.ReactNode) — default: \"{selectedCount} of {totalCount} row(s) selected.\""
|
|
1054
2000
|
}
|
|
1055
2001
|
},
|
|
1056
|
-
"description": "Composable data table built on TanStack Table. Exposes `useDataTable` hook + `DataTable` / `VirtualizedDataTable` renderers + toolbar layout + pagination and search helpers. Compose the table and its companions (DataTableToolbar rows, bulk actions) as ONE slot — a single flex-column wrapper — inside gapped parents like DialogContent or Card, so the parent's gap applies around the table block, not between the toolbars and the table; the toolbars' built-in padding provides the internal spacing."
|
|
2002
|
+
"description": "Composable data table built on TanStack Table. Exposes `useDataTable` hook + `DataTable` / `VirtualizedDataTable` renderers + toolbar layout + pagination and search helpers. Compose the table and its companions (DataTableToolbar rows, bulk actions) as ONE slot — a single flex-column wrapper — inside gapped parents like DialogContent or Card, so the parent's gap applies around the table block, not between the toolbars and the table; the toolbars' built-in padding provides the internal spacing.",
|
|
2003
|
+
"figma": {
|
|
2004
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2005
|
+
"status": "code-only",
|
|
2006
|
+
"reason": "Structurally unmappable (DS-824 verdict): the block is config-driven (columns/data props); Figma's Data Table 327:695 + Table Head/Cell sets draw examples, not the API. The underlying Table component IS mapped."
|
|
2007
|
+
},
|
|
2008
|
+
"whenToUse": [
|
|
2009
|
+
"Tables with sorting, filtering, or row selection for everyday amounts of data",
|
|
2010
|
+
"Admin panels, dashboards, and customer lists where users search or act on rows",
|
|
2011
|
+
"Lists needing bulk actions (delete, export, assign) across selected rows",
|
|
2012
|
+
"Very large tables (1,000+ rows) via VirtualizedDataTable, which renders only visible rows"
|
|
2013
|
+
],
|
|
2014
|
+
"doNotUseFor": [
|
|
2015
|
+
"simple read-only data with no sorting/filtering (use Table)",
|
|
2016
|
+
"1,000+ rows with the standard renderer (use VirtualizedDataTable)",
|
|
2017
|
+
"simple visual lists of items with icons and actions (use List)"
|
|
2018
|
+
]
|
|
1057
2019
|
},
|
|
1058
2020
|
{
|
|
1059
2021
|
"name": "DatePicker",
|
|
@@ -1090,7 +2052,76 @@
|
|
|
1090
2052
|
"contentLabel": "string — default: \"Date picker\""
|
|
1091
2053
|
}
|
|
1092
2054
|
},
|
|
1093
|
-
"description": "Date selection with calendar popup and presets"
|
|
2055
|
+
"description": "Date selection with calendar popup and presets",
|
|
2056
|
+
"figma": {
|
|
2057
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2058
|
+
"nodes": [
|
|
2059
|
+
{
|
|
2060
|
+
"nodeId": "334:4051",
|
|
2061
|
+
"figmaName": "Date Picker",
|
|
2062
|
+
"kind": "componentSet",
|
|
2063
|
+
"export": "DatePickerRoot",
|
|
2064
|
+
"note": "Draws the closed field with label/description scaffolding. Code's `mode` variant (single|range) has no axis here — the range panel is drawn as the separate 'Date Picker / Range' set (see figmaOnly).",
|
|
2065
|
+
"axes": [
|
|
2066
|
+
{
|
|
2067
|
+
"figma": "State",
|
|
2068
|
+
"exempt": "interaction-state",
|
|
2069
|
+
"valueToProp": {
|
|
2070
|
+
"Disabled": "disabled"
|
|
2071
|
+
}
|
|
2072
|
+
},
|
|
2073
|
+
{
|
|
2074
|
+
"figma": "Active",
|
|
2075
|
+
"exempt": "interaction-state",
|
|
2076
|
+
"note": "Popover open state"
|
|
2077
|
+
}
|
|
2078
|
+
]
|
|
2079
|
+
},
|
|
2080
|
+
{
|
|
2081
|
+
"nodeId": "344:4122",
|
|
2082
|
+
"figmaName": "Date Picker / Preset",
|
|
2083
|
+
"kind": "component",
|
|
2084
|
+
"export": "DatePickerPresets"
|
|
2085
|
+
}
|
|
2086
|
+
],
|
|
2087
|
+
"unmappedExports": [
|
|
2088
|
+
{
|
|
2089
|
+
"export": "DatePickerTrigger",
|
|
2090
|
+
"reason": "Drawn inside the Date Picker set — the closed field IS the trigger"
|
|
2091
|
+
},
|
|
2092
|
+
{
|
|
2093
|
+
"export": "DatePickerContent",
|
|
2094
|
+
"reason": "The open panel is composed in Figma from Calendar/Preset instances, not a standalone component"
|
|
2095
|
+
},
|
|
2096
|
+
{
|
|
2097
|
+
"export": "DatePickerCalendar",
|
|
2098
|
+
"reason": "An instance of the Calendar component inside the panel (Calendar is mapped separately)"
|
|
2099
|
+
}
|
|
2100
|
+
],
|
|
2101
|
+
"figmaOnly": [
|
|
2102
|
+
{
|
|
2103
|
+
"nodeId": "247:3751",
|
|
2104
|
+
"figmaName": "Date Picker / Range",
|
|
2105
|
+
"reason": "Range-mode panel drawn as a separate set (code expresses mode=range on DatePickerRoot); its Size md|sm axis is Figma-only"
|
|
2106
|
+
},
|
|
2107
|
+
{
|
|
2108
|
+
"nodeId": "244:3640",
|
|
2109
|
+
"figmaName": "Date Picker / Day Button",
|
|
2110
|
+
"reason": "Internal day-cell part — no code export"
|
|
2111
|
+
}
|
|
2112
|
+
]
|
|
2113
|
+
},
|
|
2114
|
+
"whenToUse": [
|
|
2115
|
+
"Picking one specific date (due date, birthday, appointment)",
|
|
2116
|
+
"Picking a start and end date together in range mode (reporting period, booking window)",
|
|
2117
|
+
"Quick presets like \"Last 7 days\" alongside the calendar",
|
|
2118
|
+
"Compact form field that opens a calendar only when clicked"
|
|
2119
|
+
],
|
|
2120
|
+
"doNotUseFor": [
|
|
2121
|
+
"an always-visible calendar on the page (use Calendar)",
|
|
2122
|
+
"picking a time of day (dates only; add a separate time field)",
|
|
2123
|
+
"fixed predefined ranges only (plain preset buttons are faster)"
|
|
2124
|
+
]
|
|
1094
2125
|
},
|
|
1095
2126
|
{
|
|
1096
2127
|
"name": "Description",
|
|
@@ -1103,7 +2134,22 @@
|
|
|
1103
2134
|
"dataHookRequired": false,
|
|
1104
2135
|
"variants": {},
|
|
1105
2136
|
"props": [],
|
|
1106
|
-
"description": "Helper/description text"
|
|
2137
|
+
"description": "Helper/description text",
|
|
2138
|
+
"figma": {
|
|
2139
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2140
|
+
"status": "represented-inline",
|
|
2141
|
+
"reason": "No standalone Figma component — field descriptions are drawn as 'Description Text'/'Show Description' props inside every field set. Verified 2026-08-18."
|
|
2142
|
+
},
|
|
2143
|
+
"whenToUse": [
|
|
2144
|
+
"Muted helper text, hints, captions, or legal disclaimers with links",
|
|
2145
|
+
"General help text needing secondary-style typography",
|
|
2146
|
+
"Context beneath a heading or setting"
|
|
2147
|
+
],
|
|
2148
|
+
"doNotUseFor": [
|
|
2149
|
+
"form field descriptions (use Field's built-in description)",
|
|
2150
|
+
"heading or body-copy weight text (use Typography)",
|
|
2151
|
+
"validation errors (use Field's error text)"
|
|
2152
|
+
]
|
|
1107
2153
|
},
|
|
1108
2154
|
{
|
|
1109
2155
|
"name": "Dialog",
|
|
@@ -1141,13 +2187,15 @@
|
|
|
1141
2187
|
"lightbox"
|
|
1142
2188
|
],
|
|
1143
2189
|
"whenToUse": [
|
|
1144
|
-
"
|
|
1145
|
-
"
|
|
1146
|
-
"
|
|
2190
|
+
"Forms or content needing full attention, blocking the rest of the page",
|
|
2191
|
+
"Multi-step content that doesn't fit naturally inline",
|
|
2192
|
+
"Distinct modal tasks rather than lightweight asides"
|
|
1147
2193
|
],
|
|
1148
2194
|
"doNotUseFor": [
|
|
1149
|
-
"
|
|
1150
|
-
"side panels (use Sheet or Drawer)"
|
|
2195
|
+
"destructive-action confirmations (use AlertDialog)",
|
|
2196
|
+
"side panels (use Sheet or Drawer)",
|
|
2197
|
+
"lightweight asides tied to a small trigger (use Popover)",
|
|
2198
|
+
"dialogs opened from within dialogs (restructure as one Dialog or a Stepper)"
|
|
1151
2199
|
],
|
|
1152
2200
|
"alternatives": [
|
|
1153
2201
|
{
|
|
@@ -1177,41 +2225,110 @@
|
|
|
1177
2225
|
"Escape",
|
|
1178
2226
|
"Tab"
|
|
1179
2227
|
]
|
|
1180
|
-
}
|
|
1181
|
-
|
|
1182
|
-
|
|
1183
|
-
|
|
1184
|
-
|
|
1185
|
-
|
|
1186
|
-
|
|
1187
|
-
|
|
1188
|
-
|
|
1189
|
-
|
|
1190
|
-
|
|
1191
|
-
|
|
1192
|
-
|
|
1193
|
-
|
|
1194
|
-
|
|
1195
|
-
|
|
1196
|
-
|
|
1197
|
-
|
|
1198
|
-
|
|
1199
|
-
|
|
1200
|
-
|
|
1201
|
-
|
|
1202
|
-
|
|
1203
|
-
|
|
1204
|
-
|
|
1205
|
-
|
|
1206
|
-
|
|
1207
|
-
|
|
1208
|
-
|
|
1209
|
-
|
|
1210
|
-
|
|
1211
|
-
|
|
2228
|
+
},
|
|
2229
|
+
"figma": {
|
|
2230
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2231
|
+
"nodes": [
|
|
2232
|
+
{
|
|
2233
|
+
"nodeId": "112:602",
|
|
2234
|
+
"figmaName": "Dialog",
|
|
2235
|
+
"kind": "componentSet",
|
|
2236
|
+
"export": "Dialog",
|
|
2237
|
+
"note": "Draws the assembled dialog; all sub-parts are drawn inside",
|
|
2238
|
+
"axes": [
|
|
2239
|
+
{
|
|
2240
|
+
"figma": "Breakpoint",
|
|
2241
|
+
"exempt": "figma-only-style",
|
|
2242
|
+
"note": "Responsive breakpoint drawings — sizing is runtime in code"
|
|
2243
|
+
}
|
|
2244
|
+
]
|
|
2245
|
+
}
|
|
2246
|
+
],
|
|
2247
|
+
"unmappedExports": [
|
|
2248
|
+
{
|
|
2249
|
+
"export": "DialogTrigger",
|
|
2250
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
2251
|
+
},
|
|
2252
|
+
{
|
|
2253
|
+
"export": "DialogPortal",
|
|
2254
|
+
"reason": "Non-rendering portal wrapper"
|
|
2255
|
+
},
|
|
2256
|
+
{
|
|
2257
|
+
"export": "DialogClose",
|
|
2258
|
+
"reason": "Drawn inside the set (the close icon; see also figmaOnly Dialog / Close Icon)"
|
|
2259
|
+
},
|
|
2260
|
+
{
|
|
2261
|
+
"export": "DialogOverlay",
|
|
2262
|
+
"reason": "Backdrop layer, drawn implicitly behind the panel"
|
|
2263
|
+
},
|
|
2264
|
+
{
|
|
2265
|
+
"export": "DialogContent",
|
|
2266
|
+
"reason": "Drawn by the Dialog set (the panel)"
|
|
2267
|
+
},
|
|
2268
|
+
{
|
|
2269
|
+
"export": "DialogHeader",
|
|
2270
|
+
"reason": "Drawn inside the set, structural"
|
|
2271
|
+
},
|
|
2272
|
+
{
|
|
2273
|
+
"export": "DialogFooter",
|
|
2274
|
+
"reason": "Drawn inside the set, structural"
|
|
2275
|
+
},
|
|
2276
|
+
{
|
|
2277
|
+
"export": "DialogTitle",
|
|
2278
|
+
"reason": "Drawn inside the set as the heading text"
|
|
2279
|
+
},
|
|
2280
|
+
{
|
|
2281
|
+
"export": "DialogDescription",
|
|
2282
|
+
"reason": "Drawn inside the set as the body text"
|
|
2283
|
+
}
|
|
2284
|
+
],
|
|
2285
|
+
"figmaOnly": [
|
|
2286
|
+
{
|
|
2287
|
+
"nodeId": "17375:198690",
|
|
2288
|
+
"figmaName": "Dialog / Example Content",
|
|
2289
|
+
"reason": "Figma demo helper"
|
|
2290
|
+
},
|
|
2291
|
+
{
|
|
2292
|
+
"nodeId": "5056:13504",
|
|
2293
|
+
"figmaName": "Dialog / Close Icon",
|
|
2294
|
+
"reason": "Close-icon part; code renders it inside DialogContent"
|
|
2295
|
+
}
|
|
2296
|
+
]
|
|
2297
|
+
}
|
|
2298
|
+
},
|
|
2299
|
+
{
|
|
2300
|
+
"name": "Drawer",
|
|
2301
|
+
"import": "@brightlocal/ui-components/drawer",
|
|
2302
|
+
"category": "overlay",
|
|
2303
|
+
"exports": [
|
|
2304
|
+
"Drawer",
|
|
2305
|
+
"DrawerTrigger",
|
|
2306
|
+
"DrawerPortal",
|
|
2307
|
+
"DrawerClose",
|
|
2308
|
+
"DrawerOverlay",
|
|
2309
|
+
"DrawerContent",
|
|
2310
|
+
"DrawerHeader",
|
|
2311
|
+
"DrawerFooter",
|
|
2312
|
+
"DrawerTitle",
|
|
2313
|
+
"DrawerDescription"
|
|
2314
|
+
],
|
|
2315
|
+
"compound": true,
|
|
2316
|
+
"dataHookRequired": false,
|
|
2317
|
+
"variants": {},
|
|
2318
|
+
"props": [
|
|
2319
|
+
"open",
|
|
2320
|
+
"onOpenChange",
|
|
2321
|
+
"direction"
|
|
2322
|
+
],
|
|
2323
|
+
"description": "Slide-out drawer panel",
|
|
2324
|
+
"whenToUse": [
|
|
2325
|
+
"Mobile panels sliding from a screen edge (quick actions, filters, settings)",
|
|
2326
|
+
"Touch-first flows where users expect to swipe a panel away",
|
|
2327
|
+
"Secondary content that shouldn't fully replace the current screen"
|
|
2328
|
+
],
|
|
1212
2329
|
"doNotUseFor": [
|
|
1213
|
-
"
|
|
1214
|
-
"
|
|
2330
|
+
"desktop-first side panels (use Sheet)",
|
|
2331
|
+
"content that must fully block interaction (use Dialog)"
|
|
1215
2332
|
],
|
|
1216
2333
|
"alternatives": [
|
|
1217
2334
|
{
|
|
@@ -1222,7 +2339,76 @@
|
|
|
1222
2339
|
"component": "Dialog",
|
|
1223
2340
|
"rule": "Use Dialog when content should be centered and focused, not sliding from an edge"
|
|
1224
2341
|
}
|
|
1225
|
-
]
|
|
2342
|
+
],
|
|
2343
|
+
"figma": {
|
|
2344
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2345
|
+
"nodes": [
|
|
2346
|
+
{
|
|
2347
|
+
"nodeId": "244:2831",
|
|
2348
|
+
"figmaName": "Drawer",
|
|
2349
|
+
"kind": "componentSet",
|
|
2350
|
+
"export": "Drawer",
|
|
2351
|
+
"note": "Show Header/Show Footer BOOLEANs are composition toggles",
|
|
2352
|
+
"axes": [
|
|
2353
|
+
{
|
|
2354
|
+
"figma": "Breakpoint",
|
|
2355
|
+
"exempt": "figma-only-style",
|
|
2356
|
+
"note": "Responsive breakpoint drawings — sizing is runtime in code"
|
|
2357
|
+
}
|
|
2358
|
+
]
|
|
2359
|
+
}
|
|
2360
|
+
],
|
|
2361
|
+
"unmappedExports": [
|
|
2362
|
+
{
|
|
2363
|
+
"export": "DrawerTrigger",
|
|
2364
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
2365
|
+
},
|
|
2366
|
+
{
|
|
2367
|
+
"export": "DrawerPortal",
|
|
2368
|
+
"reason": "Non-rendering portal wrapper"
|
|
2369
|
+
},
|
|
2370
|
+
{
|
|
2371
|
+
"export": "DrawerClose",
|
|
2372
|
+
"reason": "Drawn inside the set"
|
|
2373
|
+
},
|
|
2374
|
+
{
|
|
2375
|
+
"export": "DrawerOverlay",
|
|
2376
|
+
"reason": "Backdrop layer, drawn implicitly behind the panel"
|
|
2377
|
+
},
|
|
2378
|
+
{
|
|
2379
|
+
"export": "DrawerContent",
|
|
2380
|
+
"reason": "Drawn by the Drawer set (the panel)"
|
|
2381
|
+
},
|
|
2382
|
+
{
|
|
2383
|
+
"export": "DrawerHeader",
|
|
2384
|
+
"reason": "Drawn inside the set ('Show Header' toggle)"
|
|
2385
|
+
},
|
|
2386
|
+
{
|
|
2387
|
+
"export": "DrawerFooter",
|
|
2388
|
+
"reason": "Drawn inside the set ('Show Footer' toggle)"
|
|
2389
|
+
},
|
|
2390
|
+
{
|
|
2391
|
+
"export": "DrawerTitle",
|
|
2392
|
+
"reason": "Drawn inside the set as the heading text"
|
|
2393
|
+
},
|
|
2394
|
+
{
|
|
2395
|
+
"export": "DrawerDescription",
|
|
2396
|
+
"reason": "Drawn inside the set as the body text"
|
|
2397
|
+
}
|
|
2398
|
+
],
|
|
2399
|
+
"figmaOnly": [
|
|
2400
|
+
{
|
|
2401
|
+
"nodeId": "424:6782",
|
|
2402
|
+
"figmaName": "Drawer / Example Content",
|
|
2403
|
+
"reason": "Figma demo helper"
|
|
2404
|
+
},
|
|
2405
|
+
{
|
|
2406
|
+
"nodeId": "241:2426",
|
|
2407
|
+
"figmaName": "Drawer / Example Content / Button",
|
|
2408
|
+
"reason": "Figma demo helper"
|
|
2409
|
+
}
|
|
2410
|
+
]
|
|
2411
|
+
}
|
|
1226
2412
|
},
|
|
1227
2413
|
{
|
|
1228
2414
|
"name": "DropdownMenu",
|
|
@@ -1256,8 +2442,9 @@
|
|
|
1256
2442
|
"three-dot menu"
|
|
1257
2443
|
],
|
|
1258
2444
|
"doNotUseFor": [
|
|
1259
|
-
"
|
|
1260
|
-
"form
|
|
2445
|
+
"right-click menus (use ContextMenu)",
|
|
2446
|
+
"single-select form inputs (use Select)",
|
|
2447
|
+
"persistent horizontal menu bars (use Menubar)"
|
|
1261
2448
|
],
|
|
1262
2449
|
"replaces": [],
|
|
1263
2450
|
"states": [
|
|
@@ -1376,7 +2563,12 @@
|
|
|
1376
2563
|
"reason": "Trigger styling example; code Trigger is an unstyled asChild wrapper"
|
|
1377
2564
|
}
|
|
1378
2565
|
]
|
|
1379
|
-
}
|
|
2566
|
+
},
|
|
2567
|
+
"whenToUse": [
|
|
2568
|
+
"Action menus opened from a button, icon, or avatar (row actions, account menu)",
|
|
2569
|
+
"Grouping related actions under a single labeled trigger",
|
|
2570
|
+
"Menus discoverable by clicking rather than right-click or hover"
|
|
2571
|
+
]
|
|
1380
2572
|
},
|
|
1381
2573
|
{
|
|
1382
2574
|
"name": "Field",
|
|
@@ -1417,13 +2609,14 @@
|
|
|
1417
2609
|
"field wrapper"
|
|
1418
2610
|
],
|
|
1419
2611
|
"whenToUse": [
|
|
1420
|
-
"
|
|
1421
|
-
"
|
|
1422
|
-
"
|
|
2612
|
+
"A standard label-plus-input layout for any typical form question",
|
|
2613
|
+
"Consistent alignment of label, hint text, and error message without extra setup",
|
|
2614
|
+
"Box variant for card-style questions that need to stand out (highlighted settings, onboarding)"
|
|
1423
2615
|
],
|
|
1424
2616
|
"doNotUseFor": [
|
|
1425
|
-
"
|
|
1426
|
-
"
|
|
2617
|
+
"showing information without a form question (use Description or plain text)",
|
|
2618
|
+
"grouping related checkboxes or radios under one heading (use FieldSet with FieldLegend)",
|
|
2619
|
+
"boxed fields in dense forms (adds clutter and vertical space; use the default variant)"
|
|
1427
2620
|
],
|
|
1428
2621
|
"alternatives": [
|
|
1429
2622
|
{
|
|
@@ -1440,6 +2633,11 @@
|
|
|
1440
2633
|
"role": "group",
|
|
1441
2634
|
"requiresLabel": false,
|
|
1442
2635
|
"keyboardInteraction": []
|
|
2636
|
+
},
|
|
2637
|
+
"figma": {
|
|
2638
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2639
|
+
"status": "represented-inline",
|
|
2640
|
+
"reason": "No standalone Figma component — the Field scaffolding (label, description, error message, orientation) is drawn as 'Label Text'/'Description Text'/State=Error props inside every field set (Input, Textarea, Select, Combobox, Date Picker, ...). Verified 2026-08-18."
|
|
1443
2641
|
}
|
|
1444
2642
|
},
|
|
1445
2643
|
{
|
|
@@ -1478,7 +2676,76 @@
|
|
|
1478
2676
|
"ariaLabel": "string — default: \"Go back\""
|
|
1479
2677
|
}
|
|
1480
2678
|
},
|
|
1481
|
-
"description": "Full-page responsive layout with sidebar"
|
|
2679
|
+
"description": "Full-page responsive layout with sidebar",
|
|
2680
|
+
"figma": {
|
|
2681
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2682
|
+
"nodes": [
|
|
2683
|
+
{
|
|
2684
|
+
"nodeId": "22951:38617",
|
|
2685
|
+
"figmaName": "Global Layout",
|
|
2686
|
+
"kind": "component",
|
|
2687
|
+
"export": "GlobalLayout",
|
|
2688
|
+
"note": "Assembled page template; 'Show Sheet' is a composition toggle"
|
|
2689
|
+
},
|
|
2690
|
+
{
|
|
2691
|
+
"nodeId": "23470:101407",
|
|
2692
|
+
"figmaName": "Global Layout – Content",
|
|
2693
|
+
"kind": "componentSet",
|
|
2694
|
+
"export": "GlobalLayoutContent",
|
|
2695
|
+
"axes": [
|
|
2696
|
+
{
|
|
2697
|
+
"figma": "Content Width",
|
|
2698
|
+
"code": "variant",
|
|
2699
|
+
"valueAliases": {
|
|
2700
|
+
"lg": "full"
|
|
2701
|
+
},
|
|
2702
|
+
"note": "Figma names the widest option lg; code calls it full"
|
|
2703
|
+
}
|
|
2704
|
+
]
|
|
2705
|
+
}
|
|
2706
|
+
],
|
|
2707
|
+
"unmappedExports": [
|
|
2708
|
+
{
|
|
2709
|
+
"export": "GlobalLayoutSidebar",
|
|
2710
|
+
"reason": "Drawn as a Sidebar instance inside the Global Layout composition"
|
|
2711
|
+
},
|
|
2712
|
+
{
|
|
2713
|
+
"export": "GlobalLayoutContentActions",
|
|
2714
|
+
"reason": "Drawn inside the Content set, structural slot"
|
|
2715
|
+
},
|
|
2716
|
+
{
|
|
2717
|
+
"export": "GlobalLayoutContentHeader",
|
|
2718
|
+
"reason": "Drawn inside the Content set ('Show Header' toggle)"
|
|
2719
|
+
},
|
|
2720
|
+
{
|
|
2721
|
+
"export": "GlobalLayoutBackLink",
|
|
2722
|
+
"reason": "Drawn inside the Content header composition"
|
|
2723
|
+
},
|
|
2724
|
+
{
|
|
2725
|
+
"export": "GlobalLayoutSubtitle",
|
|
2726
|
+
"reason": "Drawn inside the Content header composition"
|
|
2727
|
+
},
|
|
2728
|
+
{
|
|
2729
|
+
"export": "GlobalLayoutContentBody",
|
|
2730
|
+
"reason": "Structural slot, drawn implicitly as the content area"
|
|
2731
|
+
},
|
|
2732
|
+
{
|
|
2733
|
+
"export": "GlobalLayoutMobileHeader",
|
|
2734
|
+
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
2735
|
+
}
|
|
2736
|
+
],
|
|
2737
|
+
"figmaOnly": []
|
|
2738
|
+
},
|
|
2739
|
+
"whenToUse": [
|
|
2740
|
+
"The overall shell for a logged-in app with sidebar and scrollable content",
|
|
2741
|
+
"Dashboards and admin panels where navigation stays visible",
|
|
2742
|
+
"Pages inside the main authenticated product experience"
|
|
2743
|
+
],
|
|
2744
|
+
"doNotUseFor": [
|
|
2745
|
+
"single standalone pages like login (use CentredLayout)",
|
|
2746
|
+
"two-column marketing/auth pages (use SplitLayout)",
|
|
2747
|
+
"user-adjustable panel widths (pair with Resizable)"
|
|
2748
|
+
]
|
|
1482
2749
|
},
|
|
1483
2750
|
{
|
|
1484
2751
|
"name": "Header",
|
|
@@ -1499,7 +2766,40 @@
|
|
|
1499
2766
|
"props": [
|
|
1500
2767
|
"align"
|
|
1501
2768
|
],
|
|
1502
|
-
"description": "Top-level page header container"
|
|
2769
|
+
"description": "Top-level page header container",
|
|
2770
|
+
"figma": {
|
|
2771
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2772
|
+
"nodes": [
|
|
2773
|
+
{
|
|
2774
|
+
"nodeId": "26460:2047",
|
|
2775
|
+
"figmaName": "Header",
|
|
2776
|
+
"kind": "componentSet",
|
|
2777
|
+
"export": "Header",
|
|
2778
|
+
"note": "Show Menu/Logo BOOLEANs are composition toggles",
|
|
2779
|
+
"axes": [
|
|
2780
|
+
{
|
|
2781
|
+
"figma": "Alignment",
|
|
2782
|
+
"code": "align",
|
|
2783
|
+
"valueAliases": {
|
|
2784
|
+
"Centered": "center"
|
|
2785
|
+
},
|
|
2786
|
+
"note": "Figma draws no Right alignment while code ships align: right — FIG-14 (allowlisted)"
|
|
2787
|
+
}
|
|
2788
|
+
]
|
|
2789
|
+
}
|
|
2790
|
+
],
|
|
2791
|
+
"unmappedExports": [],
|
|
2792
|
+
"figmaOnly": []
|
|
2793
|
+
},
|
|
2794
|
+
"whenToUse": [
|
|
2795
|
+
"Page headers with logo and navigation (Left alignment for standard app pages)",
|
|
2796
|
+
"Centered headers on login/signup screens or branded moments (Center)",
|
|
2797
|
+
"Right-to-left contexts or intentionally right-aligned layouts (Right)"
|
|
2798
|
+
],
|
|
2799
|
+
"doNotUseFor": [
|
|
2800
|
+
"centered or right alignment inside the main app shell (Left is the convention)",
|
|
2801
|
+
"complex multi-level navigation (pair with NavigationMenu or Sidebar)"
|
|
2802
|
+
]
|
|
1503
2803
|
},
|
|
1504
2804
|
{
|
|
1505
2805
|
"name": "HeightTransition",
|
|
@@ -1512,7 +2812,12 @@
|
|
|
1512
2812
|
"dataHookRequired": true,
|
|
1513
2813
|
"variants": {},
|
|
1514
2814
|
"props": [],
|
|
1515
|
-
"description": "Wrapper that smoothly transitions its height (fixed 200ms) when children's natural height changes (content swaps, filtering); reduced motion handled by the DS global kill-switch"
|
|
2815
|
+
"description": "Wrapper that smoothly transitions its height (fixed 200ms) when children's natural height changes (content swaps, filtering); reduced motion handled by the DS global kill-switch",
|
|
2816
|
+
"figma": {
|
|
2817
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2818
|
+
"status": "code-only",
|
|
2819
|
+
"reason": "Runtime height animation — not representable as a static Figma component. Verified 2026-08-18: no Figma node exists."
|
|
2820
|
+
}
|
|
1516
2821
|
},
|
|
1517
2822
|
{
|
|
1518
2823
|
"name": "HoverCard",
|
|
@@ -1531,7 +2836,64 @@
|
|
|
1531
2836
|
"closeDelay",
|
|
1532
2837
|
"disabled"
|
|
1533
2838
|
],
|
|
1534
|
-
"description": "Popover card triggered on hover"
|
|
2839
|
+
"description": "Popover card triggered on hover",
|
|
2840
|
+
"figma": {
|
|
2841
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2842
|
+
"nodes": [
|
|
2843
|
+
{
|
|
2844
|
+
"nodeId": "216:3141",
|
|
2845
|
+
"figmaName": "Hover Card",
|
|
2846
|
+
"kind": "componentSet",
|
|
2847
|
+
"export": "HoverCard",
|
|
2848
|
+
"axes": [
|
|
2849
|
+
{
|
|
2850
|
+
"figma": "Active",
|
|
2851
|
+
"exempt": "interaction-state",
|
|
2852
|
+
"note": "Open state"
|
|
2853
|
+
}
|
|
2854
|
+
]
|
|
2855
|
+
},
|
|
2856
|
+
{
|
|
2857
|
+
"nodeId": "216:3085",
|
|
2858
|
+
"figmaName": "Hover Card / Trigger",
|
|
2859
|
+
"kind": "componentSet",
|
|
2860
|
+
"export": "HoverCardTrigger",
|
|
2861
|
+
"axes": [
|
|
2862
|
+
{
|
|
2863
|
+
"figma": "State",
|
|
2864
|
+
"exempt": "interaction-state",
|
|
2865
|
+
"valueToProp": {
|
|
2866
|
+
"Disabled": "disabled"
|
|
2867
|
+
}
|
|
2868
|
+
}
|
|
2869
|
+
]
|
|
2870
|
+
},
|
|
2871
|
+
{
|
|
2872
|
+
"nodeId": "216:3126",
|
|
2873
|
+
"figmaName": "Hover Card / Card",
|
|
2874
|
+
"kind": "component",
|
|
2875
|
+
"export": "HoverCardContent"
|
|
2876
|
+
}
|
|
2877
|
+
],
|
|
2878
|
+
"unmappedExports": [],
|
|
2879
|
+
"figmaOnly": [
|
|
2880
|
+
{
|
|
2881
|
+
"nodeId": "283:8",
|
|
2882
|
+
"figmaName": "Hover Card / Content Example",
|
|
2883
|
+
"reason": "Figma demo helper"
|
|
2884
|
+
}
|
|
2885
|
+
]
|
|
2886
|
+
},
|
|
2887
|
+
"whenToUse": [
|
|
2888
|
+
"Rich previews on hover (profile summary on a user's name)",
|
|
2889
|
+
"Extra context without requiring a click",
|
|
2890
|
+
"Desktop-first experiences where hover reliably signals intent"
|
|
2891
|
+
],
|
|
2892
|
+
"doNotUseFor": [
|
|
2893
|
+
"previews with clickable content (use Popover)",
|
|
2894
|
+
"touch-heavy products (hover doesn't work there)",
|
|
2895
|
+
"single short lines of text (use Tooltip)"
|
|
2896
|
+
]
|
|
1535
2897
|
},
|
|
1536
2898
|
{
|
|
1537
2899
|
"name": "Input",
|
|
@@ -1556,7 +2918,9 @@
|
|
|
1556
2918
|
],
|
|
1557
2919
|
"doNotUseFor": [
|
|
1558
2920
|
"multi-line text (use Textarea)",
|
|
1559
|
-
"
|
|
2921
|
+
"passwords (use InputPassword)",
|
|
2922
|
+
"fixed-length codes like a 6-digit verification code (use InputOTP)",
|
|
2923
|
+
"picking from a list instead of typing freely (use Select or Combobox)"
|
|
1560
2924
|
],
|
|
1561
2925
|
"replaces": [
|
|
1562
2926
|
"native <input>"
|
|
@@ -1573,7 +2937,46 @@
|
|
|
1573
2937
|
"keyboardInteraction": [
|
|
1574
2938
|
"Tab"
|
|
1575
2939
|
]
|
|
1576
|
-
}
|
|
2940
|
+
},
|
|
2941
|
+
"figma": {
|
|
2942
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
2943
|
+
"nodes": [
|
|
2944
|
+
{
|
|
2945
|
+
"nodeId": "65:533",
|
|
2946
|
+
"figmaName": "Input",
|
|
2947
|
+
"kind": "componentSet",
|
|
2948
|
+
"export": "Input",
|
|
2949
|
+
"note": "Draws the full field with label/description/link scaffolding (TEXT/BOOLEAN props, exempt); hasIcon/hasSecondaryIcon booleans correspond to the Icon/Secondary Icon composition props",
|
|
2950
|
+
"axes": [
|
|
2951
|
+
{
|
|
2952
|
+
"figma": "Horizontal Layout",
|
|
2953
|
+
"exempt": "figma-only-style",
|
|
2954
|
+
"note": "Label-beside-field layout is consumer composition (Field/Label) in code"
|
|
2955
|
+
},
|
|
2956
|
+
{
|
|
2957
|
+
"figma": "Variant",
|
|
2958
|
+
"exempt": "figma-only-style",
|
|
2959
|
+
"note": "Text|File corresponds to the native type=\"file\" attribute, not a CVA axis — no exemption class for native-prop axes yet"
|
|
2960
|
+
},
|
|
2961
|
+
{
|
|
2962
|
+
"figma": "State",
|
|
2963
|
+
"exempt": "interaction-state",
|
|
2964
|
+
"valueToProp": {
|
|
2965
|
+
"Disabled": "disabled",
|
|
2966
|
+
"Error": "error"
|
|
2967
|
+
}
|
|
2968
|
+
}
|
|
2969
|
+
]
|
|
2970
|
+
}
|
|
2971
|
+
],
|
|
2972
|
+
"unmappedExports": [],
|
|
2973
|
+
"figmaOnly": []
|
|
2974
|
+
},
|
|
2975
|
+
"whenToUse": [
|
|
2976
|
+
"Typing a single line of text (name, email, search term, number)",
|
|
2977
|
+
"The default text box for almost any short form answer",
|
|
2978
|
+
"Search boxes and simple filters, often with an icon attached"
|
|
2979
|
+
]
|
|
1577
2980
|
},
|
|
1578
2981
|
{
|
|
1579
2982
|
"name": "InputChip",
|
|
@@ -1592,22 +2995,66 @@
|
|
|
1592
2995
|
"onValueChange",
|
|
1593
2996
|
"defaultValue",
|
|
1594
2997
|
"disabled",
|
|
1595
|
-
"allowDuplicates"
|
|
2998
|
+
"allowDuplicates",
|
|
2999
|
+
"error"
|
|
1596
3000
|
],
|
|
1597
3001
|
"i18nProps": {
|
|
1598
3002
|
"InputChipItems": {
|
|
1599
3003
|
"itemAriaLabel": "string — default: \"{item}, press Delete to remove\""
|
|
1600
3004
|
}
|
|
1601
3005
|
},
|
|
1602
|
-
"description": "Tag/chip input with managed items"
|
|
1603
|
-
|
|
1604
|
-
|
|
1605
|
-
|
|
1606
|
-
|
|
1607
|
-
|
|
1608
|
-
|
|
1609
|
-
|
|
1610
|
-
|
|
3006
|
+
"description": "Tag/chip input with managed items",
|
|
3007
|
+
"figma": {
|
|
3008
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3009
|
+
"nodes": [
|
|
3010
|
+
{
|
|
3011
|
+
"nodeId": "25416:795",
|
|
3012
|
+
"figmaName": "Input Chip",
|
|
3013
|
+
"kind": "componentSet",
|
|
3014
|
+
"export": "InputChip",
|
|
3015
|
+
"note": "'Chip 1'–'Chip 10'/Description/Placeholder BOOLEANs are composition toggles",
|
|
3016
|
+
"axes": [
|
|
3017
|
+
{
|
|
3018
|
+
"figma": "State",
|
|
3019
|
+
"exempt": "interaction-state",
|
|
3020
|
+
"valueToProp": {
|
|
3021
|
+
"Disabled": "disabled",
|
|
3022
|
+
"Error": "error"
|
|
3023
|
+
}
|
|
3024
|
+
}
|
|
3025
|
+
]
|
|
3026
|
+
}
|
|
3027
|
+
],
|
|
3028
|
+
"unmappedExports": [
|
|
3029
|
+
{
|
|
3030
|
+
"export": "InputChipInput",
|
|
3031
|
+
"reason": "Drawn inside the Input Chip set (the text input), not a standalone Figma component"
|
|
3032
|
+
},
|
|
3033
|
+
{
|
|
3034
|
+
"export": "InputChipItems",
|
|
3035
|
+
"reason": "Drawn inside the Input Chip set (the chip row), not a standalone Figma component"
|
|
3036
|
+
}
|
|
3037
|
+
],
|
|
3038
|
+
"figmaOnly": []
|
|
3039
|
+
},
|
|
3040
|
+
"whenToUse": [
|
|
3041
|
+
"Typing a value and pressing Enter to turn it into a removable tag",
|
|
3042
|
+
"Collecting custom tags with no fixed list to pick from (competitor names, search terms)",
|
|
3043
|
+
"Filter builders where users add their own custom filter values"
|
|
3044
|
+
],
|
|
3045
|
+
"doNotUseFor": [
|
|
3046
|
+
"choosing from an existing list (use Combobox)",
|
|
3047
|
+
"displaying already-chosen tags with no typing (use Chip)",
|
|
3048
|
+
"adding many items at once via paste with per-row remove controls (use InputList)"
|
|
3049
|
+
]
|
|
3050
|
+
},
|
|
3051
|
+
{
|
|
3052
|
+
"name": "InputGroup",
|
|
3053
|
+
"import": "@brightlocal/ui-components/input-group",
|
|
3054
|
+
"category": "form",
|
|
3055
|
+
"exports": [
|
|
3056
|
+
"InputGroup",
|
|
3057
|
+
"InputGroupInput",
|
|
1611
3058
|
"InputGroupAddon",
|
|
1612
3059
|
"InputGroupButton"
|
|
1613
3060
|
],
|
|
@@ -1623,7 +3070,22 @@
|
|
|
1623
3070
|
"props": [
|
|
1624
3071
|
"error"
|
|
1625
3072
|
],
|
|
1626
|
-
"description": "Input with addon text or button"
|
|
3073
|
+
"description": "Input with addon text or button",
|
|
3074
|
+
"figma": {
|
|
3075
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3076
|
+
"status": "represented-inline",
|
|
3077
|
+
"reason": "No standalone Figma component — the input-with-addon/button composition is drawn via the Input set's 'Button Text'/'Show Link'/Icon props. Verified 2026-08-18."
|
|
3078
|
+
},
|
|
3079
|
+
"whenToUse": [
|
|
3080
|
+
"A text box with something extra attached (search icon, clear button, unit prefix)",
|
|
3081
|
+
"Attachments that should feel like part of the same control, not a separate element",
|
|
3082
|
+
"Ghost variant for search fields in toolbars or dense filter bars where a border feels heavy"
|
|
3083
|
+
],
|
|
3084
|
+
"doNotUseFor": [
|
|
3085
|
+
"inputs with nothing attached (use Input)",
|
|
3086
|
+
"password visibility toggle with strength meter (use InputPassword)",
|
|
3087
|
+
"ghost variant on plain backgrounds with no surrounding context (can look non-interactive)"
|
|
3088
|
+
]
|
|
1627
3089
|
},
|
|
1628
3090
|
{
|
|
1629
3091
|
"name": "InputOTP",
|
|
@@ -1644,7 +3106,61 @@
|
|
|
1644
3106
|
"error",
|
|
1645
3107
|
"disabled"
|
|
1646
3108
|
],
|
|
1647
|
-
"description": "One-time password input"
|
|
3109
|
+
"description": "One-time password input",
|
|
3110
|
+
"figma": {
|
|
3111
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3112
|
+
"nodes": [
|
|
3113
|
+
{
|
|
3114
|
+
"nodeId": "81:141",
|
|
3115
|
+
"figmaName": "InputOTP",
|
|
3116
|
+
"kind": "componentSet",
|
|
3117
|
+
"export": "InputOTP",
|
|
3118
|
+
"axes": [
|
|
3119
|
+
{
|
|
3120
|
+
"figma": "Variant",
|
|
3121
|
+
"exempt": "figma-only-style",
|
|
3122
|
+
"note": "Digits Only/With Separator/Simple/With Spacing are composition demos — code expresses them via maxLength/pattern props and InputOTPSeparator/Group composition"
|
|
3123
|
+
}
|
|
3124
|
+
]
|
|
3125
|
+
},
|
|
3126
|
+
{
|
|
3127
|
+
"nodeId": "81:122",
|
|
3128
|
+
"figmaName": "InputOTP / Slot",
|
|
3129
|
+
"kind": "componentSet",
|
|
3130
|
+
"export": "InputOTPSlot",
|
|
3131
|
+
"axes": [
|
|
3132
|
+
{
|
|
3133
|
+
"figma": "State",
|
|
3134
|
+
"exempt": "interaction-state",
|
|
3135
|
+
"valueToProp": {
|
|
3136
|
+
"Error": "error"
|
|
3137
|
+
}
|
|
3138
|
+
}
|
|
3139
|
+
]
|
|
3140
|
+
}
|
|
3141
|
+
],
|
|
3142
|
+
"unmappedExports": [
|
|
3143
|
+
{
|
|
3144
|
+
"export": "InputOTPGroup",
|
|
3145
|
+
"reason": "Structural wrapper — drawn implicitly by slot spacing in the set variants"
|
|
3146
|
+
},
|
|
3147
|
+
{
|
|
3148
|
+
"export": "InputOTPSeparator",
|
|
3149
|
+
"reason": "Drawn inside the InputOTP set's 'With Separator' variant, not a standalone Figma component"
|
|
3150
|
+
}
|
|
3151
|
+
],
|
|
3152
|
+
"figmaOnly": []
|
|
3153
|
+
},
|
|
3154
|
+
"whenToUse": [
|
|
3155
|
+
"Fixed-length verification codes (two-factor login, email or phone verification)",
|
|
3156
|
+
"PIN code entry for secure actions",
|
|
3157
|
+
"Grouped codes like 123-456 (With Separator) or longer 6-8 digit codes (With Spacing)"
|
|
3158
|
+
],
|
|
3159
|
+
"doNotUseFor": [
|
|
3160
|
+
"spaced layouts on narrow mobile screens (use connected Simple or Digits Only)",
|
|
3161
|
+
"codes with letters in the Digits Only variant (use Simple or With Separator)",
|
|
3162
|
+
"passwords (use InputPassword)"
|
|
3163
|
+
]
|
|
1648
3164
|
},
|
|
1649
3165
|
{
|
|
1650
3166
|
"name": "InputPassword",
|
|
@@ -1670,7 +3186,53 @@
|
|
|
1670
3186
|
"hideLabel": "string — default: \"Hide password\""
|
|
1671
3187
|
}
|
|
1672
3188
|
},
|
|
1673
|
-
"description": "Password input with visibility toggle and strength meter"
|
|
3189
|
+
"description": "Password input with visibility toggle and strength meter",
|
|
3190
|
+
"figma": {
|
|
3191
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3192
|
+
"nodes": [
|
|
3193
|
+
{
|
|
3194
|
+
"nodeId": "25242:1860",
|
|
3195
|
+
"figmaName": "Input Password",
|
|
3196
|
+
"kind": "componentSet",
|
|
3197
|
+
"export": "InputPasswordRoot",
|
|
3198
|
+
"note": "Draws the assembled password field; the 'Progress' BOOLEAN corresponds to the showMeter prop (booleans are globally exempt)",
|
|
3199
|
+
"axes": [
|
|
3200
|
+
{
|
|
3201
|
+
"figma": "State",
|
|
3202
|
+
"exempt": "interaction-state",
|
|
3203
|
+
"valueToProp": {
|
|
3204
|
+
"Disabled": "disabled"
|
|
3205
|
+
}
|
|
3206
|
+
}
|
|
3207
|
+
]
|
|
3208
|
+
}
|
|
3209
|
+
],
|
|
3210
|
+
"unmappedExports": [
|
|
3211
|
+
{
|
|
3212
|
+
"export": "InputPasswordField",
|
|
3213
|
+
"reason": "Drawn inside the Input Password set (the input itself), not a standalone Figma component"
|
|
3214
|
+
},
|
|
3215
|
+
{
|
|
3216
|
+
"export": "InputPasswordToggle",
|
|
3217
|
+
"reason": "Drawn inside the Input Password set (the visibility eye icon)"
|
|
3218
|
+
},
|
|
3219
|
+
{
|
|
3220
|
+
"export": "InputPasswordStrength",
|
|
3221
|
+
"reason": "Drawn inside the Input Password set ('Progress' BOOLEAN toggle)"
|
|
3222
|
+
}
|
|
3223
|
+
],
|
|
3224
|
+
"figmaOnly": []
|
|
3225
|
+
},
|
|
3226
|
+
"whenToUse": [
|
|
3227
|
+
"Any field where someone types a password (sign up, log in, change password)",
|
|
3228
|
+
"Showing password strength feedback, mainly at account creation",
|
|
3229
|
+
"Giving users a show/hide toggle to double-check what they typed"
|
|
3230
|
+
],
|
|
3231
|
+
"doNotUseFor": [
|
|
3232
|
+
"one-time codes (use InputOTP)",
|
|
3233
|
+
"confirm-password fields with the strength meter (not relevant there)",
|
|
3234
|
+
"simple login forms with the strength meter (keep just the show/hide toggle)"
|
|
3235
|
+
]
|
|
1674
3236
|
},
|
|
1675
3237
|
{
|
|
1676
3238
|
"name": "Label",
|
|
@@ -1693,7 +3255,9 @@
|
|
|
1693
3255
|
"input label"
|
|
1694
3256
|
],
|
|
1695
3257
|
"doNotUseFor": [
|
|
1696
|
-
"
|
|
3258
|
+
"normal form fields (use Field)",
|
|
3259
|
+
"labels needing an attached description or error message (use Field)",
|
|
3260
|
+
"automatic \"(optional)\" suffix conventions (use Field)"
|
|
1697
3261
|
],
|
|
1698
3262
|
"replaces": [
|
|
1699
3263
|
"native <label>"
|
|
@@ -1705,7 +3269,16 @@
|
|
|
1705
3269
|
"role": "none",
|
|
1706
3270
|
"requiresLabel": false,
|
|
1707
3271
|
"keyboardInteraction": []
|
|
1708
|
-
}
|
|
3272
|
+
},
|
|
3273
|
+
"figma": {
|
|
3274
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3275
|
+
"status": "represented-inline",
|
|
3276
|
+
"reason": "No standalone Figma component — form labels are drawn as 'Label Text'/'Show Label' props inside every field set (Input, Textarea, Select, Combobox, Checkbox, Switch). Verified 2026-08-18: all Figma 'Label' matches are chart/menu/sidebar parts, not the form Label."
|
|
3277
|
+
},
|
|
3278
|
+
"whenToUse": [
|
|
3279
|
+
"Custom form layouts built by hand without Field",
|
|
3280
|
+
"Attaching a label to an input outside a typical form question"
|
|
3281
|
+
]
|
|
1709
3282
|
},
|
|
1710
3283
|
{
|
|
1711
3284
|
"name": "Link",
|
|
@@ -1719,6 +3292,7 @@
|
|
|
1719
3292
|
"variants": {
|
|
1720
3293
|
"variant": [
|
|
1721
3294
|
"inline",
|
|
3295
|
+
"inherit",
|
|
1722
3296
|
"primary",
|
|
1723
3297
|
"filled",
|
|
1724
3298
|
"outline",
|
|
@@ -1732,24 +3306,48 @@
|
|
|
1732
3306
|
"showExternalIcon",
|
|
1733
3307
|
"asChild"
|
|
1734
3308
|
],
|
|
1735
|
-
"description": "Styled hyperlink with inline, button-styled (incl. primary brand CTA) and icon-only variants and external link support",
|
|
3309
|
+
"description": "Styled hyperlink with inline, inherit (body-copy), button-styled (incl. primary brand CTA) and icon-only variants and external link support",
|
|
1736
3310
|
"whenToUse": [
|
|
1737
|
-
"
|
|
1738
|
-
"
|
|
1739
|
-
"
|
|
1740
|
-
"
|
|
1741
|
-
"Icon-only navigation links such as back buttons (icon variant — provide an aria-label)",
|
|
1742
|
-
"Links inside i18n <Trans> blocks — use Link as a component in the components map"
|
|
3311
|
+
"Text links inside a sentence or plain navigation links (inline variant)",
|
|
3312
|
+
"Links inside coloured or muted body copy (Alert descriptions, hints, validation messages) that should keep the surrounding text colour and stay underlined (inherit variant)",
|
|
3313
|
+
"High-priority navigation that should look like a button (filled, outline, ghost variants)",
|
|
3314
|
+
"External links that open in a new tab with the right security attributes"
|
|
1743
3315
|
],
|
|
1744
3316
|
"doNotUseFor": [
|
|
1745
|
-
"actions
|
|
3317
|
+
"actions on the current page rather than navigation (use Button)",
|
|
3318
|
+
"menu items inside a Dropdown Menu (use that component's item pattern)",
|
|
3319
|
+
"standalone links outside a sentence with the inherit variant (use inline so the link colour signals interactivity)"
|
|
1746
3320
|
],
|
|
1747
3321
|
"alternatives": [
|
|
1748
3322
|
{
|
|
1749
3323
|
"component": "Button",
|
|
1750
3324
|
"rule": "Use Button for actions (submit, delete, open). Use a button-styled Link (variant primary/filled/outline/ghost) for navigation that needs a button appearance"
|
|
1751
3325
|
}
|
|
1752
|
-
]
|
|
3326
|
+
],
|
|
3327
|
+
"figma": {
|
|
3328
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3329
|
+
"nodes": [
|
|
3330
|
+
{
|
|
3331
|
+
"nodeId": "23024:2863",
|
|
3332
|
+
"figmaName": "Link",
|
|
3333
|
+
"kind": "componentSet",
|
|
3334
|
+
"export": "Link",
|
|
3335
|
+
"axes": [
|
|
3336
|
+
{
|
|
3337
|
+
"figma": "Variant",
|
|
3338
|
+
"code": "variant"
|
|
3339
|
+
},
|
|
3340
|
+
{
|
|
3341
|
+
"figma": "State",
|
|
3342
|
+
"exempt": "interaction-state",
|
|
3343
|
+
"note": "Visited/Active are CSS pseudo-class states"
|
|
3344
|
+
}
|
|
3345
|
+
]
|
|
3346
|
+
}
|
|
3347
|
+
],
|
|
3348
|
+
"unmappedExports": [],
|
|
3349
|
+
"figmaOnly": []
|
|
3350
|
+
}
|
|
1753
3351
|
},
|
|
1754
3352
|
{
|
|
1755
3353
|
"name": "List",
|
|
@@ -1776,7 +3374,61 @@
|
|
|
1776
3374
|
]
|
|
1777
3375
|
},
|
|
1778
3376
|
"props": [],
|
|
1779
|
-
"description": "Vertical item list with optional section headings"
|
|
3377
|
+
"description": "Vertical item list with optional section headings",
|
|
3378
|
+
"figma": {
|
|
3379
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3380
|
+
"nodes": [
|
|
3381
|
+
{
|
|
3382
|
+
"nodeId": "26214:3890",
|
|
3383
|
+
"figmaName": "List",
|
|
3384
|
+
"kind": "component",
|
|
3385
|
+
"export": "List",
|
|
3386
|
+
"note": "Code's variant axis (default|filled|outline|loading) has no Figma axis — single drawing only"
|
|
3387
|
+
},
|
|
3388
|
+
{
|
|
3389
|
+
"nodeId": "28298:5025",
|
|
3390
|
+
"figmaName": "Item Subheader",
|
|
3391
|
+
"kind": "component",
|
|
3392
|
+
"export": "ItemSubheader"
|
|
3393
|
+
}
|
|
3394
|
+
],
|
|
3395
|
+
"unmappedExports": [
|
|
3396
|
+
{
|
|
3397
|
+
"export": "Item",
|
|
3398
|
+
"reason": "Drawn inside the List composition"
|
|
3399
|
+
},
|
|
3400
|
+
{
|
|
3401
|
+
"export": "ItemMedia",
|
|
3402
|
+
"reason": "Drawn inside the List composition"
|
|
3403
|
+
},
|
|
3404
|
+
{
|
|
3405
|
+
"export": "ItemContent",
|
|
3406
|
+
"reason": "Drawn inside the List composition"
|
|
3407
|
+
},
|
|
3408
|
+
{
|
|
3409
|
+
"export": "ItemTitle",
|
|
3410
|
+
"reason": "Drawn inside the List composition"
|
|
3411
|
+
},
|
|
3412
|
+
{
|
|
3413
|
+
"export": "ItemDescription",
|
|
3414
|
+
"reason": "Drawn inside the List composition"
|
|
3415
|
+
},
|
|
3416
|
+
{
|
|
3417
|
+
"export": "ItemActions",
|
|
3418
|
+
"reason": "Drawn inside the List composition"
|
|
3419
|
+
}
|
|
3420
|
+
],
|
|
3421
|
+
"figmaOnly": []
|
|
3422
|
+
},
|
|
3423
|
+
"whenToUse": [
|
|
3424
|
+
"Rows with media, title, description, and trailing actions (filled)",
|
|
3425
|
+
"Settings or form-related rows needing a visible border (outline)",
|
|
3426
|
+
"Lightweight lists inside popovers or dropdowns (default)"
|
|
3427
|
+
],
|
|
3428
|
+
"doNotUseFor": [
|
|
3429
|
+
"tabular data with sortable columns (use Table or DataTable)",
|
|
3430
|
+
"main page content with the default variant (use filled)"
|
|
3431
|
+
]
|
|
1780
3432
|
},
|
|
1781
3433
|
{
|
|
1782
3434
|
"name": "Loading",
|
|
@@ -1794,7 +3446,12 @@
|
|
|
1794
3446
|
"loadingLabel": "string — default: \"Loading\""
|
|
1795
3447
|
}
|
|
1796
3448
|
},
|
|
1797
|
-
"description": "Brand loading animation that morphs between shapes while rotating"
|
|
3449
|
+
"description": "Brand loading animation that morphs between shapes while rotating",
|
|
3450
|
+
"figma": {
|
|
3451
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3452
|
+
"status": "represented-inline",
|
|
3453
|
+
"reason": "No standalone Figma component — loading spinners are drawn as State=Loading variant values inside component sets (Button, Chip, Sonner / Icon). Verified 2026-08-18."
|
|
3454
|
+
}
|
|
1798
3455
|
},
|
|
1799
3456
|
{
|
|
1800
3457
|
"name": "Logo",
|
|
@@ -1817,7 +3474,35 @@
|
|
|
1817
3474
|
"Logo": {
|
|
1818
3475
|
"ariaLabel": "string — default: \"BrightLocal logo\""
|
|
1819
3476
|
}
|
|
1820
|
-
}
|
|
3477
|
+
},
|
|
3478
|
+
"figma": {
|
|
3479
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3480
|
+
"nodes": [
|
|
3481
|
+
{
|
|
3482
|
+
"nodeId": "18315:468385",
|
|
3483
|
+
"figmaName": "Logo",
|
|
3484
|
+
"kind": "componentSet",
|
|
3485
|
+
"export": "Logo",
|
|
3486
|
+
"axes": [
|
|
3487
|
+
{
|
|
3488
|
+
"figma": "Variant",
|
|
3489
|
+
"code": "variant"
|
|
3490
|
+
}
|
|
3491
|
+
]
|
|
3492
|
+
}
|
|
3493
|
+
],
|
|
3494
|
+
"unmappedExports": [],
|
|
3495
|
+
"figmaOnly": []
|
|
3496
|
+
},
|
|
3497
|
+
"whenToUse": [
|
|
3498
|
+
"Headers, footers, and branded spaces with room for the full wordmark (logotype)",
|
|
3499
|
+
"Compact or mobile spaces like collapsed sidebars (mark)",
|
|
3500
|
+
"Favicon or app-icon style placements (mark)"
|
|
3501
|
+
],
|
|
3502
|
+
"doNotUseFor": [
|
|
3503
|
+
"representing a person (use Avatar)",
|
|
3504
|
+
"tight spaces with the full logotype (use the mark variant)"
|
|
3505
|
+
]
|
|
1821
3506
|
},
|
|
1822
3507
|
{
|
|
1823
3508
|
"name": "Map",
|
|
@@ -1886,16 +3571,14 @@
|
|
|
1886
3571
|
"local search grid"
|
|
1887
3572
|
],
|
|
1888
3573
|
"whenToUse": [
|
|
1889
|
-
"
|
|
1890
|
-
"
|
|
1891
|
-
"
|
|
1892
|
-
"Adding loading/error placeholder states for map containers",
|
|
1893
|
-
"Building map controls (zoom, locate) as floating overlays",
|
|
1894
|
-
"Adding a color-coded legend bar to map views"
|
|
3574
|
+
"Showing locations, search-grid rankings, or map-based data with pins, clustering, and legends",
|
|
3575
|
+
"Google Maps integrations built from the DS's ready-made pin, control, and legend pieces",
|
|
3576
|
+
"Visualizing ranking data geographically with color-coded pins"
|
|
1895
3577
|
],
|
|
1896
3578
|
"doNotUseFor": [
|
|
1897
|
-
"non-
|
|
1898
|
-
"
|
|
3579
|
+
"non-geographic data like trends over time (use Chart)",
|
|
3580
|
+
"a fully wrapped, zero-config map (the app owns the map provider setup)",
|
|
3581
|
+
"a simple summary number instead of a geographic view (use a stat Card)"
|
|
1899
3582
|
],
|
|
1900
3583
|
"a11yContract": {
|
|
1901
3584
|
"MapLoadingState": {
|
|
@@ -1930,6 +3613,11 @@
|
|
|
1930
3613
|
"message": "string — default: \"Reloading usually fixes it, and it won't use any credits\"",
|
|
1931
3614
|
"retryLabel": "string — default: \"Reload\""
|
|
1932
3615
|
}
|
|
3616
|
+
},
|
|
3617
|
+
"figma": {
|
|
3618
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3619
|
+
"status": "code-only",
|
|
3620
|
+
"reason": "Structurally unmappable (DS-824 verdict): Google Maps runtime with pin/cluster exports; no Figma nodes exist (verified 2026-08-18)."
|
|
1933
3621
|
}
|
|
1934
3622
|
},
|
|
1935
3623
|
{
|
|
@@ -1955,70 +3643,312 @@
|
|
|
1955
3643
|
"props": [
|
|
1956
3644
|
"defaultValue"
|
|
1957
3645
|
],
|
|
1958
|
-
"description": "Horizontal application menu bar"
|
|
1959
|
-
|
|
1960
|
-
|
|
1961
|
-
|
|
1962
|
-
|
|
1963
|
-
|
|
1964
|
-
|
|
1965
|
-
|
|
1966
|
-
|
|
1967
|
-
|
|
1968
|
-
|
|
1969
|
-
|
|
1970
|
-
|
|
1971
|
-
|
|
1972
|
-
|
|
1973
|
-
|
|
1974
|
-
|
|
1975
|
-
|
|
1976
|
-
|
|
1977
|
-
|
|
1978
|
-
|
|
1979
|
-
|
|
1980
|
-
|
|
1981
|
-
|
|
1982
|
-
|
|
1983
|
-
|
|
1984
|
-
|
|
1985
|
-
|
|
1986
|
-
|
|
1987
|
-
|
|
1988
|
-
|
|
1989
|
-
|
|
1990
|
-
|
|
1991
|
-
|
|
1992
|
-
|
|
1993
|
-
|
|
1994
|
-
|
|
1995
|
-
|
|
1996
|
-
|
|
1997
|
-
|
|
1998
|
-
|
|
1999
|
-
|
|
2000
|
-
|
|
2001
|
-
|
|
2002
|
-
|
|
2003
|
-
|
|
2004
|
-
|
|
2005
|
-
|
|
2006
|
-
|
|
2007
|
-
|
|
2008
|
-
|
|
2009
|
-
|
|
2010
|
-
|
|
2011
|
-
|
|
2012
|
-
|
|
2013
|
-
|
|
2014
|
-
|
|
2015
|
-
|
|
2016
|
-
|
|
2017
|
-
|
|
2018
|
-
|
|
2019
|
-
|
|
2020
|
-
|
|
2021
|
-
|
|
3646
|
+
"description": "Horizontal application menu bar",
|
|
3647
|
+
"figma": {
|
|
3648
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3649
|
+
"nodes": [
|
|
3650
|
+
{
|
|
3651
|
+
"nodeId": "216:1522",
|
|
3652
|
+
"figmaName": "Menubar",
|
|
3653
|
+
"kind": "component",
|
|
3654
|
+
"export": "Menubar",
|
|
3655
|
+
"note": "Figma node is a demo composition"
|
|
3656
|
+
},
|
|
3657
|
+
{
|
|
3658
|
+
"nodeId": "210:3528",
|
|
3659
|
+
"figmaName": "Menubar / Trigger",
|
|
3660
|
+
"kind": "componentSet",
|
|
3661
|
+
"export": "MenubarTrigger",
|
|
3662
|
+
"axes": [
|
|
3663
|
+
{
|
|
3664
|
+
"figma": "Open",
|
|
3665
|
+
"exempt": "interaction-state"
|
|
3666
|
+
},
|
|
3667
|
+
{
|
|
3668
|
+
"figma": "Placement",
|
|
3669
|
+
"exempt": "figma-only-style",
|
|
3670
|
+
"note": "Menu placement drawing — positioning is runtime in code"
|
|
3671
|
+
}
|
|
3672
|
+
]
|
|
3673
|
+
},
|
|
3674
|
+
{
|
|
3675
|
+
"nodeId": "210:3534",
|
|
3676
|
+
"figmaName": "Menubar / Menu",
|
|
3677
|
+
"kind": "component",
|
|
3678
|
+
"export": "MenubarContent"
|
|
3679
|
+
},
|
|
3680
|
+
{
|
|
3681
|
+
"nodeId": "419:6748",
|
|
3682
|
+
"figmaName": "Menubar / Item / Default",
|
|
3683
|
+
"kind": "componentSet",
|
|
3684
|
+
"export": "MenubarItem",
|
|
3685
|
+
"alsoRepresents": [
|
|
3686
|
+
"MenubarCheckboxItem",
|
|
3687
|
+
"MenubarRadioGroup"
|
|
3688
|
+
],
|
|
3689
|
+
"axes": [
|
|
3690
|
+
{
|
|
3691
|
+
"figma": "Variant",
|
|
3692
|
+
"exempt": "export-discriminator",
|
|
3693
|
+
"note": "Default/Checkbox/Radio select between MenubarItem, MenubarCheckboxItem and MenubarRadioGroup"
|
|
3694
|
+
},
|
|
3695
|
+
{
|
|
3696
|
+
"figma": "Level",
|
|
3697
|
+
"exempt": "figma-only-style",
|
|
3698
|
+
"note": "Level 1/2 has no code counterpart (CODE-4 class)"
|
|
3699
|
+
},
|
|
3700
|
+
{
|
|
3701
|
+
"figma": "State",
|
|
3702
|
+
"exempt": "interaction-state",
|
|
3703
|
+
"valueToProp": {
|
|
3704
|
+
"Disabled": "disabled"
|
|
3705
|
+
}
|
|
3706
|
+
}
|
|
3707
|
+
]
|
|
3708
|
+
},
|
|
3709
|
+
{
|
|
3710
|
+
"nodeId": "210:3533",
|
|
3711
|
+
"figmaName": "Menubar / Item / Separator",
|
|
3712
|
+
"kind": "component",
|
|
3713
|
+
"export": "MenubarSeparator"
|
|
3714
|
+
}
|
|
3715
|
+
],
|
|
3716
|
+
"unmappedExports": [
|
|
3717
|
+
{
|
|
3718
|
+
"export": "MenubarMenu",
|
|
3719
|
+
"reason": "Structural wrapper with no visual representation in Figma"
|
|
3720
|
+
},
|
|
3721
|
+
{
|
|
3722
|
+
"export": "MenubarLabel",
|
|
3723
|
+
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
3724
|
+
},
|
|
3725
|
+
{
|
|
3726
|
+
"export": "MenubarShortcut",
|
|
3727
|
+
"reason": "Represented as shortcut text inside the Item set variants"
|
|
3728
|
+
},
|
|
3729
|
+
{
|
|
3730
|
+
"export": "MenubarSub",
|
|
3731
|
+
"reason": "Structural wrapper with no visual representation in Figma"
|
|
3732
|
+
}
|
|
3733
|
+
],
|
|
3734
|
+
"figmaOnly": [
|
|
3735
|
+
{
|
|
3736
|
+
"nodeId": "419:6764",
|
|
3737
|
+
"figmaName": "Menubar / Item / SubTrigger",
|
|
3738
|
+
"reason": "Sub-trigger row drawn in Figma but code exports no MenubarSubTrigger (only structural MenubarSub) — CODE-16"
|
|
3739
|
+
}
|
|
3740
|
+
]
|
|
3741
|
+
},
|
|
3742
|
+
"whenToUse": [
|
|
3743
|
+
"Desktop-style menu bars with several dropdown menus (File/Edit/View)",
|
|
3744
|
+
"Power-user, keyboard-navigable tools expecting app-menu structure",
|
|
3745
|
+
"Internal or admin tools modeled after desktop software conventions"
|
|
3746
|
+
],
|
|
3747
|
+
"doNotUseFor": [
|
|
3748
|
+
"a single dropdown of actions (use DropdownMenu)",
|
|
3749
|
+
"mobile or touch-first contexts",
|
|
3750
|
+
"primary app navigation (use NavigationMenu or Sidebar)"
|
|
3751
|
+
]
|
|
3752
|
+
},
|
|
3753
|
+
{
|
|
3754
|
+
"name": "NavigationMenu",
|
|
3755
|
+
"import": "@brightlocal/ui-components/navigation-menu",
|
|
3756
|
+
"category": "navigation",
|
|
3757
|
+
"exports": [
|
|
3758
|
+
"NavigationMenu",
|
|
3759
|
+
"NavigationMenuList",
|
|
3760
|
+
"NavigationMenuItem",
|
|
3761
|
+
"NavigationMenuTrigger",
|
|
3762
|
+
"NavigationMenuContent",
|
|
3763
|
+
"NavigationMenuViewport",
|
|
3764
|
+
"NavigationMenuIndicator"
|
|
3765
|
+
],
|
|
3766
|
+
"compound": true,
|
|
3767
|
+
"dataHookRequired": true,
|
|
3768
|
+
"variants": {},
|
|
3769
|
+
"props": [],
|
|
3770
|
+
"description": "Complex navigation menu structure",
|
|
3771
|
+
"figma": {
|
|
3772
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3773
|
+
"nodes": [
|
|
3774
|
+
{
|
|
3775
|
+
"nodeId": "210:2036",
|
|
3776
|
+
"figmaName": "NavigationMenu",
|
|
3777
|
+
"kind": "component",
|
|
3778
|
+
"export": "NavigationMenu",
|
|
3779
|
+
"note": "Figma node is a demo composition"
|
|
3780
|
+
},
|
|
3781
|
+
{
|
|
3782
|
+
"nodeId": "210:2018",
|
|
3783
|
+
"figmaName": "NavigationMenu / Button",
|
|
3784
|
+
"kind": "componentSet",
|
|
3785
|
+
"export": "NavigationMenuTrigger",
|
|
3786
|
+
"axes": [
|
|
3787
|
+
{
|
|
3788
|
+
"figma": "Variant",
|
|
3789
|
+
"exempt": "export-discriminator",
|
|
3790
|
+
"note": "Trigger|Link selects the dropdown trigger vs a plain link item (code has no NavigationMenuLink export — links are composed via asChild)"
|
|
3791
|
+
},
|
|
3792
|
+
{
|
|
3793
|
+
"figma": "State",
|
|
3794
|
+
"exempt": "interaction-state"
|
|
3795
|
+
}
|
|
3796
|
+
]
|
|
3797
|
+
},
|
|
3798
|
+
{
|
|
3799
|
+
"nodeId": "17375:179953",
|
|
3800
|
+
"figmaName": "NavigationMenu / Popover",
|
|
3801
|
+
"kind": "componentSet",
|
|
3802
|
+
"export": "NavigationMenuContent",
|
|
3803
|
+
"axes": [
|
|
3804
|
+
{
|
|
3805
|
+
"figma": "Type",
|
|
3806
|
+
"exempt": "figma-only-style",
|
|
3807
|
+
"note": "List/2 Column/Simple/Custom are content-layout compositions (consumer children in code)"
|
|
3808
|
+
}
|
|
3809
|
+
]
|
|
3810
|
+
}
|
|
3811
|
+
],
|
|
3812
|
+
"unmappedExports": [
|
|
3813
|
+
{
|
|
3814
|
+
"export": "NavigationMenuList",
|
|
3815
|
+
"reason": "Structural wrapper (the <ul>), no standalone Figma representation"
|
|
3816
|
+
},
|
|
3817
|
+
{
|
|
3818
|
+
"export": "NavigationMenuItem",
|
|
3819
|
+
"reason": "Structural wrapper (the <li>), no standalone Figma representation"
|
|
3820
|
+
},
|
|
3821
|
+
{
|
|
3822
|
+
"export": "NavigationMenuViewport",
|
|
3823
|
+
"reason": "Runtime positioning surface, not drawable as a component"
|
|
3824
|
+
},
|
|
3825
|
+
{
|
|
3826
|
+
"export": "NavigationMenuIndicator",
|
|
3827
|
+
"reason": "Runtime active-item indicator, drawn implicitly in the demo composition"
|
|
3828
|
+
}
|
|
3829
|
+
],
|
|
3830
|
+
"figmaOnly": [
|
|
3831
|
+
{
|
|
3832
|
+
"nodeId": "17375:2761",
|
|
3833
|
+
"figmaName": "NavigationMenu / Menu Link",
|
|
3834
|
+
"reason": "Popover link items — composed by the consumer in code (no NavigationMenuLink export)"
|
|
3835
|
+
}
|
|
3836
|
+
]
|
|
3837
|
+
},
|
|
3838
|
+
"whenToUse": [
|
|
3839
|
+
"Main navigation bar for a site or app with rich, multi-column dropdown content",
|
|
3840
|
+
"Marketing or documentation sites needing structured navigation beyond a link list",
|
|
3841
|
+
"Flyouts with previews or sub-links that help users find sections faster"
|
|
3842
|
+
],
|
|
3843
|
+
"doNotUseFor": [
|
|
3844
|
+
"simple action menus triggered by a button (use DropdownMenu)",
|
|
3845
|
+
"persistent app sidebars (use Sidebar)",
|
|
3846
|
+
"desktop-style app menus (use Menubar)"
|
|
3847
|
+
]
|
|
3848
|
+
},
|
|
3849
|
+
{
|
|
3850
|
+
"name": "Pagination",
|
|
3851
|
+
"import": "@brightlocal/ui-components/pagination",
|
|
3852
|
+
"category": "navigation",
|
|
3853
|
+
"exports": [
|
|
3854
|
+
"Pagination",
|
|
3855
|
+
"PaginationContent",
|
|
3856
|
+
"PaginationItem",
|
|
3857
|
+
"PaginationButton",
|
|
3858
|
+
"PaginationLink",
|
|
3859
|
+
"PaginationPrevious",
|
|
3860
|
+
"PaginationNext",
|
|
3861
|
+
"PaginationEllipsis"
|
|
3862
|
+
],
|
|
3863
|
+
"compound": true,
|
|
3864
|
+
"dataHookRequired": true,
|
|
3865
|
+
"variants": {},
|
|
3866
|
+
"props": [
|
|
3867
|
+
"page",
|
|
3868
|
+
"totalPages"
|
|
3869
|
+
],
|
|
3870
|
+
"hooks": [
|
|
3871
|
+
"usePagination"
|
|
3872
|
+
],
|
|
3873
|
+
"i18nProps": {
|
|
3874
|
+
"Pagination": {
|
|
3875
|
+
"ariaLabel": "string — default: \"Pagination\""
|
|
3876
|
+
},
|
|
3877
|
+
"PaginationPrevious": {
|
|
3878
|
+
"ariaLabel": "string — default: \"Go to previous page\""
|
|
3879
|
+
},
|
|
3880
|
+
"PaginationNext": {
|
|
3881
|
+
"ariaLabel": "string — default: \"Go to next page\""
|
|
3882
|
+
},
|
|
3883
|
+
"PaginationLink": {
|
|
3884
|
+
"ariaLabel": "string — default: \"Go to page {page}\""
|
|
3885
|
+
},
|
|
3886
|
+
"PaginationEllipsis": {
|
|
3887
|
+
"srLabel": "string — default: \"More pages\""
|
|
3888
|
+
}
|
|
3889
|
+
},
|
|
3890
|
+
"description": "Page navigation controls",
|
|
3891
|
+
"figma": {
|
|
3892
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3893
|
+
"nodes": [
|
|
3894
|
+
{
|
|
3895
|
+
"nodeId": "208:1701",
|
|
3896
|
+
"figmaName": "Pagination",
|
|
3897
|
+
"kind": "component",
|
|
3898
|
+
"export": "Pagination",
|
|
3899
|
+
"note": "Figma node is a demo composition"
|
|
3900
|
+
},
|
|
3901
|
+
{
|
|
3902
|
+
"nodeId": "208:1651",
|
|
3903
|
+
"figmaName": "Pagination / PaginationItem",
|
|
3904
|
+
"kind": "componentSet",
|
|
3905
|
+
"export": "PaginationItem",
|
|
3906
|
+
"alsoRepresents": [
|
|
3907
|
+
"PaginationPrevious",
|
|
3908
|
+
"PaginationNext",
|
|
3909
|
+
"PaginationLink",
|
|
3910
|
+
"PaginationEllipsis"
|
|
3911
|
+
],
|
|
3912
|
+
"axes": [
|
|
3913
|
+
{
|
|
3914
|
+
"figma": "Variant",
|
|
3915
|
+
"exempt": "export-discriminator",
|
|
3916
|
+
"note": "Previous/Next/Link/Ellipsis select between PaginationPrevious, PaginationNext, PaginationLink and PaginationEllipsis"
|
|
3917
|
+
},
|
|
3918
|
+
{
|
|
3919
|
+
"figma": "State",
|
|
3920
|
+
"exempt": "interaction-state",
|
|
3921
|
+
"valueToProp": {
|
|
3922
|
+
"Disabled": "disabled"
|
|
3923
|
+
},
|
|
3924
|
+
"note": "Active (+ combinations) is the isActive sub-part prop, not registered in meta (CODE-3 class) — no lift"
|
|
3925
|
+
}
|
|
3926
|
+
]
|
|
3927
|
+
}
|
|
3928
|
+
],
|
|
3929
|
+
"unmappedExports": [
|
|
3930
|
+
{
|
|
3931
|
+
"export": "PaginationContent",
|
|
3932
|
+
"reason": "Structural wrapper (the <ul>), no standalone Figma representation"
|
|
3933
|
+
},
|
|
3934
|
+
{
|
|
3935
|
+
"export": "PaginationButton",
|
|
3936
|
+
"reason": "Button flavour of PaginationLink (onClick vs href) — visually identical, covered by the Item set"
|
|
3937
|
+
}
|
|
3938
|
+
],
|
|
3939
|
+
"figmaOnly": []
|
|
3940
|
+
},
|
|
3941
|
+
"whenToUse": [
|
|
3942
|
+
"Moving between pages of a large result set with page numbers or next/previous controls",
|
|
3943
|
+
"Standalone paginated views not backed by a Data Table",
|
|
3944
|
+
"Letting users jump directly to a specific page"
|
|
3945
|
+
],
|
|
3946
|
+
"doNotUseFor": [
|
|
3947
|
+
"lists inside a Data Table (use its built-in pagination)",
|
|
3948
|
+
"continuously loading content (use infinite scroll)",
|
|
3949
|
+
"result sets that fit on one screen"
|
|
3950
|
+
]
|
|
3951
|
+
},
|
|
2022
3952
|
{
|
|
2023
3953
|
"name": "Popover",
|
|
2024
3954
|
"import": "@brightlocal/ui-components/popover",
|
|
@@ -2047,8 +3977,9 @@
|
|
|
2047
3977
|
"info popup"
|
|
2048
3978
|
],
|
|
2049
3979
|
"doNotUseFor": [
|
|
2050
|
-
"
|
|
2051
|
-
"
|
|
3980
|
+
"content that should block the whole page (use Dialog)",
|
|
3981
|
+
"hover-triggered non-interactive previews (use HoverCard)",
|
|
3982
|
+
"structured lists of clickable actions (use DropdownMenu)"
|
|
2052
3983
|
],
|
|
2053
3984
|
"replaces": [],
|
|
2054
3985
|
"states": [
|
|
@@ -2062,7 +3993,41 @@
|
|
|
2062
3993
|
"Escape",
|
|
2063
3994
|
"Tab"
|
|
2064
3995
|
]
|
|
2065
|
-
}
|
|
3996
|
+
},
|
|
3997
|
+
"figma": {
|
|
3998
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
3999
|
+
"nodes": [
|
|
4000
|
+
{
|
|
4001
|
+
"nodeId": "195:1621",
|
|
4002
|
+
"figmaName": "Popover",
|
|
4003
|
+
"kind": "component",
|
|
4004
|
+
"export": "Popover",
|
|
4005
|
+
"note": "Figma node is a demo composition. Not to be confused with the separate PopoverMenu family (5198:*) in the Components frame — that is not this component."
|
|
4006
|
+
}
|
|
4007
|
+
],
|
|
4008
|
+
"unmappedExports": [
|
|
4009
|
+
{
|
|
4010
|
+
"export": "PopoverTrigger",
|
|
4011
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
4012
|
+
},
|
|
4013
|
+
{
|
|
4014
|
+
"export": "PopoverContent",
|
|
4015
|
+
"reason": "Drawn by the Popover node (the panel)"
|
|
4016
|
+
}
|
|
4017
|
+
],
|
|
4018
|
+
"figmaOnly": [
|
|
4019
|
+
{
|
|
4020
|
+
"nodeId": "297:2381",
|
|
4021
|
+
"figmaName": "Popover / Content Example",
|
|
4022
|
+
"reason": "Figma demo helper"
|
|
4023
|
+
}
|
|
4024
|
+
]
|
|
4025
|
+
},
|
|
4026
|
+
"whenToUse": [
|
|
4027
|
+
"Small floating panels opened by click without blocking the page",
|
|
4028
|
+
"Quick-edit forms or filter panels lighter than a full Dialog",
|
|
4029
|
+
"Content the user actively interacts with, unlike a passive hover preview"
|
|
4030
|
+
]
|
|
2066
4031
|
},
|
|
2067
4032
|
{
|
|
2068
4033
|
"name": "Progress",
|
|
@@ -2079,20 +4044,68 @@
|
|
|
2079
4044
|
"red",
|
|
2080
4045
|
"orange",
|
|
2081
4046
|
"yellow"
|
|
4047
|
+
],
|
|
4048
|
+
"size": [
|
|
4049
|
+
"sm",
|
|
4050
|
+
"md"
|
|
2082
4051
|
]
|
|
2083
4052
|
},
|
|
2084
4053
|
"props": [
|
|
2085
4054
|
"value",
|
|
2086
4055
|
"max",
|
|
2087
4056
|
"color",
|
|
4057
|
+
"size",
|
|
2088
4058
|
"showValue",
|
|
2089
4059
|
"unit",
|
|
2090
4060
|
"ariaLabel",
|
|
2091
4061
|
"label",
|
|
4062
|
+
"statusDescription",
|
|
4063
|
+
"indeterminate",
|
|
4064
|
+
"labelWidth",
|
|
2092
4065
|
"indicatorClassName",
|
|
2093
4066
|
"disabled"
|
|
2094
4067
|
],
|
|
2095
|
-
"description": "Progress bar indicator with optional inline label, numeric value, and brand color options"
|
|
4068
|
+
"description": "Progress bar indicator with optional inline label, numeric value, and brand color options",
|
|
4069
|
+
"figma": {
|
|
4070
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4071
|
+
"nodes": [
|
|
4072
|
+
{
|
|
4073
|
+
"nodeId": "296:4740",
|
|
4074
|
+
"figmaName": "Progress",
|
|
4075
|
+
"kind": "componentSet",
|
|
4076
|
+
"export": "Progress",
|
|
4077
|
+
"note": "Show label / Label text (TEXT) ↔ `label`; Show value ↔ `showValue`; `disabled` has no variant by decision — shown as a 50%-opacity instance in the Playground; Fill ↔ `value` (fill + Number text); Fraction form (BOOLEAN) / Max (TEXT) / Unit (TEXT) ↔ `unit !== \"%\"` / `max` / `unit`. Label column is the exposed nested set Progress / Label — Width Auto | 20% | 30% | 40% | 50% (default 40%) + Label text = code labelWidth (\"auto\" | \"20%\"–\"50%\", default \"40%\") + label; % values are fixed px at the 364 base since Figma has no % sizing; long labels wrap (never truncate); Value layer hugs with a 40px minimum, right-aligned (code sizes it to the widest value automatically). Indicator/Track use the brand palette by decision (green-400, brand-primary-foreground/20, brand-red/orange/yellow + /20) — Figma binds the same variables; not the chart-* tokens. Text style text-xs/leading-normal = 16px = Tailwind text-xs default line-height. DS-773.",
|
|
4078
|
+
"axes": [
|
|
4079
|
+
{
|
|
4080
|
+
"figma": "Colour",
|
|
4081
|
+
"code": "color"
|
|
4082
|
+
},
|
|
4083
|
+
{
|
|
4084
|
+
"figma": "Size",
|
|
4085
|
+
"code": "size",
|
|
4086
|
+
"note": "sm = 14px text (text-sm) + 8px bar (h-2); md = 16px text (text-base) + 12px bar (h-3) — Figma binds height/h-2 and height/h-3"
|
|
4087
|
+
},
|
|
4088
|
+
{
|
|
4089
|
+
"figma": "Fill",
|
|
4090
|
+
"exempt": "figma-only-style",
|
|
4091
|
+
"note": "Discrete steps of the continuous `value` prop (drives the fill + the Number text); renamed from Percent in the DS-773 branch. Fraction form / Max / Unit TEXT props mirror `unit !== \"%\"` / `max` / `unit` — Figma cannot compute, so they set the displayed text the same way the code does; the Number is overridable for exact figures."
|
|
4092
|
+
}
|
|
4093
|
+
]
|
|
4094
|
+
}
|
|
4095
|
+
],
|
|
4096
|
+
"unmappedExports": [],
|
|
4097
|
+
"figmaOnly": []
|
|
4098
|
+
},
|
|
4099
|
+
"whenToUse": [
|
|
4100
|
+
"Completion of a process or task with a real, known percentage (upload, multi-step setup)",
|
|
4101
|
+
"Reassuring users a long-running operation is moving forward when progress is known",
|
|
4102
|
+
"Bounded measurements like scores via red/orange/yellow colors (meter semantics), paired with a text label"
|
|
4103
|
+
],
|
|
4104
|
+
"doNotUseFor": [
|
|
4105
|
+
"stalled or failed tasks (use Alert for the failure)",
|
|
4106
|
+
"unknown waits with no real percentage (Skeleton covers initial content loading)",
|
|
4107
|
+
"static scores with the green variant (colored variant is the meter-style option)"
|
|
4108
|
+
]
|
|
2096
4109
|
},
|
|
2097
4110
|
{
|
|
2098
4111
|
"name": "RadioGroup",
|
|
@@ -2121,7 +4134,62 @@
|
|
|
2121
4134
|
"hooks": [
|
|
2122
4135
|
"useRadioGroup"
|
|
2123
4136
|
],
|
|
2124
|
-
"description": "Radio button group with multiple layout variants"
|
|
4137
|
+
"description": "Radio button group with multiple layout variants",
|
|
4138
|
+
"figma": {
|
|
4139
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4140
|
+
"nodes": [
|
|
4141
|
+
{
|
|
4142
|
+
"nodeId": "65:341",
|
|
4143
|
+
"figmaName": "Radio Group",
|
|
4144
|
+
"kind": "component",
|
|
4145
|
+
"export": "RadioGroup",
|
|
4146
|
+
"note": "Assembled component — the `variant` axis is drawn on the Radio / Item set below. 'Item 2'–'Item 6' BOOLEAN props are composition toggles."
|
|
4147
|
+
},
|
|
4148
|
+
{
|
|
4149
|
+
"nodeId": "65:326",
|
|
4150
|
+
"figmaName": "Radio / Item",
|
|
4151
|
+
"kind": "componentSet",
|
|
4152
|
+
"export": "RadioGroupItem",
|
|
4153
|
+
"axes": [
|
|
4154
|
+
{
|
|
4155
|
+
"figma": "Variant",
|
|
4156
|
+
"code": "variant",
|
|
4157
|
+
"valueAliases": {
|
|
4158
|
+
"Box Icon Vertical": "boxIconVertical",
|
|
4159
|
+
"Box Icon Horiontal": "boxIconHorizontal"
|
|
4160
|
+
},
|
|
4161
|
+
"note": "'Box Icon Horiontal' is a Figma typo — FIG-7; drop the alias once designers rename the value"
|
|
4162
|
+
},
|
|
4163
|
+
{
|
|
4164
|
+
"figma": "Active",
|
|
4165
|
+
"exempt": "interaction-state"
|
|
4166
|
+
},
|
|
4167
|
+
{
|
|
4168
|
+
"figma": "Font Weight",
|
|
4169
|
+
"exempt": "figma-only-style"
|
|
4170
|
+
},
|
|
4171
|
+
{
|
|
4172
|
+
"figma": "State",
|
|
4173
|
+
"exempt": "interaction-state",
|
|
4174
|
+
"valueToProp": {
|
|
4175
|
+
"Error": "error"
|
|
4176
|
+
}
|
|
4177
|
+
}
|
|
4178
|
+
]
|
|
4179
|
+
}
|
|
4180
|
+
],
|
|
4181
|
+
"unmappedExports": [],
|
|
4182
|
+
"figmaOnly": []
|
|
4183
|
+
},
|
|
4184
|
+
"whenToUse": [
|
|
4185
|
+
"Choosing exactly one option from 2-6 visible choices",
|
|
4186
|
+
"Prominent card-style choices like plan selection (box variants)",
|
|
4187
|
+
"Icon-led visual choices (box icon variants)"
|
|
4188
|
+
],
|
|
4189
|
+
"doNotUseFor": [
|
|
4190
|
+
"multiple selection (use Checkbox or ToggleGroup)",
|
|
4191
|
+
"more than a handful of options (use Select or Combobox)"
|
|
4192
|
+
]
|
|
2125
4193
|
},
|
|
2126
4194
|
{
|
|
2127
4195
|
"name": "Rating",
|
|
@@ -2141,7 +4209,41 @@
|
|
|
2141
4209
|
"Rating": {
|
|
2142
4210
|
"ariaLabel": "string — default: \"Rating: {value} out of 5 stars\""
|
|
2143
4211
|
}
|
|
2144
|
-
}
|
|
4212
|
+
},
|
|
4213
|
+
"figma": {
|
|
4214
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4215
|
+
"nodes": [
|
|
4216
|
+
{
|
|
4217
|
+
"nodeId": "22262:19688",
|
|
4218
|
+
"figmaName": "Rating",
|
|
4219
|
+
"kind": "componentSet",
|
|
4220
|
+
"export": "Rating",
|
|
4221
|
+
"axes": [
|
|
4222
|
+
{
|
|
4223
|
+
"figma": "Rating",
|
|
4224
|
+
"exempt": "figma-only-style",
|
|
4225
|
+
"note": "Discrete value-prop demos (1.0–5.0) — value is continuous in code"
|
|
4226
|
+
},
|
|
4227
|
+
{
|
|
4228
|
+
"figma": "Size",
|
|
4229
|
+
"exempt": "figma-only-style",
|
|
4230
|
+
"note": "No size variant in code"
|
|
4231
|
+
}
|
|
4232
|
+
]
|
|
4233
|
+
}
|
|
4234
|
+
],
|
|
4235
|
+
"unmappedExports": [],
|
|
4236
|
+
"figmaOnly": []
|
|
4237
|
+
},
|
|
4238
|
+
"whenToUse": [
|
|
4239
|
+
"Showing a star-based score, like 4.5 out of 5, on a review, listing, or summary card",
|
|
4240
|
+
"Visualizing quality or satisfaction where the star convention is expected",
|
|
4241
|
+
"Summarizing aggregate customer feedback at a glance"
|
|
4242
|
+
],
|
|
4243
|
+
"doNotUseFor": [
|
|
4244
|
+
"collecting a rating from the user (display-only, no input)",
|
|
4245
|
+
"non-star scores or counts (use plain text or Badge)"
|
|
4246
|
+
]
|
|
2145
4247
|
},
|
|
2146
4248
|
{
|
|
2147
4249
|
"name": "Resizable",
|
|
@@ -2162,7 +4264,93 @@
|
|
|
2162
4264
|
"minSize",
|
|
2163
4265
|
"maxSize"
|
|
2164
4266
|
],
|
|
2165
|
-
"description": "Resizable panel layout"
|
|
4267
|
+
"description": "Resizable panel layout",
|
|
4268
|
+
"figma": {
|
|
4269
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4270
|
+
"status": "code-only",
|
|
4271
|
+
"reason": "Interactive resize behavior (panel group/handle) — mocks draw resulting layouts as plain frames. Verified 2026-08-18: no Figma node (only cursor icons match)."
|
|
4272
|
+
},
|
|
4273
|
+
"whenToUse": [
|
|
4274
|
+
"Letting users drag to adjust space between two panels (horizontal or vertical)",
|
|
4275
|
+
"Code-editor or file-explorer style layouts with varying space preferences",
|
|
4276
|
+
"Console or preview layouts where one panel needs adjustable room"
|
|
4277
|
+
],
|
|
4278
|
+
"doNotUseFor": [
|
|
4279
|
+
"fixed layout proportions (use SplitLayout or GlobalLayout)",
|
|
4280
|
+
"small/mobile screens where drag-resize is impractical (use a fixed stacked layout)"
|
|
4281
|
+
]
|
|
4282
|
+
},
|
|
4283
|
+
{
|
|
4284
|
+
"name": "RouteProgress",
|
|
4285
|
+
"import": "@brightlocal/ui-components/route-progress",
|
|
4286
|
+
"category": "feedback",
|
|
4287
|
+
"exports": [
|
|
4288
|
+
"RouteProgress"
|
|
4289
|
+
],
|
|
4290
|
+
"compound": false,
|
|
4291
|
+
"dataHookRequired": true,
|
|
4292
|
+
"variants": {},
|
|
4293
|
+
"props": [
|
|
4294
|
+
"active",
|
|
4295
|
+
"navigatingLabel"
|
|
4296
|
+
],
|
|
4297
|
+
"i18nProps": {
|
|
4298
|
+
"RouteProgress": {
|
|
4299
|
+
"navigatingLabel": "string — default: \"Loading page\""
|
|
4300
|
+
}
|
|
4301
|
+
},
|
|
4302
|
+
"description": "Slim top-edge bar that reports a full route navigation, from the click until the destination's route-critical content has settled",
|
|
4303
|
+
"aliases": [
|
|
4304
|
+
"route bar",
|
|
4305
|
+
"navigation progress",
|
|
4306
|
+
"top loading bar",
|
|
4307
|
+
"nprogress",
|
|
4308
|
+
"page load bar"
|
|
4309
|
+
],
|
|
4310
|
+
"whenToUse": [
|
|
4311
|
+
"Every full route navigation, including browser back and forward",
|
|
4312
|
+
"Acknowledging a navigation click immediately, before the destination commits",
|
|
4313
|
+
"Alongside the destination's section skeletons, which keep their own local feedback"
|
|
4314
|
+
],
|
|
4315
|
+
"doNotUseFor": [
|
|
4316
|
+
"in-page changes (tabs, filter changes, pagination refetches, modals) — none of these are route navigations",
|
|
4317
|
+
"replacing section skeletons (the bar reports the navigation; skeletons answer what will occupy this space)",
|
|
4318
|
+
"chaining behind another loader for the same wait (route bar → spinner → page loader)",
|
|
4319
|
+
"waits owned by a slow, failing or polling section, which must keep its own skeleton and let the bar finish"
|
|
4320
|
+
],
|
|
4321
|
+
"alternatives": [
|
|
4322
|
+
{
|
|
4323
|
+
"component": "Progress",
|
|
4324
|
+
"rule": "Use Progress when there is a real, known percentage to report"
|
|
4325
|
+
},
|
|
4326
|
+
{
|
|
4327
|
+
"component": "Skeleton",
|
|
4328
|
+
"rule": "Use Skeleton for the destination's own sections — it answers what will occupy this space"
|
|
4329
|
+
}
|
|
4330
|
+
],
|
|
4331
|
+
"replaces": [],
|
|
4332
|
+
"states": [
|
|
4333
|
+
"idle",
|
|
4334
|
+
"start",
|
|
4335
|
+
"creep",
|
|
4336
|
+
"complete"
|
|
4337
|
+
],
|
|
4338
|
+
"a11yContract": {
|
|
4339
|
+
"role": null,
|
|
4340
|
+
"requiresLabel": false,
|
|
4341
|
+
"keyboardInteraction": [],
|
|
4342
|
+
"note": "Decorative: the track is aria-hidden and exposes no progressbar role or aria-valuenow, because its fill is a trickle rather than measured progress. A polite live region announces navigatingLabel instead."
|
|
4343
|
+
},
|
|
4344
|
+
"knownGaps": [
|
|
4345
|
+
{
|
|
4346
|
+
"description": "Router pending state alone completes the bar when the route commits, not when the page is ready — on routes whose components fetch on mount it finishes while skeletons are still rendering",
|
|
4347
|
+
"workaround": "Declare route-critical data in the route loader (queryClient.ensureQueryData), or OR in the destination's own queries scoped to the route: useIsFetching({ queryKey }) > 0. Never a global useIsFetching() — a polling or failing query would hold the bar open."
|
|
4348
|
+
},
|
|
4349
|
+
{
|
|
4350
|
+
"description": "active is fully controlled: the component cannot itself know what a route is, so back/forward support, ignoring in-page changes, and not being held open by a slow section all depend on what active is wired to",
|
|
4351
|
+
"workaround": "Derive active from the router rather than a click handler, and mount the bar once at the root route so every route family is covered."
|
|
4352
|
+
}
|
|
4353
|
+
]
|
|
2166
4354
|
},
|
|
2167
4355
|
{
|
|
2168
4356
|
"name": "ScrollArea",
|
|
@@ -2181,7 +4369,36 @@
|
|
|
2181
4369
|
]
|
|
2182
4370
|
},
|
|
2183
4371
|
"props": [],
|
|
2184
|
-
"description": "Custom scrollable area with styled scrollbars"
|
|
4372
|
+
"description": "Custom scrollable area with styled scrollbars",
|
|
4373
|
+
"figma": {
|
|
4374
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4375
|
+
"nodes": [
|
|
4376
|
+
{
|
|
4377
|
+
"nodeId": "24961:12126",
|
|
4378
|
+
"figmaName": "Scroll Area",
|
|
4379
|
+
"kind": "component",
|
|
4380
|
+
"export": "ScrollArea",
|
|
4381
|
+
"note": "Code's orientation variant (on ScrollBar) has no Figma axis — the scrollbar is drawn vertically only"
|
|
4382
|
+
}
|
|
4383
|
+
],
|
|
4384
|
+
"unmappedExports": [
|
|
4385
|
+
{
|
|
4386
|
+
"export": "ScrollBar",
|
|
4387
|
+
"reason": "Drawn implicitly inside the Scroll Area node, not a standalone Figma component"
|
|
4388
|
+
}
|
|
4389
|
+
],
|
|
4390
|
+
"figmaOnly": []
|
|
4391
|
+
},
|
|
4392
|
+
"whenToUse": [
|
|
4393
|
+
"A specific box needing its own scroll bar (chat panel, fixed-height list)",
|
|
4394
|
+
"Dropdown menus or sidebars with long content that shouldn't grow the page",
|
|
4395
|
+
"Keeping scrollbar styling consistent with the design system"
|
|
4396
|
+
],
|
|
4397
|
+
"doNotUseFor": [
|
|
4398
|
+
"whole-page scrolling (let the browser handle it natively)",
|
|
4399
|
+
"contexts where native scrollbars are fine (skip the extra wrapper)",
|
|
4400
|
+
"scrolling already handled by another component (like Sidebar)"
|
|
4401
|
+
]
|
|
2185
4402
|
},
|
|
2186
4403
|
{
|
|
2187
4404
|
"name": "Select",
|
|
@@ -2206,7 +4423,8 @@
|
|
|
2206
4423
|
"open",
|
|
2207
4424
|
"onOpenChange",
|
|
2208
4425
|
"onClose",
|
|
2209
|
-
"disabled"
|
|
4426
|
+
"disabled",
|
|
4427
|
+
"error"
|
|
2210
4428
|
],
|
|
2211
4429
|
"description": "Dropdown select input",
|
|
2212
4430
|
"aliases": [
|
|
@@ -2215,8 +4433,9 @@
|
|
|
2215
4433
|
"select menu"
|
|
2216
4434
|
],
|
|
2217
4435
|
"doNotUseFor": [
|
|
2218
|
-
"searchable lists (use Combobox)",
|
|
2219
|
-
"
|
|
4436
|
+
"long or searchable lists (use Combobox)",
|
|
4437
|
+
"picking more than one option (use Combobox multi-select)",
|
|
4438
|
+
"showing every option at once (use RadioGroup)"
|
|
2220
4439
|
],
|
|
2221
4440
|
"replaces": [
|
|
2222
4441
|
"native <select>"
|
|
@@ -2239,7 +4458,94 @@
|
|
|
2239
4458
|
"SelectTrigger": {
|
|
2240
4459
|
"selectLabel": "string — default: \"Select an option\""
|
|
2241
4460
|
}
|
|
2242
|
-
}
|
|
4461
|
+
},
|
|
4462
|
+
"figma": {
|
|
4463
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4464
|
+
"nodes": [
|
|
4465
|
+
{
|
|
4466
|
+
"nodeId": "345:11530",
|
|
4467
|
+
"figmaName": "Select",
|
|
4468
|
+
"kind": "componentSet",
|
|
4469
|
+
"export": "Select",
|
|
4470
|
+
"note": "Draws the closed field (trigger + label/description scaffolding as TEXT/BOOLEAN props); SelectTrigger/SelectValue are drawn inside — see unmappedExports",
|
|
4471
|
+
"axes": [
|
|
4472
|
+
{
|
|
4473
|
+
"figma": "State",
|
|
4474
|
+
"exempt": "interaction-state",
|
|
4475
|
+
"valueToProp": {
|
|
4476
|
+
"Disabled": "disabled",
|
|
4477
|
+
"Error": "error"
|
|
4478
|
+
},
|
|
4479
|
+
"note": "Filled and combination values (Filled (Focus), Error (Focus)) are runtime states — stay exempt"
|
|
4480
|
+
}
|
|
4481
|
+
]
|
|
4482
|
+
},
|
|
4483
|
+
{
|
|
4484
|
+
"nodeId": "118:2501",
|
|
4485
|
+
"figmaName": "Select / Menu",
|
|
4486
|
+
"kind": "component",
|
|
4487
|
+
"export": "SelectContent"
|
|
4488
|
+
},
|
|
4489
|
+
{
|
|
4490
|
+
"nodeId": "118:1541",
|
|
4491
|
+
"figmaName": "Select Menu / Item",
|
|
4492
|
+
"kind": "componentSet",
|
|
4493
|
+
"export": "SelectItem",
|
|
4494
|
+
"axes": [
|
|
4495
|
+
{
|
|
4496
|
+
"figma": "Type",
|
|
4497
|
+
"exempt": "figma-only-style",
|
|
4498
|
+
"note": "Simple|Icon is icon-slot composition (children in code)"
|
|
4499
|
+
},
|
|
4500
|
+
{
|
|
4501
|
+
"figma": "Variant",
|
|
4502
|
+
"exempt": "figma-only-style",
|
|
4503
|
+
"note": "Checkbox item style has no code counterpart — code Select is single-select (FIG-10)"
|
|
4504
|
+
},
|
|
4505
|
+
{
|
|
4506
|
+
"figma": "State",
|
|
4507
|
+
"exempt": "interaction-state"
|
|
4508
|
+
}
|
|
4509
|
+
]
|
|
4510
|
+
},
|
|
4511
|
+
{
|
|
4512
|
+
"nodeId": "118:1542",
|
|
4513
|
+
"figmaName": "Select Menu / Label",
|
|
4514
|
+
"kind": "component",
|
|
4515
|
+
"export": "SelectLabel"
|
|
4516
|
+
}
|
|
4517
|
+
],
|
|
4518
|
+
"unmappedExports": [
|
|
4519
|
+
{
|
|
4520
|
+
"export": "SelectTrigger",
|
|
4521
|
+
"reason": "Drawn inside the Select set — the closed field IS the trigger"
|
|
4522
|
+
},
|
|
4523
|
+
{
|
|
4524
|
+
"export": "SelectValue",
|
|
4525
|
+
"reason": "Represented as the 'Placeholder' TEXT prop on the Select set"
|
|
4526
|
+
},
|
|
4527
|
+
{
|
|
4528
|
+
"export": "SelectGroup",
|
|
4529
|
+
"reason": "Structural wrapper with no visual representation in Figma"
|
|
4530
|
+
},
|
|
4531
|
+
{
|
|
4532
|
+
"export": "SelectSeparator",
|
|
4533
|
+
"reason": "No Figma representation found (2026-08-18) — DropdownMenu has one; candidate designer task"
|
|
4534
|
+
}
|
|
4535
|
+
],
|
|
4536
|
+
"figmaOnly": [
|
|
4537
|
+
{
|
|
4538
|
+
"nodeId": "24961:9197",
|
|
4539
|
+
"figmaName": "Mobile Multi-select",
|
|
4540
|
+
"reason": "Mobile multi-select pattern demo; no code counterpart (FIG-10)"
|
|
4541
|
+
}
|
|
4542
|
+
]
|
|
4543
|
+
},
|
|
4544
|
+
"whenToUse": [
|
|
4545
|
+
"Picking one option from a short, well-known list of fewer than about 10 items",
|
|
4546
|
+
"Known, stable option values that don't benefit from searching",
|
|
4547
|
+
"A quick, familiar dropdown pattern most users already know"
|
|
4548
|
+
]
|
|
2243
4549
|
},
|
|
2244
4550
|
{
|
|
2245
4551
|
"name": "Separator",
|
|
@@ -2266,7 +4572,49 @@
|
|
|
2266
4572
|
"props": [
|
|
2267
4573
|
"decorative"
|
|
2268
4574
|
],
|
|
2269
|
-
"description": "Visual divider between content with configurable spacing"
|
|
4575
|
+
"description": "Visual divider between content with configurable spacing",
|
|
4576
|
+
"figma": {
|
|
4577
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4578
|
+
"nodes": [
|
|
4579
|
+
{
|
|
4580
|
+
"nodeId": "118:2690",
|
|
4581
|
+
"figmaName": "Separator",
|
|
4582
|
+
"kind": "componentSet",
|
|
4583
|
+
"export": "Separator",
|
|
4584
|
+
"alsoRepresents": [
|
|
4585
|
+
"SeparatorWithText"
|
|
4586
|
+
],
|
|
4587
|
+
"axes": [
|
|
4588
|
+
{
|
|
4589
|
+
"figma": "Variant",
|
|
4590
|
+
"exempt": "export-discriminator",
|
|
4591
|
+
"note": "Horizontal|Vertical correspond to the orientation variant; Text selects SeparatorWithText — mixed axis, vocabulary gap noted"
|
|
4592
|
+
},
|
|
4593
|
+
{
|
|
4594
|
+
"figma": "Spacing",
|
|
4595
|
+
"code": "spacing",
|
|
4596
|
+
"valueAliases": {
|
|
4597
|
+
"Small": "sm",
|
|
4598
|
+
"Medium": "md",
|
|
4599
|
+
"Large": "lg"
|
|
4600
|
+
}
|
|
4601
|
+
}
|
|
4602
|
+
]
|
|
4603
|
+
}
|
|
4604
|
+
],
|
|
4605
|
+
"unmappedExports": [],
|
|
4606
|
+
"figmaOnly": []
|
|
4607
|
+
},
|
|
4608
|
+
"whenToUse": [
|
|
4609
|
+
"A visible dividing line between content sections or menu-item groups",
|
|
4610
|
+
"An \"OR\" divider between two options (text variant)",
|
|
4611
|
+
"Separating groups of related items inside a menu or list"
|
|
4612
|
+
],
|
|
4613
|
+
"doNotUseFor": [
|
|
4614
|
+
"spacing without a visible line (a layout/spacing choice)",
|
|
4615
|
+
"manually centering text over a plain line (use the text variant)",
|
|
4616
|
+
"inside Field compositions (form spacing already applies)"
|
|
4617
|
+
]
|
|
2270
4618
|
},
|
|
2271
4619
|
{
|
|
2272
4620
|
"name": "Sheet",
|
|
@@ -2280,6 +4628,7 @@
|
|
|
2280
4628
|
"SheetOverlay",
|
|
2281
4629
|
"SheetContent",
|
|
2282
4630
|
"SheetHeader",
|
|
4631
|
+
"SheetBody",
|
|
2283
4632
|
"SheetFooter",
|
|
2284
4633
|
"SheetTitle",
|
|
2285
4634
|
"SheetDescription"
|
|
@@ -2292,6 +4641,10 @@
|
|
|
2292
4641
|
"right",
|
|
2293
4642
|
"bottom",
|
|
2294
4643
|
"left"
|
|
4644
|
+
],
|
|
4645
|
+
"size": [
|
|
4646
|
+
"default",
|
|
4647
|
+
"sm"
|
|
2295
4648
|
]
|
|
2296
4649
|
},
|
|
2297
4650
|
"props": [
|
|
@@ -2312,13 +4665,13 @@
|
|
|
2312
4665
|
"slide-out"
|
|
2313
4666
|
],
|
|
2314
4667
|
"whenToUse": [
|
|
2315
|
-
"
|
|
2316
|
-
"
|
|
2317
|
-
"
|
|
4668
|
+
"Desktop side panels for editing details or settings (filters, detail view)",
|
|
4669
|
+
"Edge-anchored content that shouldn't trigger a full page navigation",
|
|
4670
|
+
"Right variant for detail/edit panels, Left for navigation-side content"
|
|
2318
4671
|
],
|
|
2319
4672
|
"doNotUseFor": [
|
|
2320
|
-
"
|
|
2321
|
-
"
|
|
4673
|
+
"mobile/touch interfaces (use Drawer)",
|
|
4674
|
+
"content that must fully block the page (use Dialog)"
|
|
2322
4675
|
],
|
|
2323
4676
|
"alternatives": [
|
|
2324
4677
|
{
|
|
@@ -2346,6 +4699,83 @@
|
|
|
2346
4699
|
"Escape",
|
|
2347
4700
|
"Tab"
|
|
2348
4701
|
]
|
|
4702
|
+
},
|
|
4703
|
+
"figma": {
|
|
4704
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4705
|
+
"nodes": [
|
|
4706
|
+
{
|
|
4707
|
+
"nodeId": "220:4633",
|
|
4708
|
+
"figmaName": "Sheet",
|
|
4709
|
+
"kind": "componentSet",
|
|
4710
|
+
"export": "Sheet",
|
|
4711
|
+
"note": "Show Button/Header/icon BOOLEANs are composition toggles; the side variant lives on SheetContent in code",
|
|
4712
|
+
"axes": [
|
|
4713
|
+
{
|
|
4714
|
+
"figma": "Position",
|
|
4715
|
+
"code": "side"
|
|
4716
|
+
},
|
|
4717
|
+
{
|
|
4718
|
+
"figma": "Breakpoint",
|
|
4719
|
+
"exempt": "figma-only-style",
|
|
4720
|
+
"note": "Responsive breakpoint drawings — sizing is runtime in code"
|
|
4721
|
+
}
|
|
4722
|
+
]
|
|
4723
|
+
}
|
|
4724
|
+
],
|
|
4725
|
+
"unmappedExports": [
|
|
4726
|
+
{
|
|
4727
|
+
"export": "SheetTrigger",
|
|
4728
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
4729
|
+
},
|
|
4730
|
+
{
|
|
4731
|
+
"export": "SheetPortal",
|
|
4732
|
+
"reason": "Non-rendering portal wrapper"
|
|
4733
|
+
},
|
|
4734
|
+
{
|
|
4735
|
+
"export": "SheetClose",
|
|
4736
|
+
"reason": "Drawn inside the set (see also figmaOnly Sheet / Close Icon)"
|
|
4737
|
+
},
|
|
4738
|
+
{
|
|
4739
|
+
"export": "SheetOverlay",
|
|
4740
|
+
"reason": "Backdrop layer, drawn implicitly behind the panel"
|
|
4741
|
+
},
|
|
4742
|
+
{
|
|
4743
|
+
"export": "SheetContent",
|
|
4744
|
+
"reason": "Drawn by the Sheet set (the panel); its side variant is declared on the set's Position axis"
|
|
4745
|
+
},
|
|
4746
|
+
{
|
|
4747
|
+
"export": "SheetHeader",
|
|
4748
|
+
"reason": "Drawn inside the set ('Show Header' toggle)"
|
|
4749
|
+
},
|
|
4750
|
+
{
|
|
4751
|
+
"export": "SheetBody",
|
|
4752
|
+
"reason": "Drawn inside the set as the 'Sheet Body' slot (fills available height, clips); scrolling is runtime in code"
|
|
4753
|
+
},
|
|
4754
|
+
{
|
|
4755
|
+
"export": "SheetFooter",
|
|
4756
|
+
"reason": "Drawn inside the set, structural"
|
|
4757
|
+
},
|
|
4758
|
+
{
|
|
4759
|
+
"export": "SheetTitle",
|
|
4760
|
+
"reason": "Drawn inside the set as the heading text"
|
|
4761
|
+
},
|
|
4762
|
+
{
|
|
4763
|
+
"export": "SheetDescription",
|
|
4764
|
+
"reason": "Drawn inside the set as the body text"
|
|
4765
|
+
}
|
|
4766
|
+
],
|
|
4767
|
+
"figmaOnly": [
|
|
4768
|
+
{
|
|
4769
|
+
"nodeId": "5037:3220",
|
|
4770
|
+
"figmaName": "Sheet / Close Icon",
|
|
4771
|
+
"reason": "Close-icon part; code renders it inside SheetContent"
|
|
4772
|
+
},
|
|
4773
|
+
{
|
|
4774
|
+
"nodeId": "424:7014",
|
|
4775
|
+
"figmaName": "Sheet / Example Content",
|
|
4776
|
+
"reason": "Figma demo helper"
|
|
4777
|
+
}
|
|
4778
|
+
]
|
|
2349
4779
|
}
|
|
2350
4780
|
},
|
|
2351
4781
|
{
|
|
@@ -2359,7 +4789,36 @@
|
|
|
2359
4789
|
"dataHookRequired": false,
|
|
2360
4790
|
"variants": {},
|
|
2361
4791
|
"props": [],
|
|
2362
|
-
"description": "Loading placeholder with animation"
|
|
4792
|
+
"description": "Loading placeholder with animation",
|
|
4793
|
+
"figma": {
|
|
4794
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4795
|
+
"nodes": [
|
|
4796
|
+
{
|
|
4797
|
+
"nodeId": "295:462",
|
|
4798
|
+
"figmaName": "Skeleton",
|
|
4799
|
+
"kind": "componentSet",
|
|
4800
|
+
"export": "Skeleton",
|
|
4801
|
+
"axes": [
|
|
4802
|
+
{
|
|
4803
|
+
"figma": "Variant",
|
|
4804
|
+
"exempt": "figma-only-style",
|
|
4805
|
+
"note": "Image and Text/Card/Text are composition demos — code Skeleton is a shape primitive the consumer composes"
|
|
4806
|
+
}
|
|
4807
|
+
]
|
|
4808
|
+
}
|
|
4809
|
+
],
|
|
4810
|
+
"unmappedExports": [],
|
|
4811
|
+
"figmaOnly": []
|
|
4812
|
+
},
|
|
4813
|
+
"whenToUse": [
|
|
4814
|
+
"Placeholders matching the rough shape of loading content (cards, rows, avatars)",
|
|
4815
|
+
"Reducing layout shift by reserving space before content arrives"
|
|
4816
|
+
],
|
|
4817
|
+
"doNotUseFor": [
|
|
4818
|
+
"waits of unknown length or shape (a plain spinner is more honest)",
|
|
4819
|
+
"near-instant loads (a brief flash feels jarring)",
|
|
4820
|
+
"error states (switch to a real error message)"
|
|
4821
|
+
]
|
|
2363
4822
|
},
|
|
2364
4823
|
{
|
|
2365
4824
|
"name": "Slider",
|
|
@@ -2385,7 +4844,47 @@
|
|
|
2385
4844
|
"step",
|
|
2386
4845
|
"thumbLabels"
|
|
2387
4846
|
],
|
|
2388
|
-
"description": "Numeric range slider input"
|
|
4847
|
+
"description": "Numeric range slider input",
|
|
4848
|
+
"figma": {
|
|
4849
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4850
|
+
"nodes": [
|
|
4851
|
+
{
|
|
4852
|
+
"nodeId": "17382:13106",
|
|
4853
|
+
"figmaName": "Slider",
|
|
4854
|
+
"kind": "componentSet",
|
|
4855
|
+
"export": "Slider",
|
|
4856
|
+
"axes": [
|
|
4857
|
+
{
|
|
4858
|
+
"figma": "Range",
|
|
4859
|
+
"code": "mode",
|
|
4860
|
+
"valueAliases": {
|
|
4861
|
+
"No": "single",
|
|
4862
|
+
"Yes": "range"
|
|
4863
|
+
},
|
|
4864
|
+
"note": "Figma expresses mode as a Range yes/no toggle — designer-friendly wording, aliased"
|
|
4865
|
+
}
|
|
4866
|
+
]
|
|
4867
|
+
}
|
|
4868
|
+
],
|
|
4869
|
+
"unmappedExports": [],
|
|
4870
|
+
"figmaOnly": [
|
|
4871
|
+
{
|
|
4872
|
+
"nodeId": "17428:100438",
|
|
4873
|
+
"figmaName": "Slider / Item",
|
|
4874
|
+
"reason": "Thumb part with interaction states; Slider renders thumbs internally — no standalone code export"
|
|
4875
|
+
}
|
|
4876
|
+
]
|
|
4877
|
+
},
|
|
4878
|
+
"whenToUse": [
|
|
4879
|
+
"Picking one number along a scale by dragging (radius, percentage threshold)",
|
|
4880
|
+
"Values where general feel matters more than an exact number",
|
|
4881
|
+
"Range mode for a minimum and maximum together (price range filter)"
|
|
4882
|
+
],
|
|
4883
|
+
"doNotUseFor": [
|
|
4884
|
+
"exact numbers the user would rather type (use Input)",
|
|
4885
|
+
"precise values (pair with visible number inputs)",
|
|
4886
|
+
"a few named discrete options (use ToggleGroup or RadioGroup)"
|
|
4887
|
+
]
|
|
2389
4888
|
},
|
|
2390
4889
|
{
|
|
2391
4890
|
"name": "Sonner",
|
|
@@ -2414,8 +4913,9 @@
|
|
|
2414
4913
|
"flash message"
|
|
2415
4914
|
],
|
|
2416
4915
|
"doNotUseFor": [
|
|
2417
|
-
"
|
|
2418
|
-
"
|
|
4916
|
+
"messages that must stay on screen and tied to the page (use Alert)",
|
|
4917
|
+
"decisions required before continuing (use AlertDialog)",
|
|
4918
|
+
"failures styled with the Success variant (green would mislead)"
|
|
2419
4919
|
],
|
|
2420
4920
|
"replaces": [],
|
|
2421
4921
|
"states": [
|
|
@@ -2426,7 +4926,70 @@
|
|
|
2426
4926
|
"role": "status",
|
|
2427
4927
|
"requiresLabel": false,
|
|
2428
4928
|
"keyboardInteraction": []
|
|
2429
|
-
}
|
|
4929
|
+
},
|
|
4930
|
+
"figma": {
|
|
4931
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
4932
|
+
"nodes": [
|
|
4933
|
+
{
|
|
4934
|
+
"nodeId": "193:1386",
|
|
4935
|
+
"figmaName": "Sonner",
|
|
4936
|
+
"kind": "component",
|
|
4937
|
+
"export": "Sonner",
|
|
4938
|
+
"note": "Title/Description/Action/Icon props are composition toggles matching the toast options"
|
|
4939
|
+
}
|
|
4940
|
+
],
|
|
4941
|
+
"unmappedExports": [
|
|
4942
|
+
{
|
|
4943
|
+
"export": "sonner",
|
|
4944
|
+
"reason": "Imperative toast function, not a rendered component"
|
|
4945
|
+
}
|
|
4946
|
+
],
|
|
4947
|
+
"figmaOnly": [
|
|
4948
|
+
{
|
|
4949
|
+
"nodeId": "17375:198096",
|
|
4950
|
+
"figmaName": "Sonner / Icon",
|
|
4951
|
+
"reason": "Icon-slot part; its Type values (Error/Info/Success/Warning/Loading) correspond to the colorSchema prop"
|
|
4952
|
+
}
|
|
4953
|
+
]
|
|
4954
|
+
},
|
|
4955
|
+
"whenToUse": [
|
|
4956
|
+
"Quick, temporary confirmations (\"Report saved\")",
|
|
4957
|
+
"Background operations that shouldn't interrupt the user",
|
|
4958
|
+
"Confirming actions without forcing acknowledgement"
|
|
4959
|
+
]
|
|
4960
|
+
},
|
|
4961
|
+
{
|
|
4962
|
+
"name": "Spinner",
|
|
4963
|
+
"import": "@brightlocal/ui-components/spinner",
|
|
4964
|
+
"category": "feedback",
|
|
4965
|
+
"exports": [
|
|
4966
|
+
"Spinner"
|
|
4967
|
+
],
|
|
4968
|
+
"compound": false,
|
|
4969
|
+
"dataHookRequired": false,
|
|
4970
|
+
"variants": {
|
|
4971
|
+
"size": [
|
|
4972
|
+
"sm",
|
|
4973
|
+
"md",
|
|
4974
|
+
"lg"
|
|
4975
|
+
]
|
|
4976
|
+
},
|
|
4977
|
+
"props": [],
|
|
4978
|
+
"description": "The one indeterminate loading indicator — LoaderCircle at the shared speed, three sizes (sm 14, md 16, lg 20)",
|
|
4979
|
+
"i18nProps": {
|
|
4980
|
+
"Spinner": {
|
|
4981
|
+
"loadingLabel": "string — default: none (decorative aria-hidden when omitted; pass to announce role=\"status\")"
|
|
4982
|
+
}
|
|
4983
|
+
},
|
|
4984
|
+
"whenToUse": [
|
|
4985
|
+
"An indeterminate wait inside a control that announces its own busy state (Button, Chip, Stepper, toasts embed it already)",
|
|
4986
|
+
"A wait standing alone in a small surface whose result shape is unknown (open Combobox list, cell, nav item)"
|
|
4987
|
+
],
|
|
4988
|
+
"doNotUseFor": [
|
|
4989
|
+
"content whose shape is known (use Skeleton so layout doesn't shift)",
|
|
4990
|
+
"whole-page or section loads (see Patterns / Loading)",
|
|
4991
|
+
"determinate progress (use Progress)"
|
|
4992
|
+
]
|
|
2430
4993
|
},
|
|
2431
4994
|
{
|
|
2432
4995
|
"name": "SplitLayout",
|
|
@@ -2447,14 +5010,14 @@
|
|
|
2447
5010
|
],
|
|
2448
5011
|
"description": "Two-column responsive layout with composition pattern",
|
|
2449
5012
|
"whenToUse": [
|
|
2450
|
-
"Two-column pages
|
|
2451
|
-
"
|
|
2452
|
-
"
|
|
5013
|
+
"Two-column pages with a form on one side and marketing content on the other",
|
|
5014
|
+
"Pages where secondary imagery/branding should disappear on mobile",
|
|
5015
|
+
"Auth pages prioritizing the form on one side and the brand on the other"
|
|
2453
5016
|
],
|
|
2454
5017
|
"doNotUseFor": [
|
|
2455
|
-
"
|
|
2456
|
-
"app shells with sidebar
|
|
2457
|
-
"
|
|
5018
|
+
"single-column pages (use CentredLayout)",
|
|
5019
|
+
"app shells with a persistent sidebar (use GlobalLayout)",
|
|
5020
|
+
"more than two columns, or pages needing both columns visible on mobile"
|
|
2458
5021
|
],
|
|
2459
5022
|
"alternatives": [
|
|
2460
5023
|
{
|
|
@@ -2465,7 +5028,40 @@
|
|
|
2465
5028
|
"component": "GlobalLayout",
|
|
2466
5029
|
"rule": "Use GlobalLayout for full app shells with persistent sidebar"
|
|
2467
5030
|
}
|
|
2468
|
-
]
|
|
5031
|
+
],
|
|
5032
|
+
"figma": {
|
|
5033
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5034
|
+
"nodes": [
|
|
5035
|
+
{
|
|
5036
|
+
"nodeId": "23024:470",
|
|
5037
|
+
"figmaName": "Split Layout",
|
|
5038
|
+
"kind": "componentSet",
|
|
5039
|
+
"export": "SplitLayout",
|
|
5040
|
+
"axes": [
|
|
5041
|
+
{
|
|
5042
|
+
"figma": "Variant",
|
|
5043
|
+
"exempt": "figma-only-style",
|
|
5044
|
+
"note": "Single-value placeholder axis (Default only)"
|
|
5045
|
+
}
|
|
5046
|
+
]
|
|
5047
|
+
}
|
|
5048
|
+
],
|
|
5049
|
+
"unmappedExports": [
|
|
5050
|
+
{
|
|
5051
|
+
"export": "SplitLayoutHeader",
|
|
5052
|
+
"reason": "Drawn inside the layout composition"
|
|
5053
|
+
},
|
|
5054
|
+
{
|
|
5055
|
+
"export": "SplitLayoutContentLeft",
|
|
5056
|
+
"reason": "Structural slot, drawn implicitly as the left panel"
|
|
5057
|
+
},
|
|
5058
|
+
{
|
|
5059
|
+
"export": "SplitLayoutContentRight",
|
|
5060
|
+
"reason": "Structural slot, drawn implicitly as the right panel"
|
|
5061
|
+
}
|
|
5062
|
+
],
|
|
5063
|
+
"figmaOnly": []
|
|
5064
|
+
}
|
|
2469
5065
|
},
|
|
2470
5066
|
{
|
|
2471
5067
|
"name": "Stepper",
|
|
@@ -2523,7 +5119,16 @@
|
|
|
2523
5119
|
"loadingLabel": "string — default: \"Loading\""
|
|
2524
5120
|
}
|
|
2525
5121
|
},
|
|
2526
|
-
"description": "Guides users through a multi-step process, showing progress and the current step"
|
|
5122
|
+
"description": "Guides users through a multi-step process, showing progress and the current step",
|
|
5123
|
+
"whenToUse": [
|
|
5124
|
+
"Showing progress through a multi-step process (checkout, onboarding wizard)",
|
|
5125
|
+
"Processes with a small, fixed number of steps needing an at-a-glance overview",
|
|
5126
|
+
"Vertical orientation for narrow layouts or steps with more descriptive text"
|
|
5127
|
+
],
|
|
5128
|
+
"doNotUseFor": [
|
|
5129
|
+
"single continuous forms with no distinct stages",
|
|
5130
|
+
"hierarchical location rather than sequence (use Breadcrumb)"
|
|
5131
|
+
]
|
|
2527
5132
|
},
|
|
2528
5133
|
{
|
|
2529
5134
|
"name": "Switch",
|
|
@@ -2546,8 +5151,9 @@
|
|
|
2546
5151
|
"on/off toggle"
|
|
2547
5152
|
],
|
|
2548
5153
|
"doNotUseFor": [
|
|
2549
|
-
"
|
|
2550
|
-
"
|
|
5154
|
+
"selections or boolean form choices (use Checkbox)",
|
|
5155
|
+
"three or more choices (use RadioGroup or ToggleGroup)",
|
|
5156
|
+
"standalone pressed/unpressed toolbar buttons (use Toggle)"
|
|
2551
5157
|
],
|
|
2552
5158
|
"replaces": [],
|
|
2553
5159
|
"states": [
|
|
@@ -2561,7 +5167,49 @@
|
|
|
2561
5167
|
"keyboardInteraction": [
|
|
2562
5168
|
"Space"
|
|
2563
5169
|
]
|
|
2564
|
-
}
|
|
5170
|
+
},
|
|
5171
|
+
"figma": {
|
|
5172
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5173
|
+
"nodes": [
|
|
5174
|
+
{
|
|
5175
|
+
"nodeId": "60:450",
|
|
5176
|
+
"figmaName": "Switch",
|
|
5177
|
+
"kind": "componentSet",
|
|
5178
|
+
"export": "Switch",
|
|
5179
|
+
"axes": [
|
|
5180
|
+
{
|
|
5181
|
+
"figma": "Active",
|
|
5182
|
+
"exempt": "interaction-state",
|
|
5183
|
+
"valueToProp": {
|
|
5184
|
+
"On": "checked"
|
|
5185
|
+
},
|
|
5186
|
+
"note": "Active=On doubles as the data-state=checked drawing — lifted to `checked` (Toggle Pressed precedent)"
|
|
5187
|
+
},
|
|
5188
|
+
{
|
|
5189
|
+
"figma": "Type",
|
|
5190
|
+
"exempt": "figma-only-style",
|
|
5191
|
+
"note": "Box switch style has no code counterpart (FIG-9) — decide ship-in-code vs remove-from-Figma, cf. RadioGroup box variants"
|
|
5192
|
+
},
|
|
5193
|
+
{
|
|
5194
|
+
"figma": "Side",
|
|
5195
|
+
"exempt": "figma-only-style",
|
|
5196
|
+
"note": "Label side (Left|Right) is composition in code — the consumer places the label"
|
|
5197
|
+
},
|
|
5198
|
+
{
|
|
5199
|
+
"figma": "State",
|
|
5200
|
+
"exempt": "interaction-state"
|
|
5201
|
+
}
|
|
5202
|
+
]
|
|
5203
|
+
}
|
|
5204
|
+
],
|
|
5205
|
+
"unmappedExports": [],
|
|
5206
|
+
"figmaOnly": []
|
|
5207
|
+
},
|
|
5208
|
+
"whenToUse": [
|
|
5209
|
+
"Turning a system feature or state on or off (notifications, dark mode)",
|
|
5210
|
+
"Settings panels made of binary features",
|
|
5211
|
+
"Binary preferences that typically apply immediately"
|
|
5212
|
+
]
|
|
2565
5213
|
},
|
|
2566
5214
|
{
|
|
2567
5215
|
"name": "Table",
|
|
@@ -2626,13 +5274,14 @@
|
|
|
2626
5274
|
"list table"
|
|
2627
5275
|
],
|
|
2628
5276
|
"whenToUse": [
|
|
2629
|
-
"Simple
|
|
2630
|
-
"
|
|
2631
|
-
"
|
|
5277
|
+
"Simple, fixed data in rows and columns (pricing comparisons)",
|
|
5278
|
+
"Fully controlled columns and rows that don't change interactively",
|
|
5279
|
+
"Static settings summaries and feature-comparison layouts"
|
|
2632
5280
|
],
|
|
2633
5281
|
"doNotUseFor": [
|
|
2634
|
-
"
|
|
2635
|
-
"
|
|
5282
|
+
"sorting, searching, filtering, or row selection (use DataTable)",
|
|
5283
|
+
"large or server-loaded datasets (use DataTable)",
|
|
5284
|
+
"item lists with icons and actions (use List)"
|
|
2636
5285
|
],
|
|
2637
5286
|
"alternatives": [
|
|
2638
5287
|
{
|
|
@@ -2652,6 +5301,101 @@
|
|
|
2652
5301
|
"keyboardInteraction": [
|
|
2653
5302
|
"Tab"
|
|
2654
5303
|
]
|
|
5304
|
+
},
|
|
5305
|
+
"figma": {
|
|
5306
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5307
|
+
"nodes": [
|
|
5308
|
+
{
|
|
5309
|
+
"nodeId": "28443:9292",
|
|
5310
|
+
"figmaName": "Table",
|
|
5311
|
+
"kind": "componentSet",
|
|
5312
|
+
"export": "Table",
|
|
5313
|
+
"note": "Duplicate Table set exists at 501:80592 (FIG-16) — mapped the newer node; confirm canonical with design",
|
|
5314
|
+
"axes": [
|
|
5315
|
+
{
|
|
5316
|
+
"figma": "Size",
|
|
5317
|
+
"exempt": "figma-only-style",
|
|
5318
|
+
"note": "Compact|Default density drawing with no code counterpart (FIG-17); code's size variant lives on cells and is drawn on the Table / Cell set"
|
|
5319
|
+
}
|
|
5320
|
+
]
|
|
5321
|
+
},
|
|
5322
|
+
{
|
|
5323
|
+
"nodeId": "190:898",
|
|
5324
|
+
"figmaName": "Table / Head",
|
|
5325
|
+
"kind": "componentSet",
|
|
5326
|
+
"export": "TableHead",
|
|
5327
|
+
"axes": [
|
|
5328
|
+
{
|
|
5329
|
+
"figma": "Right Text Align",
|
|
5330
|
+
"exempt": "figma-only-style",
|
|
5331
|
+
"note": "Boolean drawing of the align variant (left|right|center in code) — not value-mappable"
|
|
5332
|
+
},
|
|
5333
|
+
{
|
|
5334
|
+
"figma": "State",
|
|
5335
|
+
"exempt": "interaction-state"
|
|
5336
|
+
}
|
|
5337
|
+
]
|
|
5338
|
+
},
|
|
5339
|
+
{
|
|
5340
|
+
"nodeId": "190:901",
|
|
5341
|
+
"figmaName": "Table / Cell",
|
|
5342
|
+
"kind": "componentSet",
|
|
5343
|
+
"export": "TableCell",
|
|
5344
|
+
"axes": [
|
|
5345
|
+
{
|
|
5346
|
+
"figma": "Variant",
|
|
5347
|
+
"exempt": "figma-only-style",
|
|
5348
|
+
"note": "Cell content-type demos (Badge/Avatar/Switch/…) — consumer children in code"
|
|
5349
|
+
},
|
|
5350
|
+
{
|
|
5351
|
+
"figma": "Size",
|
|
5352
|
+
"code": "size"
|
|
5353
|
+
},
|
|
5354
|
+
{
|
|
5355
|
+
"figma": "State",
|
|
5356
|
+
"exempt": "interaction-state"
|
|
5357
|
+
},
|
|
5358
|
+
{
|
|
5359
|
+
"figma": "Last Cell",
|
|
5360
|
+
"exempt": "figma-only-style",
|
|
5361
|
+
"note": "Border drawing detail"
|
|
5362
|
+
},
|
|
5363
|
+
{
|
|
5364
|
+
"figma": "Right Text Align",
|
|
5365
|
+
"exempt": "figma-only-style",
|
|
5366
|
+
"note": "Boolean drawing of the align variant — not value-mappable"
|
|
5367
|
+
},
|
|
5368
|
+
{
|
|
5369
|
+
"figma": "Bold Text",
|
|
5370
|
+
"exempt": "figma-only-style",
|
|
5371
|
+
"note": "Typography emphasis drawing, className in code"
|
|
5372
|
+
}
|
|
5373
|
+
]
|
|
5374
|
+
}
|
|
5375
|
+
],
|
|
5376
|
+
"unmappedExports": [
|
|
5377
|
+
{
|
|
5378
|
+
"export": "TableHeader",
|
|
5379
|
+
"reason": "Structural (thead), drawn implicitly as the head row"
|
|
5380
|
+
},
|
|
5381
|
+
{
|
|
5382
|
+
"export": "TableBody",
|
|
5383
|
+
"reason": "Structural (tbody), drawn implicitly"
|
|
5384
|
+
},
|
|
5385
|
+
{
|
|
5386
|
+
"export": "TableFooter",
|
|
5387
|
+
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
5388
|
+
},
|
|
5389
|
+
{
|
|
5390
|
+
"export": "TableRow",
|
|
5391
|
+
"reason": "Structural (tr), drawn implicitly as cell rows"
|
|
5392
|
+
},
|
|
5393
|
+
{
|
|
5394
|
+
"export": "TableCaption",
|
|
5395
|
+
"reason": "No standalone Figma representation found (2026-08-18)"
|
|
5396
|
+
}
|
|
5397
|
+
],
|
|
5398
|
+
"figmaOnly": []
|
|
2655
5399
|
}
|
|
2656
5400
|
},
|
|
2657
5401
|
{
|
|
@@ -2681,8 +5425,9 @@
|
|
|
2681
5425
|
"tabbed interface"
|
|
2682
5426
|
],
|
|
2683
5427
|
"doNotUseFor": [
|
|
2684
|
-
"
|
|
2685
|
-
"
|
|
5428
|
+
"sections that must be completed in order (use Stepper)",
|
|
5429
|
+
"content users need to compare side by side (use a grid or Split Layout)",
|
|
5430
|
+
"a single section (show the content directly)"
|
|
2686
5431
|
],
|
|
2687
5432
|
"replaces": [],
|
|
2688
5433
|
"states": [
|
|
@@ -2695,7 +5440,55 @@
|
|
|
2695
5440
|
"Arrow keys",
|
|
2696
5441
|
"Tab"
|
|
2697
5442
|
]
|
|
2698
|
-
}
|
|
5443
|
+
},
|
|
5444
|
+
"figma": {
|
|
5445
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5446
|
+
"nodes": [
|
|
5447
|
+
{
|
|
5448
|
+
"nodeId": "183:539",
|
|
5449
|
+
"figmaName": "Tabs",
|
|
5450
|
+
"kind": "component",
|
|
5451
|
+
"export": "Tabs",
|
|
5452
|
+
"note": "Figma node is a demo composition"
|
|
5453
|
+
},
|
|
5454
|
+
{
|
|
5455
|
+
"nodeId": "183:532",
|
|
5456
|
+
"figmaName": "Tabs / Trigger",
|
|
5457
|
+
"kind": "componentSet",
|
|
5458
|
+
"export": "TabsTrigger",
|
|
5459
|
+
"axes": [
|
|
5460
|
+
{
|
|
5461
|
+
"figma": "Active",
|
|
5462
|
+
"exempt": "interaction-state",
|
|
5463
|
+
"note": "data-state=active runtime state"
|
|
5464
|
+
},
|
|
5465
|
+
{
|
|
5466
|
+
"figma": "State",
|
|
5467
|
+
"exempt": "interaction-state",
|
|
5468
|
+
"valueToProp": {
|
|
5469
|
+
"Disabled": "disabled"
|
|
5470
|
+
}
|
|
5471
|
+
}
|
|
5472
|
+
]
|
|
5473
|
+
}
|
|
5474
|
+
],
|
|
5475
|
+
"unmappedExports": [
|
|
5476
|
+
{
|
|
5477
|
+
"export": "TabsList",
|
|
5478
|
+
"reason": "Drawn implicitly as the trigger row in the Tabs demo node"
|
|
5479
|
+
},
|
|
5480
|
+
{
|
|
5481
|
+
"export": "TabsContent",
|
|
5482
|
+
"reason": "Consumer content panel, no standalone Figma representation"
|
|
5483
|
+
}
|
|
5484
|
+
],
|
|
5485
|
+
"figmaOnly": []
|
|
5486
|
+
},
|
|
5487
|
+
"whenToUse": [
|
|
5488
|
+
"Switching between different views of the same thing (Overview / Settings)",
|
|
5489
|
+
"Reducing clutter by showing one panel at a time while keeping others one click away",
|
|
5490
|
+
"Organizing related content into clearly labeled sections"
|
|
5491
|
+
]
|
|
2699
5492
|
},
|
|
2700
5493
|
{
|
|
2701
5494
|
"name": "Textarea",
|
|
@@ -2710,7 +5503,42 @@
|
|
|
2710
5503
|
"props": [
|
|
2711
5504
|
"error"
|
|
2712
5505
|
],
|
|
2713
|
-
"description": "Multi-line text input"
|
|
5506
|
+
"description": "Multi-line text input",
|
|
5507
|
+
"figma": {
|
|
5508
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5509
|
+
"nodes": [
|
|
5510
|
+
{
|
|
5511
|
+
"nodeId": "183:74",
|
|
5512
|
+
"figmaName": "Textarea",
|
|
5513
|
+
"kind": "componentSet",
|
|
5514
|
+
"export": "Textarea",
|
|
5515
|
+
"note": "Draws the field with label/description scaffolding (TEXT/BOOLEAN props, exempt)",
|
|
5516
|
+
"axes": [
|
|
5517
|
+
{
|
|
5518
|
+
"figma": "State",
|
|
5519
|
+
"exempt": "interaction-state",
|
|
5520
|
+
"valueToProp": {
|
|
5521
|
+
"Disabled": "disabled",
|
|
5522
|
+
"Error": "error"
|
|
5523
|
+
},
|
|
5524
|
+
"note": "Filled and Error (Focus) are runtime/combination states — stay exempt"
|
|
5525
|
+
}
|
|
5526
|
+
]
|
|
5527
|
+
}
|
|
5528
|
+
],
|
|
5529
|
+
"unmappedExports": [],
|
|
5530
|
+
"figmaOnly": []
|
|
5531
|
+
},
|
|
5532
|
+
"whenToUse": [
|
|
5533
|
+
"Typing more than one line of text (comment, message, longer description, feedback)",
|
|
5534
|
+
"Answers expected to be a paragraph rather than a short phrase",
|
|
5535
|
+
"Free-form notes fields from a sentence to a few paragraphs"
|
|
5536
|
+
],
|
|
5537
|
+
"doNotUseFor": [
|
|
5538
|
+
"text that fits on one line (use Input)",
|
|
5539
|
+
"lists of separate short items (use InputList or InputChip)",
|
|
5540
|
+
"content needing strict formatting or structure (use a structured input)"
|
|
5541
|
+
]
|
|
2714
5542
|
},
|
|
2715
5543
|
{
|
|
2716
5544
|
"name": "TextRevealMotion",
|
|
@@ -2733,7 +5561,22 @@
|
|
|
2733
5561
|
"TextRevealMotion": {
|
|
2734
5562
|
"loadingLabel": "string — default: \"Loading\""
|
|
2735
5563
|
}
|
|
2736
|
-
}
|
|
5564
|
+
},
|
|
5565
|
+
"figma": {
|
|
5566
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5567
|
+
"status": "code-only",
|
|
5568
|
+
"reason": "Runtime text-shimmer animation — not representable as a static Figma component. Verified 2026-08-18: no Figma node exists."
|
|
5569
|
+
},
|
|
5570
|
+
"whenToUse": [
|
|
5571
|
+
"Short animated loading moments that want personality (multi-stage report-generation loader)",
|
|
5572
|
+
"Marketing or product moments where delight during a wait state is desired",
|
|
5573
|
+
"Cycling through a few short status phrases with a distinctive animated treatment"
|
|
5574
|
+
],
|
|
5575
|
+
"doNotUseFor": [
|
|
5576
|
+
"quick or frequent loading states (use a plain spinner or Skeleton)",
|
|
5577
|
+
"determinate percentage progress (use Progress)",
|
|
5578
|
+
"minimal-motion contexts (prefer a simpler static state)"
|
|
5579
|
+
]
|
|
2737
5580
|
},
|
|
2738
5581
|
{
|
|
2739
5582
|
"name": "Toggle",
|
|
@@ -2760,7 +5603,48 @@
|
|
|
2760
5603
|
"onPressedChange",
|
|
2761
5604
|
"ariaLabel"
|
|
2762
5605
|
],
|
|
2763
|
-
"description": "Toggle button"
|
|
5606
|
+
"description": "Toggle button",
|
|
5607
|
+
"figma": {
|
|
5608
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5609
|
+
"nodes": [
|
|
5610
|
+
{
|
|
5611
|
+
"nodeId": "124:27",
|
|
5612
|
+
"figmaName": "Toggle",
|
|
5613
|
+
"kind": "componentSet",
|
|
5614
|
+
"export": "Toggle",
|
|
5615
|
+
"axes": [
|
|
5616
|
+
{
|
|
5617
|
+
"figma": "Variant",
|
|
5618
|
+
"code": "variant"
|
|
5619
|
+
},
|
|
5620
|
+
{
|
|
5621
|
+
"figma": "Size",
|
|
5622
|
+
"code": "size"
|
|
5623
|
+
},
|
|
5624
|
+
{
|
|
5625
|
+
"figma": "State",
|
|
5626
|
+
"exempt": "interaction-state",
|
|
5627
|
+
"valueToProp": {
|
|
5628
|
+
"Pressed": "pressed",
|
|
5629
|
+
"Disabled": "disabled"
|
|
5630
|
+
},
|
|
5631
|
+
"note": "Figma State=Pressed doubles as the data-state=on drawing (there is no separate On value) — lifted to the `pressed` prop, Button precedent"
|
|
5632
|
+
}
|
|
5633
|
+
]
|
|
5634
|
+
}
|
|
5635
|
+
],
|
|
5636
|
+
"unmappedExports": [],
|
|
5637
|
+
"figmaOnly": []
|
|
5638
|
+
},
|
|
5639
|
+
"whenToUse": [
|
|
5640
|
+
"A single button that stays pressed after clicking (bold, italic formatting)",
|
|
5641
|
+
"Lightweight on/off view controls inside a toolbar",
|
|
5642
|
+
"Standalone toggles that need a visible border (outline variant)"
|
|
5643
|
+
],
|
|
5644
|
+
"doNotUseFor": [
|
|
5645
|
+
"settings in a form (use Switch or Checkbox)",
|
|
5646
|
+
"groups where only one option can be active (use ToggleGroup)"
|
|
5647
|
+
]
|
|
2764
5648
|
},
|
|
2765
5649
|
{
|
|
2766
5650
|
"name": "ToggleGroup",
|
|
@@ -2774,7 +5658,7 @@
|
|
|
2774
5658
|
"dataHookRequired": true,
|
|
2775
5659
|
"variants": {
|
|
2776
5660
|
"variant": [
|
|
2777
|
-
"
|
|
5661
|
+
"simple",
|
|
2778
5662
|
"outline"
|
|
2779
5663
|
],
|
|
2780
5664
|
"size": [
|
|
@@ -2791,7 +5675,35 @@
|
|
|
2791
5675
|
"value",
|
|
2792
5676
|
"onValueChange"
|
|
2793
5677
|
],
|
|
2794
|
-
"description": "Group of toggle buttons"
|
|
5678
|
+
"description": "Group of toggle buttons",
|
|
5679
|
+
"figma": {
|
|
5680
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5681
|
+
"nodes": [
|
|
5682
|
+
{
|
|
5683
|
+
"nodeId": "132:946",
|
|
5684
|
+
"figmaName": "Toggle Group",
|
|
5685
|
+
"kind": "component",
|
|
5686
|
+
"export": "ToggleGroup",
|
|
5687
|
+
"note": "Assembled from Toggle instances — the variant/size axes are drawn on the Toggle set (mapped under Toggle). Code's `type` variant (single|multiple) is behavioral, intentionally no Figma axis."
|
|
5688
|
+
}
|
|
5689
|
+
],
|
|
5690
|
+
"unmappedExports": [
|
|
5691
|
+
{
|
|
5692
|
+
"export": "ToggleGroupItem",
|
|
5693
|
+
"reason": "Drawn as instances of the Toggle component inside 'Toggle Group', not a standalone Figma component"
|
|
5694
|
+
}
|
|
5695
|
+
],
|
|
5696
|
+
"figmaOnly": []
|
|
5697
|
+
},
|
|
5698
|
+
"whenToUse": [
|
|
5699
|
+
"A row of connected button-style choices (view or alignment switches)",
|
|
5700
|
+
"Picking one or a few options from a small always-visible set",
|
|
5701
|
+
"Segmented controls inside a toolbar"
|
|
5702
|
+
],
|
|
5703
|
+
"doNotUseFor": [
|
|
5704
|
+
"more than a handful of options (use Select or Combobox)",
|
|
5705
|
+
"a single binary choice (use Toggle or Switch)"
|
|
5706
|
+
]
|
|
2795
5707
|
},
|
|
2796
5708
|
{
|
|
2797
5709
|
"name": "Tooltip",
|
|
@@ -2820,8 +5732,9 @@
|
|
|
2820
5732
|
"help text"
|
|
2821
5733
|
],
|
|
2822
5734
|
"doNotUseFor": [
|
|
2823
|
-
"
|
|
2824
|
-
"
|
|
5735
|
+
"clickable content like links or buttons (use Popover)",
|
|
5736
|
+
"content longer than a sentence (use HoverCard or Popover)",
|
|
5737
|
+
"critical info for touch-only users (hover has no touch equivalent)"
|
|
2825
5738
|
],
|
|
2826
5739
|
"replaces": [
|
|
2827
5740
|
"title attribute"
|
|
@@ -2836,56 +5749,188 @@
|
|
|
2836
5749
|
"keyboardInteraction": [
|
|
2837
5750
|
"Escape"
|
|
2838
5751
|
]
|
|
5752
|
+
},
|
|
5753
|
+
"figma": {
|
|
5754
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5755
|
+
"nodes": [
|
|
5756
|
+
{
|
|
5757
|
+
"nodeId": "17103:809",
|
|
5758
|
+
"figmaName": "Tooltip",
|
|
5759
|
+
"kind": "componentSet",
|
|
5760
|
+
"export": "Tooltip",
|
|
5761
|
+
"axes": [
|
|
5762
|
+
{
|
|
5763
|
+
"figma": "Side",
|
|
5764
|
+
"code": "side",
|
|
5765
|
+
"note": "side is an enum prop on TooltipContent, not a registered variant axis — registry-gap info expected (CODE-3 class); revisit when sub-part variants get a registry home"
|
|
5766
|
+
}
|
|
5767
|
+
]
|
|
5768
|
+
}
|
|
5769
|
+
],
|
|
5770
|
+
"unmappedExports": [
|
|
5771
|
+
{
|
|
5772
|
+
"export": "TooltipProvider",
|
|
5773
|
+
"reason": "Non-rendering context provider"
|
|
5774
|
+
},
|
|
5775
|
+
{
|
|
5776
|
+
"export": "TooltipTrigger",
|
|
5777
|
+
"reason": "Unstyled asChild wrapper — the consumer's element is the trigger"
|
|
5778
|
+
},
|
|
5779
|
+
{
|
|
5780
|
+
"export": "TooltipContent",
|
|
5781
|
+
"reason": "Drawn by the Tooltip set (the bubble); its side prop is declared on the set's Side axis"
|
|
5782
|
+
}
|
|
5783
|
+
],
|
|
5784
|
+
"figmaOnly": []
|
|
5785
|
+
},
|
|
5786
|
+
"whenToUse": [
|
|
5787
|
+
"Short hints on hover or keyboard focus (icon-only buttons)",
|
|
5788
|
+
"Clarifying abbreviations or truncated text without taking up space",
|
|
5789
|
+
"Giving keyboard and screen-reader users the same context as hover"
|
|
5790
|
+
]
|
|
5791
|
+
},
|
|
5792
|
+
{
|
|
5793
|
+
"name": "Typography",
|
|
5794
|
+
"import": "@brightlocal/ui-components/typography",
|
|
5795
|
+
"category": "display",
|
|
5796
|
+
"exports": [
|
|
5797
|
+
"TypographyH1",
|
|
5798
|
+
"TypographyH2",
|
|
5799
|
+
"TypographyH3",
|
|
5800
|
+
"TypographyH4",
|
|
5801
|
+
"TypographyP",
|
|
5802
|
+
"TypographyBlockquote",
|
|
5803
|
+
"TypographyList",
|
|
5804
|
+
"TypographyInlineCode",
|
|
5805
|
+
"TypographyCode",
|
|
5806
|
+
"TypographyLead",
|
|
5807
|
+
"TypographyLarge",
|
|
5808
|
+
"TypographySmall",
|
|
5809
|
+
"TypographyMuted"
|
|
5810
|
+
],
|
|
5811
|
+
"compound": true,
|
|
5812
|
+
"dataHookRequired": true,
|
|
5813
|
+
"variants": {
|
|
5814
|
+
"align": [
|
|
5815
|
+
"left",
|
|
5816
|
+
"center",
|
|
5817
|
+
"right"
|
|
5818
|
+
]
|
|
5819
|
+
},
|
|
5820
|
+
"props": [
|
|
5821
|
+
"asChild",
|
|
5822
|
+
"align"
|
|
5823
|
+
],
|
|
5824
|
+
"description": "Semantic text components for headings, paragraphs, and inline styles",
|
|
5825
|
+
"whenToUse": [
|
|
5826
|
+
"Page and section headings that follow the design system type scale (H1-H4)",
|
|
5827
|
+
"Body copy, intros, and secondary text (P, Lead, Large, Small, Muted)",
|
|
5828
|
+
"Quoting someone's words with a distinct visual treatment (Blockquote)",
|
|
5829
|
+
"Referencing exact syntax, commands, or literal values (InlineCode, Code)"
|
|
5830
|
+
],
|
|
5831
|
+
"doNotUseFor": [
|
|
5832
|
+
"form field labels (use Label or Field)",
|
|
5833
|
+
"bold marketing-style pull-quotes (use Callout)",
|
|
5834
|
+
"validation error text (use Field's error styling)"
|
|
5835
|
+
],
|
|
5836
|
+
"alternatives": [
|
|
5837
|
+
{
|
|
5838
|
+
"component": "Label",
|
|
5839
|
+
"rule": "Use Label for form input labels — Typography is for content headings and body text"
|
|
5840
|
+
}
|
|
5841
|
+
],
|
|
5842
|
+
"figma": {
|
|
5843
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
5844
|
+
"nodes": [
|
|
5845
|
+
{
|
|
5846
|
+
"nodeId": "30021:14432",
|
|
5847
|
+
"figmaName": "Typography / H1",
|
|
5848
|
+
"kind": "component",
|
|
5849
|
+
"export": "TypographyH1",
|
|
5850
|
+
"note": "Code's align variant (left|center|right) has no Figma axis on any typography part — single drawing per part"
|
|
5851
|
+
},
|
|
5852
|
+
{
|
|
5853
|
+
"nodeId": "26:216",
|
|
5854
|
+
"figmaName": "Typography / H2",
|
|
5855
|
+
"kind": "component",
|
|
5856
|
+
"export": "TypographyH2"
|
|
5857
|
+
},
|
|
5858
|
+
{
|
|
5859
|
+
"nodeId": "26:225",
|
|
5860
|
+
"figmaName": "Typography / H3",
|
|
5861
|
+
"kind": "component",
|
|
5862
|
+
"export": "TypographyH3"
|
|
5863
|
+
},
|
|
5864
|
+
{
|
|
5865
|
+
"nodeId": "26:234",
|
|
5866
|
+
"figmaName": "Typography / H4",
|
|
5867
|
+
"kind": "component",
|
|
5868
|
+
"export": "TypographyH4"
|
|
5869
|
+
},
|
|
5870
|
+
{
|
|
5871
|
+
"nodeId": "26:239",
|
|
5872
|
+
"figmaName": "Typography / P",
|
|
5873
|
+
"kind": "component",
|
|
5874
|
+
"export": "TypographyP"
|
|
5875
|
+
},
|
|
5876
|
+
{
|
|
5877
|
+
"nodeId": "26:245",
|
|
5878
|
+
"figmaName": "Typography / Blockquote",
|
|
5879
|
+
"kind": "component",
|
|
5880
|
+
"export": "TypographyBlockquote"
|
|
5881
|
+
},
|
|
5882
|
+
{
|
|
5883
|
+
"nodeId": "26:281",
|
|
5884
|
+
"figmaName": "Typography / List",
|
|
5885
|
+
"kind": "component",
|
|
5886
|
+
"export": "TypographyList"
|
|
5887
|
+
},
|
|
5888
|
+
{
|
|
5889
|
+
"nodeId": "37:58",
|
|
5890
|
+
"figmaName": "Typography / InlineCode",
|
|
5891
|
+
"kind": "component",
|
|
5892
|
+
"export": "TypographyInlineCode"
|
|
5893
|
+
},
|
|
5894
|
+
{
|
|
5895
|
+
"nodeId": "40:330",
|
|
5896
|
+
"figmaName": "Typography / Code",
|
|
5897
|
+
"kind": "component",
|
|
5898
|
+
"export": "TypographyCode"
|
|
5899
|
+
},
|
|
5900
|
+
{
|
|
5901
|
+
"nodeId": "26:314",
|
|
5902
|
+
"figmaName": "Typography / Lead",
|
|
5903
|
+
"kind": "component",
|
|
5904
|
+
"export": "TypographyLead"
|
|
5905
|
+
},
|
|
5906
|
+
{
|
|
5907
|
+
"nodeId": "26:319",
|
|
5908
|
+
"figmaName": "Typography / Large",
|
|
5909
|
+
"kind": "component",
|
|
5910
|
+
"export": "TypographyLarge"
|
|
5911
|
+
},
|
|
5912
|
+
{
|
|
5913
|
+
"nodeId": "26:324",
|
|
5914
|
+
"figmaName": "Typography / Small",
|
|
5915
|
+
"kind": "component",
|
|
5916
|
+
"export": "TypographySmall"
|
|
5917
|
+
},
|
|
5918
|
+
{
|
|
5919
|
+
"nodeId": "36:56",
|
|
5920
|
+
"figmaName": "Typography / Muted",
|
|
5921
|
+
"kind": "component",
|
|
5922
|
+
"export": "TypographyMuted"
|
|
5923
|
+
}
|
|
5924
|
+
],
|
|
5925
|
+
"unmappedExports": [],
|
|
5926
|
+
"figmaOnly": [
|
|
5927
|
+
{
|
|
5928
|
+
"nodeId": "468:5324",
|
|
5929
|
+
"figmaName": "Typography / Rich Text",
|
|
5930
|
+
"reason": "Composition demo of multiple typography parts"
|
|
5931
|
+
}
|
|
5932
|
+
]
|
|
2839
5933
|
}
|
|
2840
|
-
},
|
|
2841
|
-
{
|
|
2842
|
-
"name": "Typography",
|
|
2843
|
-
"import": "@brightlocal/ui-components/typography",
|
|
2844
|
-
"category": "display",
|
|
2845
|
-
"exports": [
|
|
2846
|
-
"TypographyH1",
|
|
2847
|
-
"TypographyH2",
|
|
2848
|
-
"TypographyH3",
|
|
2849
|
-
"TypographyH4",
|
|
2850
|
-
"TypographyP",
|
|
2851
|
-
"TypographyBlockquote",
|
|
2852
|
-
"TypographyList",
|
|
2853
|
-
"TypographyInlineCode",
|
|
2854
|
-
"TypographyCode",
|
|
2855
|
-
"TypographyLead",
|
|
2856
|
-
"TypographyLarge",
|
|
2857
|
-
"TypographySmall",
|
|
2858
|
-
"TypographyMuted"
|
|
2859
|
-
],
|
|
2860
|
-
"compound": true,
|
|
2861
|
-
"dataHookRequired": true,
|
|
2862
|
-
"variants": {
|
|
2863
|
-
"align": [
|
|
2864
|
-
"left",
|
|
2865
|
-
"center",
|
|
2866
|
-
"right"
|
|
2867
|
-
]
|
|
2868
|
-
},
|
|
2869
|
-
"props": [
|
|
2870
|
-
"asChild",
|
|
2871
|
-
"align"
|
|
2872
|
-
],
|
|
2873
|
-
"description": "Semantic text components for headings, paragraphs, and inline styles",
|
|
2874
|
-
"whenToUse": [
|
|
2875
|
-
"Page and section headings (H1–H4) with consistent font and spacing",
|
|
2876
|
-
"Body text, lead text, muted captions, and inline code",
|
|
2877
|
-
"Any heading or paragraph that should follow the design system type scale"
|
|
2878
|
-
],
|
|
2879
|
-
"doNotUseFor": [
|
|
2880
|
-
"display-sized hero text larger than H1 — not yet covered, use custom Tailwind classes",
|
|
2881
|
-
"form labels (use Label or FieldLabel)"
|
|
2882
|
-
],
|
|
2883
|
-
"alternatives": [
|
|
2884
|
-
{
|
|
2885
|
-
"component": "Label",
|
|
2886
|
-
"rule": "Use Label for form input labels — Typography is for content headings and body text"
|
|
2887
|
-
}
|
|
2888
|
-
]
|
|
2889
5934
|
}
|
|
2890
5935
|
],
|
|
2891
5936
|
"blocks": [
|
|
@@ -2914,7 +5959,55 @@
|
|
|
2914
5959
|
"InputListItems": {
|
|
2915
5960
|
"removeAriaLabel": "string — default: \"Remove {item}\""
|
|
2916
5961
|
}
|
|
2917
|
-
}
|
|
5962
|
+
},
|
|
5963
|
+
"whenToUse": [
|
|
5964
|
+
"Adding and removing a flexible list of short text items, like keywords, including multi-line paste",
|
|
5965
|
+
"Onboarding flows where users build a list one item at a time",
|
|
5966
|
+
"Dynamic, user-controlled entry counts not fixed in advance"
|
|
5967
|
+
],
|
|
5968
|
+
"doNotUseFor": [
|
|
5969
|
+
"a fixed, known number of items (use separate Field/Input pairs)",
|
|
5970
|
+
"inline removable chips instead of a vertical list (use InputChip)",
|
|
5971
|
+
"read-only display of items (use List)"
|
|
5972
|
+
]
|
|
5973
|
+
},
|
|
5974
|
+
{
|
|
5975
|
+
"name": "ProgressScreen",
|
|
5976
|
+
"import": "@brightlocal/ui-components/progress-screen",
|
|
5977
|
+
"category": "block",
|
|
5978
|
+
"exports": [
|
|
5979
|
+
"ProgressScreen"
|
|
5980
|
+
],
|
|
5981
|
+
"compound": false,
|
|
5982
|
+
"dataHookRequired": true,
|
|
5983
|
+
"variants": {},
|
|
5984
|
+
"props": [
|
|
5985
|
+
"illustration",
|
|
5986
|
+
"title",
|
|
5987
|
+
"description",
|
|
5988
|
+
"value",
|
|
5989
|
+
"max",
|
|
5990
|
+
"progressStatusDescription",
|
|
5991
|
+
"progressUnit",
|
|
5992
|
+
"showProgressValue",
|
|
5993
|
+
"className"
|
|
5994
|
+
],
|
|
5995
|
+
"description": "Generation screen: an illustration, title and description in a centred column — the tool's illustration over a determinate bar when the backend reports a percentage, and a built-in cel animation with neither bar nor status line when it does not",
|
|
5996
|
+
"i18nProps": {
|
|
5997
|
+
"ProgressScreen": {
|
|
5998
|
+
"progressLabel": "string — default: \"Generation progress\""
|
|
5999
|
+
}
|
|
6000
|
+
},
|
|
6001
|
+
"whenToUse": [
|
|
6002
|
+
"A report or account setup that generates for minutes on a first run, with nothing on screen yet",
|
|
6003
|
+
"A section that generates while the rest of the page stays live",
|
|
6004
|
+
"Any tool needing the same generation screen as the others: LSG, Local AI Visibility, Citation Tracker, Rankings"
|
|
6005
|
+
],
|
|
6006
|
+
"doNotUseFor": [
|
|
6007
|
+
"fetching data for seconds (use Skeleton, which mirrors the geometry that is coming)",
|
|
6008
|
+
"a re-run over content already on screen (keep the data at full contrast and use Button loading on the trigger)",
|
|
6009
|
+
"a single control processing its own wait (use Button loading or Spinner)"
|
|
6010
|
+
]
|
|
2918
6011
|
},
|
|
2919
6012
|
{
|
|
2920
6013
|
"name": "Sidebar",
|
|
@@ -3001,7 +6094,315 @@
|
|
|
3001
6094
|
"triggerAriaLabel": "string — default: \"Account menu\""
|
|
3002
6095
|
}
|
|
3003
6096
|
},
|
|
3004
|
-
"description": "Complex sidebar navigation with collapsible support"
|
|
6097
|
+
"description": "Complex sidebar navigation with collapsible support",
|
|
6098
|
+
"figma": {
|
|
6099
|
+
"fileKey": "p3krmC8DBUgqpbq6cLzaal",
|
|
6100
|
+
"nodes": [
|
|
6101
|
+
{
|
|
6102
|
+
"nodeId": "5198:1113",
|
|
6103
|
+
"figmaName": "SidebarMenuButton",
|
|
6104
|
+
"kind": "componentSet",
|
|
6105
|
+
"export": "SidebarMenuButton",
|
|
6106
|
+
"axes": [
|
|
6107
|
+
{
|
|
6108
|
+
"figma": "Type",
|
|
6109
|
+
"code": "SidebarMenuButton.variant",
|
|
6110
|
+
"valueAliases": {
|
|
6111
|
+
"Big Icon": "bigIcon"
|
|
6112
|
+
},
|
|
6113
|
+
"note": "Sub-part axis with no flat registry home (CODE-3 class) — hand-verified 2026-08-19: Simple|Collapsible|Dropdown|Badge|Big Icon|Checkbox = code simple|collapsible|dropdown|badge|bigIcon|checkbox. Code size axis (default|sm|lg) is not drawn at all (FIG-20)."
|
|
6114
|
+
},
|
|
6115
|
+
{
|
|
6116
|
+
"figma": "State",
|
|
6117
|
+
"exempt": "interaction-state"
|
|
6118
|
+
},
|
|
6119
|
+
{
|
|
6120
|
+
"figma": "Collapsed",
|
|
6121
|
+
"exempt": "interaction-state",
|
|
6122
|
+
"note": "Icon-collapsed rendering; code expresses it via CSS group-data-[collapsible=icon] from SidebarProvider state, not a prop"
|
|
6123
|
+
}
|
|
6124
|
+
]
|
|
6125
|
+
},
|
|
6126
|
+
{
|
|
6127
|
+
"nodeId": "5198:1398",
|
|
6128
|
+
"figmaName": "SidebarGroupLabel",
|
|
6129
|
+
"kind": "componentSet",
|
|
6130
|
+
"export": "SidebarGroupLabel",
|
|
6131
|
+
"axes": [
|
|
6132
|
+
{
|
|
6133
|
+
"figma": "Type",
|
|
6134
|
+
"code": "SidebarGroupLabel.variant",
|
|
6135
|
+
"note": "Sub-part axis (CODE-3 class) — hand-verified 2026-08-19: Default|Collapsible|Action = code default|collapsible|action"
|
|
6136
|
+
},
|
|
6137
|
+
{
|
|
6138
|
+
"figma": "State",
|
|
6139
|
+
"exempt": "interaction-state"
|
|
6140
|
+
},
|
|
6141
|
+
{
|
|
6142
|
+
"figma": "Text Size",
|
|
6143
|
+
"code": "SidebarGroupLabel.size",
|
|
6144
|
+
"note": "Sub-part axis (CODE-3 class) — hand-verified 2026-08-19: sm|xs drawn; code 'default' value is not drawn (FIG-20)"
|
|
6145
|
+
}
|
|
6146
|
+
]
|
|
6147
|
+
},
|
|
6148
|
+
{
|
|
6149
|
+
"nodeId": "5198:1446",
|
|
6150
|
+
"figmaName": "SidebarMenuSub",
|
|
6151
|
+
"kind": "componentSet",
|
|
6152
|
+
"export": "SidebarMenuSub",
|
|
6153
|
+
"axes": [
|
|
6154
|
+
{
|
|
6155
|
+
"figma": "Type",
|
|
6156
|
+
"code": "SidebarMenuSub.variant",
|
|
6157
|
+
"note": "Sub-part axis (CODE-3 class) — hand-verified 2026-08-19: Border|Default|Indent = code border|default|indent"
|
|
6158
|
+
}
|
|
6159
|
+
]
|
|
6160
|
+
},
|
|
6161
|
+
{
|
|
6162
|
+
"nodeId": "5198:1510",
|
|
6163
|
+
"figmaName": "SidebarMenuItem",
|
|
6164
|
+
"kind": "componentSet",
|
|
6165
|
+
"export": "SidebarMenuItem",
|
|
6166
|
+
"axes": [
|
|
6167
|
+
{
|
|
6168
|
+
"figma": "CollapsibleTrigger",
|
|
6169
|
+
"exempt": "export-discriminator",
|
|
6170
|
+
"note": "True = the item embeds the SidebarMenuCollapsible family (trigger drawn via SidebarMenuButton Type=Collapsible); composition toggle modeled as a variant (FIG-19)"
|
|
6171
|
+
},
|
|
6172
|
+
{
|
|
6173
|
+
"figma": "Submenu",
|
|
6174
|
+
"exempt": "export-discriminator",
|
|
6175
|
+
"note": "True = the item composes SidebarMenuSub; composition toggle modeled as a variant (FIG-19)"
|
|
6176
|
+
}
|
|
6177
|
+
]
|
|
6178
|
+
},
|
|
6179
|
+
{
|
|
6180
|
+
"nodeId": "5198:1528",
|
|
6181
|
+
"figmaName": "SidebarGroup",
|
|
6182
|
+
"kind": "componentSet",
|
|
6183
|
+
"export": "SidebarGroup",
|
|
6184
|
+
"axes": [
|
|
6185
|
+
{
|
|
6186
|
+
"figma": "Collapsed",
|
|
6187
|
+
"exempt": "interaction-state",
|
|
6188
|
+
"note": "Icon-collapsed rendering; code expresses it via CSS group-data-[collapsible=icon] from SidebarProvider state, not a prop"
|
|
6189
|
+
}
|
|
6190
|
+
]
|
|
6191
|
+
},
|
|
6192
|
+
{
|
|
6193
|
+
"nodeId": "5198:1587",
|
|
6194
|
+
"figmaName": "SidebarMenuSubItem",
|
|
6195
|
+
"kind": "componentSet",
|
|
6196
|
+
"export": "SidebarMenuSubItem",
|
|
6197
|
+
"alsoRepresents": [
|
|
6198
|
+
"SidebarMenuSubButton"
|
|
6199
|
+
],
|
|
6200
|
+
"note": "The set draws the interactive sub link (code SidebarMenuSubButton) inside the li; SubButton's size axis (sm|md) is not drawn (FIG-20)",
|
|
6201
|
+
"axes": [
|
|
6202
|
+
{
|
|
6203
|
+
"figma": "State",
|
|
6204
|
+
"exempt": "interaction-state"
|
|
6205
|
+
}
|
|
6206
|
+
]
|
|
6207
|
+
},
|
|
6208
|
+
{
|
|
6209
|
+
"nodeId": "5198:1616",
|
|
6210
|
+
"figmaName": "SidebarGroupAction",
|
|
6211
|
+
"kind": "componentSet",
|
|
6212
|
+
"export": "SidebarGroupAction",
|
|
6213
|
+
"axes": [
|
|
6214
|
+
{
|
|
6215
|
+
"figma": "State",
|
|
6216
|
+
"exempt": "interaction-state"
|
|
6217
|
+
}
|
|
6218
|
+
]
|
|
6219
|
+
},
|
|
6220
|
+
{
|
|
6221
|
+
"nodeId": "5198:1651",
|
|
6222
|
+
"figmaName": "CollapseIcon",
|
|
6223
|
+
"kind": "componentSet",
|
|
6224
|
+
"export": "SidebarCollapseIcon",
|
|
6225
|
+
"axes": [
|
|
6226
|
+
{
|
|
6227
|
+
"figma": "Type",
|
|
6228
|
+
"code": "SidebarCollapseIcon.type",
|
|
6229
|
+
"valueAliases": {
|
|
6230
|
+
"Up Down": "upDown",
|
|
6231
|
+
"Plus Minus": "plusMinus"
|
|
6232
|
+
},
|
|
6233
|
+
"note": "Sub-part axis (CODE-3 class) — hand-verified 2026-08-19: Vertical|Up Down|Horizontal|Plus Minus|Caret; code 'dots' value is not drawn (FIG-20)"
|
|
6234
|
+
},
|
|
6235
|
+
{
|
|
6236
|
+
"figma": "Active",
|
|
6237
|
+
"exempt": "interaction-state"
|
|
6238
|
+
}
|
|
6239
|
+
]
|
|
6240
|
+
},
|
|
6241
|
+
{
|
|
6242
|
+
"nodeId": "5198:1668",
|
|
6243
|
+
"figmaName": "PopoverMenu",
|
|
6244
|
+
"kind": "component",
|
|
6245
|
+
"export": "SidebarPopoverMenu",
|
|
6246
|
+
"note": "Name lacks the Sidebar family prefix and collides with generic vocabulary (FIG-19)"
|
|
6247
|
+
},
|
|
6248
|
+
{
|
|
6249
|
+
"nodeId": "5198:1678",
|
|
6250
|
+
"figmaName": "Popover",
|
|
6251
|
+
"kind": "component",
|
|
6252
|
+
"export": "SidebarSwitcher",
|
|
6253
|
+
"note": "Assembled trigger + open teams menu matching code SidebarSwitcher's Popover composition; 'Open' BOOLEAN is a composition toggle, exempt by convention. Name collides with the standalone Popover component family (FIG-19)."
|
|
6254
|
+
},
|
|
6255
|
+
{
|
|
6256
|
+
"nodeId": "5198:1696",
|
|
6257
|
+
"figmaName": "PopoverMenuItem",
|
|
6258
|
+
"kind": "componentSet",
|
|
6259
|
+
"export": "SidebarPopoverMenuItem",
|
|
6260
|
+
"axes": [
|
|
6261
|
+
{
|
|
6262
|
+
"figma": "State",
|
|
6263
|
+
"exempt": "interaction-state"
|
|
6264
|
+
}
|
|
6265
|
+
]
|
|
6266
|
+
},
|
|
6267
|
+
{
|
|
6268
|
+
"nodeId": "5198:1724",
|
|
6269
|
+
"figmaName": "PopoverTrigger",
|
|
6270
|
+
"kind": "componentSet",
|
|
6271
|
+
"export": "SidebarPopoverTrigger",
|
|
6272
|
+
"axes": [
|
|
6273
|
+
{
|
|
6274
|
+
"figma": "State",
|
|
6275
|
+
"exempt": "interaction-state"
|
|
6276
|
+
}
|
|
6277
|
+
]
|
|
6278
|
+
},
|
|
6279
|
+
{
|
|
6280
|
+
"nodeId": "5198:1735",
|
|
6281
|
+
"figmaName": "Header Button",
|
|
6282
|
+
"kind": "componentSet",
|
|
6283
|
+
"export": "SidebarHeaderButton",
|
|
6284
|
+
"axes": [
|
|
6285
|
+
{
|
|
6286
|
+
"figma": "State",
|
|
6287
|
+
"exempt": "interaction-state"
|
|
6288
|
+
}
|
|
6289
|
+
]
|
|
6290
|
+
},
|
|
6291
|
+
{
|
|
6292
|
+
"nodeId": "5198:1754",
|
|
6293
|
+
"figmaName": "InboxItem",
|
|
6294
|
+
"kind": "componentSet",
|
|
6295
|
+
"export": "SidebarInboxItem",
|
|
6296
|
+
"axes": [
|
|
6297
|
+
{
|
|
6298
|
+
"figma": "State",
|
|
6299
|
+
"exempt": "interaction-state"
|
|
6300
|
+
}
|
|
6301
|
+
]
|
|
6302
|
+
},
|
|
6303
|
+
{
|
|
6304
|
+
"nodeId": "5198:1767",
|
|
6305
|
+
"figmaName": "AccountDropdown",
|
|
6306
|
+
"kind": "component",
|
|
6307
|
+
"export": "SidebarAccountDropdown"
|
|
6308
|
+
}
|
|
6309
|
+
],
|
|
6310
|
+
"unmappedExports": [
|
|
6311
|
+
{
|
|
6312
|
+
"export": "Sidebar",
|
|
6313
|
+
"reason": "Root panel drawn only as assembled non-component frames (e.g. 23973:2770) — no published Figma component; root variants side/variant/collapsible are single-valued or drawn via the sub-part Collapsed axes"
|
|
6314
|
+
},
|
|
6315
|
+
{
|
|
6316
|
+
"export": "SidebarProvider",
|
|
6317
|
+
"reason": "Context provider with no DOM of its own"
|
|
6318
|
+
},
|
|
6319
|
+
{
|
|
6320
|
+
"export": "SidebarTrigger",
|
|
6321
|
+
"reason": "Toggle icon-button; Figma draws the generic Header Button set (5198:1735, mapped to SidebarHeaderButton) with a swappable icon instead of a dedicated trigger node"
|
|
6322
|
+
},
|
|
6323
|
+
{
|
|
6324
|
+
"export": "SidebarRail",
|
|
6325
|
+
"reason": "Invisible drag/click rail — interaction-only, not drawn"
|
|
6326
|
+
},
|
|
6327
|
+
{
|
|
6328
|
+
"export": "SidebarInset",
|
|
6329
|
+
"reason": "Main-content wrapper (structural)"
|
|
6330
|
+
},
|
|
6331
|
+
{
|
|
6332
|
+
"export": "SidebarInput",
|
|
6333
|
+
"reason": "Wraps the Input component; drawn via the standalone Input family in Figma"
|
|
6334
|
+
},
|
|
6335
|
+
{
|
|
6336
|
+
"export": "SidebarHeader",
|
|
6337
|
+
"reason": "Structural layout container"
|
|
6338
|
+
},
|
|
6339
|
+
{
|
|
6340
|
+
"export": "SidebarFooter",
|
|
6341
|
+
"reason": "Structural layout container"
|
|
6342
|
+
},
|
|
6343
|
+
{
|
|
6344
|
+
"export": "SidebarSeparator",
|
|
6345
|
+
"reason": "Wraps Separator; drawn via the standalone Separator family in Figma"
|
|
6346
|
+
},
|
|
6347
|
+
{
|
|
6348
|
+
"export": "SidebarContent",
|
|
6349
|
+
"reason": "Structural scroll container"
|
|
6350
|
+
},
|
|
6351
|
+
{
|
|
6352
|
+
"export": "SidebarGroupContent",
|
|
6353
|
+
"reason": "Structural wrapper"
|
|
6354
|
+
},
|
|
6355
|
+
{
|
|
6356
|
+
"export": "SidebarMenu",
|
|
6357
|
+
"reason": "Structural ul wrapper"
|
|
6358
|
+
},
|
|
6359
|
+
{
|
|
6360
|
+
"export": "SidebarMenuAction",
|
|
6361
|
+
"reason": "Drawn inside the SidebarMenuButton set ('Dropdown' BOOLEAN toggle + Type=Dropdown), not standalone"
|
|
6362
|
+
},
|
|
6363
|
+
{
|
|
6364
|
+
"export": "SidebarMenuBadge",
|
|
6365
|
+
"reason": "Drawn inside the SidebarMenuButton set (Type=Badge + 'Badge Text' TEXT prop), not standalone"
|
|
6366
|
+
},
|
|
6367
|
+
{
|
|
6368
|
+
"export": "SidebarMenuSkeleton",
|
|
6369
|
+
"reason": "Loading placeholder — not drawn in the Sidebar family (the standalone Skeleton family covers it)"
|
|
6370
|
+
},
|
|
6371
|
+
{
|
|
6372
|
+
"export": "SidebarMenuCollapsible",
|
|
6373
|
+
"reason": "Accordion wrapper; drawn via SidebarMenuItem CollapsibleTrigger=True composition"
|
|
6374
|
+
},
|
|
6375
|
+
{
|
|
6376
|
+
"export": "SidebarMenuCollapsibleTrigger",
|
|
6377
|
+
"reason": "Drawn via SidebarMenuButton Type=Collapsible"
|
|
6378
|
+
},
|
|
6379
|
+
{
|
|
6380
|
+
"export": "SidebarMenuCollapsibleContent",
|
|
6381
|
+
"reason": "Structural reveal container; drawn via SidebarMenuItem Submenu=True composition"
|
|
6382
|
+
},
|
|
6383
|
+
{
|
|
6384
|
+
"export": "useSidebar",
|
|
6385
|
+
"reason": "React hook, not a visual component"
|
|
6386
|
+
}
|
|
6387
|
+
],
|
|
6388
|
+
"figmaOnly": [
|
|
6389
|
+
{
|
|
6390
|
+
"nodeId": "5198:1782",
|
|
6391
|
+
"figmaName": "MediaAsset",
|
|
6392
|
+
"reason": "Composition asset (Type=Avatar|Icon) filling the 'Media' INSTANCE_SWAP slot in sidebar items — consumer children in code"
|
|
6393
|
+
}
|
|
6394
|
+
]
|
|
6395
|
+
},
|
|
6396
|
+
"whenToUse": [
|
|
6397
|
+
"Primary navigation for an application shell (dashboards, admin panels)",
|
|
6398
|
+
"Offcanvas mode when the sidebar should fully hide to free the most space",
|
|
6399
|
+
"Icon mode when collapsing to icons keeps quick access to top-level sections",
|
|
6400
|
+
"None mode when navigation must always stay fully visible"
|
|
6401
|
+
],
|
|
6402
|
+
"doNotUseFor": [
|
|
6403
|
+
"simple, shallow navigation (a plain nav list may be simpler)",
|
|
6404
|
+
"small screens with a permanently visible sidebar (prefer Offcanvas over None)"
|
|
6405
|
+
]
|
|
3005
6406
|
}
|
|
3006
6407
|
],
|
|
3007
6408
|
"utilities": [
|