@principal-ade/industry-theme 0.1.20 → 0.1.22

package/dist/cjs/ContrastReport.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { Theme } from './index';
+export interface ContrastReportProps {
+    /** A single theme to audit. */
+    theme?: Theme;
+    /** Multiple named themes to audit side by side. */
+    themes?: {
+        name: string;
+        theme: Theme;
+    }[];
+    title?: string;
+}
+/**
+ * Renders a WCAG contrast audit for one or more themes — a deterministic,
+ * exhaustive view of every declared foreground/background pairing with its
+ * ratio and AA/AAA grade. Complements `@storybook/addon-a11y`, which only
+ * checks contrast on actually-rendered text.
+ */
+export declare const ContrastReport: React.FC<ContrastReportProps>;
+//# sourceMappingURL=ContrastReport.d.ts.map

package/dist/cjs/ContrastReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContrastReport.d.ts","sourceRoot":"","sources":["../../src/ContrastReport.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,mDAAmD;IACnD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgLD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+BxD,CAAC"}

package/dist/cjs/contrast.d.ts

@@ -0,0 +1,75 @@
+/**
+ * WCAG 2.x contrast evaluation for themes.
+ *
+ * Implements the relative-luminance / contrast-ratio formulas from
+ * https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio and provides a
+ * declarative audit of the meaningful foreground/background pairings in a
+ * {@link Theme}. This is the deterministic, exhaustive counterpart to the
+ * axe-core checks surfaced by `@storybook/addon-a11y`: axe only inspects text
+ * that is actually rendered, whereas this audits every declared color role.
+ */
+import { Theme } from './index';
+/** WCAG 2.x contrast thresholds. */
+export declare const WCAG_THRESHOLDS: {
+    /** Normal-size text (< 18pt, or < 14pt bold). */
+    readonly text: {
+        readonly AA: 4.5;
+        readonly AAA: 7;
+    };
+    /** Large text (>= 18pt, or >= 14pt bold). */
+    readonly large: {
+        readonly AA: 3;
+        readonly AAA: 4.5;
+    };
+    /** Non-text UI components & graphical objects (borders, icons, focus rings). */
+    readonly ui: {
+        readonly AA: 3;
+        readonly AAA: 3;
+    };
+};
+export type ContrastUse = keyof typeof WCAG_THRESHOLDS;
+export type ContrastLevel = 'AAA' | 'AA' | 'fail';
+/** Parse a CSS color string into an [r, g, b] triple in the 0–255 range. */
+export declare function parseColor(input: string): [number, number, number] | null;
+/** Relative luminance per WCAG, from an [r, g, b] triple (0–255). */
+export declare function relativeLuminance([r, g, b]: [number, number, number]): number;
+/**
+ * WCAG contrast ratio between two colors (1–21). Returns `null` if either
+ * color cannot be parsed.
+ */
+export declare function contrastRatio(fg: string, bg: string): number | null;
+/** Classify a ratio against the thresholds for a given use. */
+export declare function gradeContrast(ratio: number, use: ContrastUse): ContrastLevel;
+type ColorKey = keyof Theme['colors'];
+/** A foreground/background pairing to audit. */
+export interface ContrastPair {
+    label: string;
+    fg: ColorKey;
+    bg: ColorKey;
+    use: ContrastUse;
+}
+/**
+ * The meaningful color pairings every theme should satisfy. Text-on-surface
+ * pairs require AA 4.5:1; borders/graphical roles require AA 3:1.
+ */
+export declare const CONTRAST_PAIRS: ContrastPair[];
+export interface ContrastResult {
+    pair: ContrastPair;
+    fgColor: string;
+    bgColor: string;
+    ratio: number | null;
+    /** Threshold required for AA at this pair's use. */
+    required: number;
+    level: ContrastLevel;
+}
+export interface ThemeContrastReport {
+    results: ContrastResult[];
+    /** Pairs that fail AA. */
+    failures: ContrastResult[];
+    /** True when every parseable pair clears AA. */
+    passesAA: boolean;
+}
+/** Run the full contrast audit for a single theme. */
+export declare function evaluateThemeContrast(theme: Theme): ThemeContrastReport;
+export {};
+//# sourceMappingURL=contrast.d.ts.map

