blip-tokens 2.2.1 → 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 button (delete, remove). Same red as feedback/error.",
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 destructive buttons.",
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": [
@@ -52,8 +85,29 @@
52
85
  ],
53
86
  "figmaVariableId": "VariableID:2:289"
54
87
  },
88
+ "uai-action-positive": {
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.",
90
+ "type": "color",
91
+ "collection": "Colors",
92
+ "scopes": [
93
+ "FRAME_FILL",
94
+ "SHAPE_FILL",
95
+ "STROKE_COLOR"
96
+ ],
97
+ "figmaVariableId": "VariableID:202:2"
98
+ },
99
+ "uai-action-positive-foreground": {
100
+ "description": "Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark.",
101
+ "type": "color",
102
+ "collection": "Colors",
103
+ "scopes": [
104
+ "SHAPE_FILL",
105
+ "TEXT_FILL"
106
+ ],
107
+ "figmaVariableId": "VariableID:202:3"
108
+ },
55
109
  "uai-action-primary-default": {
56
- "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.",
57
111
  "type": "color",
58
112
  "collection": "Colors",
59
113
  "scopes": [
@@ -63,7 +117,7 @@
63
117
  "figmaVariableId": "VariableID:2:283"
64
118
  },
65
119
  "uai-action-primary-foreground": {
66
- "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.",
67
121
  "type": "color",
68
122
  "collection": "Colors",
69
123
  "scopes": [
@@ -74,7 +128,7 @@
74
128
  "figmaVariableId": "VariableID:2:286"
75
129
  },
76
130
  "uai-action-primary-hover": {
77
- "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.",
78
132
  "type": "color",
79
133
  "collection": "Colors",
80
134
  "scopes": [
@@ -84,7 +138,7 @@
84
138
  "figmaVariableId": "VariableID:2:284"
85
139
  },
86
140
  "uai-action-primary-pressed": {
87
- "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.",
88
142
  "type": "color",
89
143
  "collection": "Colors",
90
144
  "scopes": [
@@ -94,7 +148,7 @@
94
148
  "figmaVariableId": "VariableID:2:285"
95
149
  },
96
150
  "uai-border-default": {
97
- "description": "Default border. Cards, dividers, separators.",
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.",
98
152
  "type": "color",
99
153
  "collection": "Colors",
100
154
  "scopes": [
@@ -103,7 +157,7 @@
103
157
  "figmaVariableId": "VariableID:2:296"
104
158
  },
105
159
  "uai-border-input": {
106
- "description": "Form control border. Inputs, selects, checkboxes, outline buttons.",
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.",
107
161
  "type": "color",
108
162
  "collection": "Colors",
109
163
  "scopes": [
@@ -112,7 +166,7 @@
112
166
  "figmaVariableId": "VariableID:2:297"
113
167
  },
114
168
  "uai-border-ring": {
115
- "description": "Focus ring for keyboard navigation.",
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.",
116
170
  "type": "color",
117
171
  "collection": "Colors",
118
172
  "scopes": [
@@ -121,7 +175,7 @@
121
175
  "figmaVariableId": "VariableID:2:298"
122
176
  },
123
177
  "uai-content-disabled": {
124
- "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.",
125
179
  "type": "color",
126
180
  "collection": "Colors",
127
181
  "scopes": [
@@ -132,7 +186,7 @@
132
186
  "figmaVariableId": "VariableID:2:279"
133
187
  },
134
188
  "uai-content-inverse": {
135
- "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.",
136
190
  "type": "color",
137
191
  "collection": "Colors",
138
192
  "scopes": [
@@ -143,7 +197,7 @@
143
197
  "figmaVariableId": "VariableID:144:636"
144
198
  },
145
199
  "uai-content-link": {
146
- "description": "Links and interactive navigation 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.",
147
201
  "type": "color",
148
202
  "collection": "Colors",
149
203
  "scopes": [
@@ -154,7 +208,7 @@
154
208
  "figmaVariableId": "VariableID:2:280"
155
209
  },
156
210
  "uai-content-placeholder": {
157
- "description": "Input placeholder and hint text. Not for disabled content.",
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.",
158
212
  "type": "color",
159
213
  "collection": "Colors",
160
214
  "scopes": [
@@ -165,7 +219,7 @@
165
219
  "figmaVariableId": "VariableID:2:281"
166
220
  },
167
221
  "uai-content-primary": {
168
- "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.",
169
223
  "type": "color",
170
224
  "collection": "Colors",
171
225
  "scopes": [
@@ -176,7 +230,7 @@
176
230
  "figmaVariableId": "VariableID:2:277"
177
231
  },
178
232
  "uai-content-secondary": {
179
- "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.",
180
234
  "type": "color",
181
235
  "collection": "Colors",
182
236
  "scopes": [
@@ -187,7 +241,7 @@
187
241
  "figmaVariableId": "VariableID:2:278"
188
242
  },
189
243
  "uai-feedback-error": {
190
- "description": "Error. Field errors, failures, destructive confirmations. Components call it "negative".",
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.",
191
245
  "type": "color",
192
246
  "collection": "Colors",
193
247
  "scopes": [
@@ -199,7 +253,7 @@
199
253
  "figmaVariableId": "VariableID:2:303"
200
254
  },
201
255
  "uai-feedback-error-subtle": {
202
- "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.",
203
257
  "type": "color",
204
258
  "collection": "Colors",
205
259
  "scopes": [
@@ -209,7 +263,7 @@
209
263
  "figmaVariableId": "VariableID:2:308"
210
264
  },
211
265
  "uai-feedback-info": {
212
- "description": "Information. Info alerts, status badges and icons.",
266
+ "description": "Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds.",
213
267
  "type": "color",
214
268
  "collection": "Colors",
215
269
  "scopes": [
@@ -221,7 +275,7 @@
221
275
  "figmaVariableId": "VariableID:2:300"
222
276
  },
223
277
  "uai-feedback-info-subtle": {
224
- "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.",
225
279
  "type": "color",
226
280
  "collection": "Colors",
227
281
  "scopes": [
@@ -231,7 +285,7 @@
231
285
  "figmaVariableId": "VariableID:2:305"
232
286
  },
233
287
  "uai-feedback-success": {
234
- "description": "Success. Confirmations, positive validation, completed states. Components call it "positive".",
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.",
235
289
  "type": "color",
236
290
  "collection": "Colors",
237
291
  "scopes": [
@@ -243,7 +297,7 @@
243
297
  "figmaVariableId": "VariableID:2:301"
244
298
  },
245
299
  "uai-feedback-success-subtle": {
246
- "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.",
247
301
  "type": "color",
248
302
  "collection": "Colors",
249
303
  "scopes": [
@@ -253,7 +307,7 @@
253
307
  "figmaVariableId": "VariableID:2:306"
254
308
  },
255
309
  "uai-feedback-warning": {
256
- "description": "Warning. States that need attention. For text on light surfaces, check contrast.",
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.",
257
311
  "type": "color",
258
312
  "collection": "Colors",
259
313
  "scopes": [
@@ -265,7 +319,7 @@
265
319
  "figmaVariableId": "VariableID:2:302"
266
320
  },
267
321
  "uai-feedback-warning-subtle": {
268
- "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.",
269
323
  "type": "color",
270
324
  "collection": "Colors",
271
325
  "scopes": [
@@ -275,7 +329,7 @@
275
329
  "figmaVariableId": "VariableID:2:307"
276
330
  },
277
331
  "uai-fixed-blue": {
278
- "description": "Blip blue that does not change with the theme. Selected states and highlights.",
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.",
279
333
  "type": "color",
280
334
  "collection": "Colors",
281
335
  "scopes": [
@@ -287,7 +341,7 @@
287
341
  "figmaVariableId": "VariableID:2:315"
288
342
  },
289
343
  "uai-fixed-brand": {
290
- "description": "Product brand color. Changes per product, not per theme. Banners, highlights.",
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.",
291
345
  "type": "color",
292
346
  "collection": "Colors",
293
347
  "scopes": [
@@ -299,7 +353,7 @@
299
353
  "figmaVariableId": "VariableID:2:316"
300
354
  },
301
355
  "uai-fixed-bright": {
302
- "description": "Light color that does not change with the theme. Text 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.",
303
357
  "type": "color",
304
358
  "collection": "Colors",
305
359
  "scopes": [
@@ -311,7 +365,7 @@
311
365
  "figmaVariableId": "VariableID:2:314"
312
366
  },
313
367
  "uai-fixed-dim": {
314
- "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.",
315
369
  "type": "color",
316
370
  "collection": "Colors",
317
371
  "scopes": [
@@ -323,7 +377,7 @@
323
377
  "figmaVariableId": "VariableID:2:313"
324
378
  },
325
379
  "uai-overlay-default": {
326
- "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.",
327
381
  "type": "color",
328
382
  "collection": "Colors",
329
383
  "scopes": [
@@ -333,7 +387,7 @@
333
387
  "figmaVariableId": "VariableID:2:309"
334
388
  },
335
389
  "uai-overlay-hover": {
336
- "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.",
337
391
  "type": "color",
338
392
  "collection": "Colors",
339
393
  "scopes": [
@@ -343,7 +397,7 @@
343
397
  "figmaVariableId": "VariableID:2:310"
344
398
  },
345
399
  "uai-overlay-insight": {
346
- "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.",
347
401
  "type": "color",
348
402
  "collection": "Colors",
349
403
  "scopes": [
@@ -353,7 +407,7 @@
353
407
  "figmaVariableId": "VariableID:2:312"
354
408
  },
355
409
  "uai-overlay-pressed": {
356
- "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.",
357
411
  "type": "color",
358
412
  "collection": "Colors",
359
413
  "scopes": [
@@ -362,8 +416,18 @@
362
416
  ],
363
417
  "figmaVariableId": "VariableID:2:311"
364
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
+ },
365
429
  "uai-surface-background": {
366
- "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.",
367
431
  "type": "color",
368
432
  "collection": "Colors",
369
433
  "scopes": [
@@ -373,7 +437,7 @@
373
437
  "figmaVariableId": "VariableID:2:263"
374
438
  },
375
439
  "uai-surface-contrast": {
376
- "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.",
377
441
  "type": "color",
378
442
  "collection": "Colors",
379
443
  "scopes": [
@@ -383,7 +447,7 @@
383
447
  "figmaVariableId": "VariableID:2:267"
384
448
  },
385
449
  "uai-surface-inverse": {
386
- "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.",
387
451
  "type": "color",
388
452
  "collection": "Colors",
389
453
  "scopes": [
@@ -393,7 +457,7 @@
393
457
  "figmaVariableId": "VariableID:2:268"
394
458
  },
395
459
  "uai-surface-muted": {
396
- "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.",
397
461
  "type": "color",
398
462
  "collection": "Colors",
399
463
  "scopes": [
@@ -403,7 +467,7 @@
403
467
  "figmaVariableId": "VariableID:2:271"
404
468
  },
405
469
  "uai-surface-paper": {
406
- "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.",
407
471
  "type": "color",
408
472
  "collection": "Colors",
409
473
  "scopes": [
@@ -413,7 +477,7 @@
413
477
  "figmaVariableId": "VariableID:2:265"
414
478
  },
415
479
  "uai-border-width-default": {
416
- "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.",
417
481
  "type": "dimension",
418
482
  "collection": "Dimensions",
419
483
  "scopes": [
@@ -422,7 +486,7 @@
422
486
  "figmaVariableId": "VariableID:10:51"
423
487
  },
424
488
  "uai-border-width-none": {
425
- "description": "Border width. 0px.",
489
+ "description": "Border width 0px. Use: removing a border explicitly.",
426
490
  "type": "dimension",
427
491
  "collection": "Dimensions",
428
492
  "scopes": [
@@ -431,7 +495,7 @@
431
495
  "figmaVariableId": "VariableID:10:49"
432
496
  },
433
497
  "uai-border-width-thick": {
434
- "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.",
435
499
  "type": "dimension",
436
500
  "collection": "Dimensions",
437
501
  "scopes": [
@@ -439,8 +503,62 @@
439
503
  ],
440
504
  "figmaVariableId": "VariableID:10:53"
441
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
+ },
551
+ "uai-opacity-focus-ring": {
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.",
553
+ "type": "number",
554
+ "collection": "Dimensions",
555
+ "scopes": [
556
+ "OPACITY"
557
+ ],
558
+ "figmaVariableId": "VariableID:192:2"
559
+ },
442
560
  "uai-radius-2xl": {
443
- "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.",
444
562
  "type": "dimension",
445
563
  "collection": "Dimensions",
446
564
  "scopes": [
@@ -449,7 +567,7 @@
449
567
  "figmaVariableId": "VariableID:10:23"
450
568
  },
451
569
  "uai-radius-full": {
452
- "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.",
453
571
  "type": "dimension",
454
572
  "collection": "Dimensions",
455
573
  "scopes": [
@@ -458,7 +576,7 @@
458
576
  "figmaVariableId": "VariableID:10:24"
459
577
  },
460
578
  "uai-radius-lg": {
461
- "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.",
462
580
  "type": "dimension",
463
581
  "collection": "Dimensions",
464
582
  "scopes": [
@@ -467,7 +585,7 @@
467
585
  "figmaVariableId": "VariableID:10:21"
468
586
  },
469
587
  "uai-radius-md": {
470
- "description": "Border radius. 8px.",
588
+ "description": "Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements.",
471
589
  "type": "dimension",
472
590
  "collection": "Dimensions",
473
591
  "scopes": [
@@ -476,7 +594,7 @@
476
594
  "figmaVariableId": "VariableID:10:20"
477
595
  },
478
596
  "uai-radius-none": {
479
- "description": "Border radius. 0px.",
597
+ "description": "Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements.",
480
598
  "type": "dimension",
481
599
  "collection": "Dimensions",
482
600
  "scopes": [
@@ -485,7 +603,7 @@
485
603
  "figmaVariableId": "VariableID:10:17"
486
604
  },
487
605
  "uai-radius-sm": {
488
- "description": "Border radius. 4px.",
606
+ "description": "Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements.",
489
607
  "type": "dimension",
490
608
  "collection": "Dimensions",
491
609
  "scopes": [
@@ -494,7 +612,7 @@
494
612
  "figmaVariableId": "VariableID:10:19"
495
613
  },
496
614
  "uai-radius-xl": {
497
- "description": "Border radius. 16px.",
615
+ "description": "Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying.",
498
616
  "type": "dimension",
499
617
  "collection": "Dimensions",
500
618
  "scopes": [
@@ -503,7 +621,7 @@
503
621
  "figmaVariableId": "VariableID:10:22"
504
622
  },
505
623
  "uai-radius-xs": {
506
- "description": "Border radius. 2px.",
624
+ "description": "Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers.",
507
625
  "type": "dimension",
508
626
  "collection": "Dimensions",
509
627
  "scopes": [
@@ -512,7 +630,7 @@
512
630
  "figmaVariableId": "VariableID:10:18"
513
631
  },
514
632
  "uai-sizing-2xl": {
515
- "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.",
516
634
  "type": "dimension",
517
635
  "collection": "Dimensions",
518
636
  "scopes": [
@@ -520,8 +638,17 @@
520
638
  ],
521
639
  "figmaVariableId": "VariableID:10:44"
522
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
+ },
523
650
  "uai-sizing-3xl": {
524
- "description": "Fixed size. 48px. Large avatars.",
651
+ "description": "Fixed size 48px. Use: standard avatar.",
525
652
  "type": "dimension",
526
653
  "collection": "Dimensions",
527
654
  "scopes": [
@@ -530,7 +657,7 @@
530
657
  "figmaVariableId": "VariableID:10:45"
531
658
  },
532
659
  "uai-sizing-4xl": {
533
- "description": "Fixed size. 64px. Extra large avatars.",
660
+ "description": "Fixed size 64px. Use: large avatar.",
534
661
  "type": "dimension",
535
662
  "collection": "Dimensions",
536
663
  "scopes": [
@@ -538,8 +665,17 @@
538
665
  ],
539
666
  "figmaVariableId": "VariableID:10:46"
540
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
+ },
541
677
  "uai-sizing-lg": {
542
- "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.",
543
679
  "type": "dimension",
544
680
  "collection": "Dimensions",
545
681
  "scopes": [
@@ -548,7 +684,7 @@
548
684
  "figmaVariableId": "VariableID:10:42"
549
685
  },
550
686
  "uai-sizing-md": {
551
- "description": "Fixed size. 20px. Icon small.",
687
+ "description": "Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls.",
552
688
  "type": "dimension",
553
689
  "collection": "Dimensions",
554
690
  "scopes": [
@@ -557,7 +693,7 @@
557
693
  "figmaVariableId": "VariableID:10:41"
558
694
  },
559
695
  "uai-sizing-sm": {
560
- "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.",
561
697
  "type": "dimension",
562
698
  "collection": "Dimensions",
563
699
  "scopes": [
@@ -566,7 +702,7 @@
566
702
  "figmaVariableId": "VariableID:10:40"
567
703
  },
568
704
  "uai-sizing-xl": {
569
- "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.",
570
706
  "type": "dimension",
571
707
  "collection": "Dimensions",
572
708
  "scopes": [
@@ -575,7 +711,7 @@
575
711
  "figmaVariableId": "VariableID:10:43"
576
712
  },
577
713
  "uai-sizing-xs": {
578
- "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/*.",
579
715
  "type": "dimension",
580
716
  "collection": "Dimensions",
581
717
  "scopes": [
@@ -584,7 +720,7 @@
584
720
  "figmaVariableId": "VariableID:10:39"
585
721
  },
586
722
  "uai-spacing-2xl": {
587
- "description": "Spacing. 40px.",
723
+ "description": "Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium.",
588
724
  "type": "dimension",
589
725
  "collection": "Dimensions",
590
726
  "scopes": [
@@ -593,7 +729,7 @@
593
729
  "figmaVariableId": "VariableID:10:33"
594
730
  },
595
731
  "uai-spacing-2xs": {
596
- "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.",
597
733
  "type": "dimension",
598
734
  "collection": "Dimensions",
599
735
  "scopes": [
@@ -602,7 +738,7 @@
602
738
  "figmaVariableId": "VariableID:10:27"
603
739
  },
604
740
  "uai-spacing-3xl": {
605
- "description": "Spacing. 48px.",
741
+ "description": "Spacing 48px. Layout spacing between large page regions.",
606
742
  "type": "dimension",
607
743
  "collection": "Dimensions",
608
744
  "scopes": [
@@ -611,7 +747,7 @@
611
747
  "figmaVariableId": "VariableID:10:34"
612
748
  },
613
749
  "uai-spacing-3xs": {
614
- "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/*.",
615
751
  "type": "dimension",
616
752
  "collection": "Dimensions",
617
753
  "scopes": [
@@ -620,7 +756,7 @@
620
756
  "figmaVariableId": "VariableID:10:26"
621
757
  },
622
758
  "uai-spacing-4xl": {
623
- "description": "Spacing. 56px.",
759
+ "description": "Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large.",
624
760
  "type": "dimension",
625
761
  "collection": "Dimensions",
626
762
  "scopes": [
@@ -629,7 +765,7 @@
629
765
  "figmaVariableId": "VariableID:10:35"
630
766
  },
631
767
  "uai-spacing-5xl": {
632
- "description": "Spacing. 64px.",
768
+ "description": "Spacing 64px. Layout spacing for page margins and large regions.",
633
769
  "type": "dimension",
634
770
  "collection": "Dimensions",
635
771
  "scopes": [
@@ -638,7 +774,7 @@
638
774
  "figmaVariableId": "VariableID:10:36"
639
775
  },
640
776
  "uai-spacing-6xl": {
641
- "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.",
642
778
  "type": "dimension",
643
779
  "collection": "Dimensions",
644
780
  "scopes": [
@@ -647,7 +783,7 @@
647
783
  "figmaVariableId": "VariableID:144:634"
648
784
  },
649
785
  "uai-spacing-7xl": {
650
- "description": "Spacing. 80px.",
786
+ "description": "Spacing 80px. Layout spacing for page margins and hero areas.",
651
787
  "type": "dimension",
652
788
  "collection": "Dimensions",
653
789
  "scopes": [
@@ -656,7 +792,7 @@
656
792
  "figmaVariableId": "VariableID:10:37"
657
793
  },
658
794
  "uai-spacing-8xl": {
659
- "description": "Spacing. 88px.",
795
+ "description": "Spacing 88px. Layout spacing for page margins and hero areas.",
660
796
  "type": "dimension",
661
797
  "collection": "Dimensions",
662
798
  "scopes": [
@@ -665,7 +801,7 @@
665
801
  "figmaVariableId": "VariableID:144:635"
666
802
  },
667
803
  "uai-spacing-9xl": {
668
- "description": "Spacing. 96px.",
804
+ "description": "Spacing 96px. Largest layout spacing, for hero and landing areas.",
669
805
  "type": "dimension",
670
806
  "collection": "Dimensions",
671
807
  "scopes": [
@@ -674,7 +810,7 @@
674
810
  "figmaVariableId": "VariableID:10:38"
675
811
  },
676
812
  "uai-spacing-lg": {
677
- "description": "Spacing. 24px.",
813
+ "description": "Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar).",
678
814
  "type": "dimension",
679
815
  "collection": "Dimensions",
680
816
  "scopes": [
@@ -683,7 +819,7 @@
683
819
  "figmaVariableId": "VariableID:10:31"
684
820
  },
685
821
  "uai-spacing-md": {
686
- "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.",
687
823
  "type": "dimension",
688
824
  "collection": "Dimensions",
689
825
  "scopes": [
@@ -692,7 +828,7 @@
692
828
  "figmaVariableId": "VariableID:10:30"
693
829
  },
694
830
  "uai-spacing-none": {
695
- "description": "Spacing. 0px.",
831
+ "description": "Spacing 0px. Use: removing gaps or padding explicitly.",
696
832
  "type": "dimension",
697
833
  "collection": "Dimensions",
698
834
  "scopes": [
@@ -701,7 +837,7 @@
701
837
  "figmaVariableId": "VariableID:10:25"
702
838
  },
703
839
  "uai-spacing-sm": {
704
- "description": "Spacing. 12px.",
840
+ "description": "Spacing 12px. Horizontal padding of buttons and other controls.",
705
841
  "type": "dimension",
706
842
  "collection": "Dimensions",
707
843
  "scopes": [
@@ -710,7 +846,7 @@
710
846
  "figmaVariableId": "VariableID:10:29"
711
847
  },
712
848
  "uai-spacing-xl": {
713
- "description": "Spacing. 32px.",
849
+ "description": "Spacing 32px. Layout spacing between page sections.",
714
850
  "type": "dimension",
715
851
  "collection": "Dimensions",
716
852
  "scopes": [
@@ -719,7 +855,7 @@
719
855
  "figmaVariableId": "VariableID:10:32"
720
856
  },
721
857
  "uai-spacing-xs": {
722
- "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.",
723
859
  "type": "dimension",
724
860
  "collection": "Dimensions",
725
861
  "scopes": [
@@ -727,8 +863,198 @@
727
863
  ],
728
864
  "figmaVariableId": "VariableID:10:28"
729
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
+ },
730
1056
  "uai-body-base-font-size": {
731
- "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.",
732
1058
  "type": "dimension",
733
1059
  "collection": "Typography",
734
1060
  "scopes": [
@@ -737,7 +1063,7 @@
737
1063
  "figmaVariableId": "VariableID:2:241"
738
1064
  },
739
1065
  "uai-body-base-line-height": {
740
- "description": "Body Base — 22px.",
1066
+ "description": "Body Base line height: 22px. Pair: body/base/font-size (14px).",
741
1067
  "type": "dimension",
742
1068
  "collection": "Typography",
743
1069
  "scopes": [
@@ -745,8 +1071,44 @@
745
1071
  ],
746
1072
  "figmaVariableId": "VariableID:2:242"
747
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
+ },
748
1110
  "uai-caption-font-size": {
749
- "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.",
750
1112
  "type": "dimension",
751
1113
  "collection": "Typography",
752
1114
  "scopes": [
@@ -755,7 +1117,7 @@
755
1117
  "figmaVariableId": "VariableID:2:247"
756
1118
  },
757
1119
  "uai-caption-line-height": {
758
- "description": "Caption — 20px.",
1120
+ "description": "Caption line height: 20px. Pair: caption/font-size (12px).",
759
1121
  "type": "dimension",
760
1122
  "collection": "Typography",
761
1123
  "scopes": [
@@ -764,7 +1126,7 @@
764
1126
  "figmaVariableId": "VariableID:2:248"
765
1127
  },
766
1128
  "uai-display-font-size": {
767
- "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.",
768
1130
  "type": "dimension",
769
1131
  "collection": "Typography",
770
1132
  "scopes": [
@@ -773,7 +1135,7 @@
773
1135
  "figmaVariableId": "VariableID:2:223"
774
1136
  },
775
1137
  "uai-display-line-height": {
776
- "description": "Display — 48px.",
1138
+ "description": "Display line height: 48px. Pair: display/font-size (40px). Use only with display text.",
777
1139
  "type": "dimension",
778
1140
  "collection": "Typography",
779
1141
  "scopes": [
@@ -782,7 +1144,7 @@
782
1144
  "figmaVariableId": "VariableID:2:224"
783
1145
  },
784
1146
  "uai-font-family-display": {
785
- "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.",
786
1148
  "type": "fontFamily",
787
1149
  "collection": "Typography",
788
1150
  "scopes": [
@@ -791,7 +1153,7 @@
791
1153
  "figmaVariableId": "VariableID:2:222"
792
1154
  },
793
1155
  "uai-font-family-sans": {
794
- "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.",
795
1157
  "type": "fontFamily",
796
1158
  "collection": "Typography",
797
1159
  "scopes": [
@@ -800,7 +1162,7 @@
800
1162
  "figmaVariableId": "VariableID:2:221"
801
1163
  },
802
1164
  "uai-font-weight-bold": {
803
- "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.",
804
1166
  "type": "fontWeight",
805
1167
  "collection": "Typography",
806
1168
  "scopes": [
@@ -809,7 +1171,7 @@
809
1171
  "figmaVariableId": "VariableID:2:257"
810
1172
  },
811
1173
  "uai-font-weight-extrabold": {
812
- "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.",
813
1175
  "type": "fontWeight",
814
1176
  "collection": "Typography",
815
1177
  "scopes": [
@@ -818,7 +1180,7 @@
818
1180
  "figmaVariableId": "VariableID:2:258"
819
1181
  },
820
1182
  "uai-font-weight-medium": {
821
- "description": "Medium weight (500). Labels, buttons.",
1183
+ "description": "Font weight 500. Light emphasis: button labels, avatar initials and active navigation items.",
822
1184
  "type": "fontWeight",
823
1185
  "collection": "Typography",
824
1186
  "scopes": [
@@ -827,7 +1189,7 @@
827
1189
  "figmaVariableId": "VariableID:2:255"
828
1190
  },
829
1191
  "uai-font-weight-regular": {
830
- "description": "Regular weight (400). Default body text.",
1192
+ "description": "Font weight 400. Default for body text, input values and helper, error and success messages.",
831
1193
  "type": "fontWeight",
832
1194
  "collection": "Typography",
833
1195
  "scopes": [
@@ -836,7 +1198,7 @@
836
1198
  "figmaVariableId": "VariableID:2:254"
837
1199
  },
838
1200
  "uai-font-weight-semibold": {
839
- "description": "SemiBold weight (600). Subtitles, navigation.",
1201
+ "description": "Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles.",
840
1202
  "type": "fontWeight",
841
1203
  "collection": "Typography",
842
1204
  "scopes": [
@@ -845,7 +1207,7 @@
845
1207
  "figmaVariableId": "VariableID:2:256"
846
1208
  },
847
1209
  "uai-heading-lg-font-size": {
848
- "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).",
849
1211
  "type": "dimension",
850
1212
  "collection": "Typography",
851
1213
  "scopes": [
@@ -854,7 +1216,7 @@
854
1216
  "figmaVariableId": "VariableID:2:229"
855
1217
  },
856
1218
  "uai-heading-lg-line-height": {
857
- "description": "Heading LG — 32px.",
1219
+ "description": "Heading LG line height: 32px. Pair: heading/lg/font-size (24px).",
858
1220
  "type": "dimension",
859
1221
  "collection": "Typography",
860
1222
  "scopes": [
@@ -863,7 +1225,7 @@
863
1225
  "figmaVariableId": "VariableID:2:230"
864
1226
  },
865
1227
  "uai-heading-md-font-size": {
866
- "description": "Heading MD — 20px. Subsections.",
1228
+ "description": "Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px).",
867
1229
  "type": "dimension",
868
1230
  "collection": "Typography",
869
1231
  "scopes": [
@@ -872,7 +1234,7 @@
872
1234
  "figmaVariableId": "VariableID:2:232"
873
1235
  },
874
1236
  "uai-heading-md-line-height": {
875
- "description": "Heading MD — 28px.",
1237
+ "description": "Heading MD line height: 28px. Pair: heading/md/font-size (20px).",
876
1238
  "type": "dimension",
877
1239
  "collection": "Typography",
878
1240
  "scopes": [
@@ -881,7 +1243,7 @@
881
1243
  "figmaVariableId": "VariableID:2:233"
882
1244
  },
883
1245
  "uai-heading-xl-font-size": {
884
- "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.",
885
1247
  "type": "dimension",
886
1248
  "collection": "Typography",
887
1249
  "scopes": [
@@ -890,7 +1252,7 @@
890
1252
  "figmaVariableId": "VariableID:2:226"
891
1253
  },
892
1254
  "uai-heading-xl-line-height": {
893
- "description": "Heading XL — 40px.",
1255
+ "description": "Heading XL line height: 40px. Pair: heading/xl/font-size (32px).",
894
1256
  "type": "dimension",
895
1257
  "collection": "Typography",
896
1258
  "scopes": [
@@ -899,7 +1261,7 @@
899
1261
  "figmaVariableId": "VariableID:2:227"
900
1262
  },
901
1263
  "uai-letter-spacing-expanded": {
902
- "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.",
903
1265
  "type": "dimension",
904
1266
  "collection": "Typography",
905
1267
  "scopes": [
@@ -908,7 +1270,7 @@
908
1270
  "figmaVariableId": "VariableID:2:261"
909
1271
  },
910
1272
  "uai-letter-spacing-normal": {
911
- "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.",
912
1274
  "type": "dimension",
913
1275
  "collection": "Typography",
914
1276
  "scopes": [
@@ -917,7 +1279,7 @@
917
1279
  "figmaVariableId": "VariableID:2:260"
918
1280
  },
919
1281
  "uai-overline-font-size": {
920
- "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.",
921
1283
  "type": "dimension",
922
1284
  "collection": "Typography",
923
1285
  "scopes": [
@@ -926,7 +1288,7 @@
926
1288
  "figmaVariableId": "VariableID:2:250"
927
1289
  },
928
1290
  "uai-overline-line-height": {
929
- "description": "Overline — 16px.",
1291
+ "description": "Overline line height: 16px. Pair: overline/font-size (10px).",
930
1292
  "type": "dimension",
931
1293
  "collection": "Typography",
932
1294
  "scopes": [
@@ -935,7 +1297,7 @@
935
1297
  "figmaVariableId": "VariableID:2:251"
936
1298
  },
937
1299
  "uai-title-font-size": {
938
- "description": "Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text.",
1300
+ "description": "Title compatibility alias for title/md — 16px.",
939
1301
  "type": "dimension",
940
1302
  "collection": "Typography",
941
1303
  "scopes": [
@@ -943,13 +1305,67 @@
943
1305
  ],
944
1306
  "figmaVariableId": "VariableID:2:235"
945
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
+ },
946
1326
  "uai-title-line-height": {
947
- "description": "Title — 24px.",
1327
+ "description": "Title compatibility alias for title/md — 24px.",
948
1328
  "type": "dimension",
949
1329
  "collection": "Typography",
950
1330
  "scopes": [
951
1331
  "LINE_HEIGHT"
952
1332
  ],
953
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"
954
1370
  }
955
1371
  }