okchroma 0.1.4 → 0.1.6

package/dist-lib/index.cjs

@@ -803,7 +803,6 @@ function perceptualDarkC(L, H2, nativeC, keep = KEEP_DARK, gamut = MASTER_GAMUT)
 // src/engine/requirements/spec.ts
 var groupOf = (stop) => stop <= 2 ? "paper" : stop <= 7 ? "wash" : stop === 8 ? "highlight" : "ink";
 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" };
@@ -818,7 +817,7 @@ 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/mark-74: perceptual ladder/envelope blend on the geometric ROOT_L_LIGHT scaffold. Separation
+    // 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)).
     ...[1, 2, 3, 4, 5, 6, 7, 8].map((stop) => ({
@@ -878,7 +877,7 @@ var DARK = {
 };
 var MODE_SPECS = { light: LIGHT, dark: DARK };
 
-// node_modules/helmlab/dist/index.js
+// ../../../Users/emilygerrity/okchroma/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];
@@ -2569,10 +2568,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 +2592,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) {
@@ -2725,8 +2721,8 @@ var SCALE = {
   "wash-85": WASH,
   "wash-80": WASH,
   // ("icons" KEPT through the 2026-08-28 on-flood strip (owner): an "icon" query
-  // landing on the mark rows is worth its ic-ON-s noise — the one surviving body carrier)
-  "mark-74": { req: "focus rings, icons, large text", contrast: AA_LARGE, theming: solved, collides: true },
+  // 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 },
   // ("high-emphasis" reworded 2026-08-12: the surface planes took low/high as label
@@ -2773,15 +2769,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 +2788,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
@@ -3377,7 +3373,7 @@ var SHARED_NAMES = {
   5: "wash-89",
   6: "wash-85",
   7: "wash-80",
-  8: "mark-74",
+  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
@@ -3431,19 +3427,20 @@ var SYSTEM_LEAF = {
     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",
+    // 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"
@@ -3498,8 +3495,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 +3509,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 +3942,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

@@ -724,7 +724,6 @@ function perceptualDarkC(L, H2, nativeC, keep = KEEP_DARK, gamut = MASTER_GAMUT)
 // src/engine/requirements/spec.ts
 var groupOf = (stop) => stop <= 2 ? "paper" : stop <= 7 ? "wash" : stop === 8 ? "highlight" : "ink";
 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" };
@@ -739,7 +738,7 @@ 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/mark-74: perceptual ladder/envelope blend on the geometric ROOT_L_LIGHT scaffold. Separation
+    // 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)).
     ...[1, 2, 3, 4, 5, 6, 7, 8].map((stop) => ({
@@ -799,7 +798,7 @@ var DARK = {
 };
 var MODE_SPECS = { light: LIGHT, dark: DARK };
 
-// node_modules/helmlab/dist/index.js
+// ../../../Users/emilygerrity/okchroma/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];
@@ -2490,10 +2489,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 +2513,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) {
@@ -2646,8 +2642,8 @@ var SCALE = {
   "wash-85": WASH,
   "wash-80": WASH,
   // ("icons" KEPT through the 2026-08-28 on-flood strip (owner): an "icon" query
-  // landing on the mark rows is worth its ic-ON-s noise — the one surviving body carrier)
-  "mark-74": { req: "focus rings, icons, large text", contrast: AA_LARGE, theming: solved, collides: true },
+  // 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 },
   // ("high-emphasis" reworded 2026-08-12: the surface planes took low/high as label
@@ -2694,15 +2690,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 +2709,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
@@ -3298,7 +3294,7 @@ var SHARED_NAMES = {
   5: "wash-89",
   6: "wash-85",
   7: "wash-80",
-  8: "mark-74",
+  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
@@ -3352,19 +3348,20 @@ var SYSTEM_LEAF = {
     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",
+    // 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"
@@ -3419,8 +3416,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 +3430,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 +3863,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

@@ -56,7 +56,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.4",
+  "version": "0.1.6",
   "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": {

package/tokens/semantic.css

@@ -26,13 +26,13 @@
      theme, riding --link — no longer the brand's raw ink pair) */
 
   /* --border-default IS THE ACCESSIBILITY BORDER (owner 2026-07-29): a border that has
-     to be there — inputs and other controls — so it rides mark-74, the stop that
+     to be there — inputs and other controls — so it rides wax-74, the stop that
      carries the WCAG 1.4.11 3:1 non-text require (highlight-8 pre-Stage-B). It sat on
-     --neutral-highlight-9 until that stop was deleted; mark-74 is where the
+     --neutral-highlight-9 until that stop was deleted; wax-74 is where the
      requirement actually lives, and it is the one stop this round does not move.
      Decorative borders are --border-subtle (wash-89) and the per-family
      --*-border-default (wash-85). */
-  --border-default:       var(--neutral-mark-74);
+  --border-default:       var(--neutral-wax-74);
   --border-subtle:        var(--neutral-wash-89);
 
   /* Shadow transparencies (owner 2026-07-27) — pure black, mirrors the plugin's
@@ -86,7 +86,7 @@
   --brand-border-subtle:         var(--brand-wash-92);
   --brand-border-subtle-hover:   var(--brand-wash-89);
   --brand-border-default:            var(--brand-wash-85);
-  --brand-border-default-hover:      var(--brand-mark-74);
+  --brand-border-default-hover:      var(--brand-wax-74);
   --brand-border-emphasis:       var(--brand-stamp-fill);
   --brand-border-emphasis-hover: var(--brand-stamp-fill-hover);
 
@@ -123,7 +123,7 @@
   --brand-alt-border-subtle:         var(--brand-alt-wash-92);
   --brand-alt-border-subtle-hover:   var(--brand-alt-wash-89);
   --brand-alt-border-default:           var(--brand-alt-wash-85);
-  --brand-alt-border-default-hover:     var(--brand-alt-mark-74);
+  --brand-alt-border-default-hover:     var(--brand-alt-wax-74);
   --brand-alt-border-emphasis:       var(--brand-alt-stamp-fill);
   --brand-alt-border-emphasis-hover: var(--brand-alt-stamp-fill-hover);
 }
@@ -159,7 +159,7 @@
   --critical-border-subtle:         var(--critical-wash-92);
   --critical-border-subtle-hover:   var(--critical-wash-89);
   --critical-border-default:       var(--critical-wash-85);
-  --critical-border-default-hover: var(--critical-mark-74);
+  --critical-border-default-hover: var(--critical-wax-74);
   --critical-border-emphasis:       var(--critical-lead-53);
 
   --warning-fg:                     var(--warning-ink-30);
@@ -174,7 +174,7 @@
   --warning-border-subtle:          var(--warning-wash-92);
   --warning-border-subtle-hover:    var(--warning-wash-89);
   --warning-border-default:        var(--warning-wash-85);
-  --warning-border-default-hover:  var(--warning-mark-74);
+  --warning-border-default-hover:  var(--warning-wax-74);
   --warning-border-emphasis:        var(--warning-lead-53);
 
   --positive-fg:                      var(--positive-ink-30);
@@ -189,7 +189,7 @@
   --positive-border-subtle:           var(--positive-wash-92);
   --positive-border-subtle-hover:     var(--positive-wash-89);
   --positive-border-default:         var(--positive-wash-85);
-  --positive-border-default-hover:   var(--positive-mark-74);
+  --positive-border-default-hover:   var(--positive-wax-74);
   --positive-border-emphasis:         var(--positive-lead-53);
 
   --info-fg:                          var(--info-ink-30);
@@ -204,6 +204,6 @@
   --info-border-subtle:               var(--info-wash-92);
   --info-border-subtle-hover:         var(--info-wash-89);
   --info-border-default:             var(--info-wash-85);
-  --info-border-default-hover:       var(--info-mark-74);
+  --info-border-default-hover:       var(--info-wax-74);
   --info-border-emphasis:             var(--info-lead-53);
 }