blip-tokens 2.3.0 → 2.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/build/tokens.js CHANGED
@@ -1,4 +1,7 @@
1
1
  export const light = {
2
+ "uai-accent-ai-end": "#00c6d7",
3
+ "uai-accent-ai-middle": "#a855f7",
4
+ "uai-accent-ai-start": "#0099ff",
2
5
  "uai-action-destructive": "#cf0022",
3
6
  "uai-action-destructive-foreground": "#ffffff",
4
7
  "uai-action-outline-default": "#ffffff",
@@ -35,6 +38,7 @@ export const light = {
35
38
  "uai-overlay-hover": "rgba(0, 0, 0, 0.08)",
36
39
  "uai-overlay-insight": "rgba(255, 255, 255, 0.9)",
37
40
  "uai-overlay-pressed": "rgba(0, 0, 0, 0.16)",
41
+ "uai-overlay-selected": "rgba(0, 0, 0, 0.06)",
38
42
  "uai-surface-background": "#f2f3f3",
39
43
  "uai-surface-contrast": "#e4e6e7",
40
44
  "uai-surface-inverse": "#242729",
@@ -43,6 +47,11 @@ export const light = {
43
47
  "uai-border-width-default": "1px",
44
48
  "uai-border-width-none": "0px",
45
49
  "uai-border-width-thick": "2px",
50
+ "uai-control-height-compact": "1.5rem",
51
+ "uai-control-height-large": "3.5rem",
52
+ "uai-control-height-medium": "2.5rem",
53
+ "uai-control-height-short": "2rem",
54
+ "uai-opacity-disabled": 0.5,
46
55
  "uai-opacity-focus-ring": 0.3,
47
56
  "uai-radius-2xl": "1.5rem",
48
57
  "uai-radius-full": "624.9375rem",
@@ -53,8 +62,10 @@ export const light = {
53
62
  "uai-radius-xl": "1rem",
54
63
  "uai-radius-xs": "0.125rem",
55
64
  "uai-sizing-2xl": "2.5rem",
65
+ "uai-sizing-2xs": "0.5rem",
56
66
  "uai-sizing-3xl": "3rem",
57
67
  "uai-sizing-4xl": "4rem",
68
+ "uai-sizing-5xl": "4.5rem",
58
69
  "uai-sizing-lg": "1.5rem",
59
70
  "uai-sizing-md": "1.25rem",
60
71
  "uai-sizing-sm": "1rem",
@@ -76,8 +87,34 @@ export const light = {
76
87
  "uai-spacing-sm": "0.75rem",
77
88
  "uai-spacing-xl": "2rem",
78
89
  "uai-spacing-xs": "0.5rem",
90
+ "uai-breakpoint-lg": "67.1875rem",
91
+ "uai-breakpoint-md": "50rem",
92
+ "uai-breakpoint-sm": "40rem",
93
+ "uai-breakpoint-xs": "28.125rem",
94
+ "uai-layer-content": 100,
95
+ "uai-layer-header": 500,
96
+ "uai-layer-navigation": 400,
97
+ "uai-layer-navigation-overlay": 300,
98
+ "uai-width-content": "69.5rem",
99
+ "uai-width-dialog": "26.5rem",
100
+ "uai-width-menu": "14rem",
101
+ "uai-width-panel": "18rem",
102
+ "uai-width-side-menu": "18rem",
103
+ "uai-width-side-menu-collapsed": "5rem",
104
+ "uai-width-sidebar": "29.375rem",
105
+ "uai-width-tooltip": "15rem",
106
+ "uai-duration-fast": "150ms",
107
+ "uai-duration-instant": "65ms",
108
+ "uai-duration-loop": "800ms",
109
+ "uai-duration-moderate": "200ms",
110
+ "uai-easing-linear": "cubic-bezier(0, 0, 1, 1)",
111
+ "uai-easing-standard": "cubic-bezier(0.25, 0.1, 0.25, 1)",
79
112
  "uai-body-base-font-size": "0.875rem",
80
113
  "uai-body-base-line-height": "1.375rem",
114
+ "uai-body-lg-font-size": "1rem",
115
+ "uai-body-lg-line-height": "1.5rem",
116
+ "uai-body-sm-font-size": "0.75rem",
117
+ "uai-body-sm-line-height": "1.25rem",
81
118
  "uai-caption-font-size": "0.75rem",
82
119
  "uai-caption-line-height": "1.25rem",
83
120
  "uai-display-font-size": "2.5rem",
@@ -100,9 +137,18 @@ export const light = {
100
137
  "uai-overline-font-size": "0.625rem",
101
138
  "uai-overline-line-height": "1rem",
102
139
  "uai-title-font-size": "1rem",
103
- "uai-title-line-height": "1.5rem"
140
+ "uai-title-lg-font-size": "1.125rem",
141
+ "uai-title-lg-line-height": "1.5rem",
142
+ "uai-title-line-height": "1.5rem",
143
+ "uai-title-md-font-size": "1rem",
144
+ "uai-title-md-line-height": "1.5rem",
145
+ "uai-title-sm-font-size": "0.875rem",
146
+ "uai-title-sm-line-height": "1.25rem"
104
147
  };
105
148
  export const dark = {
149
+ "uai-accent-ai-end": "#00c6d7",
150
+ "uai-accent-ai-middle": "#a855f7",
151
+ "uai-accent-ai-start": "#0099ff",
106
152
  "uai-action-destructive": "#fca5a5",
107
153
  "uai-action-destructive-foreground": "#181a1b",
108
154
  "uai-action-outline-default": "#242729",
@@ -139,6 +185,7 @@ export const dark = {
139
185
  "uai-overlay-hover": "rgba(255, 255, 255, 0.08)",
140
186
  "uai-overlay-insight": "rgba(0, 0, 0, 0.8)",
141
187
  "uai-overlay-pressed": "rgba(255, 255, 255, 0.16)",
188
+ "uai-overlay-selected": "rgba(255, 255, 255, 0.06)",
142
189
  "uai-surface-background": "#181a1b",
143
190
  "uai-surface-contrast": "#2f3437",
144
191
  "uai-surface-inverse": "#f2f3f3",
@@ -147,6 +194,11 @@ export const dark = {
147
194
  "uai-border-width-default": "1px",
148
195
  "uai-border-width-none": "0px",
149
196
  "uai-border-width-thick": "2px",
197
+ "uai-control-height-compact": "1.5rem",
198
+ "uai-control-height-large": "3.5rem",
199
+ "uai-control-height-medium": "2.5rem",
200
+ "uai-control-height-short": "2rem",
201
+ "uai-opacity-disabled": 0.5,
150
202
  "uai-opacity-focus-ring": 0.3,
151
203
  "uai-radius-2xl": "1.5rem",
152
204
  "uai-radius-full": "624.9375rem",
@@ -157,8 +209,10 @@ export const dark = {
157
209
  "uai-radius-xl": "1rem",
158
210
  "uai-radius-xs": "0.125rem",
159
211
  "uai-sizing-2xl": "2.5rem",
212
+ "uai-sizing-2xs": "0.5rem",
160
213
  "uai-sizing-3xl": "3rem",
161
214
  "uai-sizing-4xl": "4rem",
215
+ "uai-sizing-5xl": "4.5rem",
162
216
  "uai-sizing-lg": "1.5rem",
163
217
  "uai-sizing-md": "1.25rem",
164
218
  "uai-sizing-sm": "1rem",
@@ -180,8 +234,34 @@ export const dark = {
180
234
  "uai-spacing-sm": "0.75rem",
181
235
  "uai-spacing-xl": "2rem",
182
236
  "uai-spacing-xs": "0.5rem",
237
+ "uai-breakpoint-lg": "67.1875rem",
238
+ "uai-breakpoint-md": "50rem",
239
+ "uai-breakpoint-sm": "40rem",
240
+ "uai-breakpoint-xs": "28.125rem",
241
+ "uai-layer-content": 100,
242
+ "uai-layer-header": 500,
243
+ "uai-layer-navigation": 400,
244
+ "uai-layer-navigation-overlay": 300,
245
+ "uai-width-content": "69.5rem",
246
+ "uai-width-dialog": "26.5rem",
247
+ "uai-width-menu": "14rem",
248
+ "uai-width-panel": "18rem",
249
+ "uai-width-side-menu": "18rem",
250
+ "uai-width-side-menu-collapsed": "5rem",
251
+ "uai-width-sidebar": "29.375rem",
252
+ "uai-width-tooltip": "15rem",
253
+ "uai-duration-fast": "150ms",
254
+ "uai-duration-instant": "65ms",
255
+ "uai-duration-loop": "800ms",
256
+ "uai-duration-moderate": "200ms",
257
+ "uai-easing-linear": "cubic-bezier(0, 0, 1, 1)",
258
+ "uai-easing-standard": "cubic-bezier(0.25, 0.1, 0.25, 1)",
183
259
  "uai-body-base-font-size": "0.875rem",
184
260
  "uai-body-base-line-height": "1.375rem",
261
+ "uai-body-lg-font-size": "1rem",
262
+ "uai-body-lg-line-height": "1.5rem",
263
+ "uai-body-sm-font-size": "0.75rem",
264
+ "uai-body-sm-line-height": "1.25rem",
185
265
  "uai-caption-font-size": "0.75rem",
186
266
  "uai-caption-line-height": "1.25rem",
187
267
  "uai-display-font-size": "2.5rem",
@@ -204,7 +284,13 @@ export const dark = {
204
284
  "uai-overline-font-size": "0.625rem",
205
285
  "uai-overline-line-height": "1rem",
206
286
  "uai-title-font-size": "1rem",
207
- "uai-title-line-height": "1.5rem"
287
+ "uai-title-lg-font-size": "1.125rem",
288
+ "uai-title-lg-line-height": "1.5rem",
289
+ "uai-title-line-height": "1.5rem",
290
+ "uai-title-md-font-size": "1rem",
291
+ "uai-title-md-line-height": "1.5rem",
292
+ "uai-title-sm-font-size": "0.875rem",
293
+ "uai-title-sm-line-height": "1.25rem"
208
294
  };
209
295
  export const shadows = {
210
296
  "uai-elevation-1": {
@@ -727,8 +813,41 @@ export const textStyles = {
727
813
  }
728
814
  };
729
815
  export const metadata = {
816
+ "uai-accent-ai-end": {
817
+ "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.",
818
+ "type": "color",
819
+ "collection": "Colors",
820
+ "scopes": [
821
+ "FRAME_FILL",
822
+ "SHAPE_FILL",
823
+ "STROKE_COLOR"
824
+ ],
825
+ "figmaVariableId": "VariableID:271:32"
826
+ },
827
+ "uai-accent-ai-middle": {
828
+ "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.",
829
+ "type": "color",
830
+ "collection": "Colors",
831
+ "scopes": [
832
+ "FRAME_FILL",
833
+ "SHAPE_FILL",
834
+ "STROKE_COLOR"
835
+ ],
836
+ "figmaVariableId": "VariableID:271:31"
837
+ },
838
+ "uai-accent-ai-start": {
839
+ "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.",
840
+ "type": "color",
841
+ "collection": "Colors",
842
+ "scopes": [
843
+ "FRAME_FILL",
844
+ "SHAPE_FILL",
845
+ "STROKE_COLOR"
846
+ ],
847
+ "figmaVariableId": "VariableID:271:30"
848
+ },
730
849
  "uai-action-destructive": {
731
- "description": "Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces.",
850
+ "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.",
732
851
  "type": "color",
733
852
  "collection": "Colors",
734
853
  "scopes": [
@@ -740,7 +859,7 @@ export const metadata = {
740
859
  "figmaVariableId": "VariableID:2:290"
741
860
  },
742
861
  "uai-action-destructive-foreground": {
743
- "description": "Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright.",
862
+ "description": "Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright.",
744
863
  "type": "color",
745
864
  "collection": "Colors",
746
865
  "scopes": [
@@ -751,7 +870,7 @@ export const metadata = {
751
870
  "figmaVariableId": "VariableID:2:291"
752
871
  },
753
872
  "uai-action-outline-default": {
754
- "description": "Outline and text button background — default state.",
873
+ "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.",
755
874
  "type": "color",
756
875
  "collection": "Colors",
757
876
  "scopes": [
@@ -761,7 +880,7 @@ export const metadata = {
761
880
  "figmaVariableId": "VariableID:2:287"
762
881
  },
763
882
  "uai-action-outline-hover": {
764
- "description": "Outline and text button background — hover state. Also list item hover.",
883
+ "description": "Theme-aware hover background of outline and text actions. Also the hover background of list and menu items.",
765
884
  "type": "color",
766
885
  "collection": "Colors",
767
886
  "scopes": [
@@ -771,7 +890,7 @@ export const metadata = {
771
890
  "figmaVariableId": "VariableID:2:288"
772
891
  },
773
892
  "uai-action-outline-pressed": {
774
- "description": "Outline and text button background — pressed state. Also selected list item.",
893
+ "description": "Theme-aware pressed background of outline and text actions. Also the background of the selected list or menu item.",
775
894
  "type": "color",
776
895
  "collection": "Colors",
777
896
  "scopes": [
@@ -781,7 +900,7 @@ export const metadata = {
781
900
  "figmaVariableId": "VariableID:2:289"
782
901
  },
783
902
  "uai-action-positive": {
784
- "description": "Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead.",
903
+ "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.",
785
904
  "type": "color",
786
905
  "collection": "Colors",
787
906
  "scopes": [
@@ -792,7 +911,7 @@ export const metadata = {
792
911
  "figmaVariableId": "VariableID:202:2"
793
912
  },
794
913
  "uai-action-positive-foreground": {
795
- "description": "Text and icons on action/positive. Theme-aware foreground for filled positive buttons.",
914
+ "description": "Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark.",
796
915
  "type": "color",
797
916
  "collection": "Colors",
798
917
  "scopes": [
@@ -802,7 +921,7 @@ export const metadata = {
802
921
  "figmaVariableId": "VariableID:202:3"
803
922
  },
804
923
  "uai-action-primary-default": {
805
- "description": "Primary button background — default state.",
924
+ "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.",
806
925
  "type": "color",
807
926
  "collection": "Colors",
808
927
  "scopes": [
@@ -812,7 +931,7 @@ export const metadata = {
812
931
  "figmaVariableId": "VariableID:2:283"
813
932
  },
814
933
  "uai-action-primary-foreground": {
815
- "description": "Text and icons on primary buttons.",
934
+ "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.",
816
935
  "type": "color",
817
936
  "collection": "Colors",
818
937
  "scopes": [
@@ -823,7 +942,7 @@ export const metadata = {
823
942
  "figmaVariableId": "VariableID:2:286"
824
943
  },
825
944
  "uai-action-primary-hover": {
826
- "description": "Primary button background — hover state.",
945
+ "description": "Theme-aware background of primary actions on hover. Use only as the hover state of action/primary/default. Pair: action/primary/foreground.",
827
946
  "type": "color",
828
947
  "collection": "Colors",
829
948
  "scopes": [
@@ -833,7 +952,7 @@ export const metadata = {
833
952
  "figmaVariableId": "VariableID:2:284"
834
953
  },
835
954
  "uai-action-primary-pressed": {
836
- "description": "Primary button background — pressed state.",
955
+ "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.",
837
956
  "type": "color",
838
957
  "collection": "Colors",
839
958
  "scopes": [
@@ -843,7 +962,7 @@ export const metadata = {
843
962
  "figmaVariableId": "VariableID:2:285"
844
963
  },
845
964
  "uai-border-default": {
846
- "description": "Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring.",
965
+ "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.",
847
966
  "type": "color",
848
967
  "collection": "Colors",
849
968
  "scopes": [
@@ -852,7 +971,7 @@ export const metadata = {
852
971
  "figmaVariableId": "VariableID:2:296"
853
972
  },
854
973
  "uai-border-input": {
855
- "description": "Essential form control boundary. Dark mode meets 3:1 on background, paper, contrast, muted and outline pressed surfaces. Do not use border/default as the only control boundary.",
974
+ "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.",
856
975
  "type": "color",
857
976
  "collection": "Colors",
858
977
  "scopes": [
@@ -861,7 +980,7 @@ export const metadata = {
861
980
  "figmaVariableId": "VariableID:2:297"
862
981
  },
863
982
  "uai-border-ring": {
864
- "description": "Solid neutral focus indicator, dark in Light and light in Dark. Use at full opacity. Inputs may add a separate outer halo with opacity/focus-ring, while keeping the solid focus border. Never reduce the opacity of the whole control.",
983
+ "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.",
865
984
  "type": "color",
866
985
  "collection": "Colors",
867
986
  "scopes": [
@@ -870,7 +989,7 @@ export const metadata = {
870
989
  "figmaVariableId": "VariableID:2:298"
871
990
  },
872
991
  "uai-content-disabled": {
873
- "description": "Disabled text and icons.",
992
+ "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.",
874
993
  "type": "color",
875
994
  "collection": "Colors",
876
995
  "scopes": [
@@ -881,7 +1000,7 @@ export const metadata = {
881
1000
  "figmaVariableId": "VariableID:2:279"
882
1001
  },
883
1002
  "uai-content-inverse": {
884
- "description": "Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary.",
1003
+ "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.",
885
1004
  "type": "color",
886
1005
  "collection": "Colors",
887
1006
  "scopes": [
@@ -892,7 +1011,7 @@ export const metadata = {
892
1011
  "figmaVariableId": "VariableID:144:636"
893
1012
  },
894
1013
  "uai-content-link": {
895
- "description": "Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text.",
1014
+ "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.",
896
1015
  "type": "color",
897
1016
  "collection": "Colors",
898
1017
  "scopes": [
@@ -903,7 +1022,7 @@ export const metadata = {
903
1022
  "figmaVariableId": "VariableID:2:280"
904
1023
  },
905
1024
  "uai-content-placeholder": {
906
- "description": "Input placeholder and hint text on standard surfaces. Not for disabled content. Dark mode meets 4.5:1 on background, paper, contrast, muted and outline pressed surfaces.",
1025
+ "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.",
907
1026
  "type": "color",
908
1027
  "collection": "Colors",
909
1028
  "scopes": [
@@ -914,7 +1033,7 @@ export const metadata = {
914
1033
  "figmaVariableId": "VariableID:2:281"
915
1034
  },
916
1035
  "uai-content-primary": {
917
- "description": "Primary text and icons. Headings, body text, form labels.",
1036
+ "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.",
918
1037
  "type": "color",
919
1038
  "collection": "Colors",
920
1039
  "scopes": [
@@ -925,7 +1044,7 @@ export const metadata = {
925
1044
  "figmaVariableId": "VariableID:2:277"
926
1045
  },
927
1046
  "uai-content-secondary": {
928
- "description": "Secondary text and icons. Descriptions, supporting text, text on muted surfaces.",
1047
+ "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.",
929
1048
  "type": "color",
930
1049
  "collection": "Colors",
931
1050
  "scopes": [
@@ -936,7 +1055,7 @@ export const metadata = {
936
1055
  "figmaVariableId": "VariableID:2:278"
937
1056
  },
938
1057
  "uai-feedback-error": {
939
- "description": "Error text and icons on standard surfaces or feedback/error-subtle. Keep a message or icon as a non-color cue. Filled destructive actions use action/destructive and its foreground.",
1058
+ "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.",
940
1059
  "type": "color",
941
1060
  "collection": "Colors",
942
1061
  "scopes": [
@@ -948,7 +1067,7 @@ export const metadata = {
948
1067
  "figmaVariableId": "VariableID:2:303"
949
1068
  },
950
1069
  "uai-feedback-error-subtle": {
951
- "description": "Error alert background. Pair with feedback/error for the icon.",
1070
+ "description": "Theme-aware background of error alerts, banners and inline status areas. Pair: feedback/error for the icon and content/primary for the text.",
952
1071
  "type": "color",
953
1072
  "collection": "Colors",
954
1073
  "scopes": [
@@ -958,7 +1077,7 @@ export const metadata = {
958
1077
  "figmaVariableId": "VariableID:2:308"
959
1078
  },
960
1079
  "uai-feedback-info": {
961
- "description": "Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background.",
1080
+ "description": "Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds.",
962
1081
  "type": "color",
963
1082
  "collection": "Colors",
964
1083
  "scopes": [
@@ -970,7 +1089,7 @@ export const metadata = {
970
1089
  "figmaVariableId": "VariableID:2:300"
971
1090
  },
972
1091
  "uai-feedback-info-subtle": {
973
- "description": "Info alert background. Pair with feedback/info for the icon.",
1092
+ "description": "Theme-aware background of information alerts, banners and inline status areas. Pair: feedback/info for the icon and content/primary for the text.",
974
1093
  "type": "color",
975
1094
  "collection": "Colors",
976
1095
  "scopes": [
@@ -980,7 +1099,7 @@ export const metadata = {
980
1099
  "figmaVariableId": "VariableID:2:305"
981
1100
  },
982
1101
  "uai-feedback-success": {
983
- "description": "Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons.",
1102
+ "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.",
984
1103
  "type": "color",
985
1104
  "collection": "Colors",
986
1105
  "scopes": [
@@ -992,7 +1111,7 @@ export const metadata = {
992
1111
  "figmaVariableId": "VariableID:2:301"
993
1112
  },
994
1113
  "uai-feedback-success-subtle": {
995
- "description": "Success alert background. Pair with feedback/success for the icon.",
1114
+ "description": "Theme-aware background of success alerts, banners and inline status areas. Pair: feedback/success for the icon and content/primary for the text.",
996
1115
  "type": "color",
997
1116
  "collection": "Colors",
998
1117
  "scopes": [
@@ -1002,7 +1121,7 @@ export const metadata = {
1002
1121
  "figmaVariableId": "VariableID:2:306"
1003
1122
  },
1004
1123
  "uai-feedback-warning": {
1005
- "description": "Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background.",
1124
+ "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.",
1006
1125
  "type": "color",
1007
1126
  "collection": "Colors",
1008
1127
  "scopes": [
@@ -1014,7 +1133,7 @@ export const metadata = {
1014
1133
  "figmaVariableId": "VariableID:2:302"
1015
1134
  },
1016
1135
  "uai-feedback-warning-subtle": {
1017
- "description": "Warning alert background. Pair with feedback/warning for the icon.",
1136
+ "description": "Theme-aware background of warning alerts, banners and inline status areas. Pair: feedback/warning for the icon and content/primary for the text.",
1018
1137
  "type": "color",
1019
1138
  "collection": "Colors",
1020
1139
  "scopes": [
@@ -1024,7 +1143,7 @@ export const metadata = {
1024
1143
  "figmaVariableId": "VariableID:2:307"
1025
1144
  },
1026
1145
  "uai-fixed-blue": {
1027
- "description": "Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface.",
1146
+ "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.",
1028
1147
  "type": "color",
1029
1148
  "collection": "Colors",
1030
1149
  "scopes": [
@@ -1036,7 +1155,7 @@ export const metadata = {
1036
1155
  "figmaVariableId": "VariableID:2:315"
1037
1156
  },
1038
1157
  "uai-fixed-brand": {
1039
- "description": "Product brand color, invariant across themes. Use fixed/dim for normal text on this background, not fixed/bright. Brand color alone is not an accessible selected-state boundary on every surface.",
1158
+ "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.",
1040
1159
  "type": "color",
1041
1160
  "collection": "Colors",
1042
1161
  "scopes": [
@@ -1048,7 +1167,7 @@ export const metadata = {
1048
1167
  "figmaVariableId": "VariableID:2:316"
1049
1168
  },
1050
1169
  "uai-fixed-bright": {
1051
- "description": "Fixed white. Not a universal foreground: fails normal-text contrast on fixed/brand and bright feedback colors. Use on fixed/dim or fixed/blue; use fixed/dim on fixed/brand.",
1170
+ "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.",
1052
1171
  "type": "color",
1053
1172
  "collection": "Colors",
1054
1173
  "scopes": [
@@ -1060,7 +1179,7 @@ export const metadata = {
1060
1179
  "figmaVariableId": "VariableID:2:314"
1061
1180
  },
1062
1181
  "uai-fixed-dim": {
1063
- "description": "Dark color that does not change with the theme.",
1182
+ "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.",
1064
1183
  "type": "color",
1065
1184
  "collection": "Colors",
1066
1185
  "scopes": [
@@ -1072,7 +1191,7 @@ export const metadata = {
1072
1191
  "figmaVariableId": "VariableID:2:313"
1073
1192
  },
1074
1193
  "uai-overlay-default": {
1075
- "description": "Backdrop behind modals, drawers and dialogs.",
1194
+ "description": "Theme-aware translucent backdrop behind modals, drawers and dialogs. Avoid: hover or pressed feedback; use overlay/hover or overlay/pressed.",
1076
1195
  "type": "color",
1077
1196
  "collection": "Colors",
1078
1197
  "scopes": [
@@ -1082,7 +1201,7 @@ export const metadata = {
1082
1201
  "figmaVariableId": "VariableID:2:309"
1083
1202
  },
1084
1203
  "uai-overlay-hover": {
1085
- "description": "Translucent layer for hover on any interactive surface.",
1204
+ "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.",
1086
1205
  "type": "color",
1087
1206
  "collection": "Colors",
1088
1207
  "scopes": [
@@ -1092,7 +1211,7 @@ export const metadata = {
1092
1211
  "figmaVariableId": "VariableID:2:310"
1093
1212
  },
1094
1213
  "uai-overlay-insight": {
1095
- "description": "Translucent background for insight panels and floating cards.",
1214
+ "description": "Theme-aware translucent background for insight panels and floating cards over content. Pair: content/primary.",
1096
1215
  "type": "color",
1097
1216
  "collection": "Colors",
1098
1217
  "scopes": [
@@ -1102,7 +1221,7 @@ export const metadata = {
1102
1221
  "figmaVariableId": "VariableID:2:312"
1103
1222
  },
1104
1223
  "uai-overlay-pressed": {
1105
- "description": "Translucent layer for pressed state on any interactive surface.",
1224
+ "description": "Theme-aware translucent pressed layer placed over any interactive surface. Use: the pressed state wherever overlay/hover is the hover state.",
1106
1225
  "type": "color",
1107
1226
  "collection": "Colors",
1108
1227
  "scopes": [
@@ -1111,8 +1230,18 @@ export const metadata = {
1111
1230
  ],
1112
1231
  "figmaVariableId": "VariableID:2:311"
1113
1232
  },
1233
+ "uai-overlay-selected": {
1234
+ "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.",
1235
+ "type": "color",
1236
+ "collection": "Colors",
1237
+ "scopes": [
1238
+ "FRAME_FILL",
1239
+ "SHAPE_FILL"
1240
+ ],
1241
+ "figmaVariableId": "VariableID:271:29"
1242
+ },
1114
1243
  "uai-surface-background": {
1115
- "description": "Page background. The base layer behind every screen.",
1244
+ "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.",
1116
1245
  "type": "color",
1117
1246
  "collection": "Colors",
1118
1247
  "scopes": [
@@ -1122,7 +1251,7 @@ export const metadata = {
1122
1251
  "figmaVariableId": "VariableID:2:263"
1123
1252
  },
1124
1253
  "uai-surface-contrast": {
1125
- "description": "Subtle contrast surface. Secondary panels, alternating sections, hovered or selected rows.",
1254
+ "description": "Theme-aware subtle contrast surface. Use: secondary panels, alternating sections, hovered or selected table rows. Pair: content/primary. Avoid: the page background.",
1126
1255
  "type": "color",
1127
1256
  "collection": "Colors",
1128
1257
  "scopes": [
@@ -1132,7 +1261,7 @@ export const metadata = {
1132
1261
  "figmaVariableId": "VariableID:2:267"
1133
1262
  },
1134
1263
  "uai-surface-inverse": {
1135
- "description": "Inverted surface. Tooltips, snackbars, dark banners in light mode (and the reverse). Use content/inverse on it.",
1264
+ "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.",
1136
1265
  "type": "color",
1137
1266
  "collection": "Colors",
1138
1267
  "scopes": [
@@ -1142,7 +1271,7 @@ export const metadata = {
1142
1271
  "figmaVariableId": "VariableID:2:268"
1143
1272
  },
1144
1273
  "uai-surface-muted": {
1145
- "description": "Muted surface. Chips, tags, code blocks, table headers. Use content/secondary on it.",
1274
+ "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.",
1146
1275
  "type": "color",
1147
1276
  "collection": "Colors",
1148
1277
  "scopes": [
@@ -1152,7 +1281,7 @@ export const metadata = {
1152
1281
  "figmaVariableId": "VariableID:2:271"
1153
1282
  },
1154
1283
  "uai-surface-paper": {
1155
- "description": "Cards, modals, popovers, dropdowns and drawers. Add an elevation style when it floats.",
1284
+ "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.",
1156
1285
  "type": "color",
1157
1286
  "collection": "Colors",
1158
1287
  "scopes": [
@@ -1162,7 +1291,7 @@ export const metadata = {
1162
1291
  "figmaVariableId": "VariableID:2:265"
1163
1292
  },
1164
1293
  "uai-border-width-default": {
1165
- "description": "Border width. 1px. Standard borders.",
1294
+ "description": "Border width 1px. Default for every border: inputs, selects, checkboxes, cards and dividers, including the solid focus border of inputs.",
1166
1295
  "type": "dimension",
1167
1296
  "collection": "Dimensions",
1168
1297
  "scopes": [
@@ -1171,7 +1300,7 @@ export const metadata = {
1171
1300
  "figmaVariableId": "VariableID:10:51"
1172
1301
  },
1173
1302
  "uai-border-width-none": {
1174
- "description": "Border width. 0px.",
1303
+ "description": "Border width 0px. Use: removing a border explicitly.",
1175
1304
  "type": "dimension",
1176
1305
  "collection": "Dimensions",
1177
1306
  "scopes": [
@@ -1180,7 +1309,7 @@ export const metadata = {
1180
1309
  "figmaVariableId": "VariableID:10:49"
1181
1310
  },
1182
1311
  "uai-border-width-thick": {
1183
- "description": "Border width. 2px. Focus rings and emphasis borders.",
1312
+ "description": "Border width 2px. Use: focus rings and halos, the checked radio border and emphasis borders.",
1184
1313
  "type": "dimension",
1185
1314
  "collection": "Dimensions",
1186
1315
  "scopes": [
@@ -1188,8 +1317,53 @@ export const metadata = {
1188
1317
  ],
1189
1318
  "figmaVariableId": "VariableID:10:53"
1190
1319
  },
1320
+ "uai-control-height-compact": {
1321
+ "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.",
1322
+ "type": "dimension",
1323
+ "collection": "Dimensions",
1324
+ "scopes": [
1325
+ "WIDTH_HEIGHT"
1326
+ ],
1327
+ "figmaVariableId": "VariableID:271:12"
1328
+ },
1329
+ "uai-control-height-large": {
1330
+ "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.",
1331
+ "type": "dimension",
1332
+ "collection": "Dimensions",
1333
+ "scopes": [
1334
+ "WIDTH_HEIGHT"
1335
+ ],
1336
+ "figmaVariableId": "VariableID:271:15"
1337
+ },
1338
+ "uai-control-height-medium": {
1339
+ "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.",
1340
+ "type": "dimension",
1341
+ "collection": "Dimensions",
1342
+ "scopes": [
1343
+ "WIDTH_HEIGHT"
1344
+ ],
1345
+ "figmaVariableId": "VariableID:271:14"
1346
+ },
1347
+ "uai-control-height-short": {
1348
+ "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.",
1349
+ "type": "dimension",
1350
+ "collection": "Dimensions",
1351
+ "scopes": [
1352
+ "WIDTH_HEIGHT"
1353
+ ],
1354
+ "figmaVariableId": "VariableID:271:13"
1355
+ },
1356
+ "uai-opacity-disabled": {
1357
+ "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.",
1358
+ "type": "number",
1359
+ "collection": "Dimensions",
1360
+ "scopes": [
1361
+ "OPACITY"
1362
+ ],
1363
+ "figmaVariableId": "VariableID:255:15"
1364
+ },
1191
1365
  "uai-opacity-focus-ring": {
1192
- "description": "Supplementary outer focus halo opacity: 30 percent in Figma, normalized to unitless 0.3 in web outputs. Apply only to the halo layer; retain a solid focus border or outline. Never apply to the full control or as the sole focus indication.",
1366
+ "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.",
1193
1367
  "type": "number",
1194
1368
  "collection": "Dimensions",
1195
1369
  "scopes": [
@@ -1198,7 +1372,7 @@ export const metadata = {
1198
1372
  "figmaVariableId": "VariableID:192:2"
1199
1373
  },
1200
1374
  "uai-radius-2xl": {
1201
- "description": "Border radius. 24px.",
1375
+ "description": "Corner radius 24px. Reserved for very large surfaces; no UAI component uses it yet. Confirm with design before applying.",
1202
1376
  "type": "dimension",
1203
1377
  "collection": "Dimensions",
1204
1378
  "scopes": [
@@ -1207,7 +1381,7 @@ export const metadata = {
1207
1381
  "figmaVariableId": "VariableID:10:23"
1208
1382
  },
1209
1383
  "uai-radius-full": {
1210
- "description": "Border radius. Full round.",
1384
+ "description": "Fully rounded corners (pill or circle). Use: avatars, radio buttons, the radio hover halo, badges and pill-shaped chips.",
1211
1385
  "type": "dimension",
1212
1386
  "collection": "Dimensions",
1213
1387
  "scopes": [
@@ -1216,7 +1390,7 @@ export const metadata = {
1216
1390
  "figmaVariableId": "VariableID:10:24"
1217
1391
  },
1218
1392
  "uai-radius-lg": {
1219
- "description": "Border radius. 12px.",
1393
+ "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.",
1220
1394
  "type": "dimension",
1221
1395
  "collection": "Dimensions",
1222
1396
  "scopes": [
@@ -1225,7 +1399,7 @@ export const metadata = {
1225
1399
  "figmaVariableId": "VariableID:10:21"
1226
1400
  },
1227
1401
  "uai-radius-md": {
1228
- "description": "Border radius. 8px.",
1402
+ "description": "Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements.",
1229
1403
  "type": "dimension",
1230
1404
  "collection": "Dimensions",
1231
1405
  "scopes": [
@@ -1234,7 +1408,7 @@ export const metadata = {
1234
1408
  "figmaVariableId": "VariableID:10:20"
1235
1409
  },
1236
1410
  "uai-radius-none": {
1237
- "description": "Border radius. 0px.",
1411
+ "description": "Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements.",
1238
1412
  "type": "dimension",
1239
1413
  "collection": "Dimensions",
1240
1414
  "scopes": [
@@ -1243,7 +1417,7 @@ export const metadata = {
1243
1417
  "figmaVariableId": "VariableID:10:17"
1244
1418
  },
1245
1419
  "uai-radius-sm": {
1246
- "description": "Border radius. 4px.",
1420
+ "description": "Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements.",
1247
1421
  "type": "dimension",
1248
1422
  "collection": "Dimensions",
1249
1423
  "scopes": [
@@ -1252,7 +1426,7 @@ export const metadata = {
1252
1426
  "figmaVariableId": "VariableID:10:19"
1253
1427
  },
1254
1428
  "uai-radius-xl": {
1255
- "description": "Border radius. 16px.",
1429
+ "description": "Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying.",
1256
1430
  "type": "dimension",
1257
1431
  "collection": "Dimensions",
1258
1432
  "scopes": [
@@ -1261,7 +1435,7 @@ export const metadata = {
1261
1435
  "figmaVariableId": "VariableID:10:22"
1262
1436
  },
1263
1437
  "uai-radius-xs": {
1264
- "description": "Border radius. 2px.",
1438
+ "description": "Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers.",
1265
1439
  "type": "dimension",
1266
1440
  "collection": "Dimensions",
1267
1441
  "scopes": [
@@ -1270,7 +1444,7 @@ export const metadata = {
1270
1444
  "figmaVariableId": "VariableID:10:18"
1271
1445
  },
1272
1446
  "uai-sizing-2xl": {
1273
- "description": "Fixed size. 40px. Medium avatars.",
1447
+ "description": "Fixed size 40px. Use: small avatar and square icon containers. Avoid: control heights of buttons, inputs and selects; use control-height/medium.",
1274
1448
  "type": "dimension",
1275
1449
  "collection": "Dimensions",
1276
1450
  "scopes": [
@@ -1278,8 +1452,17 @@ export const metadata = {
1278
1452
  ],
1279
1453
  "figmaVariableId": "VariableID:10:44"
1280
1454
  },
1455
+ "uai-sizing-2xs": {
1456
+ "description": "Fixed size 8px. Use: the tooltip arrow, notification dots on header actions and other very small indicators. Avoid: padding and gaps; use spacing/*.",
1457
+ "type": "dimension",
1458
+ "collection": "Dimensions",
1459
+ "scopes": [
1460
+ "WIDTH_HEIGHT"
1461
+ ],
1462
+ "figmaVariableId": "VariableID:271:16"
1463
+ },
1281
1464
  "uai-sizing-3xl": {
1282
- "description": "Fixed size. 48px. Large avatars.",
1465
+ "description": "Fixed size 48px. Use: standard avatar.",
1283
1466
  "type": "dimension",
1284
1467
  "collection": "Dimensions",
1285
1468
  "scopes": [
@@ -1288,7 +1471,7 @@ export const metadata = {
1288
1471
  "figmaVariableId": "VariableID:10:45"
1289
1472
  },
1290
1473
  "uai-sizing-4xl": {
1291
- "description": "Fixed size. 64px. Extra large avatars.",
1474
+ "description": "Fixed size 64px. Use: large avatar.",
1292
1475
  "type": "dimension",
1293
1476
  "collection": "Dimensions",
1294
1477
  "scopes": [
@@ -1296,8 +1479,17 @@ export const metadata = {
1296
1479
  ],
1297
1480
  "figmaVariableId": "VariableID:10:46"
1298
1481
  },
1482
+ "uai-sizing-5xl": {
1483
+ "description": "Fixed size 72px. Use: extra-large avatar.",
1484
+ "type": "dimension",
1485
+ "collection": "Dimensions",
1486
+ "scopes": [
1487
+ "WIDTH_HEIGHT"
1488
+ ],
1489
+ "figmaVariableId": "VariableID:255:14"
1490
+ },
1299
1491
  "uai-sizing-lg": {
1300
- "description": "Fixed size. 24px. Icon medium (default).",
1492
+ "description": "Fixed size 24px. Use: default icons (uai-icon size medium) and the micro avatar. Avoid: control heights; use control-height/compact.",
1301
1493
  "type": "dimension",
1302
1494
  "collection": "Dimensions",
1303
1495
  "scopes": [
@@ -1306,7 +1498,7 @@ export const metadata = {
1306
1498
  "figmaVariableId": "VariableID:10:42"
1307
1499
  },
1308
1500
  "uai-sizing-md": {
1309
- "description": "Fixed size. 20px. Icon small.",
1501
+ "description": "Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls.",
1310
1502
  "type": "dimension",
1311
1503
  "collection": "Dimensions",
1312
1504
  "scopes": [
@@ -1315,7 +1507,7 @@ export const metadata = {
1315
1507
  "figmaVariableId": "VariableID:10:41"
1316
1508
  },
1317
1509
  "uai-sizing-sm": {
1318
- "description": "Fixed size. 16px. Icon x-small.",
1510
+ "description": "Fixed size 16px. Use: x-small icons (uai-icon size x-small), such as the header breadcrumb chevrons.",
1319
1511
  "type": "dimension",
1320
1512
  "collection": "Dimensions",
1321
1513
  "scopes": [
@@ -1324,7 +1516,7 @@ export const metadata = {
1324
1516
  "figmaVariableId": "VariableID:10:40"
1325
1517
  },
1326
1518
  "uai-sizing-xl": {
1327
- "description": "Fixed size. 32px. Small avatars.",
1519
+ "description": "Fixed size 32px. Use: extra-small avatar, the radio hover halo and datepicker day cells. Avoid: control heights; use control-height/short.",
1328
1520
  "type": "dimension",
1329
1521
  "collection": "Dimensions",
1330
1522
  "scopes": [
@@ -1333,7 +1525,7 @@ export const metadata = {
1333
1525
  "figmaVariableId": "VariableID:10:43"
1334
1526
  },
1335
1527
  "uai-sizing-xs": {
1336
- "description": "Fixed size. 12px. Status dots, tiny indicators.",
1528
+ "description": "Fixed size 12px. Use: status dots, tiny indicators and the selected radio dot. Avoid: padding and gaps; use spacing/*.",
1337
1529
  "type": "dimension",
1338
1530
  "collection": "Dimensions",
1339
1531
  "scopes": [
@@ -1342,7 +1534,7 @@ export const metadata = {
1342
1534
  "figmaVariableId": "VariableID:10:39"
1343
1535
  },
1344
1536
  "uai-spacing-2xl": {
1345
- "description": "Spacing. 40px.",
1537
+ "description": "Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium.",
1346
1538
  "type": "dimension",
1347
1539
  "collection": "Dimensions",
1348
1540
  "scopes": [
@@ -1351,7 +1543,7 @@ export const metadata = {
1351
1543
  "figmaVariableId": "VariableID:10:33"
1352
1544
  },
1353
1545
  "uai-spacing-2xs": {
1354
- "description": "Spacing. 4px.",
1546
+ "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.",
1355
1547
  "type": "dimension",
1356
1548
  "collection": "Dimensions",
1357
1549
  "scopes": [
@@ -1360,7 +1552,7 @@ export const metadata = {
1360
1552
  "figmaVariableId": "VariableID:10:27"
1361
1553
  },
1362
1554
  "uai-spacing-3xl": {
1363
- "description": "Spacing. 48px.",
1555
+ "description": "Spacing 48px. Layout spacing between large page regions.",
1364
1556
  "type": "dimension",
1365
1557
  "collection": "Dimensions",
1366
1558
  "scopes": [
@@ -1369,7 +1561,7 @@ export const metadata = {
1369
1561
  "figmaVariableId": "VariableID:10:34"
1370
1562
  },
1371
1563
  "uai-spacing-3xs": {
1372
- "description": "Spacing. 2px.",
1564
+ "description": "Spacing 2px. Hairline gaps and offsets inside small elements, such as the side padding of avatar initials. Avoid: widths and heights; use sizing/*.",
1373
1565
  "type": "dimension",
1374
1566
  "collection": "Dimensions",
1375
1567
  "scopes": [
@@ -1378,7 +1570,7 @@ export const metadata = {
1378
1570
  "figmaVariableId": "VariableID:10:26"
1379
1571
  },
1380
1572
  "uai-spacing-4xl": {
1381
- "description": "Spacing. 56px.",
1573
+ "description": "Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large.",
1382
1574
  "type": "dimension",
1383
1575
  "collection": "Dimensions",
1384
1576
  "scopes": [
@@ -1387,7 +1579,7 @@ export const metadata = {
1387
1579
  "figmaVariableId": "VariableID:10:35"
1388
1580
  },
1389
1581
  "uai-spacing-5xl": {
1390
- "description": "Spacing. 64px.",
1582
+ "description": "Spacing 64px. Layout spacing for page margins and large regions.",
1391
1583
  "type": "dimension",
1392
1584
  "collection": "Dimensions",
1393
1585
  "scopes": [
@@ -1396,7 +1588,7 @@ export const metadata = {
1396
1588
  "figmaVariableId": "VariableID:10:36"
1397
1589
  },
1398
1590
  "uai-spacing-6xl": {
1399
- "description": "Spacing. 72px.",
1591
+ "description": "Spacing 72px. Layout spacing for page margins and large regions. Avoid: the header height, which comes from its content and padding.",
1400
1592
  "type": "dimension",
1401
1593
  "collection": "Dimensions",
1402
1594
  "scopes": [
@@ -1405,7 +1597,7 @@ export const metadata = {
1405
1597
  "figmaVariableId": "VariableID:144:634"
1406
1598
  },
1407
1599
  "uai-spacing-7xl": {
1408
- "description": "Spacing. 80px.",
1600
+ "description": "Spacing 80px. Layout spacing for page margins and hero areas.",
1409
1601
  "type": "dimension",
1410
1602
  "collection": "Dimensions",
1411
1603
  "scopes": [
@@ -1414,7 +1606,7 @@ export const metadata = {
1414
1606
  "figmaVariableId": "VariableID:10:37"
1415
1607
  },
1416
1608
  "uai-spacing-8xl": {
1417
- "description": "Spacing. 88px.",
1609
+ "description": "Spacing 88px. Layout spacing for page margins and hero areas.",
1418
1610
  "type": "dimension",
1419
1611
  "collection": "Dimensions",
1420
1612
  "scopes": [
@@ -1423,7 +1615,7 @@ export const metadata = {
1423
1615
  "figmaVariableId": "VariableID:144:635"
1424
1616
  },
1425
1617
  "uai-spacing-9xl": {
1426
- "description": "Spacing. 96px.",
1618
+ "description": "Spacing 96px. Largest layout spacing, for hero and landing areas.",
1427
1619
  "type": "dimension",
1428
1620
  "collection": "Dimensions",
1429
1621
  "scopes": [
@@ -1432,7 +1624,7 @@ export const metadata = {
1432
1624
  "figmaVariableId": "VariableID:10:38"
1433
1625
  },
1434
1626
  "uai-spacing-lg": {
1435
- "description": "Spacing. 24px.",
1627
+ "description": "Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar).",
1436
1628
  "type": "dimension",
1437
1629
  "collection": "Dimensions",
1438
1630
  "scopes": [
@@ -1441,7 +1633,7 @@ export const metadata = {
1441
1633
  "figmaVariableId": "VariableID:10:31"
1442
1634
  },
1443
1635
  "uai-spacing-md": {
1444
- "description": "Spacing. 16px.",
1636
+ "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.",
1445
1637
  "type": "dimension",
1446
1638
  "collection": "Dimensions",
1447
1639
  "scopes": [
@@ -1450,7 +1642,7 @@ export const metadata = {
1450
1642
  "figmaVariableId": "VariableID:10:30"
1451
1643
  },
1452
1644
  "uai-spacing-none": {
1453
- "description": "Spacing. 0px.",
1645
+ "description": "Spacing 0px. Use: removing gaps or padding explicitly.",
1454
1646
  "type": "dimension",
1455
1647
  "collection": "Dimensions",
1456
1648
  "scopes": [
@@ -1459,7 +1651,7 @@ export const metadata = {
1459
1651
  "figmaVariableId": "VariableID:10:25"
1460
1652
  },
1461
1653
  "uai-spacing-sm": {
1462
- "description": "Spacing. 12px.",
1654
+ "description": "Spacing 12px. Horizontal padding of buttons and other controls.",
1463
1655
  "type": "dimension",
1464
1656
  "collection": "Dimensions",
1465
1657
  "scopes": [
@@ -1468,7 +1660,7 @@ export const metadata = {
1468
1660
  "figmaVariableId": "VariableID:10:29"
1469
1661
  },
1470
1662
  "uai-spacing-xl": {
1471
- "description": "Spacing. 32px.",
1663
+ "description": "Spacing 32px. Layout spacing between page sections.",
1472
1664
  "type": "dimension",
1473
1665
  "collection": "Dimensions",
1474
1666
  "scopes": [
@@ -1477,7 +1669,7 @@ export const metadata = {
1477
1669
  "figmaVariableId": "VariableID:10:32"
1478
1670
  },
1479
1671
  "uai-spacing-xs": {
1480
- "description": "Spacing. 8px.",
1672
+ "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.",
1481
1673
  "type": "dimension",
1482
1674
  "collection": "Dimensions",
1483
1675
  "scopes": [
@@ -1485,8 +1677,198 @@ export const metadata = {
1485
1677
  ],
1486
1678
  "figmaVariableId": "VariableID:10:28"
1487
1679
  },
1680
+ "uai-breakpoint-lg": {
1681
+ "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.",
1682
+ "type": "dimension",
1683
+ "collection": "Layout",
1684
+ "scopes": [
1685
+ "WIDTH_HEIGHT"
1686
+ ],
1687
+ "figmaVariableId": "VariableID:255:25"
1688
+ },
1689
+ "uai-breakpoint-md": {
1690
+ "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.",
1691
+ "type": "dimension",
1692
+ "collection": "Layout",
1693
+ "scopes": [
1694
+ "WIDTH_HEIGHT"
1695
+ ],
1696
+ "figmaVariableId": "VariableID:255:24"
1697
+ },
1698
+ "uai-breakpoint-sm": {
1699
+ "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.",
1700
+ "type": "dimension",
1701
+ "collection": "Layout",
1702
+ "scopes": [
1703
+ "WIDTH_HEIGHT"
1704
+ ],
1705
+ "figmaVariableId": "VariableID:255:23"
1706
+ },
1707
+ "uai-breakpoint-xs": {
1708
+ "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.",
1709
+ "type": "dimension",
1710
+ "collection": "Layout",
1711
+ "scopes": [
1712
+ "WIDTH_HEIGHT"
1713
+ ],
1714
+ "figmaVariableId": "VariableID:255:22"
1715
+ },
1716
+ "uai-layer-content": {
1717
+ "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.",
1718
+ "type": "number",
1719
+ "collection": "Layout",
1720
+ "scopes": [],
1721
+ "figmaVariableId": "VariableID:271:25"
1722
+ },
1723
+ "uai-layer-header": {
1724
+ "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.",
1725
+ "type": "number",
1726
+ "collection": "Layout",
1727
+ "scopes": [],
1728
+ "figmaVariableId": "VariableID:271:28"
1729
+ },
1730
+ "uai-layer-navigation": {
1731
+ "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.",
1732
+ "type": "number",
1733
+ "collection": "Layout",
1734
+ "scopes": [],
1735
+ "figmaVariableId": "VariableID:271:27"
1736
+ },
1737
+ "uai-layer-navigation-overlay": {
1738
+ "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.",
1739
+ "type": "number",
1740
+ "collection": "Layout",
1741
+ "scopes": [],
1742
+ "figmaVariableId": "VariableID:271:26"
1743
+ },
1744
+ "uai-width-content": {
1745
+ "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.",
1746
+ "type": "dimension",
1747
+ "collection": "Layout",
1748
+ "scopes": [
1749
+ "WIDTH_HEIGHT"
1750
+ ],
1751
+ "figmaVariableId": "VariableID:271:24"
1752
+ },
1753
+ "uai-width-dialog": {
1754
+ "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.",
1755
+ "type": "dimension",
1756
+ "collection": "Layout",
1757
+ "scopes": [
1758
+ "WIDTH_HEIGHT"
1759
+ ],
1760
+ "figmaVariableId": "VariableID:271:20"
1761
+ },
1762
+ "uai-width-menu": {
1763
+ "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.",
1764
+ "type": "dimension",
1765
+ "collection": "Layout",
1766
+ "scopes": [
1767
+ "WIDTH_HEIGHT"
1768
+ ],
1769
+ "figmaVariableId": "VariableID:271:17"
1770
+ },
1771
+ "uai-width-panel": {
1772
+ "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.",
1773
+ "type": "dimension",
1774
+ "collection": "Layout",
1775
+ "scopes": [
1776
+ "WIDTH_HEIGHT"
1777
+ ],
1778
+ "figmaVariableId": "VariableID:271:18"
1779
+ },
1780
+ "uai-width-side-menu": {
1781
+ "description": "Layout width 288px. Use: Width of the expanded application side menu. Avoid: fixed widths for fields or menus that should follow their content.",
1782
+ "type": "dimension",
1783
+ "collection": "Layout",
1784
+ "scopes": [
1785
+ "WIDTH_HEIGHT"
1786
+ ],
1787
+ "figmaVariableId": "VariableID:271:22"
1788
+ },
1789
+ "uai-width-side-menu-collapsed": {
1790
+ "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.",
1791
+ "type": "dimension",
1792
+ "collection": "Layout",
1793
+ "scopes": [
1794
+ "WIDTH_HEIGHT"
1795
+ ],
1796
+ "figmaVariableId": "VariableID:271:23"
1797
+ },
1798
+ "uai-width-sidebar": {
1799
+ "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.",
1800
+ "type": "dimension",
1801
+ "collection": "Layout",
1802
+ "scopes": [
1803
+ "WIDTH_HEIGHT"
1804
+ ],
1805
+ "figmaVariableId": "VariableID:271:21"
1806
+ },
1807
+ "uai-width-tooltip": {
1808
+ "description": "Layout width 240px. Use: Maximum width of tooltips; longer text wraps. Avoid: fixed widths for fields or menus that should follow their content.",
1809
+ "type": "dimension",
1810
+ "collection": "Layout",
1811
+ "scopes": [
1812
+ "WIDTH_HEIGHT"
1813
+ ],
1814
+ "figmaVariableId": "VariableID:271:19"
1815
+ },
1816
+ "uai-duration-fast": {
1817
+ "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.",
1818
+ "type": "duration",
1819
+ "collection": "Motion",
1820
+ "scopes": [
1821
+ "ALL_SCOPES"
1822
+ ],
1823
+ "figmaVariableId": "VariableID:255:17"
1824
+ },
1825
+ "uai-duration-instant": {
1826
+ "description": "Motion duration 65ms. Use: feedback that must not delay reading, such as tooltips appearing and hiding. Pair: easing/standard. Respect prefers-reduced-motion.",
1827
+ "type": "duration",
1828
+ "collection": "Motion",
1829
+ "scopes": [
1830
+ "ALL_SCOPES"
1831
+ ],
1832
+ "figmaVariableId": "VariableID:255:16"
1833
+ },
1834
+ "uai-duration-loop": {
1835
+ "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.",
1836
+ "type": "duration",
1837
+ "collection": "Motion",
1838
+ "scopes": [
1839
+ "ALL_SCOPES"
1840
+ ],
1841
+ "figmaVariableId": "VariableID:255:19"
1842
+ },
1843
+ "uai-duration-moderate": {
1844
+ "description": "Motion duration 200ms. Use: overlays entering and leaving, such as dropdowns, listboxes, popovers and toasts. Pair: easing/standard. Respect prefers-reduced-motion.",
1845
+ "type": "duration",
1846
+ "collection": "Motion",
1847
+ "scopes": [
1848
+ "ALL_SCOPES"
1849
+ ],
1850
+ "figmaVariableId": "VariableID:255:18"
1851
+ },
1852
+ "uai-easing-linear": {
1853
+ "description": "Motion easing, CSS linear. Use: continuous animations at constant speed, such as spinners. Pair: duration/loop. Avoid: state changes; use easing/standard.",
1854
+ "type": "cubicBezier",
1855
+ "collection": "Motion",
1856
+ "scopes": [
1857
+ "ALL_SCOPES"
1858
+ ],
1859
+ "figmaVariableId": "VariableID:255:21"
1860
+ },
1861
+ "uai-easing-standard": {
1862
+ "description": "Motion easing, CSS ease. Default curve for state changes and overlays. Pair: duration/instant, duration/fast or duration/moderate.",
1863
+ "type": "cubicBezier",
1864
+ "collection": "Motion",
1865
+ "scopes": [
1866
+ "ALL_SCOPES"
1867
+ ],
1868
+ "figmaVariableId": "VariableID:255:20"
1869
+ },
1488
1870
  "uai-body-base-font-size": {
1489
- "description": "Body Base — 14px. Default application text.",
1871
+ "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.",
1490
1872
  "type": "dimension",
1491
1873
  "collection": "Typography",
1492
1874
  "scopes": [
@@ -1495,7 +1877,7 @@ export const metadata = {
1495
1877
  "figmaVariableId": "VariableID:2:241"
1496
1878
  },
1497
1879
  "uai-body-base-line-height": {
1498
- "description": "Body Base — 22px.",
1880
+ "description": "Body Base line height: 22px. Pair: body/base/font-size (14px).",
1499
1881
  "type": "dimension",
1500
1882
  "collection": "Typography",
1501
1883
  "scopes": [
@@ -1503,8 +1885,44 @@ export const metadata = {
1503
1885
  ],
1504
1886
  "figmaVariableId": "VariableID:2:242"
1505
1887
  },
1888
+ "uai-body-lg-font-size": {
1889
+ "description": "Body Large — 16px. Lead text and large body copy.",
1890
+ "type": "dimension",
1891
+ "collection": "Typography",
1892
+ "scopes": [
1893
+ "FONT_SIZE"
1894
+ ],
1895
+ "figmaVariableId": "VariableID:296:9"
1896
+ },
1897
+ "uai-body-lg-line-height": {
1898
+ "description": "Body Large — 24px line height.",
1899
+ "type": "dimension",
1900
+ "collection": "Typography",
1901
+ "scopes": [
1902
+ "LINE_HEIGHT"
1903
+ ],
1904
+ "figmaVariableId": "VariableID:296:10"
1905
+ },
1906
+ "uai-body-sm-font-size": {
1907
+ "description": "Body Small — 12px. Compact secondary text.",
1908
+ "type": "dimension",
1909
+ "collection": "Typography",
1910
+ "scopes": [
1911
+ "FONT_SIZE"
1912
+ ],
1913
+ "figmaVariableId": "VariableID:296:11"
1914
+ },
1915
+ "uai-body-sm-line-height": {
1916
+ "description": "Body Small — 20px line height.",
1917
+ "type": "dimension",
1918
+ "collection": "Typography",
1919
+ "scopes": [
1920
+ "LINE_HEIGHT"
1921
+ ],
1922
+ "figmaVariableId": "VariableID:296:12"
1923
+ },
1506
1924
  "uai-caption-font-size": {
1507
- "description": "Caption — 12px. Helpers, badges, small body text.",
1925
+ "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.",
1508
1926
  "type": "dimension",
1509
1927
  "collection": "Typography",
1510
1928
  "scopes": [
@@ -1513,7 +1931,7 @@ export const metadata = {
1513
1931
  "figmaVariableId": "VariableID:2:247"
1514
1932
  },
1515
1933
  "uai-caption-line-height": {
1516
- "description": "Caption — 20px.",
1934
+ "description": "Caption line height: 20px. Pair: caption/font-size (12px).",
1517
1935
  "type": "dimension",
1518
1936
  "collection": "Typography",
1519
1937
  "scopes": [
@@ -1522,7 +1940,7 @@ export const metadata = {
1522
1940
  "figmaVariableId": "VariableID:2:248"
1523
1941
  },
1524
1942
  "uai-display-font-size": {
1525
- "description": "Display — 40px. Hero, landing pages.",
1943
+ "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.",
1526
1944
  "type": "dimension",
1527
1945
  "collection": "Typography",
1528
1946
  "scopes": [
@@ -1531,7 +1949,7 @@ export const metadata = {
1531
1949
  "figmaVariableId": "VariableID:2:223"
1532
1950
  },
1533
1951
  "uai-display-line-height": {
1534
- "description": "Display — 48px.",
1952
+ "description": "Display line height: 48px. Pair: display/font-size (40px). Use only with display text.",
1535
1953
  "type": "dimension",
1536
1954
  "collection": "Typography",
1537
1955
  "scopes": [
@@ -1540,7 +1958,7 @@ export const metadata = {
1540
1958
  "figmaVariableId": "VariableID:2:224"
1541
1959
  },
1542
1960
  "uai-font-family-display": {
1543
- "description": "Display font for hero and marketing titles. Figtree today; may diverge per product.",
1961
+ "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.",
1544
1962
  "type": "fontFamily",
1545
1963
  "collection": "Typography",
1546
1964
  "scopes": [
@@ -1549,7 +1967,7 @@ export const metadata = {
1549
1967
  "figmaVariableId": "VariableID:2:222"
1550
1968
  },
1551
1969
  "uai-font-family-sans": {
1552
- "description": "Primary font for all interface text. Figtree.",
1970
+ "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.",
1553
1971
  "type": "fontFamily",
1554
1972
  "collection": "Typography",
1555
1973
  "scopes": [
@@ -1558,7 +1976,7 @@ export const metadata = {
1558
1976
  "figmaVariableId": "VariableID:2:221"
1559
1977
  },
1560
1978
  "uai-font-weight-bold": {
1561
- "description": "Bold weight (700). Titles, strong emphasis.",
1979
+ "description": "Font weight 700. Strong emphasis in titles and short inline text. Avoid: long passages and whole paragraphs.",
1562
1980
  "type": "fontWeight",
1563
1981
  "collection": "Typography",
1564
1982
  "scopes": [
@@ -1567,7 +1985,7 @@ export const metadata = {
1567
1985
  "figmaVariableId": "VariableID:2:257"
1568
1986
  },
1569
1987
  "uai-font-weight-extrabold": {
1570
- "description": "ExtraBold weight (800). Hero emphasis; maps to blip-ds bold="extra-bold".",
1988
+ "description": "Font weight 800. Hero emphasis only; equivalent to blip-ds bold='extra-bold'. Avoid: regular interface text.",
1571
1989
  "type": "fontWeight",
1572
1990
  "collection": "Typography",
1573
1991
  "scopes": [
@@ -1576,7 +1994,7 @@ export const metadata = {
1576
1994
  "figmaVariableId": "VariableID:2:258"
1577
1995
  },
1578
1996
  "uai-font-weight-medium": {
1579
- "description": "Medium weight (500). Labels, buttons.",
1997
+ "description": "Font weight 500. Light emphasis: button labels, avatar initials and active navigation items.",
1580
1998
  "type": "fontWeight",
1581
1999
  "collection": "Typography",
1582
2000
  "scopes": [
@@ -1585,7 +2003,7 @@ export const metadata = {
1585
2003
  "figmaVariableId": "VariableID:2:255"
1586
2004
  },
1587
2005
  "uai-font-weight-regular": {
1588
- "description": "Regular weight (400). Default body text.",
2006
+ "description": "Font weight 400. Default for body text, input values and helper, error and success messages.",
1589
2007
  "type": "fontWeight",
1590
2008
  "collection": "Typography",
1591
2009
  "scopes": [
@@ -1594,7 +2012,7 @@ export const metadata = {
1594
2012
  "figmaVariableId": "VariableID:2:254"
1595
2013
  },
1596
2014
  "uai-font-weight-semibold": {
1597
- "description": "SemiBold weight (600). Subtitles, navigation.",
2015
+ "description": "Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles.",
1598
2016
  "type": "fontWeight",
1599
2017
  "collection": "Typography",
1600
2018
  "scopes": [
@@ -1603,7 +2021,7 @@ export const metadata = {
1603
2021
  "figmaVariableId": "VariableID:2:256"
1604
2022
  },
1605
2023
  "uai-heading-lg-font-size": {
1606
- "description": "Heading LG — 24px. Content sections.",
2024
+ "description": "Heading LG font size: 24px. Use: titles of content sections within a page. Pair: heading/lg/line-height (32px).",
1607
2025
  "type": "dimension",
1608
2026
  "collection": "Typography",
1609
2027
  "scopes": [
@@ -1612,7 +2030,7 @@ export const metadata = {
1612
2030
  "figmaVariableId": "VariableID:2:229"
1613
2031
  },
1614
2032
  "uai-heading-lg-line-height": {
1615
- "description": "Heading LG — 32px.",
2033
+ "description": "Heading LG line height: 32px. Pair: heading/lg/font-size (24px).",
1616
2034
  "type": "dimension",
1617
2035
  "collection": "Typography",
1618
2036
  "scopes": [
@@ -1621,7 +2039,7 @@ export const metadata = {
1621
2039
  "figmaVariableId": "VariableID:2:230"
1622
2040
  },
1623
2041
  "uai-heading-md-font-size": {
1624
- "description": "Heading MD — 20px. Subsections.",
2042
+ "description": "Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px).",
1625
2043
  "type": "dimension",
1626
2044
  "collection": "Typography",
1627
2045
  "scopes": [
@@ -1630,7 +2048,7 @@ export const metadata = {
1630
2048
  "figmaVariableId": "VariableID:2:232"
1631
2049
  },
1632
2050
  "uai-heading-md-line-height": {
1633
- "description": "Heading MD — 28px.",
2051
+ "description": "Heading MD line height: 28px. Pair: heading/md/font-size (20px).",
1634
2052
  "type": "dimension",
1635
2053
  "collection": "Typography",
1636
2054
  "scopes": [
@@ -1639,7 +2057,7 @@ export const metadata = {
1639
2057
  "figmaVariableId": "VariableID:2:233"
1640
2058
  },
1641
2059
  "uai-heading-xl-font-size": {
1642
- "description": "Heading XL — 32px. Main page title.",
2060
+ "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.",
1643
2061
  "type": "dimension",
1644
2062
  "collection": "Typography",
1645
2063
  "scopes": [
@@ -1648,7 +2066,7 @@ export const metadata = {
1648
2066
  "figmaVariableId": "VariableID:2:226"
1649
2067
  },
1650
2068
  "uai-heading-xl-line-height": {
1651
- "description": "Heading XL — 40px.",
2069
+ "description": "Heading XL line height: 40px. Pair: heading/xl/font-size (32px).",
1652
2070
  "type": "dimension",
1653
2071
  "collection": "Typography",
1654
2072
  "scopes": [
@@ -1657,7 +2075,7 @@ export const metadata = {
1657
2075
  "figmaVariableId": "VariableID:2:227"
1658
2076
  },
1659
2077
  "uai-letter-spacing-expanded": {
1660
- "description": "Expanded letter spacing (0.2em). Spaced body variant.",
2078
+ "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.",
1661
2079
  "type": "dimension",
1662
2080
  "collection": "Typography",
1663
2081
  "scopes": [
@@ -1666,7 +2084,7 @@ export const metadata = {
1666
2084
  "figmaVariableId": "VariableID:2:261"
1667
2085
  },
1668
2086
  "uai-letter-spacing-normal": {
1669
- "description": "Default letter spacing for all text styles.",
2087
+ "description": "Letter spacing 0px. Default tracking for every text role. Use unless a text style explicitly asks for expanded tracking.",
1670
2088
  "type": "dimension",
1671
2089
  "collection": "Typography",
1672
2090
  "scopes": [
@@ -1675,7 +2093,7 @@ export const metadata = {
1675
2093
  "figmaVariableId": "VariableID:2:260"
1676
2094
  },
1677
2095
  "uai-overline-font-size": {
1678
- "description": "Overline — 10px. Tags, restricted use.",
2096
+ "description": "Overline font size: 10px. Restricted use: tags and small category labels. Pair: overline/line-height (16px). Avoid: body copy or any essential information.",
1679
2097
  "type": "dimension",
1680
2098
  "collection": "Typography",
1681
2099
  "scopes": [
@@ -1684,7 +2102,7 @@ export const metadata = {
1684
2102
  "figmaVariableId": "VariableID:2:250"
1685
2103
  },
1686
2104
  "uai-overline-line-height": {
1687
- "description": "Overline — 16px.",
2105
+ "description": "Overline line height: 16px. Pair: overline/font-size (10px).",
1688
2106
  "type": "dimension",
1689
2107
  "collection": "Typography",
1690
2108
  "scopes": [
@@ -1693,7 +2111,7 @@ export const metadata = {
1693
2111
  "figmaVariableId": "VariableID:2:251"
1694
2112
  },
1695
2113
  "uai-title-font-size": {
1696
- "description": "Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text.",
2114
+ "description": "Title compatibility alias for title/md — 16px.",
1697
2115
  "type": "dimension",
1698
2116
  "collection": "Typography",
1699
2117
  "scopes": [
@@ -1701,13 +2119,67 @@ export const metadata = {
1701
2119
  ],
1702
2120
  "figmaVariableId": "VariableID:2:235"
1703
2121
  },
2122
+ "uai-title-lg-font-size": {
2123
+ "description": "Title Large — 18px. Primary page titles.",
2124
+ "type": "dimension",
2125
+ "collection": "Typography",
2126
+ "scopes": [
2127
+ "FONT_SIZE"
2128
+ ],
2129
+ "figmaVariableId": "VariableID:296:3"
2130
+ },
2131
+ "uai-title-lg-line-height": {
2132
+ "description": "Title Large — 24px line height.",
2133
+ "type": "dimension",
2134
+ "collection": "Typography",
2135
+ "scopes": [
2136
+ "LINE_HEIGHT"
2137
+ ],
2138
+ "figmaVariableId": "VariableID:296:4"
2139
+ },
1704
2140
  "uai-title-line-height": {
1705
- "description": "Title — 24px.",
2141
+ "description": "Title compatibility alias for title/md — 24px.",
1706
2142
  "type": "dimension",
1707
2143
  "collection": "Typography",
1708
2144
  "scopes": [
1709
2145
  "LINE_HEIGHT"
1710
2146
  ],
1711
2147
  "figmaVariableId": "VariableID:2:236"
2148
+ },
2149
+ "uai-title-md-font-size": {
2150
+ "description": "Title Medium — 16px. Card titles, strong labels, navigation.",
2151
+ "type": "dimension",
2152
+ "collection": "Typography",
2153
+ "scopes": [
2154
+ "FONT_SIZE"
2155
+ ],
2156
+ "figmaVariableId": "VariableID:296:5"
2157
+ },
2158
+ "uai-title-md-line-height": {
2159
+ "description": "Title Medium — 24px line height.",
2160
+ "type": "dimension",
2161
+ "collection": "Typography",
2162
+ "scopes": [
2163
+ "LINE_HEIGHT"
2164
+ ],
2165
+ "figmaVariableId": "VariableID:296:6"
2166
+ },
2167
+ "uai-title-sm-font-size": {
2168
+ "description": "Title Small — 14px. Compact titles and labels.",
2169
+ "type": "dimension",
2170
+ "collection": "Typography",
2171
+ "scopes": [
2172
+ "FONT_SIZE"
2173
+ ],
2174
+ "figmaVariableId": "VariableID:296:7"
2175
+ },
2176
+ "uai-title-sm-line-height": {
2177
+ "description": "Title Small — 20px line height.",
2178
+ "type": "dimension",
2179
+ "collection": "Typography",
2180
+ "scopes": [
2181
+ "LINE_HEIGHT"
2182
+ ],
2183
+ "figmaVariableId": "VariableID:296:8"
1712
2184
  }
1713
2185
  };