package/dist/cjs/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oCAAoC;AACpC,eAAO,MAAM,eAAe;IAC1B,iDAAiD;;;;;IAEjD,6CAA6C;;;;;IAE7C,gFAAgF;;;;;CAExE,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,eAAe,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAElD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAuCzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASnE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,CAK5E;AAED,KAAK,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;AAEtC,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAwBxC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB,CAYvE"}

package/dist/cjs/index.d.ts

@@ -131,5 +131,9 @@ export { getColor, getSpace, getFontSize, getRadius, getShadow, getZIndex, respo
 export { overrideColors, makeTheme, addMode, getMode } from './themeHelpers';
 export { ThemeShowcase } from './ThemeShowcase';
 export type { ThemeShowcaseProps } from './ThemeShowcase';
+export { WCAG_THRESHOLDS, CONTRAST_PAIRS, parseColor, relativeLuminance, contrastRatio, gradeContrast, evaluateThemeContrast, } from './contrast';
+export type { ContrastUse, ContrastLevel, ContrastPair, ContrastResult, ThemeContrastReport, } from './contrast';
+export { ContrastReport } from './ContrastReport';
+export type { ContrastReportProps } from './ContrastReport';
 export default theme;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.js

@@ -53,7 +53,9 @@ __export(exports_src, {
   scaleThemeFonts: () => scaleThemeFonts,
   responsive: () => responsive,
   resetFontScale: () => resetFontScale,
+  relativeLuminance: () => relativeLuminance,
   regalTheme: () => regalTheme,
+  parseColor: () => parseColor,
   overrideColors: () => overrideColors,
   neuralPulseTheme: () => neuralPulseTheme,
   mergeThemes: () => mergeThemes,
@@ -66,6 +68,7 @@ __export(exports_src, {
   iceTangerineTheme: () => iceTangerineTheme,
   iceTangerineDarkTheme: () => iceTangerineDarkTheme,
   humanCentricTheme: () => humanCentricTheme,
+  gradeContrast: () => gradeContrast,
   getZIndex: () => getZIndex,
   getSpace: () => getSpace,
   getShadow: () => getShadow,
@@ -73,6 +76,7 @@ __export(exports_src, {
   getMode: () => getMode,
   getFontSize: () => getFontSize,
   getColor: () => getColor,
+  evaluateThemeContrast: () => evaluateThemeContrast,
   enterpriseTheme: () => enterpriseTheme,
   defaultTerminalTheme: () => defaultTerminalTheme,
   defaultMarkdownTheme: () => defaultMarkdownTheme,
@@ -80,9 +84,13 @@ __export(exports_src, {
   default: () => src_default,
   decreaseFontScale: () => decreaseFontScale,
   createStyle: () => createStyle,
+  contrastRatio: () => contrastRatio,
   addMode: () => addMode,
+  WCAG_THRESHOLDS: () => WCAG_THRESHOLDS,
   ThemeShowcase: () => ThemeShowcase,
-  ThemeProvider: () => ThemeProvider
+  ThemeProvider: () => ThemeProvider,
+  ContrastReport: () => ContrastReport,
+  CONTRAST_PAIRS: () => CONTRAST_PAIRS
 });
 module.exports = __toCommonJS(exports_src);
 
@@ -1719,7 +1727,7 @@ var slateNeonTheme = {
   colors: {
     text: "#d0d6e0",
     background: "#1a1c1e",
-    primary: "#ff6b35",
+    primary: "#F36F41",
     secondary: "#ff8257",
     accent: "#00ff00",
     highlight: "#2a1f18",
@@ -1738,8 +1746,8 @@ var slateNeonTheme = {
     textTertiary: "#6b7280",
     textMuted: "#4b5563",
     highlightBg: "#2a1f18",
-    highlightBorder: "#ff6b35",
-    textOnPrimary: "#ffffff",
+    highlightBorder: "#F36F41",
+    textOnPrimary: "#1a1c1e",
     textOnSecondary: "#ffffff",
     textOnAccent: "#1a1c1e"
   },
@@ -1960,7 +1968,7 @@ var iceTangerineDarkTheme = {
   zIndices: [0, 1, 10, 20, 30, 40, 50],
   colors: {
     text: "#d0e5ea",
-    background: "#0d274d",
+    background: "#0a1829",
     primary: "#ff6b35",
     secondary: "#ff8257",
     accent: "#0893d2",
@@ -1970,26 +1978,26 @@ var iceTangerineDarkTheme = {
     warning: "#f59e0b",
     error: "#ef4444",
     info: "#0893d2",
-    border: "#1e3a5f",
+    border: "#5a82aa",
     backgroundSecondary: "#0f2e58",
     backgroundTertiary: "#123461",
     backgroundLight: "#0b1f3f",
-    backgroundDark: "#0a1829",
+    backgroundDark: "#040b15",
     backgroundHover: "#2a1f18",
     primaryBlade: "#0e2b53",
     surface: "#0f2e58",
     textSecondary: "#9fc4d4",
     textTertiary: "#7ba8bc",
-    textMuted: "#5a8a9e",
+    textMuted: "#73a0b3",
     highlightBg: "#2a1f18",
     highlightBorder: "#ff6b35",
-    textOnPrimary: "#ffffff",
-    textOnSecondary: "#ffffff",
-    textOnAccent: "#ffffff"
+    textOnPrimary: "#0d274d",
+    textOnSecondary: "#0d274d",
+    textOnAccent: "#0a1829"
   },
   buttons: {
     primary: {
-      color: "#ffffff",
+      color: "#0d274d",
       bg: "primary",
       borderWidth: 0,
       "&:hover": {
@@ -2893,6 +2901,272 @@ var ThemeShowcase = ({
     }
   }, modeName)))));
 };
+// src/contrast.ts
+var WCAG_THRESHOLDS = {
+  text: { AA: 4.5, AAA: 7 },
+  large: { AA: 3, AAA: 4.5 },
+  ui: { AA: 3, AAA: 3 }
+};
+function parseColor(input) {
+  if (!input)
+    return null;
+  const color = input.trim().toLowerCase();
+  if (color.startsWith("#")) {
+    let hex = color.slice(1);
+    if (hex.length === 3 || hex.length === 4) {
+      hex = hex.split("").map((c) => c + c).join("");
+    }
+    if (hex.length === 6 || hex.length === 8) {
+      const r = parseInt(hex.slice(0, 2), 16);
+      const g = parseInt(hex.slice(2, 4), 16);
+      const b = parseInt(hex.slice(4, 6), 16);
+      if ([r, g, b].some((n) => Number.isNaN(n)))
+        return null;
+      return [r, g, b];
+    }
+    return null;
+  }
+  const rgbMatch = color.match(/^rgba?\(([^)]+)\)$/);
+  if (rgbMatch) {
+    const parts = rgbMatch[1].split(/[,/\s]+/).filter(Boolean).slice(0, 3);
+    if (parts.length < 3)
+      return null;
+    const channels = parts.map((p) => p.endsWith("%") ? Math.round(parseFloat(p) / 100 * 255) : parseFloat(p));
+    if (channels.some((n) => Number.isNaN(n)))
+      return null;
+    return [channels[0], channels[1], channels[2]];
+  }
+  return null;
+}
+function relativeLuminance([r, g, b]) {
+  const toLinear = (c) => {
+    const s = c / 255;
+    return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+  };
+  return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
+}
+function contrastRatio(fg, bg) {
+  const a = parseColor(fg);
+  const b = parseColor(bg);
+  if (!a || !b)
+    return null;
+  const l1 = relativeLuminance(a);
+  const l2 = relativeLuminance(b);
+  const lighter = Math.max(l1, l2);
+  const darker = Math.min(l1, l2);
+  return (lighter + 0.05) / (darker + 0.05);
+}
+function gradeContrast(ratio, use) {
+  const t = WCAG_THRESHOLDS[use];
+  if (ratio >= t.AAA)
+    return "AAA";
+  if (ratio >= t.AA)
+    return "AA";
+  return "fail";
+}
+var CONTRAST_PAIRS = [
+  { label: "text on background", fg: "text", bg: "background", use: "text" },
+  { label: "text on surface", fg: "text", bg: "surface", use: "text" },
+  { label: "text on backgroundSecondary", fg: "text", bg: "backgroundSecondary", use: "text" },
+  { label: "textSecondary on background", fg: "textSecondary", bg: "background", use: "text" },
+  { label: "textTertiary on background", fg: "textTertiary", bg: "background", use: "text" },
+  { label: "textMuted on background", fg: "textMuted", bg: "background", use: "text" },
+  { label: "textOnPrimary on primary", fg: "textOnPrimary", bg: "primary", use: "text" },
+  { label: "textOnSecondary on secondary", fg: "textOnSecondary", bg: "secondary", use: "text" },
+  { label: "textOnAccent on accent", fg: "textOnAccent", bg: "accent", use: "text" },
+  { label: "primary on background", fg: "primary", bg: "background", use: "large" },
+  { label: "success on background", fg: "success", bg: "background", use: "ui" },
+  { label: "warning on background", fg: "warning", bg: "background", use: "ui" },
+  { label: "error on background", fg: "error", bg: "background", use: "ui" },
+  { label: "info on background", fg: "info", bg: "background", use: "ui" },
+  { label: "border on background", fg: "border", bg: "background", use: "ui" },
+  { label: "border on surface", fg: "border", bg: "surface", use: "ui" }
+];
+function evaluateThemeContrast(theme2) {
+  const results = CONTRAST_PAIRS.map((pair) => {
+    const fgColor = theme2.colors[pair.fg] ?? "";
+    const bgColor = theme2.colors[pair.bg] ?? "";
+    const ratio = contrastRatio(fgColor, bgColor);
+    const required = WCAG_THRESHOLDS[pair.use].AA;
+    const level = ratio === null ? "fail" : gradeContrast(ratio, pair.use);
+    return { pair, fgColor, bgColor, ratio, required, level };
+  });
+  const failures = results.filter((r) => r.level === "fail");
+  return { results, failures, passesAA: failures.length === 0 };
+}
+// src/ContrastReport.tsx
+var import_react3 = __toESM(require("react"));
+var LEVEL_STYLE = {
+  AAA: { bg: "#0f7b3f", fg: "#ffffff", label: "AAA" },
+  AA: { bg: "#1f6feb", fg: "#ffffff", label: "AA" },
+  fail: { bg: "#cf222e", fg: "#ffffff", label: "FAIL" }
+};
+var ui = {
+  fontFamily: "ui-sans-serif, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif",
+  text: "#1c2128",
+  subtle: "#57606a",
+  border: "#d0d7de",
+  surface: "#ffffff",
+  panel: "#f6f8fa"
+};
+var Badge = ({ level }) => {
+  const s = LEVEL_STYLE[level];
+  return /* @__PURE__ */ import_react3.default.createElement("span", {
+    style: {
+      display: "inline-block",
+      minWidth: 44,
+      textAlign: "center",
+      padding: "2px 8px",
+      borderRadius: 999,
+      fontSize: 11,
+      fontWeight: 700,
+      letterSpacing: 0.4,
+      backgroundColor: s.bg,
+      color: s.fg
+    }
+  }, s.label);
+};
+var Swatch = ({ fg, bg }) => /* @__PURE__ */ import_react3.default.createElement("span", {
+  title: `${fg} on ${bg}`,
+  style: {
+    display: "inline-flex",
+    alignItems: "center",
+    justifyContent: "center",
+    width: 40,
+    height: 24,
+    borderRadius: 4,
+    border: `1px solid ${ui.border}`,
+    backgroundColor: bg,
+    color: fg,
+    fontSize: 13,
+    fontWeight: 700
+  }
+}, "Aa");
+var Row = ({ r }) => {
+  const failed = r.level === "fail";
+  return /* @__PURE__ */ import_react3.default.createElement("tr", {
+    style: { backgroundColor: failed ? "#fff5f5" : "transparent" }
+  }, /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: cell
+  }, /* @__PURE__ */ import_react3.default.createElement(Swatch, {
+    fg: r.fgColor,
+    bg: r.bgColor
+  })), /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: { ...cell, fontWeight: 500 }
+  }, r.pair.label, /* @__PURE__ */ import_react3.default.createElement("div", {
+    style: { fontSize: 11, color: ui.subtle, fontFamily: "monospace" }
+  }, r.fgColor, " / ", r.bgColor)), /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: { ...cell, textAlign: "right", fontVariantNumeric: "tabular-nums" }
+  }, /* @__PURE__ */ import_react3.default.createElement("span", {
+    style: { fontWeight: 700, color: failed ? "#cf222e" : ui.text }
+  }, r.ratio === null ? "—" : `${r.ratio.toFixed(2)}:1`)), /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: {
+      ...cell,
+      textAlign: "right",
+      color: ui.subtle,
+      fontVariantNumeric: "tabular-nums"
+    }
+  }, r.required, ":1"), /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: { ...cell, textAlign: "center", textTransform: "capitalize", color: ui.subtle }
+  }, r.pair.use), /* @__PURE__ */ import_react3.default.createElement("td", {
+    style: { ...cell, textAlign: "center" }
+  }, /* @__PURE__ */ import_react3.default.createElement(Badge, {
+    level: r.level
+  })));
+};
+var cell = {
+  padding: "8px 12px",
+  borderBottom: `1px solid ${ui.border}`,
+  fontSize: 13,
+  verticalAlign: "middle"
+};
+var headCell = {
+  padding: "8px 12px",
+  textAlign: "left",
+  fontSize: 11,
+  fontWeight: 700,
+  textTransform: "uppercase",
+  letterSpacing: 0.5,
+  color: ui.subtle,
+  borderBottom: `2px solid ${ui.border}`
+};
+var ThemeTable = ({ name, theme: theme2 }) => {
+  const report = evaluateThemeContrast(theme2);
+  const fails = report.failures.length;
+  return /* @__PURE__ */ import_react3.default.createElement("section", {
+    style: {
+      marginBottom: 28,
+      border: `1px solid ${ui.border}`,
+      borderRadius: 8,
+      overflow: "hidden",
+      backgroundColor: ui.surface
+    }
+  }, /* @__PURE__ */ import_react3.default.createElement("header", {
+    style: {
+      display: "flex",
+      alignItems: "center",
+      justifyContent: "space-between",
+      gap: 12,
+      padding: "12px 16px",
+      backgroundColor: ui.panel,
+      borderBottom: `1px solid ${ui.border}`
+    }
+  }, /* @__PURE__ */ import_react3.default.createElement("h3", {
+    style: { margin: 0, fontSize: 16, color: ui.text }
+  }, name), /* @__PURE__ */ import_react3.default.createElement("span", {
+    style: {
+      fontSize: 12,
+      fontWeight: 700,
+      padding: "4px 10px",
+      borderRadius: 999,
+      backgroundColor: report.passesAA ? "#dafbe1" : "#ffebe9",
+      color: report.passesAA ? "#0f7b3f" : "#cf222e"
+    }
+  }, report.passesAA ? "✓ Passes AA" : `${fails} AA failure${fails === 1 ? "" : "s"}`)), /* @__PURE__ */ import_react3.default.createElement("table", {
+    style: { width: "100%", borderCollapse: "collapse" }
+  }, /* @__PURE__ */ import_react3.default.createElement("thead", null, /* @__PURE__ */ import_react3.default.createElement("tr", null, /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: headCell
+  }, "Sample"), /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: headCell
+  }, "Pair"), /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: { ...headCell, textAlign: "right" }
+  }, "Ratio"), /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: { ...headCell, textAlign: "right" }
+  }, "Req. (AA)"), /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: { ...headCell, textAlign: "center" }
+  }, "Use"), /* @__PURE__ */ import_react3.default.createElement("th", {
+    style: { ...headCell, textAlign: "center" }
+  }, "Grade"))), /* @__PURE__ */ import_react3.default.createElement("tbody", null, report.results.map((r, i) => /* @__PURE__ */ import_react3.default.createElement(Row, {
+    key: i,
+    r
+  })))));
+};
+var ContrastReport = ({
+  theme: theme2,
+  themes,
+  title = "WCAG Contrast Report"
+}) => {
+  const list = themes ?? (theme2 ? [{ name: title, theme: theme2 }] : []);
+  return /* @__PURE__ */ import_react3.default.createElement("div", {
+    style: {
+      fontFamily: ui.fontFamily,
+      color: ui.text,
+      backgroundColor: ui.panel,
+      padding: 24,
+      minHeight: "100vh"
+    }
+  }, /* @__PURE__ */ import_react3.default.createElement("header", {
+    style: { marginBottom: 20 }
+  }, /* @__PURE__ */ import_react3.default.createElement("h1", {
+    style: { margin: "0 0 6px", fontSize: 22 }
+  }, title), /* @__PURE__ */ import_react3.default.createElement("p", {
+    style: { margin: 0, fontSize: 13, color: ui.subtle, maxWidth: 720 }
+  }, "WCAG 2.x contrast ratios for each theme's declared color roles. Text pairs require AA", " ", WCAG_THRESHOLDS.text.AA, ":1 (AAA ", WCAG_THRESHOLDS.text.AAA, ":1); large text requires", " ", WCAG_THRESHOLDS.large.AA, ":1; borders and other non-text UI require", " ", WCAG_THRESHOLDS.ui.AA, ":1.")), list.map((t) => /* @__PURE__ */ import_react3.default.createElement(ThemeTable, {
+    key: t.name,
+    name: t.name,
+    theme: t.theme
+  })));
+};
 
 // src/index.ts
 var theme = terminalTheme;

