@code-sherpas/pharos-tokens 0.5.0 → 0.7.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.
@@ -4,200 +4,200 @@
4
4
  "white": {
5
5
  "$value": "oklch(100% 0 0)",
6
6
  "$type": "color",
7
- "$description": "Pure white. Used as surface background and typical on-color for dark brand fills."
7
+ "$description": "Pure white. Cards, panels, sheets and popovers (via surface-card); text and icons on dark and semantic fills."
8
8
  },
9
9
  "black": {
10
10
  "$value": "oklch(0% 0 0)",
11
11
  "$type": "color",
12
- "$description": "Pure black. Rarely used — prefer color.neutral.900 for text and dark surfaces."
12
+ "$description": "Pure black base value."
13
13
  }
14
14
  },
15
15
  "neutral": {
16
16
  "50": {
17
- "$value": "oklch(97.91% 0 0)",
17
+ "$value": "oklch(97.91% 0.003 248.83)",
18
18
  "$type": "color",
19
- "$description": "Lightest surface. Replaces Alexandria #f8f8f8 and legacy 'grey'."
19
+ "$description": "Ink ramp (tints of navy). The light steps 50–400 are disabled / low-emphasis ink: reach for paper-* (fills) or rule-* (lines) first. The Pharos-faithful components still use 50/100/200 for hover and press bands (un-migrated)."
20
20
  },
21
21
  "100": {
22
- "$value": "oklch(97.02% 0 0)",
22
+ "$value": "oklch(97.02% 0.004 248.83)",
23
23
  "$type": "color",
24
- "$description": "Subtle surface. Replaces Alexandria #f5f5f5 / light-grey / supporting.light."
24
+ "$description": "Ink ramp (tints of navy). The light steps 50–400 are disabled / low-emphasis ink: reach for paper-* (fills) or rule-* (lines) first. The Pharos-faithful components still use 50/100/200 for hover and press bands (un-migrated)."
25
25
  },
26
26
  "200": {
27
- "$value": "oklch(95.21% 0 0)",
27
+ "$value": "oklch(95.21% 0.005 248.83)",
28
28
  "$type": "color",
29
- "$description": "Quiet surface / default border on light mode. Replaces Alexandria #efefef / supporting.base / legacy border."
29
+ "$description": "Ink ramp (tints of navy). The light steps 50–400 are disabled / low-emphasis ink: reach for paper-* (fills) or rule-* (lines) first. The Pharos-faithful components still use 50/100/200 for hover and press bands (un-migrated)."
30
30
  },
31
31
  "300": {
32
- "$value": "oklch(88.82% 0.0029 264.54)",
32
+ "$value": "oklch(88.82% 0.007 248.83)",
33
33
  "$type": "color",
34
- "$description": "Border strong / disabled fill. Replaces Alexandria #d9dadc / supporting.dark / border-dark."
34
+ "$description": "Ink ramp (tints of navy). The light steps 50–400 are disabled / low-emphasis ink: reach for paper-* (fills) or rule-* (lines) first. The Pharos-faithful components still use 50/100/200 for hover and press bands (un-migrated)."
35
35
  },
36
36
  "400": {
37
- "$value": "oklch(81.09% 0 0)",
37
+ "$value": "oklch(81.09% 0.01 248.83)",
38
38
  "$type": "color",
39
- "$description": "Muted foreground on light surfaces. Replaces Alexandria #c1c1c1."
39
+ "$description": "Ink ramp (tints of navy). The light steps 50–400 are disabled / low-emphasis ink: reach for paper-* (fills) or rule-* (lines) first. The Pharos-faithful components still use 50/100/200 for hover and press bands (un-migrated)."
40
40
  },
41
41
  "500": {
42
- "$value": "oklch(52.78% 0 0)",
42
+ "$value": "oklch(52.78% 0.016 248.83)",
43
43
  "$type": "color",
44
- "$description": "Secondary text (most-used neutral). Replaces Alexandria #6b6b6b / secondary-text / supporting.secondary."
44
+ "$description": "Ink: de-emphasised text on the warm ground and on white; the 1px border of interactive controls (Input, secondary Button, outline Badge, Select, Combobox), clearing WCAG 3:1 non-text contrast."
45
45
  },
46
46
  "600": {
47
- "$value": "oklch(35.62% 0 0)",
47
+ "$value": "oklch(35.62% 0.019 248.83)",
48
48
  "$type": "color",
49
- "$description": "Icon dark / secondary emphasis. Replaces Alexandria #3c3c3c."
49
+ "$description": "Ink: secondary body text on paper-* and white."
50
50
  },
51
51
  "700": {
52
- "$value": "oklch(29.52% 0.0107 254)",
52
+ "$value": "oklch(29.52% 0.02 248.83)",
53
53
  "$type": "color",
54
- "$description": "Strong text on light surfaces. Replaces Alexandria #292d32."
54
+ "$description": "Ink: labels and captions on paper-* and white; hover of the primary Button."
55
55
  },
56
56
  "800": {
57
- "$value": "oklch(37.05% 0.0436 247.87)",
57
+ "$value": "oklch(24.5% 0.02 248.83)",
58
58
  "$type": "color",
59
- "$description": "Charcoal blue, alternative navy. Replaces Alexandria #2d4256 / charcoal-blue."
59
+ "$description": "Ink ramp step between 700 and 900 (fixed: no longer lighter than 700)."
60
60
  },
61
61
  "900": {
62
62
  "$value": "oklch(20.50% 0.02 248.83)",
63
63
  "$type": "color",
64
- "$description": "Primary text / dark surface. Hero neutral of the Code Sherpas identity. Replaces Alexandria #101820 (279 usages) / main.base / navy-blue-text."
64
+ "$description": "Brand navy #101820. Primary text, icons and headlines on paper-* and white; the primary Button fill."
65
65
  },
66
66
  "950": {
67
- "$value": "oklch(14.69% 0.0225 269.48)",
67
+ "$value": "oklch(14.69% 0.0225 248.83)",
68
68
  "$type": "color",
69
- "$description": "Deepest neutral. Replaces Alexandria #070a14 / primary-text."
69
+ "$description": "Deepest ink; press state of the primary Button."
70
70
  }
71
71
  },
