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.
package/build/tokens.js CHANGED
@@ -1,16 +1,21 @@
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",
5
8
  "uai-action-outline-hover": "#f2f3f3",
6
9
  "uai-action-outline-pressed": "#e4e6e7",
10
+ "uai-action-positive": "#047857",
11
+ "uai-action-positive-foreground": "#ffffff",
7
12
  "uai-action-primary-default": "#242729",
8
13
  "uai-action-primary-foreground": "#ffffff",
9
14
  "uai-action-primary-hover": "#181a1b",
10
15
  "uai-action-primary-pressed": "#0a0a0a",
11
16
  "uai-border-default": "#e4e6e7",
12
17
  "uai-border-input": "#adb4b8",
13
- "uai-border-ring": "#c084fc",
18
+ "uai-border-ring": "#242729",
14
19
  "uai-content-disabled": "#848e94",
15
20
  "uai-content-inverse": "#ffffff",
16
21
  "uai-content-link": "#0073e5",
@@ -33,6 +38,7 @@ export const light = {
33
38
  "uai-overlay-hover": "rgba(0, 0, 0, 0.08)",
34
39
  "uai-overlay-insight": "rgba(255, 255, 255, 0.9)",
35
40
  "uai-overlay-pressed": "rgba(0, 0, 0, 0.16)",
41
+ "uai-overlay-selected": "rgba(0, 0, 0, 0.06)",
36
42
  "uai-surface-background": "#f2f3f3",
37
43
  "uai-surface-contrast": "#e4e6e7",
38
44
  "uai-surface-inverse": "#242729",
@@ -41,6 +47,12 @@ export const light = {
41
47
  "uai-border-width-default": "1px",
42
48
  "uai-border-width-none": "0px",
43
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,
55
+ "uai-opacity-focus-ring": 0.3,
44
56
  "uai-radius-2xl": "1.5rem",
45
57
  "uai-radius-full": "624.9375rem",
46
58
  "uai-radius-lg": "0.75rem",
@@ -50,8 +62,10 @@ export const light = {
50
62
  "uai-radius-xl": "1rem",
51
63
  "uai-radius-xs": "0.125rem",
52
64
  "uai-sizing-2xl": "2.5rem",
65
+ "uai-sizing-2xs": "0.5rem",
53
66
  "uai-sizing-3xl": "3rem",
54
67
  "uai-sizing-4xl": "4rem",
68
+ "uai-sizing-5xl": "4.5rem",
55
69
  "uai-sizing-lg": "1.5rem",
56
70
  "uai-sizing-md": "1.25rem",
57
71
  "uai-sizing-sm": "1rem",
@@ -73,8 +87,34 @@ export const light = {
73
87
  "uai-spacing-sm": "0.75rem",
74
88
  "uai-spacing-xl": "2rem",
75
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)",
76
112
  "uai-body-base-font-size": "0.875rem",
77
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",
78
118
  "uai-caption-font-size": "0.75rem",
79
119
  "uai-caption-line-height": "1.25rem",
80
120
  "uai-display-font-size": "2.5rem",
@@ -97,34 +137,45 @@ export const light = {
97
137
  "uai-overline-font-size": "0.625rem",
98
138
  "uai-overline-line-height": "1rem",
99
139
  "uai-title-font-size": "1rem",
100
- "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"
101
147
  };
102
148
  export const dark = {
103
- "uai-action-destructive": "#cf0022",
104
- "uai-action-destructive-foreground": "#ffffff",
149
+ "uai-accent-ai-end": "#00c6d7",
150
+ "uai-accent-ai-middle": "#a855f7",
151
+ "uai-accent-ai-start": "#0099ff",
152
+ "uai-action-destructive": "#fca5a5",
153
+ "uai-action-destructive-foreground": "#181a1b",
105
154
  "uai-action-outline-default": "#242729",
106
155
  "uai-action-outline-hover": "#2f3437",
107
156
  "uai-action-outline-pressed": "#3b4144",
157
+ "uai-action-positive": "#35de90",
158
+ "uai-action-positive-foreground": "#181a1b",
108
159
  "uai-action-primary-default": "#e4e6e7",
109
160
  "uai-action-primary-foreground": "#242729",
110
161
  "uai-action-primary-hover": "#d6d9db",
111
162
  "uai-action-primary-pressed": "#c8cccf",
112
163
  "uai-border-default": "#2f3437",
113
- "uai-border-input": "#5f676d",
114
- "uai-border-ring": "#c084fc",
164
+ "uai-border-input": "#848e94",
165
+ "uai-border-ring": "#ffffff",
115
166
  "uai-content-disabled": "#768188",
116
167
  "uai-content-inverse": "#181a1b",
117
- "uai-content-link": "#0099ff",
118
- "uai-content-placeholder": "#768188",
168
+ "uai-content-link": "#93c5fd",
169
+ "uai-content-placeholder": "#adb4b8",
119
170
  "uai-content-primary": "#ffffff",
120
171
  "uai-content-secondary": "#adb4b8",
121
- "uai-feedback-error": "#cf0022",
172
+ "uai-feedback-error": "#fca5a5",
122
173
  "uai-feedback-error-subtle": "#450a0a",
123
- "uai-feedback-info": "#0073e5",
174
+ "uai-feedback-info": "#93c5fd",
124
175
  "uai-feedback-info-subtle": "#072563",
125
- "uai-feedback-success": "#3da329",
176
+ "uai-feedback-success": "#35de90",
126
177
  "uai-feedback-success-subtle": "#022c22",
127
- "uai-feedback-warning": "#ff8000",
178
+ "uai-feedback-warning": "#fb923c",
128
179
  "uai-feedback-warning-subtle": "#431407",
129
180
  "uai-fixed-blue": "#1e6bf1",
130
181
  "uai-fixed-brand": "#0099ff",
@@ -134,6 +185,7 @@ export const dark = {
134
185
  "uai-overlay-hover": "rgba(255, 255, 255, 0.08)",
135
186
  "uai-overlay-insight": "rgba(0, 0, 0, 0.8)",
136
187
  "uai-overlay-pressed": "rgba(255, 255, 255, 0.16)",
188
+ "uai-overlay-selected": "rgba(255, 255, 255, 0.06)",
137
189
  "uai-surface-background": "#181a1b",
138
190
  "uai-surface-contrast": "#2f3437",
139
191
  "uai-surface-inverse": "#f2f3f3",
@@ -142,6 +194,12 @@ export const dark = {
142
194
  "uai-border-width-default": "1px",
143
195
  "uai-border-width-none": "0px",
144
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,
202
+ "uai-opacity-focus-ring": 0.3,
145
203
  "uai-radius-2xl": "1.5rem",
146
204
  "uai-radius-full": "624.9375rem",
147
205
  "uai-radius-lg": "0.75rem",
@@ -151,8 +209,10 @@ export const dark = {
151
209
  "uai-radius-xl": "1rem",
152
210
  "uai-radius-xs": "0.125rem",
153
211
  "uai-sizing-2xl": "2.5rem",
212
+ "uai-sizing-2xs": "0.5rem",
154
213
  "uai-sizing-3xl": "3rem",
155
214
  "uai-sizing-4xl": "4rem",
215
+ "uai-sizing-5xl": "4.5rem",
156
216
  "uai-sizing-lg": "1.5rem",
157
217
  "uai-sizing-md": "1.25rem",
158
218
  "uai-sizing-sm": "1rem",
@@ -174,8 +234,34 @@ export const dark = {
174
234
  "uai-spacing-sm": "0.75rem",
175
235
  "uai-spacing-xl": "2rem",
176
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)",
177
259
  "uai-body-base-font-size": "0.875rem",
178
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",
179
265
  "uai-caption-font-size": "0.75rem",
180
266
  "uai-caption-line-height": "1.25rem",
181
267
  "uai-display-font-size": "2.5rem",
@@ -198,7 +284,13 @@ export const dark = {
198
284
  "uai-overline-font-size": "0.625rem",
199
285
  "uai-overline-line-height": "1rem",
200
286
  "uai-title-font-size": "1rem",
201
- "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"
202
294
  };
203
295
  export const shadows = {
204
296
  "uai-elevation-1": {
@@ -721,8 +813,41 @@ export const textStyles = {
721
813
  }
722
814
  };
723
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
+ },
724
849
  "uai-action-destructive": {
725
- "description": "Destructive button (delete, remove). Same red as feedback/error.",
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.",
726
851
  "type": "color",
727
852
  "collection": "Colors",
728
853
  "scopes": [
@@ -734,7 +859,7 @@ export const metadata = {
734
859
  "figmaVariableId": "VariableID:2:290"
735
860
  },
736
861
  "uai-action-destructive-foreground": {
737
- "description": "Text and icons on destructive buttons.",
862
+ "description": "Theme-aware text and icon color on action/destructive: white in Light, dark neutral in Dark. Avoid: replacing it with fixed/bright.",
738
863
  "type": "color",
739
864
  "collection": "Colors",
740
865
  "scopes": [
@@ -745,7 +870,7 @@ export const metadata = {
745
870
  "figmaVariableId": "VariableID:2:291"
746
871
  },
747
872
  "uai-action-outline-default": {
748
- "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.",
749
874
  "type": "color",
750
875
  "collection": "Colors",
751
876
  "scopes": [
@@ -755,7 +880,7 @@ export const metadata = {
755
880
  "figmaVariableId": "VariableID:2:287"
756
881
  },
757
882
  "uai-action-outline-hover": {
758
- "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.",
759
884
  "type": "color",
760
885
  "collection": "Colors",
761
886
  "scopes": [
@@ -765,7 +890,7 @@ export const metadata = {
765
890
  "figmaVariableId": "VariableID:2:288"
766
891
  },
767
892
  "uai-action-outline-pressed": {
768
- "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.",
769
894
  "type": "color",
770
895
  "collection": "Colors",
771
896
  "scopes": [
@@ -774,8 +899,29 @@ export const metadata = {
774
899
  ],
775
900
  "figmaVariableId": "VariableID:2:289"
776
901
  },
902
+ "uai-action-positive": {
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.",
904
+ "type": "color",
905
+ "collection": "Colors",
906
+ "scopes": [
907
+ "FRAME_FILL",
908
+ "SHAPE_FILL",
909
+ "STROKE_COLOR"
910
+ ],
911
+ "figmaVariableId": "VariableID:202:2"
912
+ },
913
+ "uai-action-positive-foreground": {
914
+ "description": "Theme-aware text and icon color on action/positive: white in Light, dark neutral in Dark.",
915
+ "type": "color",
916
+ "collection": "Colors",
917
+ "scopes": [
918
+ "SHAPE_FILL",
919
+ "TEXT_FILL"
920
+ ],
921
+ "figmaVariableId": "VariableID:202:3"
922
+ },
777
923
  "uai-action-primary-default": {
778
- "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.",
779
925
  "type": "color",
780
926
  "collection": "Colors",
781
927
  "scopes": [
@@ -785,7 +931,7 @@ export const metadata = {
785
931
  "figmaVariableId": "VariableID:2:283"
786
932
  },
787
933
  "uai-action-primary-foreground": {
788
- "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.",
789
935
  "type": "color",
790
936
  "collection": "Colors",
791
937
  "scopes": [
@@ -796,7 +942,7 @@ export const metadata = {
796
942
  "figmaVariableId": "VariableID:2:286"
797
943
  },
798
944
  "uai-action-primary-hover": {
799
- "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.",
800
946
  "type": "color",
801
947
  "collection": "Colors",
802
948
  "scopes": [
@@ -806,7 +952,7 @@ export const metadata = {
806
952
  "figmaVariableId": "VariableID:2:284"
807
953
  },
808
954
  "uai-action-primary-pressed": {
809
- "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.",
810
956
  "type": "color",
811
957
  "collection": "Colors",
812
958
  "scopes": [
@@ -816,7 +962,7 @@ export const metadata = {
816
962
  "figmaVariableId": "VariableID:2:285"
817
963
  },
818
964
  "uai-border-default": {
819
- "description": "Default border. Cards, dividers, separators.",
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.",
820
966
  "type": "color",
821
967
  "collection": "Colors",
822
968
  "scopes": [
@@ -825,7 +971,7 @@ export const metadata = {
825
971
  "figmaVariableId": "VariableID:2:296"
826
972
  },
827
973
  "uai-border-input": {
828
- "description": "Form control border. Inputs, selects, checkboxes, outline buttons.",
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.",
829
975
  "type": "color",
830
976
  "collection": "Colors",
831
977
  "scopes": [
@@ -834,7 +980,7 @@ export const metadata = {
834
980
  "figmaVariableId": "VariableID:2:297"
835
981
  },
836
982
  "uai-border-ring": {
837
- "description": "Focus ring for keyboard navigation.",
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.",
838
984
  "type": "color",
839
985
  "collection": "Colors",
840
986
  "scopes": [
@@ -843,7 +989,7 @@ export const metadata = {
843
989
  "figmaVariableId": "VariableID:2:298"
844
990
  },
845
991
  "uai-content-disabled": {
846
- "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.",
847
993
  "type": "color",
848
994
  "collection": "Colors",
849
995
  "scopes": [
@@ -854,7 +1000,7 @@ export const metadata = {
854
1000
  "figmaVariableId": "VariableID:2:279"
855
1001
  },
856
1002
  "uai-content-inverse": {
857
- "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.",
858
1004
  "type": "color",
859
1005
  "collection": "Colors",
860
1006
  "scopes": [
@@ -865,7 +1011,7 @@ export const metadata = {
865
1011
  "figmaVariableId": "VariableID:144:636"
866
1012
  },
867
1013
  "uai-content-link": {
868
- "description": "Links and interactive navigation 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.",
869
1015
  "type": "color",
870
1016
  "collection": "Colors",
871
1017
  "scopes": [
@@ -876,7 +1022,7 @@ export const metadata = {
876
1022
  "figmaVariableId": "VariableID:2:280"
877
1023
  },
878
1024
  "uai-content-placeholder": {
879
- "description": "Input placeholder and hint text. Not for disabled content.",
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.",
880
1026
  "type": "color",
881
1027
  "collection": "Colors",
882
1028
  "scopes": [
@@ -887,7 +1033,7 @@ export const metadata = {
887
1033
  "figmaVariableId": "VariableID:2:281"
888
1034
  },
889
1035
  "uai-content-primary": {
890
- "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.",
891
1037
  "type": "color",
892
1038
  "collection": "Colors",
893
1039
  "scopes": [
@@ -898,7 +1044,7 @@ export const metadata = {
898
1044
  "figmaVariableId": "VariableID:2:277"
899
1045
  },
900
1046
  "uai-content-secondary": {
901
- "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.",
902
1048
  "type": "color",
903
1049
  "collection": "Colors",
904
1050
  "scopes": [
@@ -909,7 +1055,7 @@ export const metadata = {
909
1055
  "figmaVariableId": "VariableID:2:278"
910
1056
  },
911
1057
  "uai-feedback-error": {
912
- "description": "Error. Field errors, failures, destructive confirmations. Components call it "negative".",
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.",
913
1059
  "type": "color",
914
1060
  "collection": "Colors",
915
1061
  "scopes": [
@@ -921,7 +1067,7 @@ export const metadata = {
921
1067
  "figmaVariableId": "VariableID:2:303"
922
1068
  },
923
1069
  "uai-feedback-error-subtle": {
924
- "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.",
925
1071
  "type": "color",
926
1072
  "collection": "Colors",
927
1073
  "scopes": [
@@ -931,7 +1077,7 @@ export const metadata = {
931
1077
  "figmaVariableId": "VariableID:2:308"
932
1078
  },
933
1079
  "uai-feedback-info": {
934
- "description": "Information. Info alerts, status badges and icons.",
1080
+ "description": "Theme-aware information color for text, icons and borders on standard surfaces or on feedback/info-subtle. Avoid: filled button backgrounds.",
935
1081
  "type": "color",
936
1082
  "collection": "Colors",
937
1083
  "scopes": [
@@ -943,7 +1089,7 @@ export const metadata = {
943
1089
  "figmaVariableId": "VariableID:2:300"
944
1090
  },
945
1091
  "uai-feedback-info-subtle": {
946
- "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.",
947
1093
  "type": "color",
948
1094
  "collection": "Colors",
949
1095
  "scopes": [
@@ -953,7 +1099,7 @@ export const metadata = {
953
1099
  "figmaVariableId": "VariableID:2:305"
954
1100
  },
955
1101
  "uai-feedback-success": {
956
- "description": "Success. Confirmations, positive validation, completed states. Components call it "positive".",
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.",
957
1103
  "type": "color",
958
1104
  "collection": "Colors",
959
1105
  "scopes": [
@@ -965,7 +1111,7 @@ export const metadata = {
965
1111
  "figmaVariableId": "VariableID:2:301"
966
1112
  },
967
1113
  "uai-feedback-success-subtle": {
968
- "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.",
969
1115
  "type": "color",
970
1116
  "collection": "Colors",
971
1117
  "scopes": [
@@ -975,7 +1121,7 @@ export const metadata = {
975
1121
  "figmaVariableId": "VariableID:2:306"
976
1122
  },
977
1123
  "uai-feedback-warning": {
978
- "description": "Warning. States that need attention. For text on light surfaces, check contrast.",
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.",
979
1125
  "type": "color",
980
1126
  "collection": "Colors",
981
1127
  "scopes": [
@@ -987,7 +1133,7 @@ export const metadata = {
987
1133
  "figmaVariableId": "VariableID:2:302"
988
1134
  },
989
1135
  "uai-feedback-warning-subtle": {
990
- "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.",
991
1137
  "type": "color",
992
1138
  "collection": "Colors",
993
1139
  "scopes": [
@@ -997,7 +1143,7 @@ export const metadata = {
997
1143
  "figmaVariableId": "VariableID:2:307"
998
1144
  },
999
1145
  "uai-fixed-blue": {
1000
- "description": "Blip blue that does not change with the theme. Selected states and highlights.",
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.",
1001
1147
  "type": "color",
1002
1148
  "collection": "Colors",
1003
1149
  "scopes": [
@@ -1009,7 +1155,7 @@ export const metadata = {
1009
1155
  "figmaVariableId": "VariableID:2:315"
1010
1156
  },
1011
1157
  "uai-fixed-brand": {
1012
- "description": "Product brand color. Changes per product, not per theme. Banners, highlights.",
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.",
1013
1159
  "type": "color",
1014
1160
  "collection": "Colors",
1015
1161
  "scopes": [
@@ -1021,7 +1167,7 @@ export const metadata = {
1021
1167
  "figmaVariableId": "VariableID:2:316"
1022
1168
  },
1023
1169
  "uai-fixed-bright": {
1024
- "description": "Light color that does not change with the theme. Text 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.",
1025
1171
  "type": "color",
1026
1172
  "collection": "Colors",
1027
1173
  "scopes": [
@@ -1033,7 +1179,7 @@ export const metadata = {
1033
1179
  "figmaVariableId": "VariableID:2:314"
1034
1180
  },
1035
1181
  "uai-fixed-dim": {
1036
- "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.",
1037
1183
  "type": "color",
1038
1184
  "collection": "Colors",
1039
1185
  "scopes": [
@@ -1045,7 +1191,7 @@ export const metadata = {
1045
1191
  "figmaVariableId": "VariableID:2:313"
1046
1192
  },
1047
1193
  "uai-overlay-default": {
1048
- "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.",
1049
1195
  "type": "color",
1050
1196
  "collection": "Colors",
1051
1197
  "scopes": [
@@ -1055,7 +1201,7 @@ export const metadata = {
1055
1201
  "figmaVariableId": "VariableID:2:309"
1056
1202
  },
1057
1203
  "uai-overlay-hover": {
1058
- "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.",
1059
1205
  "type": "color",
1060
1206
  "collection": "Colors",
1061
1207
  "scopes": [
@@ -1065,7 +1211,7 @@ export const metadata = {
1065
1211
  "figmaVariableId": "VariableID:2:310"
1066
1212
  },
1067
1213
  "uai-overlay-insight": {
1068
- "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.",
1069
1215
  "type": "color",
1070
1216
  "collection": "Colors",
1071
1217
  "scopes": [
@@ -1075,7 +1221,7 @@ export const metadata = {
1075
1221
  "figmaVariableId": "VariableID:2:312"
1076
1222
  },
1077
1223
  "uai-overlay-pressed": {
1078
- "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.",
1079
1225
  "type": "color",
1080
1226
  "collection": "Colors",
1081
1227
  "scopes": [
@@ -1084,8 +1230,18 @@ export const metadata = {
1084
1230
  ],
1085
1231
  "figmaVariableId": "VariableID:2:311"
1086
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
+ },
1087
1243
  "uai-surface-background": {
1088
- "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.",
1089
1245
  "type": "color",
1090
1246
  "collection": "Colors",
1091
1247
  "scopes": [
@@ -1095,7 +1251,7 @@ export const metadata = {
1095
1251
  "figmaVariableId": "VariableID:2:263"
1096
1252
  },
1097
1253
  "uai-surface-contrast": {
1098
- "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.",
1099
1255
  "type": "color",
1100
1256
  "collection": "Colors",
1101
1257
  "scopes": [
@@ -1105,7 +1261,7 @@ export const metadata = {
1105
1261
  "figmaVariableId": "VariableID:2:267"
1106
1262
  },
1107
1263
  "uai-surface-inverse": {
1108
- "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.",
1109
1265
  "type": "color",
1110
1266
  "collection": "Colors",
1111
1267
  "scopes": [
@@ -1115,7 +1271,7 @@ export const metadata = {
1115
1271
  "figmaVariableId": "VariableID:2:268"
1116
1272
  },
1117
1273
  "uai-surface-muted": {
1118
- "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.",
1119
1275
  "type": "color",
1120
1276
  "collection": "Colors",
1121
1277
  "scopes": [
@@ -1125,7 +1281,7 @@ export const metadata = {
1125
1281
  "figmaVariableId": "VariableID:2:271"
1126
1282
  },
1127
1283
  "uai-surface-paper": {
1128
- "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.",
1129
1285
  "type": "color",
1130
1286
  "collection": "Colors",
1131
1287
  "scopes": [
@@ -1135,7 +1291,7 @@ export const metadata = {
1135
1291
  "figmaVariableId": "VariableID:2:265"
1136
1292
  },
1137
1293
  "uai-border-width-default": {
1138
- "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.",
1139
1295
  "type": "dimension",
1140
1296
  "collection": "Dimensions",
1141
1297
  "scopes": [
@@ -1144,7 +1300,7 @@ export const metadata = {
1144
1300
  "figmaVariableId": "VariableID:10:51"
1145
1301
  },
1146
1302
  "uai-border-width-none": {
1147
- "description": "Border width. 0px.",
1303
+ "description": "Border width 0px. Use: removing a border explicitly.",
1148
1304
  "type": "dimension",
1149
1305
  "collection": "Dimensions",
1150
1306
  "scopes": [
@@ -1153,7 +1309,7 @@ export const metadata = {
1153
1309
  "figmaVariableId": "VariableID:10:49"
1154
1310
  },
1155
1311
  "uai-border-width-thick": {
1156
- "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.",
1157
1313
  "type": "dimension",
1158
1314
  "collection": "Dimensions",
1159
1315
  "scopes": [
@@ -1161,8 +1317,62 @@ export const metadata = {
1161
1317
  ],
1162
1318
  "figmaVariableId": "VariableID:10:53"
1163
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
+ },
1365
+ "uai-opacity-focus-ring": {
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.",
1367
+ "type": "number",
1368
+ "collection": "Dimensions",
1369
+ "scopes": [
1370
+ "OPACITY"
1371
+ ],
1372
+ "figmaVariableId": "VariableID:192:2"
1373
+ },
1164
1374
  "uai-radius-2xl": {
1165
- "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.",
1166
1376
  "type": "dimension",
1167
1377
  "collection": "Dimensions",
1168
1378
  "scopes": [
@@ -1171,7 +1381,7 @@ export const metadata = {
1171
1381
  "figmaVariableId": "VariableID:10:23"
1172
1382
  },
1173
1383
  "uai-radius-full": {
1174
- "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.",
1175
1385
  "type": "dimension",
1176
1386
  "collection": "Dimensions",
1177
1387
  "scopes": [
@@ -1180,7 +1390,7 @@ export const metadata = {
1180
1390
  "figmaVariableId": "VariableID:10:24"
1181
1391
  },
1182
1392
  "uai-radius-lg": {
1183
- "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.",
1184
1394
  "type": "dimension",
1185
1395
  "collection": "Dimensions",
1186
1396
  "scopes": [
@@ -1189,7 +1399,7 @@ export const metadata = {
1189
1399
  "figmaVariableId": "VariableID:10:21"
1190
1400
  },
1191
1401
  "uai-radius-md": {
1192
- "description": "Border radius. 8px.",
1402
+ "description": "Corner radius 8px. Use: compact 24px controls, such as the compact uai-button, and other small interactive elements.",
1193
1403
  "type": "dimension",
1194
1404
  "collection": "Dimensions",
1195
1405
  "scopes": [
@@ -1198,7 +1408,7 @@ export const metadata = {
1198
1408
  "figmaVariableId": "VariableID:10:20"
1199
1409
  },
1200
1410
  "uai-radius-none": {
1201
- "description": "Border radius. 0px.",
1411
+ "description": "Corner radius 0px. Use: square corners on full-bleed surfaces, table cells and edges that touch other elements.",
1202
1412
  "type": "dimension",
1203
1413
  "collection": "Dimensions",
1204
1414
  "scopes": [
@@ -1207,7 +1417,7 @@ export const metadata = {
1207
1417
  "figmaVariableId": "VariableID:10:17"
1208
1418
  },
1209
1419
  "uai-radius-sm": {
1210
- "description": "Border radius. 4px.",
1420
+ "description": "Corner radius 4px. Use: checkboxes, chip remove buttons, small badges and other small inner elements.",
1211
1421
  "type": "dimension",
1212
1422
  "collection": "Dimensions",
1213
1423
  "scopes": [
@@ -1216,7 +1426,7 @@ export const metadata = {
1216
1426
  "figmaVariableId": "VariableID:10:19"
1217
1427
  },
1218
1428
  "uai-radius-xl": {
1219
- "description": "Border radius. 16px.",
1429
+ "description": "Corner radius 16px. Reserved for large surfaces; no UAI component uses it yet. Confirm with design before applying.",
1220
1430
  "type": "dimension",
1221
1431
  "collection": "Dimensions",
1222
1432
  "scopes": [
@@ -1225,7 +1435,7 @@ export const metadata = {
1225
1435
  "figmaVariableId": "VariableID:10:22"
1226
1436
  },
1227
1437
  "uai-radius-xs": {
1228
- "description": "Border radius. 2px.",
1438
+ "description": "Corner radius 2px. Use: tiny inner marks and indicators. Avoid: controls and containers.",
1229
1439
  "type": "dimension",
1230
1440
  "collection": "Dimensions",
1231
1441
  "scopes": [
@@ -1234,7 +1444,7 @@ export const metadata = {
1234
1444
  "figmaVariableId": "VariableID:10:18"
1235
1445
  },
1236
1446
  "uai-sizing-2xl": {
1237
- "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.",
1238
1448
  "type": "dimension",
1239
1449
  "collection": "Dimensions",
1240
1450
  "scopes": [
@@ -1242,8 +1452,17 @@ export const metadata = {
1242
1452
  ],
1243
1453
  "figmaVariableId": "VariableID:10:44"
1244
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
+ },
1245
1464
  "uai-sizing-3xl": {
1246
- "description": "Fixed size. 48px. Large avatars.",
1465
+ "description": "Fixed size 48px. Use: standard avatar.",
1247
1466
  "type": "dimension",
1248
1467
  "collection": "Dimensions",
1249
1468
  "scopes": [
@@ -1252,7 +1471,7 @@ export const metadata = {
1252
1471
  "figmaVariableId": "VariableID:10:45"
1253
1472
  },
1254
1473
  "uai-sizing-4xl": {
1255
- "description": "Fixed size. 64px. Extra large avatars.",
1474
+ "description": "Fixed size 64px. Use: large avatar.",
1256
1475
  "type": "dimension",
1257
1476
  "collection": "Dimensions",
1258
1477
  "scopes": [
@@ -1260,8 +1479,17 @@ export const metadata = {
1260
1479
  ],
1261
1480
  "figmaVariableId": "VariableID:10:46"
1262
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
+ },
1263
1491
  "uai-sizing-lg": {
1264
- "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.",
1265
1493
  "type": "dimension",
1266
1494
  "collection": "Dimensions",
1267
1495
  "scopes": [
@@ -1270,7 +1498,7 @@ export const metadata = {
1270
1498
  "figmaVariableId": "VariableID:10:42"
1271
1499
  },
1272
1500
  "uai-sizing-md": {
1273
- "description": "Fixed size. 20px. Icon small.",
1501
+ "description": "Fixed size 20px. Use: small icons (uai-icon size small), checkbox and radio controls.",
1274
1502
  "type": "dimension",
1275
1503
  "collection": "Dimensions",
1276
1504
  "scopes": [
@@ -1279,7 +1507,7 @@ export const metadata = {
1279
1507
  "figmaVariableId": "VariableID:10:41"
1280
1508
  },
1281
1509
  "uai-sizing-sm": {
1282
- "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.",
1283
1511
  "type": "dimension",
1284
1512
  "collection": "Dimensions",
1285
1513
  "scopes": [
@@ -1288,7 +1516,7 @@ export const metadata = {
1288
1516
  "figmaVariableId": "VariableID:10:40"
1289
1517
  },
1290
1518
  "uai-sizing-xl": {
1291
- "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.",
1292
1520
  "type": "dimension",
1293
1521
  "collection": "Dimensions",
1294
1522
  "scopes": [
@@ -1297,7 +1525,7 @@ export const metadata = {
1297
1525
  "figmaVariableId": "VariableID:10:43"
1298
1526
  },
1299
1527
  "uai-sizing-xs": {
1300
- "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/*.",
1301
1529
  "type": "dimension",
1302
1530
  "collection": "Dimensions",
1303
1531
  "scopes": [
@@ -1306,7 +1534,7 @@ export const metadata = {
1306
1534
  "figmaVariableId": "VariableID:10:39"
1307
1535
  },
1308
1536
  "uai-spacing-2xl": {
1309
- "description": "Spacing. 40px.",
1537
+ "description": "Spacing 40px. Layout spacing between large page regions. Avoid: control heights; use control-height/medium.",
1310
1538
  "type": "dimension",
1311
1539
  "collection": "Dimensions",
1312
1540
  "scopes": [
@@ -1315,7 +1543,7 @@ export const metadata = {
1315
1543
  "figmaVariableId": "VariableID:10:33"
1316
1544
  },
1317
1545
  "uai-spacing-2xs": {
1318
- "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.",
1319
1547
  "type": "dimension",
1320
1548
  "collection": "Dimensions",
1321
1549
  "scopes": [
@@ -1324,7 +1552,7 @@ export const metadata = {
1324
1552
  "figmaVariableId": "VariableID:10:27"
1325
1553
  },
1326
1554
  "uai-spacing-3xl": {
1327
- "description": "Spacing. 48px.",
1555
+ "description": "Spacing 48px. Layout spacing between large page regions.",
1328
1556
  "type": "dimension",
1329
1557
  "collection": "Dimensions",
1330
1558
  "scopes": [
@@ -1333,7 +1561,7 @@ export const metadata = {
1333
1561
  "figmaVariableId": "VariableID:10:34"
1334
1562
  },
1335
1563
  "uai-spacing-3xs": {
1336
- "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/*.",
1337
1565
  "type": "dimension",
1338
1566
  "collection": "Dimensions",
1339
1567
  "scopes": [
@@ -1342,7 +1570,7 @@ export const metadata = {
1342
1570
  "figmaVariableId": "VariableID:10:26"
1343
1571
  },
1344
1572
  "uai-spacing-4xl": {
1345
- "description": "Spacing. 56px.",
1573
+ "description": "Spacing 56px. Layout spacing for page margins and large regions. Avoid: control heights; use control-height/large.",
1346
1574
  "type": "dimension",
1347
1575
  "collection": "Dimensions",
1348
1576
  "scopes": [
@@ -1351,7 +1579,7 @@ export const metadata = {
1351
1579
  "figmaVariableId": "VariableID:10:35"
1352
1580
  },
1353
1581
  "uai-spacing-5xl": {
1354
- "description": "Spacing. 64px.",
1582
+ "description": "Spacing 64px. Layout spacing for page margins and large regions.",
1355
1583
  "type": "dimension",
1356
1584
  "collection": "Dimensions",
1357
1585
  "scopes": [
@@ -1360,7 +1588,7 @@ export const metadata = {
1360
1588
  "figmaVariableId": "VariableID:10:36"
1361
1589
  },
1362
1590
  "uai-spacing-6xl": {
1363
- "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.",
1364
1592
  "type": "dimension",
1365
1593
  "collection": "Dimensions",
1366
1594
  "scopes": [
@@ -1369,7 +1597,7 @@ export const metadata = {
1369
1597
  "figmaVariableId": "VariableID:144:634"
1370
1598
  },
1371
1599
  "uai-spacing-7xl": {
1372
- "description": "Spacing. 80px.",
1600
+ "description": "Spacing 80px. Layout spacing for page margins and hero areas.",
1373
1601
  "type": "dimension",
1374
1602
  "collection": "Dimensions",
1375
1603
  "scopes": [
@@ -1378,7 +1606,7 @@ export const metadata = {
1378
1606
  "figmaVariableId": "VariableID:10:37"
1379
1607
  },
1380
1608
  "uai-spacing-8xl": {
1381
- "description": "Spacing. 88px.",
1609
+ "description": "Spacing 88px. Layout spacing for page margins and hero areas.",
1382
1610
  "type": "dimension",
1383
1611
  "collection": "Dimensions",
1384
1612
  "scopes": [
@@ -1387,7 +1615,7 @@ export const metadata = {
1387
1615
  "figmaVariableId": "VariableID:144:635"
1388
1616
  },
1389
1617
  "uai-spacing-9xl": {
1390
- "description": "Spacing. 96px.",
1618
+ "description": "Spacing 96px. Largest layout spacing, for hero and landing areas.",
1391
1619
  "type": "dimension",
1392
1620
  "collection": "Dimensions",
1393
1621
  "scopes": [
@@ -1396,7 +1624,7 @@ export const metadata = {
1396
1624
  "figmaVariableId": "VariableID:10:38"
1397
1625
  },
1398
1626
  "uai-spacing-lg": {
1399
- "description": "Spacing. 24px.",
1627
+ "description": "Spacing 24px. Gap between groups of content and between navigation bar items (uai-navbar).",
1400
1628
  "type": "dimension",
1401
1629
  "collection": "Dimensions",
1402
1630
  "scopes": [
@@ -1405,7 +1633,7 @@ export const metadata = {
1405
1633
  "figmaVariableId": "VariableID:10:31"
1406
1634
  },
1407
1635
  "uai-spacing-md": {
1408
- "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.",
1409
1637
  "type": "dimension",
1410
1638
  "collection": "Dimensions",
1411
1639
  "scopes": [
@@ -1414,7 +1642,7 @@ export const metadata = {
1414
1642
  "figmaVariableId": "VariableID:10:30"
1415
1643
  },
1416
1644
  "uai-spacing-none": {
1417
- "description": "Spacing. 0px.",
1645
+ "description": "Spacing 0px. Use: removing gaps or padding explicitly.",
1418
1646
  "type": "dimension",
1419
1647
  "collection": "Dimensions",
1420
1648
  "scopes": [
@@ -1423,7 +1651,7 @@ export const metadata = {
1423
1651
  "figmaVariableId": "VariableID:10:25"
1424
1652
  },
1425
1653
  "uai-spacing-sm": {
1426
- "description": "Spacing. 12px.",
1654
+ "description": "Spacing 12px. Horizontal padding of buttons and other controls.",
1427
1655
  "type": "dimension",
1428
1656
  "collection": "Dimensions",
1429
1657
  "scopes": [
@@ -1432,7 +1660,7 @@ export const metadata = {
1432
1660
  "figmaVariableId": "VariableID:10:29"
1433
1661
  },
1434
1662
  "uai-spacing-xl": {
1435
- "description": "Spacing. 32px.",
1663
+ "description": "Spacing 32px. Layout spacing between page sections.",
1436
1664
  "type": "dimension",
1437
1665
  "collection": "Dimensions",
1438
1666
  "scopes": [
@@ -1441,7 +1669,7 @@ export const metadata = {
1441
1669
  "figmaVariableId": "VariableID:10:32"
1442
1670
  },
1443
1671
  "uai-spacing-xs": {
1444
- "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.",
1445
1673
  "type": "dimension",
1446
1674
  "collection": "Dimensions",
1447
1675
  "scopes": [
@@ -1449,8 +1677,198 @@ export const metadata = {
1449
1677
  ],
1450
1678
  "figmaVariableId": "VariableID:10:28"
1451
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
+ },
1452
1870
  "uai-body-base-font-size": {
1453
- "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.",
1454
1872
  "type": "dimension",
1455
1873
  "collection": "Typography",
1456
1874
  "scopes": [
@@ -1459,7 +1877,7 @@ export const metadata = {
1459
1877
  "figmaVariableId": "VariableID:2:241"
1460
1878
  },
1461
1879
  "uai-body-base-line-height": {
1462
- "description": "Body Base — 22px.",
1880
+ "description": "Body Base line height: 22px. Pair: body/base/font-size (14px).",
1463
1881
  "type": "dimension",
1464
1882
  "collection": "Typography",
1465
1883
  "scopes": [
@@ -1467,8 +1885,44 @@ export const metadata = {
1467
1885
  ],
1468
1886
  "figmaVariableId": "VariableID:2:242"
1469
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
+ },
1470
1924
  "uai-caption-font-size": {
1471
- "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.",
1472
1926
  "type": "dimension",
1473
1927
  "collection": "Typography",
1474
1928
  "scopes": [
@@ -1477,7 +1931,7 @@ export const metadata = {
1477
1931
  "figmaVariableId": "VariableID:2:247"
1478
1932
  },
1479
1933
  "uai-caption-line-height": {
1480
- "description": "Caption — 20px.",
1934
+ "description": "Caption line height: 20px. Pair: caption/font-size (12px).",
1481
1935
  "type": "dimension",
1482
1936
  "collection": "Typography",
1483
1937
  "scopes": [
@@ -1486,7 +1940,7 @@ export const metadata = {
1486
1940
  "figmaVariableId": "VariableID:2:248"
1487
1941
  },
1488
1942
  "uai-display-font-size": {
1489
- "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.",
1490
1944
  "type": "dimension",
1491
1945
  "collection": "Typography",
1492
1946
  "scopes": [
@@ -1495,7 +1949,7 @@ export const metadata = {
1495
1949
  "figmaVariableId": "VariableID:2:223"
1496
1950
  },
1497
1951
  "uai-display-line-height": {
1498
- "description": "Display — 48px.",
1952
+ "description": "Display line height: 48px. Pair: display/font-size (40px). Use only with display text.",
1499
1953
  "type": "dimension",
1500
1954
  "collection": "Typography",
1501
1955
  "scopes": [
@@ -1504,7 +1958,7 @@ export const metadata = {
1504
1958
  "figmaVariableId": "VariableID:2:224"
1505
1959
  },
1506
1960
  "uai-font-family-display": {
1507
- "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.",
1508
1962
  "type": "fontFamily",
1509
1963
  "collection": "Typography",
1510
1964
  "scopes": [
@@ -1513,7 +1967,7 @@ export const metadata = {
1513
1967
  "figmaVariableId": "VariableID:2:222"
1514
1968
  },
1515
1969
  "uai-font-family-sans": {
1516
- "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.",
1517
1971
  "type": "fontFamily",
1518
1972
  "collection": "Typography",
1519
1973
  "scopes": [
@@ -1522,7 +1976,7 @@ export const metadata = {
1522
1976
  "figmaVariableId": "VariableID:2:221"
1523
1977
  },
1524
1978
  "uai-font-weight-bold": {
1525
- "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.",
1526
1980
  "type": "fontWeight",
1527
1981
  "collection": "Typography",
1528
1982
  "scopes": [
@@ -1531,7 +1985,7 @@ export const metadata = {
1531
1985
  "figmaVariableId": "VariableID:2:257"
1532
1986
  },
1533
1987
  "uai-font-weight-extrabold": {
1534
- "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.",
1535
1989
  "type": "fontWeight",
1536
1990
  "collection": "Typography",
1537
1991
  "scopes": [
@@ -1540,7 +1994,7 @@ export const metadata = {
1540
1994
  "figmaVariableId": "VariableID:2:258"
1541
1995
  },
1542
1996
  "uai-font-weight-medium": {
1543
- "description": "Medium weight (500). Labels, buttons.",
1997
+ "description": "Font weight 500. Light emphasis: button labels, avatar initials and active navigation items.",
1544
1998
  "type": "fontWeight",
1545
1999
  "collection": "Typography",
1546
2000
  "scopes": [
@@ -1549,7 +2003,7 @@ export const metadata = {
1549
2003
  "figmaVariableId": "VariableID:2:255"
1550
2004
  },
1551
2005
  "uai-font-weight-regular": {
1552
- "description": "Regular weight (400). Default body text.",
2006
+ "description": "Font weight 400. Default for body text, input values and helper, error and success messages.",
1553
2007
  "type": "fontWeight",
1554
2008
  "collection": "Typography",
1555
2009
  "scopes": [
@@ -1558,7 +2012,7 @@ export const metadata = {
1558
2012
  "figmaVariableId": "VariableID:2:254"
1559
2013
  },
1560
2014
  "uai-font-weight-semibold": {
1561
- "description": "SemiBold weight (600). Subtitles, navigation.",
2015
+ "description": "Font weight 600. Emphasis for labels and titles: input labels (caption semibold), card and section titles.",
1562
2016
  "type": "fontWeight",
1563
2017
  "collection": "Typography",
1564
2018
  "scopes": [
@@ -1567,7 +2021,7 @@ export const metadata = {
1567
2021
  "figmaVariableId": "VariableID:2:256"
1568
2022
  },
1569
2023
  "uai-heading-lg-font-size": {
1570
- "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).",
1571
2025
  "type": "dimension",
1572
2026
  "collection": "Typography",
1573
2027
  "scopes": [
@@ -1576,7 +2030,7 @@ export const metadata = {
1576
2030
  "figmaVariableId": "VariableID:2:229"
1577
2031
  },
1578
2032
  "uai-heading-lg-line-height": {
1579
- "description": "Heading LG — 32px.",
2033
+ "description": "Heading LG line height: 32px. Pair: heading/lg/font-size (24px).",
1580
2034
  "type": "dimension",
1581
2035
  "collection": "Typography",
1582
2036
  "scopes": [
@@ -1585,7 +2039,7 @@ export const metadata = {
1585
2039
  "figmaVariableId": "VariableID:2:230"
1586
2040
  },
1587
2041
  "uai-heading-md-font-size": {
1588
- "description": "Heading MD — 20px. Subsections.",
2042
+ "description": "Heading MD font size: 20px. Use: subsection titles below heading/lg. Pair: heading/md/line-height (28px).",
1589
2043
  "type": "dimension",
1590
2044
  "collection": "Typography",
1591
2045
  "scopes": [
@@ -1594,7 +2048,7 @@ export const metadata = {
1594
2048
  "figmaVariableId": "VariableID:2:232"
1595
2049
  },
1596
2050
  "uai-heading-md-line-height": {
1597
- "description": "Heading MD — 28px.",
2051
+ "description": "Heading MD line height: 28px. Pair: heading/md/font-size (20px).",
1598
2052
  "type": "dimension",
1599
2053
  "collection": "Typography",
1600
2054
  "scopes": [
@@ -1603,7 +2057,7 @@ export const metadata = {
1603
2057
  "figmaVariableId": "VariableID:2:233"
1604
2058
  },
1605
2059
  "uai-heading-xl-font-size": {
1606
- "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.",
1607
2061
  "type": "dimension",
1608
2062
  "collection": "Typography",
1609
2063
  "scopes": [
@@ -1612,7 +2066,7 @@ export const metadata = {
1612
2066
  "figmaVariableId": "VariableID:2:226"
1613
2067
  },
1614
2068
  "uai-heading-xl-line-height": {
1615
- "description": "Heading XL — 40px.",
2069
+ "description": "Heading XL line height: 40px. Pair: heading/xl/font-size (32px).",
1616
2070
  "type": "dimension",
1617
2071
  "collection": "Typography",
1618
2072
  "scopes": [
@@ -1621,7 +2075,7 @@ export const metadata = {
1621
2075
  "figmaVariableId": "VariableID:2:227"
1622
2076
  },
1623
2077
  "uai-letter-spacing-expanded": {
1624
- "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.",
1625
2079
  "type": "dimension",
1626
2080
  "collection": "Typography",
1627
2081
  "scopes": [
@@ -1630,7 +2084,7 @@ export const metadata = {
1630
2084
  "figmaVariableId": "VariableID:2:261"
1631
2085
  },
1632
2086
  "uai-letter-spacing-normal": {
1633
- "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.",
1634
2088
  "type": "dimension",
1635
2089
  "collection": "Typography",
1636
2090
  "scopes": [
@@ -1639,7 +2093,7 @@ export const metadata = {
1639
2093
  "figmaVariableId": "VariableID:2:260"
1640
2094
  },
1641
2095
  "uai-overline-font-size": {
1642
- "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.",
1643
2097
  "type": "dimension",
1644
2098
  "collection": "Typography",
1645
2099
  "scopes": [
@@ -1648,7 +2102,7 @@ export const metadata = {
1648
2102
  "figmaVariableId": "VariableID:2:250"
1649
2103
  },
1650
2104
  "uai-overline-line-height": {
1651
- "description": "Overline — 16px.",
2105
+ "description": "Overline line height: 16px. Pair: overline/font-size (10px).",
1652
2106
  "type": "dimension",
1653
2107
  "collection": "Typography",
1654
2108
  "scopes": [
@@ -1657,7 +2111,7 @@ export const metadata = {
1657
2111
  "figmaVariableId": "VariableID:2:251"
1658
2112
  },
1659
2113
  "uai-title-font-size": {
1660
- "description": "Title — 16px. Card titles, strong labels, navigation. Use regular weight for large body text.",
2114
+ "description": "Title compatibility alias for title/md — 16px.",
1661
2115
  "type": "dimension",
1662
2116
  "collection": "Typography",
1663
2117
  "scopes": [
@@ -1665,13 +2119,67 @@ export const metadata = {
1665
2119
  ],
1666
2120
  "figmaVariableId": "VariableID:2:235"
1667
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
+ },
1668
2140
  "uai-title-line-height": {
1669
- "description": "Title — 24px.",
2141
+ "description": "Title compatibility alias for title/md — 24px.",
1670
2142
  "type": "dimension",
1671
2143
  "collection": "Typography",
1672
2144
  "scopes": [
1673
2145
  "LINE_HEIGHT"
1674
2146
  ],
1675
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"
1676
2184
  }
1677
2185
  };