@med-o/design-tokens 0.4.1 → 0.5.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
@@ -48,6 +48,27 @@ Light and Dark follow the operating system. Force a theme with `data-theme="ligh
48
48
  | `@med-o/design-tokens/js` | Resolved values and TypeScript types |
49
49
  | `@med-o/design-tokens/src/*` | Source tokens in the DTCG format |
50
50
 
51
+ ## Spacing rules
52
+
53
+ The space between elements comes from one of six rules, never from a free number. The values follow the layout mode (px):
54
+
55
+ | Rule | Use for | Mobile · Tablet · Desktop |
56
+ | --- | --- | --- |
57
+ | `inline` | side by side in one group: buttons, tags, filters | 8 |
58
+ | `content` | inside one block: heading, text, actions | 16 |
59
+ | `fields` | form fields below each other | 16 · 24 · 24 |
60
+ | `items` | cards and tiles in a grid or list (= gutter) | 16 · 24 · 24 |
61
+ | `group` | groups inside a section: sub-sections, fieldsets | 32 · 40 · 48 |
62
+ | `section` | sections of a page | 48 · 64 · 96 |
63
+
64
+ Use them as CSS variables (`--medo-layout-gap-items`), as classes (`medo-gap-items`) or in Tailwind (`gap-items`, `space-y-fields`, `py-section`). With [`@med-o/ui`](https://www.npmjs.com/package/@med-o/ui) the layout components `Stack`, `Grid` and `Container` apply them for you.
65
+
66
+ ## Versions
67
+
68
+ While the package is 0.x, a patch only fixes bugs and a minor may contain breaking changes – each marked **Breaking:** in the changelog, with how to update. `@med-o/design-tokens` and `@med-o/ui` are always released together with the same version.
69
+
70
+ [What's new](https://design.med-o.de/?path=/docs/what-s-new--docs) · [Versioning & support](https://design.med-o.de/?path=/docs/guides-versioning-support--docs)
71
+
51
72
  ## License
52
73
 
53
74
  MIT
@@ -310,6 +310,7 @@
310
310
  --medo-container-xl: 1280px;
311
311
  --medo-font-family-sans: 'DM Sans', system-ui, sans-serif;
312
312
  --medo-font-family-mono: 'DM Mono', ui-monospace, monospace;
313
+ --medo-font-size-2xs: 0.6875rem;
313
314
  --medo-font-size-xs: 0.75rem;
314
315
  --medo-font-size-sm: 0.875rem;
315
316
  --medo-font-size-base: 1rem;
@@ -355,7 +356,7 @@
355
356
  --medo-typography-label-md-strong: var(--medo-font-weight-bold) var(--medo-font-size-sm)/1.4286 var(--medo-font-family-sans);
356
357
  --medo-typography-label-sm: var(--medo-font-weight-medium) var(--medo-font-size-xs)/1.3333 var(--medo-font-family-sans);
357
358
  --medo-typography-label-sm-strong: var(--medo-font-weight-bold) var(--medo-font-size-xs)/1.3333 var(--medo-font-family-sans);
358
- --medo-typography-label-xs: var(--medo-font-weight-medium) 0.6875rem/1.4545 var(--medo-font-family-sans);
359
+ --medo-typography-label-xs: var(--medo-font-weight-medium) var(--medo-font-size-2xs)/1.4545 var(--medo-font-family-sans);
359
360
  --medo-typography-caption: var(--medo-font-weight-regular) var(--medo-font-size-xs)/1.3333 var(--medo-font-family-sans);
360
361
  --medo-typography-overline: var(--medo-font-weight-semibold) var(--medo-font-size-xs)/1.3333 var(--medo-font-family-sans);
361
362
  --medo-typography-code-md: var(--medo-font-weight-regular) var(--medo-font-size-sm)/1.4286 var(--medo-font-family-mono);
@@ -159,7 +159,7 @@
159
159
  /* label/xs */