72
72
  "primary": {
73
73
  "50": {
74
74
  "$value": "oklch(95.94% 0.0164 274.82)",
75
75
  "$type": "color",
76
- "$description": "Primary tint, lightest. Replaces Alexandria #eef1fd / new-primary.light derivates."
76
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
77
77
  },
78
78
  "100": {
79
79
  "$value": "oklch(91.35% 0.0374 275.69)",
80
80
  "$type": "color",
81
- "$description": "Primary tint, soft. Replaces Alexandria #dbe1fc / new-primary.light."
81
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
82
82
  },
83
83
  "200": {
84
84
  "$value": "oklch(82.70% 0.0785 274.99)",
85
85
  "$type": "color",
86
- "$description": "Primary tint, medium."
86
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
87
87
  },
88
88
  "300": {
89
89
  "$value": "oklch(74.07% 0.1205 273.68)",
90
90
  "$type": "color",
91
- "$description": "Primary tint, stronger."
91
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
92
92
  },
93
93
  "400": {
94
94
  "$value": "oklch(65.40% 0.1582 271.71)",
95
95
  "$type": "color",
96
- "$description": "Primary highlight."
96
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
97
97
  },
98
98
  "500": {
99
99
  "$value": "oklch(57.34% 0.1996 269.61)",
100
100
  "$type": "color",
101
- "$description": "Primary lighter step."
101
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
102
102
  },
103
103
  "600": {
104
104
  "$value": "oklch(49.83% 0.2417 267.34)",
105
105
  "$type": "color",
106
- "$description": "Primary brand color (sea blue). Replaces Alexandria #2a48e9 / sea-blue-primitive / new-primary.base."
106
+ "$description": "Seablue, the brand hue (≈ #2A48E9). The one blue anchor per view: action, focus ring (2px white halo + 4px primary-600), selection, links, AI/copilot."
107
107
  },
108
108
  "700": {
109
109
  "$value": "oklch(42.19% 0.2111 267.20)",
110
110
  "$type": "color",
111
- "$description": "Primary pressed / hover dark."
111
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
112
112
  },
113
113
  "800": {
114
114
  "$value": "oklch(34.32% 0.1726 267.54)",
115
115
  "$type": "color",
116
- "$description": "Primary deep."
116
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
117
117
  },
118
118
  "900": {
119
119
  "$value": "oklch(25.97% 0.1317 268.18)",
120
120
  "$type": "color",
121
- "$description": "Primary darkest."
121
+ "$description": "Seablue ramp: signature and signal — action, focus, selection, links, AI/copilot. Never structural chrome."
122
122
  }
123
123
  },
