okchroma 0.1.5 → 0.1.7

package/dist-lib/index.cjs

@@ -405,7 +405,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.801, 0.653],
     // wash-7    │
     [0.738, 0.505],
-    // highlight-8
+    // wax-74
     [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
+    // wax-74
     [0.6, 0.4],
     // knee (ex-scaffold)
     [0.64, 0.347],
@@ -800,10 +800,119 @@ 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-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 wash-collision machinery
+  // (collision.ts WASH_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-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/requirements/spec.ts
-var groupOf = (stop) => stop <= 2 ? "paper" : stop <= 7 ? "wash" : stop === 8 ? "highlight" : "ink";
+var inkLane = (g2) => g2 === "lead" || g2 === "ink";
+var groupOf = (stop) => (stop === 0 ? PAPER_100 : stopTokenName(stop)).split("-")[0];
 var PAPER0_DARK_ROOT_L = 0.16;
-var INK0_SEAM_OVERSHOOT = (ROOT_L_DARK[1] - PAPER0_DARK_ROOT_L) / (ROOT_L_DARK[2] - ROOT_L_DARK[1]);
 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" };
@@ -817,7 +926,7 @@ var ONS = { onFill: { metric: "apca-pole", enforce: true, ratioFloor: 4.5, coEnf
 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 },
+    { 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/wash/wax-74: 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)).
@@ -833,9 +942,9 @@ var LIGHT = {
     // 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) —
     // 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].inkMult, inkMaxC: SCALE_C_LIGHT[9].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_LIGHT[10].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_LIGHT[11].inkMaxC, chromaFloor: SCALE_C_LIGHT[11].chromaFloor, require: T11 }
   ],
   roles: [
     { role: "cta", produce: { hue: "constant", L: "anchor", chroma: "brand" }, floorL: 0, chromaMult: 1 },
@@ -848,7 +957,7 @@ 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
     // 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 },
+    { stop: 0, rootL: PAPER0_DARK_ROOT_L, group: groupOf(0), 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
     // 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
@@ -865,9 +974,9 @@ var DARK = {
     })),
     // ink 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].inkMult, inkMaxC: SCALE_C_DARK[9].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_DARK[10].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_DARK[11].inkMaxC, 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 },
@@ -2304,7 +2413,7 @@ function resolveRamp(hex, mode, spec, opts) {
     let placed;
     let clamped = false, unresolvable;
     if (mode === "light") {
-      if (sp.group === "ink") {
+      if (inkLane(sp.group)) {
         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);
         clamped = true;
@@ -2328,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 inkTwin = inkLane(sp.group) && ctx.opts?.deltaCarry && ctx.opts?.chromaCurve ? ctx.opts.deltaLightStops?.find((s) => s.stop === sp.stop) : void 0;
+      const chromaAt = inkLane(sp.group) ? 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);
       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;
@@ -2349,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 && !inkLane(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) };
@@ -2569,10 +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 inkExtreme = (arr) => {
-    const a = arr.find((s) => s.stop === 10), b = arr.find((s) => s.stop === 11);
-    return a && b ? makeStop(12, b.L + (b.L - a.L) * INK0_SEAM_OVERSHOOT, b.C, b.H) : void 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 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);
@@ -2596,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: inkExtreme(light),
-    ink0Dark: inkExtreme(dark)
+    ink0: inkPole(light, 0),
+    ink0Dark: inkPole(dark, 1)
   };
 }
 function generateNeutralScale(brandH, level = "default", contrastProfile) {
@@ -2773,15 +2879,15 @@ var SYSTEM = {
   // ("fills" reworded 2026-08-18: fill became a label word and is foreign here;
   // "on-color" reworded 2026-08-28: the bare on fed the "on" flood)
   "system/alpha/ink": { req: "soft text pole for quiet CTAs" },
-  "system/alpha/006": OFFSET,
-  "system/alpha/008": OFFSET,
-  "system/alpha/016": OFFSET,
+  "system/alpha/away-from-bg/06": OFFSET,
+  "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
   // bodies: acti-ON would feed the "on" flood)
-  "system/alpha/inverse-006": OFFSET_INVERSE,
-  "system/alpha/inverse-008": OFFSET_INVERSE,
-  "system/alpha/inverse-016": OFFSET_INVERSE,
+  "system/alpha/toward-bg/06": OFFSET_INVERSE,
+  "system/alpha/toward-bg/08": OFFSET_INVERSE,
+  "system/alpha/toward-bg/16": OFFSET_INVERSE,
   "system/alpha/shadow-04": SHADOW,
   "system/alpha/shadow-08": SHADOW,
   "system/alpha/shadow-12": SHADOW,
@@ -2792,12 +2898,12 @@ var SYSTEM = {
   "system/surface/mid": PLANE("raised plane \u2014 cards, menus"),
   // ("overlays" reworded 2026-08-13: paper-overlay took the word as a label — the C50 law)
   "system/surface/high": PLANE("topmost plane \u2014 modals, dialogs"),
-  "system/link/default": LINK("", AA_BODY),
-  "system/link/hover": LINK(" pointer-over", AA_BODY),
-  "system/link/pressed": LINK(" pressed", AAA_BODY),
-  "system/link/inverse": 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/default/enabled": LINK("", AA_BODY),
+  "system/link/default/hover": LINK(" pointer-over", AA_BODY),
+  "system/link/default/pressed": LINK(" pressed", AAA_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)
 };
 var PREFIXES = [
   // community spellings FIRST: the 2026-08-21 family rename made the ext word a
@@ -3362,112 +3468,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",
-    OFFSET_006: "system/alpha/006",
-    OFFSET_008: "system/alpha/008",
-    OFFSET_016: "system/alpha/016",
-    // the INVERSE offset ladder (owner 2026-08-29, the interaction round): the
-    // same rungs with the pole flipped per mode — white in light, black in dark
-    // — STATE LAYERS for INVERTED grounds, whose polarity is opposite the
-    // page's. (Never call these a "wash": that word belongs to the tinted band
-    // stops.) The reversal lives in the engine (the system/surface posture): 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.
-    INVERSE_006: "system/alpha/inverse-006",
-    INVERSE_008: "system/alpha/inverse-008",
-    INVERSE_016: "system/alpha/inverse-016",
-    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) {
@@ -3498,8 +3498,8 @@ function pageStopFor(neutral, mode) {
 }
 var OFFSET_ALPHAS = { 6: 0.06, 8: 0.08, 16: 0.16 };
 var ctaBorderRung = (prefix) => prefix === CSS_NEUTRAL ? 8 : prefix === CSS_SECONDARY ? 6 : 16;
-var offsetLeafName = (rung) => String(rung).padStart(3, "0");
-var offsetVarName = (rung) => `--alpha-${offsetLeafName(rung)}`;
+var offsetLeafName = (rung) => String(rung).padStart(2, "0");
+var offsetVarName = (rung) => `--alpha-away-from-bg-${offsetLeafName(rung)}`;
 var SHADOW_ALPHAS = {
   4: { light: 0.04, dark: 0.32 },
   8: { light: 0.08, dark: 0.48 },
@@ -3512,11 +3512,11 @@ var offsetRgba = (rung, mode) => mode === "light" ? `rgba(0, 0, 0, ${OFFSET_ALPH
 var alphaRootVars = (mode) => [
   `  ${TRANSPARENT_VAR}: transparent;`,
   ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  ${offsetVarName(r)}: ${offsetRgba(r, mode)};`),
-  // the INVERSE ladder: the same rungs, pole flipped per mode — state layers
-  // for INVERTED grounds (owner 2026-08-29; never called a "wash" — that word
-  // is the tinted band's). One spelling with the Figma row:
-  // --alpha-inverse-006 ↔ system/alpha/inverse-006.
-  ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  --alpha-inverse-${offsetLeafName(r)}: ${offsetRgba(r, mode === "light" ? "dark" : "light")};`)
+  // 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
+  // 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")};`)
 ];
 function ctaPageLc(s, mode, page) {
   const cta = mode === "light" ? s.cta : s.ctaDark;
@@ -3945,13 +3945,13 @@ function themeToFigma(r, input) {
     putLeaf(g2, SYSTEM_LEAF.ALPHA.TRANSPARENT, pole(true, 0));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SCRIM, pole(false, SCRIM_ALPHA));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.INK, pole(mode === "dark", SOFT_ON_CTA_ALPHA[mode]));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_006, OFFSET_TOKEN(6, mode));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_008, OFFSET_TOKEN(8, mode));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_016, OFFSET_TOKEN(16, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_06, OFFSET_TOKEN(6, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_08, OFFSET_TOKEN(8, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_16, OFFSET_TOKEN(16, mode));
     const inv = mode === "light" ? "dark" : "light";
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_006, OFFSET_TOKEN(6, inv));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_008, OFFSET_TOKEN(8, inv));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_016, OFFSET_TOKEN(16, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_06, OFFSET_TOKEN(6, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_08, OFFSET_TOKEN(8, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_16, OFFSET_TOKEN(16, inv));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_04, pole(false, SHADOW_ALPHAS[4][mode]));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_08, pole(false, SHADOW_ALPHAS[8][mode]));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_12, pole(false, SHADOW_ALPHAS[12][mode]));

