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,9 +1,88 @@
1
1
  {
2
2
  "color": {
3
+ "accent": {
4
+ "ai": {
5
+ "end": {
6
+ "$type": "color",
7
+ "$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.",
8
+ "$extensions": {
9
+ "com.blip.figma": {
10
+ "variableId": "VariableID:271:32",
11
+ "collectionId": "VariableCollectionId:2:262",
12
+ "collection": "Colors",
13
+ "scopes": [
14
+ "FRAME_FILL",
15
+ "SHAPE_FILL",
16
+ "STROKE_COLOR"
17
+ ]
18
+ }
19
+ },
20
+ "$value": {
21
+ "colorSpace": "srgb",
22
+ "components": [
23
+ 0,
24
+ 0.776471,
25
+ 0.843137
26
+ ],
27
+ "alpha": 1
28
+ }
29
+ },
30
+ "middle": {
31
+ "$type": "color",
32
+ "$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.",
33
+ "$extensions": {
34
+ "com.blip.figma": {
35
+ "variableId": "VariableID:271:31",
36
+ "collectionId": "VariableCollectionId:2:262",
37
+ "collection": "Colors",
38
+ "scopes": [
39
+ "FRAME_FILL",
40
+ "SHAPE_FILL",
41
+ "STROKE_COLOR"
42
+ ]
43
+ }
44
+ },
45
+ "$value": {
46
+ "colorSpace": "srgb",
47
+ "components": [
48
+ 0.658824,
49
+ 0.333333,
50
+ 0.968627
51
+ ],
52
+ "alpha": 1
53
+ }
54
+ },
55
+ "start": {
56
+ "$type": "color",
57
+ "$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.",
58
+ "$extensions": {
59
+ "com.blip.figma": {
60
+ "variableId": "VariableID:271:30",
61
+ "collectionId": "VariableCollectionId:2:262",
62
+ "collection": "Colors",
63
+ "scopes": [
64
+ "FRAME_FILL",
65
+ "SHAPE_FILL",
66
+ "STROKE_COLOR"
67
+ ]
68
+ }
69
+ },
70
+ "$value": {
71
+ "colorSpace": "srgb",
72
+ "components": [
73
+ 0,
74
+ 0.6,
75
+ 1
76
+ ],
77
+ "alpha": 1
78
+ }
79
+ }
80
+ }
81
+ },
3
82
  "action": {
4
83
  "destructive": {
5
84
  "$type": "color",
6
- "$description": "Destructive button (delete, remove). Same red as feedback/error.",
85
+ "$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.",
7
86
  "$extensions": {
8
87
  "com.blip.figma": {
9
88
  "variableId": "VariableID:2:290",
@@ -29,7 +108,7 @@
29
108
  },
30
109
  "destructive-foreground": {
31
110
  "$type": "color",
32
- "$description": "Text and icons on destructive buttons.",
111
+ "$description": "Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright.",
33
112
  "$extensions": {
34
113
  "com.blip.figma": {
35
114
  "variableId": "VariableID:2:291",
@@ -55,7 +134,7 @@
55
134
  "outline": {
56
135
  "default": {
57
136
  "$type": "color",
58
- "$description": "Outline and text button background — default state.",
137
+ "$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.",
59
138
  "$extensions": {
60
139
  "com.blip.figma": {
61
140
  "variableId": "VariableID:2:287",
@@ -79,7 +158,7 @@
79
158
  },
80
159
  "hover": {
81
160
  "$type": "color",
82
- "$description": "Outline and text button background — hover state. Also list item hover.",
161
+ "$description": "Theme-aware hover background of outline and text actions. Also the hover background of list and menu items.",
83
162
  "$extensions": {
84
163
  "com.blip.figma": {
85
164
  "variableId": "VariableID:2:288",
@@ -103,7 +182,7 @@
103
182
  },
104
183
  "pressed": {
105
184
  "$type": "color",
106
- "$description": "Outline and text button background — pressed state. Also selected list item.",
185
+ "$description": "Theme-aware pressed background of outline and text actions. Also the background of the selected list or menu item.",
107
186
  "$extensions": {
108
187
  "com.blip.figma": {
109
188
  "variableId": "VariableID:2:289",
@@ -126,10 +205,59 @@
126
205
  }
127
206
  }
128
207
  },
208
+ "positive": {
209
+ "$type": "color",
210
+ "$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.",
211
+ "$extensions": {
212
+ "com.blip.figma": {
213
+ "variableId": "VariableID:202:2",
214
+ "collectionId": "VariableCollectionId:2:262",
215
+ "collection": "Colors",
216
+ "scopes": [
217
+ "FRAME_FILL",
218
+ "SHAPE_FILL",
219
+ "STROKE_COLOR"
220
+ ]
221
+ }
222
+ },
223
+ "$value": {
224
+ "colorSpace": "srgb",
225
+ "components": [
226
+ 0.015686,
227
+ 0.470588,
228
+ 0.341176
229
+ ],
230
+ "alpha": 1
231
+ }
232
+ },
233
+ "positive-foreground": {
234
+ "$type": "color",
235
+ "$description": "Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark.",
236
+ "$extensions": {
237
+ "com.blip.figma": {
238
+ "variableId": "VariableID:202:3",
239
+ "collectionId": "VariableCollectionId:2:262",
240
+ "collection": "Colors",
241
+ "scopes": [
242
+ "SHAPE_FILL",
243
+ "TEXT_FILL"
244
+ ]
245
+ }
246
+ },
247
+ "$value": {
248
+ "colorSpace": "srgb",
249
+ "components": [
250
+ 1,
251
+ 1,
252
+ 1
253
+ ],
254
+ "alpha": 1
255
+ }
256
+ },
129
257
  "primary": {
130
258
  "default": {
131
259
  "$type": "color",
132
- "$description": "Primary button background — default state.",
260
+ "$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.",
133
261
  "$extensions": {
134
262
  "com.blip.figma": {
135
263
  "variableId": "VariableID:2:283",
@@ -153,7 +281,7 @@
153
281
  },
154
282
  "foreground": {
155
283
  "$type": "color",
156
- "$description": "Text and icons on primary buttons.",
284
+ "$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.",
157
285
  "$extensions": {
158
286
  "com.blip.figma": {
159
287
  "variableId": "VariableID:2:286",
@@ -178,7 +306,7 @@
178
306
  },
179
307
  "hover": {
180
308
  "$type": "color",
181
- "$description": "Primary button background — hover state.",
309
+ "$description": "Theme-aware background of primary actions on hover. Use only as the hover state of action/primary/default. Pair: action/primary/foreground.",
182
310
  "$extensions": {
183
311
  "com.blip.figma": {
184
312
  "variableId": "VariableID:2:284",
@@ -202,7 +330,7 @@
202
330
  },
203
331
  "pressed": {
204
332
  "$type": "color",
205
- "$description": "Primary button background — pressed state.",
333
+ "$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.",
206
334
  "$extensions": {
207
335
  "com.blip.figma": {
208
336
  "variableId": "VariableID:2:285",
@@ -229,7 +357,7 @@
229
357
  "border": {
230
358
  "default": {
231
359
  "$type": "color",
232
- "$description": "Default border. Cards, dividers, separators.",
360
+ "$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.",
233
361
  "$extensions": {
234
362
  "com.blip.figma": {
235
363
  "variableId": "VariableID:2:296",
@@ -252,7 +380,7 @@
252
380
  },
253
381
  "input": {
254
382
  "$type": "color",
255
- "$description": "Form control border. Inputs, selects, checkboxes, outline buttons.",
383
+ "$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.",
256
384
  "$extensions": {
257
385
  "com.blip.figma": {
258
386
  "variableId": "VariableID:2:297",
@@ -275,7 +403,7 @@
275
403
  },
276
404
  "ring": {
277
405
  "$type": "color",
278
- "$description": "Focus ring for keyboard navigation.",
406
+ "$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.",
279
407
  "$extensions": {
280
408
  "com.blip.figma": {
281
409
  "variableId": "VariableID:2:298",
@@ -289,9 +417,9 @@
289
417
  "$value": {
290
418
  "colorSpace": "srgb",
291
419
  "components": [
292
- 0.752941,
293
- 0.517647,
294
- 0.988235
420
+ 0.141176,
421
+ 0.152941,
422
+ 0.160784
295
423
  ],
296
424
  "alpha": 1
297
425
  }
@@ -300,7 +428,7 @@
300
428
  "content": {
301
429
  "disabled": {
302
430
  "$type": "color",
303
- "$description": "Disabled text and icons.",
431
+ "$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.",
304
432
  "$extensions": {
305
433
  "com.blip.figma": {
306
434
  "variableId": "VariableID:2:279",
@@ -325,7 +453,7 @@
325
453
  },
326
454
  "inverse": {
327
455
  "$type": "color",
328
- "$description": "Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary.",
456
+ "$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.",
329
457
  "$extensions": {
330
458
  "com.blip.figma": {
331
459
  "variableId": "VariableID:144:636",
@@ -350,7 +478,7 @@
350
478
  },
351
479
  "link": {
352
480
  "$type": "color",
353
- "$description": "Links and interactive navigation text.",
481
+ "$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.",
354
482
  "$extensions": {
355
483
  "com.blip.figma": {
356
484
  "variableId": "VariableID:2:280",
@@ -375,7 +503,7 @@
375
503
  },
376
504
  "placeholder": {
377
505
  "$type": "color",
378
- "$description": "Input placeholder and hint text. Not for disabled content.",
506
+ "$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.",
379
507
  "$extensions": {
380
508
  "com.blip.figma": {
381
509
  "variableId": "VariableID:2:281",
@@ -400,7 +528,7 @@
400
528
  },
401
529
  "primary": {
402
530
  "$type": "color",
403
- "$description": "Primary text and icons. Headings, body text, form labels.",
531
+ "$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.",
404
532
  "$extensions": {
405
533
  "com.blip.figma": {
406
534
  "variableId": "VariableID:2:277",
@@ -425,7 +553,7 @@
425
553
  },
426
554
  "secondary": {
427
555
  "$type": "color",
428
- "$description": "Secondary text and icons. Descriptions, supporting text, text on muted surfaces.",
556
+ "$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.",
429
557
  "$extensions": {
430
558
  "com.blip.figma": {
431
559
  "variableId": "VariableID:2:278",
@@ -452,7 +580,7 @@
452
580
  "feedback": {
453
581
  "error": {
454
582
  "$type": "color",
455
- "$description": "Error. Field errors, failures, destructive confirmations. Components call it "negative".",
583
+ "$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.",
456
584
  "$extensions": {
457
585
  "com.blip.figma": {
458
586
  "variableId": "VariableID:2:303",
@@ -478,7 +606,7 @@
478
606
  },
479
607
  "error-subtle": {
480
608
  "$type": "color",
481
- "$description": "Error alert background. Pair with feedback/error for the icon.",
609
+ "$description": "Theme-aware background of error alerts, banners and inline status areas. Pair: feedback/error for the icon and content/primary for the text.",
482
610
  "$extensions": {
483
611
  "com.blip.figma": {
484
612
  "variableId": "VariableID:2:308",
@@ -502,7 +630,7 @@
502
630
  },
503
631
  "info": {
504
632
  "$type": "color",
505
- "$description": "Information. Info alerts, status badges and icons.",
633
+ "$description": "Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds.",
506
634
  "$extensions": {
507
635
  "com.blip.figma": {
508
636
  "variableId": "VariableID:2:300",
@@ -528,7 +656,7 @@
528
656
  },
529
657
  "info-subtle": {
530
658
  "$type": "color",
531
- "$description": "Info alert background. Pair with feedback/info for the icon.",
659
+ "$description": "Theme-aware background of information alerts, banners and inline status areas. Pair: feedback/info for the icon and content/primary for the text.",
532
660
  "$extensions": {
533
661
  "com.blip.figma": {
534
662
  "variableId": "VariableID:2:305",
@@ -552,7 +680,7 @@
552
680
  },
553
681
  "success": {
554
682
  "$type": "color",
555
- "$description": "Success. Confirmations, positive validation, completed states. Components call it "positive".",
683
+ "$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.",
556
684
  "$extensions": {
557
685
  "com.blip.figma": {
558
686
  "variableId": "VariableID:2:301",
@@ -578,7 +706,7 @@
578
706
  },
579
707
  "success-subtle": {
580
708
  "$type": "color",
581
- "$description": "Success alert background. Pair with feedback/success for the icon.",
709
+ "$description": "Theme-aware background of success alerts, banners and inline status areas. Pair: feedback/success for the icon and content/primary for the text.",
582
710
  "$extensions": {
583
711
  "com.blip.figma": {
584
712
  "variableId": "VariableID:2:306",
@@ -602,7 +730,7 @@
602
730
  },
603
731
  "warning": {
604
732
  "$type": "color",
605
- "$description": "Warning. States that need attention. For text on light surfaces, check contrast.",
733
+ "$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.",
606
734
  "$extensions": {
607
735
  "com.blip.figma": {
608
736
  "variableId": "VariableID:2:302",
@@ -628,7 +756,7 @@
628
756
  },
629
757
  "warning-subtle": {
630
758
  "$type": "color",
631
- "$description": "Warning alert background. Pair with feedback/warning for the icon.",
759
+ "$description": "Theme-aware background of warning alerts, banners and inline status areas. Pair: feedback/warning for the icon and content/primary for the text.",
632
760
  "$extensions": {
633
761
  "com.blip.figma": {
634
762
  "variableId": "VariableID:2:307",
@@ -654,7 +782,7 @@
654
782
  "fixed": {
655
783
  "blue": {
656
784
  "$type": "color",
657
- "$description": "Blip blue that does not change with the theme. Selected states and highlights.",
785
+ "$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.",
658
786
  "$extensions": {
659
787
  "com.blip.figma": {
660
788
  "variableId": "VariableID:2:315",
@@ -680,7 +808,7 @@
680
808
  },
681
809
  "brand": {
682
810
  "$type": "color",
683
- "$description": "Product brand color. Changes per product, not per theme. Banners, highlights.",
811
+ "$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.",
684
812
  "$extensions": {
685
813
  "com.blip.figma": {
686
814
  "variableId": "VariableID:2:316",
@@ -706,7 +834,7 @@
706
834
  },
707
835
  "bright": {
708
836
  "$type": "color",
709
- "$description": "Light color that does not change with the theme. Text on fixed/brand.",
837
+ "$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.",
710
838
  "$extensions": {
711
839
  "com.blip.figma": {
712
840
  "variableId": "VariableID:2:314",
@@ -732,7 +860,7 @@
732
860
  },
733
861
  "dim": {
734
862
  "$type": "color",
735
- "$description": "Dark color that does not change with the theme.",
863
+ "$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.",
736
864
  "$extensions": {
737
865
  "com.blip.figma": {
738
866
  "variableId": "VariableID:2:313",
@@ -760,7 +888,7 @@
760
888
  "overlay": {
761
889
  "default": {
762
890
  "$type": "color",
763
- "$description": "Backdrop behind modals, drawers and dialogs.",
891
+ "$description": "Theme-aware translucent backdrop behind modals, drawers and dialogs. Avoid: hover or pressed feedback; use overlay/hover or overlay/pressed.",
764
892
  "$extensions": {
765
893
  "com.blip.figma": {
766
894
  "variableId": "VariableID:2:309",
@@ -784,7 +912,7 @@
784
912
  },
785
913
  "hover": {
786
914
  "$type": "color",
787
- "$description": "Translucent layer for hover on any interactive surface.",
915
+ "$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.",
788
916
  "$extensions": {
789
917
  "com.blip.figma": {
790
918
  "variableId": "VariableID:2:310",
@@ -808,7 +936,7 @@
808
936
  },
809
937
  "insight": {
810
938
  "$type": "color",
811
- "$description": "Translucent background for insight panels and floating cards.",
939
+ "$description": "Theme-aware translucent background for insight panels and floating cards over content. Pair: content/primary.",
812
940
  "$extensions": {
813
941
  "com.blip.figma": {
814
942
  "variableId": "VariableID:2:312",
@@ -832,7 +960,7 @@
832
960
  },
833
961
  "pressed": {
834
962
  "$type": "color",
835
- "$description": "Translucent layer for pressed state on any interactive surface.",
963
+ "$description": "Theme-aware translucent pressed layer placed over any interactive surface. Use: the pressed state wherever overlay/hover is the hover state.",
836
964
  "$extensions": {
837
965
  "com.blip.figma": {
838
966
  "variableId": "VariableID:2:311",
@@ -853,12 +981,36 @@
853
981
  ],
854
982
  "alpha": 0.16
855
983
  }
984
+ },
985
+ "selected": {
986
+ "$type": "color",
987
+ "$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.",
988
+ "$extensions": {
989
+ "com.blip.figma": {
990
+ "variableId": "VariableID:271:29",
991
+ "collectionId": "VariableCollectionId:2:262",
992
+ "collection": "Colors",
993
+ "scopes": [
994
+ "FRAME_FILL",
995
+ "SHAPE_FILL"
996
+ ]
997
+ }
998
+ },
999
+ "$value": {
1000
+ "colorSpace": "srgb",
1001
+ "components": [
1002
+ 0,
1003
+ 0,
1004
+ 0
1005
+ ],
1006
+ "alpha": 0.06
1007
+ }
856
1008
  }
857
1009
  },
858
1010
  "surface": {
859
1011
  "background": {
860
1012
  "$type": "color",
861
- "$description": "Page background. The base layer behind every screen.",
1013
+ "$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.",
862
1014
  "$extensions": {
863
1015
  "com.blip.figma": {
864
1016
  "variableId": "VariableID:2:263",
@@ -882,7 +1034,7 @@
882
1034
  },
883
1035
  "contrast": {
884
1036
  "$type": "color",
885
- "$description": "Subtle contrast surface. Secondary panels, alternating sections, hovered or selected rows.",
1037
+ "$description": "Theme-aware subtle contrast surface. Use: secondary panels, alternating sections, hovered or selected table rows. Pair: content/primary. Avoid: the page background.",
886
1038
  "$extensions": {
887
1039
  "com.blip.figma": {
888
1040
  "variableId": "VariableID:2:267",
@@ -906,7 +1058,7 @@
906
1058
  },
907
1059
  "inverse": {
908
1060
  "$type": "color",
909
- "$description": "Inverted surface. Tooltips, snackbars, dark banners in light mode (and the reverse). Use content/inverse on it.",
1061
+ "$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.",
910
1062
  "$extensions": {
911
1063
  "com.blip.figma": {
912
1064
  "variableId": "VariableID:2:268",
@@ -930,7 +1082,7 @@
930
1082
  },
931
1083
  "muted": {
932
1084
  "$type": "color",
933
- "$description": "Muted surface. Chips, tags, code blocks, table headers. Use content/secondary on it.",
1085
+ "$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.",
934
1086
  "$extensions": {
935
1087
  "com.blip.figma": {
936
1088
  "variableId": "VariableID:2:271",
@@ -954,7 +1106,7 @@
954
1106
  },
955
1107
  "paper": {
956
1108
  "$type": "color",
957
- "$description": "Cards, modals, popovers, dropdowns and drawers. Add an elevation style when it floats.",
1109
+ "$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.",
958
1110
  "$extensions": {
959
1111
  "com.blip.figma": {
960
1112
  "variableId": "VariableID:2:265",
@@ -982,7 +1134,7 @@
982
1134
  "border-width": {
983
1135
  "default": {
984
1136
  "$type": "dimension",
985
- "$description": "Border width. 1px. Standard borders.",
1137
+ "$description": "Border width 1px. Default for every border: inputs, selects, checkboxes, cards and dividers, including the solid focus border of inputs.",
986
1138
  "$extensions": {
987
1139
  "com.blip.figma": {
988
1140
  "variableId": "VariableID:10:51",
@@ -1000,7 +1152,7 @@
1000
1152
  },
1001
1153
  "none": {
1002
1154
  "$type": "dimension",
1003
- "$description": "Border width. 0px.",
1155
+ "$description": "Border width 0px. Use: removing a border explicitly.",
1004
1156
  "$extensions": {
1005
1157
  "com.blip.figma": {
1006
1158
  "variableId": "VariableID:10:49",
@@ -1018,7 +1170,7 @@
1018
1170
  },
1019
1171
  "thick": {
1020
1172
  "$type": "dimension",
1021
- "$description": "Border width. 2px. Focus rings and emphasis borders.",
1173
+ "$description": "Border width 2px. Use: focus rings and halos, the checked radio border and emphasis borders.",
1022
1174
  "$extensions": {
1023
1175
  "com.blip.figma": {
1024
1176
  "variableId": "VariableID:10:53",
@@ -1035,10 +1187,116 @@
1035
1187
  }
1036
1188
  }
1037
1189
  },
1190
+ "control-height": {
1191
+ "compact": {
1192
+ "$type": "dimension",
1193
+ "$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.",
1194
+ "$extensions": {
1195
+ "com.blip.figma": {
1196
+ "variableId": "VariableID:271:12",
1197
+ "collectionId": "VariableCollectionId:10:16",
1198
+ "collection": "Dimensions",
1199
+ "scopes": [
1200
+ "WIDTH_HEIGHT"
1201
+ ]
1202
+ }
1203
+ },
1204
+ "$value": {
1205
+ "value": 24,
1206
+ "unit": "px"
1207
+ }
1208
+ },
1209
+ "large": {
1210
+ "$type": "dimension",
1211
+ "$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.",
1212
+ "$extensions": {
1213
+ "com.blip.figma": {
1214
+ "variableId": "VariableID:271:15",
1215
+ "collectionId": "VariableCollectionId:10:16",
1216
+ "collection": "Dimensions",
1217
+ "scopes": [
1218
+ "WIDTH_HEIGHT"
1219
+ ]
1220
+ }
1221
+ },
1222
+ "$value": {
1223
+ "value": 56,
1224
+ "unit": "px"
1225
+ }
1226
+ },
1227
+ "medium": {
1228
+ "$type": "dimension",
1229
+ "$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.",
1230
+ "$extensions": {
1231
+ "com.blip.figma": {
1232
+ "variableId": "VariableID:271:14",
1233
+ "collectionId": "VariableCollectionId:10:16",
1234
+ "collection": "Dimensions",
1235
+ "scopes": [
1236
+ "WIDTH_HEIGHT"
1237
+ ]
1238
+ }
1239
+ },
1240
+ "$value": {
1241
+ "value": 40,
1242
+ "unit": "px"
1243
+ }
1244
+ },
1245
+ "short": {
1246
+ "$type": "dimension",
1247
+ "$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.",
1248
+ "$extensions": {
1249
+ "com.blip.figma": {
1250
+ "variableId": "VariableID:271:13",
1251
+ "collectionId": "VariableCollectionId:10:16",
1252
+ "collection": "Dimensions",
1253
+ "scopes": [
1254
+ "WIDTH_HEIGHT"
1255
+ ]
1256
+ }
1257
+ },
1258
+ "$value": {
1259
+ "value": 32,
1260
+ "unit": "px"
1261
+ }
1262
+ }
1263
+ },
1264
+ "opacity": {
1265
+ "disabled": {
1266
+ "$type": "number",
1267
+ "$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.",
1268
+ "$extensions": {
1269
+ "com.blip.figma": {
1270
+ "variableId": "VariableID:255:15",
1271
+ "collectionId": "VariableCollectionId:10:16",
1272
+ "collection": "Dimensions",
1273
+ "scopes": [
1274
+ "OPACITY"
1275
+ ]
1276
+ }
1277
+ },
1278
+ "$value": 0.5
1279
+ },
1280
+ "focus-ring": {
1281
+ "$type": "number",
1282
+ "$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.",
1283
+ "$extensions": {
1284
+ "com.blip.figma": {
1285
+ "variableId": "VariableID:192:2",
1286
+ "collectionId": "VariableCollectionId:10:16",
1287
+ "collection": "Dimensions",
1288
+ "scopes": [
1289
+ "OPACITY"
1290
+ ]
1291
+ }
1292
+ },
1293
+ "$value": 0.3
1294
+ }
1295
+ },
1038
1296
  "radius": {
1039
1297
  "2xl": {
1040
1298
  "$type": "dimension",
1041
- "$description": "Border radius. 24px.",
1299
+ "$description": "Corner radius 24px. Reserved for very large surfaces; no UAI component uses it yet. Confirm with design before applying.",
1042
1300
  "$extensions": {
1043
1301
  "com.blip.figma": {
1044
1302
  "variableId": "VariableID:10:23",
@@ -1056,7 +1314,7 @@
1056
1314
  },
1057
1315
  "full": {
1058
1316
  "$type": "dimension",
1059
- "$description": "Border radius. Full round.",
1317
+ "$description": "Fully rounded corners (pill or circle). Use: avatars, radio buttons, the radio hover halo, badges and pill-shaped chips.",
1060
1318
  "$extensions": {
1061
1319
  "com.blip.figma": {
1062
1320
  "variableId": "VariableID:10:24",
@@ -1074,7 +1332,7 @@
1074
1332
  },
1075
1333
  "lg": {
1076
1334
  "$type": "dimension",
1077
- "$description": "Border radius. 12px.",
1335
+ "$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.",
1078
1336
  "$extensions": {
1079
1337
  "com.blip.figma": {
1080
1338
  "variableId": "VariableID:10:21",
@@ -1092,7 +1350,7 @@
1092
1350
  },
1093
1351
  "md": {
1094
1352
  "$type": "dimension",
1095
- "$description": "Border radius. 8px.",
1353
+ "$description": "Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements.",
1096
1354
  "$extensions": {
1097
1355
  "com.blip.figma": {
1098
1356
  "variableId": "VariableID:10:20",
@@ -1110,7 +1368,7 @@
1110
1368
  },
1111
1369
  "none": {
1112
1370
  "$type": "dimension",
1113
- "$description": "Border radius. 0px.",
1371
+ "$description": "Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements.",
1114
1372
  "$extensions": {
1115
1373
  "com.blip.figma": {
1116
1374
  "variableId": "VariableID:10:17",
@@ -1128,7 +1386,7 @@
1128
1386
  },
1129
1387
  "sm": {
1130
1388
  "$type": "dimension",
1131
- "$description": "Border radius. 4px.",
1389
+ "$description": "Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements.",
1132
1390
  "$extensions": {
1133
1391
  "com.blip.figma": {
1134
1392
  "variableId": "VariableID:10:19",
@@ -1146,7 +1404,7 @@
1146
1404
  },
1147
1405
  "xl": {
1148
1406
  "$type": "dimension",
1149
- "$description": "Border radius. 16px.",
1407
+ "$description": "Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying.",
1150
1408
  "$extensions": {
1151
1409
  "com.blip.figma": {
1152
1410
  "variableId": "VariableID:10:22",
@@ -1164,7 +1422,7 @@
1164
1422
  },
1165
1423
  "xs": {
1166
1424
  "$type": "dimension",
1167
- "$description": "Border radius. 2px.",
1425
+ "$description": "Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers.",
1168
1426
  "$extensions": {
1169
1427
  "com.blip.figma": {
1170
1428
  "variableId": "VariableID:10:18",
@@ -1184,7 +1442,7 @@
1184
1442
  "sizing": {
1185
1443
  "2xl": {
1186
1444
  "$type": "dimension",
1187
- "$description": "Fixed size. 40px. Medium avatars.",
1445
+ "$description": "Fixed size 40px. Use: small avatar and square icon containers. Avoid: control heights of buttons, inputs and selects; use control-height/medium.",
1188
1446
  "$extensions": {
1189
1447
  "com.blip.figma": {
1190
1448
  "variableId": "VariableID:10:44",
@@ -1200,9 +1458,27 @@
1200
1458
  "unit": "px"
1201
1459
  }
1202
1460
  },
1461
+ "2xs": {
1462
+ "$type": "dimension",
1463
+ "$description": "Fixed size 8px. Use: the tooltip arrow, notification dots on header actions and other very small indicators. Avoid: padding and gaps; use spacing/*.",
1464
+ "$extensions": {
1465
+ "com.blip.figma": {
1466
+ "variableId": "VariableID:271:16",
1467
+ "collectionId": "VariableCollectionId:10:16",
1468
+ "collection": "Dimensions",
1469
+ "scopes": [
1470
+ "WIDTH_HEIGHT"
1471
+ ]
1472
+ }
1473
+ },
1474
+ "$value": {
1475
+ "value": 8,
1476
+ "unit": "px"
1477
+ }
1478
+ },
1203
1479
  "3xl": {
1204
1480
  "$type": "dimension",
1205
- "$description": "Fixed size. 48px. Large avatars.",
1481
+ "$description": "Fixed size 48px. Use: standard avatar.",
1206
1482
  "$extensions": {
1207
1483
  "com.blip.figma": {
1208
1484
  "variableId": "VariableID:10:45",
@@ -1220,7 +1496,7 @@
1220
1496
  },
1221
1497
  "4xl": {
1222
1498
  "$type": "dimension",
1223
- "$description": "Fixed size. 64px. Extra large avatars.",
1499
+ "$description": "Fixed size 64px. Use: large avatar.",
1224
1500
  "$extensions": {
1225
1501
  "com.blip.figma": {
1226
1502
  "variableId": "VariableID:10:46",
@@ -1236,9 +1512,27 @@
1236
1512
  "unit": "px"
1237
1513
  }
1238
1514
  },
1515
+ "5xl": {
1516
+ "$type": "dimension",
1517
+ "$description": "Fixed size 72px. Use: extra-large avatar.",
1518
+ "$extensions": {
1519
+ "com.blip.figma": {
1520
+ "variableId": "VariableID:255:14",
1521
+ "collectionId": "VariableCollectionId:10:16",
1522
+ "collection": "Dimensions",
1523
+ "scopes": [
1524
+ "WIDTH_HEIGHT"
1525
+ ]
1526
+ }
1527
+ },
1528
+ "$value": {
1529
+ "value": 72,
1530
+ "unit": "px"
1531
+ }
1532
+ },
1239
1533
  "lg": {
1240
1534
  "$type": "dimension",
1241
- "$description": "Fixed size. 24px. Icon medium (default).",
1535
+ "$description": "Fixed size 24px. Use: default icons (uai-icon size medium) and the micro avatar. Avoid: control heights; use control-height/compact.",
1242
1536
  "$extensions": {
1243
1537
  "com.blip.figma": {
1244
1538
  "variableId": "VariableID:10:42",
@@ -1256,7 +1550,7 @@
1256
1550
  },
1257
1551
  "md": {
1258
1552
  "$type": "dimension",
1259
- "$description": "Fixed size. 20px. Icon small.",
1553
+ "$description": "Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls.",
1260
1554
  "$extensions": {
1261
1555
  "com.blip.figma": {
1262
1556
  "variableId": "VariableID:10:41",
@@ -1274,7 +1568,7 @@
1274
1568
  },
1275
1569
  "sm": {
1276
1570
  "$type": "dimension",
1277
- "$description": "Fixed size. 16px. Icon x-small.",
1571
+ "$description": "Fixed size 16px. Use: x-small icons (uai-icon size x-small), such as the header breadcrumb chevrons.",
1278
1572
  "$extensions": {
1279
1573
  "com.blip.figma": {
1280
1574
  "variableId": "VariableID:10:40",
@@ -1292,7 +1586,7 @@
1292
1586
  },
1293
1587
  "xl": {
1294
1588
  "$type": "dimension",
1295
- "$description": "Fixed size. 32px. Small avatars.",
1589
+ "$description": "Fixed size 32px. Use: extra-small avatar, the radio hover halo and datepicker day cells. Avoid: control heights; use control-height/short.",
1296
1590
  "$extensions": {
1297
1591
  "com.blip.figma": {
1298
1592
  "variableId": "VariableID:10:43",
@@ -1310,7 +1604,7 @@
1310
1604
  },
1311
1605
  "xs": {
1312
1606
  "$type": "dimension",
1313
- "$description": "Fixed size. 12px. Status dots, tiny indicators.",
1607
+ "$description": "Fixed size 12px. Use: status dots, tiny indicators and the selected radio dot. Avoid: padding and gaps; use spacing/*.",
1314
1608
  "$extensions": {
1315
1609
  "com.blip.figma": {
1316
1610
  "variableId": "VariableID:10:39",
@@ -1330,7 +1624,7 @@
1330
1624
  "spacing": {
1331
1625
  "2xl": {
1332
1626
  "$type": "dimension",
1333
- "$description": "Spacing. 40px.",
1627
+ "$description": "Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium.",
1334
1628
  "$extensions": {
1335
1629
  "com.blip.figma": {
1336
1630
  "variableId": "VariableID:10:33",
@@ -1348,7 +1642,7 @@
1348
1642
  },
1349
1643
  "2xs": {
1350
1644
  "$type": "dimension",
1351
- "$description": "Spacing. 4px.",
1645
+ "$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.",
1352
1646
  "$extensions": {
1353
1647
  "com.blip.figma": {
1354
1648
  "variableId": "VariableID:10:27",
@@ -1366,7 +1660,7 @@
1366
1660
  },
1367
1661
  "3xl": {
1368
1662
  "$type": "dimension",
1369
- "$description": "Spacing. 48px.",
1663
+ "$description": "Spacing 48px. Layout spacing between large page regions.",
1370
1664
  "$extensions": {
1371
1665
  "com.blip.figma": {
1372
1666
  "variableId": "VariableID:10:34",
@@ -1384,7 +1678,7 @@
1384
1678
  },
1385
1679
  "3xs": {
1386
1680
  "$type": "dimension",
1387
- "$description": "Spacing. 2px.",
1681
+ "$description": "Spacing 2px. Hairline gaps and offsets inside small elements, such as the side padding of avatar initials. Avoid: widths and heights; use sizing/*.",
1388
1682
  "$extensions": {
1389
1683
  "com.blip.figma": {
1390
1684
  "variableId": "VariableID:10:26",
@@ -1402,7 +1696,7 @@
1402
1696
  },
1403
1697
  "4xl": {
1404
1698
  "$type": "dimension",
1405
- "$description": "Spacing. 56px.",
1699
+ "$description": "Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large.",
1406
1700
  "$extensions": {
1407
1701
  "com.blip.figma": {
1408
1702
  "variableId": "VariableID:10:35",
@@ -1420,7 +1714,7 @@
1420
1714
  },
1421
1715
  "5xl": {
1422
1716
  "$type": "dimension",
1423
- "$description": "Spacing. 64px.",
1717
+ "$description": "Spacing 64px. Layout spacing for page margins and large regions.",
1424
1718
  "$extensions": {
1425
1719
  "com.blip.figma": {
1426
1720
  "variableId": "VariableID:10:36",
@@ -1438,7 +1732,7 @@
1438
1732
  },
1439
1733
  "6xl": {
1440
1734
  "$type": "dimension",
1441
- "$description": "Spacing. 72px.",
1735
+ "$description": "Spacing 72px. Layout spacing for page margins and large regions. Avoid: the header height, which comes from its content and padding.",
1442
1736
  "$extensions": {
1443
1737
  "com.blip.figma": {
1444
1738
  "variableId": "VariableID:144:634",
@@ -1456,7 +1750,7 @@
1456
1750
  },
1457
1751
  "7xl": {
1458
1752
  "$type": "dimension",
1459
- "$description": "Spacing. 80px.",
1753
+ "$description": "Spacing 80px. Layout spacing for page margins and hero areas.",
1460
1754
  "$extensions": {
1461
1755
  "com.blip.figma": {
1462
1756
  "variableId": "VariableID:10:37",
@@ -1474,7 +1768,7 @@
1474
1768
  },
1475
1769
  "8xl": {
1476
1770
  "$type": "dimension",
1477
- "$description": "Spacing. 88px.",
1771
+ "$description": "Spacing 88px. Layout spacing for page margins and hero areas.",
1478
1772
  "$extensions": {
1479
1773
  "com.blip.figma": {
1480
1774
  "variableId": "VariableID:144:635",
@@ -1492,7 +1786,7 @@
1492
1786
  },
1493
1787
  "9xl": {
1494
1788
  "$type": "dimension",
1495
- "$description": "Spacing. 96px.",
1789
+ "$description": "Spacing 96px. Largest layout spacing, for hero and landing areas.",
1496
1790
  "$extensions": {
1497
1791
  "com.blip.figma": {
1498
1792
  "variableId": "VariableID:10:38",
@@ -1510,7 +1804,7 @@
1510
1804
  },
1511
1805
  "lg": {
1512
1806
  "$type": "dimension",
1513
- "$description": "Spacing. 24px.",
1807
+ "$description": "Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar).",
1514
1808
  "$extensions": {
1515
1809
  "com.blip.figma": {
1516
1810
  "variableId": "VariableID:10:31",
@@ -1528,7 +1822,7 @@
1528
1822
  },
1529
1823
  "md": {
1530
1824
  "$type": "dimension",
1531
- "$description": "Spacing. 16px.",
1825
+ "$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.",
1532
1826
  "$extensions": {
1533
1827
  "com.blip.figma": {
1534
1828
  "variableId": "VariableID:10:30",
@@ -1546,7 +1840,7 @@
1546
1840
  },
1547
1841
  "none": {
1548
1842
  "$type": "dimension",
1549
- "$description": "Spacing. 0px.",
1843
+ "$description": "Spacing 0px. Use: removing gaps or padding explicitly.",
1550
1844
  "$extensions": {
1551
1845
  "com.blip.figma": {
1552
1846
  "variableId": "VariableID:10:25",
@@ -1564,7 +1858,7 @@
1564
1858
  },
1565
1859
  "sm": {
1566
1860
  "$type": "dimension",
1567
- "$description": "Spacing. 12px.",
1861
+ "$description": "Spacing 12px. Horizontal padding of buttons and other controls.",
1568
1862
  "$extensions": {
1569
1863
  "com.blip.figma": {
1570
1864
  "variableId": "VariableID:10:29",
@@ -1582,7 +1876,7 @@
1582
1876
  },
1583
1877
  "xl": {
1584
1878
  "$type": "dimension",
1585
- "$description": "Spacing. 32px.",
1879
+ "$description": "Spacing 32px. Layout spacing between page sections.",
1586
1880
  "$extensions": {
1587
1881
  "com.blip.figma": {
1588
1882
  "variableId": "VariableID:10:32",
@@ -1600,7 +1894,7 @@
1600
1894
  },
1601
1895
  "xs": {
1602
1896
  "$type": "dimension",
1603
- "$description": "Spacing. 8px.",
1897
+ "$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.",
1604
1898
  "$extensions": {
1605
1899
  "com.blip.figma": {
1606
1900
  "variableId": "VariableID:10:28",
@@ -1618,30 +1912,424 @@
1618
1912
  }
1619
1913
  }
1620
1914
  },
1621
- "typography": {
1622
- "body": {
1623
- "base": {
1624
- "font-size": {
1625
- "$type": "dimension",
1626
- "$description": "Body Base — 14px. Default application text.",
1627
- "$extensions": {
1628
- "com.blip.figma": {
1629
- "variableId": "VariableID:2:241",
1630
- "collectionId": "VariableCollectionId:2:220",
1631
- "collection": "Typography",
1632
- "scopes": [
1633
- "FONT_SIZE"
1634
- ]
1635
- }
1636
- },
1637
- "$value": {
1638
- "value": 14,
1639
- "unit": "px"
1640
- }
1641
- },
1642
- "line-height": {
1915
+ "layout": {
1916
+ "breakpoint": {
1917
+ "lg": {
1918
+ "$type": "dimension",
1919
+ "$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.",
1920
+ "$extensions": {
1921
+ "com.blip.figma": {
1922
+ "variableId": "VariableID:255:25",
1923
+ "collectionId": "VariableCollectionId:255:3",
1924
+ "collection": "Layout",
1925
+ "scopes": [
1926
+ "WIDTH_HEIGHT"
1927
+ ]
1928
+ }
1929
+ },
1930
+ "$value": {
1931
+ "value": 1075,
1932
+ "unit": "px"
1933
+ }
1934
+ },
1935
+ "md": {
1936
+ "$type": "dimension",
1937
+ "$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.",
1938
+ "$extensions": {
1939
+ "com.blip.figma": {
1940
+ "variableId": "VariableID:255:24",
1941
+ "collectionId": "VariableCollectionId:255:3",
1942
+ "collection": "Layout",
1943
+ "scopes": [
1944
+ "WIDTH_HEIGHT"
1945
+ ]
1946
+ }
1947
+ },
1948
+ "$value": {
1949
+ "value": 800,
1950
+ "unit": "px"
1951
+ }
1952
+ },
1953
+ "sm": {
1954
+ "$type": "dimension",
1955
+ "$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.",
1956
+ "$extensions": {
1957
+ "com.blip.figma": {
1958
+ "variableId": "VariableID:255:23",
1959
+ "collectionId": "VariableCollectionId:255:3",
1960
+ "collection": "Layout",
1961
+ "scopes": [
1962
+ "WIDTH_HEIGHT"
1963
+ ]
1964
+ }
1965
+ },
1966
+ "$value": {
1967
+ "value": 640,
1968
+ "unit": "px"
1969
+ }
1970
+ },
1971
+ "xs": {
1972
+ "$type": "dimension",
1973
+ "$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.",
1974
+ "$extensions": {
1975
+ "com.blip.figma": {
1976
+ "variableId": "VariableID:255:22",
1977
+ "collectionId": "VariableCollectionId:255:3",
1978
+ "collection": "Layout",
1979
+ "scopes": [
1980
+ "WIDTH_HEIGHT"
1981
+ ]
1982
+ }
1983
+ },
1984
+ "$value": {
1985
+ "value": 450,
1986
+ "unit": "px"
1987
+ }
1988
+ }
1989
+ },
1990
+ "layer": {
1991
+ "content": {
1992
+ "$type": "number",
1993
+ "$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.",
1994
+ "$extensions": {
1995
+ "com.blip.figma": {
1996
+ "variableId": "VariableID:271:25",
1997
+ "collectionId": "VariableCollectionId:255:3",
1998
+ "collection": "Layout",
1999
+ "scopes": []
2000
+ }
2001
+ },
2002
+ "$value": 100
2003
+ },
2004
+ "header": {
2005
+ "$type": "number",
2006
+ "$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.",
2007
+ "$extensions": {
2008
+ "com.blip.figma": {
2009
+ "variableId": "VariableID:271:28",
2010
+ "collectionId": "VariableCollectionId:255:3",
2011
+ "collection": "Layout",
2012
+ "scopes": []
2013
+ }
2014
+ },
2015
+ "$value": 500
2016
+ },
2017
+ "navigation": {
2018
+ "$type": "number",
2019
+ "$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.",
2020
+ "$extensions": {
2021
+ "com.blip.figma": {
2022
+ "variableId": "VariableID:271:27",
2023
+ "collectionId": "VariableCollectionId:255:3",
2024
+ "collection": "Layout",
2025
+ "scopes": []
2026
+ }
2027
+ },
2028
+ "$value": 400
2029
+ },
2030
+ "navigation-overlay": {
2031
+ "$type": "number",
2032
+ "$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.",
2033
+ "$extensions": {
2034
+ "com.blip.figma": {
2035
+ "variableId": "VariableID:271:26",
2036
+ "collectionId": "VariableCollectionId:255:3",
2037
+ "collection": "Layout",
2038
+ "scopes": []
2039
+ }
2040
+ },
2041
+ "$value": 300
2042
+ }
2043
+ },
2044
+ "width": {
2045
+ "content": {
2046
+ "$type": "dimension",
2047
+ "$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.",
2048
+ "$extensions": {
2049
+ "com.blip.figma": {
2050
+ "variableId": "VariableID:271:24",
2051
+ "collectionId": "VariableCollectionId:255:3",
2052
+ "collection": "Layout",
2053
+ "scopes": [
2054
+ "WIDTH_HEIGHT"
2055
+ ]
2056
+ }
2057
+ },
2058
+ "$value": {
2059
+ "value": 1112,
2060
+ "unit": "px"
2061
+ }
2062
+ },
2063
+ "dialog": {
2064
+ "$type": "dimension",
2065
+ "$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.",
2066
+ "$extensions": {
2067
+ "com.blip.figma": {
2068
+ "variableId": "VariableID:271:20",
2069
+ "collectionId": "VariableCollectionId:255:3",
2070
+ "collection": "Layout",
2071
+ "scopes": [
2072
+ "WIDTH_HEIGHT"
2073
+ ]
2074
+ }
2075
+ },
2076
+ "$value": {
2077
+ "value": 424,
2078
+ "unit": "px"
2079
+ }
2080
+ },
2081
+ "menu": {
2082
+ "$type": "dimension",
2083
+ "$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.",
2084
+ "$extensions": {
2085
+ "com.blip.figma": {
2086
+ "variableId": "VariableID:271:17",
2087
+ "collectionId": "VariableCollectionId:255:3",
2088
+ "collection": "Layout",
2089
+ "scopes": [
2090
+ "WIDTH_HEIGHT"
2091
+ ]
2092
+ }
2093
+ },
2094
+ "$value": {
2095
+ "value": 224,
2096
+ "unit": "px"
2097
+ }
2098
+ },
2099
+ "panel": {
2100
+ "$type": "dimension",
2101
+ "$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.",
2102
+ "$extensions": {
2103
+ "com.blip.figma": {
2104
+ "variableId": "VariableID:271:18",
2105
+ "collectionId": "VariableCollectionId:255:3",
2106
+ "collection": "Layout",
2107
+ "scopes": [
2108
+ "WIDTH_HEIGHT"
2109
+ ]
2110
+ }
2111
+ },
2112
+ "$value": {
2113
+ "value": 288,
2114
+ "unit": "px"
2115
+ }
2116
+ },
2117
+ "side-menu": {
2118
+ "$type": "dimension",
2119
+ "$description": "Layout width 288px. Use: Width of the expanded application side menu. Avoid: fixed widths for fields or menus that should follow their content.",
2120
+ "$extensions": {
2121
+ "com.blip.figma": {
2122
+ "variableId": "VariableID:271:22",
2123
+ "collectionId": "VariableCollectionId:255:3",
2124
+ "collection": "Layout",
2125
+ "scopes": [
2126
+ "WIDTH_HEIGHT"
2127
+ ]
2128
+ }
2129
+ },
2130
+ "$value": {
2131
+ "value": 288,
2132
+ "unit": "px"
2133
+ }
2134
+ },
2135
+ "side-menu-collapsed": {
2136
+ "$type": "dimension",
2137
+ "$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.",
2138
+ "$extensions": {
2139
+ "com.blip.figma": {
2140
+ "variableId": "VariableID:271:23",
2141
+ "collectionId": "VariableCollectionId:255:3",
2142
+ "collection": "Layout",
2143
+ "scopes": [
2144
+ "WIDTH_HEIGHT"
2145
+ ]
2146
+ }
2147
+ },
2148
+ "$value": {
2149
+ "value": 80,
2150
+ "unit": "px"
2151
+ }
2152
+ },
2153
+ "sidebar": {
2154
+ "$type": "dimension",
2155
+ "$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.",
2156
+ "$extensions": {
2157
+ "com.blip.figma": {
2158
+ "variableId": "VariableID:271:21",
2159
+ "collectionId": "VariableCollectionId:255:3",
2160
+ "collection": "Layout",
2161
+ "scopes": [
2162
+ "WIDTH_HEIGHT"
2163
+ ]
2164
+ }
2165
+ },
2166
+ "$value": {
2167
+ "value": 470,
2168
+ "unit": "px"
2169
+ }
2170
+ },
2171
+ "tooltip": {
2172
+ "$type": "dimension",
2173
+ "$description": "Layout width 240px. Use: Maximum width of tooltips; longer text wraps. Avoid: fixed widths for fields or menus that should follow their content.",
2174
+ "$extensions": {
2175
+ "com.blip.figma": {
2176
+ "variableId": "VariableID:271:19",
2177
+ "collectionId": "VariableCollectionId:255:3",
2178
+ "collection": "Layout",
2179
+ "scopes": [
2180
+ "WIDTH_HEIGHT"
2181
+ ]
2182
+ }
2183
+ },
2184
+ "$value": {
2185
+ "value": 240,
2186
+ "unit": "px"
2187
+ }
2188
+ }
2189
+ }
2190
+ },
2191
+ "motion": {
2192
+ "duration": {
2193
+ "fast": {
2194
+ "$type": "duration",
2195
+ "$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.",
2196
+ "$extensions": {
2197
+ "com.blip.figma": {
2198
+ "variableId": "VariableID:255:17",
2199
+ "collectionId": "VariableCollectionId:255:2",
2200
+ "collection": "Motion",
2201
+ "scopes": [
2202
+ "ALL_SCOPES"
2203
+ ]
2204
+ }
2205
+ },
2206
+ "$value": {
2207
+ "value": 150,
2208
+ "unit": "ms"
2209
+ }
2210
+ },
2211
+ "instant": {
2212
+ "$type": "duration",
2213
+ "$description": "Motion duration 65ms. Use: feedback that must not delay reading, such as tooltips appearing and hiding. Pair: easing/standard. Respect prefers-reduced-motion.",
2214
+ "$extensions": {
2215
+ "com.blip.figma": {
2216
+ "variableId": "VariableID:255:16",
2217
+ "collectionId": "VariableCollectionId:255:2",
2218
+ "collection": "Motion",
2219
+ "scopes": [
2220
+ "ALL_SCOPES"
2221
+ ]
2222
+ }
2223
+ },
2224
+ "$value": {
2225
+ "value": 65,
2226
+ "unit": "ms"
2227
+ }
2228
+ },
2229
+ "loop": {
2230
+ "$type": "duration",
2231
+ "$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.",
2232
+ "$extensions": {
2233
+ "com.blip.figma": {
2234
+ "variableId": "VariableID:255:19",
2235
+ "collectionId": "VariableCollectionId:255:2",
2236
+ "collection": "Motion",
2237
+ "scopes": [
2238
+ "ALL_SCOPES"
2239
+ ]
2240
+ }
2241
+ },
2242
+ "$value": {
2243
+ "value": 800,
2244
+ "unit": "ms"
2245
+ }
2246
+ },
2247
+ "moderate": {
2248
+ "$type": "duration",
2249
+ "$description": "Motion duration 200ms. Use: overlays entering and leaving, such as dropdowns, listboxes, popovers and toasts. Pair: easing/standard. Respect prefers-reduced-motion.",
2250
+ "$extensions": {
2251
+ "com.blip.figma": {
2252
+ "variableId": "VariableID:255:18",
2253
+ "collectionId": "VariableCollectionId:255:2",
2254
+ "collection": "Motion",
2255
+ "scopes": [
2256
+ "ALL_SCOPES"
2257
+ ]
2258
+ }
2259
+ },
2260
+ "$value": {
2261
+ "value": 200,
2262
+ "unit": "ms"
2263
+ }
2264
+ }
2265
+ },
2266
+ "easing": {
2267
+ "linear": {
2268
+ "$type": "cubicBezier",
2269
+ "$description": "Motion easing, CSS linear. Use: continuous animations at constant speed, such as spinners. Pair: duration/loop. Avoid: state changes; use easing/standard.",
2270
+ "$extensions": {
2271
+ "com.blip.figma": {
2272
+ "variableId": "VariableID:255:21",
2273
+ "collectionId": "VariableCollectionId:255:2",
2274
+ "collection": "Motion",
2275
+ "scopes": [
2276
+ "ALL_SCOPES"
2277
+ ]
2278
+ }
2279
+ },
2280
+ "$value": [
2281
+ 0,
2282
+ 0,
2283
+ 1,
2284
+ 1
2285
+ ]
2286
+ },
2287
+ "standard": {
2288
+ "$type": "cubicBezier",
2289
+ "$description": "Motion easing, CSS ease. Default curve for state changes and overlays. Pair: duration/instant, duration/fast or duration/moderate.",
2290
+ "$extensions": {
2291
+ "com.blip.figma": {
2292
+ "variableId": "VariableID:255:20",
2293
+ "collectionId": "VariableCollectionId:255:2",
2294
+ "collection": "Motion",
2295
+ "scopes": [
2296
+ "ALL_SCOPES"
2297
+ ]
2298
+ }
2299
+ },
2300
+ "$value": [
2301
+ 0.25,
2302
+ 0.1,
2303
+ 0.25,
2304
+ 1
2305
+ ]
2306
+ }
2307
+ }
2308
+ },
2309
+ "typography": {
2310
+ "body": {
2311
+ "base": {
2312
+ "font-size": {
2313
+ "$type": "dimension",
2314
+ "$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.",
2315
+ "$extensions": {
2316
+ "com.blip.figma": {
2317
+ "variableId": "VariableID:2:241",
2318
+ "collectionId": "VariableCollectionId:2:220",
2319
+ "collection": "Typography",
2320
+ "scopes": [
2321
+ "FONT_SIZE"
2322
+ ]
2323
+ }
2324
+ },
2325
+ "$value": {
2326
+ "value": 14,
2327
+ "unit": "px"
2328
+ }
2329
+ },
2330
+ "line-height": {
1643
2331
  "$type": "dimension",
1644
- "$description": "Body Base — 22px.",
2332
+ "$description": "Body Base line height: 22px. Pair: body/base/font-size (14px).",
1645
2333
  "$extensions": {
1646
2334
  "com.blip.figma": {
1647
2335
  "variableId": "VariableID:2:242",
@@ -1657,12 +2345,88 @@
1657
2345
  "unit": "px"
1658
2346
  }
1659
2347
  }
2348
+ },
2349
+ "lg": {
2350
+ "font-size": {
2351
+ "$type": "dimension",
2352
+ "$description": "Body Large — 16px. Lead text and large body copy.",
2353
+ "$extensions": {
2354
+ "com.blip.figma": {
2355
+ "variableId": "VariableID:296:9",
2356
+ "collectionId": "VariableCollectionId:2:220",
2357
+ "collection": "Typography",
2358
+ "scopes": [
2359
+ "FONT_SIZE"
2360
+ ]
2361
+ }
2362
+ },
2363
+ "$value": {
2364
+ "value": 16,
2365
+ "unit": "px"
2366
+ }
2367
+ },
2368
+ "line-height": {
2369
+ "$type": "dimension",
2370
+ "$description": "Body Large — 24px line height.",
2371
+ "$extensions": {
2372
+ "com.blip.figma": {
2373
+ "variableId": "VariableID:296:10",
2374
+ "collectionId": "VariableCollectionId:2:220",
2375
+ "collection": "Typography",
2376
+ "scopes": [
2377
+ "LINE_HEIGHT"
2378
+ ]
2379
+ }
2380
+ },
2381
+ "$value": {
2382
+ "value": 24,
2383
+ "unit": "px"
2384
+ }
2385
+ }
2386
+ },
2387
+ "sm": {
2388
+ "font-size": {
2389
+ "$type": "dimension",
2390
+ "$description": "Body Small — 12px. Compact secondary text.",
2391
+ "$extensions": {
2392
+ "com.blip.figma": {
2393
+ "variableId": "VariableID:296:11",
2394
+ "collectionId": "VariableCollectionId:2:220",
2395
+ "collection": "Typography",
2396
+ "scopes": [
2397
+ "FONT_SIZE"
2398
+ ]
2399
+ }
2400
+ },
2401
+ "$value": {
2402
+ "value": 12,
2403
+ "unit": "px"
2404
+ }
2405
+ },
2406
+ "line-height": {
2407
+ "$type": "dimension",
2408
+ "$description": "Body Small — 20px line height.",
2409
+ "$extensions": {
2410
+ "com.blip.figma": {
2411
+ "variableId": "VariableID:296:12",
2412
+ "collectionId": "VariableCollectionId:2:220",
2413
+ "collection": "Typography",
2414
+ "scopes": [
2415
+ "LINE_HEIGHT"
2416
+ ]
2417
+ }
2418
+ },
2419
+ "$value": {
2420
+ "value": 20,
2421
+ "unit": "px"
2422
+ }
2423
+ }
1660
2424
  }
1661
2425
  },
1662
2426
  "caption": {
1663
2427
  "font-size": {
1664
2428
  "$type": "dimension",
1665
- "$description": "Caption — 12px. Helpers, badges, small body text.",
2429
+ "$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.",
1666
2430
  "$extensions": {
1667
2431
  "com.blip.figma": {
1668
2432
  "variableId": "VariableID:2:247",
@@ -1680,7 +2444,7 @@
1680
2444
  },
1681
2445
  "line-height": {
1682
2446
  "$type": "dimension",
1683
- "$description": "Caption — 20px.",
2447
+ "$description": "Caption line height: 20px. Pair: caption/font-size (12px).",
1684
2448
  "$extensions": {
1685
2449
  "com.blip.figma": {
1686
2450
  "variableId": "VariableID:2:248",
@@ -1700,7 +2464,7 @@
1700
2464
  "display": {
1701
2465
  "font-size": {
1702
2466
  "$type": "dimension",
1703
- "$description": "Display — 40px. Hero, landing pages.",
2467
+ "$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.",
1704
2468
  "$extensions": {
1705
2469
  "com.blip.figma": {
1706
2470
  "variableId": "VariableID:2:223",
@@ -1718,7 +2482,7 @@
1718
2482
  },
1719
2483
  "line-height": {
1720
2484
  "$type": "dimension",
1721
- "$description": "Display — 48px.",
2485
+ "$description": "Display line height: 48px. Pair: display/font-size (40px). Use only with display text.",
1722
2486
  "$extensions": {
1723
2487
  "com.blip.figma": {
1724
2488
  "variableId": "VariableID:2:224",
@@ -1738,7 +2502,7 @@
1738
2502
  "font-family": {
1739
2503
  "display": {
1740
2504
  "$type": "fontFamily",
1741
- "$description": "Display font for hero and marketing titles. Figtree today; may diverge per product.",
2505
+ "$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.",
1742
2506
  "$extensions": {
1743
2507
  "com.blip.figma": {
1744
2508
  "variableId": "VariableID:2:222",
@@ -1753,7 +2517,7 @@
1753
2517
  },
1754
2518
  "sans": {
1755
2519
  "$type": "fontFamily",
1756
- "$description": "Primary font for all interface text. Figtree.",
2520
+ "$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.",
1757
2521
  "$extensions": {
1758
2522
  "com.blip.figma": {
1759
2523
  "variableId": "VariableID:2:221",
@@ -1770,7 +2534,7 @@
1770
2534
  "font-weight": {
1771
2535
  "bold": {
1772
2536
  "$type": "fontWeight",
1773
- "$description": "Bold weight (700). Titles, strong emphasis.",
2537
+ "$description": "Font weight 700. Strong emphasis in titles and short inline text. Avoid: long passages and whole paragraphs.",
1774
2538
  "$extensions": {
1775
2539
  "com.blip.figma": {
1776
2540
  "variableId": "VariableID:2:257",
@@ -1785,7 +2549,7 @@
1785
2549
  },
1786
2550
  "extrabold": {
1787
2551
  "$type": "fontWeight",
1788
- "$description": "ExtraBold weight (800). Hero emphasis; maps to blip-ds bold="extra-bold".",
2552
+ "$description": "Font weight 800. Hero emphasis only; equivalent to blip-ds bold='extra-bold'. Avoid: regular interface text.",
1789
2553
  "$extensions": {
1790
2554
  "com.blip.figma": {
1791
2555
  "variableId": "VariableID:2:258",
@@ -1800,7 +2564,7 @@
1800
2564
  },
1801
2565
  "medium": {
1802
2566
  "$type": "fontWeight",
1803
- "$description": "Medium weight (500). Labels, buttons.",
2567
+ "$description": "Font weight 500. Light emphasis: button labels, avatar initials and active navigation items.",
1804
2568
  "$extensions": {
1805
2569
  "com.blip.figma": {
1806
2570
  "variableId": "VariableID:2:255",
@@ -1815,7 +2579,7 @@
1815
2579
  },
1816
2580
  "regular": {
1817
2581
  "$type": "fontWeight",
1818
- "$description": "Regular weight (400). Default body text.",
2582
+ "$description": "Font weight 400. Default for body text, input values and helper, error and success messages.",
1819
2583
  "$extensions": {
1820
2584
  "com.blip.figma": {
1821
2585
  "variableId": "VariableID:2:254",
@@ -1830,7 +2594,7 @@
1830
2594
  },
1831
2595
  "semibold": {
1832
2596
  "$type": "fontWeight",
1833
- "$description": "SemiBold weight (600). Subtitles, navigation.",
2597
+ "$description": "Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles.",
1834
2598
  "$extensions": {
1835
2599
  "com.blip.figma": {
1836
2600
  "variableId": "VariableID:2:256",
@@ -1848,7 +2612,7 @@
1848
2612
  "lg": {
1849
2613
  "font-size": {
1850
2614
  "$type": "dimension",
1851
- "$description": "Heading LG — 24px. Content sections.",
2615
+ "$description": "Heading LG font size: 24px. Use: titles of content sections within a page. Pair: heading/lg/line-height (32px).",
1852
2616
  "$extensions": {
1853
2617
  "com.blip.figma": {
1854
2618
  "variableId": "VariableID:2:229",
@@ -1866,7 +2630,7 @@
1866
2630
  },
1867
2631
  "line-height": {
1868
2632
  "$type": "dimension",
1869
- "$description": "Heading LG — 32px.",
2633
+ "$description": "Heading LG line height: 32px. Pair: heading/lg/font-size (24px).",
1870
2634
  "$extensions": {
1871
2635
  "com.blip.figma": {
1872
2636
  "variableId": "VariableID:2:230",
@@ -1886,7 +2650,7 @@
1886
2650
  "md": {
1887
2651
  "font-size": {
1888
2652
  "$type": "dimension",
1889
- "$description": "Heading MD — 20px. Subsections.",
2653
+ "$description": "Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px).",
1890
2654
  "$extensions": {
1891
2655
  "com.blip.figma": {
1892
2656
  "variableId": "VariableID:2:232",
@@ -1904,7 +2668,7 @@
1904
2668
  },
1905
2669
  "line-height": {
1906
2670
  "$type": "dimension",
1907
- "$description": "Heading MD — 28px.",
2671
+ "$description": "Heading MD line height: 28px. Pair: heading/md/font-size (20px).",
1908
2672
  "$extensions": {
1909
2673
  "com.blip.figma": {
1910
2674
  "variableId": "VariableID:2:233",
@@ -1924,7 +2688,7 @@
1924
2688
  "xl": {
1925
2689
  "font-size": {
1926
2690
  "$type": "dimension",
1927
- "$description": "Heading XL — 32px. Main page title.",
2691
+ "$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.",
1928
2692
  "$extensions": {
1929
2693
  "com.blip.figma": {
1930
2694
  "variableId": "VariableID:2:226",
@@ -1942,7 +2706,7 @@
1942
2706
  },
1943
2707
  "line-height": {
1944
2708
  "$type": "dimension",
1945
- "$description": "Heading XL — 40px.",
2709
+ "$description": "Heading XL line height: 40px. Pair: heading/xl/font-size (32px).",
1946
2710
  "$extensions": {
1947
2711
  "com.blip.figma": {
1948
2712
  "variableId": "VariableID:2:227",
@@ -1963,7 +2727,7 @@
1963
2727
  "letter-spacing": {
1964
2728
  "expanded": {
1965
2729
  "$type": "dimension",
1966
- "$description": "Expanded letter spacing (0.2em). Spaced body variant.",
2730
+ "$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.",
1967
2731
  "$extensions": {
1968
2732
  "com.blip.figma": {
1969
2733
  "variableId": "VariableID:2:261",
@@ -1981,7 +2745,7 @@
1981
2745
  },
1982
2746
  "normal": {
1983
2747
  "$type": "dimension",
1984
- "$description": "Default letter spacing for all text styles.",
2748
+ "$description": "Letter spacing 0px. Default tracking for every text role. Use unless a text style explicitly asks for expanded tracking.",
1985
2749
  "$extensions": {
1986
2750
  "com.blip.figma": {
1987
2751
  "variableId": "VariableID:2:260",
@@ -2001,7 +2765,7 @@
2001
2765
  "overline": {
2002
2766
  "font-size": {
2003
2767
  "$type": "dimension",
2004
- "$description": "Overline — 10px. Tags, restricted use.",
2768
+ "$description": "Overline font size: 10px. Restricted use: tags and small category labels. Pair: overline/line-height (16px). Avoid: body copy or any essential information.",
2005
2769
  "$extensions": {
2006
2770
  "com.blip.figma": {
2007
2771
  "variableId": "VariableID:2:250",
@@ -2019,7 +2783,7 @@
2019
2783
  },
2020
2784
  "line-height": {
2021
2785
  "$type": "dimension",
2022
- "$description": "Overline — 16px.",
2786
+ "$description": "Overline line height: 16px. Pair: overline/font-size (10px).",
2023
2787
  "$extensions": {
2024
2788
  "com.blip.figma": {
2025
2789
  "variableId": "VariableID:2:251",
@@ -2039,7 +2803,7 @@
2039
2803
  "title": {
2040
2804
  "font-size": {
2041
2805
  "$type": "dimension",
2042
- "$description": "Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text.",
2806
+ "$description": "Title compatibility alias for title/md — 16px.",
2043
2807
  "$extensions": {
2044
2808
  "com.blip.figma": {
2045
2809
  "variableId": "VariableID:2:235",
@@ -2055,9 +2819,47 @@
2055
2819
  "unit": "px"
2056
2820
  }
2057
2821
  },
2822
+ "lg": {
2823
+ "font-size": {
2824
+ "$type": "dimension",
2825
+ "$description": "Title Large — 18px. Primary page titles.",
2826
+ "$extensions": {
2827
+ "com.blip.figma": {
2828
+ "variableId": "VariableID:296:3",
2829
+ "collectionId": "VariableCollectionId:2:220",
2830
+ "collection": "Typography",
2831
+ "scopes": [
2832
+ "FONT_SIZE"
2833
+ ]
2834
+ }
2835
+ },
2836
+ "$value": {
2837
+ "value": 18,
2838
+ "unit": "px"
2839
+ }
2840
+ },
2841
+ "line-height": {
2842
+ "$type": "dimension",
2843
+ "$description": "Title Large — 24px line height.",
2844
+ "$extensions": {
2845
+ "com.blip.figma": {
2846
+ "variableId": "VariableID:296:4",
2847
+ "collectionId": "VariableCollectionId:2:220",
2848
+ "collection": "Typography",
2849
+ "scopes": [
2850
+ "LINE_HEIGHT"
2851
+ ]
2852
+ }
2853
+ },
2854
+ "$value": {
2855
+ "value": 24,
2856
+ "unit": "px"
2857
+ }
2858
+ }
2859
+ },
2058
2860
  "line-height": {
2059
2861
  "$type": "dimension",
2060
- "$description": "Title — 24px.",
2862
+ "$description": "Title compatibility alias for title/md — 24px.",
2061
2863
  "$extensions": {
2062
2864
  "com.blip.figma": {
2063
2865
  "variableId": "VariableID:2:236",
@@ -2072,6 +2874,82 @@
2072
2874
  "value": 24,
2073
2875
  "unit": "px"
2074
2876
  }
2877
+ },
2878
+ "md": {
2879
+ "font-size": {
2880
+ "$type": "dimension",
2881
+ "$description": "Title Medium — 16px. Card titles, strong labels, navigation.",
2882
+ "$extensions": {
2883
+ "com.blip.figma": {
2884
+ "variableId": "VariableID:296:5",
2885
+ "collectionId": "VariableCollectionId:2:220",
2886
+ "collection": "Typography",
2887
+ "scopes": [
2888
+ "FONT_SIZE"
2889
+ ]
2890
+ }
2891
+ },
2892
+ "$value": {
2893
+ "value": 16,
2894
+ "unit": "px"
2895
+ }
2896
+ },
2897
+ "line-height": {
2898
+ "$type": "dimension",
2899
+ "$description": "Title Medium — 24px line height.",
2900
+ "$extensions": {
2901
+ "com.blip.figma": {
2902
+ "variableId": "VariableID:296:6",
2903
+ "collectionId": "VariableCollectionId:2:220",
2904
+ "collection": "Typography",
2905
+ "scopes": [
2906
+ "LINE_HEIGHT"
2907
+ ]
2908
+ }
2909
+ },
2910
+ "$value": {
2911
+ "value": 24,
2912
+ "unit": "px"
2913
+ }
2914
+ }
2915
+ },
2916
+ "sm": {
2917
+ "font-size": {
2918
+ "$type": "dimension",
2919
+ "$description": "Title Small — 14px. Compact titles and labels.",
2920
+ "$extensions": {
2921
+ "com.blip.figma": {
2922
+ "variableId": "VariableID:296:7",
2923
+ "collectionId": "VariableCollectionId:2:220",
2924
+ "collection": "Typography",
2925
+ "scopes": [
2926
+ "FONT_SIZE"
2927
+ ]
2928
+ }
2929
+ },
2930
+ "$value": {
2931
+ "value": 14,
2932
+ "unit": "px"
2933
+ }
2934
+ },
2935
+ "line-height": {
2936
+ "$type": "dimension",
2937
+ "$description": "Title Small — 20px line height.",
2938
+ "$extensions": {
2939
+ "com.blip.figma": {
2940
+ "variableId": "VariableID:296:8",
2941
+ "collectionId": "VariableCollectionId:2:220",
2942
+ "collection": "Typography",
2943
+ "scopes": [
2944
+ "LINE_HEIGHT"
2945
+ ]
2946
+ }
2947
+ },
2948
+ "$value": {
2949
+ "value": 20,
2950
+ "unit": "px"
2951
+ }
2952
+ }
2075
2953
  }
2076
2954
  }
2077
2955
  }