124
124
  "semantic": {
125
125
  "success": {
126
126
  "fg": {
127
- "$value": "oklch(52% 0.17 152)",
127
+ "$value": "oklch(52% 0.136 152)",
128
128
  "$type": "color",
129
- "$description": "Success foreground. Darkened from Alexandria #05b661 (L=68%, failed WCAG) to pass AA 4.5:1 vs white background and AA 3:1 for white text on filled surfaces."
129
+ "$description": "System state only: success fill and success text colour; pair with semantic-success-on on the fill (WCAG AA). #027E3F — chroma clamped to the sRGB gamut edge."
130
130
  },
131
131
  "bg": {
132
- "$value": "oklch(52% 0.17 152 / 0.063)",
132
+ "$value": "oklch(52% 0.136 152 / 0.063)",
133
133
  "$type": "color",
134
- "$description": "Success background, subtle tint of success.fg."
134
+ "$description": "System state only: tinted success background (fg at 6.3%)."
135
135
  },
136
136
  "on": {
137
137
  "$value": "{color.base.white}",
138
138
  "$type": "color",
139
- "$description": "Readable on success.fg filled surfaces (WCAG AA)."
139
+ "$description": "Text and icons on a semantic-success-fg fill."
140
140
  }
141
141
  },
142
142
  "error": {
143
143
  "fg": {
144
144
  "$value": "oklch(54% 0.22 27.48)",
145
145
  "$type": "color",
146
- "$description": "Error foreground. Darkened from Alexandria #ef2828 (L=61%, contrast 4.19 against white failed WCAG AA 4.5:1 for normal text in filled destructive buttons) to pass AA 4.5:1 (contrast 5.68 vs white). Decision D2: single red (laser-red merged). Same precedent as success.fg and info.fg — Alexandria's value failed AA, Pharos fixes it systemically."
146
+ "$description": "System state only: error fill and error text colour; pair with semantic-error-on on the fill (WCAG AA). Single red (laser-red merged); also the destructive Button fill and its focus ring."
147
147
  },
148
148
  "fg-hover": {
149
- "$value": "oklch(47% 0.205 27.48)",
149
+ "$value": "oklch(47% 0.191 27.48)",
150
150
  "$type": "color",
151
- "$description": "Darker shade of error.fg for hover states on filled destructive surfaces. Contrast 7.26 vs error.on (white), passes WCAG AA 4.5:1 with margin."
151
+ "$description": "Hover of an error / destructive fill. #AD020E."
152
152
  },
153
153
  "fg-active": {
154
- "$value": "oklch(40% 0.175 27.48)",
154
+ "$value": "oklch(40% 0.162 27.48)",
155
155
  "$type": "color",
156
- "$description": "Darkest — pressed/active state for filled destructive surfaces. Contrast 9.69 vs error.on (white), passes WCAG AAA 7:1."
156
+ "$description": "Press of an error / destructive fill. #8A0209."
157
157
  },
158
158
  "bg": {
159
159
  "$value": "oklch(54% 0.22 27.48 / 0.063)",
160
160
  "$type": "color",
161
- "$description": "Error background, subtle tint of error.fg. Tracks the darkened fg so the relationship stays consistent."
161
+ "$description": "System state only: tinted error background (fg at 6.3%)."
162
162
  },
163
163
  "on": {
164
164
  "$value": "{color.base.white}",
165
165
  "$type": "color",
166
- "$description": "Readable on error.fg filled surfaces (WCAG AA 4.5:1 for normal text)."
166
+ "$description": "Text and icons on a semantic-error-fg fill."
167
167
  }
168
168
  },
169
169
  "warning": {
170
170
  "fg": {
171
171
  "$value": "oklch(77.77% 0.1588 90.66)",
172
172
  "$type": "color",
173
- "$description": "Warning foreground. Replaces Alexandria #ddb101 / warning.fore."
173
+ "$description": "System state only: warning fill and warning text colour; pair with semantic-warning-on on the fill (WCAG AA)."
174
174
  },
175
175
  "bg": {
176
176
  "$value": "oklch(77.77% 0.1588 90.66 / 0.063)",
177
177
  "$type": "color",
178
- "$description": "Warning background, subtle. Replaces Alexandria #ddb10110 / warning.back."
178
+ "$description": "System state only: tinted warning background (fg at 6.3%)."
179
179
  },
180
180
  "on": {
181
181
  "$value": "{color.neutral.900}",
182
182
  "$type": "color",
183
- "$description": "Readable on warning.fg filled surfaces (WCAG AA). Warning is light/amber — needs dark on-color."
183
+ "$description": "Dark text on a semantic-warning-fg (amber) fill."
184
184
  }
185
185
  },
186
186
  "info": {
187
187
  "fg": {
188
- "$value": "oklch(52% 0.17 246)",
188
+ "$value": "oklch(52% 0.133 246)",
189
189
  "$type": "color",
190
- "$description": "Info foreground. Darkened from Alexandria #009bf9 (L=67%, failed WCAG) to pass AA 4.5:1 vs white background."
190
+ "$description": "System state only: info fill and info text colour; pair with semantic-info-on on the fill (WCAG AA). #026DB0 — chroma clamped to the sRGB gamut edge."
191
191
  },
192
192
  "bg": {
193
- "$value": "oklch(52% 0.17 246 / 0.063)",
193
+ "$value": "oklch(52% 0.133 246 / 0.063)",
194
194
  "$type": "color",
195
- "$description": "Info background, subtle tint of info.fg."
195
+ "$description": "System state only: tinted info background (fg at 6.3%)."
196
196
  },
197
197
  "on": {
198
198
  "$value": "{color.base.white}",
199
199
  "$type": "color",
200
- "$description": "Readable on info.fg filled surfaces (WCAG AA)."
200
+ "$description": "Text and icons on a semantic-info-fg fill."
201
201
  }
202
202
  }
203
203
  },
