@motion-proto/live-tokens 0.73.0 → 0.74.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.
Files changed (73) hide show
  1. package/.claude/skills/live-tokens-build-page/SKILL.md +2 -2
  2. package/.claude/skills/live-tokens-check-compliance/SKILL.md +2 -2
  3. package/.claude/skills/live-tokens-create-component/SKILL.md +4 -4
  4. package/.claude/skills/live-tokens-create-theme/SKILL.md +80 -0
  5. package/.claude/skills/live-tokens-create-theme/references/design-directions.md +94 -0
  6. package/.claude/skills/live-tokens-set-colors/SKILL.md +140 -0
  7. package/.claude/skills/live-tokens-set-colors/references/color-anchors.md +80 -0
  8. package/.claude/skills/{live-tokens-adjust-geometry → live-tokens-set-geometry}/SKILL.md +12 -7
  9. package/.claude/skills/live-tokens-set-geometry/references/geometry-anchors.md +61 -0
  10. package/.claude/skills/{live-tokens-pair-fonts → live-tokens-set-type}/SKILL.md +18 -15
  11. package/.claude/skills/live-tokens-set-type/references/type-anchors.md +60 -0
  12. package/CHANGELOG.md +91 -0
  13. package/README.md +24 -15
  14. package/bin/check-page.mjs +3 -3
  15. package/bin/cli.mjs +92 -55
  16. package/bin/lib/liveState.mjs +110 -0
  17. package/bin/save-theme.mjs +177 -0
  18. package/bin/set-colors.mjs +191 -0
  19. package/bin/{adjust.mjs → set-geometry.mjs} +18 -50
  20. package/bin/{set-fonts.mjs → set-type.mjs} +21 -55
  21. package/dist-plugin/{chunk-RIXO2E55.js → chunk-7VRTBGJT.js} +1 -1
  22. package/dist-plugin/{chunk-YLCOIGQC.js → chunk-V3YF6CGT.js} +56 -2
  23. package/dist-plugin/index.cjs +58 -3
  24. package/dist-plugin/index.js +11 -11
  25. package/dist-plugin/migrateData/index.cjs +56 -1
  26. package/dist-plugin/migrateData/index.js +2 -2
  27. package/dist-plugin/{generateColorsAndType → setColors}/index.cjs +1109 -1071
  28. package/dist-plugin/{generateColorsAndType → setColors}/index.d.cts +33 -24
  29. package/dist-plugin/{generateColorsAndType → setColors}/index.d.ts +33 -24
  30. package/dist-plugin/{generateColorsAndType → setColors}/index.js +45 -63
  31. package/dist-plugin/{adjust → setGeometry}/index.cjs +60 -5
  32. package/dist-plugin/{adjust → setGeometry}/index.d.cts +1 -1
  33. package/dist-plugin/{adjust → setGeometry}/index.d.ts +1 -1
  34. package/dist-plugin/{adjust → setGeometry}/index.js +1 -1
  35. package/dist-plugin/{fontPairing → setType}/index.cjs +4 -4
  36. package/dist-plugin/{fontPairing → setType}/index.d.cts +1 -1
  37. package/dist-plugin/{fontPairing → setType}/index.d.ts +1 -1
  38. package/dist-plugin/{themeTypes-DSV3Zisf.d.cts → themeTypes-BxRtuN5V.d.cts} +1 -1
  39. package/dist-plugin/{themeTypes-DSV3Zisf.d.ts → themeTypes-BxRtuN5V.d.ts} +1 -1
  40. package/package.json +2 -1
  41. package/src/editor/core/themes/{generateColorsAndType.ts → buildColors.ts} +82 -96
  42. package/src/editor/core/themes/migrations/2026-09-03-drop-legacy-component-keys.ts +62 -0
  43. package/src/editor/core/themes/migrations/index.ts +2 -0
  44. package/src/editor/docs/content/themes-workflow.md +2 -2
  45. package/src/editor/docs/content.generated.ts +1 -1
  46. package/src/editor/overlay/LiveEditorOverlay.svelte +519 -28
  47. package/src/editor/skill-atlas/SkillAtlas.svelte +2 -2
  48. package/src/editor/skill-atlas/skillSources.generated.ts +19 -15
  49. package/src/editor/skill-atlas/skillTrees.ts +785 -632
  50. package/src/live-tokens/data/colors-and-type/autumn.json +1 -37
  51. package/src/live-tokens/data/colors-and-type/default.json +1 -37
  52. package/src/live-tokens/data/colors-and-type/halloween.json +1 -37
  53. package/src/live-tokens/data/colors-and-type/midnight-study.json +1 -37
  54. package/src/live-tokens/data/colors-and-type/ocean.json +1 -37
  55. package/src/live-tokens/data/colors-and-type/royal-velvet.json +1 -37
  56. package/src/live-tokens/data/colors-and-type/sketchy.json +1 -37
  57. package/src/live-tokens/data/colors-and-type/spring-meadow.json +1 -37
  58. package/src/live-tokens/data/colors-and-type/sunset.json +1 -37
  59. package/src/live-tokens/data/themes/autumn.json +1 -37
  60. package/src/live-tokens/data/themes/halloween.json +1 -37
  61. package/src/live-tokens/data/themes/midnight-study.json +1 -37
  62. package/src/live-tokens/data/themes/ocean.json +1 -37
  63. package/src/live-tokens/data/themes/royal-velvet.json +1 -37
  64. package/src/live-tokens/data/themes/sketchy.json +1 -37
  65. package/src/live-tokens/data/themes/spring-meadow.json +1 -37
  66. package/src/live-tokens/data/themes/sunset.json +1 -37
  67. package/src/live-tokens/data/tokens.generated.css +0 -36
  68. package/.claude/skills/live-tokens-generate-theme/SKILL.md +0 -156
  69. package/.claude/skills/live-tokens-generate-theme/references/mood-vocabulary.md +0 -43
  70. package/.claude/skills/live-tokens-generate-theme/references/named-themes.md +0 -18
  71. package/.claude/skills/live-tokens-generate-theme/references/style-vocabulary.md +0 -35
  72. package/bin/generate-theme.mjs +0 -260
  73. /package/dist-plugin/{fontPairing → setType}/index.js +0 -0
@@ -1,131 +1,380 @@
1
1
  import type { SkillTree } from './types';
2
2
 