package/dist-lib/index.mjs

@@ -326,7 +326,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.801, 0.653],
     // wash-7    │
     [0.738, 0.505],
-    // highlight-8
+    // wax-74
     [0.6, 0.4],
     // knee (ex-scaffold)   the drop-off: hue fades as you climb
     [0.56, 0.347],
@@ -352,7 +352,7 @@ var NEUTRAL_TINT_POINTS = {
     [0.42, 0.653],
     // wash-7
     [0.55, 0.505],
-    // highlight-8
+    // wax-74
     [0.6, 0.4],
     // knee (ex-scaffold)
     [0.64, 0.347],
@@ -721,10 +721,119 @@ 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-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 wash-collision machinery
+  // (collision.ts WASH_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-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/requirements/spec.ts
-var groupOf = (stop) => stop <= 2 ? "paper" : stop <= 7 ? "wash" : stop === 8 ? "highlight" : "ink";
+var inkLane = (g2) => g2 === "lead" || g2 === "ink";
+var groupOf = (stop) => (stop === 0 ? PAPER_100 : stopTokenName(stop)).split("-")[0];
 var PAPER0_DARK_ROOT_L = 0.16;
-var INK0_SEAM_OVERSHOOT = (ROOT_L_DARK[1] - PAPER0_DARK_ROOT_L) / (ROOT_L_DARK[2] - ROOT_L_DARK[1]);
 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" };
@@ -738,7 +847,7 @@ var ONS = { onFill: { metric: "apca-pole", enforce: true, ratioFloor: 4.5, coEnf
 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 },
+    { 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/wash/wax-74: 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)).
@@ -754,9 +863,9 @@ var LIGHT = {
     // 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) —
     // 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].inkMult, inkMaxC: SCALE_C_LIGHT[9].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_LIGHT[10].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_LIGHT[11].inkMaxC, chromaFloor: SCALE_C_LIGHT[11].chromaFloor, require: T11 }
   ],
   roles: [
     { role: "cta", produce: { hue: "constant", L: "anchor", chroma: "brand" }, floorL: 0, chromaMult: 1 },
@@ -769,7 +878,7 @@ 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
     // 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 },
+    { stop: 0, rootL: PAPER0_DARK_ROOT_L, group: groupOf(0), 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
     // 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
@@ -786,9 +895,9 @@ var DARK = {
     })),
     // ink 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].inkMult, inkMaxC: SCALE_C_DARK[9].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_DARK[10].inkMaxC, 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].inkMult, inkMaxC: SCALE_C_DARK[11].inkMaxC, 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 },
@@ -2225,7 +2334,7 @@ function resolveRamp(hex, mode, spec, opts) {
     let placed;
     let clamped = false, unresolvable;
     if (mode === "light") {
-      if (sp.group === "ink") {
+      if (inkLane(sp.group)) {
         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);
         clamped = true;
@@ -2249,8 +2358,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 inkTwin = inkLane(sp.group) && ctx.opts?.deltaCarry && ctx.opts?.chromaCurve ? ctx.opts.deltaLightStops?.find((s) => s.stop === sp.stop) : void 0;
+      const chromaAt = inkLane(sp.group) ? 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);
       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;
@@ -2270,7 +2379,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 && !inkLane(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) };
@@ -2490,10 +2599,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 inkExtreme = (arr) => {
-    const a = arr.find((s) => s.stop === 10), b = arr.find((s) => s.stop === 11);
-    return a && b ? makeStop(12, b.L + (b.L - a.L) * INK0_SEAM_OVERSHOOT, b.C, b.H) : void 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 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);
@@ -2517,8 +2623,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: inkExtreme(light),
-    ink0Dark: inkExtreme(dark)
+    ink0: inkPole(light, 0),
+    ink0Dark: inkPole(dark, 1)
   };
 }
 function generateNeutralScale(brandH, level = "default", contrastProfile) {
@@ -2694,15 +2800,15 @@ var SYSTEM = {
   // ("fills" reworded 2026-08-18: fill became a label word and is foreign here;
   // "on-color" reworded 2026-08-28: the bare on fed the "on" flood)
   "system/alpha/ink": { req: "soft text pole for quiet CTAs" },
-  "system/alpha/006": OFFSET,
-  "system/alpha/008": OFFSET,
-  "system/alpha/016": OFFSET,
+  "system/alpha/away-from-bg/06": OFFSET,
+  "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
   // bodies: acti-ON would feed the "on" flood)
-  "system/alpha/inverse-006": OFFSET_INVERSE,
-  "system/alpha/inverse-008": OFFSET_INVERSE,
-  "system/alpha/inverse-016": OFFSET_INVERSE,
+  "system/alpha/toward-bg/06": OFFSET_INVERSE,
+  "system/alpha/toward-bg/08": OFFSET_INVERSE,
+  "system/alpha/toward-bg/16": OFFSET_INVERSE,
   "system/alpha/shadow-04": SHADOW,
   "system/alpha/shadow-08": SHADOW,
   "system/alpha/shadow-12": SHADOW,
@@ -2713,12 +2819,12 @@ var SYSTEM = {
   "system/surface/mid": PLANE("raised plane \u2014 cards, menus"),
   // ("overlays" reworded 2026-08-13: paper-overlay took the word as a label — the C50 law)
   "system/surface/high": PLANE("topmost plane \u2014 modals, dialogs"),
-  "system/link/default": LINK("", AA_BODY),
-  "system/link/hover": LINK(" pointer-over", AA_BODY),
-  "system/link/pressed": LINK(" pressed", AAA_BODY),
-  "system/link/inverse": 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/default/enabled": LINK("", AA_BODY),
+  "system/link/default/hover": LINK(" pointer-over", AA_BODY),
+  "system/link/default/pressed": LINK(" pressed", AAA_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)
 };
 var PREFIXES = [
   // community spellings FIRST: the 2026-08-21 family rename made the ext word a
@@ -3283,112 +3389,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",
-    OFFSET_006: "system/alpha/006",
-    OFFSET_008: "system/alpha/008",
-    OFFSET_016: "system/alpha/016",
-    // the INVERSE offset ladder (owner 2026-08-29, the interaction round): the
-    // same rungs with the pole flipped per mode — white in light, black in dark
-    // — STATE LAYERS for INVERTED grounds, whose polarity is opposite the
-    // page's. (Never call these a "wash": that word belongs to the tinted band
-    // stops.) The reversal lives in the engine (the system/surface posture): 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.
-    INVERSE_006: "system/alpha/inverse-006",
-    INVERSE_008: "system/alpha/inverse-008",
-    INVERSE_016: "system/alpha/inverse-016",
-    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) {
@@ -3419,8 +3419,8 @@ function pageStopFor(neutral, mode) {
 }
 var OFFSET_ALPHAS = { 6: 0.06, 8: 0.08, 16: 0.16 };
 var ctaBorderRung = (prefix) => prefix === CSS_NEUTRAL ? 8 : prefix === CSS_SECONDARY ? 6 : 16;
-var offsetLeafName = (rung) => String(rung).padStart(3, "0");
-var offsetVarName = (rung) => `--alpha-${offsetLeafName(rung)}`;
+var offsetLeafName = (rung) => String(rung).padStart(2, "0");
+var offsetVarName = (rung) => `--alpha-away-from-bg-${offsetLeafName(rung)}`;
 var SHADOW_ALPHAS = {
   4: { light: 0.04, dark: 0.32 },
   8: { light: 0.08, dark: 0.48 },
@@ -3433,11 +3433,11 @@ var offsetRgba = (rung, mode) => mode === "light" ? `rgba(0, 0, 0, ${OFFSET_ALPH
 var alphaRootVars = (mode) => [
   `  ${TRANSPARENT_VAR}: transparent;`,
   ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  ${offsetVarName(r)}: ${offsetRgba(r, mode)};`),
-  // the INVERSE ladder: the same rungs, pole flipped per mode — state layers
-  // for INVERTED grounds (owner 2026-08-29; never called a "wash" — that word
-  // is the tinted band's). One spelling with the Figma row:
-  // --alpha-inverse-006 ↔ system/alpha/inverse-006.
-  ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  --alpha-inverse-${offsetLeafName(r)}: ${offsetRgba(r, mode === "light" ? "dark" : "light")};`)
+  // 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
+  // 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")};`)
 ];
 function ctaPageLc(s, mode, page) {
   const cta = mode === "light" ? s.cta : s.ctaDark;
@@ -3866,13 +3866,13 @@ function themeToFigma(r, input) {
     putLeaf(g2, SYSTEM_LEAF.ALPHA.TRANSPARENT, pole(true, 0));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SCRIM, pole(false, SCRIM_ALPHA));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.INK, pole(mode === "dark", SOFT_ON_CTA_ALPHA[mode]));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_006, OFFSET_TOKEN(6, mode));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_008, OFFSET_TOKEN(8, mode));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.OFFSET_016, OFFSET_TOKEN(16, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_06, OFFSET_TOKEN(6, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_08, OFFSET_TOKEN(8, mode));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.AWAY_FROM_BG_16, OFFSET_TOKEN(16, mode));
     const inv = mode === "light" ? "dark" : "light";
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_006, OFFSET_TOKEN(6, inv));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_008, OFFSET_TOKEN(8, inv));
-    putLeaf(g2, SYSTEM_LEAF.ALPHA.INVERSE_016, OFFSET_TOKEN(16, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_06, OFFSET_TOKEN(6, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_08, OFFSET_TOKEN(8, inv));
+    putLeaf(g2, SYSTEM_LEAF.ALPHA.TOWARD_BG_16, OFFSET_TOKEN(16, inv));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_04, pole(false, SHADOW_ALPHAS[4][mode]));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_08, pole(false, SHADOW_ALPHAS[8][mode]));
     putLeaf(g2, SYSTEM_LEAF.ALPHA.SHADOW_12, pole(false, SHADOW_ALPHAS[12][mode]));

