blip-tokens 2.2.1 → 2.3.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/README.md CHANGED
@@ -147,15 +147,82 @@ references resolved to values so it has no dangling aliases. Descriptions,
147
147
  Figma scopes and variable IDs stay attached to each published semantic token.
148
148
  CSS custom properties include each token's Figma usage description as a
149
149
  comment. The legacy outputs remain available alongside them.
150
- The 305-variable count covers variable collections only: 206 Foundation
151
- primitives are internal, and 99 semantic variables are published. Separately,
150
+ The 306-variable count covers variable collections only: 206 Foundation
151
+ primitives are internal, and 100 semantic variables are published. Separately,
152
152
  the Figma file has eight elevation effect styles, published as variables, and
153
153
  28 text styles, published as metadata, without exposing Foundation primitives.
154
154
  There are no per-component color or typography tokens: components use the
155
155
  semantic tokens directly, so their names stay stable across light and dark modes.
156
156
 
157
+ ### Focus indicators
158
+
159
+ `border/ring` (`--uai-border-ring`) is a solid neutral focus color: dark in Light
160
+ mode and light in Dark mode, using the same Foundation aliases as `content/primary`.
161
+ It replaces the previous purple value without renaming the public token.
162
+ Consumers such as UaiButton keep a full-opacity focus outline.
163
+
164
+ For UaiInput, the focused control has two independent layers: a solid 1 px border
165
+ and a 2 px outer halo. Only the halo uses semantic `opacity/focus-ring`
166
+ (`--uai-opacity-focus-ring`, unitless `0.3`);
167
+ never reduce the opacity of the whole input or of every focus indicator.
168
+ The token lives in Dimensions: Figma opacity bindings require percentages, so
169
+ its source value is `30`, explicitly normalized to unitless `0.3` in DTCG,
170
+ CSS, SCSS and JavaScript outputs. Foundation's pre-existing fractional opacity
171
+ primitives remain private and unchanged. Do not invent a local opacity
172
+ value or reuse a pressed overlay for this role.
173
+ The halo is supplementary, not the only focus cue. Keep geometry tokenized,
174
+ avoid layout shifts, and verify focus contrast and forced-colors behavior in
175
+ the consuming component.
176
+
177
+ The halo maps directly to a zero-blur CSS shadow; it does not change the
178
+ control's box size:
179
+
180
+ ```css
181
+ .control[data-focused] {
182
+ border-color: var(--uai-border-ring);
183
+ box-shadow: 0 0 0 var(--uai-border-width-thick)
184
+ color-mix(in srgb, var(--uai-border-ring) calc(var(--uai-opacity-focus-ring) * 100%), transparent);
185
+ }
186
+
187
+ @media (forced-colors: active) {
188
+ .control[data-focused] {
189
+ box-shadow: none;
190
+ outline: var(--uai-border-width-thick) solid CanvasText;
191
+ outline-offset: var(--uai-border-width-default);
192
+ }
193
+ }
194
+ ```
195
+
196
+ The consumer tracks focus, not whether `value` is empty or typing is in progress.
197
+ Keep the normal border width and radius unchanged, and ensure that parent
198
+ containers do not clip the halo.
199
+
157
200
  ### Using the tokens in a component
158
201
 
202
+ #### Dark-mode contrast and action colors
203
+
204
+ The [dark-theme contrast and migration report](docs/dark-theme-contrast.md)
205
+ records the audited foreground/background pairs, changed values and consumer
206
+ impact. Dark text and feedback accents target **4.5:1** on the supported standard
207
+ surfaces; essential control borders and solid focus cues target **3:1**.
208
+ This is color-contrast coverage, not a claim of complete WCAG conformance.
209
+
210
+ - Use `feedback/*` for text/icons on standard or matching subtle surfaces, not
211
+ as a universal filled-button background.
212
+ - Filled positive actions pair `action/positive` with
213
+ `action/positive-foreground`. Filled destructive actions pair
214
+ `action/destructive` with `action/destructive-foreground`. Never assume
215
+ white text: both foregrounds are dark neutrals in Dark mode.
216
+ - `border/default` is decorative. Use `border/input` for an essential control
217
+ boundary and `border/ring` for focus.
218
+ - `fixed/brand` keeps its brand value; pair it with `fixed/dim`, not white.
219
+ Keep `fixed/bright` for supported dark backgrounds such as `fixed/dim` and
220
+ `fixed/blue`.
221
+ - Keep non-color cues for errors, links and selection. Disabled content is
222
+ exempt from contrast requirements; placeholders are not.
223
+ - Light placeholder, success and warning text have existing contrast gaps and
224
+ are outside this Dark correction. Do not infer Light compliance from this audit.
225
+
159
226
  The tokens are an internal contract of the blip-ds design system. Only blip-ds