@@ -205,63 +205,63 @@
205
205
  "50": {
206
206
  "$value": "oklch(99.4% 0.003 70)",
207
207
  "$type": "color",
208
- "$description": "Warmest, lightest paper. Sunken surfaces inside a card."
208
+ "$description": "Warm paper #FEFDFB — all but white, a spark of warmth. Fill: hover rows, zebra banding, the faintest lift off white (surface-sunken). Never a border."
209
209
  },
210
210
  "100": {
211
211
  "$value": "oklch(98.5% 0.009 70)",
212
212
  "$type": "color",
213
- "$description": "The page canvas of the redesigned screens."
213
+ "$description": "Warm paper #FEF9F4 — the app canvas, the page itself (surface-canvas). Never a border."
214
214
  },
215
215
  "200": {
216
216
  "$value": "oklch(96.5% 0.010 70)",
217
217
  "$type": "color",
218
- "$description": "Panels and hovers on paper."
218
+ "$description": "Warm paper #F8F2EC — light fills on the canvas: chips, tracks, step circles, inputs. Never a border."
219
219
  },
220
220
  "300": {
221
221
  "$value": "oklch(93.5% 0.010 70)",
222
222
  "$type": "color",
223
- "$description": "The rule that separates paper from paper."
223
+ "$description": "Warm paper #EEE8E2 — stronger fill: disabled surfaces, switch off-track. Never a border."
224
224
  }
225
225
  },
