okchroma 0.1.1 → 0.1.2

package/dist-lib/index.cjs

@@ -30,7 +30,9 @@ __export(index_exports, {
   PAPER_100: () => PAPER_100,
   RESOLVER_ID: () => RESOLVER_ID,
   SCALE_STOP_COUNT: () => SCALE_STOP_COUNT,
+  SCRIM_ALPHA: () => SCRIM_ALPHA,
   SECONDARY_DISTINCT_DELTA_E: () => SECONDARY_DISTINCT_DELTA_E,
+  SHADOW_ALPHAS: () => SHADOW_ALPHAS,
   SIGNALS: () => SIGNALS2,
   SIGNAL_EMIT_NAME: () => SIGNAL_EMIT_NAME,
   SIGNAL_SCALES: () => SIGNAL_SCALES,
@@ -42,6 +44,8 @@ __export(index_exports, {
   STAMP_STATE_LEAVES: () => STAMP_STATE_LEAVES,
   SUBTLE_PASTEL_K: () => SUBTLE_PASTEL_K,
   SUBTLE_TINT_MULT: () => SUBTLE_TINT_MULT,
+  SURFACE_PLANE_LAW: () => SURFACE_PLANE_LAW,
+  SYSTEM_LEAF: () => SYSTEM_LEAF,
   brandCss: () => brandCss,
   checkAllCollisions: () => checkAllCollisions,
   checkCollision: () => checkCollision,
@@ -3406,6 +3410,33 @@ var STAMP_LEAF = {
   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",
+    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,
@@ -3451,6 +3482,12 @@ 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 SHADOW_ALPHAS = {
+  4: { light: 0.04, dark: 0.32 },
+  8: { light: 0.08, dark: 0.48 },
+  12: { light: 0.12, dark: 0.64 }
+};
+var SCRIM_ALPHA = 0.6;
 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) => [
@@ -3868,6 +3905,28 @@ function themeToFigma(r, input) {
         ctaFamily(sig.scale, mode, sig.name)
       );
     }
+    const pole = (white, alpha) => {
+      const c = white ? 1 : 0;
+      return {
+        $type: "color",
+        $value: { colorSpace: "srgb", components: [c, c, c], alpha, hex: white ? "#ffffff" : "#000000" }
+      };
+    };
+    putLeaf(g2, SYSTEM_LEAF.ABS_BLACK, colorFromHex(false));
+    putLeaf(g2, SYSTEM_LEAF.ABS_WHITE, colorFromHex(true));
+    for (const [path, law] of Object.entries(SURFACE_PLANE_LAW)) {
+      const tok = neutralGroup[law[mode]];
+      if (tok && "$type" in tok) putLeaf(g2, path, tok);
+    }
+    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.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]));
     return g2;
   };
   return { light: build("light"), dark: build("dark") };

package/dist-lib/index.mjs

@@ -3332,6 +3332,33 @@ var STAMP_LEAF = {
   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",
+    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,
@@ -3377,6 +3404,12 @@ 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 SHADOW_ALPHAS = {
+  4: { light: 0.04, dark: 0.32 },
+  8: { light: 0.08, dark: 0.48 },
+  12: { light: 0.12, dark: 0.64 }
+};
+var SCRIM_ALPHA = 0.6;
 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) => [
@@ -3794,6 +3827,28 @@ function themeToFigma(r, input) {
         ctaFamily(sig.scale, mode, sig.name)
       );
     }
+    const pole = (white, alpha) => {
+      const c = white ? 1 : 0;
+      return {
+        $type: "color",
+        $value: { colorSpace: "srgb", components: [c, c, c], alpha, hex: white ? "#ffffff" : "#000000" }
+      };
+    };
+    putLeaf(g2, SYSTEM_LEAF.ABS_BLACK, colorFromHex(false));
+    putLeaf(g2, SYSTEM_LEAF.ABS_WHITE, colorFromHex(true));
+    for (const [path, law] of Object.entries(SURFACE_PLANE_LAW)) {
+      const tok = neutralGroup[law[mode]];
+      if (tok && "$type" in tok) putLeaf(g2, path, tok);
+    }
+    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.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]));
     return g2;
   };
   return { light: build("light"), dark: build("dark") };
