@number10/jsx-core 5.0.0

package/dist/colors/color-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-utils.js","sources":["../../src/colors/color-utils.ts"],"sourcesContent":["/**\n * Color utility functions — renderer-neutral color math.\n * Provides conversion between formats and color manipulation.\n */\n\nimport type { TextStyleToken } from '../design-tokens/design-token-types'\nimport { HexColor, type RGBColor } from './color-types'\n\n/**\n * Convert hex string to Phaser number format\n * @param hex - Hex color string (e.g., '#ffffff' or 'ffffff')\n * @returns Phaser color number (e.g., 0xffffff)\n * @example\n * ```typescript\n * hexToNumber('#ff0000') // returns 0xff0000\n * hexToNumber('00ff00')  // returns 0x00ff00\n * ```\n */\nexport function hexToNumber(hex: string): number {\n  const cleaned = hex.replace('#', '')\n  return parseInt(cleaned, 16)\n}\n\n/**\n * Convert Phaser number format to hex string\n * @param num - Phaser color number (e.g., 0xffffff)\n * @param withHash - Include '#' prefix (default: true)\n * @returns Hex color string (e.g., '#ffffff')\n * @example\n * ```typescript\n * numberToHex(0xff0000)        // returns '#ff0000'\n * numberToHex(0x00ff00, false) // returns '00ff00'\n * ```\n */\nexport function numberToHex(num: number, withHash = true): string {\n  const hex = normalizeColorNumber(num).toString(16).padStart(6, '0')\n  return withHash ? `#${hex}` : hex\n}\n\n/**\n * Normalize a color number to Phaser's 0x000000-0xffffff RGB range.\n * @param color - Color number to normalize\n * @returns RGB color number in the 24-bit range\n */\nexport function normalizeColorNumber(color: number): number {\n  if (!Number.isFinite(color)) return 0x000000\n  return Math.max(0, Math.round(color)) & 0xffffff\n}\n\n/**\n * Normalize a text color value to a CSS-compatible hex string.\n *\n * Handles all common formats users might pass in JSX style.color:\n * - `0xff0000` (number) → `'#ff0000'`\n * - `'0xff0000'` (0x-prefixed string) → `'#ff0000'`\n * - `'0xf00'` (0x short string) → `'#ff0000'`\n * - `'#f00'` (short CSS hex) → `'#ff0000'`\n * - `'#ff0000'` (full CSS hex) → `'#ff0000'` (passthrough)\n * - `'red'`, `'yellow'` (CSS name) → passthrough unchanged\n * - `undefined` → `undefined`\n *\n * Both renderers (Phaser, Pixi) receive the same normalized value,\n * preventing inconsistent color rendering across renderers.\n *\n * @param color - Raw color value from style.color\n * @returns Normalized CSS hex string, CSS name, or undefined\n */\nexport function normalizeTextColor(color: string | number | undefined): string | undefined {\n  if (color === undefined || color === null) return undefined\n\n  // Number: convert to #rrggbb\n  if (typeof color === 'number') {\n    return numberToHex(normalizeColorNumber(color))\n  }\n\n  // String: detect and normalize 0x-prefixed hex strings\n  const trimmed = color.trim()\n  if (trimmed === '') return undefined\n\n  // '0xf00' or '0xff0000' → parse as hex, convert to #rrggbb\n  if (/^0x[0-9a-fA-F]+$/.test(trimmed)) {\n    const num = parseInt(trimmed.slice(2), 16)\n    if (Number.isNaN(num)) return undefined\n    return numberToHex(normalizeColorNumber(num))\n  }\n\n  // '#f00' → '#ff0000' (expand short CSS hex)\n  if (/^#[0-9a-fA-F]{3}$/.test(trimmed)) {\n    const r = trimmed[1]\n    const g = trimmed[2]\n    const b = trimmed[3]\n    return `#${r}${r}${g}${g}${b}${b}`\n  }\n\n  // Already clean '#ff0000' or CSS name like 'red' — passthrough\n  return trimmed\n}\n\n/**\n * Convert RGB values to Phaser number format\n * @param r - Red component (0-255)\n * @param g - Green component (0-255)\n * @param b - Blue component (0-255)\n * @returns Phaser color number\n * @example\n * ```typescript\n * rgbToNumber(255, 0, 0)     // returns 0xff0000 (red)\n * rgbToNumber(0, 255, 0)     // returns 0x00ff00 (green)\n * rgbToNumber(255, 255, 255) // returns 0xffffff (white)\n * ```\n */\nexport function rgbToNumber(r: number, g: number, b: number): number {\n  return ((r & 0xff) << 16) | ((g & 0xff) << 8) | (b & 0xff)\n}\n\n/**\n * Convert Phaser number to RGB components\n * @param num - Phaser color number\n * @returns RGB color object\n * @example\n * ```typescript\n * numberToRgb(0xff0000) // returns { r: 255, g: 0, b: 0 }\n * numberToRgb(0x00ff00) // returns { r: 0, g: 255, b: 0 }\n * ```\n */\nexport function numberToRgb(num: number): RGBColor {\n  const normalized = normalizeColorNumber(num)\n\n  return {\n    r: (normalized >> 16) & 0xff,\n    g: (normalized >> 8) & 0xff,\n    b: normalized & 0xff,\n  }\n}\n\n/**\n * HSL color representation\n */\nexport interface HSLColor {\n  /** Hue in normalized range (0.0 to 1.0) */\n  h: number\n  /** Saturation in normalized range (0.0 to 1.0) */\n  s: number\n  /** Lightness in normalized range (0.0 to 1.0) */\n  l: number\n}\n\n/**\n * Convert RGB values to HSL values (normalized 0.0 to 1.0)\n * @param r - Red component (0-255)\n * @param g - Green component (0-255)\n * @param b - Blue component (0-255)\n * @returns HSL color values with normalized components\n * @example\n * ```typescript\n * rgbToHsl(255, 0, 0) // returns { h: 0, s: 1, l: 0.5 }\n * rgbToHsl(0, 255, 0) // returns { h: 0.333..., s: 1, l: 0.5 }\n * ```\n */\nexport function rgbToHsl(r: number, g: number, b: number): HSLColor {\n  const red = r / 255\n  const green = g / 255\n  const blue = b / 255\n  const max = Math.max(red, green, blue)\n  const min = Math.min(red, green, blue)\n  const delta = max - min\n  const light = (max + min) / 2\n\n  if (delta === 0) {\n    return { h: 0, s: 0, l: light }\n  }\n\n  const saturationValue = light > 0.5 ? delta / (2 - max - min) : delta / (max + min)\n  let hueValue: number\n  if (max === red) {\n    hueValue = (green - blue) / delta + (green < blue ? 6 : 0)\n  } else if (max === green) {\n    hueValue = (blue - red) / delta + 2\n  } else {\n    hueValue = (red - green) / delta + 4\n  }\n  return { h: hueValue / 6, s: saturationValue, l: light }\n}\n\n/**\n * Convert normalized HSL values to RGB components.\n * @param h - Hue in normalized range (0.0 to 1.0)\n * @param s - Saturation in normalized range (0.0 to 1.0)\n * @param l - Lightness in normalized range (0.0 to 1.0)\n * @returns RGB color object\n */\nexport function hslToRgb(h: number, s: number, l: number): RGBColor {\n  const hue = (((Number.isFinite(h) ? h : 0) % 1) + 1) % 1\n  const saturation = Math.max(0, Math.min(1, Number.isFinite(s) ? s : 0))\n  const lightness = Math.max(0, Math.min(1, Number.isFinite(l) ? l : 0))\n\n  if (saturation === 0) {\n    const value = Math.round(lightness * 255)\n    return { r: value, g: value, b: value }\n  }\n\n  const hueToRgb = (p: number, q: number, t: number): number => {\n    let next = t\n    if (next < 0) next += 1\n    if (next > 1) next -= 1\n    if (next < 1 / 6) return p + (q - p) * 6 * next\n    if (next < 1 / 2) return q\n    if (next < 2 / 3) return p + (q - p) * (2 / 3 - next) * 6\n    return p\n  }\n\n  const q =\n    lightness < 0.5 ? lightness * (1 + saturation) : lightness + saturation - lightness * saturation\n  const p = 2 * lightness - q\n\n  return {\n    r: Math.round(hueToRgb(p, q, hue + 1 / 3) * 255),\n    g: Math.round(hueToRgb(p, q, hue) * 255),\n    b: Math.round(hueToRgb(p, q, hue - 1 / 3) * 255),\n  }\n}\n\n/**\n * Convert normalized HSL values to Phaser number format.\n * @param h - Hue in normalized range (0.0 to 1.0)\n * @param s - Saturation in normalized range (0.0 to 1.0)\n * @param l - Lightness in normalized range (0.0 to 1.0)\n * @returns Phaser color number\n */\nexport function hslToNumber(h: number, s: number, l: number): number {\n  const rgb = hslToRgb(h, s, l)\n  return rgbToNumber(rgb.r, rgb.g, rgb.b)\n}\n\n/**\n * Convert Phaser number format to normalized HSL values.\n * @param color - Phaser color number\n * @returns HSL color values with normalized components\n */\nexport function numberToHsl(color: number): HSLColor {\n  const rgb = numberToRgb(color)\n  return rgbToHsl(rgb.r, rgb.g, rgb.b)\n}\n\n/**\n * Lighten a color by a given amount\n * @param color - Phaser color number\n * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)\n * @returns Lightened color number\n * @example\n * ```typescript\n * lighten(0x0000ff, 0.3) // returns lighter blue\n * lighten(0xff0000, 0.5) // returns light red/pink\n * ```\n */\nexport function lighten(color: number, amount: number): number {\n  const rgb = numberToRgb(color)\n  const factor = Math.max(0, Math.min(1, amount))\n\n  const r = Math.round(rgb.r + (255 - rgb.r) * factor)\n  const g = Math.round(rgb.g + (255 - rgb.g) * factor)\n  const b = Math.round(rgb.b + (255 - rgb.b) * factor)\n\n  return rgbToNumber(r, g, b)\n}\n\n/**\n * Darken a color by a given amount\n * @param color - Phaser color number\n * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)\n * @returns Darkened color number\n * @example\n * ```typescript\n * darken(0x0000ff, 0.3) // returns darker blue\n * darken(0xff0000, 0.5) // returns dark red\n * ```\n */\nexport function darken(color: number, amount: number): number {\n  const rgb = numberToRgb(color)\n  const factor = 1 - Math.max(0, Math.min(1, amount))\n\n  const r = Math.round(rgb.r * factor)\n  const g = Math.round(rgb.g * factor)\n  const b = Math.round(rgb.b * factor)\n\n  return rgbToNumber(r, g, b)\n}\n\n/**\n * Lighten a hex color by a given amount\n * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')\n * @param amount - Amount to lighten (0.0 to 1.0, where 1.0 is white)\n * @returns Lightened hex color string with '#' prefix\n * @example\n * ```typescript\n * lightenHex('#0000ff', 0.3) // returns lighter blue\n * lightenHex('#ff0000', 0.5) // returns light red/pink\n * ```\n */\nexport function lightenHex(hex: string, amount: number): HexColor {\n  const num = hexToNumber(hex)\n  const lightened = lighten(num, amount)\n  return HexColor.from(numberToHex(lightened))\n}\n\n/**\n * Darken a hex color by a given amount\n * @param hex - Hex color (e.g., '#ffffff' or 'ffffff')\n * @param amount - Amount to darken (0.0 to 1.0, where 1.0 is black)\n * @returns Darkened hex color string with '#' prefix\n * @example\n * ```typescript\n * darkenHex('#0000ff', 0.3) // returns darker blue\n * darkenHex('#ff0000', 0.5) // returns dark red\n * ```\n */\nexport function darkenHex(hex: string, amount: number): HexColor {\n  const num = hexToNumber(hex)\n  const darkened = darken(num, amount)\n  return HexColor.from(numberToHex(darkened))\n}\n\n/**\n * Convert color to rgba string for Phaser Text style\n * @param color - Phaser color number\n * @param alphaValue - Alpha value (0.0 to 1.0, default: 1.0)\n * @returns RGBA string usable in Text style (e.g., 'rgba(255, 0, 0, 0.5)')\n * @example\n * ```typescript\n * alpha(0xff0000, 1.0)   // returns 'rgba(255, 0, 0, 1)'\n * alpha(0x00ff00, 0.5)   // returns 'rgba(0, 255, 0, 0.5)'\n * alpha(0x0000ff)        // returns 'rgba(0, 0, 255, 1)'\n * ```\n */\nexport function alpha(color: number, alphaValue = 1.0): string {\n  const rgb = numberToRgb(color)\n  const a = Math.max(0, Math.min(1, alphaValue))\n  return `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a})`\n}\n\n/**\n * Calculate relative luminance of a color (WCAG formula)\n * @param color - Phaser color number\n * @returns Relative luminance (0.0 to 1.0)\n */\nfunction getLuminance(color: number): number {\n  const rgb = numberToRgb(color)\n\n  // Convert to sRGB\n  const rsRGB = rgb.r / 255\n  const gsRGB = rgb.g / 255\n  const bsRGB = rgb.b / 255\n\n  // Apply gamma correction\n  const r = rsRGB <= 0.03928 ? rsRGB / 12.92 : Math.pow((rsRGB + 0.055) / 1.055, 2.4)\n  const g = gsRGB <= 0.03928 ? gsRGB / 12.92 : Math.pow((gsRGB + 0.055) / 1.055, 2.4)\n  const b = bsRGB <= 0.03928 ? bsRGB / 12.92 : Math.pow((bsRGB + 0.055) / 1.055, 2.4)\n\n  // Calculate luminance\n  return 0.2126 * r + 0.7152 * g + 0.0722 * b\n}\n\n/**\n * Calculate contrast ratio between two colors (WCAG 2.0)\n * @param foreground - Foreground color (e.g., text)\n * @param background - Background color\n * @returns Contrast ratio (1 to 21)\n * @example\n * ```typescript\n * getContrastRatio(0x000000, 0xffffff) // returns 21 (black on white)\n * getContrastRatio(0xffffff, 0xffffff) // returns 1 (white on white)\n * ```\n */\nexport function getContrastRatio(foreground: number, background: number): number {\n  const l1 = getLuminance(foreground)\n  const l2 = getLuminance(background)\n\n  const lighter = Math.max(l1, l2)\n  const darker = Math.min(l1, l2)\n\n  return (lighter + 0.05) / (darker + 0.05)\n}\n\n/**\n * Ensure minimum contrast ratio by adjusting foreground color\n * Uses binary search for efficiency (O(log n) vs O(n))\n * @param foreground - Foreground color to adjust\n * @param background - Background color (fixed)\n * @param minRatio - Minimum contrast ratio (default: 4.5 for WCAG AA)\n * @returns Adjusted foreground color meeting contrast requirements\n * @example\n * ```typescript\n * // Ensure text is readable on background\n * const textColor = ensureContrast(0x888888, 0xffffff, 4.5)\n * ```\n */\nexport function ensureContrast(foreground: number, background: number, minRatio = 4.5): number {\n  // If contrast is already sufficient, return original\n  if (getContrastRatio(foreground, background) >= minRatio) {\n    return foreground\n  }\n\n  // Determine if we should lighten or darken\n  const bgLuminance = getLuminance(background)\n  const shouldLighten = bgLuminance < 0.5\n\n  // Binary search for the minimal adjustment needed\n  let low = 0\n  let high = 1\n\n  while (high - low > 0.01) {\n    const mid = (low + high) / 2\n    const adjusted = shouldLighten ? lighten(foreground, mid) : darken(foreground, mid)\n\n    if (getContrastRatio(adjusted, background) >= minRatio) {\n      high = mid\n    } else {\n      low = mid\n    }\n  }\n\n  return shouldLighten ? lighten(foreground, high) : darken(foreground, high)\n}\n\n/**\n * Create a TextStyleToken by merging base style with overrides to ensure required properties are set\n * @param baseStyle\n * @param overrides\n * @returns\n */\nexport function createTextStyle(\n  baseStyle: Partial<TextStyleToken> | undefined,\n  overrides: Partial<TextStyleToken>\n): TextStyleToken {\n  const base = baseStyle ?? {}\n  return {\n    fontSize: overrides.fontSize ?? base.fontSize ?? '14px',\n    color: overrides.color ?? base.color ?? '#ffffff',\n    ...(base.fontFamily && { fontFamily: base.fontFamily }),\n    ...(base.align && { align: base.align }),\n    ...overrides,\n  }\n}\n"],"names":["p","q"],"mappings":"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"}

package/dist/colors/contrast-contracts.cjs

@@ -0,0 +1,265 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const colorUtils = require("./color-utils.cjs");
+const contrastBackgroundRoles = {
+  "background/default": {
+    description: "Main application background.",
+    color: { group: "background", shade: "DEFAULT" }
+  },
+  "surface/default": {
+    description: "Default surface for panels, cards, and controls.",
+    color: { group: "surface", shade: "DEFAULT" }
+  },
+  "surface/elevated": {
+    description: "Elevated surface used for stronger separation.",
+    color: { group: "surface", shade: "light" }
+  },
+  "brand/primary": {
+    description: "Primary brand background.",
+    color: { group: "primary", shade: "dark" }
+  },
+  "feedback/success": {
+    description: "Success-state background.",
+    color: { group: "success", shade: "dark" }
+  },
+  "feedback/warning": {
+    description: "Warning-state background.",
+    color: { group: "warning", shade: "dark" }
+  },
+  "feedback/error": {
+    description: "Error-state background.",
+    color: { group: "error", shade: "dark" }
+  }
+};
+const contrastForegroundRoles = {
+  "text/default": {
+    description: "Default body text.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "DEFAULT" },
+      { group: "text", shade: "dark" },
+      { group: "text", shade: "darkest" },
+      { group: "text", shade: "light" }
+    ]
+  },
+  "text/muted": {
+    description: "Secondary or supporting text.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "light" },
+      { group: "text", shade: "medium" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/strong": {
+    description: "Emphasized text on neutral surfaces.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "darkest" },
+      { group: "text", shade: "dark" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/on-brand": {
+    description: "Text intended for strong brand or colored backgrounds.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "text/on-danger": {
+    description: "Text intended for danger/error backgrounds.",
+    kind: "text",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "icon/on-brand": {
+    description: "Icon tint intended for strong brand or colored backgrounds.",
+    kind: "icon",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  },
+  "icon/on-danger": {
+    description: "Icon tint intended for danger/error backgrounds.",
+    kind: "icon",
+    candidates: [
+      { group: "text", shade: "lightest" },
+      { group: "text", shade: "light" },
+      { group: "text", shade: "DEFAULT" }
+    ]
+  }
+};
+const defaultContrastContracts = [
+  {
+    id: "body-on-background",
+    description: "Default body text on the main application background.",
+    foregroundRole: "text/default",
+    backgroundRole: "background/default",
+    minRatio: 4.5
+  },
+  {
+    id: "body-on-surface",
+    description: "Default body text on standard surfaces and cards.",
+    foregroundRole: "text/default",
+    backgroundRole: "surface/default",
+    minRatio: 4.5
+  },
+  {
+    id: "muted-on-surface",
+    description: "Muted supporting text on standard surfaces.",
+    foregroundRole: "text/muted",
+    backgroundRole: "surface/default",
+    minRatio: 4.5
+  },
+  {
+    id: "strong-on-surface",
+    description: "Strong emphasized text on elevated surfaces.",
+    foregroundRole: "text/strong",
+    backgroundRole: "surface/elevated",
+    minRatio: 4.5
+  },
+  {
+    id: "text-on-primary",
+    description: "Readable text on the primary brand background.",
+    foregroundRole: "text/on-brand",
+    backgroundRole: "brand/primary",
+    minRatio: 4.5
+  },
+  {
+    id: "text-on-error",
+    description: "Readable text on the error background.",
+    foregroundRole: "text/on-danger",
+    backgroundRole: "feedback/error",
+    minRatio: 4.5
+  },
+  {
+    id: "icon-on-primary",
+    description: "Readable icon tint on the primary brand background.",
+    foregroundRole: "icon/on-brand",
+    backgroundRole: "brand/primary",
+    minRatio: 3
+  },
+  {
+    id: "icon-on-error",
+    description: "Readable icon tint on the error background.",
+    foregroundRole: "icon/on-danger",
+    backgroundRole: "feedback/error",
+    minRatio: 3
+  }
+];
+function resolveContrastColorRef(colors, ref) {
+  return colors[ref.group][ref.shade].toNumber();
+}
+function resolveContrastBackgroundRole(colors, role) {
+  const definition = contrastBackgroundRoles[role];
+  const value = resolveContrastColorRef(colors, definition.color);
+  return {
+    role,
+    value,
+    hex: colorUtils.numberToHex(value)
+  };
+}
+function resolveContrastForegroundRole(colors, role, background, minRatio) {
+  const definition = contrastForegroundRoles[role];
+  const resolvedCandidates = definition.candidates.map((candidate) => ({
+    candidate,
+    value: resolveContrastColorRef(colors, candidate)
+  }));
+  const exactMatch = resolvedCandidates.find(
+    ({ value }) => colorUtils.getContrastRatio(value, background) >= minRatio
+  );
+  if (exactMatch) {
+    return {
+      role,
+      kind: definition.kind,
+      source: "token",
+      candidate: exactMatch.candidate,
+      value: exactMatch.value,
+      hex: colorUtils.numberToHex(exactMatch.value)
+    };
+  }
+  const preferred = resolvedCandidates[0];
+  if (!preferred) {
+    throw new Error(`Contrast foreground role "${role}" has no candidate colors.`);
+  }
+  const adjustedValue = colorUtils.ensureContrast(preferred.value, background, minRatio);
+  return {
+    role,
+    kind: definition.kind,
+    source: "adjusted",
+    candidate: preferred.candidate,
+    value: adjustedValue,
+    hex: colorUtils.numberToHex(adjustedValue)
+  };
+}
+function resolveContrastContract(colors, contract) {
+  const background = resolveContrastBackgroundRole(colors, contract.backgroundRole);
+  const foreground = resolveContrastForegroundRole(
+    colors,
+    contract.foregroundRole,
+    background.value,
+    contract.minRatio
+  );
+  const ratio = colorUtils.getContrastRatio(foreground.value, background.value);
+  return {
+    contract,
+    foreground,
+    background,
+    ratio,
+    passes: ratio >= contract.minRatio
+  };
+}
+function validateContrastContracts(colors, contracts = defaultContrastContracts) {
+  return contracts.map((contract) => resolveContrastContract(colors, contract));
+}
+function getFailingContrastContracts(colors, contracts = defaultContrastContracts) {
+  return validateContrastContracts(colors, contracts).filter((result) => !result.passes);
+}
+function getContrastContract(contractId) {
+  return defaultContrastContracts.find((contract) => contract.id === contractId);
+}
+function resolveContrastContractById(colors, contractId) {
+  const contract = getContrastContract(contractId);
+  if (!contract) throw new Error(`Contrast contract not found: ${contractId}`);
+  return resolveContrastContract(colors, contract);
+}
+function resolveContrastTextColor(colors, foregroundRole, background, minRatio = 4.5) {
+  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).hex;
+}
+function resolveContrastTintColor(colors, foregroundRole, background, minRatio = 3) {
+  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).value;
+}
+function formatResolvedContrastContract(resolved) {
+  const { contract, foreground, background, ratio } = resolved;
+  const status = resolved.passes ? "✓" : "✗";
+  return [
+    `${status} ${contract.id}`,
+    `  ${contract.description}`,
+    `  fg: ${foreground.hex}  role=${foreground.role}  kind=${foreground.kind}  src=${foreground.source}`,
+    `  bg: ${background.hex}  role=${background.role}`,
+    `  ratio: ${ratio.toFixed(2)}:1  (need ≥ ${contract.minRatio}:1)`
+  ].join("\n");
+}
+exports.contrastBackgroundRoles = contrastBackgroundRoles;
+exports.contrastForegroundRoles = contrastForegroundRoles;
+exports.defaultContrastContracts = defaultContrastContracts;
+exports.formatResolvedContrastContract = formatResolvedContrastContract;
+exports.getContrastContract = getContrastContract;
+exports.getFailingContrastContracts = getFailingContrastContracts;
+exports.resolveContrastBackgroundRole = resolveContrastBackgroundRole;
+exports.resolveContrastColorRef = resolveContrastColorRef;
+exports.resolveContrastContract = resolveContrastContract;
+exports.resolveContrastContractById = resolveContrastContractById;
+exports.resolveContrastForegroundRole = resolveContrastForegroundRole;
+exports.resolveContrastTextColor = resolveContrastTextColor;
+exports.resolveContrastTintColor = resolveContrastTintColor;
+exports.validateContrastContracts = validateContrastContracts;
+//# sourceMappingURL=contrast-contracts.cjs.map

package/dist/colors/contrast-contracts.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast-contracts.cjs","sources":["../../src/colors/contrast-contracts.ts"],"sourcesContent":["/**\n * Semantic contrast contracts for theme and preset authors.\n *\n * This file is intentionally a small first step:\n * - define a shared language for meaningful foreground/background pairings\n * - expose helpers that can resolve and validate those pairings\n * - keep room for a second step where component defaults and tests adopt them\n *\n * TODO(step-2): let theme-default builders consume these contracts directly.\n * TODO(step-2): move component-level contrast test heuristics onto this model.\n * TODO(step-3): add context-aware contracts for alpha/translucent surfaces.\n */\n\nimport type { ColorTokens, ShadeLevel } from './color-types'\nimport { ensureContrast, getContrastRatio, numberToHex } from './color-utils'\n\ntype TokenColorGroup =\n  | 'background'\n  | 'surface'\n  | 'text'\n  | 'border'\n  | 'primary'\n  | 'secondary'\n  | 'accent'\n  | 'success'\n  | 'warning'\n  | 'error'\n  | 'info'\n\nexport interface ContrastColorRef {\n  group: TokenColorGroup\n  shade: ShadeLevel | 'DEFAULT'\n}\n\nexport interface ContrastBackgroundRoleDefinition {\n  description: string\n  color: ContrastColorRef\n}\n\nexport interface ContrastForegroundRoleDefinition {\n  description: string\n  kind: 'text' | 'icon'\n  candidates: readonly ContrastColorRef[]\n}\n\nexport const contrastBackgroundRoles = {\n  'background/default': {\n    description: 'Main application background.',\n    color: { group: 'background', shade: 'DEFAULT' },\n  },\n  'surface/default': {\n    description: 'Default surface for panels, cards, and controls.',\n    color: { group: 'surface', shade: 'DEFAULT' },\n  },\n  'surface/elevated': {\n    description: 'Elevated surface used for stronger separation.',\n    color: { group: 'surface', shade: 'light' },\n  },\n  'brand/primary': {\n    description: 'Primary brand background.',\n    color: { group: 'primary', shade: 'dark' },\n  },\n  'feedback/success': {\n    description: 'Success-state background.',\n    color: { group: 'success', shade: 'dark' },\n  },\n  'feedback/warning': {\n    description: 'Warning-state background.',\n    color: { group: 'warning', shade: 'dark' },\n  },\n  'feedback/error': {\n    description: 'Error-state background.',\n    color: { group: 'error', shade: 'dark' },\n  },\n} as const satisfies Record<string, ContrastBackgroundRoleDefinition>\n\nexport type ContrastBackgroundRole = keyof typeof contrastBackgroundRoles\n\nexport const contrastForegroundRoles = {\n  'text/default': {\n    description: 'Default body text.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'DEFAULT' },\n      { group: 'text', shade: 'dark' },\n      { group: 'text', shade: 'darkest' },\n      { group: 'text', shade: 'light' },\n    ],\n  },\n  'text/muted': {\n    description: 'Secondary or supporting text.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'medium' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/strong': {\n    description: 'Emphasized text on neutral surfaces.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'darkest' },\n      { group: 'text', shade: 'dark' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/on-brand': {\n    description: 'Text intended for strong brand or colored backgrounds.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'text/on-danger': {\n    description: 'Text intended for danger/error backgrounds.',\n    kind: 'text',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'icon/on-brand': {\n    description: 'Icon tint intended for strong brand or colored backgrounds.',\n    kind: 'icon',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n  'icon/on-danger': {\n    description: 'Icon tint intended for danger/error backgrounds.',\n    kind: 'icon',\n    candidates: [\n      { group: 'text', shade: 'lightest' },\n      { group: 'text', shade: 'light' },\n      { group: 'text', shade: 'DEFAULT' },\n    ],\n  },\n} as const satisfies Record<string, ContrastForegroundRoleDefinition>\n\nexport type ContrastForegroundRole = keyof typeof contrastForegroundRoles\n\nexport interface ContrastContract {\n  id: string\n  description: string\n  foregroundRole: ContrastForegroundRole\n  backgroundRole: ContrastBackgroundRole\n  minRatio: number\n}\n\nexport const defaultContrastContracts = [\n  {\n    id: 'body-on-background',\n    description: 'Default body text on the main application background.',\n    foregroundRole: 'text/default',\n    backgroundRole: 'background/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'body-on-surface',\n    description: 'Default body text on standard surfaces and cards.',\n    foregroundRole: 'text/default',\n    backgroundRole: 'surface/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'muted-on-surface',\n    description: 'Muted supporting text on standard surfaces.',\n    foregroundRole: 'text/muted',\n    backgroundRole: 'surface/default',\n    minRatio: 4.5,\n  },\n  {\n    id: 'strong-on-surface',\n    description: 'Strong emphasized text on elevated surfaces.',\n    foregroundRole: 'text/strong',\n    backgroundRole: 'surface/elevated',\n    minRatio: 4.5,\n  },\n  {\n    id: 'text-on-primary',\n    description: 'Readable text on the primary brand background.',\n    foregroundRole: 'text/on-brand',\n    backgroundRole: 'brand/primary',\n    minRatio: 4.5,\n  },\n  {\n    id: 'text-on-error',\n    description: 'Readable text on the error background.',\n    foregroundRole: 'text/on-danger',\n    backgroundRole: 'feedback/error',\n    minRatio: 4.5,\n  },\n  {\n    id: 'icon-on-primary',\n    description: 'Readable icon tint on the primary brand background.',\n    foregroundRole: 'icon/on-brand',\n    backgroundRole: 'brand/primary',\n    minRatio: 3,\n  },\n  {\n    id: 'icon-on-error',\n    description: 'Readable icon tint on the error background.',\n    foregroundRole: 'icon/on-danger',\n    backgroundRole: 'feedback/error',\n    minRatio: 3,\n  },\n] as const satisfies readonly ContrastContract[]\n\nexport interface ResolvedContrastColor {\n  role: ContrastForegroundRole | ContrastBackgroundRole\n  value: number\n  hex: string\n}\n\nexport interface ResolvedContrastForeground extends ResolvedContrastColor {\n  kind: 'text' | 'icon'\n  source: 'token' | 'adjusted'\n  candidate: ContrastColorRef\n}\n\nexport interface ResolvedContrastContract {\n  contract: ContrastContract\n  foreground: ResolvedContrastForeground\n  background: ResolvedContrastColor\n  ratio: number\n  passes: boolean\n}\n\nexport function resolveContrastColorRef(colors: ColorTokens, ref: ContrastColorRef): number {\n  return colors[ref.group][ref.shade].toNumber()\n}\n\nexport function resolveContrastBackgroundRole(\n  colors: ColorTokens,\n  role: ContrastBackgroundRole\n): ResolvedContrastColor {\n  const definition = contrastBackgroundRoles[role]\n  const value = resolveContrastColorRef(colors, definition.color)\n\n  return {\n    role,\n    value,\n    hex: numberToHex(value),\n  }\n}\n\nexport function resolveContrastForegroundRole(\n  colors: ColorTokens,\n  role: ContrastForegroundRole,\n  background: number,\n  minRatio: number\n): ResolvedContrastForeground {\n  const definition = contrastForegroundRoles[role]\n  const resolvedCandidates = definition.candidates.map((candidate) => ({\n    candidate,\n    value: resolveContrastColorRef(colors, candidate),\n  }))\n\n  const exactMatch = resolvedCandidates.find(\n    ({ value }) => getContrastRatio(value, background) >= minRatio\n  )\n\n  if (exactMatch) {\n    return {\n      role,\n      kind: definition.kind,\n      source: 'token',\n      candidate: exactMatch.candidate,\n      value: exactMatch.value,\n      hex: numberToHex(exactMatch.value),\n    }\n  }\n\n  const preferred = resolvedCandidates[0]\n  if (!preferred) {\n    throw new Error(`Contrast foreground role \"${role}\" has no candidate colors.`)\n  }\n\n  const adjustedValue = ensureContrast(preferred.value, background, minRatio)\n\n  return {\n    role,\n    kind: definition.kind,\n    source: 'adjusted',\n    candidate: preferred.candidate,\n    value: adjustedValue,\n    hex: numberToHex(adjustedValue),\n  }\n}\n\nexport function resolveContrastContract(\n  colors: ColorTokens,\n  contract: ContrastContract\n): ResolvedContrastContract {\n  const background = resolveContrastBackgroundRole(colors, contract.backgroundRole)\n  const foreground = resolveContrastForegroundRole(\n    colors,\n    contract.foregroundRole,\n    background.value,\n    contract.minRatio\n  )\n  const ratio = getContrastRatio(foreground.value, background.value)\n\n  return {\n    contract,\n    foreground,\n    background,\n    ratio,\n    passes: ratio >= contract.minRatio,\n  }\n}\n\nexport function validateContrastContracts(\n  colors: ColorTokens,\n  contracts: readonly ContrastContract[] = defaultContrastContracts\n): ResolvedContrastContract[] {\n  return contracts.map((contract) => resolveContrastContract(colors, contract))\n}\n\nexport function getFailingContrastContracts(\n  colors: ColorTokens,\n  contracts: readonly ContrastContract[] = defaultContrastContracts\n): ResolvedContrastContract[] {\n  return validateContrastContracts(colors, contracts).filter((result) => !result.passes)\n}\n\nexport function getContrastContract(contractId: string): ContrastContract | undefined {\n  return defaultContrastContracts.find((contract) => contract.id === contractId)\n}\n\n/**\n * Resolve a contract by id, throwing if the contract is not found.\n * Convenience wrapper around getContrastContract + resolveContrastContract.\n * @param colors - The color token set\n * @param contractId - The contract identifier (e.g. 'text-on-primary')\n * @returns Resolved contract with foreground, background, ratio, and pass/fail\n * @throws If no contract with the given id exists\n */\nexport function resolveContrastContractById(\n  colors: ColorTokens,\n  contractId: string\n): ResolvedContrastContract {\n  const contract = getContrastContract(contractId)\n  if (!contract) throw new Error(`Contrast contract not found: ${contractId}`)\n  return resolveContrastContract(colors, contract)\n}\n\n/**\n * Convenience: resolve a foreground role against a numeric background and\n * return the resulting hex color string (for Text style `.color`).\n * @param colors - The color token set\n * @param foregroundRole - Semantic foreground role (e.g. 'text/on-brand')\n * @param background - Numeric background color to check contrast against\n * @param minRatio - Minimum contrast ratio (defaults to WCAG AA 4.5:1)\n * @returns Hex color string suitable for Text style `.color`\n */\nexport function resolveContrastTextColor(\n  colors: ColorTokens,\n  foregroundRole: ContrastForegroundRole,\n  background: number,\n  minRatio = 4.5\n): string {\n  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).hex\n}\n\n/**\n * Convenience: resolve a foreground role against a numeric background and\n * return the resulting numeric color (for Icon `.tint` or similar).\n * @param colors - The color token set\n * @param foregroundRole - Semantic foreground role (e.g. 'icon/on-brand')\n * @param background - Numeric background color to check contrast against\n * @param minRatio - Minimum contrast ratio (defaults to 3:1 for icons/UI graphics)\n * @returns Numeric color value\n */\nexport function resolveContrastTintColor(\n  colors: ColorTokens,\n  foregroundRole: ContrastForegroundRole,\n  background: number,\n  minRatio = 3\n): number {\n  return resolveContrastForegroundRole(colors, foregroundRole, background, minRatio).value\n}\n\n/**\n * Format a resolved contract as a human-readable multi-line string.\n * Useful for debugging, CLI output, and authoring tools.\n * @param resolved - A resolved contrast contract\n * @returns Formatted description string\n */\nexport function formatResolvedContrastContract(resolved: ResolvedContrastContract): string {\n  const { contract, foreground, background, ratio } = resolved\n  const status = resolved.passes ? '✓' : '✗'\n  return [\n    `${status} ${contract.id}`,\n    `  ${contract.description}`,\n    `  fg: ${foreground.hex}  role=${foreground.role}  kind=${foreground.kind}  src=${foreground.source}`,\n    `  bg: ${background.hex}  role=${background.role}`,\n    `  ratio: ${ratio.toFixed(2)}:1  (need ≥ ${contract.minRatio}:1)`,\n  ].join('\\n')\n}\n"],"names":["numberToHex","getContrastRatio","ensureContrast"],"mappings":"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"}

package/dist/colors/contrast-contracts.d.ts

@@ -0,0 +1,289 @@
+import { ColorTokens, ShadeLevel } from './color-types';
+type TokenColorGroup = 'background' | 'surface' | 'text' | 'border' | 'primary' | 'secondary' | 'accent' | 'success' | 'warning' | 'error' | 'info';
+export interface ContrastColorRef {
+    group: TokenColorGroup;
+    shade: ShadeLevel | 'DEFAULT';
+}
+export interface ContrastBackgroundRoleDefinition {
+    description: string;
+    color: ContrastColorRef;
+}
+export interface ContrastForegroundRoleDefinition {
+    description: string;
+    kind: 'text' | 'icon';
+    candidates: readonly ContrastColorRef[];
+}
+export declare const contrastBackgroundRoles: {
+    readonly 'background/default': {
+        readonly description: "Main application background.";
+        readonly color: {
+            readonly group: "background";
+            readonly shade: "DEFAULT";
+        };
+    };
+    readonly 'surface/default': {
+        readonly description: "Default surface for panels, cards, and controls.";
+        readonly color: {
+            readonly group: "surface";
+            readonly shade: "DEFAULT";
+        };
+    };
+    readonly 'surface/elevated': {
+        readonly description: "Elevated surface used for stronger separation.";
+        readonly color: {
+            readonly group: "surface";
+            readonly shade: "light";
+        };
+    };
+    readonly 'brand/primary': {
+        readonly description: "Primary brand background.";
+        readonly color: {
+            readonly group: "primary";
+            readonly shade: "dark";
+        };
+    };
+    readonly 'feedback/success': {
+        readonly description: "Success-state background.";
+        readonly color: {
+            readonly group: "success";
+            readonly shade: "dark";
+        };
+    };
+    readonly 'feedback/warning': {
+        readonly description: "Warning-state background.";
+        readonly color: {
+            readonly group: "warning";
+            readonly shade: "dark";
+        };
+    };
+    readonly 'feedback/error': {
+        readonly description: "Error-state background.";
+        readonly color: {
+            readonly group: "error";
+            readonly shade: "dark";
+        };
+    };
+};
+export type ContrastBackgroundRole = keyof typeof contrastBackgroundRoles;
+export declare const contrastForegroundRoles: {
+    readonly 'text/default': {
+        readonly description: "Default body text.";
+        readonly kind: "text";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }, {
+            readonly group: "text";
+            readonly shade: "dark";
+        }, {
+            readonly group: "text";
+            readonly shade: "darkest";
+        }, {
+            readonly group: "text";
+            readonly shade: "light";
+        }];
+    };
+    readonly 'text/muted': {
+        readonly description: "Secondary or supporting text.";
+        readonly kind: "text";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "light";
+        }, {
+            readonly group: "text";
+            readonly shade: "medium";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+    readonly 'text/strong': {
+        readonly description: "Emphasized text on neutral surfaces.";
+        readonly kind: "text";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "darkest";
+        }, {
+            readonly group: "text";
+            readonly shade: "dark";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+    readonly 'text/on-brand': {
+        readonly description: "Text intended for strong brand or colored backgrounds.";
+        readonly kind: "text";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "lightest";
+        }, {
+            readonly group: "text";
+            readonly shade: "light";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+    readonly 'text/on-danger': {
+        readonly description: "Text intended for danger/error backgrounds.";
+        readonly kind: "text";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "lightest";
+        }, {
+            readonly group: "text";
+            readonly shade: "light";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+    readonly 'icon/on-brand': {
+        readonly description: "Icon tint intended for strong brand or colored backgrounds.";
+        readonly kind: "icon";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "lightest";
+        }, {
+            readonly group: "text";
+            readonly shade: "light";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+    readonly 'icon/on-danger': {
+        readonly description: "Icon tint intended for danger/error backgrounds.";
+        readonly kind: "icon";
+        readonly candidates: readonly [{
+            readonly group: "text";
+            readonly shade: "lightest";
+        }, {
+            readonly group: "text";
+            readonly shade: "light";
+        }, {
+            readonly group: "text";
+            readonly shade: "DEFAULT";
+        }];
+    };
+};
+export type ContrastForegroundRole = keyof typeof contrastForegroundRoles;
+export interface ContrastContract {
+    id: string;
+    description: string;
+    foregroundRole: ContrastForegroundRole;
+    backgroundRole: ContrastBackgroundRole;
+    minRatio: number;
+}
+export declare const defaultContrastContracts: readonly [{
+    readonly id: "body-on-background";
+    readonly description: "Default body text on the main application background.";
+    readonly foregroundRole: "text/default";
+    readonly backgroundRole: "background/default";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "body-on-surface";
+    readonly description: "Default body text on standard surfaces and cards.";
+    readonly foregroundRole: "text/default";
+    readonly backgroundRole: "surface/default";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "muted-on-surface";
+    readonly description: "Muted supporting text on standard surfaces.";
+    readonly foregroundRole: "text/muted";
+    readonly backgroundRole: "surface/default";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "strong-on-surface";
+    readonly description: "Strong emphasized text on elevated surfaces.";
+    readonly foregroundRole: "text/strong";
+    readonly backgroundRole: "surface/elevated";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "text-on-primary";
+    readonly description: "Readable text on the primary brand background.";
+    readonly foregroundRole: "text/on-brand";
+    readonly backgroundRole: "brand/primary";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "text-on-error";
+    readonly description: "Readable text on the error background.";
+    readonly foregroundRole: "text/on-danger";
+    readonly backgroundRole: "feedback/error";
+    readonly minRatio: 4.5;
+}, {
+    readonly id: "icon-on-primary";
+    readonly description: "Readable icon tint on the primary brand background.";
+    readonly foregroundRole: "icon/on-brand";
+    readonly backgroundRole: "brand/primary";
+    readonly minRatio: 3;
+}, {
+    readonly id: "icon-on-error";
+    readonly description: "Readable icon tint on the error background.";
+    readonly foregroundRole: "icon/on-danger";
+    readonly backgroundRole: "feedback/error";
+    readonly minRatio: 3;
+}];
+export interface ResolvedContrastColor {
+    role: ContrastForegroundRole | ContrastBackgroundRole;
+    value: number;
+    hex: string;
+}
+export interface ResolvedContrastForeground extends ResolvedContrastColor {
+    kind: 'text' | 'icon';
+    source: 'token' | 'adjusted';
+    candidate: ContrastColorRef;
+}
+export interface ResolvedContrastContract {
+    contract: ContrastContract;
+    foreground: ResolvedContrastForeground;
+    background: ResolvedContrastColor;
+    ratio: number;
+    passes: boolean;
+}
+export declare function resolveContrastColorRef(colors: ColorTokens, ref: ContrastColorRef): number;
+export declare function resolveContrastBackgroundRole(colors: ColorTokens, role: ContrastBackgroundRole): ResolvedContrastColor;
+export declare function resolveContrastForegroundRole(colors: ColorTokens, role: ContrastForegroundRole, background: number, minRatio: number): ResolvedContrastForeground;
+export declare function resolveContrastContract(colors: ColorTokens, contract: ContrastContract): ResolvedContrastContract;
+export declare function validateContrastContracts(colors: ColorTokens, contracts?: readonly ContrastContract[]): ResolvedContrastContract[];
+export declare function getFailingContrastContracts(colors: ColorTokens, contracts?: readonly ContrastContract[]): ResolvedContrastContract[];
+export declare function getContrastContract(contractId: string): ContrastContract | undefined;
+/**
+ * Resolve a contract by id, throwing if the contract is not found.
+ * Convenience wrapper around getContrastContract + resolveContrastContract.
+ * @param colors - The color token set
+ * @param contractId - The contract identifier (e.g. 'text-on-primary')
+ * @returns Resolved contract with foreground, background, ratio, and pass/fail
+ * @throws If no contract with the given id exists
+ */
+export declare function resolveContrastContractById(colors: ColorTokens, contractId: string): ResolvedContrastContract;
+/**
+ * Convenience: resolve a foreground role against a numeric background and
+ * return the resulting hex color string (for Text style `.color`).
+ * @param colors - The color token set
+ * @param foregroundRole - Semantic foreground role (e.g. 'text/on-brand')
+ * @param background - Numeric background color to check contrast against
+ * @param minRatio - Minimum contrast ratio (defaults to WCAG AA 4.5:1)
+ * @returns Hex color string suitable for Text style `.color`
+ */
+export declare function resolveContrastTextColor(colors: ColorTokens, foregroundRole: ContrastForegroundRole, background: number, minRatio?: number): string;
+/**
+ * Convenience: resolve a foreground role against a numeric background and
+ * return the resulting numeric color (for Icon `.tint` or similar).
+ * @param colors - The color token set
+ * @param foregroundRole - Semantic foreground role (e.g. 'icon/on-brand')
+ * @param background - Numeric background color to check contrast against
+ * @param minRatio - Minimum contrast ratio (defaults to 3:1 for icons/UI graphics)
+ * @returns Numeric color value
+ */
+export declare function resolveContrastTintColor(colors: ColorTokens, foregroundRole: ContrastForegroundRole, background: number, minRatio?: number): number;
+/**
+ * Format a resolved contract as a human-readable multi-line string.
+ * Useful for debugging, CLI output, and authoring tools.
+ * @param resolved - A resolved contrast contract
+ * @returns Formatted description string
+ */
+export declare function formatResolvedContrastContract(resolved: ResolvedContrastContract): string;
+export {};
+//# sourceMappingURL=contrast-contracts.d.ts.map

package/dist/colors/contrast-contracts.d.ts.map

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