okchroma 0.1.2 → 0.1.4

package/dist-lib/index.cjs

@@ -22,6 +22,7 @@ var index_exports = {};
 __export(index_exports, {
   CSS_FAMILY: () => CSS_FAMILY,
   DEFAULT_LINK_HEX: () => DEFAULT_LINK_HEX,
+  DISABLED_OPACITY: () => DISABLED_OPACITY,
   EXT_KEY: () => EXT_KEY,
   INK_0: () => INK_0,
   MODE_SPECS: () => MODE_SPECS,
@@ -2744,6 +2745,7 @@ var SCALE = {
 };
 var ABS = { req: "extreme poles for CTAs, aliased global endpoints" };
 var OFFSET = { req: "min APCA visibility", theming: "offsets CTAs in themes where they sit close to the page" };
+var OFFSET_INVERSE = { req: "state layers over inverted backgrounds", theming: "the offset ladder with its pole flipped, so inverted grounds keep the same rungs" };
 var SHADOW = { req: "drop shadows" };
 var PLANE = (req) => ({ req, theming: "aliased to the gray ramp" });
 var LINK = (state, contrast) => ({
@@ -2774,6 +2776,12 @@ var SYSTEM = {
   "system/alpha/006": OFFSET,
   "system/alpha/008": OFFSET,
   "system/alpha/016": 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/shadow-04": SHADOW,
   "system/alpha/shadow-08": SHADOW,
   "system/alpha/shadow-12": SHADOW,
@@ -3426,6 +3434,16 @@ var SYSTEM_LEAF = {
     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"
@@ -3488,11 +3506,17 @@ var SHADOW_ALPHAS = {
   12: { light: 0.12, dark: 0.64 }
 };
 var SCRIM_ALPHA = 0.6;
+var DISABLED_OPACITY = 0.38;
 var TRANSPARENT_VAR = "--alpha-transparent";
 var offsetRgba = (rung, mode) => mode === "light" ? `rgba(0, 0, 0, ${OFFSET_ALPHAS[rung]})` : `rgba(255, 255, 255, ${OFFSET_ALPHAS[rung]})`;
 var alphaRootVars = (mode) => [
   `  ${TRANSPARENT_VAR}: transparent;`,
-  ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  ${offsetVarName(r)}: ${offsetRgba(r, mode)};`)
+  ...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")};`)
 ];
 function ctaPageLc(s, mode, page) {
   const cta = mode === "light" ? s.cta : s.ctaDark;
@@ -3924,6 +3948,10 @@ function themeToFigma(r, input) {
     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));
+    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.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

@@ -2666,6 +2666,7 @@ var SCALE = {
 };
 var ABS = { req: "extreme poles for CTAs, aliased global endpoints" };
 var OFFSET = { req: "min APCA visibility", theming: "offsets CTAs in themes where they sit close to the page" };
+var OFFSET_INVERSE = { req: "state layers over inverted backgrounds", theming: "the offset ladder with its pole flipped, so inverted grounds keep the same rungs" };
 var SHADOW = { req: "drop shadows" };
 var PLANE = (req) => ({ req, theming: "aliased to the gray ramp" });
 var LINK = (state, contrast) => ({
@@ -2696,6 +2697,12 @@ var SYSTEM = {
   "system/alpha/006": OFFSET,
   "system/alpha/008": OFFSET,
   "system/alpha/016": 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/shadow-04": SHADOW,
   "system/alpha/shadow-08": SHADOW,
   "system/alpha/shadow-12": SHADOW,
@@ -3348,6 +3355,16 @@ var SYSTEM_LEAF = {
     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"
@@ -3410,11 +3427,17 @@ var SHADOW_ALPHAS = {
   12: { light: 0.12, dark: 0.64 }
 };
 var SCRIM_ALPHA = 0.6;
+var DISABLED_OPACITY = 0.38;
 var TRANSPARENT_VAR = "--alpha-transparent";
 var offsetRgba = (rung, mode) => mode === "light" ? `rgba(0, 0, 0, ${OFFSET_ALPHAS[rung]})` : `rgba(255, 255, 255, ${OFFSET_ALPHAS[rung]})`;
 var alphaRootVars = (mode) => [
   `  ${TRANSPARENT_VAR}: transparent;`,
-  ...Object.keys(OFFSET_ALPHAS).map(Number).sort((a, b) => a - b).map((r) => `  ${offsetVarName(r)}: ${offsetRgba(r, mode)};`)
+  ...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")};`)
 ];
 function ctaPageLc(s, mode, page) {
   const cta = mode === "light" ? s.cta : s.ctaDark;
@@ -3846,6 +3869,10 @@ function themeToFigma(r, input) {
     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));
+    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.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]));
@@ -3919,6 +3946,7 @@ function resolveDtcgRamp(group) {
 export {
   CSS_FAMILY,
   DEFAULT_LINK_HEX,
+  DISABLED_OPACITY,
   EXT_KEY,
   INK_0,
   MODE_SPECS,

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

@@ -33,6 +33,7 @@ export declare const SHADOW_ALPHAS: {
 };
 export type ShadowRung = keyof typeof SHADOW_ALPHAS;
 export declare const SCRIM_ALPHA = 0.6;
+export declare const DISABLED_OPACITY = 0.38;
 export declare const TRANSPARENT_VAR = "--alpha-transparent";
 export declare const offsetRgba: (rung: OffsetRung, mode: "light" | "dark") => string;
 export declare const alphaRootVars: (mode: "light" | "dark") => string[];

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

@@ -31,6 +31,9 @@ export declare const SYSTEM_LEAF: {
         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 SHADOW_04: "system/alpha/shadow-04";
         readonly SHADOW_08: "system/alpha/shadow-08";
         readonly SHADOW_12: "system/alpha/shadow-12";

package/dist-lib/types/index.d.ts

@@ -1,6 +1,6 @@
 export { generateScale, generateNeutralScale, generateSubtleSecondary, type GeneratedScale, type ColorStop, type GenerateOptions, type NeutralLevel, type ContrastProfile, } from './engine/colorEngine';
 export { resolveBrand, resolveTheme, resolveLinkTrio, resolveLinkInverseTrio, DEFAULT_LINK_HEX, SIGNAL_SCALES, signalScalesFor, SECONDARY_DISTINCT_DELTA_E, SUBTLE_TINT_MULT, SUBTLE_PASTEL_K, OUTLINE_HOVER_ALPHA, type ResolvedBrand, type ResolvedTheme, type ResolvedSecondary, type SecondaryLevel, type SecondaryStyle, type SignalOverride, } from './engine/resolve';
-export { brandCss, neutralCss, signalsCss, stopsToVars, toHex, stopHex, OFFSET_ALPHAS, SHADOW_ALPHAS, SCRIM_ALPHA, type ShadowRung, ctaNeedsBorder, ctaBorderRung, pageStopFor, } from './engine/cssRender';
+export { brandCss, neutralCss, signalsCss, stopsToVars, toHex, stopHex, OFFSET_ALPHAS, SHADOW_ALPHAS, SCRIM_ALPHA, DISABLED_OPACITY, type ShadowRung, ctaNeedsBorder, ctaBorderRung, pageStopFor, } from './engine/cssRender';
 export { CSS_FAMILY } from './engine/tokenDescriptions';
 export { themeToFigma, type FigmaGroup, type FigmaColorToken, type ThemeInput, } from './engine/figmaRender';
 export { emitDtcgRamp, resolveDtcgRamp, parseToken, EXT_KEY, RESOLVER_ID, type DtcgRampGroup, type DtcgRequirementToken, type DtcgSeedToken, type DtcgColorValue, } from './engine/requirements/dtcg';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "okchroma",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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

@@ -43,6 +43,11 @@
   --shadow-04: rgba(0, 0, 0, 0.04);
   --shadow-08: rgba(0, 0, 0, 0.08);
   --shadow-12: rgba(0, 0, 0, 0.12);
+
+  /* Disabled opacity (owner 2026-08-29): disabled is a COMPONENT-LEVEL opacity —
+     colors stay the enabled ones and never swap. Mode-invariant; mirrors the JS
+     API's DISABLED_OPACITY constant 1:1. */
+  --disabled-opacity: 0.38;
 }
 
 [data-brand][data-theme="dark"] {