okchroma 0.1.6 → 0.2.0

package/dist-lib/index.cjs

@@ -24,11 +24,11 @@ __export(index_exports, {
   DEFAULT_LINK_HEX: () => DEFAULT_LINK_HEX,
   DISABLED_OPACITY: () => DISABLED_OPACITY,
   EXT_KEY: () => EXT_KEY,
-  INK_0: () => INK_0,
   MODE_SPECS: () => MODE_SPECS,
   OFFSET_ALPHAS: () => OFFSET_ALPHAS,
   OUTLINE_HOVER_ALPHA: () => OUTLINE_HOVER_ALPHA,
-  PAPER_100: () => PAPER_100,
+  PAPER_0: () => PAPER_0,
+  PEN_100: () => PEN_100,
   RESOLVER_ID: () => RESOLVER_ID,
   SCALE_STOP_COUNT: () => SCALE_STOP_COUNT,
   SCRIM_ALPHA: () => SCRIM_ALPHA,
@@ -282,12 +282,12 @@ var SCALE_C_LIGHT = {
   6: { base: 0.068, sat: 0.85 },
   7: { base: 0.086, sat: 0.78 },
   8: { base: 0.142, sat: 0.78 },
-  9: { inkMult: 0.95, inkMaxC: 0.15, chromaFloor: chromaFloorBase(10) },
+  9: { textMult: 0.95, textMaxC: 0.15, chromaFloor: chromaFloorBase(10) },
   // ink-10 keeps the FIRST-text register (ink-9's row, C49): the retired hover law
   // evaluated ink-9's chroma register at the between L, so the same params reproduce it;
   // the damped strong register below belongs to the top text stop alone.
-  10: { inkMult: 0.95, inkMaxC: 0.15, chromaFloor: chromaFloorBase(10) },
-  11: { inkMult: 0.5, inkMaxC: 0.08, chromaFloor: chromaFloorBase(11) }
+  10: { textMult: 0.95, textMaxC: 0.15, chromaFloor: chromaFloorBase(10) },
+  11: { textMult: 0.5, textMaxC: 0.08, chromaFloor: chromaFloorBase(11) }
 };
 var SCALE_C_DARK = {
   0: { sat: 0.4 },
@@ -299,9 +299,9 @@ var SCALE_C_DARK = {
   6: { sat: 0.76 },
   7: { sat: 0.8 },
   8: { sat: 0.84 },
-  9: { inkMult: 0.95, inkMaxC: 0.12, chromaFloor: chromaFloorBase(10) },
-  10: { inkMult: 0.95, inkMaxC: 0.12, chromaFloor: chromaFloorBase(10) },
-  11: { inkMult: 0.62, inkMaxC: 0.045, chromaFloor: chromaFloorBase(11) }
+  9: { textMult: 0.95, textMaxC: 0.12, chromaFloor: chromaFloorBase(10) },
+  10: { textMult: 0.95, textMaxC: 0.12, chromaFloor: chromaFloorBase(10) },
+  11: { textMult: 0.62, textMaxC: 0.045, chromaFloor: chromaFloorBase(11) }
 };
 var DARK_CTA_C = {
   brand: {
@@ -318,10 +318,10 @@ var DARK_CTA_C = {
 };
 var STOP_8_NONTEXT_CONTRAST = 3;
 var DARK_BAND_TOP_LIFT = 1.19;
-var INK_9_CONTRAST = 4.5;
-var INK_10_CONTRAST = 4.5;
-var INK_11_CONTRAST_FLOOR = 7;
-var INK_30_GROUND = {
+var PENCIL_9_CONTRAST = 4.5;
+var PEN_10_CONTRAST = 4.5;
+var PEN_11_CONTRAST_FLOOR = 7;
+var PEN_70_GROUND = {
   wcag: {
     light: { L: 0.3334966864733433, C: 0.07399966383476321, H: 104.26776675496032 },
     dark: { L: 0.907688606079988, C: 0.045, H: 293.66431934911327 }
@@ -397,7 +397,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.95, 0.895],
     // paper-3  ─┘
     [0.924, 1],
-    // wash-4   ─┐ peak: the mid-wash band, the neutral's most-branded moment
+    // wash-4   ─┐ peak: the mid-highlighter band, the neutral's most-branded moment
     [0.892, 1],
     // wash-5   ─┘
     [0.852, 0.842],
@@ -405,7 +405,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.801, 0.653],
     // wash-7    │
     [0.738, 0.505],
-    // highlight-8
+    // crayon-26
     [0.6, 0.4],
     // knee (ex-scaffold)   the drop-off: hue fades as you climb
     [0.56, 0.347],
@@ -431,7 +431,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.42, 0.653],
     // wash-7
     [0.55, 0.505],
-    // highlight-8
+    // crayon-26
     [0.6, 0.4],
     // knee (ex-scaffold)
     [0.64, 0.347],
@@ -800,26 +800,136 @@ function perceptualDarkC(L, H2, nativeC, keep = KEEP_DARK, gamut = MASTER_GAMUT)
   return solveCForApparent(L, H2, grayApparentL(L, gamut) + keep * meanBoost(L, nativeC, gamut), gamut);
 }
 
+// src/engine/tokenNames.ts
+var SHARED_NAMES = {
+  1: "paper-1",
+  2: "paper-3",
+  // stop 3 renamed wash-3 → paper-3 (owner 2026-07-24, elevation round): it is a
+  // PLANE in both themes (light sink / dark pop), so it belongs to the surface band.
+  // NAME ONLY — generation is index-keyed and unchanged; the highlighter-collision machinery
+  // (collision.ts HIGHLIGHTER_STOPS) deliberately still spans stops 3–7. (The requirement
+  // spec's `group` label followed the band to 'paper' on 2026-08-31 — labels only,
+  // the spans never moved; see spec.ts groupOf.)
+  // Stage B (owner 2026-08-07, names only): relabeled to the ROOT_L-derived digit,
+  // paper-5 — same band, same index.
+  3: "paper-5",
+  4: "highlighter-8",
+  5: "highlighter-11",
+  6: "highlighter-15",
+  7: "highlighter-20",
+  8: "crayon-26",
+  // THE PEN BAND (C49, owner 2026-08-05): the first text stop + emphasis fill (the
+  // 2026-07-29 highlight collapse — the old highlight-9 and on-highlight are
+  // deleted; this stop carries both jobs, its on-color a paper token), the between
+  // text stop (a value the retired text-cta hover state used to generate bespokely,
+  // promoted to a normal stop), and the strong text stop. The three read as states
+  // ARE the text-style cta (owner 2026-08-12). C49 restored the top
+  // two pre-collapse stop INDICES (11, and the off-scale anchor's 12 — emitted as a
+  // literal in cssRender, not through this table) with the between stop taking the
+  // vacated index 10; the indices (9/10/11) are unchanged since.
+  9: "pencil-47",
+  10: "pen-58",
+  11: "pen-70"
+};
+var SCALE_STOP_COUNT = Object.keys(SHARED_NAMES).length;
+function stopTokenName(stop) {
+  const name = SHARED_NAMES[stop];
+  if (!name) throw new Error(`stopTokenName: unexpected stop ${stop}`);
+  return name;
+}
+var PAPER_0 = "paper-0";
+var PEN_100 = "pen-100";
+var STAMP_FILL = "stamp-fill";
+var STAMP_FILL_HOVER = "stamp-fill-hover";
+var STAMP_FILL_PRESSED = "stamp-fill-pressed";
+var STAMP_EDGE = "stamp-edge";
+var STAMP_ON = "stamp-on";
+var STAMP_STATE_LEAVES = {
+  [STAMP_FILL]: "stamp/fill",
+  [STAMP_FILL_HOVER]: "stamp/fill-hover",
+  [STAMP_FILL_PRESSED]: "stamp/fill-pressed",
+  [STAMP_EDGE]: "stamp/edge",
+  [STAMP_ON]: "stamp/on"
+};
+var STAMP_LEAF = {
+  FILL: STAMP_STATE_LEAVES[STAMP_FILL],
+  FILL_HOVER: STAMP_STATE_LEAVES[STAMP_FILL_HOVER],
+  FILL_PRESSED: STAMP_STATE_LEAVES[STAMP_FILL_PRESSED],
+  EDGE: STAMP_STATE_LEAVES[STAMP_EDGE],
+  ON: STAMP_STATE_LEAVES[STAMP_ON]
+};
+var SYSTEM_LEAF = {
+  ABS_BLACK: "system/abs-black",
+  ABS_WHITE: "system/abs-white",
+  SURFACE: {
+    DIM: "system/surface/dim",
+    LOW: "system/surface/low",
+    MID: "system/surface/mid",
+    HIGH: "system/surface/high"
+  },
+  ALPHA: {
+    TRANSPARENT: "system/alpha/transparent",
+    SCRIM: "system/alpha/abs-black-060",
+    INK: "system/alpha/ink",
+    // the DIRECTIONAL ladders (owner 2026-08-31, renaming the 2026-08-18 bare rungs
+    // and the 2026-08-29 inverse ladder): away-from-bg is the page-polarity pole
+    // (black in light, white in dark), toward-bg the flipped pole — STATE LAYERS for
+    // INVERTED grounds, whose polarity is opposite the page's. (Never call toward-bg
+    // a "highlighter": that word belongs to the tinted band stops.) The reversal lives in
+    // the engine: a consumer on an inverted ground names one token and never picks a
+    // pole. Colored fills never ride these; their states stay engine-solved stops.
+    // Rungs are two-digit percent, harmonizing with shadow-04/08/12.
+    AWAY_FROM_BG_06: "system/alpha/away-from-bg/06",
+    AWAY_FROM_BG_08: "system/alpha/away-from-bg/08",
+    AWAY_FROM_BG_16: "system/alpha/away-from-bg/16",
+    TOWARD_BG_06: "system/alpha/toward-bg/06",
+    TOWARD_BG_08: "system/alpha/toward-bg/08",
+    TOWARD_BG_16: "system/alpha/toward-bg/16",
+    SHADOW_04: "system/alpha/shadow-04",
+    SHADOW_08: "system/alpha/shadow-08",
+    SHADOW_12: "system/alpha/shadow-12"
+  }
+};
+var SURFACE_PLANE_LAW = {
+  [SYSTEM_LEAF.SURFACE.DIM]: { light: SHARED_NAMES[3], dark: PAPER_0 },
+  [SYSTEM_LEAF.SURFACE.LOW]: { light: SHARED_NAMES[2], dark: SHARED_NAMES[1] },
+  [SYSTEM_LEAF.SURFACE.MID]: { light: SHARED_NAMES[1], dark: SHARED_NAMES[2] },
+  [SYSTEM_LEAF.SURFACE.HIGH]: { light: PAPER_0, dark: SHARED_NAMES[3] }
+};
+var TOKEN_ORDER = [
+  ...Object.values(SHARED_NAMES),
+  STAMP_FILL,
+  STAMP_FILL_HOVER,
+  STAMP_FILL_PRESSED,
+  STAMP_ON,
+  "identity"
+];
+function tokenOrder(name) {
+  const i = TOKEN_ORDER.indexOf(name);
+  return i === -1 ? TOKEN_ORDER.length : i;
+}
+
 // src/engine/requirements/spec.ts
-var groupOf = (stop) => stop <= 2 ? "paper" : stop <= 7 ? "wash" : stop === 8 ? "highlight" : "ink";
+var textLane = (g2) => g2 === "pencil" || g2 === "pen" || g2 === "lead" || g2 === "ink";
+var groupOf = (stop) => (stop === 0 ? PAPER_0 : stopTokenName(stop)).split("-")[0];
 var PAPER0_DARK_ROOT_L = 0.16;
 var PL_LADDER = { hue: "warm-drift", L: "perceptual", chroma: "ladder" };
 var PL_TEXT = { hue: "warm-drift", L: "perceptual", chroma: "brand" };
 var P_LIFT = { hue: "warm-torsion", L: "perceptual-lift", chroma: "ladder" };
 var P_FIXED = { hue: "warm-torsion", L: "fixed", chroma: "ladder" };
 var P_TEXT = { hue: "warm-torsion", L: "perceptual", chroma: "brand" };
-var S8 = { metric: "wcag", against: "paper-95", target: STOP_8_NONTEXT_CONTRAST, level: "AA" };
-var T9 = { metric: "wcag", against: "paper-97", target: INK_9_CONTRAST, level: "AA" };
-var T10 = { metric: "wcag", against: "wash-80", target: INK_10_CONTRAST, level: "AA" };
-var T11 = { metric: "wcag", against: "paper-97", target: INK_11_CONTRAST_FLOOR, level: "AAA" };
+var S8 = { metric: "wcag", against: "paper-5", target: STOP_8_NONTEXT_CONTRAST, level: "AA" };
+var T9 = { metric: "wcag", against: "paper-3", target: PENCIL_9_CONTRAST, level: "AA" };
+var T10 = { metric: "wcag", against: "highlighter-20", target: PEN_10_CONTRAST, level: "AA" };
+var T11 = { metric: "wcag", against: "paper-3", target: PEN_11_CONTRAST_FLOOR, level: "AAA" };
 var ONS = { onFill: { metric: "apca-pole", enforce: true, ratioFloor: 4.5, coEnforceLc: 65 } };
 var LIGHT = {
   stops: [
-    // paper-100 (paper-0 pre-Stage-B): the resolved ladder extreme — in light it genuinely is white (rootL 1.0, zero chroma)
-    { stop: 0, rootL: 1, group: "paper", produce: { hue: "warm-drift", L: "fixed", chroma: "ladder" }, satFraction: SCALE_C_LIGHT[0].sat, baseC: SCALE_C_LIGHT[0].base },
-    // paper/wash/wax-74: perceptual ladder/envelope blend on the geometric ROOT_L_LIGHT scaffold. Separation
+    // paper-0 (paper-0 pre-Stage-B): the resolved ladder extreme — in light it genuinely is white (rootL 1.0, zero chroma)
+    { stop: 0, rootL: 1, group: groupOf(0), produce: { hue: "warm-drift", L: "fixed", chroma: "ladder" }, satFraction: SCALE_C_LIGHT[0].sat, baseC: SCALE_C_LIGHT[0].base },
+    // paper/highlighter/crayon-26: perceptual ladder/envelope blend on the geometric ROOT_L_LIGHT scaffold. Separation
     // falls out of the shape (see above) — no min-separation require. Only stop 8 carries a require: the WCAG
-    // 3:1 vs the resolved paper-97 (paper-2) (re-solves automatically since it references paper-97 (paper-2)).
+    // 3:1 vs the resolved paper-3 (paper-2) (re-solves automatically since it references paper-3 (paper-2)).
     ...[1, 2, 3, 4, 5, 6, 7, 8].map((stop) => ({
       stop,
       rootL: ROOT_L_LIGHT[stop],
@@ -829,12 +939,12 @@ var LIGHT = {
       baseC: SCALE_C_LIGHT[stop].base,
       require: stop === 8 ? S8 : void 0
     })),
-    // ink text: perceptual + contrast-required. lead-53 (ink-9) is ALSO the emphasis fill (the
-    // highlight-9 collapse, owner 2026-07-29). ink-42 (ink-10) is the between text stop (C49) —
+    // pen text: perceptual + contrast-required. pencil-47 (ink-9) is ALSO the emphasis fill (the
+    // highlight-9 collapse, owner 2026-07-29). pen-58 (ink-10) is the between text stop (C49) —
     // a normal stop like its neighbors; the three together are the text-register cta.
-    { stop: 9, rootL: ROOT_L_LIGHT[9], group: "ink", produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[9].inkMult, inkMaxC: SCALE_C_LIGHT[9].inkMaxC, chromaFloor: SCALE_C_LIGHT[9].chromaFloor, require: T9 },
-    { stop: 10, rootL: ROOT_L_LIGHT[10], group: "ink", produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[10].inkMult, inkMaxC: SCALE_C_LIGHT[10].inkMaxC, chromaFloor: SCALE_C_LIGHT[10].chromaFloor, require: T10 },
-    { stop: 11, rootL: ROOT_L_LIGHT[11], group: "ink", produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[11].inkMult, inkMaxC: SCALE_C_LIGHT[11].inkMaxC, chromaFloor: SCALE_C_LIGHT[11].chromaFloor, require: T11 }
+    { stop: 9, rootL: ROOT_L_LIGHT[9], group: groupOf(9), produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[9].textMult, textMaxC: SCALE_C_LIGHT[9].textMaxC, chromaFloor: SCALE_C_LIGHT[9].chromaFloor, require: T9 },
+    { stop: 10, rootL: ROOT_L_LIGHT[10], group: groupOf(10), produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[10].textMult, textMaxC: SCALE_C_LIGHT[10].textMaxC, chromaFloor: SCALE_C_LIGHT[10].chromaFloor, require: T10 },
+    { stop: 11, rootL: ROOT_L_LIGHT[11], group: groupOf(11), produce: PL_TEXT, chromaMult: SCALE_C_LIGHT[11].textMult, textMaxC: SCALE_C_LIGHT[11].textMaxC, chromaFloor: SCALE_C_LIGHT[11].chromaFloor, require: T11 }
   ],
   roles: [
     { role: "cta", produce: { hue: "constant", L: "anchor", chroma: "brand" }, floorL: 0, chromaMult: 1 },
@@ -845,10 +955,10 @@ var LIGHT = {
 };
 var DARK = {
   stops: [
-    // paper-100 (paper-0 pre-Stage-B): the resolved ladder extreme — one seam BELOW paper-99 (paper-1), deep and brand-tinted, never the
+    // paper-0 (paper-0 pre-Stage-B): the resolved ladder extreme — one seam BELOW paper-1 (paper-1), deep and brand-tinted, never the
     // absolute void (the old hard-coded #000000 was "too much"). Lift applies like the rest of the scale.
-    { stop: 0, rootL: PAPER0_DARK_ROOT_L, group: "paper", produce: P_LIFT, satFraction: SCALE_C_DARK[0].sat },
-    // paper/wash 1–7: perceptual on the dark scaffold. stop 8: FIXED at the hand-placed scaffold BUT with the
+    { stop: 0, rootL: PAPER0_DARK_ROOT_L, group: groupOf(0), produce: P_LIFT, satFraction: SCALE_C_DARK[0].sat },
+    // paper/highlighter 1–7: perceptual on the dark scaffold. stop 8: FIXED at the hand-placed scaffold BUT with the
     // 3:1 non-text require DECLARED (the Stage-5 flip, owner-approved) — the blue-recede failure is prevented
     // BY RULE, not by patch. The require now genuinely PLACES the stop rather than catching a few low-luminance
     // hues: on the delta-carry path it solves from the sentinel every time, and the old claim that "most hues
@@ -862,11 +972,11 @@ var DARK = {
       satFraction: SCALE_C_DARK[stop].sat,
       require: stop === 8 ? S8 : void 0
     })),
-    // ink text: perceptual + the contrast requires DECLARED in dark too (Stage-5 flip): the scaffold already
+    // pen text: perceptual + the contrast requires DECLARED in dark too (Stage-5 flip): the scaffold already
     // clears them for every hue (the gate proves it), so values don't move — but the guarantee is now a rule.
-    { stop: 9, rootL: ROOT_L_DARK[9], group: "ink", produce: P_TEXT, chromaMult: SCALE_C_DARK[9].inkMult, inkMaxC: SCALE_C_DARK[9].inkMaxC, chromaFloor: SCALE_C_DARK[9].chromaFloor, require: T9 },
-    { stop: 10, rootL: ROOT_L_DARK[10], group: "ink", produce: P_TEXT, chromaMult: SCALE_C_DARK[10].inkMult, inkMaxC: SCALE_C_DARK[10].inkMaxC, chromaFloor: SCALE_C_DARK[10].chromaFloor, require: T10 },
-    { stop: 11, rootL: ROOT_L_DARK[11], group: "ink", produce: P_TEXT, chromaMult: SCALE_C_DARK[11].inkMult, inkMaxC: SCALE_C_DARK[11].inkMaxC, chromaFloor: SCALE_C_DARK[11].chromaFloor, require: T11 }
+    { stop: 9, rootL: ROOT_L_DARK[9], group: groupOf(9), produce: P_TEXT, chromaMult: SCALE_C_DARK[9].textMult, textMaxC: SCALE_C_DARK[9].textMaxC, chromaFloor: SCALE_C_DARK[9].chromaFloor, require: T9 },
+    { stop: 10, rootL: ROOT_L_DARK[10], group: groupOf(10), produce: P_TEXT, chromaMult: SCALE_C_DARK[10].textMult, textMaxC: SCALE_C_DARK[10].textMaxC, chromaFloor: SCALE_C_DARK[10].chromaFloor, require: T10 },
+    { stop: 11, rootL: ROOT_L_DARK[11], group: groupOf(11), produce: P_TEXT, chromaMult: SCALE_C_DARK[11].textMult, textMaxC: SCALE_C_DARK[11].textMaxC, chromaFloor: SCALE_C_DARK[11].chromaFloor, require: T11 }
   ],
   roles: [
     { role: "cta", produce: { hue: "constant", L: "anchor", chroma: "brand" }, floorL: DARK_CTA_MIN_L, chromaMult: 1 },
@@ -877,7 +987,7 @@ var DARK = {
 };
 var MODE_SPECS = { light: LIGHT, dark: DARK };
 
-// ../../../Users/emilygerrity/okchroma/node_modules/helmlab/dist/index.js
+// node_modules/helmlab/dist/index.js
 function o0(n) {
   let t = new Float64Array(9);
   for (let e = 0; e < 3; e++) for (let s = 0; s < 3; s++) t[e * 3 + s] = n[e][s];
@@ -1793,7 +1903,7 @@ function p2Diff(a, b) {
 var DEFAULT_APCA_LC_MAP = { 3: 30, 4.5: 75, 6.5: 85, 7: 90 };
 function toApca(req, lcMap) {
   if (req.metric !== "wcag") return req;
-  if (req.against === "wash-80") return { metric: "apca", against: "paper-97", targetLc: 85 };
+  if (req.against === "highlighter-20") return { metric: "apca", against: "paper-3", targetLc: 85 };
   const targetLc = lcMap[req.target];
   if (targetLc === void 0) throw new Error(`apca profile: no Lc mapping for wcag target ${req.target}`);
   return { metric: "apca", against: req.against, targetLc };
@@ -1807,7 +1917,7 @@ function withProfile(spec, profile, lcMap = DEFAULT_APCA_LC_MAP) {
     // (The stop-9 CARVE-OUT is gone with the stop, owner 2026-07-29. It existed because
     // highlight-9's require was a fill-vs-its-own-plane bar with no honest slot in a map
     // of TEXT bars — 3 → 30 non-text, 4.5 → 75 body, 7 → 90 — so the apca lane kept its
-    // own hl-9 placement instead. Today's stop 9 is an INK stop: 4.5 is a text bar, the
+    // own hl-9 placement instead. Today's stop 9 is a PEN stop: 4.5 is a text bar, the
     // 75 slot is its correct translation, and it maps like every other require.)
     stops: spec.stops.map((s) => s.require ? { ...s, require: toApca(s.require, lcMap) } : s),
     ons: {
@@ -1969,16 +2079,16 @@ function separationClampLight(ctx, placed, chromaAt, ref, target) {
   return { L: pass, C: ceilingAt(pass), H: ctx.lightHueAt(pass) };
 }
 function placeLightText(ctx, rootL, cMult, maxLFor, deepen, maxC = Infinity) {
-  const inkC = Math.min(cMult * ctx.brandC, maxC);
-  const anchorL = perceptualRungL(rootL, clampChromaToGamut(rootL, inkC, ctx.lightHueAt(rootL)), ctx.lightHueAt(rootL));
+  const textC = Math.min(cMult * ctx.brandC, maxC);
+  const anchorL = perceptualRungL(rootL, clampChromaToGamut(rootL, textC, ctx.lightHueAt(rootL)), ctx.lightHueAt(rootL));
   let H2 = ctx.lightHueAt(anchorL);
-  let C2 = clampChromaToGamut(anchorL, inkC, H2);
+  let C2 = clampChromaToGamut(anchorL, textC, H2);
   let L = Math.min(anchorL, maxLFor(C2, H2));
   H2 = ctx.lightHueAt(L);
-  C2 = clampChromaToGamut(L, inkC, H2);
+  C2 = clampChromaToGamut(L, textC, H2);
   L = Math.min(anchorL, maxLFor(C2, H2));
   L = Math.min(L - deepen, maxLFor(C2, ctx.lightHueAt(L - deepen)));
-  return { L, C: ctx.cAt("light", L, inkC), H: ctx.lightHueAt(L) };
+  return { L, C: ctx.cAt("light", L, textC), H: ctx.lightHueAt(L) };
 }
 function onFillIsWhiteLight(ctx, enforce, ratioFloor) {
   const fill9ApcaY = apcaYAt(ctx.scaleL, clampChromaToGamut(ctx.scaleL, ctx.cAt("light", ctx.scaleL, ctx.brandC), ctx.brandH), ctx.brandH);
@@ -1992,7 +2102,7 @@ function buildDarkContext(ctx, specFloorL = DARK_CTA_MIN_L) {
   return { dark9L, darkC9, darkHueAtL };
 }
 var darkScaleChromaAt = (ctx, dctx, stopIndex, multiplier) => (L) => ctx.cAt("dark", L, ctx.opts?.darkChromaCurve ? ctx.opts.darkChromaCurve(L, dctx.darkHueAtL(L), ctx.brandC, dctx.darkC9) : applyChromaFloor(ctx.subtleC, multiplier, chromaFloorBase(stopIndex), ctx.darkFloorStrength));
-var darkInkChromaAt = (ctx, dctx, floorBase, multiplier, maxC = Infinity) => (L) => ctx.cAt("dark", L, Math.min(applyChromaFloor(ctx.brandC, multiplier, floorBase, ctx.darkFloorStrength), maxC));
+var darkTextChromaAt = (ctx, dctx, floorBase, multiplier, maxC = Infinity) => (L) => ctx.cAt("dark", L, Math.min(applyChromaFloor(ctx.brandC, multiplier, floorBase, ctx.darkFloorStrength), maxC));
 function placeDark(dctx, rootL, chromaAt, lift = false) {
   let L = perceptualRungL(rootL, chromaAt(rootL), dctx.darkHueAtL(rootL));
   if (lift) L = Math.max(L, rootL);
@@ -2253,7 +2363,7 @@ function resolveRamp(hex, mode, spec, opts) {
   const seed = { hex, ...o };
   const ctx = buildContext(hex, opts);
   spec ?? (spec = MODE_SPECS[mode]);
-  if (ctx.opts?.inkGround) {
+  if (ctx.opts?.textGround) {
     spec = {
       ...spec,
       stops: spec.stops.map((s) => s.stop === 10 && s.require?.metric === "wcag" ? { ...s, require: { ...s.require, target: 6.5 } } : s)
@@ -2275,12 +2385,12 @@ function resolveRamp(hex, mode, spec, opts) {
     if (!ref) throw new Error(`stop ${forWhom}: require against stop ${stopNum} but it is not resolved yet`);
     return ref;
   };
-  const AGAINST_STOP = { "paper-99": 1, "paper-97": 2, "paper-95": 3, "wash-80": 7 };
+  const AGAINST_STOP = { "paper-1": 1, "paper-3": 2, "paper-5": 3, "highlighter-20": 7 };
   const declaredAnchor = (req) => req.metric === "min-separation" ? 1 : AGAINST_STOP[req.against] ?? 2;
   const wcagAnchorStop = (req, stop) => stop >= 9 && declaredAnchor(req) <= 3 ? 3 : declaredAnchor(req);
-  const inkGround = ctx.opts?.inkGround?.[mode];
-  const groundOf = (req, stop) => inkGround && stop >= 9 ? inkGround : refOf(wcagAnchorStop(req, stop), stop);
-  const apcaGroundOf = (req, stop) => inkGround && stop >= 9 ? inkGround : refOf(declaredAnchor(req), stop);
+  const textGround = ctx.opts?.textGround?.[mode];
+  const groundOf = (req, stop) => textGround && stop >= 9 ? textGround : refOf(wcagAnchorStop(req, stop), stop);
+  const apcaGroundOf = (req, stop) => textGround && stop >= 9 ? textGround : refOf(declaredAnchor(req), stop);
   const NEUTRAL_P3_WORST_SHIP_Y = { light: 0.845015, dark: 0.014247 };
   const NEUTRAL_W80_WORST_SHIP_Y = { light: 0.506433, dark: 0.074262 };
   const maxLForOf = (req, forWhom, withMargin) => {
@@ -2298,14 +2408,14 @@ function resolveRamp(hex, mode, spec, opts) {
     }
     throw new Error(`stop ${forWhom}: ${req.metric} is not a contrast require`);
   };
-  const INK_DEEPEN = 0;
+  const TEXT_DEEPEN = 0;
   for (const sp of spec.stops) {
     let placed;
     let clamped = false, unresolvable;
     if (mode === "light") {
-      if (sp.group === "ink") {
-        if (!sp.require) throw new Error(`light ink stop ${sp.stop} must declare a contrast require`);
-        placed = placeLightText(ctx, sp.rootL, sp.chromaMult ?? 1, maxLForOf(sp.require, sp.stop, false), INK_DEEPEN, sp.inkMaxC);
+      if (textLane(sp.group)) {
+        if (!sp.require) throw new Error(`light pen stop ${sp.stop} must declare a contrast require`);
+        placed = placeLightText(ctx, sp.rootL, sp.chromaMult ?? 1, maxLForOf(sp.require, sp.stop, false), TEXT_DEEPEN, sp.textMaxC);
         clamped = true;
       } else if (sp.produce.L === "fixed") {
         const chromaAt = lightScaleChromaAt(ctx, sp.baseC ?? 0, sp.satFraction ?? 1);
@@ -2317,7 +2427,7 @@ function resolveRamp(hex, mode, spec, opts) {
         placed = placeLightScale(ctx, sp.rootL, chromaAt, contrastReq ? maxLForOf(contrastReq, sp.stop, true) : void 0, targetChromaAt);
         clamped = !!contrastReq;
         if (sp.require?.metric === "min-separation") {
-          const refStop = sp.require.against === "paper-99" ? 1 : sp.stop - 1;
+          const refStop = sp.require.against === "paper-1" ? 1 : sp.stop - 1;
           const ref = stops.find((s) => s.stop === refStop);
           if (!ref) throw new Error(`stop ${sp.stop}: min-separation against stop ${refStop} but it is not resolved yet`);
           const before = placed.L;
@@ -2327,8 +2437,8 @@ function resolveRamp(hex, mode, spec, opts) {
       }
     } else {
       const d = dctx;
-      const inkTwin = sp.group === "ink" && ctx.opts?.deltaCarry && ctx.opts?.chromaCurve ? ctx.opts.deltaLightStops?.find((s) => s.stop === sp.stop) : void 0;
-      const chromaAt = sp.group === "ink" ? inkTwin ? ((_L) => inkTwin.C) : darkInkChromaAt(ctx, d, sp.chromaFloor ?? chromaFloorBase(sp.stop), sp.chromaMult ?? 1, sp.inkMaxC) : darkScaleChromaAt(ctx, d, Math.max(0, sp.stop - 1), sp.satFraction ?? 1);
+      const textTwin = textLane(sp.group) && ctx.opts?.deltaCarry && ctx.opts?.chromaCurve ? ctx.opts.deltaLightStops?.find((s) => s.stop === sp.stop) : void 0;
+      const chromaAt = textLane(sp.group) ? textTwin ? ((_L) => textTwin.C) : darkTextChromaAt(ctx, d, sp.chromaFloor ?? chromaFloorBase(sp.stop), sp.chromaMult ?? 1, sp.textMaxC) : darkScaleChromaAt(ctx, d, Math.max(0, sp.stop - 1), sp.satFraction ?? 1);
       let spineH = null;
       const dl = ctx.opts?.deltaLightStops;
       const ls = dl && sp.stop >= 1 && sp.stop <= 8 ? dl.find((s) => s.stop === sp.stop) : void 0;
@@ -2348,7 +2458,7 @@ function resolveRamp(hex, mode, spec, opts) {
         }
         if (ctx.opts.deltaHKPlace) L = perceptualRungL(sp.rootL, ls.C, ls.H);
         if (ctx.opts.deltaLiftFloor) L = Math.max(L, sp.rootL);
-        if (ctx.opts.deltaChromaEq && sp.group !== "ink") C2 = ctx.cAt("dark", L, perceptualDarkC(L, ls.H, ctx.brandC));
+        if (ctx.opts.deltaChromaEq && !textLane(sp.group)) C2 = ctx.cAt("dark", L, perceptualDarkC(L, ls.H, ctx.brandC));
         placed = { L, C: C2, H: spineH ?? ls.H };
       } else if (sp.produce.L === "fixed") {
         placed = ls ? placeDarkDelta(d, sp.rootL, chromaAt, ls) : { L: sp.rootL, C: chromaAt(sp.rootL), H: d.darkHueAtL(sp.rootL) };
@@ -2384,7 +2494,7 @@ function resolveRamp(hex, mode, spec, opts) {
     if (sp.require?.metric === "wcag") {
       const anchor = groundOf(sp.require, sp.stop);
       const anchorShipY = shippedY(anchor.L, anchor.C, anchor.H);
-      const paperBound = sp.stop >= 8 && !(inkGround && sp.stop >= 9);
+      const paperBound = sp.stop >= 8 && !(textGround && sp.stop >= 9);
       const crossBoundY = wcagAnchorStop(sp.require, sp.stop) === 7 ? NEUTRAL_W80_WORST_SHIP_Y[mode] : NEUTRAL_P3_WORST_SHIP_Y[mode];
       const shipRatio = (L) => {
         const y2 = shippedY(L, placed.C, placed.H);
@@ -2412,7 +2522,7 @@ function resolveRamp(hex, mode, spec, opts) {
       const got = Math.abs(apcaLc(apcaYAt(placed.L, clampChromaToGamut(placed.L, placed.C, placed.H), placed.H), refA));
       if (got < sp.require.targetLc - APCA_TOL_LC) unresolvable = `stop ${sp.stop}: |Lc| ${got.toFixed(1)} < required ${sp.require.targetLc}`;
     } else if (sp.require?.metric === "min-separation") {
-      const ref = stops.find((s) => s.stop === (sp.require.against === "paper-99" ? 1 : sp.stop - 1));
+      const ref = stops.find((s) => s.stop === (sp.require.against === "paper-1" ? 1 : sp.stop - 1));
       const rad2 = (h) => h * Math.PI / 180;
       const gC = clampChromaToGamut(placed.L, placed.C, placed.H);
       const got = Math.sqrt((placed.L - ref.L) ** 2 + (gC * Math.cos(rad2(placed.H)) - ref.C * Math.cos(rad2(ref.H))) ** 2 + (gC * Math.sin(rad2(placed.H)) - ref.C * Math.sin(rad2(ref.H))) ** 2);
@@ -2568,7 +2678,7 @@ function generateScale(hex, scaleName, forcedArchetype, opts) {
   const dark = darkRamp.stops.filter((s) => s.stop >= 1).map(toStop).sort((a, b) => a.stop - b.stop);
   const p0Light = lightRamp.stops.find((s) => s.stop === 0);
   const p0Dark = darkRamp.stops.find((s) => s.stop === 0);
-  const inkPole = (arr, L) => arr.find((s) => s.stop === 11) ? makeStop(12, L, 0, arr.find((s) => s.stop === 11).H) : void 0;
+  const penPole = (arr, L) => arr.find((s) => s.stop === 11) ? makeStop(12, L, 0, arr.find((s) => s.stop === 11).H) : void 0;
   const cta = makeStop(9, lightRamp.roles.cta.L, lightRamp.roles.cta.C, lightRamp.roles.cta.H);
   const ctaDark = makeStop(9, darkRamp.roles.cta.L, darkRamp.roles.cta.C, darkRamp.roles.cta.H);
   const roleStop = (r, stop) => makeStop(stop, r.L, r.C, r.H);
@@ -2592,8 +2702,8 @@ function generateScale(hex, scaleName, forcedArchetype, opts) {
     identityHex: hex.toUpperCase(),
     paper0: p0Light ? makeStop(0, p0Light.L, p0Light.C, p0Light.H) : void 0,
     paper0Dark: p0Dark ? makeStop(0, p0Dark.L, p0Dark.C, p0Dark.H) : void 0,
-    ink0: inkPole(light, 0),
-    ink0Dark: inkPole(dark, 1)
+    pen100: penPole(light, 0),
+    pen100Dark: penPole(dark, 1)
   };
 }
 function generateNeutralScale(brandH, level = "default", contrastProfile) {
@@ -2665,8 +2775,7 @@ function generateSubtleSecondary(hex, opts) {
 
 // src/engine/tokenDescriptions.ts
 var AA_LARGE = "AA large text and UI elements";
-var AA_BODY = "AA standard body text & Level AAA large text";
-var AAA_BODY = "AAA standard body text";
+var AA_BODY = "AA standard body text";
 var FAMILY = {
   neutral: "neutral",
   brandPrimary: "brand",
@@ -2702,7 +2811,7 @@ var COLOR_WORD = {
   [FAMILY.info]: " (blue)"
 };
 var PAPER = { req: "backgrounds, inverted text", theming: (f) => TINT[f], collides: true };
-var WASH = { req: "subtle interactive states, decorative borders, illos, signal hierarchy", theming: (f) => TINT[f], collides: true };
+var HIGHLIGHTER = { req: "subtle interactive states, decorative borders, illos, signal hierarchy", theming: (f) => TINT[f], collides: true };
 var solved = (f) => `${TINT[f]}; re-solved to clear its floor`;
 var OVERLAY = {
   req: "translucent backgrounds that hold their reading on any paper",
@@ -2710,25 +2819,25 @@ var OVERLAY = {
   collides: true
 };
 var SCALE = {
-  "paper-99": PAPER,
+  "paper-1": PAPER,
   "paper-99-overlay": OVERLAY,
-  "paper-97": PAPER,
+  "paper-3": PAPER,
   "paper-97-overlay": OVERLAY,
-  "paper-95": { req: "backgrounds, inverted text", theming: (f) => `${TINT[f]}. Worst background text stops must clear.`, collides: true },
+  "paper-5": { req: "backgrounds, inverted text", theming: (f) => `${TINT[f]}. Worst background text stops must clear.`, collides: true },
   "paper-95-overlay": OVERLAY,
-  "wash-92": WASH,
-  "wash-89": WASH,
-  "wash-85": WASH,
-  "wash-80": WASH,
+  "highlighter-8": HIGHLIGHTER,
+  "highlighter-11": HIGHLIGHTER,
+  "highlighter-15": HIGHLIGHTER,
+  "highlighter-20": HIGHLIGHTER,
   // ("icons" KEPT through the 2026-08-28 on-flood strip (owner): an "icon" query
-  // landing on the wax rows is worth its ic-ON-s noise — the one surviving body carrier)
-  "wax-74": { req: "focus rings, icons, large text", contrast: AA_LARGE, theming: solved, collides: true },
-  "lead-53": { req: "regular text, inverted backgrounds", contrast: AA_BODY, theming: solved, collides: true },
-  "ink-42": { req: "regular text, inverted backgrounds", contrast: AA_BODY, theming: solved, collides: true },
+  // landing on the crayon rows is worth its ic-ON-s noise — the one surviving body carrier)
+  "crayon-26": { req: "focus rings, icons, large text", contrast: AA_LARGE, theming: solved, collides: true },
+  "pencil-47": { req: "regular text, inverted backgrounds", contrast: AA_BODY, theming: solved, collides: true },
+  "pen-58": { req: "regular text, inverted backgrounds", contrast: AA_BODY, theming: solved, collides: true },
   // ("high-emphasis" reworded 2026-08-12: the surface planes took low/high as label
   // words, and a body carrying either floods that token's picker search — the C50 law;
   // "strong-emphasis" reworded 2026-08-28: str-ON-g fed the "on" flood)
-  "ink-30": { req: "heavy-emphasis text, inverted backgrounds", contrast: AAA_BODY, theming: solved, collides: true },
+  "pen-70": { req: "heavy-emphasis text, inverted backgrounds", contrast: AA_BODY, theming: solved, collides: true },
   // the stamp family (cta words → solid 2026-08-18, solid → stamp 2026-08-27). "CTA" stays in
   // these bodies on purpose: it stopped being a token label, so it floods nothing,
   // and a designer's "cta" query still lands on these rows.
@@ -2757,7 +2866,7 @@ var LINK_INVERSE = (state, contrast) => ({
 var SYSTEM = {
   "system/abs-black": ABS,
   "system/abs-white": ABS,
-  // (the community system/ink-0 row RETIRED 2026-08-28 with its STATIC_UTILS entry:
+  // (the community system/pen-100 row RETIRED 2026-08-28 with its STATIC_UTILS entry:
   // the anchor is engine-resolved and rides the neutral in BOTH plugins now —
   // NEUTRAL_ONLY above. Old files' static rows orphan unwritten.)
   "system/abs-primary": { req: "identity seed reference", theming: "the theme\u2019s own input, as given" },
@@ -2773,7 +2882,7 @@ var SYSTEM = {
   "system/alpha/away-from-bg/08": OFFSET,
   "system/alpha/away-from-bg/16": OFFSET,
   // the inverse ladder: the offset rungs with the pole flipped per mode, for
-  // washes and edges over inverted backgrounds ("interaction" avoided in the
+  // highlighters and edges over inverted backgrounds ("interaction" avoided in the
   // bodies: acti-ON would feed the "on" flood)
   "system/alpha/toward-bg/06": OFFSET_INVERSE,
   "system/alpha/toward-bg/08": OFFSET_INVERSE,
@@ -2790,10 +2899,10 @@ var SYSTEM = {
   "system/surface/high": PLANE("topmost plane \u2014 modals, dialogs"),
   "system/link/default/enabled": LINK("", AA_BODY),
   "system/link/default/hover": LINK(" pointer-over", AA_BODY),
-  "system/link/default/pressed": LINK(" pressed", AAA_BODY),
+  "system/link/default/pressed": LINK(" pressed", AA_BODY),
   "system/link/inverse/enabled": LINK_INVERSE("", AA_BODY),
   "system/link/inverse/hover": LINK_INVERSE(" pointer-over", AA_BODY),
-  "system/link/inverse/pressed": LINK_INVERSE(" pressed", AAA_BODY)
+  "system/link/inverse/pressed": LINK_INVERSE(" pressed", AA_BODY)
 };
 var PREFIXES = [
   // community spellings FIRST: the 2026-08-21 family rename made the ext word a
@@ -2840,15 +2949,15 @@ function checkCollision(brand, signalScale, signalDef, mode) {
     collides: hueGate && deltaE <= threshold
   };
 }
-var HUE_COLLISION_WASH_DEG = 15;
+var HUE_COLLISION_HIGHLIGHTER_DEG = 15;
 var HUE_COLLISION_MIN_V = 0.5;
 var SECONDARY_NOTE_MIN_V = HUE_NOISE_C / VIVID_C;
-var WASH_STOPS = [3, 4, 5, 6, 7];
-function washProximity(brand, sig, mode) {
+var HIGHLIGHTER_STOPS = [3, 4, 5, 6, 7];
+function highlighterProximity(brand, sig, mode) {
   const b = mode === "light" ? brand.light : brand.dark;
   const s = mode === "light" ? sig.light : sig.dark;
   let dH = Infinity, dE = Infinity;
-  for (const k of WASH_STOPS) {
+  for (const k of HIGHLIGHTER_STOPS) {
     const bs = b.find((x2) => x2.stop === k), ss = s.find((x2) => x2.stop === k);
     if (!bs || !ss) continue;
     dH = Math.min(dH, hueDistance(bs.H, ss.H));
@@ -2857,15 +2966,15 @@ function washProximity(brand, sig, mode) {
   return { dH, dE };
 }
 function checkHueCollision(brand, signalScale, signalDef, opts) {
-  const l = washProximity(brand, signalScale, "light");
-  const d = washProximity(brand, signalScale, "dark");
+  const l = highlighterProximity(brand, signalScale, "light");
+  const d = highlighterProximity(brand, signalScale, "dark");
   const vividness = Math.min(1, brand.brandC / VIVID_C);
   return {
     signal: signalDef.name,
-    dHueWash: { light: l.dH, dark: d.dH },
-    washDeltaE: { light: l.dE, dark: d.dE },
+    dHueHighlighter: { light: l.dH, dark: d.dH },
+    highlighterDeltaE: { light: l.dE, dark: d.dE },
     vividness,
-    collides: vividness >= (opts?.minV ?? HUE_COLLISION_MIN_V) && Math.min(l.dH, d.dH) <= HUE_COLLISION_WASH_DEG
+    collides: vividness >= (opts?.minV ?? HUE_COLLISION_MIN_V) && Math.min(l.dH, d.dH) <= HUE_COLLISION_HIGHLIGHTER_DEG
   };
 }
 var YELLOW_SPLIT_H = 96;
@@ -3058,7 +3167,7 @@ function resolveBrand(hex, name, opts) {
     // (buildSignalScales/signalShift) — neutral alone stays outside; exact has enforce off.
     apcaClearance: opts?.apcaClearance ?? true,
     darkCtaFlatApp: opts?.darkCtaFlatApp,
-    inkGround: opts?.inkGround
+    textGround: opts?.textGround
   };
   let scale = generateScale(hex, name, void 0, floor);
   let pending = [];
@@ -3141,7 +3250,7 @@ function resolveLinkTrio(linkHex, contrastProfile) {
   const s = resolveBrand(linkHex, "link", { skipCollisionRules: true, contrastProfile }).scale;
   const at = (arr, n) => {
     const st = arr.find((x2) => x2.stop === n);
-    if (!st) throw new Error(`resolveLinkTrio: the link resolve has no ink stop ${n}`);
+    if (!st) throw new Error(`resolveLinkTrio: the link resolve has no pen stop ${n}`);
     return st;
   };
   return {
@@ -3154,16 +3263,16 @@ function resolveLinkTrio(linkHex, contrastProfile) {
   };
 }
 function resolveLinkInverseTrio(seedHex, contrastProfile) {
-  const ground = INK_30_GROUND[contrastProfile === "apca" ? "apca" : "wcag"];
+  const ground = PEN_70_GROUND[contrastProfile === "apca" ? "apca" : "wcag"];
   const s = resolveBrand(seedHex, "link-inverse", {
     skipCollisionRules: true,
     contrastProfile,
     // the cross — ramp keyed, ground mode-swapped
-    inkGround: { light: ground.dark, dark: ground.light }
+    textGround: { light: ground.dark, dark: ground.light }
   }).scale;
   const at = (arr, n) => {
     const st = arr.find((x2) => x2.stop === n);
-    if (!st) throw new Error(`resolveLinkInverseTrio: the link resolve has no ink stop ${n}`);
+    if (!st) throw new Error(`resolveLinkInverseTrio: the link resolve has no pen stop ${n}`);
     return st;
   };
   return {
@@ -3177,12 +3286,12 @@ function resolveLinkInverseTrio(seedHex, contrastProfile) {
   };
 }
 function escapeCtaFamily(nScale, mode, contrastProfile) {
-  const strongInk = (mode === "light" ? nScale.light : nScale.dark).find((s) => s.stop === 11);
-  if (!strongInk) throw new Error("escapeCtaFamily: the neutral scale has no ink-11 stop");
-  const mk = (stop, L) => makeStop(stop, L, strongInk.C, strongInk.H);
-  const cta = mk(9, strongInk.L);
-  const ctaHover = mk(10, stateFillL(strongInk.L, mode, 1));
-  const ctaPressed = mk(11, stateFillL(strongInk.L, mode, 2));
+  const strongText = (mode === "light" ? nScale.light : nScale.dark).find((s) => s.stop === 11);
+  if (!strongText) throw new Error("escapeCtaFamily: the neutral scale has no ink-11 stop");
+  const mk = (stop, L) => makeStop(stop, L, strongText.C, strongText.H);
+  const cta = mk(9, strongText.L);
+  const ctaHover = mk(10, stateFillL(strongText.L, mode, 1));
+  const ctaPressed = mk(11, stateFillL(strongText.L, mode, 2));
   const onEnforce = contrastProfile !== "apca";
   const onFloor = contrastProfile === "apca" ? void 0 : 4.5;
   const onFillIsWhite = onTextIsWhite(apcaY(cta.r, cta.g, cta.b), cta.L, cta.C, cta.H, onEnforce, onFloor);
@@ -3258,7 +3367,7 @@ function resolveTheme(input) {
     for (const def of SIGNALS2) {
       if (adoptedForSecondary.has(def.name)) continue;
       const h = checkHueCollision(scale2, effectiveOf(def.name), def, { minV: SECONDARY_NOTE_MIN_V });
-      if (h.collides) out.push(wording(def.name, Math.min(h.washDeltaE.light, h.washDeltaE.dark)));
+      if (h.collides) out.push(wording(def.name, Math.min(h.highlighterDeltaE.light, h.highlighterDeltaE.dark)));
     }
     return out;
   };
@@ -3308,7 +3417,7 @@ function resolveTheme(input) {
         derived: true,
         notes: [
           `secondary derived from the brand color (default model, seed ${liftedHex})`,
-          ...signalNotesFor(scale2, (name, dE) => `derived secondary sits on the ${name} signal's hue (wash \u0394E ${dE.toFixed(3)}) \u2014 it tracks the brand color`)
+          ...signalNotesFor(scale2, (name, dE) => `derived secondary sits on the ${name} signal's hue (highlighter \u0394E ${dE.toFixed(3)}) \u2014 it tracks the brand color`)
         ],
         distinctness: ctaDistinctness(primary.scale, scale2)
       },
@@ -3333,7 +3442,7 @@ function resolveTheme(input) {
         derived: false,
         notes: [
           `secondary keeps your color through the ramp; the cta is a tint of it (tint seed ${tintedHex})`,
-          ...signalNotesFor(scale2, (name, dE) => `secondary sits on the ${name} signal's hue (wash \u0394E ${dE.toFixed(3)}) \u2014 it tracks your color`)
+          ...signalNotesFor(scale2, (name, dE) => `secondary sits on the ${name} signal's hue (highlighter \u0394E ${dE.toFixed(3)}) \u2014 it tracks your color`)
         ],
         distinctness: distinctness2
       },
@@ -3345,7 +3454,7 @@ function resolveTheme(input) {
   const scale = rSec.scale;
   const level = "standard";
   mergeSecondarySignals(scale, input.secondaryHex);
-  const secNotes = signalNotesFor(scale, (name, dE) => `secondary reads close to the ${name} signal (wash \u0394E ${dE.toFixed(3)}) \u2014 your color ships untouched`);
+  const secNotes = signalNotesFor(scale, (name, dE) => `secondary reads close to the ${name} signal (highlighter \u0394E ${dE.toFixed(3)}) \u2014 your color ships untouched`);
   const distinctness = ctaDistinctness(primary.scale, scale);
   if (distinctness.close)
     notes.push(`secondary reads close to the primary (\u0394E ${Math.min(distinctness.light, distinctness.dark).toFixed(2)}) \u2014 consider a more distinct color`);
@@ -3358,113 +3467,6 @@ function resolveTheme(input) {
   };
 }
 
-// src/engine/tokenNames.ts
-var SHARED_NAMES = {
-  1: "paper-99",
-  2: "paper-97",
-  // stop 3 renamed wash-3 → paper-3 (owner 2026-07-24, elevation round): it is a
-  // PLANE in both themes (light sink / dark pop), so it belongs to the surface band.
-  // NAME ONLY — generation is index-keyed and unchanged; the internal wash machinery
-  // (reqtoken groupOf, collision WASH_STOPS) deliberately still spans stops 3–7.
-  // Stage B (owner 2026-08-07, names only): relabeled to the ROOT_L-derived digit,
-  // paper-95 — same band, same index.
-  3: "paper-95",
-  4: "wash-92",
-  5: "wash-89",
-  6: "wash-85",
-  7: "wash-80",
-  8: "wax-74",
-  // THE INK BAND (C49, owner 2026-08-05): the first text stop + emphasis fill (the
-  // 2026-07-29 highlight collapse — the old highlight-9 and on-highlight are
-  // deleted; this stop carries both jobs, its on-color a paper token), the between
-  // text stop (a value the retired text-cta hover state used to generate bespokely,
-  // promoted to a normal stop), and the strong text stop. The three read as states
-  // ARE the text-style cta (owner 2026-08-12). C49 restored the top
-  // two pre-collapse stop INDICES (11, and the off-scale anchor's 12 — emitted as a
-  // literal in cssRender, not through this table) with the between stop taking the
-  // vacated index 10; the indices (9/10/11) are unchanged since.
-  9: "lead-53",
-  10: "ink-42",
-  11: "ink-30"
-};
-var SCALE_STOP_COUNT = Object.keys(SHARED_NAMES).length;
-function stopTokenName(stop) {
-  const name = SHARED_NAMES[stop];
-  if (!name) throw new Error(`stopTokenName: unexpected stop ${stop}`);
-  return name;
-}
-var PAPER_100 = "paper-100";
-var INK_0 = "ink-0";
-var STAMP_FILL = "stamp-fill";
-var STAMP_FILL_HOVER = "stamp-fill-hover";
-var STAMP_FILL_PRESSED = "stamp-fill-pressed";
-var STAMP_EDGE = "stamp-edge";
-var STAMP_ON = "stamp-on";
-var STAMP_STATE_LEAVES = {
-  [STAMP_FILL]: "stamp/fill",
-  [STAMP_FILL_HOVER]: "stamp/fill-hover",
-  [STAMP_FILL_PRESSED]: "stamp/fill-pressed",
-  [STAMP_EDGE]: "stamp/edge",
-  [STAMP_ON]: "stamp/on"
-};
-var STAMP_LEAF = {
-  FILL: STAMP_STATE_LEAVES[STAMP_FILL],
-  FILL_HOVER: STAMP_STATE_LEAVES[STAMP_FILL_HOVER],
-  FILL_PRESSED: STAMP_STATE_LEAVES[STAMP_FILL_PRESSED],
-  EDGE: STAMP_STATE_LEAVES[STAMP_EDGE],
-  ON: STAMP_STATE_LEAVES[STAMP_ON]
-};
-var SYSTEM_LEAF = {
-  ABS_BLACK: "system/abs-black",
-  ABS_WHITE: "system/abs-white",
-  SURFACE: {
-    DIM: "system/surface/dim",
-    LOW: "system/surface/low",
-    MID: "system/surface/mid",
-    HIGH: "system/surface/high"
-  },
-  ALPHA: {
-    TRANSPARENT: "system/alpha/transparent",
-    SCRIM: "system/alpha/abs-black-060",
-    INK: "system/alpha/ink",
-    // the DIRECTIONAL ladders (owner 2026-08-31, renaming the 2026-08-18 bare rungs
-    // and the 2026-08-29 inverse ladder): away-from-bg is the page-polarity pole
-    // (black in light, white in dark), toward-bg the flipped pole — STATE LAYERS for
-    // INVERTED grounds, whose polarity is opposite the page's. (Never call toward-bg
-    // a "wash": that word belongs to the tinted band stops.) The reversal lives in
-    // the engine: a consumer on an inverted ground names one token and never picks a
-    // pole. Colored fills never ride these; their states stay engine-solved stops.
-    // Rungs are two-digit percent, harmonizing with shadow-04/08/12.
-    AWAY_FROM_BG_06: "system/alpha/away-from-bg/06",
-    AWAY_FROM_BG_08: "system/alpha/away-from-bg/08",
-    AWAY_FROM_BG_16: "system/alpha/away-from-bg/16",
-    TOWARD_BG_06: "system/alpha/toward-bg/06",
-    TOWARD_BG_08: "system/alpha/toward-bg/08",
-    TOWARD_BG_16: "system/alpha/toward-bg/16",
-    SHADOW_04: "system/alpha/shadow-04",
-    SHADOW_08: "system/alpha/shadow-08",
-    SHADOW_12: "system/alpha/shadow-12"
-  }
-};
-var SURFACE_PLANE_LAW = {
-  [SYSTEM_LEAF.SURFACE.DIM]: { light: SHARED_NAMES[3], dark: PAPER_100 },
-  [SYSTEM_LEAF.SURFACE.LOW]: { light: SHARED_NAMES[2], dark: SHARED_NAMES[1] },
-  [SYSTEM_LEAF.SURFACE.MID]: { light: SHARED_NAMES[1], dark: SHARED_NAMES[2] },
-  [SYSTEM_LEAF.SURFACE.HIGH]: { light: PAPER_100, dark: SHARED_NAMES[3] }
-};
-var TOKEN_ORDER = [
-  ...Object.values(SHARED_NAMES),
-  STAMP_FILL,
-  STAMP_FILL_HOVER,
-  STAMP_FILL_PRESSED,
-  STAMP_ON,
-  "identity"
-];
-function tokenOrder(name) {
-  const i = TOKEN_ORDER.indexOf(name);
-  return i === -1 ? TOKEN_ORDER.length : i;
-}
-
 // src/engine/cssRender.ts
 var { brandPrimary: CSS_BRAND, brandSecondary: CSS_SECONDARY, neutral: CSS_NEUTRAL } = CSS_FAMILY;
 function toHex2(r, g2, b) {
@@ -3511,7 +3513,7 @@ var alphaRootVars = (mode) => [
   ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  ${offsetVarName(r)}: ${offsetRgba(r, mode)};`),
   // the toward-bg ladder (the 2026-08-29 inverse ladder, renamed 2026-08-31): the
   // same rungs, pole flipped per mode — state layers for INVERTED grounds (never
-  // called a "wash" — that word is the tinted band's). One spelling with the Figma
+  // called a "highlighter" — that word is the tinted band's). One spelling with the Figma
   // row: --alpha-toward-bg-06 ↔ system/alpha/toward-bg/06.
   ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  --alpha-toward-bg-${offsetLeafName(r)}: ${offsetRgba(r, mode === "light" ? "dark" : "light")};`)
 ];
@@ -3538,7 +3540,7 @@ function brandKindBody(prefix, s, mode, page) {
     `  --${prefix}-stamp-fill-pressed: ${stopHex(f.ctaPressed)};`,
     `  --${prefix}-stamp-edge: var(${border ? offsetVarName(ctaBorderRung(prefix)) : TRANSPARENT_VAR});`,
     // the SOFT on-cta (owner 2026-08-04: "neutral cta on's should also be the alpha"): the
-    // neutral's cta is the scale-fed WASH-level fill, the system's other quiet cta, so its
+    // neutral's cta is the scale-fed HIGHLIGHTER-level fill, the system's other quiet cta, so its
     // button text takes the pole AT ALPHA like the default-model secondary's — composited
     // over whatever state the fill is in, so hover/pressed carry their own legibility. Same
     // register both families (SOFT_ON_CTA_ALPHA), so both alias the ONE system/alpha/ink
@@ -3568,16 +3570,16 @@ function neutralCss(selector, brandH, level = "default", contrastProfile, ctaBor
   const p3Dark = brandKindP3Body(CSS_NEUTRAL, s, "dark");
   return [
     `${selector} {`,
-    `  --${PAPER_100}: ${p02(s.paper0, "#ffffff")};`,
-    `  --${INK_0}: ${p02(s.ink0, "#000000")};`,
+    `  --${PAPER_0}: ${p02(s.paper0, "#ffffff")};`,
+    `  --${PEN_100}: ${p02(s.pen100, "#000000")};`,
     // the neutral IS the page, so it is judged against its own paper stop
     // the neutral's overlays never read the visibility bar (the exempt family), so
     // the brandless chrome context passes 0
     ...brandKindBody(CSS_NEUTRAL, s, "light", nPage("light")),
     `}`,
     `${selector}[data-theme="dark"] {`,
-    `  --${PAPER_100}: ${p02(s.paper0Dark, "#000000")};`,
-    `  --${INK_0}: ${p02(s.ink0Dark, "#ffffff")};`,
+    `  --${PAPER_0}: ${p02(s.paper0Dark, "#000000")};`,
+    `  --${PEN_100}: ${p02(s.pen100Dark, "#ffffff")};`,
     ...brandKindBody(CSS_NEUTRAL, s, "dark", nPage("dark")),
     `}`,
     ...p3Light.length || p3Dark.length ? [
@@ -3666,8 +3668,8 @@ function brandCss(slug, displayName, r, secondary, noteSuffix = "", neutralLevel
   const brandIdentity = `  --${CSS_BRAND}-identity: ${scale.identityHex};`;
   const secondaryIdentity = secondary ? `  --${CSS_SECONDARY}-identity: ${secondary.identityHex};` : `  --${CSS_SECONDARY}-identity: var(--${CSS_BRAND}-identity);`;
   const p0hex = (s, fallback) => s ? stopHex(s) : fallback;
-  const lightAnchors = [`  --${PAPER_100}: ${p0hex(nScale.paper0, "#ffffff")};`, `  --${INK_0}: ${p0hex(nScale.ink0, "#000000")};`];
-  const darkAnchors = [`  --${PAPER_100}: ${p0hex(nScale.paper0Dark, "#000000")};`, `  --${INK_0}: ${p0hex(nScale.ink0Dark, "#ffffff")};`];
+  const lightAnchors = [`  --${PAPER_0}: ${p0hex(nScale.paper0, "#ffffff")};`, `  --${PEN_100}: ${p0hex(nScale.pen100, "#000000")};`];
+  const darkAnchors = [`  --${PAPER_0}: ${p0hex(nScale.paper0Dark, "#000000")};`, `  --${PEN_100}: ${p0hex(nScale.pen100Dark, "#ffffff")};`];
   const linkTrio = linkHex ? resolveLinkTrio(linkHex, contrastProfile) : null;
   const link = (mode) => linkTrio ? mode === "light" ? [`  --link: ${stopHex(linkTrio.link)};`, `  --link-hover: ${stopHex(linkTrio.linkHover)};`, `  --link-pressed: ${stopHex(linkTrio.linkPressed)};`] : [`  --link: ${stopHex(linkTrio.linkDark)};`, `  --link-hover: ${stopHex(linkTrio.linkHoverDark)};`, `  --link-pressed: ${stopHex(linkTrio.linkPressedDark)};`] : [
     `  --link: var(--${CSS_BRAND}-${stopTokenName(9)});`,
@@ -3855,17 +3857,17 @@ function themeToFigma(r, input) {
   const build = (mode) => {
     const p02 = mode === "light" ? nScale.paper0 : nScale.paper0Dark;
     const ramp = rampGroup(nScale[mode], mode === "light" ? nScale.onFillTextIsWhite : nScale.onFillTextIsWhiteDark, neutralExtra(mode));
-    const i02 = mode === "light" ? nScale.ink0 : nScale.ink0Dark;
-    const spliceInk0 = (g3) => {
+    const i02 = mode === "light" ? nScale.pen100 : nScale.pen100Dark;
+    const splicePen100 = (g3) => {
       if (!i02) return g3;
       const out = {};
       for (const [k, v2] of Object.entries(g3)) {
         out[k] = v2;
-        if (k === stopTokenName(11)) out[INK_0] = colorFromStop(i02);
+        if (k === stopTokenName(11)) out[PEN_100] = colorFromStop(i02);
       }
       return out;
     };
-    const neutralGroup = spliceInk0(p02 ? { [PAPER_100]: colorFromStop(p02), ...ramp } : ramp);
+    const neutralGroup = splicePen100(p02 ? { [PAPER_0]: colorFromStop(p02), ...ramp } : ramp);
     const secondaryGroup = rampGroup(secondary[mode], mode === "light" ? secondaryOnFillLight : secondaryOnFillDark, brandExtra(secondary, mode, CSS_FAMILY.brandSecondary));
     if (input.secondaryStyle === "outline" && input.secondary) {
       const s8 = secondary[mode].find((s) => s.stop === 8);
@@ -3903,12 +3905,12 @@ function themeToFigma(r, input) {
         putLeaf(g3, STAMP_ON, colorFromHex(esc.onFillIsWhite));
       }
     }
-    const scaleInkAt = (n) => {
+    const scaleTextAt = (n) => {
       const s = scale[mode].find((x2) => x2.stop === n);
-      if (!s) throw new Error(`themeToFigma link: the brand scale has no ink stop ${n}`);
+      if (!s) throw new Error(`themeToFigma link: the brand scale has no pen stop ${n}`);
       return s;
     };
-    const linkGroup = lt ? mode === "light" ? { "link": colorFromStop(lt.link), "link-hover": colorFromStop(lt.linkHover), "link-pressed": colorFromStop(lt.linkPressed) } : { "link": colorFromStop(lt.linkDark), "link-hover": colorFromStop(lt.linkHoverDark), "link-pressed": colorFromStop(lt.linkPressedDark) } : { "link": colorFromStop(scaleInkAt(9)), "link-hover": colorFromStop(scaleInkAt(10)), "link-pressed": colorFromStop(scaleInkAt(11)) };
+    const linkGroup = lt ? mode === "light" ? { "link": colorFromStop(lt.link), "link-hover": colorFromStop(lt.linkHover), "link-pressed": colorFromStop(lt.linkPressed) } : { "link": colorFromStop(lt.linkDark), "link-hover": colorFromStop(lt.linkHoverDark), "link-pressed": colorFromStop(lt.linkPressedDark) } : { "link": colorFromStop(scaleTextAt(9)), "link-hover": colorFromStop(scaleTextAt(10)), "link-pressed": colorFromStop(scaleTextAt(11)) };
     const linkInverseGroup = mode === "light" ? { "link": colorFromStop(invLt.link), "link-hover": colorFromStop(invLt.linkHover), "link-pressed": colorFromStop(invLt.linkPressed) } : { "link": colorFromStop(invLt.linkDark), "link-hover": colorFromStop(invLt.linkHoverDark), "link-pressed": colorFromStop(invLt.linkPressedDark) };
     const g2 = {
       brand: brandGroup,