3
3
  export const skillTrees: Record<string, SkillTree> = {
4
- "generate-theme": {
5
- "id": "live-tokens-generate-theme",
6
- "digest": "sha256:e6b9892d67820148",
7
- "title": "generate-theme",
8
- "tagline": "One brief guides color, type, and geometry across three skills.",
4
+ "create-theme": {
5
+ "id": "live-tokens-create-theme",
6
+ "digest": "sha256:7a87f61fa686368c",
7
+ "title": "create-theme",
8
+ "tagline": "One reading of the request becomes three intents, routed to three skills and saved as one theme.",
9
9
  "nodes": [
10
10
  {
11
- "id": "gt-trig",
11
+ "id": "ct-trig",
12
12
  "row": 0,
13
13
  "kind": "trigger",
14
- "title": "Define or refine a theme",
15
- "desc": "A palette, mood, style, occasion, hue, or color refinement drives the theme. The editor handles single tokens; pair-fonts handles type; adjust-geometry handles geometry.",
14
+ "title": "Define or refine a whole look",
15
+ "desc": "A theme, look, vibe, or brand feel by mood, style, era, season, holiday, or hue. One dimension alone goes straight to set-colors, set-type, or set-geometry.",
16
16
  "lines": [
17
17
  2,
18
- 8
18
+ 19
19
19
  ],
20
- "anchor": "name: live-tokens-generate-theme",
21
- "anchorEnd": "A theme is three decisions made from one brief: color, type,"
20
+ "anchor": "name: live-tokens-create-theme",
21
+ "anchorEnd": "never edit the data tree directly."
22
22
  },
23
23
  {
24
- "id": "gt-voice",
24
+ "id": "ct-direction",
25
25
  "row": 1,
26
26
  "kind": "step",
27
27
  "n": "1",
28
- "title": "Define the theme voice",
29
- "desc": "The voice sentence captures the mood, hue family, scheme, and implied type and geometry. It guides every later choice.",
28
+ "title": "State the design direction",
29
+ "desc": "One or two lines fix the mood, the hue family, the scheme, and the type and geometry that mood implies, naming the default where the request leaves a dimension open.",
30
30
  "lines": [
31
- 12,
32
- 12
31
+ 23,
32
+ 23
33
33
  ],
34
- "anchor": "Read the brief once and name its voice in a sentence: the mo"
34
+ "anchor": "Read the request once and state the design direction to the "
35
35
  },
36
36
  {
37
- "id": "gt-anchor",
37
+ "id": "ct-index",
38
38
  "row": 2,
39
- "kind": "decide",
40
- "title": "Anchor category?",
41
- "desc": "Anchors define color, type, and geometry and override generic defaults. When two match, the idiom sets constraints and the feeling adjusts its dials.",
39
+ "kind": "ref",
40
+ "title": "Name the anchor",
41
+ "desc": "A feeling, an idiom, or an occasion. An idiom sets constraints and a feeling moves dials inside them, so a request matching both reads the idiom first.",
42
+ "reference": "references/design-directions.md",
42
43
  "lines": [
43
- 13,
44
- 13
44
+ 24,
45
+ 24
45
46
  ],
46
- "anchor": "Read the anchor reference that matches the voice (feeling, i",
47
- "n": "2"
47
+ "anchor": "Read `references/design-directions.md` and name the **anchor"
48
48
  },
49
49
  {
50
- "id": "gt-mood",
50
+ "id": "ct-intents",
51
51
  "row": 3,
52
- "kind": "ref",
53
- "title": "Read the mood anchor",
54
- "reference": "references/mood-vocabulary.md",
52
+ "kind": "step",
53
+ "n": "3",
54
+ "title": "State the three intents",
55
+ "desc": "The color, type, and geometry intents each name an outcome in a line. The anchor name travels with each one so the contributing skill can read its own column.",
55
56
  "lines": [
56
- 123,
57
- 123
57
+ 25,
58
+ 25
58
59
  ],
59
- "anchor": "- `references/mood-vocabulary.md` covers feelings: joyful, p"
60
+ "anchor": "State the three intents the design direction and the anchor ",
61
+ "chips": [
62
+ {
63
+ "label": "What each contributing skill owns",
64
+ "lines": [
65
+ 39,
66
+ 43
67
+ ],
68
+ "anchor": "| Dimension | Contributing skill | It decides |",
69
+ "anchorEnd": "| geometry | live-tokens-set-geometry | radius, padding, gap"
70
+ }
71
+ ]
60
72
  },
61
73
  {
62
- "id": "gt-style",
63
- "row": 3,
64
- "kind": "ref",
65
- "title": "Read the style anchor",
66
- "reference": "references/style-vocabulary.md",
74
+ "id": "ct-colors",
75
+ "row": 4,
76
+ "kind": "hand",
77
+ "title": "Hand the color intent to set-colors",
78
+ "desc": "This hand-off never skips: a theme request names a color identity, so color is the one dimension every look fixes.",
67
79
  "lines": [
68
- 124,
69
- 124
80
+ 26,
81
+ 26
70
82
  ],
71
- "anchor": "- `references/style-vocabulary.md` covers named idioms, eras"
83
+ "anchor": "Invoke **live-tokens-set-colors** with the color intent. Thi"
72
84
  },
73
85
  {
74
- "id": "gt-named",
75
- "row": 3,
76
- "kind": "ref",
77
- "title": "Read the named-theme anchor",
78
- "reference": "references/named-themes.md",
86
+ "id": "ct-type-q",
87
+ "row": 5,
88
+ "kind": "decide",
89
+ "title": "Does the look need new type?",
90
+ "desc": "Type is skipped only when the user asked to leave it alone.",
79
91
  "lines": [
80
- 125,
81
- 125
92
+ 27,
93
+ 27
82
94
  ],
83
- "anchor": "- `references/named-themes.md` covers holidays, seasons, and"
95
+ "anchor": "Invoke **live-tokens-set-type** with the type intent. Skip o"
84
96
  },
85
97
  {
86
- "id": "gt-none",
87
- "row": 3,
98
+ "id": "ct-type",
99
+ "row": 6,
100
+ "kind": "hand",
101
+ "title": "Hand the type intent to set-type",
102
+ "desc": "The contributing skill chooses the families. This skill passes an outcome and never a family name.",
103
+ "lines": [
104
+ 27,
105
+ 27
106
+ ],
107
+ "anchor": "Invoke **live-tokens-set-type** with the type intent. Skip o"
108
+ },
109
+ {
110
+ "id": "ct-geo-q",
111
+ "row": 7,
112
+ "kind": "decide",
113
+ "title": "Does the look need geometry changes?",
114
+ "desc": "Geometry is skipped when the geometry intent is to leave it alone.",
115
+ "lines": [
116
+ 28,
117
+ 28
118
+ ],
119
+ "anchor": "Invoke **live-tokens-set-geometry** with the geometry intent"
120
+ },
121
+ {
122
+ "id": "ct-geo",
123
+ "row": 8,
124
+ "kind": "hand",
125
+ "title": "Hand the geometry intent to set-geometry",
126
+ "desc": "The contributing skill chooses the ops. This skill passes an outcome and never a radius or a token.",
127
+ "lines": [
128
+ 28,
129
+ 28
130
+ ],
131
+ "anchor": "Invoke **live-tokens-set-geometry** with the geometry intent"
132
+ },
133
+ {
134
+ "id": "ct-save",
135
+ "row": 9,
136
+ "kind": "cli",
137
+ "n": "7",
138
+ "title": "Save the theme",
139
+ "desc": "One verb composes the three buffers into themes/<slug>.json and opens it, so nothing is left unsaved.",
140
+ "lines": [
141
+ 29,
142
+ 29
143
+ ],
144
+ "anchor": "Take the theme name from the design direction and run `npx l",
145
+ "command": "npx live-tokens save-theme \"<name>\"",
146
+ "chips": [
147
+ {
148
+ "label": "A set of themes",
149
+ "lines": [
150
+ 32,
151
+ 33
152
+ ],
153
+ "anchor": "A set of themes runs steps 4 to 7 once per theme, with `--no",
154
+ "anchorEnd": "save but the last, so each theme starts from the same live l"
155
+ }
156
+ ]
157
+ },
158
+ {
159
+ "id": "ct-assemble",
160
+ "row": 10,
161
+ "kind": "step",
162
+ "n": "8",
163
+ "title": "Assemble the three reports",
164
+ "desc": "One summary carries the design direction, what each contributing skill changed, the theme that was written, and anything one of them flagged.",
165
+ "lines": [
166
+ 30,
167
+ 30
168
+ ],
169
+ "anchor": "Assemble the three reports into the assembled report: the de"
170
+ },
171
+ {
172
+ "id": "ct-ver",
173
+ "row": 11,
174
+ "kind": "step",
175
+ "title": "Verify the whole look",
176
+ "desc": "Each contributing skill reports back, save-theme names the theme it wrote, and the running app shows the look after a reload.",
177
+ "lines": [
178
+ 74,
179
+ 80
180
+ ],
181
+ "anchor": "## Verify",
182
+ "anchorEnd": "- To return to the previous look, load the earlier theme fro"
183
+ },
184
+ {
185
+ "id": "ct-refine-q",
186
+ "row": 12,
187
+ "kind": "decide",
188
+ "title": "Refine the look?",
189
+ "desc": "One adjective usually names one dimension, and that dimension owns the refinement.",
190
+ "lines": [
191
+ 49,
192
+ 52
193
+ ],
194
+ "anchor": "## Refining a look",
195
+ "anchorEnd": "usually names one dimension. Route it rather than re-reading"
196
+ },
197
+ {
198
+ "id": "ct-refine",
199
+ "row": 13,
200
+ "kind": "step",
201
+ "title": "Route the refinement to one contributing skill",
202
+ "desc": "Warmer and calmer go to set-colors, a type voice to set-type, rounder and tighter to set-geometry.",
203
+ "lines": [
204
+ 54,
205
+ 58
206
+ ],
207
+ "anchor": "| The user says | Goes to |",
208
+ "anchorEnd": "| rounder, sharper, pill buttons, tighter, airier, thicker b"
209
+ },
210
+ {
211
+ "id": "ct-done",
212
+ "row": 13,
213
+ "kind": "done",
214
+ "title": "Look complete",
215
+ "desc": "save-theme wrote the theme and opened it, which cleared the three buffers. Adopt, in the editor, ships it.",
216
+ "lines": [
217
+ 66,
218
+ 72
219
+ ],
220
+ "anchor": "Color, type, and geometry each write an unsaved buffer, whic",
221
+ "anchorEnd": "new families."
222
+ }
223
+ ],
224
+ "edges": [
225
+ {
226
+ "from": "ct-trig",
227
+ "to": "ct-direction"
228
+ },
229
+ {
230
+ "from": "ct-direction",
231
+ "to": "ct-index"
232
+ },
233
+ {
234
+ "from": "ct-index",
235
+ "to": "ct-intents"
236
+ },
237
+ {
238
+ "from": "ct-intents",
239
+ "to": "ct-colors"
240
+ },
241
+ {
242
+ "from": "ct-colors",
243
+ "to": "ct-type-q"
244
+ },
245
+ {
246
+ "from": "ct-type-q",
247
+ "to": "ct-type",
248
+ "label": "set type"
249
+ },
250
+ {
251
+ "from": "ct-type-q",
252
+ "to": "ct-geo-q",
253
+ "label": "keep type"
254
+ },
255
+ {
256
+ "from": "ct-type",
257
+ "to": "ct-geo-q"
258
+ },
259
+ {
260
+ "from": "ct-geo-q",
261
+ "to": "ct-geo",
262
+ "label": "set geometry"
263
+ },
264
+ {
265
+ "from": "ct-geo-q",
266
+ "to": "ct-save",
267
+ "label": "keep geometry"
268
+ },
269
+ {
270
+ "from": "ct-geo",
271
+ "to": "ct-save"
272
+ },
273
+ {
274
+ "from": "ct-save",
275
+ "to": "ct-assemble"
276
+ },
277
+ {
278
+ "from": "ct-assemble",
279
+ "to": "ct-ver"
280
+ },
281
+ {
282
+ "from": "ct-ver",
283
+ "to": "ct-refine-q"
284
+ },
285
+ {
286
+ "from": "ct-refine-q",
287
+ "to": "ct-refine",
288
+ "label": "one dimension"
289
+ },
290
+ {
291
+ "from": "ct-refine-q",
292
+ "to": "ct-direction",
293
+ "label": "spans dimensions",
294
+ "back": true
295
+ },
296
+ {
297
+ "from": "ct-refine-q",
298
+ "to": "ct-done",
299
+ "label": "done"
300
+ },
301
+ {
302
+ "from": "ct-refine",
303
+ "to": "ct-done"
304
+ }
305
+ ]
306
+ },
307
+ "set-colors": {
308
+ "id": "live-tokens-set-colors",
309
+ "digest": "sha256:ed316c987e1cb5c4",
310
+ "title": "set-colors",
311
+ "tagline": "Ten base colors become every ramp, gated on AA contrast, written into the live look.",
312
+ "nodes": [
313
+ {
314
+ "id": "sc-trig",
315
+ "row": 0,
316
+ "kind": "trigger",
317
+ "title": "Set or refine a palette",
318
+ "desc": "A palette, colors, or hues by mood, style, or hue, and every color refinement. create-theme supplies the color intent for a whole look.",
319
+ "lines": [
320
+ 2,
321
+ 15
322
+ ],
323
+ "anchor": "name: live-tokens-set-colors",
324
+ "anchorEnd": "theme in the editor, or running `save-theme`, turns the live"
325
+ },
326
+ {
327
+ "id": "sc-anchor",
328
+ "row": 1,
88
329
  "kind": "ref",
89
- "title": "Use generic color and geometry rules",
330
+ "title": "Read the color anchor",
331
+ "desc": "An anchor the color intent names overrides the generic bands. Say which anchor you took.",
332
+ "reference": "references/color-anchors.md",
90
333
  "lines": [
91
- 127,
92
- 127
334
+ 19,
335
+ 19
93
336
  ],
94
- "anchor": "Most briefs hit the first file. A brief that matches two (\"c"
337
+ "anchor": "Read the color intent. When it names an anchor (a feeling, a"
95
338
  },
96
339
  {
97
- "id": "gt-seed",
98
- "row": 4,
340
+ "id": "sc-base-colors",
341
+ "row": 2,
99
342
  "kind": "step",
100
- "n": "3",
101
- "title": "Define ten OKLCH seeds",
102
- "desc": "scratch/<slug>-brief.json records Brand, Accent, Special, Canvas, Neutral, Alternate, and four status seeds.",
343
+ "n": "2",
344
+ "title": "Define ten OKLCH base colors",
345
+ "desc": "Brand, Accent, Special, Canvas, Neutral, Alternate, and four statuses go to scratch/<slug>-base-colors.json, which is the only copy.",
103
346
  "lines": [
104
- 14,
105
- 14
347
+ 20,
348
+ 20
106
349
  ],
107
- "anchor": "Translate the brief into a seed file using the framework bel"
350
+ "anchor": "Translate the intent into ten base colors using the framewor"
108
351
  },
109
352
  {
110
- "id": "gt-cons",
111
- "row": 5,
353
+ "id": "sc-cons",
354
+ "row": 3,
112
355
  "kind": "chipset",
113
356
  "title": "Apply all palette constraints",
357
+ "lines": [
358
+ 27,
359
+ 120
360
+ ],
361
+ "anchor": "## The base color file",
362
+ "anchorEnd": "Shadow opacity derives from Canvas lightness and re-derives ",
114
363
  "chips": [
115
364
  {
116
- "label": "Brief schema",
365
+ "label": "Base color file schema",
117
366
  "lines": [
118
- 24,
119
- 47
367
+ 27,
368
+ 49
120
369
  ],
121
- "anchor": "## The brief",
370
+ "anchor": "## The base color file",
122
371
  "anchorEnd": "Roles: **Brand** is the dominant chromatic identity; **Accen"
123
372
  },
124
373
  {
125
374
  "label": "Chroma budget",
126
375
  "lines": [
127
- 49,
128
- 58
376
+ 51,
377
+ 61
129
378
  ],
130
379
  "anchor": "## Chroma budget: color is inversely proportional to area",
131
380
  "anchorEnd": "A good theme reads as 3 or 4 hue families on screen, never 1"
@@ -133,8 +382,8 @@ export const skillTrees: Record<string, SkillTree> = {
133
382
  {
134
383
  "label": "Role bands",
135
384
  "lines": [
136
- 60,
137
- 72
385
+ 63,
386
+ 75
138
387
  ],
139
388
  "anchor": "## Per-role bands",
140
389
  "anchorEnd": "| Danger | shared status L, C 0.15 to 0.20 | same | H 20 to "
@@ -142,17 +391,26 @@ export const skillTrees: Record<string, SkillTree> = {
142
391
  {
143
392
  "label": "Canvas commitment",
144
393
  "lines": [
145
- 74,
146
- 87
394
+ 77,
395
+ 81
147
396
  ],
148
397
  "anchor": "**The canvas carries the theme's identity, so commit to it.*",
149
- "anchorEnd": ""
398
+ "anchorEnd": "*Full-color ground* (holiday and statement intents): the can"
399
+ },
400
+ {
401
+ "label": "Dark scheme and status lightness",
402
+ "lines": [
403
+ 83,
404
+ 89
405
+ ],
406
+ "anchor": "Also:",
407
+ "anchorEnd": "- Status hues never rotate with the harmony; only their L an"
150
408
  },
151
409
  {
152
410
  "label": "Mood dials",
153
411
  "lines": [
154
- 88,
155
- 94
412
+ 91,
413
+ 97
156
414
  ],
157
415
  "anchor": "## Mood dials",
158
416
  "anchorEnd": "Avoid mid-lightness yellow-green (H 100 to 120 at L 0.5 to 0"
@@ -160,8 +418,8 @@ export const skillTrees: Record<string, SkillTree> = {
160
418
  {
161
419
  "label": "Gamut guardrails",
162
420
  "lines": [
163
- 96,
164
- 103
421
+ 99,
422
+ 106
165
423
  ],
166
424
  "anchor": "## Gamut guardrails",
167
425
  "anchorEnd": "- Peak chroma anchors: red H20 C 0.25 at L 0.63; orange H60 "
@@ -169,8 +427,8 @@ export const skillTrees: Record<string, SkillTree> = {
169
427
  {
170
428
  "label": "Hue harmony",
171
429
  "lines": [
172
- 105,
173
- 111
430
+ 108,
431
+ 114
174
432
  ],
175
433
  "anchor": "## Harmony",
176
434
  "anchorEnd": "- Drama or maximum contrast: complementary, triadic, or tetr"
@@ -178,368 +436,208 @@ export const skillTrees: Record<string, SkillTree> = {
178
436
  {
179
437
  "label": "Canvas gradient and shadows",
180
438
  "lines": [
181
- 113,
182
- 117
439
+ 116,
440
+ 120
183
441
  ],
184
442
  "anchor": "## Canvas sky and shadows",
185
443
  "anchorEnd": "Shadow opacity derives from Canvas lightness and re-derives "
186
444
  }
187
- ],
188
- "tag": "constraints"
445
+ ]
189
446
  },
190
447
  {
191
- "id": "gt-cli",
192
- "row": 6,
448
+ "id": "sc-cli",
449
+ "row": 4,
193
450
  "kind": "cli",
194
- "n": "4",
195
- "title": "Generate and validate the theme",
196
- "desc": "The CLI writes and opens themes/<slug>.json and reports contrast. Reruns replace every color, including editor edits. --carry-from <theme> copies gradients, fonts, and component aliases.",
451
+ "n": "3",
452
+ "title": "Write the color buffer",
453
+ "desc": "The CLI builds every ramp, enforces AA contrast on the derived text tokens, writes the result into the unsaved buffer the page already runs, and prints a contrast report.",
197
454
  "lines": [
198
- 15,
199
- 15
455
+ 21,
456
+ 21
200
457
  ],
201
- "anchor": "Run `npx live-tokens generate-theme scratch/<slug>-brief.jso",
458
+ "anchor": "Run `npx live-tokens set-colors scratch/<slug>-base-colors.j",
459
+ "command": "npx live-tokens set-colors scratch/<slug>-base-colors.json",
202
460
  "chips": [
203
461
  {
204
462
  "label": "Flags",
205
463
  "lines": [
206
- 22,
207
- 22
464
+ 25,
465
+ 25
208
466
  ],
209
- "anchor": "Flags: `--dry-run` prints the report without writing; `--no-"
467
+ "anchor": "Flags: `--dry-run` prints the contrast report without writin"
210
468
  }
211
- ],
212
- "command": "npx live-tokens generate-theme scratch/<slug>-brief.json"
469
+ ]
213
470
  },
214
471
  {
215
- "id": "gt-fail",
216
- "row": 7,
472
+ "id": "sc-fail",
473
+ "row": 5,
217
474
  "kind": "gate",
218
- "title": "A seed fails validation",
219
- "desc": "The report names the failed seed. A valid repair raises its lightness or reduces its chroma before the next run.",
475
+ "title": "A base color fails validation",
476
+ "desc": "Each failure line names the base color to change, usually by raising its lightness or cutting its chroma.",
220
477
  "lines": [
221
- 15,
222
- 15
478
+ 22,
479
+ 22
223
480
  ],
224
- "anchor": "Run `npx live-tokens generate-theme scratch/<slug>-brief.jso"
481
+ "anchor": "Read the report. Exit 0 passes, and auto-corrected values co"
225
482
  },
226
483
  {
227
- "id": "gt-pass",
228
- "row": 7,
484
+ "id": "sc-pass",
485
+ "row": 5,
229
486
  "kind": "ok",
230
487
  "title": "Colors pass validation",
231
- "desc": "The flow continues to the type and geometry decisions.",
232
- "lines": [
233
- 15,
234
- 15
235
- ],
236
- "anchor": "Run `npx live-tokens generate-theme scratch/<slug>-brief.jso"
237
- },
238
- {
239
- "id": "gt-type-q",
240
- "row": 8,
241
- "kind": "decide",
242
- "title": "Preserve the current type?",
243
- "desc": "An explicit color-only instruction preserves current type. Complete themes pair type through pair-fonts.",
244
- "lines": [
245
- 16,
246
- 16
247
- ],
248
- "anchor": "Invoke **live-tokens-pair-fonts** with the same voice. Skip "
249
- },
250
- {
251
- "id": "gt-fonts",
252
- "row": 9,
253
- "kind": "hand",
254
- "n": "5",
255
- "title": "Pair fonts from the same voice",
256
- "desc": "pair-fonts receives the voice sentence and aligns the type with the theme.",
257
- "lines": [
258
- 16,
259
- 16
260
- ],
261
- "anchor": "Invoke **live-tokens-pair-fonts** with the same voice. Skip "
262
- },
263
- {
264
- "id": "gt-geo-q",
265
- "row": 10,
266
- "kind": "decide",
267
- "title": "Does the theme need geometry changes?",
268
- "desc": "A shape or spacing cue continues to adjust-geometry. A neutral geometry voice preserves current aliases.",
269
- "lines": [
270
- 17,
271
- 17
272
- ],
273
- "anchor": "Invoke **live-tokens-adjust-geometry** with the geometry the"
274
- },
275
- {
276
- "id": "gt-geo",
277
- "row": 12,
278
- "kind": "hand",
279
- "n": "6",
280
- "title": "Adjust geometry from the same voice",
281
- "desc": "adjust-geometry receives the geometry intent. Anchor geometry overrides the voice table.",
282
- "lines": [
283
- 17,
284
- 17
285
- ],
286
- "anchor": "Invoke **live-tokens-adjust-geometry** with the geometry the"
287
- },
288
- {
289
- "id": "gt-geotab",
290
- "row": 11,
291
- "kind": "chipset",
292
- "title": "Prepare the geometry hand-off",
293
- "chips": [
294
- {
295
- "label": "Voice-to-geometry map",
296
- "lines": [
297
- 129,
298
- 140
299
- ],
300
- "anchor": "## Geometry from the voice",
301
- "anchorEnd": "This table is the fallback. When the brief matched an entry "
302
- },
303
- {
304
- "label": "Safe operation order",
305
- "lines": [
306
- 20,
307
- 20
308
- ],
309
- "anchor": "Order matters only for safety, and the order above is safe: "
310
- },
311
- {
312
- "label": "Output files",
313
- "lines": [
314
- 148,
315
- 150
316
- ],
317
- "anchor": "## Files each step writes",
318
- "anchorEnd": "Color writes `themes/<slug>.json` and opens it. Type and geo"
319
- }
320
- ],
321
- "tag": "sources"
322
- },
323
- {
324
- "id": "gt-tell",
325
- "row": 13,
326
- "kind": "step",
327
- "n": "7",
328
- "title": "Reload and review the theme",
329
- "desc": "The browser holds type and geometry in the working buffer until Save. Further revisions update the same brief.",
488
+ "desc": "Auto-corrected values count as passing.",
330
489
  "lines": [
331
- 18,
332
- 18
490
+ 22,
491
+ 22
333
492
  ],
334
- "anchor": "Tell the user to look at the running app, and that type and "
493
+ "anchor": "Read the report. Exit 0 passes, and auto-corrected values co"
335
494
  },
336
495
  {
337
- "id": "gt-ver",
338
- "row": 14,
496
+ "id": "sc-report",
497
+ "row": 6,
339
498
  "kind": "step",
340
- "title": "Verify the complete theme",
341
- "desc": "Colors pass validation, each invoked sibling reports success, and the reloaded app shows the complete theme. Selecting the previous theme restores the prior look.",
499
+ "n": "5",
500
+ "title": "Report back",
501
+ "desc": "The line back to create-theme names the scheme, the hue families on screen, the canvas commitment level, and anything auto-corrected.",
342
502
  "lines": [
343
- 152,
344
- 156
503
+ 23,
504
+ 23
345
505
  ],
346
- "anchor": "## Verify",
347
- "anchorEnd": "- To return to the previous look, load the theme the CLI out"
506
+ "anchor": "Report back in a line: the scheme, the hue families on scree"
348
507
  },
349
508
  {
350
- "id": "gt-refine-q",
351
- "row": 15,
509
+ "id": "sc-refine-q",
510
+ "row": 7,
352
511
  "kind": "decide",
353
- "title": "Refine the theme?",
354
- "desc": "Every refinement updates the existing seed brief. The generator owns the derived theme data.",
355
- "lines": [
356
- 142,
357
- 146
358
- ],
359
- "anchor": "## Refining a theme that exists",
360
- "anchorEnd": "One adjective moves one dial. Warmer and cooler rotate hue; "
361
- },
362
- {
363
- "id": "gt-refine",
364
- "row": 16,
365
- "kind": "step",
366
- "tag": "Follow-up",
367
- "title": "Refine the seed brief",
368
- "desc": "The scratch brief supplies seeds. The theme file recovers them after scratch-file loss. Each refinement moves one requested dial and retains the other seeds.",
512
+ "title": "Refine the color?",
513
+ "desc": "Warmer, calmer, or more contrast arrives against a theme that is already open, and the answer is a new base color file.",
369
514
  "lines": [
370
- 142,
371
- 146
372
- ],
373
- "anchor": "## Refining a theme that exists",
374
- "anchorEnd": "One adjective moves one dial. Warmer and cooler rotate hue; "
375
- },
376
- {
377
- "id": "gt-done",
378
- "row": 16,
379
- "kind": "done",
380
- "title": "Theme complete",
381
- "desc": "generate-theme has written the colors. Saving the open theme keeps any type or geometry changes.",
382
- "lines": [
383
- 148,
384
- 150
385
- ],
386
- "anchor": "## Files each step writes",
387
- "anchorEnd": "Color writes `themes/<slug>.json` and opens it. Type and geo"
388
- }
389
- ],
390
- "edges": [
391
- {
392
- "from": "gt-trig",
393
- "to": "gt-voice"
394
- },
395
- {
396
- "from": "gt-voice",
397
- "to": "gt-anchor"
398
- },
399
- {
400
- "from": "gt-anchor",
401
- "to": "gt-mood",
402
- "label": "feeling"
403
- },
404
- {
405
- "from": "gt-anchor",
406
- "to": "gt-style",
407
- "label": "idiom or era"
408
- },
409
- {
410
- "from": "gt-anchor",
411
- "to": "gt-named",
412
- "label": "holiday, season, or scene"
413
- },
414
- {
415
- "from": "gt-anchor",
416
- "to": "gt-none",
417
- "label": "generic rules"
515
+ 122,
516
+ 124
517
+ ],
518
+ "anchor": "## Refining the color of a theme that exists",
519
+ "anchorEnd": "\"Warmer\", \"calmer\", \"more contrast\" arrive against a theme t"
418
520
  },
419
521
  {
420
- "from": "gt-mood",
421
- "to": "gt-seed"
522
+ "id": "sc-refine",
523
+ "row": 8,
524
+ "kind": "step",
525
+ "title": "Move one dial and re-run",
526
+ "desc": "One adjective moves one dial. A re-run replaces the buffer's whole color state, so every base color the user did not name stays where it was.",
527
+ "lines": [
528
+ 126,
529
+ 126
530
+ ],
531
+ "anchor": "One adjective moves one dial. Warmer and cooler rotate hue; "
422
532
  },
423
533
  {
424
- "from": "gt-style",
425
- "to": "gt-seed"
426
- },
534
+ "id": "sc-done",
535
+ "row": 8,
536
+ "kind": "done",
537
+ "title": "Color set",
538
+ "desc": "The buffer holds the new color state, and type and geometry carried forward. A Save or a save-theme run keeps it, Adopt ships it.",
539
+ "lines": [
540
+ 128,
541
+ 133
542
+ ],
543
+ "anchor": "## Scope",
544
+ "anchorEnd": "ships it."
545
+ }
546
+ ],
547
+ "edges": [
427
548
  {
428
- "from": "gt-named",
429
- "to": "gt-seed"
549
+ "from": "sc-trig",
550
+ "to": "sc-anchor"
430
551
  },
431
552
  {
432
- "from": "gt-none",
433
- "to": "gt-seed"
553
+ "from": "sc-anchor",
554
+ "to": "sc-base-colors"
434
555
  },
435
556
  {
436
- "from": "gt-seed",
437
- "to": "gt-cons"
557
+ "from": "sc-base-colors",
558
+ "to": "sc-cons"
438
559
  },
439
560
  {
440
- "from": "gt-cons",
441
- "to": "gt-cli"
561
+ "from": "sc-cons",
562
+ "to": "sc-cli"
442
563
  },
443
564
  {
444
- "from": "gt-cli",
445
- "to": "gt-fail",
565
+ "from": "sc-cli",
566
+ "to": "sc-fail",
446
567
  "label": "exit 1"
447
568
  },
448
569
  {
449
- "from": "gt-cli",
450
- "to": "gt-pass",
570
+ "from": "sc-cli",
571
+ "to": "sc-pass",
451
572
  "label": "exit 0"
452
573
  },
453
574
  {
454
- "from": "gt-fail",
455
- "to": "gt-cli",
575
+ "from": "sc-fail",
576
+ "to": "sc-cli",
456
577
  "label": "rerun",
457
578
  "back": true
458
579
  },
459
580
  {
460
- "from": "gt-pass",
461
- "to": "gt-type-q"
462
- },
463
- {
464
- "from": "gt-type-q",
465
- "to": "gt-fonts",
466
- "label": "pair type"
581
+ "from": "sc-pass",
582
+ "to": "sc-report"
467
583
  },
468
584
  {
469
- "from": "gt-type-q",
470
- "to": "gt-geo-q",
471
- "label": "preserve type"
585
+ "from": "sc-report",
586
+ "to": "sc-refine-q"
472
587
  },
473
588
  {
474
- "from": "gt-fonts",
475
- "to": "gt-geo-q"
476
- },
477
- {
478
- "from": "gt-geo-q",
479
- "to": "gt-geotab",
480
- "label": "change geometry"
481
- },
482
- {
483
- "from": "gt-geotab",
484
- "to": "gt-geo"
485
- },
486
- {
487
- "from": "gt-geo",
488
- "to": "gt-tell"
489
- },
490
- {
491
- "from": "gt-geo-q",
492
- "to": "gt-tell",
493
- "label": "preserve geometry"
494
- },
495
- {
496
- "from": "gt-tell",
497
- "to": "gt-ver"
498
- },
499
- {
500
- "from": "gt-ver",
501
- "to": "gt-refine-q"
502
- },
503
- {
504
- "from": "gt-refine-q",
505
- "to": "gt-refine",
589
+ "from": "sc-refine-q",
590
+ "to": "sc-refine",
506
591
  "label": "refine"
507
592
  },
508
593
  {
509
- "from": "gt-refine-q",
510
- "to": "gt-done",
511
- "label": "done"
512
- },
513
- {
514
- "from": "gt-refine",
515
- "to": "gt-cli",
594
+ "from": "sc-refine",
595
+ "to": "sc-cli",
516
596
  "label": "regenerate",
517
597
  "back": true
598
+ },
599
+ {
600
+ "from": "sc-refine-q",
601
+ "to": "sc-done",
602
+ "label": "done"
518
603
  }
519
604
  ]
520
605
  },
521
- "pair-fonts": {
522
- "id": "live-tokens-pair-fonts",
523
- "digest": "sha256:f5f807a05b7665e2",
524
- "title": "pair-fonts",
606
+ "set-type": {
607
+ "id": "live-tokens-set-type",
608
+ "digest": "sha256:9a82b5b14ddebdc0",
609
+ "title": "set-type",
525
610
  "tagline": "Choose the families; the CLI verifies them and builds URLs for their available weights.",
526
611
  "nodes": [
527
612
  {
528
- "id": "pf-trig",
613
+ "id": "st-trig",
529
614
  "row": 0,
530
615
  "kind": "trigger",
531
616
  "title": "Choose or pair font families",
532
- "desc": "The pairing selects or restyles font families. generate-theme supplies the type voice for complete themes.",
617
+ "desc": "The pairing selects or restyles font families. create-theme supplies the type intent for complete themes.",
533
618
  "lines": [
534
619
  2,
535
620
  6
536
621
  ],
537
- "anchor": "name: live-tokens-pair-fonts",
538
- "anchorEnd": "# Pairing fonts for a theme"
622
+ "anchor": "name: live-tokens-set-type",
623
+ "anchorEnd": "# Setting a theme's fonts"
539
624
  },
540
625
  {
541
- "id": "pf-pool",
626
+ "id": "st-anchor",
542
627
  "row": 1,
628
+ "kind": "ref",
629
+ "title": "Read the type anchor",
630
+ "desc": "An anchor the type intent names overrides the voice table. Occasions fix color only, so their type comes from the feeling they imply.",
631
+ "reference": "references/type-anchors.md",
632
+ "lines": [
633
+ 12,
634
+ 12
635
+ ],
636
+ "anchor": "Read the type intent. When it names an anchor (a feeling, an"
637
+ },
638
+ {
639
+ "id": "st-pool",
640
+ "row": 2,
543
641
  "kind": "step",
544
642
  "title": "Use Google Fonts with the CLI",
545
643
  "desc": "The CLI manages Google Fonts. The editor's Project fonts section handles other sources.",
@@ -550,92 +648,92 @@ export const skillTrees: Record<string, SkillTree> = {
550
648
  "anchor": "You choose the families; the CLI verifies each against Googl"
551
649
  },
552
650
  {
553
- "id": "pf-body",
554
- "row": 2,
651
+ "id": "st-body",
652
+ "row": 3,
555
653
  "kind": "step",
556
654
  "title": "Choose the body face first",
557
655
  "desc": "Body faces need regular, bold, italic, open apertures, a large x-height, and low or moderate contrast. Families that miss a requirement belong in display.",
558
656
  "lines": [
559
- 29,
560
- 31
657
+ 30,
658
+ 32
561
659
  ],
562
660
  "anchor": "## Choose the body face first",
563
661
  "anchorEnd": "The body face is the anchor. It carries most of the words, a"
564
662
  },
565
663
  {
566
- "id": "pf-spec",
567
- "row": 3,
664
+ "id": "st-spec",
665
+ "row": 4,
568
666
  "kind": "decide",
569
- "title": "Does the brief define a specific voice?",
570
- "desc": "A specific voice follows the full matrix. A vague or quiet brief takes a conservative pairing.",
667
+ "title": "Does the type intent name a specific voice?",
668
+ "desc": "A specific voice follows the full matrix. A vague or quiet type intent takes a conservative pairing.",
571
669
  "lines": [
572
- 65,
573
- 67
670
+ 68,
671
+ 70
574
672
  ],
575
673
  "anchor": "## Shortcuts",
576
674
  "anchorEnd": "These find an adequate pairing fast and skip the reasoning; "
577
675
  },
578
676
  {
579
- "id": "pf-matrix",
580
- "row": 4,
677
+ "id": "st-matrix",
678
+ "row": 5,
581
679
  "kind": "step",
582
680
  "title": "Classify each face by form and finish",
583
681
  "desc": "Form describes its model: dynamic, rational, or geometric. Finish describes stroke contrast and serif treatment.",
584
682
  "lines": [
585
- 35,
683
+ 36,
586
684
  44
587
685
  ],
588
686
  "anchor": "## The font matrix: the decision rule",
589
- "anchorEnd": ""
687
+ "anchorEnd": "| **Geometric** | monolinear, circle-and-line | technical, m"
590
688
  },
591
689
  {
592
- "id": "pf-short",
593
- "row": 4,
690
+ "id": "st-short",
691
+ "row": 5,
594
692
  "kind": "step",
595
693
  "title": "Choose a conservative pairing",
596
694
  "desc": "Conservative options include a superfamily, one family across weights, two families by one designer, or a serif display face with a sans body.",
597
695
  "lines": [
598
- 65,
599
- 72
696
+ 68,
697
+ 75
600
698
  ],
601
699
  "anchor": "## Shortcuts",
602
700
  "anchorEnd": "- **Serif display over sans body** when nothing else decides"
603
701
  },
604
702
  {
605
- "id": "pf-rule",
606
- "row": 5,
703
+ "id": "st-rule",
704
+ "row": 6,
607
705
  "kind": "chipset",
608
706
  "title": "Compare form and finish",
609
707
  "chips": [
610
708
  {
611
709
  "label": "Same form, different finish: reliable",
612
710
  "lines": [
613
- 45,
614
- 45
711
+ 46,
712
+ 46
615
713
  ],
616
714
  "anchor": "- **Same skeleton, different flesh: reliable.** Helvetica an"
617
715
  },
618
716
  {
619
717
  "label": "Same finish, different form: clashes",
620
718
  "lines": [
621
- 46,
622
- 46
719
+ 47,
720
+ 47
623
721
  ],
624
722
  "anchor": "- **Same flesh, different skeleton: the failure case.** The "
625
723
  },
626
724
  {
627
725
  "label": "Different on both: deliberate contrast",
628
726
  "lines": [
629
- 47,
630
- 47
727
+ 48,
728
+ 48
631
729
  ],
632
730
  "anchor": "- **Far apart on both: works, deliberately.** An unmistakabl"
633
731
  },
634
732
  {
635
733
  "label": "Faces between models",
636
734
  "lines": [
637
- 49,
638
- 49
735
+ 50,
736
+ 50
639
737
  ],
640
738
  "anchor": "Many faces sit between columns. When one straddles, say so a"
641
739
  }
@@ -643,114 +741,114 @@ export const skillTrees: Record<string, SkillTree> = {
643
741
  "tag": "pairing rule"
644
742
  },
645
743
  {
646
- "id": "pf-voice",
647
- "row": 6,
744
+ "id": "st-voice",
745
+ "row": 7,
648
746
  "kind": "step",
649
- "title": "Match the pairing to the theme voice",
650
- "desc": "The pairing matches type and color to the same brief. Conflicting voices make them feel unrelated.",
747
+ "title": "Match the pairing to the design direction",
748
+ "desc": "The pairing matches type and color to the same design direction. Conflicting voices make them feel unrelated.",
651
749
  "lines": [
652
- 51,
653
- 63
750
+ 52,
751
+ 66
654
752
  ],
655
753
  "anchor": "## Voice",
656
- "anchorEnd": "Match the type to the same brief the color came from. A warm"
754
+ "anchorEnd": "Match the type to the same design direction the color came f"
657
755
  },
658
756
  {
659
- "id": "pf-watch",
660
- "row": 7,
757
+ "id": "st-watch",
758
+ "row": 8,
661
759
  "kind": "chipset",
662
760
  "title": "Check four pairing risks",
663
761
  "chips": [
664
762
  {
665
763
  "label": "x-height parity",
666
764
  "lines": [
667
- 76,
668
- 76
765
+ 79,
766
+ 79
669
767
  ],
670
768
  "anchor": "- **x-height parity.** Both faces are set from one size scal"
671
769
  },
672
770
  {
673
771
  "label": "Small-size legibility",
674
772
  "lines": [
675
- 77,
676
- 77
773
+ 80,
774
+ 80
677
775
  ],
678
776
  "anchor": "- **Print faces at small sizes.** Delicate serifs and high s"
679
777
  },
680
778
  {
681
779
  "label": "More than two families",
682
780
  "lines": [
683
- 78,
684
- 78
781
+ 81,
782
+ 81
685
783
  ],
686
- "anchor": "- **Every family is a request.** Two is the target; three ne"
784
+ "anchor": "- **Every family is a download.** Two is the target; three n"
687
785
  },
688
786
  {
689
787
  "label": "Repeated families across theme sets",
690
788
  "lines": [
691
- 79,
692
- 79
789
+ 82,
790
+ 82
693
791
  ],
694
792
  "anchor": "- **Sets of themes:** no two share a display face or a body "
695
793
  }
696
794
  ],
697
795
  "lines": [
698
- 74,
699
- 74
796
+ 77,
797
+ 77
700
798
  ],
701
799
  "anchor": "## Watch for",
702
800
  "tag": "risks"
703
801
  },
704
802
  {
705
- "id": "pf-brief",
706
- "row": 8,
803
+ "id": "st-pairing",
804
+ "row": 9,
707
805
  "kind": "step",
708
806
  "n": "1",
709
- "title": "Write scratch/font-brief.json",
710
- "desc": "The brief changes listed slots and preserves the rest. Display maps to --font-display; body maps to --font-sans. Serif, mono, and editorial serve specialized roles.",
807
+ "title": "Write scratch/font-pairing.json",
808
+ "desc": "The pairing file changes listed slots and preserves the rest. Display maps to --font-display; body maps to --font-sans. Serif, mono, and editorial serve specialized roles.",
711
809
  "lines": [
712
810
  12,
713
811
  12
714
812
  ],
715
- "anchor": "Choose the pairing with the framework below and write a brie"
813
+ "anchor": "Read the type intent. When it names an anchor (a feeling, an"
716
814
  },
717
815
  {
718
- "id": "pf-shape",
719
- "row": 9,
816
+ "id": "st-shape",
817
+ "row": 10,
720
818
  "kind": "chipset",
721
- "title": "Check font brief fields and flags",
819
+ "title": "Check pairing file fields and flags",
722
820
  "chips": [
723
821
  {
724
822
  "label": "Slots and stacks",
725
823
  "lines": [
726
- 21,
727
- 27
824
+ 22,
825
+ 28
728
826
  ],
729
- "anchor": "## The brief",
827
+ "anchor": "## The pairing file",
730
828
  "anchorEnd": "Every slot is optional and an omitted slot is left exactly a"
731
829
  },
732
830
  {
733
831
  "label": "Pairing rationale",
734
832
  "lines": [
735
- 17,
736
- 17
833
+ 18,
834
+ 18
737
835
  ],
738
836
  "anchor": "State your reasoning when you propose the pairing: each face"
739
837
  },
740
838
  {
741
839
  "label": "Flags",
742
840
  "lines": [
743
- 19,
744
- 19
841
+ 20,
842
+ 20
745
843
  ],
746
844
  "anchor": "Flags: `--dry-run` reports without writing. `--no-verify` sk"
747
845
  }
748
846
  ],
749
- "tag": "brief"
847
+ "tag": "pairing file"
750
848
  },
751
849
  {
752
- "id": "pf-cli",
753
- "row": 10,
850
+ "id": "st-cli",
851
+ "row": 11,
754
852
  "kind": "cli",
755
853
  "n": "2",
756
854
  "title": "Validate and apply the font stacks",
@@ -759,12 +857,12 @@ export const skillTrees: Record<string, SkillTree> = {
759
857
  13,
760
858
  13
761
859
  ],
762
- "anchor": "Run `npx live-tokens set-fonts scratch/font-brief.json`. It ",
763
- "command": "npx live-tokens set-fonts scratch/font-brief.json"
860
+ "anchor": "Run `npx live-tokens set-type scratch/font-pairing.json`. I",
861
+ "command": "npx live-tokens set-type scratch/font-pairing.json"
764
862
  },
765
863
  {
766
- "id": "pf-fail",
767
- "row": 11,
864
+ "id": "st-fail",
865
+ "row": 12,
768
866
  "kind": "gate",
769
867
  "title": "Google Fonts lacks a family",
770
868
  "desc": "The next run uses a valid Google Fonts family name.",
@@ -775,8 +873,8 @@ export const skillTrees: Record<string, SkillTree> = {
775
873
  "anchor": "Read the report. A weight gap is a quality note: name it and"
776
874
  },
777
875
  {
778
- "id": "pf-gap",
779
- "row": 11,
876
+ "id": "st-gap",
877
+ "row": 12,
780
878
  "kind": "ok",
781
879
  "n": "3",
782
880
  "title": "The CLI applies the font stacks",
@@ -788,21 +886,34 @@ export const skillTrees: Record<string, SkillTree> = {
788
886
  "anchor": "Read the report. A weight gap is a quality note: name it and"
789
887
  },
790
888
  {
791
- "id": "pf-tell",
792
- "row": 12,
889
+ "id": "st-report",
890
+ "row": 13,
793
891
  "kind": "step",
794
892
  "n": "4",
795
- "title": "Reload and review the type",
796
- "desc": "Reloading before Save gives the editor the new buffer. Save then keeps the change.",
893
+ "title": "Report back",
894
+ "desc": "The line back to create-theme names both families, the form model behind each, and any weight gap worth naming.",
797
895
  "lines": [
798
896
  15,
799
897
  15
800
898
  ],
899
+ "anchor": "Report back in a line: the two families, the form model behi"
900
+ },
901
+ {
902
+ "id": "st-tell",
903
+ "row": 14,
904
+ "kind": "step",
905
+ "n": "5",
906
+ "title": "Reload and review the type",
907
+ "desc": "Reloading before Save gives the editor the new buffer. Save then keeps the change.",
908
+ "lines": [
909
+ 16,
910
+ 16
911
+ ],
801
912
  "anchor": "Tell the user to reload the editor page before saving. A run"
802
913
  },
803
914
  {
804
- "id": "pf-scope",
805
- "row": 13,
915
+ "id": "st-scope",
916
+ "row": 15,
806
917
  "kind": "chipset",
807
918
  "title": "Font-family scope",
808
919
  "desc": "Font-family changes preserve color, component aliases, geometry, and the type scale.",
@@ -810,8 +921,8 @@ export const skillTrees: Record<string, SkillTree> = {
810
921
  {
811
922
  "label": "Buffer, Save, and Adopt",
812
923
  "lines": [
813
- 81,
814
- 83
924
+ 84,
925
+ 86
815
926
  ],
816
927
  "anchor": "## Scope",
817
928
  "anchorEnd": "Type only. Color, component aliases, shape, and the type sca"
@@ -820,178 +931,199 @@ export const skillTrees: Record<string, SkillTree> = {
820
931
  "tag": "scope"
821
932
  },
822
933
  {
823
- "id": "pf-ver",
824
- "row": 14,
934
+ "id": "st-ver",
935
+ "row": 16,
825
936
  "kind": "done",
826
937
  "title": "Verify the type",
827
938
  "desc": "The report lists stacks and weights; the CLI builds matching URLs. Reloading shows the new type. Reselecting the open theme restores the previous type.",
828
939
  "lines": [
829
- 85,
830
- 90
940
+ 88,
941
+ 93
831
942
  ],
832
943
  "anchor": "## Verify",
833
- "anchorEnd": "- To revert, run the inverse brief, or load the open theme a"
944
+ "anchorEnd": "- To revert, run the inverse pairing file, or load the open "
834
945
  }
835
946
  ],
836
947
  "edges": [
837
948
  {
838
- "from": "pf-trig",
839
- "to": "pf-pool"
949
+ "from": "st-trig",
950
+ "to": "st-anchor"
951
+ },
952
+ {
953
+ "from": "st-anchor",
954
+ "to": "st-pool"
840
955
  },
841
956
  {
842
- "from": "pf-pool",
843
- "to": "pf-body"
957
+ "from": "st-pool",
958
+ "to": "st-body"
844
959
  },
845
960
  {
846
- "from": "pf-body",
847
- "to": "pf-spec"
961
+ "from": "st-body",
962
+ "to": "st-spec"
848
963
  },
849
964
  {
850
- "from": "pf-spec",
851
- "to": "pf-matrix",
965
+ "from": "st-spec",
966
+ "to": "st-matrix",
852
967
  "label": "specific"
853
968
  },
854
969
  {
855
- "from": "pf-spec",
856
- "to": "pf-short",
970
+ "from": "st-spec",
971
+ "to": "st-short",
857
972
  "label": "vague or quiet"
858
973
  },
859
974
  {
860
- "from": "pf-matrix",
861
- "to": "pf-rule"
975
+ "from": "st-matrix",
976
+ "to": "st-rule"
862
977
  },
863
978
  {
864
- "from": "pf-rule",
865
- "to": "pf-voice"
979
+ "from": "st-rule",
980
+ "to": "st-voice"
866
981
  },
867
982
  {
868
- "from": "pf-short",
869
- "to": "pf-voice"
983
+ "from": "st-short",
984
+ "to": "st-voice"
870
985
  },
871
986
  {
872
- "from": "pf-voice",
873
- "to": "pf-watch"
987
+ "from": "st-voice",
988
+ "to": "st-watch"
874
989
  },
875
990
  {
876
- "from": "pf-watch",
877
- "to": "pf-brief"
991
+ "from": "st-watch",
992
+ "to": "st-pairing"
878
993
  },
879
994
  {
880
- "from": "pf-brief",
881
- "to": "pf-shape"
995
+ "from": "st-pairing",
996
+ "to": "st-shape"
882
997
  },
883
998
  {
884
- "from": "pf-shape",
885
- "to": "pf-cli"
999
+ "from": "st-shape",
1000
+ "to": "st-cli"
886
1001
  },
887
1002
  {
888
- "from": "pf-cli",
889
- "to": "pf-fail",
1003
+ "from": "st-cli",
1004
+ "to": "st-fail",
890
1005
  "label": "exit 1"
891
1006
  },
892
1007
  {
893
- "from": "pf-cli",
894
- "to": "pf-gap",
1008
+ "from": "st-cli",
1009
+ "to": "st-gap",
895
1010
  "label": "exit 0"
896
1011
  },
897
1012
  {
898
- "from": "pf-fail",
899
- "to": "pf-cli",
1013
+ "from": "st-fail",
1014
+ "to": "st-cli",
900
1015
  "label": "rerun",
901
1016
  "back": true
902
1017
  },
903
1018
  {
904
- "from": "pf-gap",
905
- "to": "pf-tell"
1019
+ "from": "st-gap",
1020
+ "to": "st-report"
906
1021
  },
907
1022
  {
908
- "from": "pf-tell",
909
- "to": "pf-scope"
1023
+ "from": "st-report",
1024
+ "to": "st-tell"
910
1025
  },
911
1026
  {
912
- "from": "pf-scope",
913
- "to": "pf-ver"
1027
+ "from": "st-tell",
1028
+ "to": "st-scope"
1029
+ },
1030
+ {
1031
+ "from": "st-scope",
1032
+ "to": "st-ver"
914
1033
  }
915
1034
  ]
916
1035
  },
917
- "adjust-geometry": {
918
- "id": "live-tokens-adjust-geometry",
919
- "digest": "sha256:cd28cf6a45c926e2",
920
- "title": "adjust-geometry",
1036
+ "set-geometry": {
1037
+ "id": "live-tokens-set-geometry",
1038
+ "digest": "sha256:c5b43383a2da10d2",
1039
+ "title": "set-geometry",
921
1040
  "tagline": "The CLI reads a small ops file, moves each alias along its token scale, and reports the result.",
922
1041
  "nodes": [
923
1042
  {
924
- "id": "ag-trig",
1043
+ "id": "sg-trig",
925
1044
  "row": 0,
926
1045
  "kind": "trigger",
927
1046
  "title": "Adjust shape or spacing",
928
- "desc": "Geometry changes cover radius, padding, gaps, border width, and density. generate-theme supplies the geometry intent for complete themes.",
1047
+ "desc": "Geometry changes cover radius, padding, gaps, border width, and density. create-theme supplies the geometry intent for complete themes.",
929
1048
  "lines": [
930
1049
  2,
931
1050
  8
932
1051
  ],
933
- "anchor": "name: live-tokens-adjust-geometry",
1052
+ "anchor": "name: live-tokens-set-geometry",
934
1053
  "anchorEnd": "You translate the request into a small ops file; the CLI res"
935
1054
  },
936
1055
  {
937
- "id": "ag-live",
1056
+ "id": "sg-anchor",
938
1057
  "row": 1,
1058
+ "kind": "ref",
1059
+ "title": "Read the geometry anchor",
1060
+ "desc": "An anchor the geometry intent names overrides the idiom table. Occasions fix color only, so their geometry comes from the feeling they imply.",
1061
+ "reference": "references/geometry-anchors.md",
1062
+ "lines": [
1063
+ 12,
1064
+ 12
1065
+ ],
1066
+ "anchor": "Read the geometry intent. When it names an anchor (a feeling"
1067
+ },
1068
+ {
1069
+ "id": "sg-live",
1070
+ "row": 2,
939
1071
  "kind": "step",
940
1072
  "title": "Read the live configuration",
941
1073
  "desc": "Each run reads the buffer or falls back to the open theme and shipped default. Relative shifts compound across runs.",
942
1074
  "lines": [
943
- 17,
944
- 17
1075
+ 18,
1076
+ 18
945
1077
  ],
946
1078
  "anchor": "Each run reads the LIVE config (buffer, else the open theme,"
947
1079
  },
948
1080
  {
949
- "id": "ag-target",
950
- "row": 2,
1081
+ "id": "sg-target",
1082
+ "row": 3,
951
1083
  "kind": "step",
952
1084
  "title": "Choose a global or component target",
953
1085
  "desc": "An absent target applies globally. Component IDs map windows and modals to dialog, cards to card, and tabs to tabbar. Unknown IDs fail.",
954
1086
  "lines": [
955
- 34,
956
- 34
1087
+ 35,
1088
+ 35
957
1089
  ],
958
1090
  "anchor": "- `target` (optional): a component id (the folder names unde"
959
1091
  },
960
1092
  {
961
- "id": "ag-kind",
962
- "row": 3,
1093
+ "id": "sg-kind",
1094
+ "row": 4,
963
1095
  "kind": "chipset",
964
1096
  "title": "Choose the geometry property",
965
1097
  "chips": [
966
1098
  {
967
1099
  "label": "radius",
968
1100
  "lines": [
969
- 35,
970
- 35
1101
+ 36,
1102
+ 36
971
1103
  ],
972
1104
  "anchor": "- `kind`: `radius | padding | gap | border-width`."
973
1105
  },
974
1106
  {
975
1107
  "label": "padding",
976
1108
  "lines": [
977
- 35,
978
- 35
1109
+ 36,
1110
+ 36
979
1111
  ],
980
1112
  "anchor": "- `kind`: `radius | padding | gap | border-width`."
981
1113
  },
982
1114
  {
983
1115
  "label": "gap",
984
1116
  "lines": [
985
- 35,
986
- 35
1117
+ 36,
1118
+ 36
987
1119
  ],
988
1120
  "anchor": "- `kind`: `radius | padding | gap | border-width`."
989
1121
  },
990
1122
  {
991
1123
  "label": "border-width",
992
1124
  "lines": [
993
- 35,
994
- 35
1125
+ 36,
1126
+ 36
995
1127
  ],
996
1128
  "anchor": "- `kind`: `radius | padding | gap | border-width`."
997
1129
  }
@@ -999,178 +1131,178 @@ export const skillTrees: Record<string, SkillTree> = {
999
1131
  "tag": "property"
1000
1132
  },
1001
1133
  {
1002
- "id": "ag-op",
1003
- "row": 4,
1134
+ "id": "sg-op",
1135
+ "row": 5,
1004
1136
  "kind": "decide",
1005
1137
  "title": "Set or shift?",
1006
1138
  "desc": "Set selects a token on the property's scale. Shift moves a whole number of steps and clamps at either end.",
1007
1139
  "lines": [
1008
- 36,
1009
- 36
1140
+ 37,
1141
+ 37
1010
1142
  ],
1011
1143
  "anchor": "- `set` or `shift`, exactly one of the two. `set` takes an e"
1012
1144
  },
1013
1145
  {
1014
- "id": "ag-shift",
1015
- "row": 5,
1146
+ "id": "sg-shift",
1147
+ "row": 6,
1016
1148
  "kind": "step",
1017
1149
  "title": "Shift by steps",
1018
1150
  "desc": "'Slightly' and 'a bit' each move 1 step; an unqualified request moves 1–2; 'much,' 'way,' and 'really' move 2–3. 'Softer' increases radius and spacing.",
1019
1151
  "lines": [
1020
- 53,
1021
- 53
1152
+ 58,
1153
+ 58
1022
1154
  ],
1023
1155
  "anchor": "Magnitude words: \"slightly\" or \"a bit\" is 1 step, unqualifie"
1024
1156
  },
1025
1157
  {
1026
- "id": "ag-set",
1027
- "row": 5,
1158
+ "id": "sg-set",
1159
+ "row": 6,
1028
1160
  "kind": "step",
1029
1161
  "title": "Set an exact token",
1030
1162
  "desc": "Set selects a token from the property's scale. A pill operation sets --radius-full. The full flag belongs to radius shifts.",
1031
1163
  "lines": [
1032
- 37,
1033
- 37
1164
+ 38,
1165
+ 38
1034
1166
  ],
1035
1167
  "anchor": "- `full` (radius shifts only): admits `--radius-full` as the"
1036
1168
  },
1037
1169
  {
1038
- "id": "ag-idiom",
1039
- "row": 6,
1170
+ "id": "sg-idiom",
1171
+ "row": 7,
1040
1172
  "kind": "step",
1041
1173
  "title": "Map common phrases to operations",
1042
1174
  "desc": "The table translates pill, corner, density, and border requests into exact operations.",
1043
1175
  "lines": [
1044
- 39,
1045
- 51
1176
+ 40,
1177
+ 54
1046
1178
  ],
1047
1179
  "anchor": "## Idioms",
1048
1180
  "anchorEnd": "| thicker, thinner borders | border-width `shift: 1` or `-1`"
1049
1181
  },
1050
1182
  {
1051
- "id": "ag-squeeze",
1052
- "row": 7,
1183
+ "id": "sg-squeeze",
1184
+ "row": 8,
1053
1185
  "kind": "step",
1054
1186
  "title": "Protect controls during compaction",
1055
1187
  "desc": "Global compaction stops at shift: -1 because larger shifts crush controls. Further compaction targets named containers. Global expansion remains safe.",
1056
1188
  "lines": [
1057
- 55,
1058
- 59
1189
+ 60,
1190
+ 64
1059
1191
  ],
1060
1192
  "anchor": "## Controls squeeze before containers",
1061
- "anchorEnd": "So a global compaction is `shift: -1`. When the brief wants "
1193
+ "anchorEnd": "So a global compaction is `shift: -1`. When the request wants "
1062
1194
  },
1063
1195
  {
1064
- "id": "ag-pill",
1065
- "row": 8,
1196
+ "id": "sg-pill",
1197
+ "row": 9,
1066
1198
  "kind": "decide",
1067
1199
  "title": "Does the request create a pill?",
1068
1200
  "desc": "--radius-full curves into the end glyphs. Large-text pills need at least --space-8 horizontal padding.",
1069
1201
  "lines": [
1070
- 61,
1071
- 61
1202
+ 66,
1203
+ 66
1072
1204
  ],
1073
1205
  "anchor": "A pill needs the room most. `--radius-full` bends the corner"
1074
1206
  },
1075
1207
  {
1076
- "id": "ag-pillop",
1077
- "row": 9,
1208
+ "id": "sg-pillop",
1209
+ "row": 10,
1078
1210
  "kind": "step",
1079
1211
  "title": "Set pill radius and padding together",
1080
1212
  "desc": "The radius and padding operations share a target. The padding set follows global compaction so it wins.",
1081
1213
  "lines": [
1082
- 63,
1083
- 69
1214
+ 68,
1215
+ 68
1084
1216
  ],
1085
1217
  "anchor": "```json",
1086
1218
  "anchorEnd": "```"
1087
1219
  },
1088
1220
  {
1089
- "id": "ag-ladder",
1090
- "row": 10,
1221
+ "id": "sg-ladder",
1222
+ "row": 11,
1091
1223
  "kind": "chipset",
1092
1224
  "title": "Respect token scales and padding floors",
1093
1225
  "chips": [
1094
1226
  {
1095
1227
  "label": "Radius, space, and border-width scales",
1096
1228
  "lines": [
1097
- 73,
1098
- 73
1229
+ 78,
1230
+ 78
1099
1231
  ],
1100
1232
  "anchor": "Radius runs `none, sm, md, lg, xl, 2xl, 3xl, 4xl`, with `ful"
1101
1233
  },
1102
1234
  {
1103
1235
  "label": "Content padding floor: --space-4",
1104
1236
  "lines": [
1105
- 75,
1106
- 75
1237
+ 80,
1238
+ 80
1107
1239
  ],
1108
1240
  "anchor": "Content insets stop at `--space-4`. Below it the text sits a"
1109
1241
  },
1110
1242
  {
1111
1243
  "label": "Text-control padding floor: --space-6",
1112
1244
  "lines": [
1113
- 77,
1114
- 77
1245
+ 82,
1246
+ 82
1115
1247
  ],
1116
1248
  "anchor": "Padding that wraps a line of type stops a rung higher, at `-"
1117
1249
  },
1118
1250
  {
1119
1251
  "label": "Margin shifts use the full scale",
1120
1252
  "lines": [
1121
- 79,
1122
- 79
1253
+ 84,
1254
+ 84
1123
1255
  ],
1124
1256
  "anchor": "The floor guards `-padding` only. Outer space is exempt, bec"
1125
1257
  },
1126
1258
  {
1127
1259
  "label": "Off-subset aliases first reach a listed rung",
1128
1260
  "lines": [
1129
- 81,
1130
- 81
1261
+ 86,
1262
+ 86
1131
1263
  ],
1132
1264
  "anchor": "An alias sitting off the subset spends its first step reachi"
1133
1265
  }
1134
1266
  ],
1135
1267
  "lines": [
1136
- 71,
1137
- 71
1268
+ 76,
1269
+ 76
1138
1270
  ],
1139
1271
  "anchor": "## Ladders",
1140
1272
  "tag": "ladders and floors"
1141
1273
  },
1142
1274
  {
1143
- "id": "ag-write",
1144
- "row": 11,
1275
+ "id": "sg-write",
1276
+ "row": 12,
1145
1277
  "kind": "step",
1146
1278
  "n": "1",
1147
- "title": "Write scratch/adjust-ops.json",
1279
+ "title": "Write scratch/geometry-ops.json",
1148
1280
  "lines": [
1149
1281
  12,
1150
1282
  12
1151
1283
  ],
1152
- "anchor": "Write the ops file to `scratch/adjust-ops.json`."
1284
+ "anchor": "Read the geometry intent. When it names an anchor (a feeling"
1153
1285
  },
1154
1286
  {
1155
- "id": "ag-shapes",
1156
- "row": 12,
1287
+ "id": "sg-shapes",
1288
+ "row": 13,
1157
1289
  "kind": "chipset",
1158
1290
  "title": "Check operation forms",
1159
1291
  "chips": [
1160
1292
  {
1161
1293
  "label": "Global, relative",
1162
1294
  "lines": [
1163
- 20,
1164
- 25
1295
+ 22,
1296
+ 24
1165
1297
  ],
1166
- "anchor": "",
1298
+ "anchor": "Global, relative:",
1167
1299
  "anchorEnd": "```"
1168
1300
  },
1169
1301
  {
1170
1302
  "label": "Targeted, absolute",
1171
1303
  "lines": [
1172
- 27,
1173
- 31
1304
+ 28,
1305
+ 30
1174
1306
  ],
1175
1307
  "anchor": "Targeted, absolute:",
1176
1308
  "anchorEnd": "```"
@@ -1178,22 +1310,22 @@ export const skillTrees: Record<string, SkillTree> = {
1178
1310
  {
1179
1311
  "label": "The CLI ignores name",
1180
1312
  "lines": [
1181
- 33,
1182
- 33
1313
+ 34,
1314
+ 34
1183
1315
  ],
1184
1316
  "anchor": "- `name`: ignored. Buffers are fixed slots, so a name names "
1185
1317
  }
1186
1318
  ],
1187
1319
  "lines": [
1188
- 19,
1189
- 19
1320
+ 20,
1321
+ 20
1190
1322
  ],
1191
1323
  "anchor": "## The ops file",
1192
1324
  "tag": "ops file"
1193
1325
  },
1194
1326
  {
1195
- "id": "ag-cli",
1196
- "row": 13,
1327
+ "id": "sg-cli",
1328
+ "row": 14,
1197
1329
  "kind": "cli",
1198
1330
  "n": "2",
1199
1331
  "title": "Apply the geometry operations",
@@ -1202,12 +1334,12 @@ export const skillTrees: Record<string, SkillTree> = {
1202
1334
  13,
1203
1335
  13
1204
1336
  ],
1205
- "anchor": "Run `npx live-tokens adjust scratch/adjust-ops.json`. It wri",
1206
- "command": "npx live-tokens adjust scratch/adjust-ops.json"
1337
+ "anchor": "Run `npx live-tokens set-geometry scratch/geometry-ops.json",
1338
+ "command": "npx live-tokens set-geometry scratch/geometry-ops.json"
1207
1339
  },
1208
1340
  {
1209
- "id": "ag-fail",
1210
- "row": 14,
1341
+ "id": "sg-fail",
1342
+ "row": 15,
1211
1343
  "kind": "gate",
1212
1344
  "title": "The CLI rejects an operation",
1213
1345
  "desc": "The report names the invalid operation or missing input. The repair resolves that issue before the next run.",
@@ -1218,8 +1350,8 @@ export const skillTrees: Record<string, SkillTree> = {
1218
1350
  "anchor": "Read the report card: every changed alias old → new, plus sk"
1219
1351
  },
1220
1352
  {
1221
- "id": "ag-card",
1222
- "row": 14,
1353
+ "id": "sg-card",
1354
+ "row": 15,
1223
1355
  "kind": "ok",
1224
1356
  "n": "3",
1225
1357
  "title": "The buffers hold the new geometry",
@@ -1231,21 +1363,34 @@ export const skillTrees: Record<string, SkillTree> = {
1231
1363
  "anchor": "Read the report card: every changed alias old → new, plus sk"
1232
1364
  },
1233
1365
  {
1234
- "id": "ag-tell",
1235
- "row": 15,
1366
+ "id": "sg-report",
1367
+ "row": 16,
1236
1368
  "kind": "step",
1237
1369
  "n": "4",
1238
- "title": "Reload and review the geometry",
1239
- "desc": "Reloading before Save gives the editor the current buffer. Save keeps the change, and inverse operations undo it.",
1370
+ "title": "Report back",
1371
+ "desc": "The line back to create-theme names every alias that moved and any skip or clamp worth naming.",
1240
1372
  "lines": [
1241
1373
  15,
1242
1374
  15
1243
1375
  ],
1376
+ "anchor": "Report back in a line: every alias that moved, and any skip "
1377
+ },
1378
+ {
1379
+ "id": "sg-tell",
1380
+ "row": 17,
1381
+ "kind": "step",
1382
+ "n": "5",
1383
+ "title": "Reload and review the geometry",
1384
+ "desc": "Reloading before Save gives the editor the current buffer. Save keeps the change, and inverse operations undo it.",
1385
+ "lines": [
1386
+ 16,
1387
+ 16
1388
+ ],
1244
1389
  "anchor": "Tell the user to reload the page before saving. The editor k"
1245
1390
  },
1246
1391
  {
1247
- "id": "ag-scope",
1248
- "row": 16,
1392
+ "id": "sg-scope",
1393
+ "row": 18,
1249
1394
  "kind": "chipset",
1250
1395
  "title": "Geometry scope",
1251
1396
  "desc": "Geometry operations remap component aliases to existing tokens and preserve colors, fonts, tokens.css, and saved themes.",
@@ -1253,8 +1398,8 @@ export const skillTrees: Record<string, SkillTree> = {
1253
1398
  {
1254
1399
  "label": "Buffers, Save, and Adopt",
1255
1400
  "lines": [
1256
- 83,
1257
- 85
1401
+ 88,
1402
+ 90
1258
1403
  ],
1259
1404
  "anchor": "## Scope",
1260
1405
  "anchorEnd": "Every value written is an existing token; nothing new is min"
@@ -1263,14 +1408,14 @@ export const skillTrees: Record<string, SkillTree> = {
1263
1408
  "tag": "scope"
1264
1409
  },
1265
1410
  {
1266
- "id": "ag-ver",
1267
- "row": 17,
1411
+ "id": "sg-ver",
1412
+ "row": 19,
1268
1413
  "kind": "done",
1269
1414
  "title": "Verify the geometry",
1270
1415
  "desc": "The command exits 0 with expected changes and explained skips. Controls remain readable after reload. Each reported component has a _working.json.",
1271
1416
  "lines": [
1272
- 87,
1273
- 93
1417
+ 92,
1418
+ 98
1274
1419
  ],
1275
1420
  "anchor": "## Verify",
1276
1421
  "anchorEnd": "- To revert, run the inverse ops, or load a theme in the The"
@@ -1278,99 +1423,107 @@ export const skillTrees: Record<string, SkillTree> = {
1278
1423
  ],
1279
1424
  "edges": [
1280
1425
  {
1281
- "from": "ag-trig",
1282
- "to": "ag-live"
1426
+ "from": "sg-trig",
1427
+ "to": "sg-anchor"
1283
1428
  },
1284
1429
  {
1285
- "from": "ag-live",
1286
- "to": "ag-target"
1430
+ "from": "sg-anchor",
1431
+ "to": "sg-live"
1287
1432
  },
1288
1433
  {
1289
- "from": "ag-target",
1290
- "to": "ag-kind"
1434
+ "from": "sg-live",
1435
+ "to": "sg-target"
1291
1436
  },
1292
1437
  {
1293
- "from": "ag-kind",
1294
- "to": "ag-op"
1438
+ "from": "sg-target",
1439
+ "to": "sg-kind"
1295
1440
  },
1296
1441
  {
1297
- "from": "ag-op",
1298
- "to": "ag-shift",
1442
+ "from": "sg-kind",
1443
+ "to": "sg-op"
1444
+ },
1445
+ {
1446
+ "from": "sg-op",
1447
+ "to": "sg-shift",
1299
1448
  "label": "shift"
1300
1449
  },
1301
1450
  {
1302
- "from": "ag-op",
1303
- "to": "ag-set",
1451
+ "from": "sg-op",
1452
+ "to": "sg-set",
1304
1453
  "label": "set"
1305
1454
  },
1306
1455
  {
1307
- "from": "ag-shift",
1308
- "to": "ag-idiom"
1456
+ "from": "sg-shift",
1457
+ "to": "sg-idiom"
1309
1458
  },
1310
1459
  {
1311
- "from": "ag-set",
1312
- "to": "ag-idiom"
1460
+ "from": "sg-set",
1461
+ "to": "sg-idiom"
1313
1462
  },
1314
1463
  {
1315
- "from": "ag-idiom",
1316
- "to": "ag-squeeze"
1464
+ "from": "sg-idiom",
1465
+ "to": "sg-squeeze"
1317
1466
  },
1318
1467
  {
1319
- "from": "ag-squeeze",
1320
- "to": "ag-pill"
1468
+ "from": "sg-squeeze",
1469
+ "to": "sg-pill"
1321
1470
  },
1322
1471
  {
1323
- "from": "ag-pill",
1324
- "to": "ag-pillop",
1472
+ "from": "sg-pill",
1473
+ "to": "sg-pillop",
1325
1474
  "label": "pill"
1326
1475
  },
1327
1476
  {
1328
- "from": "ag-pillop",
1329
- "to": "ag-ladder"
1477
+ "from": "sg-pillop",
1478
+ "to": "sg-ladder"
1330
1479
  },
1331
1480
  {
1332
- "from": "ag-ladder",
1333
- "to": "ag-write"
1481
+ "from": "sg-ladder",
1482
+ "to": "sg-write"
1334
1483
  },
1335
1484
  {
1336
- "from": "ag-write",
1337
- "to": "ag-shapes"
1485
+ "from": "sg-write",
1486
+ "to": "sg-shapes"
1338
1487
  },
1339
1488
  {
1340
- "from": "ag-shapes",
1341
- "to": "ag-cli"
1489
+ "from": "sg-shapes",
1490
+ "to": "sg-cli"
1342
1491
  },
1343
1492
  {
1344
- "from": "ag-cli",
1345
- "to": "ag-fail",
1493
+ "from": "sg-cli",
1494
+ "to": "sg-fail",
1346
1495
  "label": "exit 1"
1347
1496
  },
1348
1497
  {
1349
- "from": "ag-cli",
1350
- "to": "ag-card",
1498
+ "from": "sg-cli",
1499
+ "to": "sg-card",
1351
1500
  "label": "exit 0"
1352
1501
  },
1353
1502
  {
1354
- "from": "ag-fail",
1355
- "to": "ag-cli",
1503
+ "from": "sg-fail",
1504
+ "to": "sg-cli",
1356
1505
  "label": "rerun",
1357
1506
  "back": true
1358
1507
  },
1359
1508
  {
1360
- "from": "ag-card",
1361
- "to": "ag-tell"
1509
+ "from": "sg-card",
1510
+ "to": "sg-report"
1511
+ },
1512
+ {
1513
+ "from": "sg-report",
1514
+ "to": "sg-tell"
1362
1515
  },
1363
1516
  {
1364
- "from": "ag-tell",
1365
- "to": "ag-scope"
1517
+ "from": "sg-tell",
1518
+ "to": "sg-scope"
1366
1519
  },
1367
1520
  {
1368
- "from": "ag-scope",
1369
- "to": "ag-ver"
1521
+ "from": "sg-scope",
1522
+ "to": "sg-ver"
1370
1523
  },
1371
1524
  {
1372
- "from": "ag-pill",
1373
- "to": "ag-ladder",
1525
+ "from": "sg-pill",
1526
+ "to": "sg-ladder",
1374
1527
  "label": "other geometry"
1375
1528
  }
1376
1529
  ]
@@ -1913,7 +2066,7 @@ export const skillTrees: Record<string, SkillTree> = {
1913
2066
  },
1914
2067
  "build-page": {
1915
2068
  "id": "live-tokens-build-page",
1916
- "digest": "sha256:9690053df3487413",
2069
+ "digest": "sha256:6bb7df43ef2c7de4",
1917
2070
  "title": "build-page",
1918
2071
  "tagline": "Catalogue components cover established needs. Theme tokens drive every theme-owned value.",
1919
2072
  "nodes": [
@@ -2443,7 +2596,7 @@ export const skillTrees: Record<string, SkillTree> = {
2443
2596
  },
2444
2597
  "create-component": {
2445
2598
  "id": "live-tokens-create-component",
2446
- "digest": "sha256:d4d3024f29d6580e",
2599
+ "digest": "sha256:8bd2a011d9d5b878",
2447
2600
  "title": "create-component",
2448
2601
  "tagline": "A runtime/editor pair exposes full token editing in the CUSTOM catalogue.",
2449
2602
  "nodes": [
@@ -2858,7 +3011,7 @@ export const skillTrees: Record<string, SkillTree> = {
2858
3011
  },
2859
3012
  "check-compliance": {
2860
3013
  "id": "live-tokens-check-compliance",
2861
- "digest": "sha256:312e48bb6fc90fa4",
3014
+ "digest": "sha256:495beffadd041e80",
2862
3015
  "title": "check-compliance",
2863
3016
  "tagline": "A read-only report explains project compliance and repair cost, then hands findings to fix-findings.",
2864
3017
  "nodes": [
@@ -3089,12 +3242,12 @@ export const skillTrees: Record<string, SkillTree> = {
3089
3242
  "anchor": "What fails the build now: errors by rule, with the files."
3090
3243
  },
3091
3244
  {
3092
- "label": "--strict warnings",
3245
+ "label": "Strict warnings",
3093
3246
  "lines": [
3094
3247
  45,
3095
3248
  45
3096
3249
  ],
3097
- "anchor": "What `--strict` would add: warnings by rule."
3250
+ "anchor": "What the strict count adds: warnings by rule."
3098
3251
  },
3099
3252
  {
3100
3253
  "label": "Components",