226
226
  "rule": {
227
227
  "subtle": {
228
228
  "$value": "oklch(91.5% 0.008 248.83)",
229
229
  "$type": "color",
230
- "$description": "Hairline between rows and inside cards."
230
+ "$description": "Line #DFE3E8 (ink family): default divider, card border — on white and on the warm ground."
231
231
  },
232
232
  "strong": {
233
233
  "$value": "oklch(85.5% 0.012 248.83)",
234
234
  "$type": "color",
235
- "$description": "Visible border of a surface."
235
+ "$description": "Line #C9D0D7 (ink family): emphatic rule, dashed placeholder."
236
236
  }
237
237
  },
238
238
  "surface": {
239
239
  "canvas": {
240
240
  "$value": "{color.paper.100}",
241
241
  "$type": "color",
242
- "$description": "The page itself."
242
+ "$description": "Page / app background (→ paper-100). Prefer the semantic aliases in new work."
243
243
  },
244
244
  "card": {
245
245
  "$value": "{color.base.white}",
246
246
  "$type": "color",
247
- "$description": "A surface resting on the canvas."
247
+ "$description": "Cards, panels, sheets, popovers (→ base-white)."
248
248
  },
249
249
  "sunken": {
250
250
  "$value": "{color.paper.50}",
251
251
  "$type": "color",
252
- "$description": "A well inside a card."
252
+ "$description": "Hover rows, subtle bands (→ paper-50)."
253
253
  }
254
254
  },
255
255
  "border": {
256
256
  "subtle": {
257
257
  "$value": "{color.rule.subtle}",
258
258
  "$type": "color",
259
- "$description": "Border of a resting surface."
259
+ "$description": "Card borders, dividers, rules (→ rule-subtle)."
260
260
  },
261
261
  "strong": {
262
262
  "$value": "{color.rule.strong}",
263
263
  "$type": "color",
264
- "$description": "Border that has to be seen."
264
+ "$description": "Emphatic rules, dashed placeholders (→ rule-strong)."
265
265
  }
266
266
  },
267
267
  "accent": {
@@ -269,67 +269,67 @@
269
269
  "50": {
270
270
  "$value": "oklch(96.50% 0.0160 42.5)",
271
271
  "$type": "color",
272
- "$description": "Tint surface for warm-accent blocks."
272
+ "$description": "Tint surfaces and soft badges (#FEF0EB); bg of a warm tint block (text 900) or a tag (text 700)."
273
273
  },
274
274
  "100": {
275
275
  "$value": "oklch(93.00% 0.0350 42.5)",
276
276
  "$type": "color",
277
- "$description": "Hover of the tint surface."
277
+ "$description": "Terracotta tint #FDE1D6: tag and chip fills when many show at once."
278
278
  },
279
279
  "200": {
280
280
  "$value": "oklch(87.00% 0.0620 42.5)",
281
281
  "$type": "color",
282
- "$description": "Border of a warm-accent block."
282
+ "$description": "Subtle terracotta borders and rules; low end of chart ramps (#F9C8B5)."
283
283
  },
284
284
  "300": {
285
285
  "$value": "oklch(79.00% 0.0950 42.5)",
286
286
  "$type": "color",
287
- "$description": "Disabled warm accent."
287
+ "$description": "Chart ramp step (#EFA78A)."
288
288
  },
289
289
  "400": {
290
290
  "$value": "oklch(70.00% 0.1220 42.5)",
291
291
  "$type": "color",
292
- "$description": "Warm accent on dark surfaces."
292
+ "$description": "Terracotta ramp step (#DD835F)."
293
293
  },
294
294
  "500": {
295
295
  "$value": "oklch(65.00% 0.1320 42.5)",
296
296
  "$type": "color",
297
- "$description": "The accent at full strength."
297
+ "$description": "Chart ramp step (#D1714A)."
298
298
  },
299
299
  "600": {
300
300
  "$value": "oklch(60.75% 0.1358 42.5)",
301
301
  "$type": "color",
302
- "$description": "Default warm accent (#C4633A)."
302
+ "$description": "BASE — the brand terracotta #C4633A. Solid fills with no small text (bars, blocks, ≥18.66px bold / ≥24px), emphatic rules. 4.04:1 on white either way: large text only. Never a control, focus ring, link or state."
303
303
  },
304
304
  "700": {
305
305
  "$value": "oklch(51.60% 0.1261 40.7)",
306
306
  "$type": "color",
307
- "$description": "Warm accent as ink: 5.92:1 on white, AA (#A24A28)."
307
+ "$description": "Terracotta ink #A24A28: accent text on white (5.92:1, AA); solid marks carrying small white text; hover of a 600 fill."
308
308
  },
309
309
  "800": {
310
310
  "$value": "oklch(42.00% 0.1020 42.5)",
311
311
  "$type": "color",
312
- "$description": "Pressed step."
312
+ "$description": "Press step of a terracotta fill (#79371A)."
313
313
  },
314
314
  "900": {
315
315
  "$value": "oklch(33.00% 0.0770 42.5)",
316
316
  "$type": "color",
317
- "$description": "Darkest step."
317
+ "$description": "Deep text on a terracotta tint (#552612)."
318
318
  },
319
319
  "fg": {
320
320
  "$value": "{color.accent.terracotta.700}",
321
321
  "$type": "color",
322
- "$description": "Readable warm-accent ink on white."
322
+ "$description": "Accessible ink for warm-accent blocks on white (→ terracotta-700)."
323
323
  },
324
324
  "bg": {
325
325
  "$value": "{color.accent.terracotta.50}",
326
326
  "$type": "color",
327
- "$description": "Warm-accent tint surface."
327
+ "$description": "Tint surface for warm-accent blocks on white (→ terracotta-50)."
328
328
  },
329
329
  "on": {
330
330
  "$value": "{color.base.white}",
331
331
  "$type": "color",
332
- "$description": "Readable on a filled warm-accent surface."
332
+ "$description": "Text on a solid terracotta mark (use on 700 for small text)."
333
333
  }
334
334
  }