160
160
  .medo-text-label-xs {
161
161
  font-family: var(--medo-font-family-sans);
162
- font-size: 0.6875rem;
162
+ font-size: var(--medo-font-size-2xs);
163
163
  font-weight: var(--medo-font-weight-medium);
164
164
  line-height: 1.4545;
165
165
  letter-spacing: var(--medo-font-tracking-normal);
@@ -0,0 +1,525 @@
1
+ {
2
+ "min": 4.5,
3
+ "groups": [
4
+ {
5
+ "name": "Content surfaces",
6
+ "use": "Pages, cards, panels, inputs, selected rows.",
7
+ "pairs": [
8
+ {
9
+ "surface": "surface/canvas",
10
+ "text": "text/primary",
11
+ "contrast": {
12
+ "light": 17.04,
13
+ "dark": 19.27
14
+ }
15
+ },
16
+ {
17
+ "surface": "surface/canvas",
18
+ "text": "text/secondary",
19
+ "contrast": {
20
+ "light": 7.25,
21
+ "dark": 7.66
22
+ }
23
+ },
24
+ {
25
+ "surface": "surface/canvas",
26
+ "text": "text/brand",
27
+ "contrast": {
28
+ "light": 9.36,
29
+ "dark": 9.65
30
+ }
31
+ },
32
+ {
33
+ "surface": "surface/canvas",
34
+ "text": "text/brand-hover",
35
+ "contrast": {
36
+ "light": 11.98,
37
+ "dark": 13.23
38
+ }
39
+ },
40
+ {
41
+ "surface": "surface/canvas",
42
+ "text": "text/brand-pressed",
43
+ "contrast": {
44
+ "light": 14.63,
45
+ "dark": 16.69
46
+ }
47
+ },
48
+ {
49
+ "surface": "surface/canvas",
50
+ "text": "text/danger",
51
+ "contrast": {
52
+ "light": 6.14,
53
+ "dark": 6.98
54
+ }
55
+ },
56
+ {
57
+ "surface": "surface/default",
58
+ "text": "text/primary",
59
+ "contrast": {
60
+ "light": 17.83,
61
+ "dark": 17.04
62
+ }
63
+ },
64
+ {
65
+ "surface": "surface/default",
66
+ "text": "text/secondary",
67
+ "contrast": {
68
+ "light": 7.58,
69
+ "dark": 6.78
70
+ }
71
+ },
72
+ {
73
+ "surface": "surface/default",
74
+ "text": "text/brand",
75
+ "contrast": {
76
+ "light": 9.79,
77
+ "dark": 8.54
78
+ }
79
+ },
80
+ {
81
+ "surface": "surface/default",
82
+ "text": "text/brand-hover",
83
+ "contrast": {
84
+ "light": 12.54,
85
+ "dark": 11.7
86
+ }
87
+ },
88
+ {
89
+ "surface": "surface/default",
90
+ "text": "text/brand-pressed",
91
+ "contrast": {
92
+ "light": 15.3,
93
+ "dark": 14.76
94
+ }
95
+ },
96
+ {
97
+ "surface": "surface/default",
98
+ "text": "text/danger",
99
+ "contrast": {
100
+ "light": 6.42,
101
+ "dark": 6.17
102
+ }
103
+ },
104
+ {
105
+ "surface": "surface/raised",
106
+ "text": "text/primary",
107
+ "contrast": {
108
+ "light": 17.83,
109
+ "dark": 13.97
110
+ }
111
+ },
112
+ {
113
+ "surface": "surface/raised",
114
+ "text": "text/secondary",
115
+ "contrast": {
116
+ "light": 7.58,
117
+ "dark": 5.56
118
+ }
119
+ },
120
+ {
121
+ "surface": "surface/raised",
122
+ "text": "text/brand",
123
+ "contrast": {
124
+ "light": 9.79,
125
+ "dark": 7
126
+ }
127
+ },
128
+ {
129
+ "surface": "surface/raised",
130
+ "text": "text/brand-hover",
131
+ "contrast": {
132
+ "light": 12.54,
133
+ "dark": 9.59
134
+ }
135
+ },
136
+ {
137
+ "surface": "surface/raised",
138
+ "text": "text/brand-pressed",
139
+ "contrast": {
140
+ "light": 15.3,
141
+ "dark": 12.1
142
+ }
143
+ },
144
+ {
145
+ "surface": "surface/raised",
146
+ "text": "text/danger",
147
+ "contrast": {
148
+ "light": 6.42,
149
+ "dark": 5.06
150
+ }
151
+ },
152
+ {
153
+ "surface": "surface/subtle",
154
+ "text": "text/primary",
155
+ "contrast": {
156
+ "light": 16.28,
157
+ "dark": 13.97
158
+ }
159
+ },
160
+ {
161
+ "surface": "surface/subtle",
162
+ "text": "text/secondary",
163
+ "contrast": {
164
+ "light": 6.92,
165
+ "dark": 5.56
166
+ }
167
+ },
168
+ {
169
+ "surface": "surface/subtle",
170
+ "text": "text/brand",
171
+ "contrast": {
172
+ "light": 8.94,
173
+ "dark": 7
174
+ }
175
+ },
176
+ {
177
+ "surface": "surface/subtle",
178
+ "text": "text/brand-hover",
179
+ "contrast": {
180
+ "light": 11.44,
181
+ "dark": 9.59
182
+ }
183
+ },
184
+ {
185
+ "surface": "surface/subtle",
186
+ "text": "text/brand-pressed",
187
+ "contrast": {
188
+ "light": 13.97,
189
+ "dark": 12.1
190
+ }
191
+ },
192
+ {
193
+ "surface": "surface/subtle",
194
+ "text": "text/danger",
195
+ "contrast": {
196
+ "light": 5.86,
197
+ "dark": 5.06
198
+ }
199
+ },
200
+ {
201
+ "surface": "surface/brand-subtle",
202
+ "text": "text/primary",
203
+ "contrast": {
204
+ "light": 16.34,
205
+ "dark": 17.86
206
+ }
207
+ },
208
+ {
209
+ "surface": "surface/brand-subtle",
210
+ "text": "text/secondary",
211
+ "contrast": {
212
+ "light": 6.95,
213
+ "dark": 7.11
214
+ }
215
+ },
216
+ {
217
+ "surface": "surface/brand-subtle",
218
+ "text": "text/brand",
219
+ "contrast": {
220
+ "light": 8.97,
221
+ "dark": 8.95
222
+ }
223
+ },
224
+ {
225
+ "surface": "surface/brand-subtle",
226
+ "text": "text/brand-hover",
227
+ "contrast": {
228
+ "light": 11.49,
229
+ "dark": 12.27
230
+ }
231
+ },
232
+ {
233
+ "surface": "surface/brand-subtle",
234
+ "text": "text/brand-pressed",
235
+ "contrast": {
236
+ "light": 14.02,
237
+ "dark": 15.48
238
+ }
239
+ },
240
+ {
241
+ "surface": "surface/brand-subtle",
242
+ "text": "text/danger",
243
+ "contrast": {
244
+ "light": 5.88,
245
+ "dark": 6.47
246
+ }
247
+ },
248
+ {
249
+ "surface": "surface/brand-muted",
250
+ "text": "text/primary",
251
+ "contrast": {
252
+ "light": 14.76,
253
+ "dark": 14.63
254
+ }
255
+ },
256
+ {
257
+ "surface": "surface/brand-muted",
258
+ "text": "text/secondary",
259
+ "contrast": {
260
+ "light": 6.28,
261
+ "dark": 5.82
262
+ }
263
+ },
264
+ {
265
+ "surface": "surface/brand-muted",
266
+ "text": "text/brand",
267
+ "contrast": {
268
+ "light": 8.11,
269
+ "dark": 7.33
270
+ }
271
+ },
272
+ {
273
+ "surface": "surface/brand-muted",
274
+ "text": "text/brand-hover",
275
+ "contrast": {
276
+ "light": 10.38,
277
+ "dark": 10.04
278
+ }
279
+ },
280
+ {
281
+ "surface": "surface/brand-muted",
282
+ "text": "text/brand-pressed",
283
+ "contrast": {
284
+ "light": 12.67,
285
+ "dark": 12.67
286
+ }
287
+ },
288
+ {
289
+ "surface": "surface/brand-muted",
290
+ "text": "text/danger",
291
+ "contrast": {
292
+ "light": 5.32,
293
+ "dark": 5.3
294
+ }
295
+ }
296
+ ]
297
+ },
298
+ {
299
+ "name": "Brand surface",
300
+ "use": "Bold brand areas: hero, banner, highlighted plan.",
301
+ "pairs": [
302
+ {
303
+ "surface": "surface/brand-bold",
304
+ "text": "text/on-brand",
305
+ "contrast": {
306
+ "light": 7.6,
307
+ "dark": 9.79
308
+ }
309
+ },
310
+ {
311
+ "surface": "surface/brand-bold",
312
+ "text": "text/on-brand-secondary",
313
+ "contrast": {
314
+ "light": 6.29,
315
+ "dark": 8.11
316
+ }
317
+ }
318
+ ]
319
+ },
320
+ {
321
+ "name": "Inverse surface",
322
+ "use": "Tooltips, snackbars, dark areas in the light theme and vice versa.",
323
+ "pairs": [
324
+ {
325
+ "surface": "surface/inverse",
326
+ "text": "text/inverse",
327
+ "contrast": {
328
+ "light": 17.83,
329
+ "dark": 16.28
330
+ }
331
+ },
332
+ {
333
+ "surface": "surface/inverse",
334
+ "text": "text/inverse-secondary",
335
+ "contrast": {
336
+ "light": 6.78,
337
+ "dark": 6.92
338
+ }
339
+ }
340
+ ]
341
+ },
342
+ {
343
+ "name": "Filled actions",
344
+ "use": "Primary and danger buttons in every state.",
345
+ "pairs": [
346
+ {
347
+ "surface": "action/primary",
348
+ "text": "text/on-action",
349
+ "contrast": {
350
+ "light": 7.6,
351
+ "dark": 6.09
352
+ }
353
+ },
354
+ {
355
+ "surface": "action/primary-hover",
356
+ "text": "text/on-action",
357
+ "contrast": {
358
+ "light": 9.79,
359
+ "dark": 9.65
360
+ }
361
+ },
362
+ {
363
+ "surface": "action/primary-pressed",
364
+ "text": "text/on-action",
365
+ "contrast": {
366
+ "light": 12.54,
367
+ "dark": 13.23
368
+ }
369
+ }
370
+ ]
371
+ },
372
+ {
373
+ "name": "Filled danger actions",
374
+ "use": "Danger buttons in every state.",
375
+ "pairs": [
376
+ {
377
+ "surface": "action/danger",
378
+ "text": "text/on-danger",
379
+ "contrast": {
380
+ "light": 4.77,
381
+ "dark": 4.77
382
+ }
383
+ },
384
+ {
385
+ "surface": "action/danger-hover",
386
+ "text": "text/on-danger",
387
+ "contrast": {
388
+ "light": 6.42,
389
+ "dark": 6.42
390
+ }
391
+ },
392
+ {
393
+ "surface": "action/danger-pressed",
394
+ "text": "text/on-danger",
395
+ "contrast": {
396
+ "light": 8.36,
397
+ "dark": 8.36
398
+ }
399
+ }
400
+ ]
401
+ },
402
+ {
403
+ "name": "Feedback",
404
+ "use": "Alerts, banners and badges.",
405
+ "pairs": [
406
+ {
407
+ "surface": "feedback/success/surface",
408
+ "text": "text/primary",
409
+ "contrast": {
410
+ "light": 17.03,
411
+ "dark": 14.28
412
+ }
413
+ },
414
+ {
415
+ "surface": "feedback/success/surface",
416
+ "text": "feedback/success/text",
417
+ "contrast": {
418
+ "light": 4.72,
419
+ "dark": 10.67
420
+ }
421
+ },
422
+ {
423
+ "surface": "feedback/warning/surface",
424
+ "text": "text/primary",
425
+ "contrast": {
426
+ "light": 17.19,
427
+ "dark": 14.34
428
+ }
429
+ },
430
+ {
431
+ "surface": "feedback/warning/surface",
432
+ "text": "feedback/warning/text",
433
+ "contrast": {
434
+ "light": 4.85,
435
+ "dark": 10.37
436
+ }
437
+ },
438
+ {
439
+ "surface": "feedback/danger/surface",
440
+ "text": "text/primary",
441
+ "contrast": {
442
+ "light": 16.3,
443
+ "dark": 15.45
444
+ }
445
+ },
446
+ {
447
+ "surface": "feedback/danger/surface",
448
+ "text": "feedback/danger/text",
449
+ "contrast": {
450
+ "light": 5.87,
451
+ "dark": 8.42
452
+ }
453
+ },
454
+ {
455
+ "surface": "feedback/info/surface",
456
+ "text": "text/primary",
457
+ "contrast": {
458
+ "light": 16.73,
459
+ "dark": 13.28
460
+ }
461
+ },
462
+ {
463
+ "surface": "feedback/info/surface",
464
+ "text": "feedback/info/text",
465
+ "contrast": {
466
+ "light": 5.49,
467
+ "dark": 8.34
468
+ }
469
+ }
470
+ ]
471
+ },
472
+ {
473
+ "name": "Solid feedback",
474
+ "use": "Strong badges and status dots with text.",
475
+ "pairs": [
476
+ {
477
+ "surface": "feedback/success/solid",
478
+ "text": "feedback/success/on-solid",
479
+ "contrast": {
480
+ "light": 4.95,
481
+ "dark": 4.95
482
+ }
483
+ },
484
+ {
485
+ "surface": "feedback/warning/solid",
486
+ "text": "feedback/warning/on-solid",
487
+ "contrast": {
488
+ "light": 10.35,
489
+ "dark": 10.35
490
+ }
491
+ },
492
+ {
493
+ "surface": "feedback/danger/solid",
494
+ "text": "feedback/danger/on-solid",
495
+ "contrast": {
496
+ "light": 6.42,
497
+ "dark": 6.42
498
+ }
499
+ },
500
+ {
501
+ "surface": "feedback/info/solid",
502
+ "text": "feedback/info/on-solid",
503
+ "contrast": {
504
+ "light": 5.86,
505
+ "dark": 5.86
506
+ }
507
+ }
508
+ ]
509
+ },
510
+ {
511
+ "name": "Media",
512
+ "use": "Text on images and video – always on the overlay/media scrim. Checked on a white image, the worst case.",
513
+ "pairs": [
514
+ {
515
+ "surface": "overlay/media",
516
+ "text": "text/on-media",
517
+ "contrast": {
518
+ "light": 5.74,
519
+ "dark": 5.74
520
+ }
521
+ }
522
+ ]
523
+ }
524
+ ]
525
+ }
@@ -205,7 +205,7 @@
205
205
  "cssVar": "--medo-color-text-primary",
206
206
  "value": "#f8fafc",
207
207
  "ref": "neutral/50",
208
- "description": "Main text and headings. ≥ 13.9:1 on all surfaces."
208
+ "description": "Main text and headings on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 13.9:1. Not on brand-bold or inverse – use text/on-brand or text/inverse there."
209
209
  },