package/dist-lib/types/engine/requirements/spec.d.ts

@@ -1,4 +1,5 @@
-export type Group = 'paper' | 'wash' | 'highlight' | 'ink';
+export type Group = 'paper' | 'wash' | 'wax' | 'lead' | 'ink';
+export declare const inkLane: (g: string) => boolean;
 export type Producer = {
     hue: 'warm-drift' | 'warm-torsion' | 'constant';
     L: 'perceptual' | 'perceptual-lift' | 'fixed';
@@ -56,7 +57,6 @@ export type ModeSpec = {
     };
 };
 export declare const PAPER0_DARK_ROOT_L = 0.16;
-export declare const INK0_SEAM_OVERSHOOT: number;
 export declare const LIGHT: ModeSpec;
 export declare const DARK: ModeSpec;
 export declare const MODE_SPECS: {

package/dist-lib/types/engine/tokenNames.d.ts

@@ -28,12 +28,12 @@ export declare const SYSTEM_LEAF: {
         readonly TRANSPARENT: "system/alpha/transparent";
         readonly SCRIM: "system/alpha/abs-black-060";
         readonly INK: "system/alpha/ink";
-        readonly OFFSET_006: "system/alpha/006";
-        readonly OFFSET_008: "system/alpha/008";
-        readonly OFFSET_016: "system/alpha/016";
-        readonly INVERSE_006: "system/alpha/inverse-006";
-        readonly INVERSE_008: "system/alpha/inverse-008";
-        readonly INVERSE_016: "system/alpha/inverse-016";
+        readonly AWAY_FROM_BG_06: "system/alpha/away-from-bg/06";
+        readonly AWAY_FROM_BG_08: "system/alpha/away-from-bg/08";
+        readonly AWAY_FROM_BG_16: "system/alpha/away-from-bg/16";
+        readonly TOWARD_BG_06: "system/alpha/toward-bg/06";
+        readonly TOWARD_BG_08: "system/alpha/toward-bg/08";
+        readonly TOWARD_BG_16: "system/alpha/toward-bg/16";
         readonly SHADOW_04: "system/alpha/shadow-04";
         readonly SHADOW_08: "system/alpha/shadow-08";
         readonly SHADOW_12: "system/alpha/shadow-12";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okchroma",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "license": "MIT",
   "description": "Color token engine: one brand hex in, a full WCAG-enforced light+dark token system out (CSS variables, DTCG JSON, Figma variables)",
   "repository": {
@@ -33,8 +33,8 @@
     "audit:alpha": "esbuild scripts/alpha-audit.ts --bundle --platform=node --outfile=dist/alpha-audit.js && node dist/alpha-audit.js",
     "audit:alpha:bless": "esbuild scripts/alpha-audit.ts --bundle --platform=node --outfile=dist/alpha-audit.js && node dist/alpha-audit.js --bless",
     "audit:bless": "esbuild scripts/dark-audit.ts --bundle --platform=node --outfile=dist/dark-audit.js && node dist/dark-audit.js --bless",
-    "highlight-audit": "esbuild scripts/highlight-audit.ts --bundle --platform=node --outfile=dist/highlight-audit.js && node dist/highlight-audit.js",
-    "highlight-audit:bless": "esbuild scripts/highlight-audit.ts --bundle --platform=node --outfile=dist/highlight-audit.js && node dist/highlight-audit.js --bless",
+    "band-audit": "esbuild scripts/band-audit.ts --bundle --platform=node --outfile=dist/band-audit.js && node dist/band-audit.js",
+    "band-audit:bless": "esbuild scripts/band-audit.ts --bundle --platform=node --outfile=dist/band-audit.js && node dist/band-audit.js --bless",
     "audit:divergence": "esbuild scripts/divergence-audit.ts --bundle --platform=node --outfile=dist/divergence-audit.js && node dist/divergence-audit.js",
     "audit:divergence:bless": "esbuild scripts/divergence-audit.ts --bundle --platform=node --outfile=dist/divergence-audit.js && node dist/divergence-audit.js --bless",
     "smooth": "esbuild scripts/smoothness-audit.ts --bundle --platform=node --outfile=dist/smoothness-audit.js && node dist/smoothness-audit.js",