335
335
  }
@@ -1,28 +1,44 @@
1
1
  {
2
2
  "radius": {
3
- "none": { "$value": "0", "$type": "dimension", "$description": "No rounding." },
4
- "sm": { "$value": "0.125rem", "$type": "dimension", "$description": "2px. Subtle rounding." },
3
+ "none": {
4
+ "$value": "0",
5
+ "$type": "dimension",
6
+ "$description": "Square corners."
7
+ },
8
+ "sm": {
9
+ "$value": "0.125rem",
10
+ "$type": "dimension",
11
+ "$description": "2px — small marks, code chips."
12
+ },
5
13
  "md": {
6
14
  "$value": "0.375rem",
7
15
  "$type": "dimension",
8
- "$description": "6px. Default control rounding."
16
+ "$description": "6px — default control rounding."
17
+ },
18
+ "lg": {
19
+ "$value": "0.5rem",
20
+ "$type": "dimension",
21
+ "$description": "8px — swatches, inner panels."
22
+ },
23
+ "xl": {
24
+ "$value": "0.75rem",
25
+ "$type": "dimension",
26
+ "$description": "12px."
9
27
  },
10
- "lg": { "$value": "0.5rem", "$type": "dimension", "$description": "8px." },
11
- "xl": { "$value": "0.75rem", "$type": "dimension", "$description": "12px." },
12
28
  "2xl": {
13
29
  "$value": "1rem",
14
30
  "$type": "dimension",
15
- "$description": "16px. Default card rounding (replaces Alexandria cs-md / rounded-cs-md)."
31
+ "$description": "16px — default card rounding."
16
32
  },
17
33
  "3xl": {
18
34
  "$value": "1.5rem",
19
35
  "$type": "dimension",
20
- "$description": "24px. Large surface rounding (replaces Alexandria cs-lg / rounded-cs-lg)."
36
+ "$description": "24px — large surface rounding."
21
37
  },
22
38
  "full": {
23
39
  "$value": "9999px",
24
40
  "$type": "dimension",
25
- "$description": "Fully rounded — pills, avatars, icon buttons. 117 usages in Alexandria."
41
+ "$description": "Pills, avatars, icon buttons, buttons."
26
42
  }
27
43
  }
28
44
  }