160
227
  components read them. Micro frontends (MFEs) consume blip-ds components and do
161
228
  not import `blip-tokens` or use `var(--uai-*)`: spacing and layout come from the
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
- "version": "2.2.1",
3
+ "version": "2.3.0",
4
4
  "baseUrl": "https://cdn.blip.ai/blip-tokens/",
5
5
  "assets": {
6
6
  "asset-icon-123-outline": {
@@ -1,7 +1,7 @@
1
1
  :where([data-uai-theme="light"]) {
2
- /* Destructive button (delete, remove). Same red as feedback/error. */
2
+ /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
3
3
  --uai-action-destructive: #cf0022;
4
- /* Text and icons on destructive buttons. */
4
+ /* Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright. */
5
5
  --uai-action-destructive-foreground: #ffffff;
6
6
  /* Outline and text button background — default state. */
7
7
  --uai-action-outline-default: #ffffff;
@@ -9,6 +9,10 @@
9
9
  --uai-action-outline-hover: #f2f3f3;
10
10
  /* Outline and text button background — pressed state. Also selected list item. */
11
11
  --uai-action-outline-pressed: #e4e6e7;
12
+ /* Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead. */
13
+ --uai-action-positive: #047857;
14
+ /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
15
+ --uai-action-positive-foreground: #ffffff;
12
16
  /* Primary button background — default state. */
13
17
  --uai-action-primary-default: #242729;
14
18
  /* Text and icons on primary buttons. */
@@ -17,45 +21,45 @@
17
21
  --uai-action-primary-hover: #181a1b;
18
22
  /* Primary button background — pressed state. */
19
23
  --uai-action-primary-pressed: #0a0a0a;
20
- /* Default border. Cards, dividers, separators. */
24
+ /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
21
25
  --uai-border-default: #e4e6e7;
22
- /* Form control border. Inputs, selects, checkboxes, outline buttons. */
26
+ /* 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. */
23
27
  --uai-border-input: #adb4b8;
24
- /* Focus ring for keyboard navigation. */
25
- --uai-border-ring: #c084fc;
28
+ /* 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. */
29
+ --uai-border-ring: #242729;
26
30
  /* Disabled text and icons. */
27
31
  --uai-content-disabled: #848e94;
28
32
  /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
29
33
  --uai-content-inverse: #ffffff;
30
- /* Links and interactive navigation text. */
34
+ /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
31
35
  --uai-content-link: #0073e5;
32
- /* Input placeholder and hint text. Not for disabled content. */
36
+ /* 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. */
33
37
  --uai-content-placeholder: #adb4b8;
34
38
  /* Primary text and icons. Headings, body text, form labels. */
35
39
  --uai-content-primary: #242729;
36
40
  /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
37
41
  --uai-content-secondary: #5f676d;
38
- /* Error. Field errors, failures, destructive confirmations. Components call it "negative". */
42
+ /* 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. */
39
43
  --uai-feedback-error: #cf0022;
40
44
  /* Error alert background. Pair with feedback/error for the icon. */
41
45
  --uai-feedback-error-subtle: #fef2f2;
42
- /* Information. Info alerts, status badges and icons. */
46
+ /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
43
47
  --uai-feedback-info: #0073e5;
44
48
  /* Info alert background. Pair with feedback/info for the icon. */
45
49
  --uai-feedback-info-subtle: #eff6ff;
46
- /* Success. Confirmations, positive validation, completed states. Components call it "positive". */
50
+ /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
47
51
  --uai-feedback-success: #3da329;
48
52
  /* Success alert background. Pair with feedback/success for the icon. */
49
53
  --uai-feedback-success-subtle: #ecfdf5;
50
- /* Warning. States that need attention. For text on light surfaces, check contrast. */
54
+ /* Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background. */
51
55
  --uai-feedback-warning: #ff8000;
52
56
  /* Warning alert background. Pair with feedback/warning for the icon. */
53
57
  --uai-feedback-warning-subtle: #fff7ed;
54
- /* Blip blue that does not change with the theme. Selected states and highlights. */
58
+ /* Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface. */
55
59
  --uai-fixed-blue: #1e6bf1;
56
- /* Product brand color. Changes per product, not per theme. Banners, highlights. */
60
+ /* 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. */
57
61
  --uai-fixed-brand: #0099ff;
58
- /* Light color that does not change with the theme. Text on fixed/brand. */
62
+ /* 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. */
59
63
  --uai-fixed-bright: #ffffff;
60
64
  /* Dark color that does not change with the theme. */
61
65
  --uai-fixed-dim: #242729;
@@ -81,16 +85,20 @@
81
85
  }
82
86
 
83
87
  :where([data-uai-theme="dark"]) {
84
- /* Destructive button (delete, remove). Same red as feedback/error. */
85
- --uai-action-destructive: #cf0022;
86
- /* Text and icons on destructive buttons. */
87
- --uai-action-destructive-foreground: #ffffff;
88
+ /* Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces. */
89
+ --uai-action-destructive: #fca5a5;
90
+ /* Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright. */
91
+ --uai-action-destructive-foreground: #181a1b;
88
92
  /* Outline and text button background — default state. */
89
93
  --uai-action-outline-default: #242729;
90
94
  /* Outline and text button background — hover state. Also list item hover. */
91
95
  --uai-action-outline-hover: #2f3437;
92
96
  /* Outline and text button background — pressed state. Also selected list item. */
93
97
  --uai-action-outline-pressed: #3b4144;
98
+ /* Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead. */
99
+ --uai-action-positive: #35de90;
100
+ /* Text and icons on action/positive. Theme-aware foreground for filled positive buttons. */
101
+ --uai-action-positive-foreground: #181a1b;
94
102
  /* Primary button background — default state. */
95
103
  --uai-action-primary-default: #e4e6e7;
96
104
  /* Text and icons on primary buttons. */
@@ -99,45 +107,45 @@
99
107
  --uai-action-primary-hover: #d6d9db;
100
108
  /* Primary button background — pressed state. */
101
109
  --uai-action-primary-pressed: #c8cccf;
102
- /* Default border. Cards, dividers, separators. */
110
+ /* Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring. */
103
111
  --uai-border-default: #2f3437;
104
- /* Form control border. Inputs, selects, checkboxes, outline buttons. */
105
- --uai-border-input: #5f676d;
106
- /* Focus ring for keyboard navigation. */
107
- --uai-border-ring: #c084fc;
112
+ /* 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. */
113
+ --uai-border-input: #848e94;
114
+ /* 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. */
115
+ --uai-border-ring: #ffffff;
108
116
  /* Disabled text and icons. */
109
117
  --uai-content-disabled: #768188;
110
118
  /* Text and icons on inverse or dark surfaces, such as surface/inverse and action/primary. */
111
119
  --uai-content-inverse: #181a1b;
112
- /* Links and interactive navigation text. */
113
- --uai-content-link: #0099ff;
114
- /* Input placeholder and hint text. Not for disabled content. */
115
- --uai-content-placeholder: #768188;
120
+ /* Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text. */
121
+ --uai-content-link: #93c5fd;
122
+ /* 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. */
123
+ --uai-content-placeholder: #adb4b8;
116
124
  /* Primary text and icons. Headings, body text, form labels. */
117
125
  --uai-content-primary: #ffffff;
118
126
  /* Secondary text and icons. Descriptions, supporting text, text on muted surfaces. */
119
127
  --uai-content-secondary: #adb4b8;
120
- /* Error. Field errors, failures, destructive confirmations. Components call it "negative". */
121
- --uai-feedback-error: #cf0022;
128
+ /* 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. */
129
+ --uai-feedback-error: #fca5a5;
122
130
  /* Error alert background. Pair with feedback/error for the icon. */
123
131
  --uai-feedback-error-subtle: #450a0a;
124
- /* Information. Info alerts, status badges and icons. */
125
- --uai-feedback-info: #0073e5;
132
+ /* Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background. */
133
+ --uai-feedback-info: #93c5fd;
126
134
  /* Info alert background. Pair with feedback/info for the icon. */
127
135
  --uai-feedback-info-subtle: #072563;
128
- /* Success. Confirmations, positive validation, completed states. Components call it "positive". */
129
- --uai-feedback-success: #3da329;
136
+ /* Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons. */
137
+ --uai-feedback-success: #35de90;
130
138
  /* Success alert background. Pair with feedback/success for the icon. */
131
139
  --uai-feedback-success-subtle: #022c22;
132
- /* Warning. States that need attention. For text on light surfaces, check contrast. */
133
- --uai-feedback-warning: #ff8000;
140
+ /* Warning text and icons on standard surfaces or feedback/warning-subtle. Light-mode text still requires a contrast check. Not a filled button background. */
141
+ --uai-feedback-warning: #fb923c;
134
142
  /* Warning alert background. Pair with feedback/warning for the icon. */
135
143
  --uai-feedback-warning-subtle: #431407;
136
- /* Blip blue that does not change with the theme. Selected states and highlights. */
144
+ /* Fixed Blip blue. Pair with fixed/bright for text on it. Do not use it as the sole selected-state boundary on every surface. */
137
145
  --uai-fixed-blue: #1e6bf1;
138
- /* Product brand color. Changes per product, not per theme. Banners, highlights. */
146
+ /* 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. */
139
147
  --uai-fixed-brand: #0099ff;
140
- /* Light color that does not change with the theme. Text on fixed/brand. */
148
+ /* 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. */
141
149
  --uai-fixed-bright: #ffffff;
142
150
  /* Dark color that does not change with the theme. */
143
151
  --uai-fixed-dim: #242729;
@@ -5,6 +5,8 @@
5
5
  --uai-border-width-none: 0px;
6
6
  /* Border width. 2px. Focus rings and emphasis borders. */
7
7
  --uai-border-width-thick: 2px;
8
+ /* 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. */
9
+ --uai-opacity-focus-ring: 0.3;
8
10
  /* Border radius. 24px. */
9
11
  --uai-radius-2xl: 1.5rem;
10
12
  /* Border radius. Full round. */
@@ -3,7 +3,7 @@
3
3
  "action": {
4
4
  "destructive": {
5
5
  "$type": "color",
6
- "$description": "Destructive button (delete, remove). Same red as feedback/error.",
6
+ "$description": "Destructive action accent. Filled buttons must use action/destructive-foreground, never fixed/bright. Outline/text actions use this accent on standard surfaces.",
7
7
  "$extensions": {
8
8
  "com.blip.figma": {
9
9
  "variableId": "VariableID:2:290",
@@ -20,16 +20,16 @@
20
20
  "$value": {
21
21
  "colorSpace": "srgb",
22
22
  "components": [
23
- 0.811765,
24
- 0,
25
- 0.133333
23
+ 0.988235,
24
+ 0.647059,
25
+ 0.647059
26
26
  ],
27
27
  "alpha": 1
28
28
  }
29
29
  },
30
30
  "destructive-foreground": {
31
31
  "$type": "color",
32
- "$description": "Text and icons on destructive buttons.",
32
+ "$description": "Text and icons on action/destructive. Theme-aware: white in Light, dark neutral in Dark. Do not replace with fixed/bright.",
33
33
  "$extensions": {
34
34
  "com.blip.figma": {
35
35
  "variableId": "VariableID:2:291",
@@ -45,9 +45,9 @@
45
45
  "$value": {
46
46
  "colorSpace": "srgb",
47
47
  "components": [
48
- 1,
49
- 1,
50
- 1
48
+ 0.094118,
49
+ 0.101961,
50
+ 0.105882
51
51
  ],
52
52
  "alpha": 1
53
53
  }
@@ -126,6 +126,55 @@
126
126
  }
127
127
  }
128
128
  },
129
+ "positive": {
130
+ "$type": "color",
131
+ "$description": "Filled positive button background. Always pair with action/positive-foreground, never fixed/bright. Feedback text and outline/text actions use feedback/success instead.",
132
+ "$extensions": {
133
+ "com.blip.figma": {
134
+ "variableId": "VariableID:202:2",
135
+ "collectionId": "VariableCollectionId:2:262",
136
+ "collection": "Colors",
137
+ "scopes": [
138
+ "FRAME_FILL",
139
+ "SHAPE_FILL",
140
+ "STROKE_COLOR"
141
+ ]
142
+ }
143
+ },
144
+ "$value": {
145
+ "colorSpace": "srgb",
146
+ "components": [
147
+ 0.207843,
148
+ 0.870588,
149
+ 0.564706
150
+ ],
151
+ "alpha": 1
152
+ }
153
+ },
154
+ "positive-foreground": {
155
+ "$type": "color",
156
+ "$description": "Text and icons on action/positive. Theme-aware foreground for filled positive buttons.",
157
+ "$extensions": {
158
+ "com.blip.figma": {
159
+ "variableId": "VariableID:202:3",
160
+ "collectionId": "VariableCollectionId:2:262",
161
+ "collection": "Colors",
162
+ "scopes": [
163
+ "SHAPE_FILL",
164
+ "TEXT_FILL"
165
+ ]
166
+ }
167
+ },
168
+ "$value": {
169
+ "colorSpace": "srgb",
170
+ "components": [
171
+ 0.094118,
172
+ 0.101961,
173
+ 0.105882
174
+ ],
175
+ "alpha": 1
176
+ }
177
+ },
129
178
  "primary": {
130
179
  "default": {
131
180
  "$type": "color",
@@ -229,7 +278,7 @@
229
278
  "border": {
230
279
  "default": {
231
280
  "$type": "color",
232
- "$description": "Default border. Cards, dividers, separators.",
281
+ "$description": "Decorative cards, dividers and separators. Not an accessible control boundary or sole state indicator; use border/input or border/ring.",
233
282
  "$extensions": {
234
283
  "com.blip.figma": {
235
284
  "variableId": "VariableID:2:296",
@@ -252,7 +301,7 @@
252
301
  },
253
302
  "input": {
254
303
  "$type": "color",
255
- "$description": "Form control border. Inputs, selects, checkboxes, outline buttons.",
304
+ "$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.",
256
305
  "$extensions": {
257
306
  "com.blip.figma": {
258
307
  "variableId": "VariableID:2:297",
@@ -266,16 +315,16 @@
266
315
  "$value": {
267
316
  "colorSpace": "srgb",
268
317
  "components": [
269
- 0.372549,
270
- 0.403922,
271
- 0.427451
318
+ 0.517647,
319
+ 0.556863,
320
+ 0.580392
272
321
  ],
273
322
  "alpha": 1
274
323
  }
275
324
  },
276
325
  "ring": {
277
326
  "$type": "color",
278
- "$description": "Focus ring for keyboard navigation.",
327
+ "$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.",
279
328
  "$extensions": {
280
329
  "com.blip.figma": {
281
330
  "variableId": "VariableID:2:298",
@@ -289,9 +338,9 @@
289
338
  "$value": {
290
339
  "colorSpace": "srgb",
291
340
  "components": [
292
- 0.752941,
293
- 0.517647,
294
- 0.988235
341
+ 1,
342
+ 1,
343
+ 1
295
344
  ],
296
345
  "alpha": 1
297
346
  }
@@ -350,7 +399,7 @@
350
399
  },
351
400
  "link": {
352
401
  "$type": "color",
353
- "$description": "Links and interactive navigation text.",
402
+ "$description": "Links and interactive navigation text on standard surfaces. Keep an underline or another non-color cue when embedded in body text.",
354
403
  "$extensions": {
355
404
  "com.blip.figma": {
356
405
  "variableId": "VariableID:2:280",
@@ -366,16 +415,16 @@
366
415
  "$value": {
367
416
  "colorSpace": "srgb",
368
417
  "components": [
369
- 0,
370
- 0.6,
371
- 1
418
+ 0.576471,
419
+ 0.772549,
420
+ 0.992157
372
421
  ],
373
422
  "alpha": 1
374
423
  }
375
424
  },
376
425
  "placeholder": {
377
426
  "$type": "color",
378
- "$description": "Input placeholder and hint text. Not for disabled content.",
427
+ "$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.",
379
428
  "$extensions": {
380
429
  "com.blip.figma": {
381
430
  "variableId": "VariableID:2:281",
@@ -391,9 +440,9 @@
391
440
  "$value": {
392
441
  "colorSpace": "srgb",
393
442
  "components": [
394
- 0.462745,
395
- 0.505882,
396
- 0.533333
443
+ 0.678431,
444
+ 0.705882,
445
+ 0.721569
397
446
  ],
398
447
  "alpha": 1
399
448
  }
@@ -452,7 +501,7 @@
452
501
  "feedback": {
453
502
  "error": {
454
503
  "$type": "color",
455
- "$description": "Error. Field errors, failures, destructive confirmations. Components call it "negative".",
504
+ "$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.",
456
505
  "$extensions": {
457
506
  "com.blip.figma": {
458
507
  "variableId": "VariableID:2:303",
@@ -469,9 +518,9 @@
469
518
  "$value": {
470
519
  "colorSpace": "srgb",
471
520
  "components": [
472
- 0.811765,
473
- 0,
474
- 0.133333
521
+ 0.988235,
522
+ 0.647059,
523
+ 0.647059
475
524
  ],
476
525
  "alpha": 1
477
526
  }
@@ -502,7 +551,7 @@
502
551
  },
503
552
  "info": {
504
553
  "$type": "color",
505
- "$description": "Information. Info alerts, status badges and icons.",
554
+ "$description": "Information text and icons on standard surfaces or feedback/info-subtle. Not a filled button background.",
506
555
  "$extensions": {
507
556
  "com.blip.figma": {
508
557
  "variableId": "VariableID:2:300",
@@ -519,9 +568,9 @@
519
568
  "$value": {
520
569
  "colorSpace": "srgb",
521
570
  "components": [
522
- 0,
523
- 0.45098,
524
- 0.898039
571
+ 0.576471,
572
+ 0.772549,
573
+ 0.992157
525
574
  ],
526
575
  "alpha": 1
527
576
  }
@@ -552,7 +601,7 @@
552
601
  },
553
602
  "success": {
554
603
  "$type": "color",
555
- "$description": "Success. Confirmations, positive validation, completed states. Components call it "positive".",
604
+ "$description": "Success text and icons on standard surfaces or feedback/success-subtle. Use action/positive with action/positive-foreground for filled positive buttons.",
556
605
  "$extensions": {
557
606
  "com.blip.figma": {
558
607
  "variableId": "VariableID:2:301",
@@ -569,9 +618,9 @@
569
618
  "$value": {
570
619
  "colorSpace": "srgb",
571
620
  "components": [
572
- 0.239216,
573
- 0.639216,
574
- 0.160784
621
+ 0.207843,
622
+ 0.870588,
623
+ 0.564706
575
624
  ],
576
625
  "alpha": 1
577
626
  }
@@ -602,7 +651,7 @@
602
651
  },
603
652
  "warning": {
604
653
  "$type": "color",
605
- "$description": "Warning. States that need attention. For text on light surfaces, check contrast.",
654
+ "$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.",
606
655
  "$extensions": {
607
656
  "com.blip.figma": {
608
657
  "variableId": "VariableID:2:302",
@@ -619,9 +668,9 @@
619
668
  "$value": {
620
669
  "colorSpace": "srgb",
621
670
  "components": [
622
- 1,
623
- 0.501961,
624
- 0
671
+ 0.984314,
672
+ 0.572549,
673
+ 0.235294
625
674
  ],
626
675
  "alpha": 1
627
676
  }
@@ -654,7 +703,7 @@
654
703
  "fixed": {
655
704
  "blue": {
656
705
  "$type": "color",
657
- "$description": "Blip blue that does not change with the theme. Selected states and highlights.",
706
+ "$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.",
658
707
  "$extensions": {
659
708
  "com.blip.figma": {
660
709
  "variableId": "VariableID:2:315",
@@ -680,7 +729,7 @@
680
729
  },
681
730
  "brand": {
682
731
  "$type": "color",
683
- "$description": "Product brand color. Changes per product, not per theme. Banners, highlights.",
732
+ "$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.",
684
733
  "$extensions": {
685
734
  "com.blip.figma": {
686
735
  "variableId": "VariableID:2:316",
@@ -706,7 +755,7 @@
706
755
  },
707
756
  "bright": {
708
757
  "$type": "color",
709
- "$description": "Light color that does not change with the theme. Text on fixed/brand.",
758
+ "$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.",
710
759
  "$extensions": {
711
760
  "com.blip.figma": {
712
761
  "variableId": "VariableID:2:314",
@@ -1035,6 +1084,23 @@
1035
1084
  }
1036
1085
  }
1037
1086
  },
1087
+ "opacity": {
1088
+ "focus-ring": {
1089
+ "$type": "number",
1090
+ "$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.",
1091
+ "$extensions": {
1092
+ "com.blip.figma": {
1093
+ "variableId": "VariableID:192:2",
1094
+ "collectionId": "VariableCollectionId:10:16",
1095
+ "collection": "Dimensions",
1096
+ "scopes": [
1097
+ "OPACITY"
1098
+ ]
1099
+ }
1100
+ },
1101
+ "$value": 0.3
1102
+ }
1103
+ },
1038
1104
  "radius": {
1039
1105
  "2xl": {
1040
1106
  "$type": "dimension",