@@ -3872,7 +3927,9 @@ export {
   PAPER_100,
   RESOLVER_ID,
   SCALE_STOP_COUNT,
+  SCRIM_ALPHA,
   SECONDARY_DISTINCT_DELTA_E,
+  SHADOW_ALPHAS,
   SIGNALS2 as SIGNALS,
   SIGNAL_EMIT_NAME,
   SIGNAL_SCALES,
@@ -3884,6 +3941,8 @@ export {
   STAMP_STATE_LEAVES,
   SUBTLE_PASTEL_K,
   SUBTLE_TINT_MULT,
+  SURFACE_PLANE_LAW,
+  SYSTEM_LEAF,
   brandCss,
   checkAllCollisions,
   checkCollision,

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

@@ -17,6 +17,22 @@ export declare const ctaBorderRung: (prefix: string) => OffsetRung;
 export declare const offsetLeafName: (rung: OffsetRung) => string;
 export declare const offsetVarName: (rung: OffsetRung) => string;
 export declare const offsetTokenPath: (rung: OffsetRung) => string;
+export declare const SHADOW_ALPHAS: {
+    readonly 4: {
+        readonly light: 0.04;
+        readonly dark: 0.32;
+    };
+    readonly 8: {
+        readonly light: 0.08;
+        readonly dark: 0.48;
+    };
+    readonly 12: {
+        readonly light: 0.12;
+        readonly dark: 0.64;
+    };
+};
+export type ShadowRung = keyof typeof SHADOW_ALPHAS;
+export declare const SCRIM_ALPHA = 0.6;
 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

@@ -15,6 +15,31 @@ export declare const STAMP_LEAF: {
     readonly EDGE: string;
     readonly ON: string;
 };
+export declare const SYSTEM_LEAF: {
+    readonly ABS_BLACK: "system/abs-black";
+    readonly ABS_WHITE: "system/abs-white";
+    readonly SURFACE: {
+        readonly DIM: "system/surface/dim";
+        readonly LOW: "system/surface/low";
+        readonly MID: "system/surface/mid";
+        readonly HIGH: "system/surface/high";
+    };
+    readonly ALPHA: {
+        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 SHADOW_04: "system/alpha/shadow-04";
+        readonly SHADOW_08: "system/alpha/shadow-08";
+        readonly SHADOW_12: "system/alpha/shadow-12";
+    };
+};
+export declare const SURFACE_PLANE_LAW: Record<string, {
+    light: string;
+    dark: string;
+}>;
 export declare const CONTRACT_INVARIANT_ROWS: ReadonlySet<string>;
 export declare const EXT_NON_OVERRIDABLE: (p: string) => boolean;
 export declare const EXT_OVERRIDABLE_SYSTEM: (p: string) => boolean;

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

@@ -1,11 +1,11 @@
 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, ctaNeedsBorder, ctaBorderRung, pageStopFor, } from './engine/cssRender';
+export { brandCss, neutralCss, signalsCss, stopsToVars, toHex, stopHex, OFFSET_ALPHAS, SHADOW_ALPHAS, SCRIM_ALPHA, 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';
 export { MODE_SPECS, type ModeSpec } from './engine/requirements/spec';
-export { stopTokenName, tokenOrder, SCALE_STOP_COUNT, PAPER_100, INK_0, STAMP_FILL, STAMP_FILL_HOVER, STAMP_FILL_PRESSED, STAMP_EDGE, STAMP_ON, STAMP_STATE_LEAVES, } from './engine/tokenNames';
+export { stopTokenName, tokenOrder, SCALE_STOP_COUNT, PAPER_100, INK_0, STAMP_FILL, STAMP_FILL_HOVER, STAMP_FILL_PRESSED, STAMP_EDGE, STAMP_ON, STAMP_STATE_LEAVES, SYSTEM_LEAF, SURFACE_PLANE_LAW, } from './engine/tokenNames';
 export { SIGNAL_EMIT_NAME } from './engine/signals';
 export { classifyArchetype, type Archetype } from './engine/archetypes';
 export { SIGNALS, type SignalDef } from './engine/signals';

package/package.json

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