blip-tokens 2.3.0 → 2.4.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.
@@ -1,6 +1,39 @@
1
1
  {
2
+ "uai-accent-ai-end": {
3
+ "description": "Last stop of the AI accent gradient (cyan). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features.",
4
+ "type": "color",
5
+ "collection": "Colors",
6
+ "scopes": [
7
+ "FRAME_FILL",
8
+ "SHAPE_FILL",
9
+ "STROKE_COLOR"
10
+ ],
11
+ "figmaVariableId": "VariableID:271:32"
12
+ },
13
+ "uai-accent-ai-middle": {
14
+ "description": "Middle stop of the AI accent gradient (purple). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features.",
15
+ "type": "color",
16
+ "collection": "Colors",
17
+ "scopes": [
18
+ "FRAME_FILL",
19
+ "SHAPE_FILL",
20
+ "STROKE_COLOR"
21
+ ],
22
+ "figmaVariableId": "VariableID:271:31"
23
+ },
24
+ "uai-accent-ai-start": {
25
+ "description": "First stop of the AI accent gradient (blue). Same value in every theme. Use: borders and highlights of AI features: insight cards use start, middle and end; Brain actions use start to middle. Pair: content/primary for text over insight surfaces (overlay/insight). Avoid: body text color, status colors and non-AI features.",
26
+ "type": "color",
27
+ "collection": "Colors",
28
+ "scopes": [
29
+ "FRAME_FILL",
30
+ "SHAPE_FILL",
31
+ "STROKE_COLOR"
32
+ ],
33
+ "figmaVariableId": "VariableID:271:30"
34
+ },
2
35
  "uai-action-destructive": {
3
- "description": "Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces.",
36
+ "description": "Theme-aware destructive action accent. Use: background of filled destructive buttons, and text and border of outline or text destructive actions on standard surfaces. Pair: action/destructive-foreground on filled buttons, never fixed/bright. Avoid: error messages; use feedback/error.",
4
37
  "type": "color",
5
38
  "collection": "Colors",
6
39
  "scopes": [
@@ -12,7 +45,7 @@
12
45
  "figmaVariableId": "VariableID:2:290"
13
46
  },
14
47
  "uai-action-destructive-foreground": {
15
- "description": "Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright.",
48
+ "description": "Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright.",
16
49
  "type": "color",
17
50
  "collection": "Colors",
18
51
  "scopes": [
@@ -23,7 +56,7 @@
23
56
  "figmaVariableId": "VariableID:2:291"
24
57
  },
25
58
  "uai-action-outline-default": {
26
- "description": "Outline and text button background — default state.",
59
+ "description": "Theme-aware background of outline and text (ghost) actions, default state. Pair: content/primary for the label. States: action/outline/hover and action/outline/pressed.",
27
60
  "type": "color",
28
61
  "collection": "Colors",
29
62
  "scopes": [
@@ -33,7 +66,7 @@
33
66
  "figmaVariableId": "VariableID:2:287"
34
67
  },
35
68
  "uai-action-outline-hover": {
36
- "description": "Outline and text button background — hover state. Also list item hover.",
69
+ "description": "Theme-aware hover background of outline and text actions. Also the hover background of list and menu items.",
37
70
  "type": "color",
38
71
  "collection": "Colors",
39
72
  "scopes": [
@@ -43,7 +76,7 @@
43
76
  "figmaVariableId": "VariableID:2:288"
44
77
  },
45
78
  "uai-action-outline-pressed": {
46
- "description": "Outline and text button background — pressed state. Also selected list item.",
79
+ "description": "Theme-aware pressed background of outline and text actions. Also the background of the selected list or menu item.",
47
80
  "type": "color",
48
81
  "collection": "Colors",
49
82
  "scopes": [
@@ -53,7 +86,7 @@
53
86
  "figmaVariableId": "VariableID:2:289"
54
87
  },
55
88
  "uai-action-positive": {
56
- "description": "Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead.",
89
+ "description": "Theme-aware background of filled positive buttons. Pair: action/positive-foreground, never fixed/bright. Avoid: success text and outline or text actions; use feedback/success.",
57
90
  "type": "color",
58
91
  "collection": "Colors",
59
92
  "scopes": [
@@ -64,7 +97,7 @@
64
97
  "figmaVariableId": "VariableID:202:2"
65
98
  },
66
99
  "uai-action-positive-foreground": {
67
- "description": "Text and icons on action/positive. Theme-aware foreground for filled positive buttons.",
100
+ "description": "Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark.",
68
101
  "type": "color",
69
102
  "collection": "Colors",
70
103
  "scopes": [
@@ -74,7 +107,7 @@
74
107
  "figmaVariableId": "VariableID:202:3"
75
108
  },
76
109
  "uai-action-primary-default": {
77
- "description": "Primary button background — default state.",
110
+ "description": "Theme-aware background of primary actions, default state: solid uai-button and the checked checkbox fill. Neutral (near-black in Light), not brand blue. Pair: action/primary/foreground. States: action/primary/hover and action/primary/pressed.",
78
111
  "type": "color",
79
112
  "collection": "Colors",
80
113
  "scopes": [
@@ -84,7 +117,7 @@
84
117
  "figmaVariableId": "VariableID:2:283"
85
118
  },
86
119
  "uai-action-primary-foreground": {
87
- "description": "Text and icons on primary buttons.",
120
+ "description": "Theme-aware text and icon color on action/primary backgrounds, including the checkbox check mark. Avoid: fixed/bright or content/inverse on primary actions.",
88
121
  "type": "color",
89
122
  "collection": "Colors",
90
123
  "scopes": [
@@ -95,7 +128,7 @@
95
128
  "figmaVariableId": "VariableID:2:286"
96
129
  },
97
130
  "uai-action-primary-hover": {
98
- "description": "Primary button background — hover state.",
131
+ "description": "Theme-aware background of primary actions on hover. Use only as the hover state of action/primary/default. Pair: action/primary/foreground.",
99
132
  "type": "color",
100
133
  "collection": "Colors",
101
134
  "scopes": [
@@ -105,7 +138,7 @@
105
138
  "figmaVariableId": "VariableID:2:284"
106
139
  },
107
140
  "uai-action-primary-pressed": {
108
- "description": "Primary button background — pressed state.",
141
+ "description": "Theme-aware background of primary actions while pressed or active. Use only as the pressed state of action/primary/default. Pair: action/primary/foreground.",
109
142
  "type": "color",
110
143
  "collection": "Colors",
111
144
  "scopes": [
@@ -115,7 +148,7 @@
115
148
  "figmaVariableId": "VariableID:2:285"
116
149
  },
117
150
  "uai-border-default": {
118
- "description": "Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring.",
151
+ "description": "Theme-aware decorative border. Use: cards, dividers and separators. Avoid: as the only boundary of a form control or as the sole state indicator; use border/input or border/ring.",
119
152
  "type": "color",
120
153
  "collection": "Colors",
121
154
  "scopes": [
@@ -124,7 +157,7 @@
124
157
  "figmaVariableId": "VariableID:2:296"
125
158
  },
126
159
  "uai-border-input": {
127
- "description": "Essential form control boundary. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Do not use border/default as the only control boundary.",
160
+ "description": "Theme-aware essential boundary of form controls. Use: default borders of inputs, selects, checkboxes and radios. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: decorative dividers; use border/default.",
128
161
  "type": "color",
129
162
  "collection": "Colors",
130
163
  "scopes": [
@@ -133,7 +166,7 @@
133
166
  "figmaVariableId": "VariableID:2:297"
134
167
  },
135
168
  "uai-border-ring": {
136
- "description": "Solid neutral focus indicator, dark in Light and light in Dark. Use at full opacity. Inputs may add a separate outer halo with opacity/focus-ring, while keeping the solid focus border. Never reduce the opacity of the whole control.",
169
+ "description": "Theme-aware solid focus indicator: dark in Light, light in Dark. Use: focus border of inputs and focus outline of buttons, checkboxes and radios, always at full opacity. Inputs may add a separate outer halo with opacity/focus-ring. Avoid: reducing the opacity of the whole control.",
137
170
  "type": "color",
138
171
  "collection": "Colors",
139
172
  "scopes": [
@@ -142,7 +175,7 @@
142
175
  "figmaVariableId": "VariableID:2:298"
143
176
  },
144
177
  "uai-content-disabled": {
145
- "description": "Disabled text and icons.",
178
+ "description": "Theme-aware color for disabled text, icons and control borders (inputs, checkbox, radio). Avoid: placeholders (use content/placeholder) and readable secondary text, because disabled content is exempt from contrast rules.",
146
179
  "type": "color",
147
180
  "collection": "Colors",
148
181
  "scopes": [
@@ -153,7 +186,7 @@
153
186
  "figmaVariableId": "VariableID:2:279"
154
187
  },
155
188
  "uai-content-inverse": {
156
- "description": "Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary.",
189
+ "description": "Theme-aware text and icon color for inverted surfaces. Use: text and icons on surface/inverse, such as tooltips and snackbars. Avoid: labels on filled actions; use the matching action foreground token.",
157
190
  "type": "color",
158
191
  "collection": "Colors",
159
192
  "scopes": [
@@ -164,7 +197,7 @@
164
197
  "figmaVariableId": "VariableID:144:636"
165
198
  },
166
199
  "uai-content-link": {
167
- "description": "Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text.",
200
+ "description": "Theme-aware link color. Use: links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. Avoid: non-interactive emphasis.",
168
201
  "type": "color",
169
202
  "collection": "Colors",
170
203
  "scopes": [
@@ -175,7 +208,7 @@
175
208
  "figmaVariableId": "VariableID:2:280"
176
209
  },
177
210
  "uai-content-placeholder": {
178
- "description": "Input placeholder and hint text on standard surfaces. Not for disabled content. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces.",
211
+ "description": "Theme-aware placeholder color. Use: placeholder and empty-value hint text inside inputs and selects on standard surfaces. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces. Avoid: disabled content; use content/disabled.",
179
212
  "type": "color",
180
213
  "collection": "Colors",
181
214
  "scopes": [
@@ -186,7 +219,7 @@
186
219
  "figmaVariableId": "VariableID:2:281"
187
220
  },
188
221
  "uai-content-primary": {
189
- "description": "Primary text and icons. Headings, body text, form labels.",
222
+ "description": "Theme-aware primary text and icon color. Use: headings, body text, input values and form labels on standard surfaces (background, paper, contrast, muted). Avoid: text on surface/inverse or on filled actions; use content/inverse or the matching action foreground.",
190
223
  "type": "color",
191
224
  "collection": "Colors",
192
225
  "scopes": [
@@ -197,7 +230,7 @@
197
230
  "figmaVariableId": "VariableID:2:277"
198
231
  },
199
232
  "uai-content-secondary": {
200
- "description": "Secondary text and icons. Descriptions, supporting text, text on muted surfaces.",
233
+ "description": "Theme-aware secondary text and icon color. Use: descriptions, supporting text, input icons, avatar initials and text on surface/muted. Avoid: essential information that must be read at a glance; use content/primary.",
201
234
  "type": "color",
202
235
  "collection": "Colors",
203
236
  "scopes": [
@@ -208,7 +241,7 @@
208
241
  "figmaVariableId": "VariableID:2:278"
209
242
  },
210
243
  "uai-feedback-error": {
211
- "description": "Error text and icons on standard surfaces or feedback/error-subtle. Keep a message or icon as a non-color cue. Filled destructive actions use action/destructive and its foreground.",
244
+ "description": "Theme-aware error color for text, icons and borders, such as an invalid input and its message, on standard surfaces or on feedback/error-subtle. Keep a message or icon as a non-color cue. Avoid: filled destructive buttons; use action/destructive.",
212
245
  "type": "color",
213
246
  "collection": "Colors",
214
247
  "scopes": [
@@ -220,7 +253,7 @@
220
253
  "figmaVariableId": "VariableID:2:303"
221
254
  },
222
255
  "uai-feedback-error-subtle": {
223
- "description": "Error alert background. Pair with feedback/error for the icon.",
256
+ "description": "Theme-aware background of error alerts, banners and inline status areas. Pair: feedback/error for the icon and content/primary for the text.",
224
257
  "type": "color",
225
258
  "collection": "Colors",
226
259
  "scopes": [
@@ -230,7 +263,7 @@
230
263
  "figmaVariableId": "VariableID:2:308"
231
264
  },
232
265
  "uai-feedback-info": {
233
- "description": "Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background.",
266
+ "description": "Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds.",
234
267
  "type": "color",
235
268
  "collection": "Colors",
236
269
  "scopes": [
@@ -242,7 +275,7 @@
242
275
  "figmaVariableId": "VariableID:2:300"
243
276
  },
244
277
  "uai-feedback-info-subtle": {
245
- "description": "Info alert background. Pair with feedback/info for the icon.",
278
+ "description": "Theme-aware background of information alerts, banners and inline status areas. Pair: feedback/info for the icon and content/primary for the text.",
246
279
  "type": "color",
247
280
  "collection": "Colors",
248
281
  "scopes": [
@@ -252,7 +285,7 @@
252
285
  "figmaVariableId": "VariableID:2:305"
253
286
  },
254
287
  "uai-feedback-success": {
255
- "description": "Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons.",
288
+ "description": "Theme-aware success color for text, icons and borders, such as a valid input and its message, on standard surfaces or on feedback/success-subtle. Avoid: filled buttons; use action/positive with action/positive-foreground.",
256
289
  "type": "color",
257
290
  "collection": "Colors",
258
291
  "scopes": [
@@ -264,7 +297,7 @@
264
297
  "figmaVariableId": "VariableID:2:301"
265
298
  },
266
299
  "uai-feedback-success-subtle": {
267
- "description": "Success alert background. Pair with feedback/success for the icon.",
300
+ "description": "Theme-aware background of success alerts, banners and inline status areas. Pair: feedback/success for the icon and content/primary for the text.",
268
301
  "type": "color",
269
302
  "collection": "Colors",
270
303
  "scopes": [
@@ -274,7 +307,7 @@
274
307
  "figmaVariableId": "VariableID:2:306"
275
308
  },
276
309
  "uai-feedback-warning": {
277
- "description": "Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background.",
310
+ "description": "Theme-aware warning color for text, icons and borders on standard surfaces or on feedback/warning-subtle. Check text contrast in Light mode. Avoid: filled button backgrounds.",
278
311
  "type": "color",
279
312
  "collection": "Colors",
280
313
  "scopes": [
@@ -286,7 +319,7 @@
286
319
  "figmaVariableId": "VariableID:2:302"
287
320
  },
288
321
  "uai-feedback-warning-subtle": {
289
- "description": "Warning alert background. Pair with feedback/warning for the icon.",
322
+ "description": "Theme-aware background of warning alerts, banners and inline status areas. Pair: feedback/warning for the icon and content/primary for the text.",
290
323
  "type": "color",
291
324
  "collection": "Colors",
292
325
  "scopes": [
@@ -296,7 +329,7 @@
296
329
  "figmaVariableId": "VariableID:2:307"
297
330
  },
298
331
  "uai-fixed-blue": {
299
- "description": "Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface.",
332
+ "description": "Fixed Blip blue, the same in every theme. Pair: fixed/bright for text on it. Avoid: as the only selected-state boundary on every surface, and as a replacement for the neutral action/primary.",
300
333
  "type": "color",
301
334
  "collection": "Colors",
302
335
  "scopes": [
@@ -308,7 +341,7 @@
308
341
  "figmaVariableId": "VariableID:2:315"
309
342
  },
310
343
  "uai-fixed-brand": {
311
- "description": "Product brand color, invariant across themes. Use fixed/dim for normal text on this background, not fixed/bright. Brand color alone is not an accessible selected-state boundary on every surface.",
344
+ "description": "Product brand color, invariant across themes. Use: brand marks and illustrations. Pair: fixed/dim for normal text on it, not fixed/bright. Avoid: as the only selected-state boundary on every surface.",
312
345
  "type": "color",
313
346
  "collection": "Colors",
314
347
  "scopes": [
@@ -320,7 +353,7 @@
320
353
  "figmaVariableId": "VariableID:2:316"
321
354
  },
322
355
  "uai-fixed-bright": {
323
- "description": "Fixed white. Not a universal foreground: fails normal-text contrast on fixed/brand and bright feedback colors. Use on fixed/dim or fixed/blue; use fixed/dim on fixed/brand.",
356
+ "description": "Fixed white that does not change with the theme. Use: text and icons on fixed/dim or fixed/blue. Avoid: text on fixed/brand or on light feedback colors, where it fails normal-text contrast.",
324
357
  "type": "color",
325
358
  "collection": "Colors",
326
359
  "scopes": [
@@ -332,7 +365,7 @@
332
365
  "figmaVariableId": "VariableID:2:314"
333
366
  },
334
367
  "uai-fixed-dim": {
335
- "description": "Dark color that does not change with the theme.",
368
+ "description": "Fixed dark neutral that does not change with the theme. Use: text on fixed/brand, and dark areas that must look the same in Light and Dark. Avoid: theme-aware text; use content/primary.",
336
369
  "type": "color",
337
370
  "collection": "Colors",
338
371
  "scopes": [
@@ -344,7 +377,7 @@
344
377
  "figmaVariableId": "VariableID:2:313"
345
378
  },
346
379
  "uai-overlay-default": {
347
- "description": "Backdrop behind modals, drawers and dialogs.",
380
+ "description": "Theme-aware translucent backdrop behind modals, drawers and dialogs. Avoid: hover or pressed feedback; use overlay/hover or overlay/pressed.",
348
381
  "type": "color",
349
382
  "collection": "Colors",
350
383
  "scopes": [
@@ -354,7 +387,7 @@
354
387
  "figmaVariableId": "VariableID:2:309"
355
388
  },
356
389
  "uai-overlay-hover": {
357
- "description": "Translucent layer for hover on any interactive surface.",
390
+ "description": "Theme-aware translucent hover layer placed over any interactive surface: black tint in Light, white tint in Dark. Use: menu items, icon buttons and the radio hover halo. Avoid: as a solid background.",
358
391
  "type": "color",
359
392
  "collection": "Colors",
360
393
  "scopes": [
@@ -364,7 +397,7 @@
364
397
  "figmaVariableId": "VariableID:2:310"
365
398
  },
366
399
  "uai-overlay-insight": {
367
- "description": "Translucent background for insight panels and floating cards.",
400
+ "description": "Theme-aware translucent background for insight panels and floating cards over content. Pair: content/primary.",
368
401
  "type": "color",
369
402
  "collection": "Colors",
370
403
  "scopes": [
@@ -374,7 +407,7 @@
374
407
  "figmaVariableId": "VariableID:2:312"
375
408
  },
376
409
  "uai-overlay-pressed": {
377
- "description": "Translucent layer for pressed state on any interactive surface.",
410
+ "description": "Theme-aware translucent pressed layer placed over any interactive surface. Use: the pressed state wherever overlay/hover is the hover state.",
378
411
  "type": "color",
379
412
  "collection": "Colors",
380
413
  "scopes": [
@@ -383,8 +416,18 @@
383
416
  ],
384
417
  "figmaVariableId": "VariableID:2:311"
385
418
  },
419
+ "uai-overlay-selected": {
420
+ "description": "Theme-aware translucent layer for the selected item in navigation placed over any surface: black tint in Light, white tint in Dark. Use: selected header navigation and side menu items, together with medium font weight. Pair: content/primary. Avoid: selected list or menu options in panels; use action/outline/pressed.",
421
+ "type": "color",
422
+ "collection": "Colors",
423
+ "scopes": [
424
+ "FRAME_FILL",
425
+ "SHAPE_FILL"
426
+ ],
427
+ "figmaVariableId": "VariableID:271:29"
428
+ },
386
429
  "uai-surface-background": {
387
- "description": "Page background. The base layer behind every screen.",
430
+ "description": "Theme-aware page background, the base layer behind every screen. Use: app canvas and the area around cards. Pair: content/primary and content/secondary. Avoid: cards, fields and floating panels; use surface/paper.",
388
431
  "type": "color",
389
432
  "collection": "Colors",
390
433
  "scopes": [
@@ -394,7 +437,7 @@
394
437
  "figmaVariableId": "VariableID:2:263"
395
438
  },
396
439
  "uai-surface-contrast": {
397
- "description": "Subtle contrast surface. Secondary panels, alternating sections, hovered or selected rows.",
440
+ "description": "Theme-aware subtle contrast surface. Use: secondary panels, alternating sections, hovered or selected table rows. Pair: content/primary. Avoid: the page background.",
398
441
  "type": "color",
399
442
  "collection": "Colors",
400
443
  "scopes": [
@@ -404,7 +447,7 @@
404
447
  "figmaVariableId": "VariableID:2:267"
405
448
  },
406
449
  "uai-surface-inverse": {
407
- "description": "Inverted surface. Tooltips, snackbars, dark banners in light mode (and the reverse). Use content/inverse on it.",
450
+ "description": "Theme-aware inverted surface: dark in Light mode, light in Dark mode. Use: tooltips, snackbars and banners that must stand out from the page. Pair: content/inverse for text and icons. Avoid: large areas.",
408
451
  "type": "color",
409
452
  "collection": "Colors",
410
453
  "scopes": [
@@ -414,7 +457,7 @@
414
457
  "figmaVariableId": "VariableID:2:268"
415
458
  },
416
459
  "uai-surface-muted": {
417
- "description": "Muted surface. Chips, tags, code blocks, table headers. Use content/secondary on it.",
460
+ "description": "Theme-aware muted surface. Use: chips, tags, code blocks, table headers, input adornment boxes and the avatar initials background. Pair: content/secondary for text and icons.",
418
461
  "type": "color",
419
462
  "collection": "Colors",
420
463
  "scopes": [
@@ -424,7 +467,7 @@
424
467
  "figmaVariableId": "VariableID:2:271"
425
468
  },
426
469
  "uai-surface-paper": {
427
- "description": "Cards, modals, popovers, dropdowns and drawers. Add an elevation style when it floats.",
470
+ "description": "Theme-aware main container surface. Use: cards, modals, popovers, dropdown panels, drawers, input fields and the app header. Pair: content/* tokens; add an elevation style when it floats. Avoid: the page canvas; use surface/background.",
428
471
  "type": "color",
429
472
  "collection": "Colors",
430
473
  "scopes": [
@@ -434,7 +477,7 @@
434
477
  "figmaVariableId": "VariableID:2:265"
435
478
  },
436
479
  "uai-border-width-default": {
437
- "description": "Border width. 1px. Standard borders.",
480
+ "description": "Border width 1px. Default for every border: inputs, selects, checkboxes, cards and dividers, including the solid focus border of inputs.",
438
481
  "type": "dimension",
439
482
  "collection": "Dimensions",
440
483
  "scopes": [
@@ -443,7 +486,7 @@
443
486
  "figmaVariableId": "VariableID:10:51"
444
487
  },
445
488
  "uai-border-width-none": {
446
- "description": "Border width. 0px.",
489
+ "description": "Border width 0px. Use: removing a border explicitly.",
447
490
  "type": "dimension",
448
491
  "collection": "Dimensions",
449
492
  "scopes": [
@@ -452,7 +495,7 @@
452
495
  "figmaVariableId": "VariableID:10:49"
453
496
  },
454
497
  "uai-border-width-thick": {
455
- "description": "Border width. 2px. Focus rings and emphasis borders.",
498
+ "description": "Border width 2px. Use: focus rings and halos, the checked radio border and emphasis borders.",
456
499
  "type": "dimension",
457
500
  "collection": "Dimensions",
458
501
  "scopes": [
@@ -460,8 +503,53 @@
460
503
  ],
461
504
  "figmaVariableId": "VariableID:10:53"
462
505
  },
506
+ "uai-control-height-compact": {
507
+ "description": "Control height 24px. Compact controls: 24px icon-only buttons and the compact uai-button, toolbars and dense tables. Pair: radius/md and caption text. Avoid: primary actions and form fields in regular forms. Avoid: spacing tokens for heights.",
508
+ "type": "dimension",
509
+ "collection": "Dimensions",
510
+ "scopes": [
511
+ "WIDTH_HEIGHT"
512
+ ],
513
+ "figmaVariableId": "VariableID:271:12"
514
+ },
515
+ "uai-control-height-large": {
516
+ "description": "Control height 56px. Large controls: 56px buttons for prominent single actions, such as hero or empty-state calls to action. Pair: radius/lg and spacing/md horizontal padding. Avoid: dense forms and tables. Avoid: spacing tokens for heights.",
517
+ "type": "dimension",
518
+ "collection": "Dimensions",
519
+ "scopes": [
520
+ "WIDTH_HEIGHT"
521
+ ],
522
+ "figmaVariableId": "VariableID:271:15"
523
+ },
524
+ "uai-control-height-medium": {
525
+ "description": "Control height 40px. Default control height: buttons, inputs, selects, datepickers and header actions. Pair: radius/lg, spacing/sm horizontal padding and body/base text. Use this size when unsure. Avoid: spacing tokens for heights.",
526
+ "type": "dimension",
527
+ "collection": "Dimensions",
528
+ "scopes": [
529
+ "WIDTH_HEIGHT"
530
+ ],
531
+ "figmaVariableId": "VariableID:271:14"
532
+ },
533
+ "uai-control-height-short": {
534
+ "description": "Control height 32px. Short controls: 32px buttons, inputs and selects in dense areas such as filters, table toolbars and breadcrumb items. Pair: radius/lg and body/base text. Avoid: spacing tokens for heights.",
535
+ "type": "dimension",
536
+ "collection": "Dimensions",
537
+ "scopes": [
538
+ "WIDTH_HEIGHT"
539
+ ],
540
+ "figmaVariableId": "VariableID:271:13"
541
+ },
542
+ "uai-opacity-disabled": {
543
+ "description": "Opacity of a disabled control: 50 percent in Figma, unitless 0.5 in web outputs. Use only where the component contract dims the whole control, such as uai-button. Avoid: inputs and selection controls, which use content/disabled colors instead.",
544
+ "type": "number",
545
+ "collection": "Dimensions",
546
+ "scopes": [
547
+ "OPACITY"
548
+ ],
549
+ "figmaVariableId": "VariableID:255:15"
550
+ },
463
551
  "uai-opacity-focus-ring": {
464
- "description": "Supplementary outer focus halo opacity: 30 percent in Figma, normalized to unitless 0.3 in web outputs. Apply only to the halo layer; retain a solid focus border or outline. Never apply to the full control or as the sole focus indication.",
552
+ "description": "Opacity of the supplementary outer focus halo: 30 percent in Figma, unitless 0.3 in web outputs. Apply only to the halo layer and keep a solid border/ring focus indicator. Avoid: the whole control, or the halo as the only focus cue.",
465
553
  "type": "number",
466
554
  "collection": "Dimensions",
467
555
  "scopes": [
@@ -470,7 +558,7 @@
470
558
  "figmaVariableId": "VariableID:192:2"
471
559
  },
472
560
  "uai-radius-2xl": {
473
- "description": "Border radius. 24px.",
561
+ "description": "Corner radius 24px. Reserved for very large surfaces; no UAI component uses it yet. Confirm with design before applying.",
474
562
  "type": "dimension",
475
563
  "collection": "Dimensions",
476
564
  "scopes": [
@@ -479,7 +567,7 @@
479
567
  "figmaVariableId": "VariableID:10:23"
480
568
  },
481
569
  "uai-radius-full": {
482
- "description": "Border radius. Full round.",
570
+ "description": "Fully rounded corners (pill or circle). Use: avatars, radio buttons, the radio hover halo, badges and pill-shaped chips.",
483
571
  "type": "dimension",
484
572
  "collection": "Dimensions",
485
573
  "scopes": [
@@ -488,7 +576,7 @@
488
576
  "figmaVariableId": "VariableID:10:24"
489
577
  },
490
578
  "uai-radius-lg": {
491
- "description": "Border radius. 12px.",
579
+ "description": "Corner radius 12px. Default for controls and the panels they open: inputs, selects, buttons (32 to 56px), dropdown and listbox panels, menu items, datepicker day cells and header actions.",
492
580
  "type": "dimension",
493
581
  "collection": "Dimensions",
494
582
  "scopes": [
@@ -497,7 +585,7 @@
497
585
  "figmaVariableId": "VariableID:10:21"
498
586
  },
499
587
  "uai-radius-md": {
500
- "description": "Border radius. 8px.",
588
+ "description": "Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements.",
501
589
  "type": "dimension",
502
590
  "collection": "Dimensions",
503
591
  "scopes": [
@@ -506,7 +594,7 @@
506
594
  "figmaVariableId": "VariableID:10:20"
507
595
  },
508
596
  "uai-radius-none": {
509
- "description": "Border radius. 0px.",
597
+ "description": "Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements.",
510
598
  "type": "dimension",
511
599
  "collection": "Dimensions",
512
600
  "scopes": [
@@ -515,7 +603,7 @@
515
603
  "figmaVariableId": "VariableID:10:17"
516
604
  },
517
605
  "uai-radius-sm": {
518
- "description": "Border radius. 4px.",
606
+ "description": "Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements.",
519
607
  "type": "dimension",
520
608
  "collection": "Dimensions",
521
609
  "scopes": [
@@ -524,7 +612,7 @@
524
612
  "figmaVariableId": "VariableID:10:19"
525
613
  },
526
614
  "uai-radius-xl": {
527
- "description": "Border radius. 16px.",
615
+ "description": "Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying.",
528
616
  "type": "dimension",
529
617
  "collection": "Dimensions",
530
618
  "scopes": [
@@ -533,7 +621,7 @@
533
621
  "figmaVariableId": "VariableID:10:22"
534
622
  },
535
623
  "uai-radius-xs": {
536
- "description": "Border radius. 2px.",
624
+ "description": "Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers.",
537
625
  "type": "dimension",
538
626
  "collection": "Dimensions",
539
627
  "scopes": [
@@ -542,7 +630,7 @@
542
630
  "figmaVariableId": "VariableID:10:18"
543
631
  },
544
632
  "uai-sizing-2xl": {
545
- "description": "Fixed size. 40px. Medium avatars.",
633
+ "description": "Fixed size 40px. Use: small avatar and square icon containers. Avoid: control heights of buttons, inputs and selects; use control-height/medium.",
546
634
  "type": "dimension",
547
635
  "collection": "Dimensions",
548
636
  "scopes": [
@@ -550,8 +638,17 @@
550
638
  ],
551
639
  "figmaVariableId": "VariableID:10:44"
552
640
  },
641
+ "uai-sizing-2xs": {
642
+ "description": "Fixed size 8px. Use: the tooltip arrow, notification dots on header actions and other very small indicators. Avoid: padding and gaps; use spacing/*.",
643
+ "type": "dimension",
644
+ "collection": "Dimensions",
645
+ "scopes": [
646
+ "WIDTH_HEIGHT"
647
+ ],
648
+ "figmaVariableId": "VariableID:271:16"
649
+ },
553
650
  "uai-sizing-3xl": {
554
- "description": "Fixed size. 48px. Large avatars.",
651
+ "description": "Fixed size 48px. Use: standard avatar.",
555
652
  "type": "dimension",
556
653
  "collection": "Dimensions",
557
654
  "scopes": [
@@ -560,7 +657,7 @@
560
657
  "figmaVariableId": "VariableID:10:45"
561
658
  },
562
659
  "uai-sizing-4xl": {
563
- "description": "Fixed size. 64px. Extra large avatars.",
660
+ "description": "Fixed size 64px. Use: large avatar.",
564
661
  "type": "dimension",
565
662
  "collection": "Dimensions",
566
663
  "scopes": [
@@ -568,8 +665,17 @@
568
665
  ],
569
666
  "figmaVariableId": "VariableID:10:46"
570
667
  },
668
+ "uai-sizing-5xl": {
669
+ "description": "Fixed size 72px. Use: extra-large avatar.",
670
+ "type": "dimension",
671
+ "collection": "Dimensions",
672
+ "scopes": [
673
+ "WIDTH_HEIGHT"
674
+ ],
675
+ "figmaVariableId": "VariableID:255:14"
676
+ },
571
677
  "uai-sizing-lg": {
572
- "description": "Fixed size. 24px. Icon medium (default).",
678
+ "description": "Fixed size 24px. Use: default icons (uai-icon size medium) and the micro avatar. Avoid: control heights; use control-height/compact.",
573
679
  "type": "dimension",
574
680
  "collection": "Dimensions",
575
681
  "scopes": [
@@ -578,7 +684,7 @@
578
684
  "figmaVariableId": "VariableID:10:42"
579
685
  },
580
686
  "uai-sizing-md": {
581
- "description": "Fixed size. 20px. Icon small.",
687
+ "description": "Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls.",
582
688
  "type": "dimension",
583
689
  "collection": "Dimensions",
584
690
  "scopes": [
@@ -587,7 +693,7 @@
587
693
  "figmaVariableId": "VariableID:10:41"
588
694
  },
589
695
  "uai-sizing-sm": {
590
- "description": "Fixed size. 16px. Icon x-small.",
696
+ "description": "Fixed size 16px. Use: x-small icons (uai-icon size x-small), such as the header breadcrumb chevrons.",
591
697
  "type": "dimension",
592
698
  "collection": "Dimensions",
593
699
  "scopes": [
@@ -596,7 +702,7 @@
596
702
  "figmaVariableId": "VariableID:10:40"
597
703
  },
598
704
  "uai-sizing-xl": {
599
- "description": "Fixed size. 32px. Small avatars.",
705
+ "description": "Fixed size 32px. Use: extra-small avatar, the radio hover halo and datepicker day cells. Avoid: control heights; use control-height/short.",
600
706
  "type": "dimension",
601
707
  "collection": "Dimensions",
602
708
  "scopes": [
@@ -605,7 +711,7 @@
605
711
  "figmaVariableId": "VariableID:10:43"
606
712
  },
607
713
  "uai-sizing-xs": {
608
- "description": "Fixed size. 12px. Status dots, tiny indicators.",
714
+ "description": "Fixed size 12px. Use: status dots, tiny indicators and the selected radio dot. Avoid: padding and gaps; use spacing/*.",
609
715
  "type": "dimension",
610
716
  "collection": "Dimensions",
611
717
  "scopes": [
@@ -614,7 +720,7 @@
614
720
  "figmaVariableId": "VariableID:10:39"
615
721
  },
616
722
  "uai-spacing-2xl": {
617
- "description": "Spacing. 40px.",
723
+ "description": "Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium.",
618
724
  "type": "dimension",
619
725
  "collection": "Dimensions",
620
726
  "scopes": [
@@ -623,7 +729,7 @@
623
729
  "figmaVariableId": "VariableID:10:33"
624
730
  },
625
731
  "uai-spacing-2xs": {
626
- "description": "Spacing. 4px.",
732
+ "description": "Spacing 4px. Smallest gap between related items: label to field and field to message in inputs, and the offset of a dropdown or popover from its trigger.",
627
733
  "type": "dimension",
628
734
  "collection": "Dimensions",
629
735
  "scopes": [
@@ -632,7 +738,7 @@
632
738
  "figmaVariableId": "VariableID:10:27"
633
739
  },
634
740
  "uai-spacing-3xl": {
635
- "description": "Spacing. 48px.",
741
+ "description": "Spacing 48px. Layout spacing between large page regions.",
636
742
  "type": "dimension",
637
743
  "collection": "Dimensions",
638
744
  "scopes": [
@@ -641,7 +747,7 @@
641
747
  "figmaVariableId": "VariableID:10:34"
642
748
  },
643
749
  "uai-spacing-3xs": {
644
- "description": "Spacing. 2px.",
750
+ "description": "Spacing 2px. Hairline gaps and offsets inside small elements, such as the side padding of avatar initials. Avoid: widths and heights; use sizing/*.",
645
751
  "type": "dimension",
646
752
  "collection": "Dimensions",
647
753
  "scopes": [
@@ -650,7 +756,7 @@
650
756
  "figmaVariableId": "VariableID:10:26"
651
757
  },
652
758
  "uai-spacing-4xl": {
653
- "description": "Spacing. 56px.",
759
+ "description": "Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large.",
654
760
  "type": "dimension",
655
761
  "collection": "Dimensions",
656
762
  "scopes": [
@@ -659,7 +765,7 @@
659
765
  "figmaVariableId": "VariableID:10:35"
660
766
  },
661
767
  "uai-spacing-5xl": {
662
- "description": "Spacing. 64px.",
768
+ "description": "Spacing 64px. Layout spacing for page margins and large regions.",
663
769
  "type": "dimension",
664
770
  "collection": "Dimensions",
665
771
  "scopes": [
@@ -668,7 +774,7 @@
668
774
  "figmaVariableId": "VariableID:10:36"
669
775
  },
670
776
  "uai-spacing-6xl": {
671
- "description": "Spacing. 72px.",
777
+ "description": "Spacing 72px. Layout spacing for page margins and large regions. Avoid: the header height, which comes from its content and padding.",
672
778
  "type": "dimension",
673
779
  "collection": "Dimensions",
674
780
  "scopes": [
@@ -677,7 +783,7 @@
677
783
  "figmaVariableId": "VariableID:144:634"
678
784
  },
679
785
  "uai-spacing-7xl": {
680
- "description": "Spacing. 80px.",
786
+ "description": "Spacing 80px. Layout spacing for page margins and hero areas.",
681
787
  "type": "dimension",
682
788
  "collection": "Dimensions",
683
789
  "scopes": [
@@ -686,7 +792,7 @@
686
792
  "figmaVariableId": "VariableID:10:37"
687
793
  },
688
794
  "uai-spacing-8xl": {
689
- "description": "Spacing. 88px.",
795
+ "description": "Spacing 88px. Layout spacing for page margins and hero areas.",
690
796
  "type": "dimension",
691
797
  "collection": "Dimensions",
692
798
  "scopes": [
@@ -695,7 +801,7 @@
695
801
  "figmaVariableId": "VariableID:144:635"
696
802
  },
697
803
  "uai-spacing-9xl": {
698
- "description": "Spacing. 96px.",
804
+ "description": "Spacing 96px. Largest layout spacing, for hero and landing areas.",
699
805
  "type": "dimension",
700
806
  "collection": "Dimensions",
701
807
  "scopes": [
@@ -704,7 +810,7 @@
704
810
  "figmaVariableId": "VariableID:10:38"
705
811
  },
706
812
  "uai-spacing-lg": {
707
- "description": "Spacing. 24px.",
813
+ "description": "Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar).",
708
814
  "type": "dimension",
709
815
  "collection": "Dimensions",
710
816
  "scopes": [
@@ -713,7 +819,7 @@
713
819
  "figmaVariableId": "VariableID:10:31"
714
820
  },
715
821
  "uai-spacing-md": {
716
- "description": "Spacing. 16px.",
822
+ "description": "Spacing 16px. Default padding of containers such as the app header, cards and dropdown search rows. The header height comes from sizing/2xl content plus this padding above and below.",
717
823
  "type": "dimension",
718
824
  "collection": "Dimensions",
719
825
  "scopes": [
@@ -722,7 +828,7 @@
722
828
  "figmaVariableId": "VariableID:10:30"
723
829
  },
724
830
  "uai-spacing-none": {
725
- "description": "Spacing. 0px.",
831
+ "description": "Spacing 0px. Use: removing gaps or padding explicitly.",
726
832
  "type": "dimension",
727
833
  "collection": "Dimensions",
728
834
  "scopes": [
@@ -731,7 +837,7 @@
731
837
  "figmaVariableId": "VariableID:10:25"
732
838
  },
733
839
  "uai-spacing-sm": {
734
- "description": "Spacing. 12px.",
840
+ "description": "Spacing 12px. Horizontal padding of buttons and other controls.",
735
841
  "type": "dimension",
736
842
  "collection": "Dimensions",
737
843
  "scopes": [
@@ -740,7 +846,7 @@
740
846
  "figmaVariableId": "VariableID:10:29"
741
847
  },
742
848
  "uai-spacing-xl": {
743
- "description": "Spacing. 32px.",
849
+ "description": "Spacing 32px. Layout spacing between page sections.",
744
850
  "type": "dimension",
745
851
  "collection": "Dimensions",
746
852
  "scopes": [
@@ -749,7 +855,7 @@
749
855
  "figmaVariableId": "VariableID:10:32"
750
856
  },
751
857
  "uai-spacing-xs": {
752
- "description": "Spacing. 8px.",
858
+ "description": "Spacing 8px. Gap between an icon and its label, between a checkbox or radio and its label, and between header actions; minimum distance from the viewport edge for floating panels and the tooltip offset from its trigger.",
753
859
  "type": "dimension",
754
860
  "collection": "Dimensions",
755
861
  "scopes": [
@@ -757,8 +863,198 @@
757
863
  ],
758
864
  "figmaVariableId": "VariableID:10:28"
759
865
  },
866
+ "uai-breakpoint-lg": {
867
+ "description": "Viewport breakpoint 1075px, used as a max-width media query. Below it, the app header collapses the breadcrumb into a menu. Available in SCSS and JS only, not as a CSS custom property.",
868
+ "type": "dimension",
869
+ "collection": "Layout",
870
+ "scopes": [
871
+ "WIDTH_HEIGHT"
872
+ ],
873
+ "figmaVariableId": "VariableID:255:25"
874
+ },
875
+ "uai-breakpoint-md": {
876
+ "description": "Viewport breakpoint 800px, used as a max-width media query. Medium screens; for example, the header search collapses to an icon and the Brain action hides its label. Available in SCSS and JS only.",
877
+ "type": "dimension",
878
+ "collection": "Layout",
879
+ "scopes": [
880
+ "WIDTH_HEIGHT"
881
+ ],
882
+ "figmaVariableId": "VariableID:255:24"
883
+ },
884
+ "uai-breakpoint-sm": {
885
+ "description": "Viewport breakpoint 640px, used as a max-width media query. Narrow screens; for example, the period datepicker stacks its two calendars. Available in SCSS and JS only, not as a CSS custom property.",
886
+ "type": "dimension",
887
+ "collection": "Layout",
888
+ "scopes": [
889
+ "WIDTH_HEIGHT"
890
+ ],
891
+ "figmaVariableId": "VariableID:255:23"
892
+ },
893
+ "uai-breakpoint-xs": {
894
+ "description": "Viewport breakpoint 450px, used as a max-width media query. Very narrow screens; for example, the app header hides the Brain action. Available in SCSS and JS only, not as a CSS custom property.",
895
+ "type": "dimension",
896
+ "collection": "Layout",
897
+ "scopes": [
898
+ "WIDTH_HEIGHT"
899
+ ],
900
+ "figmaVariableId": "VariableID:255:22"
901
+ },
902
+ "uai-layer-content": {
903
+ "description": "Stacking order 100 (z-index). Use: Page content that must stay above the page background, such as sticky table headers inside the page. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header.",
904
+ "type": "number",
905
+ "collection": "Layout",
906
+ "scopes": [],
907
+ "figmaVariableId": "VariableID:271:25"
908
+ },
909
+ "uai-layer-header": {
910
+ "description": "Stacking order 500 (z-index). Use: The application header (uai-header), above content and navigation. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header.",
911
+ "type": "number",
912
+ "collection": "Layout",
913
+ "scopes": [],
914
+ "figmaVariableId": "VariableID:271:28"
915
+ },
916
+ "uai-layer-navigation": {
917
+ "description": "Stacking order 400 (z-index). Use: The application side menu. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header.",
918
+ "type": "number",
919
+ "collection": "Layout",
920
+ "scopes": [],
921
+ "figmaVariableId": "VariableID:271:27"
922
+ },
923
+ "uai-layer-navigation-overlay": {
924
+ "description": "Stacking order 300 (z-index). Use: Backdrop shown behind the expanded side menu on narrow screens. Overlays (dropdowns, tooltips, dialogs, drawers, toasts) do not use layers; they open in the browser top layer. Avoid: raising other elements above the header.",
925
+ "type": "number",
926
+ "collection": "Layout",
927
+ "scopes": [],
928
+ "figmaVariableId": "VariableID:271:26"
929
+ },
930
+ "uai-width-content": {
931
+ "description": "Layout width 1112px. Use: Maximum width of page content; pages center their content within it. Avoid: fixed widths for fields or menus that should follow their content.",
932
+ "type": "dimension",
933
+ "collection": "Layout",
934
+ "scopes": [
935
+ "WIDTH_HEIGHT"
936
+ ],
937
+ "figmaVariableId": "VariableID:271:24"
938
+ },
939
+ "uai-width-dialog": {
940
+ "description": "Layout width 424px. Use: Width of standard dialogs (uai-dialog). On narrow screens the dialog uses the viewport minus spacing/md on each side. Avoid: fixed widths for fields or menus that should follow their content.",
941
+ "type": "dimension",
942
+ "collection": "Layout",
943
+ "scopes": [
944
+ "WIDTH_HEIGHT"
945
+ ],
946
+ "figmaVariableId": "VariableID:271:20"
947
+ },
948
+ "uai-width-menu": {
949
+ "description": "Layout width 224px. Use: Minimum width of contextual menus and action lists (uai-dropdown). Menus grow with content up to the viewport minus spacing/xs on each side. Avoid: fixed widths for fields or menus that should follow their content.",
950
+ "type": "dimension",
951
+ "collection": "Layout",
952
+ "scopes": [
953
+ "WIDTH_HEIGHT"
954
+ ],
955
+ "figmaVariableId": "VariableID:271:17"
956
+ },
957
+ "uai-width-panel": {
958
+ "description": "Layout width 288px. Use: Width of rich dropdown panels such as alerts, organization switcher and profile menus. Avoid: fixed widths for fields or menus that should follow their content.",
959
+ "type": "dimension",
960
+ "collection": "Layout",
961
+ "scopes": [
962
+ "WIDTH_HEIGHT"
963
+ ],
964
+ "figmaVariableId": "VariableID:271:18"
965
+ },
966
+ "uai-width-side-menu": {
967
+ "description": "Layout width 288px. Use: Width of the expanded application side menu. Avoid: fixed widths for fields or menus that should follow their content.",
968
+ "type": "dimension",
969
+ "collection": "Layout",
970
+ "scopes": [
971
+ "WIDTH_HEIGHT"
972
+ ],
973
+ "figmaVariableId": "VariableID:271:22"
974
+ },
975
+ "uai-width-side-menu-collapsed": {
976
+ "description": "Layout width 80px. Use: Width of the collapsed application side menu (icons only). Avoid: fixed widths for fields or menus that should follow their content.",
977
+ "type": "dimension",
978
+ "collection": "Layout",
979
+ "scopes": [
980
+ "WIDTH_HEIGHT"
981
+ ],
982
+ "figmaVariableId": "VariableID:271:23"
983
+ },
984
+ "uai-width-sidebar": {
985
+ "description": "Layout width 470px. Use: Width of side panels and drawers that overlay the page, such as the Brain sidebar. Avoid: fixed widths for fields or menus that should follow their content.",
986
+ "type": "dimension",
987
+ "collection": "Layout",
988
+ "scopes": [
989
+ "WIDTH_HEIGHT"
990
+ ],
991
+ "figmaVariableId": "VariableID:271:21"
992
+ },
993
+ "uai-width-tooltip": {
994
+ "description": "Layout width 240px. Use: Maximum width of tooltips; longer text wraps. Avoid: fixed widths for fields or menus that should follow their content.",
995
+ "type": "dimension",
996
+ "collection": "Layout",
997
+ "scopes": [
998
+ "WIDTH_HEIGHT"
999
+ ],
1000
+ "figmaVariableId": "VariableID:271:19"
1001
+ },
1002
+ "uai-duration-fast": {
1003
+ "description": "Motion duration 150ms. Use: control state changes such as hover, focus, pressed, checked and selected, and chevron rotation. Pair: easing/standard. Respect prefers-reduced-motion.",
1004
+ "type": "duration",
1005
+ "collection": "Motion",
1006
+ "scopes": [
1007
+ "ALL_SCOPES"
1008
+ ],
1009
+ "figmaVariableId": "VariableID:255:17"
1010
+ },
1011
+ "uai-duration-instant": {
1012
+ "description": "Motion duration 65ms. Use: feedback that must not delay reading, such as tooltips appearing and hiding. Pair: easing/standard. Respect prefers-reduced-motion.",
1013
+ "type": "duration",
1014
+ "collection": "Motion",
1015
+ "scopes": [
1016
+ "ALL_SCOPES"
1017
+ ],
1018
+ "figmaVariableId": "VariableID:255:16"
1019
+ },
1020
+ "uai-duration-loop": {
1021
+ "description": "Motion duration 800ms. Use: one cycle of a continuous animation, such as a loading spinner rotation. Pair: easing/linear. Under prefers-reduced-motion, slow it down or stop it.",
1022
+ "type": "duration",
1023
+ "collection": "Motion",
1024
+ "scopes": [
1025
+ "ALL_SCOPES"
1026
+ ],
1027
+ "figmaVariableId": "VariableID:255:19"
1028
+ },
1029
+ "uai-duration-moderate": {
1030
+ "description": "Motion duration 200ms. Use: overlays entering and leaving, such as dropdowns, listboxes, popovers and toasts. Pair: easing/standard. Respect prefers-reduced-motion.",
1031
+ "type": "duration",
1032
+ "collection": "Motion",
1033
+ "scopes": [
1034
+ "ALL_SCOPES"
1035
+ ],
1036
+ "figmaVariableId": "VariableID:255:18"
1037
+ },
1038
+ "uai-easing-linear": {
1039
+ "description": "Motion easing, CSS linear. Use: continuous animations at constant speed, such as spinners. Pair: duration/loop. Avoid: state changes; use easing/standard.",
1040
+ "type": "cubicBezier",
1041
+ "collection": "Motion",
1042
+ "scopes": [
1043
+ "ALL_SCOPES"
1044
+ ],
1045
+ "figmaVariableId": "VariableID:255:21"
1046
+ },
1047
+ "uai-easing-standard": {
1048
+ "description": "Motion easing, CSS ease. Default curve for state changes and overlays. Pair: duration/instant, duration/fast or duration/moderate.",
1049
+ "type": "cubicBezier",
1050
+ "collection": "Motion",
1051
+ "scopes": [
1052
+ "ALL_SCOPES"
1053
+ ],
1054
+ "figmaVariableId": "VariableID:255:20"
1055
+ },
760
1056
  "uai-body-base-font-size": {
761
- "description": "Body Base — 14px. Default application text.",
1057
+ "description": "Body Base font size: 14px. Default for application text: paragraphs, input values, button labels, list and menu items, table cells. Pair: body/base/line-height (22px). Use this role when unsure.",
762
1058
  "type": "dimension",
763
1059
  "collection": "Typography",
764
1060
  "scopes": [
@@ -767,7 +1063,7 @@
767
1063
  "figmaVariableId": "VariableID:2:241"
768
1064
  },
769
1065
  "uai-body-base-line-height": {
770
- "description": "Body Base — 22px.",
1066
+ "description": "Body Base line height: 22px. Pair: body/base/font-size (14px).",
771
1067
  "type": "dimension",
772
1068
  "collection": "Typography",
773
1069
  "scopes": [
@@ -775,8 +1071,44 @@
775
1071
  ],
776
1072
  "figmaVariableId": "VariableID:2:242"
777
1073
  },
1074
+ "uai-body-lg-font-size": {
1075
+ "description": "Body Large — 16px. Lead text and large body copy.",
1076
+ "type": "dimension",
1077
+ "collection": "Typography",
1078
+ "scopes": [
1079
+ "FONT_SIZE"
1080
+ ],
1081
+ "figmaVariableId": "VariableID:296:9"
1082
+ },
1083
+ "uai-body-lg-line-height": {
1084
+ "description": "Body Large — 24px line height.",
1085
+ "type": "dimension",
1086
+ "collection": "Typography",
1087
+ "scopes": [
1088
+ "LINE_HEIGHT"
1089
+ ],
1090
+ "figmaVariableId": "VariableID:296:10"
1091
+ },
1092
+ "uai-body-sm-font-size": {
1093
+ "description": "Body Small — 12px. Compact secondary text.",
1094
+ "type": "dimension",
1095
+ "collection": "Typography",
1096
+ "scopes": [
1097
+ "FONT_SIZE"
1098
+ ],
1099
+ "figmaVariableId": "VariableID:296:11"
1100
+ },
1101
+ "uai-body-sm-line-height": {
1102
+ "description": "Body Small — 20px line height.",
1103
+ "type": "dimension",
1104
+ "collection": "Typography",
1105
+ "scopes": [
1106
+ "LINE_HEIGHT"
1107
+ ],
1108
+ "figmaVariableId": "VariableID:296:12"
1109
+ },
778
1110
  "uai-caption-font-size": {
779
- "description": "Caption — 12px. Helpers, badges, small body text.",
1111
+ "description": "Caption font size: 12px. Use: input labels, helper, error and success messages, compact button labels, badges, metadata and timestamps. Pair: caption/line-height (20px). Avoid: long reading text; use body/base.",
780
1112
  "type": "dimension",
781
1113
  "collection": "Typography",
782
1114
  "scopes": [
@@ -785,7 +1117,7 @@
785
1117
  "figmaVariableId": "VariableID:2:247"
786
1118
  },
787
1119
  "uai-caption-line-height": {
788
- "description": "Caption — 20px.",
1120
+ "description": "Caption line height: 20px. Pair: caption/font-size (12px).",
789
1121
  "type": "dimension",
790
1122
  "collection": "Typography",
791
1123
  "scopes": [
@@ -794,7 +1126,7 @@
794
1126
  "figmaVariableId": "VariableID:2:248"
795
1127
  },
796
1128
  "uai-display-font-size": {
797
- "description": "Display — 40px. Hero, landing pages.",
1129
+ "description": "Display font size: 40px. Use: hero and landing-page headlines, at most one per view. Pair: display/line-height (48px) and font-family/display. Avoid: in-app page titles; use heading/xl.",
798
1130
  "type": "dimension",
799
1131
  "collection": "Typography",
800
1132
  "scopes": [
@@ -803,7 +1135,7 @@
803
1135
  "figmaVariableId": "VariableID:2:223"
804
1136
  },
805
1137
  "uai-display-line-height": {
806
- "description": "Display — 48px.",
1138
+ "description": "Display line height: 48px. Pair: display/font-size (40px). Use only with display text.",
807
1139
  "type": "dimension",
808
1140
  "collection": "Typography",
809
1141
  "scopes": [
@@ -812,7 +1144,7 @@
812
1144
  "figmaVariableId": "VariableID:2:224"
813
1145
  },
814
1146
  "uai-font-family-display": {
815
- "description": "Display font for hero and marketing titles. Figtree today; may diverge per product.",
1147
+ "description": "Typeface for display and marketing headlines: Figtree today, may diverge per product. Use: display text only. Avoid: interface text, which uses font-family/sans.",
816
1148
  "type": "fontFamily",
817
1149
  "collection": "Typography",
818
1150
  "scopes": [
@@ -821,7 +1153,7 @@
821
1153
  "figmaVariableId": "VariableID:2:222"
822
1154
  },
823
1155
  "uai-font-family-sans": {
824
- "description": "Primary font for all interface text. Figtree.",
1156
+ "description": "Typeface for all interface text: Figtree. Use: every UI text, through the text styles in designs and this token in code. Pair: the size, line-height and weight tokens of one role (body/base, caption, title, heading, display). Avoid: typing the family name in code or designs.",
825
1157
  "type": "fontFamily",
826
1158
  "collection": "Typography",
827
1159
  "scopes": [
@@ -830,7 +1162,7 @@
830
1162
  "figmaVariableId": "VariableID:2:221"
831
1163
  },
832
1164
  "uai-font-weight-bold": {
833
- "description": "Bold weight (700). Titles, strong emphasis.",
1165
+ "description": "Font weight 700. Strong emphasis in titles and short inline text. Avoid: long passages and whole paragraphs.",
834
1166
  "type": "fontWeight",
835
1167
  "collection": "Typography",
836
1168
  "scopes": [
@@ -839,7 +1171,7 @@
839
1171
  "figmaVariableId": "VariableID:2:257"
840
1172
  },
841
1173
  "uai-font-weight-extrabold": {
842
- "description": "ExtraBold weight (800). Hero emphasis; maps to blip-ds bold="extra-bold".",
1174
+ "description": "Font weight 800. Hero emphasis only; equivalent to blip-ds bold='extra-bold'. Avoid: regular interface text.",
843
1175
  "type": "fontWeight",
844
1176
  "collection": "Typography",
845
1177
  "scopes": [
@@ -848,7 +1180,7 @@
848
1180
  "figmaVariableId": "VariableID:2:258"
849
1181
  },
850
1182
  "uai-font-weight-medium": {
851
- "description": "Medium weight (500). Labels, buttons.",
1183
+ "description": "Font weight 500. Light emphasis: button labels, avatar initials and active navigation items.",
852
1184
  "type": "fontWeight",
853
1185
  "collection": "Typography",
854
1186
  "scopes": [
@@ -857,7 +1189,7 @@
857
1189
  "figmaVariableId": "VariableID:2:255"
858
1190
  },
859
1191
  "uai-font-weight-regular": {
860
- "description": "Regular weight (400). Default body text.",
1192
+ "description": "Font weight 400. Default for body text, input values and helper, error and success messages.",
861
1193
  "type": "fontWeight",
862
1194
  "collection": "Typography",
863
1195
  "scopes": [
@@ -866,7 +1198,7 @@
866
1198
  "figmaVariableId": "VariableID:2:254"
867
1199
  },
868
1200
  "uai-font-weight-semibold": {
869
- "description": "SemiBold weight (600). Subtitles, navigation.",
1201
+ "description": "Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles.",
870
1202
  "type": "fontWeight",
871
1203
  "collection": "Typography",
872
1204
  "scopes": [
@@ -875,7 +1207,7 @@
875
1207
  "figmaVariableId": "VariableID:2:256"
876
1208
  },
877
1209
  "uai-heading-lg-font-size": {
878
- "description": "Heading LG — 24px. Content sections.",
1210
+ "description": "Heading LG font size: 24px. Use: titles of content sections within a page. Pair: heading/lg/line-height (32px).",
879
1211
  "type": "dimension",
880
1212
  "collection": "Typography",
881
1213
  "scopes": [
@@ -884,7 +1216,7 @@
884
1216
  "figmaVariableId": "VariableID:2:229"
885
1217
  },
886
1218
  "uai-heading-lg-line-height": {
887
- "description": "Heading LG — 32px.",
1219
+ "description": "Heading LG line height: 32px. Pair: heading/lg/font-size (24px).",
888
1220
  "type": "dimension",
889
1221
  "collection": "Typography",
890
1222
  "scopes": [
@@ -893,7 +1225,7 @@
893
1225
  "figmaVariableId": "VariableID:2:230"
894
1226
  },
895
1227
  "uai-heading-md-font-size": {
896
- "description": "Heading MD — 20px. Subsections.",
1228
+ "description": "Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px).",
897
1229
  "type": "dimension",
898
1230
  "collection": "Typography",
899
1231
  "scopes": [
@@ -902,7 +1234,7 @@
902
1234
  "figmaVariableId": "VariableID:2:232"
903
1235
  },
904
1236
  "uai-heading-md-line-height": {
905
- "description": "Heading MD — 28px.",
1237
+ "description": "Heading MD line height: 28px. Pair: heading/md/font-size (20px).",
906
1238
  "type": "dimension",
907
1239
  "collection": "Typography",
908
1240
  "scopes": [
@@ -911,7 +1243,7 @@
911
1243
  "figmaVariableId": "VariableID:2:233"
912
1244
  },
913
1245
  "uai-heading-xl-font-size": {
914
- "description": "Heading XL — 32px. Main page title.",
1246
+ "description": "Heading XL font size: 32px. Use: the main title of a page, one per view. Pair: heading/xl/line-height (40px). Avoid: section titles; use heading/lg.",
915
1247
  "type": "dimension",
916
1248
  "collection": "Typography",
917
1249
  "scopes": [
@@ -920,7 +1252,7 @@
920
1252
  "figmaVariableId": "VariableID:2:226"
921
1253
  },
922
1254
  "uai-heading-xl-line-height": {
923
- "description": "Heading XL — 40px.",
1255
+ "description": "Heading XL line height: 40px. Pair: heading/xl/font-size (32px).",
924
1256
  "type": "dimension",
925
1257
  "collection": "Typography",
926
1258
  "scopes": [
@@ -929,7 +1261,7 @@
929
1261
  "figmaVariableId": "VariableID:2:227"
930
1262
  },
931
1263
  "uai-letter-spacing-expanded": {
932
- "description": "Expanded letter spacing (0.2em). Spaced body variant.",
1264
+ "description": "Letter spacing 2.8px (0.2em at 14px). Use only for the spaced body variant (body/base/regular-space). Avoid: headings, long text and small sizes.",
933
1265
  "type": "dimension",
934
1266
  "collection": "Typography",
935
1267
  "scopes": [
@@ -938,7 +1270,7 @@
938
1270
  "figmaVariableId": "VariableID:2:261"
939
1271
  },
940
1272
  "uai-letter-spacing-normal": {
941
- "description": "Default letter spacing for all text styles.",
1273
+ "description": "Letter spacing 0px. Default tracking for every text role. Use unless a text style explicitly asks for expanded tracking.",
942
1274
  "type": "dimension",
943
1275
  "collection": "Typography",
944
1276
  "scopes": [
@@ -947,7 +1279,7 @@
947
1279
  "figmaVariableId": "VariableID:2:260"
948
1280
  },
949
1281
  "uai-overline-font-size": {
950
- "description": "Overline — 10px. Tags, restricted use.",
1282
+ "description": "Overline font size: 10px. Restricted use: tags and small category labels. Pair: overline/line-height (16px). Avoid: body copy or any essential information.",
951
1283
  "type": "dimension",
952
1284
  "collection": "Typography",
953
1285
  "scopes": [
@@ -956,7 +1288,7 @@
956
1288
  "figmaVariableId": "VariableID:2:250"
957
1289
  },
958
1290
  "uai-overline-line-height": {
959
- "description": "Overline — 16px.",
1291
+ "description": "Overline line height: 16px. Pair: overline/font-size (10px).",
960
1292
  "type": "dimension",
961
1293
  "collection": "Typography",
962
1294
  "scopes": [
@@ -965,7 +1297,7 @@
965
1297
  "figmaVariableId": "VariableID:2:251"
966
1298
  },
967
1299
  "uai-title-font-size": {
968
- "description": "Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text.",
1300
+ "description": "Title compatibility alias for title/md — 16px.",
969
1301
  "type": "dimension",
970
1302
  "collection": "Typography",
971
1303
  "scopes": [
@@ -973,13 +1305,67 @@
973
1305
  ],
974
1306
  "figmaVariableId": "VariableID:2:235"
975
1307
  },
1308
+ "uai-title-lg-font-size": {
1309
+ "description": "Title Large — 18px. Primary page titles.",
1310
+ "type": "dimension",
1311
+ "collection": "Typography",
1312
+ "scopes": [
1313
+ "FONT_SIZE"
1314
+ ],
1315
+ "figmaVariableId": "VariableID:296:3"
1316
+ },
1317
+ "uai-title-lg-line-height": {
1318
+ "description": "Title Large — 24px line height.",
1319
+ "type": "dimension",
1320
+ "collection": "Typography",
1321
+ "scopes": [
1322
+ "LINE_HEIGHT"
1323
+ ],
1324
+ "figmaVariableId": "VariableID:296:4"
1325
+ },
976
1326
  "uai-title-line-height": {
977
- "description": "Title — 24px.",
1327
+ "description": "Title compatibility alias for title/md — 24px.",
978
1328
  "type": "dimension",
979
1329
  "collection": "Typography",
980
1330
  "scopes": [
981
1331
  "LINE_HEIGHT"
982
1332
  ],
983
1333
  "figmaVariableId": "VariableID:2:236"
1334
+ },
1335
+ "uai-title-md-font-size": {
1336
+ "description": "Title Medium — 16px. Card titles, strong labels, navigation.",
1337
+ "type": "dimension",
1338
+ "collection": "Typography",
1339
+ "scopes": [
1340
+ "FONT_SIZE"
1341
+ ],
1342
+ "figmaVariableId": "VariableID:296:5"
1343
+ },
1344
+ "uai-title-md-line-height": {
1345
+ "description": "Title Medium — 24px line height.",
1346
+ "type": "dimension",
1347
+ "collection": "Typography",
1348
+ "scopes": [
1349
+ "LINE_HEIGHT"
1350
+ ],
1351
+ "figmaVariableId": "VariableID:296:6"
1352
+ },
1353
+ "uai-title-sm-font-size": {
1354
+ "description": "Title Small — 14px. Compact titles and labels.",
1355
+ "type": "dimension",
1356
+ "collection": "Typography",
1357
+ "scopes": [
1358
+ "FONT_SIZE"
1359
+ ],
1360
+ "figmaVariableId": "VariableID:296:7"
1361
+ },
1362
+ "uai-title-sm-line-height": {
1363
+ "description": "Title Small — 20px line height.",
1364
+ "type": "dimension",
1365
+ "collection": "Typography",
1366
+ "scopes": [
1367
+ "LINE_HEIGHT"
1368
+ ],
1369
+ "figmaVariableId": "VariableID:296:8"
984
1370
  }
985
1371
  }