210
210
  {
211
211
  "name": "text/secondary",
@@ -218,7 +218,7 @@
218
218
  "cssVar": "--medo-color-text-secondary",
219
219
  "value": "#90a1b9",
220
220
  "ref": "neutral/400",
221
- "description": "Supporting text, descriptions, placeholders. ≥ 5.5:1 on all surfaces."
221
+ "description": "Supporting text, descriptions, placeholders on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 5.5:1. Not on brand-bold or inverse – use text/on-brand-secondary or text/inverse-secondary there."
222
222
  },
223
223
  {
224
224
  "name": "text/disabled",
@@ -400,7 +400,7 @@
400
400
  "cssVar": "--medo-color-border-strong",
401
401
  "value": "#90a1b9",
402
402
  "ref": "neutral/400",
403
- "description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on all surfaces."
403
+ "description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on content surfaces."
404
404
  },
405
405
  {
406
406
  "name": "border/strong-hover",
@@ -2119,7 +2119,7 @@
2119
2119
  "cssVar": "--medo-color-text-primary",
2120
2120
  "value": "#0f172b",
2121
2121
  "ref": "neutral/900",
2122
- "description": "Main text and headings. ≥ 13.9:1 on all surfaces."
2122
+ "description": "Main text and headings on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 13.9:1. Not on brand-bold or inverse – use text/on-brand or text/inverse there."
2123
2123
  },