package/dist/esm/ContrastReport.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { Theme } from './index';
+export interface ContrastReportProps {
+    /** A single theme to audit. */
+    theme?: Theme;
+    /** Multiple named themes to audit side by side. */
+    themes?: {
+        name: string;
+        theme: Theme;
+    }[];
+    title?: string;
+}
+/**
+ * Renders a WCAG contrast audit for one or more themes — a deterministic,
+ * exhaustive view of every declared foreground/background pairing with its
+ * ratio and AA/AAA grade. Complements `@storybook/addon-a11y`, which only
+ * checks contrast on actually-rendered text.
+ */
+export declare const ContrastReport: React.FC<ContrastReportProps>;
+//# sourceMappingURL=ContrastReport.d.ts.map

package/dist/esm/ContrastReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContrastReport.d.ts","sourceRoot":"","sources":["../../src/ContrastReport.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,+BAA+B;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,mDAAmD;IACnD,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgLD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA+BxD,CAAC"}

package/dist/esm/contrast.d.ts

@@ -0,0 +1,75 @@
+/**
+ * WCAG 2.x contrast evaluation for themes.
+ *
+ * Implements the relative-luminance / contrast-ratio formulas from
+ * https://www.w3.org/TR/WCAG21/#dfn-contrast-ratio and provides a
+ * declarative audit of the meaningful foreground/background pairings in a
+ * {@link Theme}. This is the deterministic, exhaustive counterpart to the
+ * axe-core checks surfaced by `@storybook/addon-a11y`: axe only inspects text
+ * that is actually rendered, whereas this audits every declared color role.
+ */
+import { Theme } from './index';
+/** WCAG 2.x contrast thresholds. */
+export declare const WCAG_THRESHOLDS: {
+    /** Normal-size text (< 18pt, or < 14pt bold). */
+    readonly text: {
+        readonly AA: 4.5;
+        readonly AAA: 7;
+    };
+    /** Large text (>= 18pt, or >= 14pt bold). */
+    readonly large: {
+        readonly AA: 3;
+        readonly AAA: 4.5;
+    };
+    /** Non-text UI components & graphical objects (borders, icons, focus rings). */
+    readonly ui: {
+        readonly AA: 3;
+        readonly AAA: 3;
+    };
+};
+export type ContrastUse = keyof typeof WCAG_THRESHOLDS;
+export type ContrastLevel = 'AAA' | 'AA' | 'fail';
+/** Parse a CSS color string into an [r, g, b] triple in the 0–255 range. */
+export declare function parseColor(input: string): [number, number, number] | null;
+/** Relative luminance per WCAG, from an [r, g, b] triple (0–255). */
+export declare function relativeLuminance([r, g, b]: [number, number, number]): number;
+/**
+ * WCAG contrast ratio between two colors (1–21). Returns `null` if either
+ * color cannot be parsed.
+ */
+export declare function contrastRatio(fg: string, bg: string): number | null;
+/** Classify a ratio against the thresholds for a given use. */
+export declare function gradeContrast(ratio: number, use: ContrastUse): ContrastLevel;
+type ColorKey = keyof Theme['colors'];
+/** A foreground/background pairing to audit. */
+export interface ContrastPair {
+    label: string;
+    fg: ColorKey;
+    bg: ColorKey;
+    use: ContrastUse;
+}
+/**
+ * The meaningful color pairings every theme should satisfy. Text-on-surface
+ * pairs require AA 4.5:1; borders/graphical roles require AA 3:1.
+ */
+export declare const CONTRAST_PAIRS: ContrastPair[];
+export interface ContrastResult {
+    pair: ContrastPair;
+    fgColor: string;
+    bgColor: string;
+    ratio: number | null;
+    /** Threshold required for AA at this pair's use. */
+    required: number;
+    level: ContrastLevel;
+}
+export interface ThemeContrastReport {
+    results: ContrastResult[];
+    /** Pairs that fail AA. */
+    failures: ContrastResult[];
+    /** True when every parseable pair clears AA. */
+    passesAA: boolean;
+}
+/** Run the full contrast audit for a single theme. */
+export declare function evaluateThemeContrast(theme: Theme): ThemeContrastReport;
+export {};
+//# sourceMappingURL=contrast.d.ts.map

package/dist/esm/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../src/contrast.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,oCAAoC;AACpC,eAAO,MAAM,eAAe;IAC1B,iDAAiD;;;;;IAEjD,6CAA6C;;;;;IAE7C,gFAAgF;;;;;CAExE,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,eAAe,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAElD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAuCzE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAM7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASnE;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,aAAa,CAK5E;AAED,KAAK,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;AAEtC,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,QAAQ,CAAC;IACb,EAAE,EAAE,QAAQ,CAAC;IACb,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAwBxC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,mBAAmB,CAYvE"}

package/dist/esm/index.d.ts

@@ -131,5 +131,9 @@ export { getColor, getSpace, getFontSize, getRadius, getShadow, getZIndex, respo
 export { overrideColors, makeTheme, addMode, getMode } from './themeHelpers';
 export { ThemeShowcase } from './ThemeShowcase';
 export type { ThemeShowcaseProps } from './ThemeShowcase';
+export { WCAG_THRESHOLDS, CONTRAST_PAIRS, parseColor, relativeLuminance, contrastRatio, gradeContrast, evaluateThemeContrast, } from './contrast';
+export type { ContrastUse, ContrastLevel, ContrastPair, ContrastResult, ThemeContrastReport, } from './contrast';
+export { ContrastReport } from './ContrastReport';
+export type { ContrastReportProps } from './ContrastReport';
 export default theme;
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,KAAK,aAAa,GAAG;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,WAAW,KAAK;IAEpB,KAAK,CAAC,EAAE;QACN,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC9C,CAAC;IAGF,KAAK,EAAE,MAAM,EAAE,CAAC;IAGhB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAEF,SAAS,EAAE,MAAM,EAAE,CAAC;IAGpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAGF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAGnB,MAAM,EAAE;QAEN,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QAGd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QAGb,MAAM,EAAE,MAAM,CAAC;QACf,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAGlB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;QAGzB,aAAa,EAAE,MAAM,CAAC;QAEtB,eAAe,EAAE,MAAM,CAAC;QAExB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IAGF,OAAO,EAAE;QACP,OAAO,EAAE,aAAa,CAAC;QACvB,SAAS,EAAE,aAAa,CAAC;QACzB,KAAK,EAAE,aAAa,CAAC;KACtB,CAAC;IAEF,IAAI,EAAE;QACJ,OAAO,EAAE,WAAW,CAAC;QACrB,IAAI,EAAE,WAAW,CAAC;QAClB,OAAO,EAAE,WAAW,CAAC;KACtB,CAAC;IAEF,KAAK,EAAE;QACL,OAAO,EAAE,WAAW,CAAC;QACrB,SAAS,EAAE,WAAW,CAAC;KACxB,CAAC;CACH;AAGD,eAAO,MAAM,KAAK,EAAE,KAAqB,CAAC;AAG1C,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAWlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAIrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAIrD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAElD;AAGD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,EAAE,EACF,WAAW,EACX,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG7E,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,eAAe,KAAK,CAAC"}