2124
2124
  {
2125
2125
  "name": "text/secondary",
@@ -2132,7 +2132,7 @@
2132
2132
  "cssVar": "--medo-color-text-secondary",
2133
2133
  "value": "#45556c",
2134
2134
  "ref": "neutral/600",
2135
- "description": "Supporting text, descriptions, placeholders. ≥ 5.5:1 on all surfaces."
2135
+ "description": "Supporting text, descriptions, placeholders on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 5.5:1. Not on brand-bold or inverse – use text/on-brand-secondary or text/inverse-secondary there."
2136
2136
  },
2137
2137
  {
2138
2138
  "name": "text/disabled",
@@ -2314,7 +2314,7 @@
2314
2314
  "cssVar": "--medo-color-border-strong",
2315
2315
  "value": "#62748e",
2316
2316
  "ref": "neutral/500",
2317
- "description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on all surfaces."
2317
+ "description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on content surfaces."
2318
2318
  },
2319
2319
  {
2320
2320
  "name": "border/strong-hover",
@@ -3544,6 +3544,17 @@
3544
3544
  "cssVar": "--medo-font-family-mono",
3545
3545
  "value": "'DM Mono', ui-monospace, monospace"
3546
3546
  },
3547
+ {
3548
+ "name": "font/size/2xs",
3549
+ "path": [
3550
+ "font",
3551
+ "size",
3552
+ "2xs"
3553
+ ],
3554
+ "type": "dimension",
3555
+ "cssVar": "--medo-font-size-2xs",
3556
+ "value": "0.6875rem"
3557
+ },
3547
3558
  {
3548
3559
  "name": "font/size/xs",
3549
3560
  "path": [
package/dist/js/tokens.js CHANGED
@@ -301,6 +301,7 @@ export const tokens = {
301
301
  "container-xl": "1280px",
302
302
  "font-family-sans": "'DM Sans', system-ui, sans-serif",
303
303
  "font-family-mono": "'DM Mono', ui-monospace, monospace",
304
+ "font-size-2xs": "0.6875rem",
304
305
  "font-size-xs": "0.75rem",
305
306
  "font-size-sm": "0.875rem",
306
307
  "font-size-base": "1rem",
@@ -226,7 +226,7 @@
226
226
  --text-label-sm-strong--line-height: 1.3333;
227
227
  --text-label-sm-strong--font-weight: var(--medo-font-weight-bold);
228
228
  --text-label-sm-strong--letter-spacing: var(--medo-font-tracking-normal);
229
- --text-label-xs: 0.6875rem;
229
+ --text-label-xs: var(--medo-font-size-2xs);
230
230
  --text-label-xs--line-height: 1.4545;
231
231
  --text-label-xs--font-weight: var(--medo-font-weight-medium);
232
232
  --text-label-xs--letter-spacing: var(--medo-font-tracking-normal);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@med-o/design-tokens",
3
- "version": "0.4.1",
3
+ "version": "0.5.0",
4
4
  "description": "Design tokens of the med.o Design System (DTCG source, CSS variables, Tailwind v4 theme, JS).",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -85,12 +85,12 @@
85
85
  "primary": {
86
86
  "$type": "color",
87
87
  "$value": "{color.neutral.50}",
88
- "$description": "Main text and headings. ≥ 13.9:1 on all surfaces."
88
+ "$description": "Main text and headings on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 13.9:1. Not on brand-bold or inverse – use text/on-brand or text/inverse there."
89
89
  },
90
90
  "secondary": {
91
91
  "$type": "color",
92
92
  "$value": "{color.neutral.400}",
93
- "$description": "Supporting text, descriptions, placeholders. ≥ 5.5:1 on all surfaces."
93
+ "$description": "Supporting text, descriptions, placeholders on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 5.5:1. Not on brand-bold or inverse – use text/on-brand-secondary or text/inverse-secondary there."
94
94
  },
95
95
  "disabled": {
96
96
  "$type": "color",
@@ -162,7 +162,7 @@
162
162
  "strong": {
163
163
  "$type": "color",
164
164
  "$value": "{color.neutral.400}",
165
- "$description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on all surfaces."
165
+ "$description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on content surfaces."
166
166
  },
167
167
  "strong-hover": {
168
168
  "$type": "color",
@@ -85,12 +85,12 @@
85
85
  "primary": {
86
86
  "$type": "color",
87
87
  "$value": "{color.neutral.900}",
88
- "$description": "Main text and headings. ≥ 13.9:1 on all surfaces."
88
+ "$description": "Main text and headings on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 13.9:1. Not on brand-bold or inverse – use text/on-brand or text/inverse there."
89
89
  },
90
90
  "secondary": {
91
91
  "$type": "color",
92
92
  "$value": "{color.neutral.600}",
93
- "$description": "Supporting text, descriptions, placeholders. ≥ 5.5:1 on all surfaces."
93
+ "$description": "Supporting text, descriptions, placeholders on content surfaces (canvas, default, raised, subtle, brand-subtle, brand-muted): ≥ 5.5:1. Not on brand-bold or inverse – use text/on-brand-secondary or text/inverse-secondary there."
94
94
  },
95
95
  "disabled": {
96
96
  "$type": "color",
@@ -162,7 +162,7 @@
162
162
  "strong": {
163
163
  "$type": "color",
164
164
  "$value": "{color.neutral.500}",
165
- "$description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on all surfaces."
165
+ "$description": "Boundaries of interactive controls (inputs, checkboxes). ≥ 3:1 on content surfaces."
166
166
  },
167
167
  "strong-hover": {
168
168
  "$type": "color",
@@ -19,6 +19,13 @@
19
19
  }
20
20
  },
21
21
  "size": {
22
+ "2xs": {
23
+ "$type": "dimension",
24
+ "$value": {
25
+ "value": 11,
26
+ "unit": "px"
27
+ }
28
+ },
22
29
  "xs": {
23
30
  "$type": "dimension",
24
31
  "$value": {
@@ -393,10 +400,7 @@
393
400
  "$type": "typography",
394
401
  "$value": {
395
402
  "fontFamily": "{font.family.sans}",
396
- "fontSize": {
397
- "value": 11,
398
- "unit": "px"
399
- },
403
+ "fontSize": "{font.size.2xs}",
400
404
  "fontWeight": "{font.weight.medium}",
401
405
  "lineHeight": 1.4545,
402
406
  "letterSpacing": "{font.tracking.normal}"