tempest-react-sdk 0.77.0 → 0.79.0

package/dist/theme/color.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"color.cjs","names":[],"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — OKLCH ↔ sRGB with the gamut mapping in between: the\n * transfer function, the LMS matrices, the chroma search that finds the nearest in-\n * gamut colour and the contrast ratio used to check it. Matrices split across files\n * are matrices that get edited one half at a time.\n */\n/**\n * Color math behind {@link createTheme} — OKLab/OKLCH conversions, tint scale\n * generation and WCAG contrast picking.\n *\n * Everything here is pure and dependency-free: the SDK generates brand ramps at\n * runtime in the browser, so a color library would be a disproportionate cost\n * for ~150 lines of well-specified math. OKLCH is used instead of HSL because\n * HSL lightness is not perceptual — an HSL ramp of a yellow and of a blue at the\n * same `L` read as wildly different brightness, which is exactly what breaks a\n * generated palette.\n */\n\n/** A color in the OKLCH space: perceptual lightness, chroma and hue. */\nexport interface Oklch {\n    /** Perceptual lightness, `0` (black) to `1` (white). */\n    l: number;\n    /** Chroma (colorfulness). `0` is gray; sRGB rarely exceeds `~0.37`. */\n    c: number;\n    /** Hue angle in degrees, `0`–`360`. */\n    h: number;\n}\n\n/** The ten steps of a Tempest tint scale, lightest to darkest. */\nexport type ScaleStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\n/** A generated tint scale, keyed by step. */\nexport type ColorScale = Record<ScaleStep, string>;\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\n/**\n * Target lightness per step for a **brand** ramp in light mode.\n *\n * These are the measured OKLCH lightnesses of the hand-written `--tempest-primary-*`\n * scale in `colors.css`, so a generated brand ramp lands in the same visual range\n * as the built-in one instead of merely near it.\n */\nconst LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.966,\n    100: 0.923,\n    200: 0.844,\n    300: 0.743,\n    400: 0.642,\n    500: 0.563,\n    600: 0.48,\n    700: 0.391,\n    800: 0.325,\n    900: 0.251,\n};\n\n/**\n * Target lightness per step for a **neutral** ramp in light mode — measured from\n * the hand-written `--tempest-gray-*` scale.\n *\n * Deliberately **wider** than the brand curve at both ends (`0.982` → `0.210` vs\n * `0.966` → `0.251`): a neutral carries surfaces that must read as near-white and\n * text that must read as near-black, and the pair `text-muted` on `surface-3` has\n * to clear AA. Reusing the brand curve for neutrals is what dropped that pair to\n * 3.5:1 and made the browser axe sweep fail on every generated theme.\n */\nconst NEUTRAL_LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.982,\n    100: 0.963,\n    200: 0.927,\n    300: 0.872,\n    400: 0.71,\n    500: 0.544,\n    600: 0.442,\n    700: 0.369,\n    800: 0.278,\n    900: 0.21,\n};\n\n/**\n * Neutral ramp for dark mode, measured from the `[data-tempest-theme=\"dark\"]`\n * surface/text tokens: `50` is the page background and `900` is text-grade.\n */\nconst NEUTRAL_DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.159,\n    100: 0.205,\n    200: 0.254,\n    300: 0.314,\n    400: 0.381,\n    500: 0.5,\n    600: 0.571,\n    700: 0.762,\n    800: 0.86,\n    900: 0.964,\n};\n\n/**\n * Target lightness for a dark-theme ramp — the ramp is **inverted**: `50` is the\n * darkest tint (a surface) and `900` the lightest (text-grade), matching the\n * `[data-tempest-theme=\"dark\"]` block in `colors.css`.\n */\nconst DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.238,\n    100: 0.288,\n    200: 0.362,\n    300: 0.452,\n    400: 0.544,\n    500: 0.632,\n    600: 0.712,\n    700: 0.788,\n    800: 0.862,\n    900: 0.928,\n};\n\n/**\n * Chroma multiplier per step, relative to the input color's chroma.\n *\n * Peaks around `500`–`600` and falls off at both ends: near-white and near-black\n * tints hold very little chroma before they look muddy or leave the sRGB gamut.\n */\nconst CHROMA_CURVE: Record<ScaleStep, number> = {\n    50: 0.18,\n    100: 0.34,\n    200: 0.6,\n    300: 0.82,\n    400: 0.95,\n    500: 1,\n    600: 0.98,\n    700: 0.88,\n    800: 0.74,\n    900: 0.58,\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n    return Math.min(max, Math.max(min, value));\n}\n\n/** Expand `#abc` to `#aabbcc` and normalize to a lowercase 6-digit hex. */\nfunction normalizeHex(hex: string): string {\n    const raw = hex.trim().replace(/^#/, \"\");\n    const expanded =\n        raw.length === 3 || raw.length === 4\n            ? raw\n                  .slice(0, 3)\n                  .split(\"\")\n                  .map((char) => char + char)\n                  .join(\"\")\n            : raw.slice(0, 6);\n    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {\n        throw new Error(`Invalid hex color: \"${hex}\"`);\n    }\n    return `#${expanded.toLowerCase()}`;\n}\n\n/** Parse a hex color into sRGB channels in the `0`–`1` range. */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } {\n    const normalized = normalizeHex(hex).slice(1);\n    return {\n        r: parseInt(normalized.slice(0, 2), 16) / 255,\n        g: parseInt(normalized.slice(2, 4), 16) / 255,\n        b: parseInt(normalized.slice(4, 6), 16) / 255,\n    };\n}\n\n/** Serialize sRGB channels (`0`–`1`, clamped) back to a `#rrggbb` string. */\nexport function rgbToHex(r: number, g: number, b: number): string {\n    const channel = (value: number): string =>\n        Math.round(clamp(value, 0, 1) * 255)\n            .toString(16)\n            .padStart(2, \"0\");\n    return `#${channel(r)}${channel(g)}${channel(b)}`;\n}\n\nfunction srgbToLinear(channel: number): number {\n    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\nfunction linearToSrgb(channel: number): number {\n    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;\n}\n\n/** Convert a hex color to OKLCH. */\nexport function hexToOklch(hex: string): Oklch {\n    const { r, g, b } = hexToRgb(hex);\n    const lr = srgbToLinear(r);\n    const lg = srgbToLinear(g);\n    const lb = srgbToLinear(b);\n\n    const long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);\n    const medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);\n    const short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);\n\n    const l = 0.2104542553 * long + 0.793617785 * medium - 0.0040720468 * short;\n    const a = 1.9779984951 * long - 2.428592205 * medium + 0.4505937099 * short;\n    const bAxis = 0.0259040371 * long + 0.7827717662 * medium - 0.808675766 * short;\n\n    const c = Math.sqrt(a * a + bAxis * bAxis);\n    const hue = c < 1e-6 ? 0 : (Math.atan2(bAxis, a) * 180) / Math.PI;\n\n    return { l, c, h: hue < 0 ? hue + 360 : hue };\n}\n\n/** Convert OKLCH to linear-light sRGB, without gamut clamping. */\nfunction oklchToLinearRgb({ l, c, h }: Oklch): { r: number; g: number; b: number } {\n    const hRad = (h * Math.PI) / 180;\n    const a = Math.cos(hRad) * c;\n    const bAxis = Math.sin(hRad) * c;\n\n    const long = (l + 0.3963377774 * a + 0.2158037573 * bAxis) ** 3;\n    const medium = (l - 0.1055613458 * a - 0.0638541728 * bAxis) ** 3;\n    const short = (l - 0.0894841775 * a - 1.291485548 * bAxis) ** 3;\n\n    return {\n        r: 4.0767416621 * long - 3.3077115913 * medium + 0.2309699292 * short,\n        g: -1.2684380046 * long + 2.6097574011 * medium - 0.3413193965 * short,\n        b: -0.0041960863 * long - 0.7034186147 * medium + 1.707614701 * short,\n    };\n}\n\nfunction inGamut({ r, g, b }: { r: number; g: number; b: number }): boolean {\n    const epsilon = 1e-4;\n    return (\n        r >= -epsilon &&\n        r <= 1 + epsilon &&\n        g >= -epsilon &&\n        g <= 1 + epsilon &&\n        b >= -epsilon &&\n        b <= 1 + epsilon\n    );\n}\n\n/**\n * Convert OKLCH to a hex color, reducing chroma until the result fits sRGB.\n *\n * Lightness and hue are preserved: desaturating is far less noticeable than\n * shifting either of them, and a naive channel clamp would do both.\n */\nexport function oklchToHex(color: Oklch): string {\n    let chroma = Math.max(0, color.c);\n    let rgb = oklchToLinearRgb({ ...color, c: chroma });\n\n    for (let i = 0; i < 24 && !inGamut(rgb); i += 1) {\n        chroma *= 0.9;\n        rgb = oklchToLinearRgb({ ...color, c: chroma });\n    }\n\n    return rgbToHex(linearToSrgb(rgb.r), linearToSrgb(rgb.g), linearToSrgb(rgb.b));\n}\n\n/** Options for {@link createColorScale}. */\nexport interface ColorScaleOptions {\n    /**\n     * Pin step `500` to the input color's exact lightness. Default `true`.\n     *\n     * Right for a **brand** color: the hex a designer hands over is the one the\n     * buttons must be. Wrong for a **neutral**: nobody checks that `gray-500` is\n     * exactly the input, while everybody notices that a surface stopped being\n     * near-white — anchoring rescales both halves around the input and compresses\n     * exactly the range a neutral needs wide. With `false`, the ramp keeps the\n     * tuned lightness curve and the input only contributes hue and chroma (a warm\n     * or cool neutral, as asked).\n     */\n    anchor?: boolean;\n    /**\n     * Use the neutral lightness curve instead of the brand one. Default `false`.\n     *\n     * The neutral curve is wider at both ends, which is what keeps\n     * `text-muted`-on-`surface-3` above AA. Implies the ramp is meant for\n     * surfaces, borders and text rather than for an action color.\n     */\n    neutral?: boolean;\n}\n\n/**\n * Build a ten-step tint scale from a single color.\n *\n * The input color's hue is kept throughout and its chroma sets the intensity of\n * the whole ramp, so a muted brand color yields a muted scale instead of being\n * \"corrected\" into something the brand never approved.\n *\n * @param hex - Any hex color (`#abc` or `#aabbcc`), the intended `500` step.\n * @param mode - `\"light\"` for a light→dark ramp, `\"dark\"` for the inverted ramp\n *   used under `[data-tempest-theme=\"dark\"]`.\n * @param options - See {@link ColorScaleOptions}.\n */\nexport function createColorScale(\n    hex: string,\n    mode: \"light\" | \"dark\" = \"light\",\n    options: ColorScaleOptions = {},\n): ColorScale {\n    const base = hexToOklch(hex);\n    const targets = options.neutral\n        ? mode === \"dark\"\n            ? NEUTRAL_DARK_LIGHTNESS\n            : NEUTRAL_LIGHT_LIGHTNESS\n        : mode === \"dark\"\n          ? DARK_LIGHTNESS\n          : LIGHT_LIGHTNESS;\n    const lightness =\n        options.anchor === false ? targets : anchorLightnessAt500(targets, base.l, mode);\n    const scale = {} as ColorScale;\n\n    for (const step of SCALE_STEPS) {\n        scale[step] = oklchToHex({\n            l: lightness[step],\n            c: base.c * CHROMA_CURVE[step],\n            h: base.h,\n        });\n    }\n\n    return scale;\n}\n\n/** Widest lightness band a generated ramp may span, so both ends stay usable. */\nconst LIGHTNESS_CEILING = 0.985;\nconst LIGHTNESS_FLOOR = 0.12;\n\n/**\n * Re-anchor a lightness ramp so step `500` lands on the brand color exactly.\n *\n * Without this, `500` is forced onto the ramp's own target lightness: a brand\n * `#7c3aed` came back as `#9161fe` — same hue, same chroma, *re-lightened*. It\n * looks fine in isolation and is wrong anyway, because the one color a designer\n * hands over is the one the buttons must actually be.\n *\n * Each half of the ramp is scaled independently around the anchor, so the shape\n * of the original curve survives and the ramp stays monotonic even for a very\n * light brand (yellow) or a very dark one (navy) — those simply get a shorter\n * run on the crowded side.\n *\n * @param targets - The default per-step lightness for this scheme.\n * @param anchor - Lightness of the brand color, used verbatim at step `500`.\n * @param mode - `\"dark\"` inverts which side of the ramp is the light one.\n */\nfunction anchorLightnessAt500(\n    targets: Record<ScaleStep, number>,\n    anchor: number,\n    mode: \"light\" | \"dark\",\n): Record<ScaleStep, number> {\n    const anchored = {} as Record<ScaleStep, number>;\n    const base = targets[500];\n    const lightEnd = mode === \"dark\" ? targets[900] : targets[50];\n    const darkEnd = mode === \"dark\" ? targets[50] : targets[900];\n\n    const top = Math.min(LIGHTNESS_CEILING, Math.max(lightEnd, anchor + 0.05));\n    const bottom = Math.max(LIGHTNESS_FLOOR, Math.min(darkEnd, anchor - 0.05));\n\n    for (const step of SCALE_STEPS) {\n        const target = targets[step];\n        if (target === base) {\n            anchored[step] = anchor;\n        } else if (target > base) {\n            const ratio = (target - base) / (lightEnd - base);\n            anchored[step] = anchor + ratio * (top - anchor);\n        } else {\n            const ratio = (base - target) / (base - darkEnd);\n            anchored[step] = anchor - ratio * (anchor - bottom);\n        }\n    }\n\n    return anchored;\n}\n\n/** WCAG 2.x relative luminance of a hex color. */\nexport function relativeLuminance(hex: string): number {\n    const { r, g, b } = hexToRgb(hex);\n    return 0.2126 * srgbToLinear(r) + 0.7152 * srgbToLinear(g) + 0.0722 * srgbToLinear(b);\n}\n\n/** WCAG 2.x contrast ratio between two hex colors, from `1` to `21`. */\nexport function contrastRatio(a: string, b: string): number {\n    const la = relativeLuminance(a);\n    const lb = relativeLuminance(b);\n    const lighter = Math.max(la, lb);\n    const darker = Math.min(la, lb);\n    return (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * Pick the readable foreground for a background, by contrast ratio.\n *\n * Used for `--tempest-primary-foreground`: a generated brand color can land\n * anywhere on the lightness axis, and hardcoding white would silently produce\n * unreadable buttons for light brands (yellow, lime, cyan).\n */\nexport function readableForeground(\n    background: string,\n    light = \"#ffffff\",\n    dark = \"#101828\",\n): string {\n    return contrastRatio(background, light) >= contrastRatio(background, dark) ? light : dark;\n}\n\n/** Format a hex color as `rgb(r g b / alpha)`, for focus rings and overlays. */\nexport function hexToRgbaString(hex: string, alpha: number): string {\n    const { r, g, b } = hexToRgb(hex);\n    const channel = (value: number): number => Math.round(clamp(value, 0, 1) * 255);\n    return `rgb(${channel(r)} ${channel(g)} ${channel(b)} / ${clamp(alpha, 0, 1)})`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"color.cjs","names":["SCALE_STEPS","LIGHT_LIGHTNESS","NEUTRAL_LIGHT_LIGHTNESS","NEUTRAL_DARK_LIGHTNESS","DARK_LIGHTNESS","CHROMA_CURVE","clamp","max","min","value","normalizeHex","raw","hex","expanded","char","hexToRgb","normalized","rgbToHex","channel","r","g","b","srgbToLinear","linearToSrgb","hexToOklch","lr","lg","lb","long","medium","short","l","a","bAxis","c","hue","oklchToLinearRgb","hRad","h","inGamut","oklchToHex","chroma","color","rgb","i","createColorScale","base","targets","options","mode","lightness","anchorLightnessAt500","scale","step","LIGHTNESS_CEILING","LIGHTNESS_FLOOR","anchored","lightEnd","darkEnd","top","anchor","bottom","target","relativeLuminance","contrastRatio","la","lighter","darker","readableForeground","background","light","dark","hexToRgbaString","alpha"],"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — OKLCH ↔ sRGB with the gamut mapping in between: the\n * transfer function, the LMS matrices, the chroma search that finds the nearest in-\n * gamut colour and the contrast ratio used to check it. Matrices split across files\n * are matrices that get edited one half at a time.\n */\n/**\n * Color math behind {@link createTheme} — OKLab/OKLCH conversions, tint scale\n * generation and WCAG contrast picking.\n *\n * Everything here is pure and dependency-free: the SDK generates brand ramps at\n * runtime in the browser, so a color library would be a disproportionate cost\n * for ~150 lines of well-specified math. OKLCH is used instead of HSL because\n * HSL lightness is not perceptual — an HSL ramp of a yellow and of a blue at the\n * same `L` read as wildly different brightness, which is exactly what breaks a\n * generated palette.\n */\n\n/** A color in the OKLCH space: perceptual lightness, chroma and hue. */\nexport interface Oklch {\n    /** Perceptual lightness, `0` (black) to `1` (white). */\n    l: number;\n    /** Chroma (colorfulness). `0` is gray; sRGB rarely exceeds `~0.37`. */\n    c: number;\n    /** Hue angle in degrees, `0`–`360`. */\n    h: number;\n}\n\n/** The ten steps of a Tempest tint scale, lightest to darkest. */\nexport type ScaleStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\n/** A generated tint scale, keyed by step. */\nexport type ColorScale = Record<ScaleStep, string>;\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\n/**\n * Target lightness per step for a **brand** ramp in light mode.\n *\n * These are the measured OKLCH lightnesses of the hand-written `--tempest-primary-*`\n * scale in `colors.css`, so a generated brand ramp lands in the same visual range\n * as the built-in one instead of merely near it.\n */\nconst LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.966,\n    100: 0.923,\n    200: 0.844,\n    300: 0.743,\n    400: 0.642,\n    500: 0.563,\n    600: 0.48,\n    700: 0.391,\n    800: 0.325,\n    900: 0.251,\n};\n\n/**\n * Target lightness per step for a **neutral** ramp in light mode — measured from\n * the hand-written `--tempest-gray-*` scale.\n *\n * Deliberately **wider** than the brand curve at both ends (`0.982` → `0.210` vs\n * `0.966` → `0.251`): a neutral carries surfaces that must read as near-white and\n * text that must read as near-black, and the pair `text-muted` on `surface-3` has\n * to clear AA. Reusing the brand curve for neutrals is what dropped that pair to\n * 3.5:1 and made the browser axe sweep fail on every generated theme.\n */\nconst NEUTRAL_LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.982,\n    100: 0.963,\n    200: 0.927,\n    300: 0.872,\n    400: 0.71,\n    500: 0.544,\n    600: 0.442,\n    700: 0.369,\n    800: 0.278,\n    900: 0.21,\n};\n\n/**\n * Neutral ramp for dark mode, measured from the `[data-tempest-theme=\"dark\"]`\n * surface/text tokens: `50` is the page background and `900` is text-grade.\n */\nconst NEUTRAL_DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.159,\n    100: 0.205,\n    200: 0.254,\n    300: 0.314,\n    400: 0.381,\n    500: 0.5,\n    600: 0.571,\n    700: 0.762,\n    800: 0.86,\n    900: 0.964,\n};\n\n/**\n * Target lightness for a dark-theme ramp — the ramp is **inverted**: `50` is the\n * darkest tint (a surface) and `900` the lightest (text-grade), matching the\n * `[data-tempest-theme=\"dark\"]` block in `colors.css`.\n */\nconst DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.238,\n    100: 0.288,\n    200: 0.362,\n    300: 0.452,\n    400: 0.544,\n    500: 0.632,\n    600: 0.712,\n    700: 0.788,\n    800: 0.862,\n    900: 0.928,\n};\n\n/**\n * Chroma multiplier per step, relative to the input color's chroma.\n *\n * Peaks around `500`–`600` and falls off at both ends: near-white and near-black\n * tints hold very little chroma before they look muddy or leave the sRGB gamut.\n */\nconst CHROMA_CURVE: Record<ScaleStep, number> = {\n    50: 0.18,\n    100: 0.34,\n    200: 0.6,\n    300: 0.82,\n    400: 0.95,\n    500: 1,\n    600: 0.98,\n    700: 0.88,\n    800: 0.74,\n    900: 0.58,\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n    return Math.min(max, Math.max(min, value));\n}\n\n/** Expand `#abc` to `#aabbcc` and normalize to a lowercase 6-digit hex. */\nfunction normalizeHex(hex: string): string {\n    const raw = hex.trim().replace(/^#/, \"\");\n    const expanded =\n        raw.length === 3 || raw.length === 4\n            ? raw\n                  .slice(0, 3)\n                  .split(\"\")\n                  .map((char) => char + char)\n                  .join(\"\")\n            : raw.slice(0, 6);\n    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {\n        throw new Error(`Invalid hex color: \"${hex}\"`);\n    }\n    return `#${expanded.toLowerCase()}`;\n}\n\n/** Parse a hex color into sRGB channels in the `0`–`1` range. */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } {\n    const normalized = normalizeHex(hex).slice(1);\n    return {\n        r: parseInt(normalized.slice(0, 2), 16) / 255,\n        g: parseInt(normalized.slice(2, 4), 16) / 255,\n        b: parseInt(normalized.slice(4, 6), 16) / 255,\n    };\n}\n\n/** Serialize sRGB channels (`0`–`1`, clamped) back to a `#rrggbb` string. */\nexport function rgbToHex(r: number, g: number, b: number): string {\n    const channel = (value: number): string =>\n        Math.round(clamp(value, 0, 1) * 255)\n            .toString(16)\n            .padStart(2, \"0\");\n    return `#${channel(r)}${channel(g)}${channel(b)}`;\n}\n\nfunction srgbToLinear(channel: number): number {\n    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\nfunction linearToSrgb(channel: number): number {\n    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;\n}\n\n/** Convert a hex color to OKLCH. */\nexport function hexToOklch(hex: string): Oklch {\n    const { r, g, b } = hexToRgb(hex);\n    const lr = srgbToLinear(r);\n    const lg = srgbToLinear(g);\n    const lb = srgbToLinear(b);\n\n    const long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);\n    const medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);\n    const short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);\n\n    const l = 0.2104542553 * long + 0.793617785 * medium - 0.0040720468 * short;\n    const a = 1.9779984951 * long - 2.428592205 * medium + 0.4505937099 * short;\n    const bAxis = 0.0259040371 * long + 0.7827717662 * medium - 0.808675766 * short;\n\n    const c = Math.sqrt(a * a + bAxis * bAxis);\n    const hue = c < 1e-6 ? 0 : (Math.atan2(bAxis, a) * 180) / Math.PI;\n\n    return { l, c, h: hue < 0 ? hue + 360 : hue };\n}\n\n/** Convert OKLCH to linear-light sRGB, without gamut clamping. */\nfunction oklchToLinearRgb({ l, c, h }: Oklch): { r: number; g: number; b: number } {\n    const hRad = (h * Math.PI) / 180;\n    const a = Math.cos(hRad) * c;\n    const bAxis = Math.sin(hRad) * c;\n\n    const long = (l + 0.3963377774 * a + 0.2158037573 * bAxis) ** 3;\n    const medium = (l - 0.1055613458 * a - 0.0638541728 * bAxis) ** 3;\n    const short = (l - 0.0894841775 * a - 1.291485548 * bAxis) ** 3;\n\n    return {\n        r: 4.0767416621 * long - 3.3077115913 * medium + 0.2309699292 * short,\n        g: -1.2684380046 * long + 2.6097574011 * medium - 0.3413193965 * short,\n        b: -0.0041960863 * long - 0.7034186147 * medium + 1.707614701 * short,\n    };\n}\n\nfunction inGamut({ r, g, b }: { r: number; g: number; b: number }): boolean {\n    const epsilon = 1e-4;\n    return (\n        r >= -epsilon &&\n        r <= 1 + epsilon &&\n        g >= -epsilon &&\n        g <= 1 + epsilon &&\n        b >= -epsilon &&\n        b <= 1 + epsilon\n    );\n}\n\n/**\n * Convert OKLCH to a hex color, reducing chroma until the result fits sRGB.\n *\n * Lightness and hue are preserved: desaturating is far less noticeable than\n * shifting either of them, and a naive channel clamp would do both.\n */\nexport function oklchToHex(color: Oklch): string {\n    let chroma = Math.max(0, color.c);\n    let rgb = oklchToLinearRgb({ ...color, c: chroma });\n\n    for (let i = 0; i < 24 && !inGamut(rgb); i += 1) {\n        chroma *= 0.9;\n        rgb = oklchToLinearRgb({ ...color, c: chroma });\n    }\n\n    return rgbToHex(linearToSrgb(rgb.r), linearToSrgb(rgb.g), linearToSrgb(rgb.b));\n}\n\n/** Options for {@link createColorScale}. */\nexport interface ColorScaleOptions {\n    /**\n     * Pin step `500` to the input color's exact lightness. Default `true`.\n     *\n     * Right for a **brand** color: the hex a designer hands over is the one the\n     * buttons must be. Wrong for a **neutral**: nobody checks that `gray-500` is\n     * exactly the input, while everybody notices that a surface stopped being\n     * near-white — anchoring rescales both halves around the input and compresses\n     * exactly the range a neutral needs wide. With `false`, the ramp keeps the\n     * tuned lightness curve and the input only contributes hue and chroma (a warm\n     * or cool neutral, as asked).\n     */\n    anchor?: boolean;\n    /**\n     * Use the neutral lightness curve instead of the brand one. Default `false`.\n     *\n     * The neutral curve is wider at both ends, which is what keeps\n     * `text-muted`-on-`surface-3` above AA. Implies the ramp is meant for\n     * surfaces, borders and text rather than for an action color.\n     */\n    neutral?: boolean;\n}\n\n/**\n * Build a ten-step tint scale from a single color.\n *\n * The input color's hue is kept throughout and its chroma sets the intensity of\n * the whole ramp, so a muted brand color yields a muted scale instead of being\n * \"corrected\" into something the brand never approved.\n *\n * @param hex - Any hex color (`#abc` or `#aabbcc`), the intended `500` step.\n * @param mode - `\"light\"` for a light→dark ramp, `\"dark\"` for the inverted ramp\n *   used under `[data-tempest-theme=\"dark\"]`.\n * @param options - See {@link ColorScaleOptions}.\n */\nexport function createColorScale(\n    hex: string,\n    mode: \"light\" | \"dark\" = \"light\",\n    options: ColorScaleOptions = {},\n): ColorScale {\n    const base = hexToOklch(hex);\n    const targets = options.neutral\n        ? mode === \"dark\"\n            ? NEUTRAL_DARK_LIGHTNESS\n            : NEUTRAL_LIGHT_LIGHTNESS\n        : mode === \"dark\"\n          ? DARK_LIGHTNESS\n          : LIGHT_LIGHTNESS;\n    const lightness =\n        options.anchor === false ? targets : anchorLightnessAt500(targets, base.l, mode);\n    const scale = {} as ColorScale;\n\n    for (const step of SCALE_STEPS) {\n        scale[step] = oklchToHex({\n            l: lightness[step],\n            c: base.c * CHROMA_CURVE[step],\n            h: base.h,\n        });\n    }\n\n    return scale;\n}\n\n/** Widest lightness band a generated ramp may span, so both ends stay usable. */\nconst LIGHTNESS_CEILING = 0.985;\nconst LIGHTNESS_FLOOR = 0.12;\n\n/**\n * Re-anchor a lightness ramp so step `500` lands on the brand color exactly.\n *\n * Without this, `500` is forced onto the ramp's own target lightness: a brand\n * `#7c3aed` came back as `#9161fe` — same hue, same chroma, *re-lightened*. It\n * looks fine in isolation and is wrong anyway, because the one color a designer\n * hands over is the one the buttons must actually be.\n *\n * Each half of the ramp is scaled independently around the anchor, so the shape\n * of the original curve survives and the ramp stays monotonic even for a very\n * light brand (yellow) or a very dark one (navy) — those simply get a shorter\n * run on the crowded side.\n *\n * @param targets - The default per-step lightness for this scheme.\n * @param anchor - Lightness of the brand color, used verbatim at step `500`.\n * @param mode - `\"dark\"` inverts which side of the ramp is the light one.\n */\nfunction anchorLightnessAt500(\n    targets: Record<ScaleStep, number>,\n    anchor: number,\n    mode: \"light\" | \"dark\",\n): Record<ScaleStep, number> {\n    const anchored = {} as Record<ScaleStep, number>;\n    const base = targets[500];\n    const lightEnd = mode === \"dark\" ? targets[900] : targets[50];\n    const darkEnd = mode === \"dark\" ? targets[50] : targets[900];\n\n    const top = Math.min(LIGHTNESS_CEILING, Math.max(lightEnd, anchor + 0.05));\n    const bottom = Math.max(LIGHTNESS_FLOOR, Math.min(darkEnd, anchor - 0.05));\n\n    for (const step of SCALE_STEPS) {\n        const target = targets[step];\n        if (target === base) {\n            anchored[step] = anchor;\n        } else if (target > base) {\n            const ratio = (target - base) / (lightEnd - base);\n            anchored[step] = anchor + ratio * (top - anchor);\n        } else {\n            const ratio = (base - target) / (base - darkEnd);\n            anchored[step] = anchor - ratio * (anchor - bottom);\n        }\n    }\n\n    return anchored;\n}\n\n/** WCAG 2.x relative luminance of a hex color. */\nexport function relativeLuminance(hex: string): number {\n    const { r, g, b } = hexToRgb(hex);\n    return 0.2126 * srgbToLinear(r) + 0.7152 * srgbToLinear(g) + 0.0722 * srgbToLinear(b);\n}\n\n/** WCAG 2.x contrast ratio between two hex colors, from `1` to `21`. */\nexport function contrastRatio(a: string, b: string): number {\n    const la = relativeLuminance(a);\n    const lb = relativeLuminance(b);\n    const lighter = Math.max(la, lb);\n    const darker = Math.min(la, lb);\n    return (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * Pick the readable foreground for a background, by contrast ratio.\n *\n * Used for `--tempest-primary-foreground`: a generated brand color can land\n * anywhere on the lightness axis, and hardcoding white would silently produce\n * unreadable buttons for light brands (yellow, lime, cyan).\n */\nexport function readableForeground(\n    background: string,\n    light = \"#ffffff\",\n    dark = \"#101828\",\n): string {\n    return contrastRatio(background, light) >= contrastRatio(background, dark) ? light : dark;\n}\n\n/** Format a hex color as `rgb(r g b / alpha)`, for focus rings and overlays. */\nexport function hexToRgbaString(hex: string, alpha: number): string {\n    const { r, g, b } = hexToRgb(hex);\n    const channel = (value: number): number => Math.round(clamp(value, 0, 1) * 255);\n    return `rgb(${channel(r)} ${channel(g)} ${channel(b)} / ${clamp(alpha, 0, 1)})`;\n}\n"],"mappings":"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"}

package/dist/theme/color.js.map

@@ -1 +1 @@
-{"version":3,"file":"color.js","names":[],"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — OKLCH ↔ sRGB with the gamut mapping in between: the\n * transfer function, the LMS matrices, the chroma search that finds the nearest in-\n * gamut colour and the contrast ratio used to check it. Matrices split across files\n * are matrices that get edited one half at a time.\n */\n/**\n * Color math behind {@link createTheme} — OKLab/OKLCH conversions, tint scale\n * generation and WCAG contrast picking.\n *\n * Everything here is pure and dependency-free: the SDK generates brand ramps at\n * runtime in the browser, so a color library would be a disproportionate cost\n * for ~150 lines of well-specified math. OKLCH is used instead of HSL because\n * HSL lightness is not perceptual — an HSL ramp of a yellow and of a blue at the\n * same `L` read as wildly different brightness, which is exactly what breaks a\n * generated palette.\n */\n\n/** A color in the OKLCH space: perceptual lightness, chroma and hue. */\nexport interface Oklch {\n    /** Perceptual lightness, `0` (black) to `1` (white). */\n    l: number;\n    /** Chroma (colorfulness). `0` is gray; sRGB rarely exceeds `~0.37`. */\n    c: number;\n    /** Hue angle in degrees, `0`–`360`. */\n    h: number;\n}\n\n/** The ten steps of a Tempest tint scale, lightest to darkest. */\nexport type ScaleStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\n/** A generated tint scale, keyed by step. */\nexport type ColorScale = Record<ScaleStep, string>;\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\n/**\n * Target lightness per step for a **brand** ramp in light mode.\n *\n * These are the measured OKLCH lightnesses of the hand-written `--tempest-primary-*`\n * scale in `colors.css`, so a generated brand ramp lands in the same visual range\n * as the built-in one instead of merely near it.\n */\nconst LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.966,\n    100: 0.923,\n    200: 0.844,\n    300: 0.743,\n    400: 0.642,\n    500: 0.563,\n    600: 0.48,\n    700: 0.391,\n    800: 0.325,\n    900: 0.251,\n};\n\n/**\n * Target lightness per step for a **neutral** ramp in light mode — measured from\n * the hand-written `--tempest-gray-*` scale.\n *\n * Deliberately **wider** than the brand curve at both ends (`0.982` → `0.210` vs\n * `0.966` → `0.251`): a neutral carries surfaces that must read as near-white and\n * text that must read as near-black, and the pair `text-muted` on `surface-3` has\n * to clear AA. Reusing the brand curve for neutrals is what dropped that pair to\n * 3.5:1 and made the browser axe sweep fail on every generated theme.\n */\nconst NEUTRAL_LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.982,\n    100: 0.963,\n    200: 0.927,\n    300: 0.872,\n    400: 0.71,\n    500: 0.544,\n    600: 0.442,\n    700: 0.369,\n    800: 0.278,\n    900: 0.21,\n};\n\n/**\n * Neutral ramp for dark mode, measured from the `[data-tempest-theme=\"dark\"]`\n * surface/text tokens: `50` is the page background and `900` is text-grade.\n */\nconst NEUTRAL_DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.159,\n    100: 0.205,\n    200: 0.254,\n    300: 0.314,\n    400: 0.381,\n    500: 0.5,\n    600: 0.571,\n    700: 0.762,\n    800: 0.86,\n    900: 0.964,\n};\n\n/**\n * Target lightness for a dark-theme ramp — the ramp is **inverted**: `50` is the\n * darkest tint (a surface) and `900` the lightest (text-grade), matching the\n * `[data-tempest-theme=\"dark\"]` block in `colors.css`.\n */\nconst DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.238,\n    100: 0.288,\n    200: 0.362,\n    300: 0.452,\n    400: 0.544,\n    500: 0.632,\n    600: 0.712,\n    700: 0.788,\n    800: 0.862,\n    900: 0.928,\n};\n\n/**\n * Chroma multiplier per step, relative to the input color's chroma.\n *\n * Peaks around `500`–`600` and falls off at both ends: near-white and near-black\n * tints hold very little chroma before they look muddy or leave the sRGB gamut.\n */\nconst CHROMA_CURVE: Record<ScaleStep, number> = {\n    50: 0.18,\n    100: 0.34,\n    200: 0.6,\n    300: 0.82,\n    400: 0.95,\n    500: 1,\n    600: 0.98,\n    700: 0.88,\n    800: 0.74,\n    900: 0.58,\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n    return Math.min(max, Math.max(min, value));\n}\n\n/** Expand `#abc` to `#aabbcc` and normalize to a lowercase 6-digit hex. */\nfunction normalizeHex(hex: string): string {\n    const raw = hex.trim().replace(/^#/, \"\");\n    const expanded =\n        raw.length === 3 || raw.length === 4\n            ? raw\n                  .slice(0, 3)\n                  .split(\"\")\n                  .map((char) => char + char)\n                  .join(\"\")\n            : raw.slice(0, 6);\n    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {\n        throw new Error(`Invalid hex color: \"${hex}\"`);\n    }\n    return `#${expanded.toLowerCase()}`;\n}\n\n/** Parse a hex color into sRGB channels in the `0`–`1` range. */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } {\n    const normalized = normalizeHex(hex).slice(1);\n    return {\n        r: parseInt(normalized.slice(0, 2), 16) / 255,\n        g: parseInt(normalized.slice(2, 4), 16) / 255,\n        b: parseInt(normalized.slice(4, 6), 16) / 255,\n    };\n}\n\n/** Serialize sRGB channels (`0`–`1`, clamped) back to a `#rrggbb` string. */\nexport function rgbToHex(r: number, g: number, b: number): string {\n    const channel = (value: number): string =>\n        Math.round(clamp(value, 0, 1) * 255)\n            .toString(16)\n            .padStart(2, \"0\");\n    return `#${channel(r)}${channel(g)}${channel(b)}`;\n}\n\nfunction srgbToLinear(channel: number): number {\n    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\nfunction linearToSrgb(channel: number): number {\n    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;\n}\n\n/** Convert a hex color to OKLCH. */\nexport function hexToOklch(hex: string): Oklch {\n    const { r, g, b } = hexToRgb(hex);\n    const lr = srgbToLinear(r);\n    const lg = srgbToLinear(g);\n    const lb = srgbToLinear(b);\n\n    const long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);\n    const medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);\n    const short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);\n\n    const l = 0.2104542553 * long + 0.793617785 * medium - 0.0040720468 * short;\n    const a = 1.9779984951 * long - 2.428592205 * medium + 0.4505937099 * short;\n    const bAxis = 0.0259040371 * long + 0.7827717662 * medium - 0.808675766 * short;\n\n    const c = Math.sqrt(a * a + bAxis * bAxis);\n    const hue = c < 1e-6 ? 0 : (Math.atan2(bAxis, a) * 180) / Math.PI;\n\n    return { l, c, h: hue < 0 ? hue + 360 : hue };\n}\n\n/** Convert OKLCH to linear-light sRGB, without gamut clamping. */\nfunction oklchToLinearRgb({ l, c, h }: Oklch): { r: number; g: number; b: number } {\n    const hRad = (h * Math.PI) / 180;\n    const a = Math.cos(hRad) * c;\n    const bAxis = Math.sin(hRad) * c;\n\n    const long = (l + 0.3963377774 * a + 0.2158037573 * bAxis) ** 3;\n    const medium = (l - 0.1055613458 * a - 0.0638541728 * bAxis) ** 3;\n    const short = (l - 0.0894841775 * a - 1.291485548 * bAxis) ** 3;\n\n    return {\n        r: 4.0767416621 * long - 3.3077115913 * medium + 0.2309699292 * short,\n        g: -1.2684380046 * long + 2.6097574011 * medium - 0.3413193965 * short,\n        b: -0.0041960863 * long - 0.7034186147 * medium + 1.707614701 * short,\n    };\n}\n\nfunction inGamut({ r, g, b }: { r: number; g: number; b: number }): boolean {\n    const epsilon = 1e-4;\n    return (\n        r >= -epsilon &&\n        r <= 1 + epsilon &&\n        g >= -epsilon &&\n        g <= 1 + epsilon &&\n        b >= -epsilon &&\n        b <= 1 + epsilon\n    );\n}\n\n/**\n * Convert OKLCH to a hex color, reducing chroma until the result fits sRGB.\n *\n * Lightness and hue are preserved: desaturating is far less noticeable than\n * shifting either of them, and a naive channel clamp would do both.\n */\nexport function oklchToHex(color: Oklch): string {\n    let chroma = Math.max(0, color.c);\n    let rgb = oklchToLinearRgb({ ...color, c: chroma });\n\n    for (let i = 0; i < 24 && !inGamut(rgb); i += 1) {\n        chroma *= 0.9;\n        rgb = oklchToLinearRgb({ ...color, c: chroma });\n    }\n\n    return rgbToHex(linearToSrgb(rgb.r), linearToSrgb(rgb.g), linearToSrgb(rgb.b));\n}\n\n/** Options for {@link createColorScale}. */\nexport interface ColorScaleOptions {\n    /**\n     * Pin step `500` to the input color's exact lightness. Default `true`.\n     *\n     * Right for a **brand** color: the hex a designer hands over is the one the\n     * buttons must be. Wrong for a **neutral**: nobody checks that `gray-500` is\n     * exactly the input, while everybody notices that a surface stopped being\n     * near-white — anchoring rescales both halves around the input and compresses\n     * exactly the range a neutral needs wide. With `false`, the ramp keeps the\n     * tuned lightness curve and the input only contributes hue and chroma (a warm\n     * or cool neutral, as asked).\n     */\n    anchor?: boolean;\n    /**\n     * Use the neutral lightness curve instead of the brand one. Default `false`.\n     *\n     * The neutral curve is wider at both ends, which is what keeps\n     * `text-muted`-on-`surface-3` above AA. Implies the ramp is meant for\n     * surfaces, borders and text rather than for an action color.\n     */\n    neutral?: boolean;\n}\n\n/**\n * Build a ten-step tint scale from a single color.\n *\n * The input color's hue is kept throughout and its chroma sets the intensity of\n * the whole ramp, so a muted brand color yields a muted scale instead of being\n * \"corrected\" into something the brand never approved.\n *\n * @param hex - Any hex color (`#abc` or `#aabbcc`), the intended `500` step.\n * @param mode - `\"light\"` for a light→dark ramp, `\"dark\"` for the inverted ramp\n *   used under `[data-tempest-theme=\"dark\"]`.\n * @param options - See {@link ColorScaleOptions}.\n */\nexport function createColorScale(\n    hex: string,\n    mode: \"light\" | \"dark\" = \"light\",\n    options: ColorScaleOptions = {},\n): ColorScale {\n    const base = hexToOklch(hex);\n    const targets = options.neutral\n        ? mode === \"dark\"\n            ? NEUTRAL_DARK_LIGHTNESS\n            : NEUTRAL_LIGHT_LIGHTNESS\n        : mode === \"dark\"\n          ? DARK_LIGHTNESS\n          : LIGHT_LIGHTNESS;\n    const lightness =\n        options.anchor === false ? targets : anchorLightnessAt500(targets, base.l, mode);\n    const scale = {} as ColorScale;\n\n    for (const step of SCALE_STEPS) {\n        scale[step] = oklchToHex({\n            l: lightness[step],\n            c: base.c * CHROMA_CURVE[step],\n            h: base.h,\n        });\n    }\n\n    return scale;\n}\n\n/** Widest lightness band a generated ramp may span, so both ends stay usable. */\nconst LIGHTNESS_CEILING = 0.985;\nconst LIGHTNESS_FLOOR = 0.12;\n\n/**\n * Re-anchor a lightness ramp so step `500` lands on the brand color exactly.\n *\n * Without this, `500` is forced onto the ramp's own target lightness: a brand\n * `#7c3aed` came back as `#9161fe` — same hue, same chroma, *re-lightened*. It\n * looks fine in isolation and is wrong anyway, because the one color a designer\n * hands over is the one the buttons must actually be.\n *\n * Each half of the ramp is scaled independently around the anchor, so the shape\n * of the original curve survives and the ramp stays monotonic even for a very\n * light brand (yellow) or a very dark one (navy) — those simply get a shorter\n * run on the crowded side.\n *\n * @param targets - The default per-step lightness for this scheme.\n * @param anchor - Lightness of the brand color, used verbatim at step `500`.\n * @param mode - `\"dark\"` inverts which side of the ramp is the light one.\n */\nfunction anchorLightnessAt500(\n    targets: Record<ScaleStep, number>,\n    anchor: number,\n    mode: \"light\" | \"dark\",\n): Record<ScaleStep, number> {\n    const anchored = {} as Record<ScaleStep, number>;\n    const base = targets[500];\n    const lightEnd = mode === \"dark\" ? targets[900] : targets[50];\n    const darkEnd = mode === \"dark\" ? targets[50] : targets[900];\n\n    const top = Math.min(LIGHTNESS_CEILING, Math.max(lightEnd, anchor + 0.05));\n    const bottom = Math.max(LIGHTNESS_FLOOR, Math.min(darkEnd, anchor - 0.05));\n\n    for (const step of SCALE_STEPS) {\n        const target = targets[step];\n        if (target === base) {\n            anchored[step] = anchor;\n        } else if (target > base) {\n            const ratio = (target - base) / (lightEnd - base);\n            anchored[step] = anchor + ratio * (top - anchor);\n        } else {\n            const ratio = (base - target) / (base - darkEnd);\n            anchored[step] = anchor - ratio * (anchor - bottom);\n        }\n    }\n\n    return anchored;\n}\n\n/** WCAG 2.x relative luminance of a hex color. */\nexport function relativeLuminance(hex: string): number {\n    const { r, g, b } = hexToRgb(hex);\n    return 0.2126 * srgbToLinear(r) + 0.7152 * srgbToLinear(g) + 0.0722 * srgbToLinear(b);\n}\n\n/** WCAG 2.x contrast ratio between two hex colors, from `1` to `21`. */\nexport function contrastRatio(a: string, b: string): number {\n    const la = relativeLuminance(a);\n    const lb = relativeLuminance(b);\n    const lighter = Math.max(la, lb);\n    const darker = Math.min(la, lb);\n    return (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * Pick the readable foreground for a background, by contrast ratio.\n *\n * Used for `--tempest-primary-foreground`: a generated brand color can land\n * anywhere on the lightness axis, and hardcoding white would silently produce\n * unreadable buttons for light brands (yellow, lime, cyan).\n */\nexport function readableForeground(\n    background: string,\n    light = \"#ffffff\",\n    dark = \"#101828\",\n): string {\n    return contrastRatio(background, light) >= contrastRatio(background, dark) ? light : dark;\n}\n\n/** Format a hex color as `rgb(r g b / alpha)`, for focus rings and overlays. */\nexport function hexToRgbaString(hex: string, alpha: number): string {\n    const { r, g, b } = hexToRgb(hex);\n    const channel = (value: number): number => Math.round(clamp(value, 0, 1) * 255);\n    return `rgb(${channel(r)} ${channel(g)} ${channel(b)} / ${clamp(alpha, 0, 1)})`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"color.js","names":["SCALE_STEPS","LIGHT_LIGHTNESS","NEUTRAL_LIGHT_LIGHTNESS","NEUTRAL_DARK_LIGHTNESS","DARK_LIGHTNESS","CHROMA_CURVE","clamp","max","min","value","normalizeHex","raw","hex","expanded","char","hexToRgb","normalized","rgbToHex","channel","r","g","b","srgbToLinear","linearToSrgb","hexToOklch","lr","lg","lb","long","medium","short","l","a","bAxis","c","hue","oklchToLinearRgb","hRad","h","inGamut","oklchToHex","chroma","color","rgb","i","createColorScale","base","targets","options","mode","lightness","anchorLightnessAt500","scale","step","LIGHTNESS_CEILING","LIGHTNESS_FLOOR","anchored","lightEnd","darkEnd","top","anchor","bottom","target","relativeLuminance","contrastRatio","la","lighter","darker","readableForeground","background","light","dark","hexToRgbaString","alpha"],"sources":["../../src/theme/color.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — OKLCH ↔ sRGB with the gamut mapping in between: the\n * transfer function, the LMS matrices, the chroma search that finds the nearest in-\n * gamut colour and the contrast ratio used to check it. Matrices split across files\n * are matrices that get edited one half at a time.\n */\n/**\n * Color math behind {@link createTheme} — OKLab/OKLCH conversions, tint scale\n * generation and WCAG contrast picking.\n *\n * Everything here is pure and dependency-free: the SDK generates brand ramps at\n * runtime in the browser, so a color library would be a disproportionate cost\n * for ~150 lines of well-specified math. OKLCH is used instead of HSL because\n * HSL lightness is not perceptual — an HSL ramp of a yellow and of a blue at the\n * same `L` read as wildly different brightness, which is exactly what breaks a\n * generated palette.\n */\n\n/** A color in the OKLCH space: perceptual lightness, chroma and hue. */\nexport interface Oklch {\n    /** Perceptual lightness, `0` (black) to `1` (white). */\n    l: number;\n    /** Chroma (colorfulness). `0` is gray; sRGB rarely exceeds `~0.37`. */\n    c: number;\n    /** Hue angle in degrees, `0`–`360`. */\n    h: number;\n}\n\n/** The ten steps of a Tempest tint scale, lightest to darkest. */\nexport type ScaleStep = 50 | 100 | 200 | 300 | 400 | 500 | 600 | 700 | 800 | 900;\n\n/** A generated tint scale, keyed by step. */\nexport type ColorScale = Record<ScaleStep, string>;\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\n/**\n * Target lightness per step for a **brand** ramp in light mode.\n *\n * These are the measured OKLCH lightnesses of the hand-written `--tempest-primary-*`\n * scale in `colors.css`, so a generated brand ramp lands in the same visual range\n * as the built-in one instead of merely near it.\n */\nconst LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.966,\n    100: 0.923,\n    200: 0.844,\n    300: 0.743,\n    400: 0.642,\n    500: 0.563,\n    600: 0.48,\n    700: 0.391,\n    800: 0.325,\n    900: 0.251,\n};\n\n/**\n * Target lightness per step for a **neutral** ramp in light mode — measured from\n * the hand-written `--tempest-gray-*` scale.\n *\n * Deliberately **wider** than the brand curve at both ends (`0.982` → `0.210` vs\n * `0.966` → `0.251`): a neutral carries surfaces that must read as near-white and\n * text that must read as near-black, and the pair `text-muted` on `surface-3` has\n * to clear AA. Reusing the brand curve for neutrals is what dropped that pair to\n * 3.5:1 and made the browser axe sweep fail on every generated theme.\n */\nconst NEUTRAL_LIGHT_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.982,\n    100: 0.963,\n    200: 0.927,\n    300: 0.872,\n    400: 0.71,\n    500: 0.544,\n    600: 0.442,\n    700: 0.369,\n    800: 0.278,\n    900: 0.21,\n};\n\n/**\n * Neutral ramp for dark mode, measured from the `[data-tempest-theme=\"dark\"]`\n * surface/text tokens: `50` is the page background and `900` is text-grade.\n */\nconst NEUTRAL_DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.159,\n    100: 0.205,\n    200: 0.254,\n    300: 0.314,\n    400: 0.381,\n    500: 0.5,\n    600: 0.571,\n    700: 0.762,\n    800: 0.86,\n    900: 0.964,\n};\n\n/**\n * Target lightness for a dark-theme ramp — the ramp is **inverted**: `50` is the\n * darkest tint (a surface) and `900` the lightest (text-grade), matching the\n * `[data-tempest-theme=\"dark\"]` block in `colors.css`.\n */\nconst DARK_LIGHTNESS: Record<ScaleStep, number> = {\n    50: 0.238,\n    100: 0.288,\n    200: 0.362,\n    300: 0.452,\n    400: 0.544,\n    500: 0.632,\n    600: 0.712,\n    700: 0.788,\n    800: 0.862,\n    900: 0.928,\n};\n\n/**\n * Chroma multiplier per step, relative to the input color's chroma.\n *\n * Peaks around `500`–`600` and falls off at both ends: near-white and near-black\n * tints hold very little chroma before they look muddy or leave the sRGB gamut.\n */\nconst CHROMA_CURVE: Record<ScaleStep, number> = {\n    50: 0.18,\n    100: 0.34,\n    200: 0.6,\n    300: 0.82,\n    400: 0.95,\n    500: 1,\n    600: 0.98,\n    700: 0.88,\n    800: 0.74,\n    900: 0.58,\n};\n\nfunction clamp(value: number, min: number, max: number): number {\n    return Math.min(max, Math.max(min, value));\n}\n\n/** Expand `#abc` to `#aabbcc` and normalize to a lowercase 6-digit hex. */\nfunction normalizeHex(hex: string): string {\n    const raw = hex.trim().replace(/^#/, \"\");\n    const expanded =\n        raw.length === 3 || raw.length === 4\n            ? raw\n                  .slice(0, 3)\n                  .split(\"\")\n                  .map((char) => char + char)\n                  .join(\"\")\n            : raw.slice(0, 6);\n    if (!/^[0-9a-fA-F]{6}$/.test(expanded)) {\n        throw new Error(`Invalid hex color: \"${hex}\"`);\n    }\n    return `#${expanded.toLowerCase()}`;\n}\n\n/** Parse a hex color into sRGB channels in the `0`–`1` range. */\nexport function hexToRgb(hex: string): { r: number; g: number; b: number } {\n    const normalized = normalizeHex(hex).slice(1);\n    return {\n        r: parseInt(normalized.slice(0, 2), 16) / 255,\n        g: parseInt(normalized.slice(2, 4), 16) / 255,\n        b: parseInt(normalized.slice(4, 6), 16) / 255,\n    };\n}\n\n/** Serialize sRGB channels (`0`–`1`, clamped) back to a `#rrggbb` string. */\nexport function rgbToHex(r: number, g: number, b: number): string {\n    const channel = (value: number): string =>\n        Math.round(clamp(value, 0, 1) * 255)\n            .toString(16)\n            .padStart(2, \"0\");\n    return `#${channel(r)}${channel(g)}${channel(b)}`;\n}\n\nfunction srgbToLinear(channel: number): number {\n    return channel <= 0.04045 ? channel / 12.92 : Math.pow((channel + 0.055) / 1.055, 2.4);\n}\n\nfunction linearToSrgb(channel: number): number {\n    return channel <= 0.0031308 ? channel * 12.92 : 1.055 * Math.pow(channel, 1 / 2.4) - 0.055;\n}\n\n/** Convert a hex color to OKLCH. */\nexport function hexToOklch(hex: string): Oklch {\n    const { r, g, b } = hexToRgb(hex);\n    const lr = srgbToLinear(r);\n    const lg = srgbToLinear(g);\n    const lb = srgbToLinear(b);\n\n    const long = Math.cbrt(0.4122214708 * lr + 0.5363325363 * lg + 0.0514459929 * lb);\n    const medium = Math.cbrt(0.2119034982 * lr + 0.6806995451 * lg + 0.1073969566 * lb);\n    const short = Math.cbrt(0.0883024619 * lr + 0.2817188376 * lg + 0.6299787005 * lb);\n\n    const l = 0.2104542553 * long + 0.793617785 * medium - 0.0040720468 * short;\n    const a = 1.9779984951 * long - 2.428592205 * medium + 0.4505937099 * short;\n    const bAxis = 0.0259040371 * long + 0.7827717662 * medium - 0.808675766 * short;\n\n    const c = Math.sqrt(a * a + bAxis * bAxis);\n    const hue = c < 1e-6 ? 0 : (Math.atan2(bAxis, a) * 180) / Math.PI;\n\n    return { l, c, h: hue < 0 ? hue + 360 : hue };\n}\n\n/** Convert OKLCH to linear-light sRGB, without gamut clamping. */\nfunction oklchToLinearRgb({ l, c, h }: Oklch): { r: number; g: number; b: number } {\n    const hRad = (h * Math.PI) / 180;\n    const a = Math.cos(hRad) * c;\n    const bAxis = Math.sin(hRad) * c;\n\n    const long = (l + 0.3963377774 * a + 0.2158037573 * bAxis) ** 3;\n    const medium = (l - 0.1055613458 * a - 0.0638541728 * bAxis) ** 3;\n    const short = (l - 0.0894841775 * a - 1.291485548 * bAxis) ** 3;\n\n    return {\n        r: 4.0767416621 * long - 3.3077115913 * medium + 0.2309699292 * short,\n        g: -1.2684380046 * long + 2.6097574011 * medium - 0.3413193965 * short,\n        b: -0.0041960863 * long - 0.7034186147 * medium + 1.707614701 * short,\n    };\n}\n\nfunction inGamut({ r, g, b }: { r: number; g: number; b: number }): boolean {\n    const epsilon = 1e-4;\n    return (\n        r >= -epsilon &&\n        r <= 1 + epsilon &&\n        g >= -epsilon &&\n        g <= 1 + epsilon &&\n        b >= -epsilon &&\n        b <= 1 + epsilon\n    );\n}\n\n/**\n * Convert OKLCH to a hex color, reducing chroma until the result fits sRGB.\n *\n * Lightness and hue are preserved: desaturating is far less noticeable than\n * shifting either of them, and a naive channel clamp would do both.\n */\nexport function oklchToHex(color: Oklch): string {\n    let chroma = Math.max(0, color.c);\n    let rgb = oklchToLinearRgb({ ...color, c: chroma });\n\n    for (let i = 0; i < 24 && !inGamut(rgb); i += 1) {\n        chroma *= 0.9;\n        rgb = oklchToLinearRgb({ ...color, c: chroma });\n    }\n\n    return rgbToHex(linearToSrgb(rgb.r), linearToSrgb(rgb.g), linearToSrgb(rgb.b));\n}\n\n/** Options for {@link createColorScale}. */\nexport interface ColorScaleOptions {\n    /**\n     * Pin step `500` to the input color's exact lightness. Default `true`.\n     *\n     * Right for a **brand** color: the hex a designer hands over is the one the\n     * buttons must be. Wrong for a **neutral**: nobody checks that `gray-500` is\n     * exactly the input, while everybody notices that a surface stopped being\n     * near-white — anchoring rescales both halves around the input and compresses\n     * exactly the range a neutral needs wide. With `false`, the ramp keeps the\n     * tuned lightness curve and the input only contributes hue and chroma (a warm\n     * or cool neutral, as asked).\n     */\n    anchor?: boolean;\n    /**\n     * Use the neutral lightness curve instead of the brand one. Default `false`.\n     *\n     * The neutral curve is wider at both ends, which is what keeps\n     * `text-muted`-on-`surface-3` above AA. Implies the ramp is meant for\n     * surfaces, borders and text rather than for an action color.\n     */\n    neutral?: boolean;\n}\n\n/**\n * Build a ten-step tint scale from a single color.\n *\n * The input color's hue is kept throughout and its chroma sets the intensity of\n * the whole ramp, so a muted brand color yields a muted scale instead of being\n * \"corrected\" into something the brand never approved.\n *\n * @param hex - Any hex color (`#abc` or `#aabbcc`), the intended `500` step.\n * @param mode - `\"light\"` for a light→dark ramp, `\"dark\"` for the inverted ramp\n *   used under `[data-tempest-theme=\"dark\"]`.\n * @param options - See {@link ColorScaleOptions}.\n */\nexport function createColorScale(\n    hex: string,\n    mode: \"light\" | \"dark\" = \"light\",\n    options: ColorScaleOptions = {},\n): ColorScale {\n    const base = hexToOklch(hex);\n    const targets = options.neutral\n        ? mode === \"dark\"\n            ? NEUTRAL_DARK_LIGHTNESS\n            : NEUTRAL_LIGHT_LIGHTNESS\n        : mode === \"dark\"\n          ? DARK_LIGHTNESS\n          : LIGHT_LIGHTNESS;\n    const lightness =\n        options.anchor === false ? targets : anchorLightnessAt500(targets, base.l, mode);\n    const scale = {} as ColorScale;\n\n    for (const step of SCALE_STEPS) {\n        scale[step] = oklchToHex({\n            l: lightness[step],\n            c: base.c * CHROMA_CURVE[step],\n            h: base.h,\n        });\n    }\n\n    return scale;\n}\n\n/** Widest lightness band a generated ramp may span, so both ends stay usable. */\nconst LIGHTNESS_CEILING = 0.985;\nconst LIGHTNESS_FLOOR = 0.12;\n\n/**\n * Re-anchor a lightness ramp so step `500` lands on the brand color exactly.\n *\n * Without this, `500` is forced onto the ramp's own target lightness: a brand\n * `#7c3aed` came back as `#9161fe` — same hue, same chroma, *re-lightened*. It\n * looks fine in isolation and is wrong anyway, because the one color a designer\n * hands over is the one the buttons must actually be.\n *\n * Each half of the ramp is scaled independently around the anchor, so the shape\n * of the original curve survives and the ramp stays monotonic even for a very\n * light brand (yellow) or a very dark one (navy) — those simply get a shorter\n * run on the crowded side.\n *\n * @param targets - The default per-step lightness for this scheme.\n * @param anchor - Lightness of the brand color, used verbatim at step `500`.\n * @param mode - `\"dark\"` inverts which side of the ramp is the light one.\n */\nfunction anchorLightnessAt500(\n    targets: Record<ScaleStep, number>,\n    anchor: number,\n    mode: \"light\" | \"dark\",\n): Record<ScaleStep, number> {\n    const anchored = {} as Record<ScaleStep, number>;\n    const base = targets[500];\n    const lightEnd = mode === \"dark\" ? targets[900] : targets[50];\n    const darkEnd = mode === \"dark\" ? targets[50] : targets[900];\n\n    const top = Math.min(LIGHTNESS_CEILING, Math.max(lightEnd, anchor + 0.05));\n    const bottom = Math.max(LIGHTNESS_FLOOR, Math.min(darkEnd, anchor - 0.05));\n\n    for (const step of SCALE_STEPS) {\n        const target = targets[step];\n        if (target === base) {\n            anchored[step] = anchor;\n        } else if (target > base) {\n            const ratio = (target - base) / (lightEnd - base);\n            anchored[step] = anchor + ratio * (top - anchor);\n        } else {\n            const ratio = (base - target) / (base - darkEnd);\n            anchored[step] = anchor - ratio * (anchor - bottom);\n        }\n    }\n\n    return anchored;\n}\n\n/** WCAG 2.x relative luminance of a hex color. */\nexport function relativeLuminance(hex: string): number {\n    const { r, g, b } = hexToRgb(hex);\n    return 0.2126 * srgbToLinear(r) + 0.7152 * srgbToLinear(g) + 0.0722 * srgbToLinear(b);\n}\n\n/** WCAG 2.x contrast ratio between two hex colors, from `1` to `21`. */\nexport function contrastRatio(a: string, b: string): number {\n    const la = relativeLuminance(a);\n    const lb = relativeLuminance(b);\n    const lighter = Math.max(la, lb);\n    const darker = Math.min(la, lb);\n    return (lighter + 0.05) / (darker + 0.05);\n}\n\n/**\n * Pick the readable foreground for a background, by contrast ratio.\n *\n * Used for `--tempest-primary-foreground`: a generated brand color can land\n * anywhere on the lightness axis, and hardcoding white would silently produce\n * unreadable buttons for light brands (yellow, lime, cyan).\n */\nexport function readableForeground(\n    background: string,\n    light = \"#ffffff\",\n    dark = \"#101828\",\n): string {\n    return contrastRatio(background, light) >= contrastRatio(background, dark) ? light : dark;\n}\n\n/** Format a hex color as `rgb(r g b / alpha)`, for focus rings and overlays. */\nexport function hexToRgbaString(hex: string, alpha: number): string {\n    const { r, g, b } = hexToRgb(hex);\n    const channel = (value: number): number => Math.round(clamp(value, 0, 1) * 255);\n    return `rgb(${channel(r)} ${channel(g)} ${channel(b)} / ${clamp(alpha, 0, 1)})`;\n}\n"],"mappings":"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"}

package/dist/theme/create-theme.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-theme.cjs","names":[],"sources":["../../src/theme/create-theme.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — one pass that emits the whole token set — surfaces,\n * text, borders, states, the chart ramps — for both modes, with every value checked\n * against the surface it will sit on. The checks are what make the length: each\n * token is derived and then verified against the same background table.\n */\n/**\n * Theme factory: turns a handful of brand colors into the full set of\n * `--tempest-*` token overrides, for both light and dark.\n *\n * Rebranding used to mean hand-writing ~167 custom properties (and getting the\n * dark ramp inversion right by hand). `createTheme({ primary: \"#7c3aed\" })`\n * emits the same thing, derived in OKLCH so the ramp stays perceptually even.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToRgbaString,\n    readableForeground,\n    type ColorScale,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport {\n    INVERSE_SELECTOR,\n    renderInverseSurface,\n    type InverseSurfaceGenerator,\n} from \"./inverse-render\";\nimport { ON_SOLID_INK, THEME_STATUSES, writeStatus } from \"./status-tokens\";\n\n/** Radius presets, applied to the whole `--tempest-radius-*` family at once. */\nexport type ThemeRadius = \"none\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"full\";\n\nexport type { ThemeStatus } from \"./status-tokens\";\n\n/** Input for {@link createTheme}. Every field is optional — omitted families keep the built-in tokens. */\nexport interface CreateThemeOptions {\n    /** Brand color, used as the `500` step of the primary scale. */\n    primary?: string;\n    /** Neutral color, used as the `500` step of the gray scale (surfaces, borders, text). */\n    gray?: string;\n    /** Success color (`--tempest-success*`). */\n    success?: string;\n    /** Warning color (`--tempest-warning*`). */\n    warning?: string;\n    /** Danger color (`--tempest-danger*`). */\n    danger?: string;\n    /** Info color (`--tempest-info*`). */\n    info?: string;\n    /**\n     * Categorical series colors for `tempest-react-sdk/charts`, in cycle order.\n     * Written to `--tempest-chart-1` … `--tempest-chart-N`, so charts follow the\n     * theme instead of a hardcoded palette.\n     */\n    chart?: string[];\n    /** Corner radius scale. A preset name, or explicit per-step values. */\n    radius?: ThemeRadius | Partial<Record<\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", string>>;\n    /**\n     * Opacity of `--tempest-focus-ring-color`. Omit it — the default ring is opaque.\n     *\n     * A translucent ring has no contrast of its own; it has the contrast of\n     * whatever it composites over. Passing a value below `1` reintroduces the\n     * failure 0.61.0 fixed in the built-in tokens, and logs a warning in a\n     * development build. Kept because a translucent ring over a background you\n     * control is a legitimate choice.\n     */\n    focusRingAlpha?: number;\n    /** Selector the light tokens are written under. Default `\":root\"`. */\n    selector?: string;\n    /** Selector the dark tokens are written under. Default `'[data-tempest-theme=\"dark\"]'`. */\n    darkSelector?: string;\n    /**\n     * Also emit the inverse surface — the token set for a section painted in the\n     * brand color — by passing its generator, `createInverseSurface`. Off by\n     * default; ignored without `primary`.\n     *\n     * The generator is passed in rather than switched on with `true` so that\n     * `createTheme` never imports it: an app that does not paint a section in\n     * its brand does not ship the 1.68 kB brotli it costs.\n     *\n     * @example\n     * ```ts\n     * import { createInverseSurface, createTheme } from \"tempest-react-sdk\";\n     *\n     * createTheme({ primary: \"#03184b\", inverse: createInverseSurface });\n     * ```\n     */\n    inverse?: InverseSurfaceGenerator;\n    /** Selector the inverse tokens are written under. Default `'[data-tempest-tone=\"inverse\"]'`. */\n    inverseSelector?: string;\n}\n\n/** A generated theme: token maps per color scheme, plus the CSS text that carries them. */\nexport interface GeneratedTheme {\n    /** Light-scheme custom properties, without the leading `--`-less names (keys include `--`). */\n    light: Record<string, string>;\n    /** Dark-scheme custom properties. */\n    dark: Record<string, string>;\n    /**\n     * Inverse-surface custom properties — literal colors, identical under the\n     * light and the dark page scheme. Present only when the theme names a\n     * `primary` and passes `inverse`.\n     */\n    inverse?: Record<string, string>;\n    /** Both blocks rendered as CSS, ready for {@link applyTheme} or a stylesheet. */\n    css: string;\n}\n\nconst RADIUS_PRESETS: Record<ThemeRadius, Record<string, string>> = {\n    none: { xs: \"0\", sm: \"0\", md: \"0\", lg: \"0\", xl: \"0\", \"2xl\": \"0\" },\n    sm: { xs: \"1px\", sm: \"2px\", md: \"4px\", lg: \"6px\", xl: \"8px\", \"2xl\": \"12px\" },\n    md: { xs: \"2px\", sm: \"4px\", md: \"8px\", lg: \"12px\", xl: \"16px\", \"2xl\": \"24px\" },\n    lg: { xs: \"4px\", sm: \"6px\", md: \"12px\", lg: \"16px\", xl: \"22px\", \"2xl\": \"32px\" },\n    xl: { xs: \"6px\", sm: \"10px\", md: \"16px\", lg: \"24px\", xl: \"32px\", \"2xl\": \"44px\" },\n    full: { xs: \"4px\", sm: \"8px\", md: \"9999px\", lg: \"9999px\", xl: \"9999px\", \"2xl\": \"9999px\" },\n};\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\nfunction writeScale(tokens: Record<string, string>, name: string, scale: ColorScale): void {\n    for (const step of SCALE_STEPS) {\n        tokens[`--tempest-${name}-${step}`] = scale[step];\n    }\n}\n\n/** Minimum contrast for body text, WCAG 2.x AA. */\nconst AA_TEXT_CONTRAST = 4.5;\n\n/**\n * Choose the ramp step for text sitting on the soft tint.\n *\n * A fixed step does not survive an arbitrary brand color: the built-in blue only\n * reaches 4.37:1 at `500` over its own `50` tint, and a generated emerald lands\n * at 4.41:1 at `600` — both fail AA for body text by a hair. So the step is\n * picked by measuring, walking away from the tint until it clears AA, and\n * falling back to the most extreme candidate when even that cannot (a very light\n * or very desaturated brand).\n *\n * @param scale - The generated ramp.\n * @param softStep - Step used as `--tempest-primary-soft`.\n * @param candidates - Steps to try, in order of preference.\n * @returns The first candidate clearing {@link AA_TEXT_CONTRAST}, else the last.\n */\nfunction pickOnSoftStep(\n    scale: ColorScale,\n    softStep: ScaleStep,\n    candidates: ScaleStep[],\n): ScaleStep {\n    for (const step of candidates) {\n        if (contrastRatio(scale[softStep], scale[step]) >= AA_TEXT_CONTRAST) return step;\n    }\n    return candidates[candidates.length - 1];\n}\n\n/** Minimum contrast for a non-text indicator, WCAG 2.2 SC 1.4.11. */\nconst INDICATOR_CONTRAST = 3;\n\n/**\n * The four surfaces a focus ring can land on, as the SDK's own `colors.css`\n * paints them.\n *\n * Ported from `src/styles/colors.css` (`--tempest-bg`, `--tempest-surface`,\n * `--tempest-surface-2`, `--tempest-surface-3`, resolved through the gray ramp),\n * and pinned by a test that reads that file — a theme that only names `primary`\n * keeps these, so the ring has to be measured against them and not against a\n * guess. The light values resolve through `--tempest-gray-50/100/200`; the dark\n * ones are literals in the dark block.\n */\nconst SDK_SURFACES: Record<\"light\" | \"dark\", readonly string[]> = {\n    light: [\"#ffffff\", \"#f8f9fb\", \"#f1f3f6\", \"#e4e7ec\"],\n    dark: [\"#0b0d12\", \"#14171f\", \"#1d2230\", \"#262d3f\"],\n};\n\n/**\n * Ramp steps to try for the focus ring, in order.\n *\n * `500` first, because the ring should read as the brand when it can, then up\n * the ramp — which moves away from the surfaces in **both** schemes, because\n * `createColorScale` inverts the dark ramp: there `50` is the darkest step (it\n * is what `--tempest-bg` is made of) and `900` the lightest. Walking down in\n * dark mode looks like the right inversion and is the wrong direction; measured,\n * it left a near-black brand's ring at 1.04:1 over its own background.\n */\nconst FOCUS_RING_CANDIDATES: readonly ScaleStep[] = [500, 600, 700, 800, 900];\n\n/**\n * Choose the ramp step for the focus ring, by measuring it against the surfaces\n * it will actually be drawn on.\n *\n * A fixed step does not survive an arbitrary brand, and the measurement says so\n * loudly: of twelve brands checked against the four surfaces in both schemes —\n * 96 pairings — `500` opaque clears 3:1 in 58 of them, and `500` at the old\n * default alpha of 0.35 in 3. Picking the step by measurement clears all 96. The\n * brand from the report that opened this\n * (`#8100D7`) passes in light at 7.20:1 and fails in **dark** at 2.70:1 down to\n * 1.91:1 on `surface-3`; a yellow fails in light at 1.43:1. So the step is\n * picked the way {@link pickOnSoftStep} picks text on a tint: walk away from the\n * surfaces until the ring clears the floor against *all* of them.\n *\n * The fallback is the candidate with the best worst case rather than the last\n * one, because \"the most extreme step\" is not always the most contrasting one\n * once a brand is near-neutral.\n *\n * @param scale - The generated ramp.\n * @param surfaces - The four surfaces this theme will paint, opaque hex.\n * @returns The first candidate clearing {@link INDICATOR_CONTRAST} on every\n *   surface, else the candidate whose weakest pairing is strongest.\n */\nfunction pickFocusRingStep(scale: ColorScale, surfaces: readonly string[]): ScaleStep {\n    const worstCase = (step: ScaleStep): number =>\n        Math.min(...surfaces.map((surface) => contrastRatio(scale[step], surface)));\n    let best: ScaleStep = FOCUS_RING_CANDIDATES[0] as ScaleStep;\n    let bestRatio = -1;\n    for (const step of FOCUS_RING_CANDIDATES) {\n        const measured = worstCase(step);\n        if (measured >= INDICATOR_CONTRAST) return step;\n        if (measured > bestRatio) {\n            best = step;\n            bestRatio = measured;\n        }\n    }\n    return best;\n}\n\n/**\n * The surfaces this theme will actually paint, per scheme.\n *\n * A theme that names `gray` repaints all four, so measuring the ring against the\n * SDK's would be measuring the wrong backdrop — and a theme that does not keeps\n * the SDK's, which is the common case. The order and the ramp steps mirror\n * {@link writeNeutralAliases}, which is what emits them.\n *\n * @param scheme - Which scheme is being emitted.\n * @param grayScales - The generated neutral ramps, when the theme names one.\n * @returns Four opaque hex colors: bg, surface, surface-2, surface-3.\n */\nfunction surfacesOf(\n    scheme: \"light\" | \"dark\",\n    grayScales: { light: ColorScale; dark: ColorScale } | undefined,\n): readonly string[] {\n    if (!grayScales) return SDK_SURFACES[scheme];\n    const scale = grayScales[scheme];\n    return scheme === \"light\"\n        ? [\"#ffffff\", scale[50], scale[100], scale[200]]\n        : [scale[50], scale[100], scale[200], scale[300]];\n}\n\n/**\n * Warn, in a development build, that an alpha was asked for the focus ring.\n *\n * A translucent ring has no contrast of its own — it has the contrast of\n * whatever it composites over — and that is the failure this option used to\n * ship by default: measured at alpha `0.35`, twelve brands across four surfaces\n * and both schemes produced 96 pairings, of which 3 cleared the 3:1 of WCAG 2.2\n * SC 1.4.11. It stays available, because a translucent ring over a\n * known background is a legitimate choice, but it is a choice a theme now has to\n * make on purpose.\n *\n * The warning is the difficult part to notice otherwise: a failing focus ring is\n * visible, it just does not separate.\n *\n * @param focusRingAlpha - The opacity the caller asked for, if any.\n */\nfunction warnOnTranslucentFocusRing(focusRingAlpha: number | undefined): void {\n    if (focusRingAlpha === undefined || focusRingAlpha >= 1) return;\n    if (!isDevBuild()) return;\n    console.warn(\n        `[tempest-react-sdk] createTheme({ focusRingAlpha: ${focusRingAlpha} }) makes the focus ring ` +\n            \"translucent, so its contrast becomes whatever it composites over — measured below the 3:1 \" +\n            \"of WCAG 2.2 SC 1.4.11 on every surface the SDK paints. Drop the option to get the opaque \" +\n            \"ring, which is derived from your brand ramp and measured against those surfaces.\",\n    );\n}\n\n/**\n * Emit the primary aliases for one scheme.\n *\n * The dark scheme walks the ramp the other way (hover is *lighter*, the soft\n * tint is a dark shade, and readable text on that tint is a light shade) — the\n * same inversion the built-in `colors.css` dark block does by hand.\n *\n * The selected-state indicator is derived from the same measurement as the focus\n * ring and emitted as its own token. It never takes `focusRingAlpha`: a\n * translucent ring over a known background is a legitimate choice a theme can\n * make, while a translucent *state* indicator has the contrast of whatever it\n * composites over, which is the defect this token exists to end.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param scale - The generated primary ramp.\n * @param scheme - Which scheme is being emitted.\n * @param surfaces - The surfaces this theme paints, for the focus-ring measurement.\n * @param focusRingAlpha - Opacity asked for the ring, or `undefined` for opaque.\n */\nfunction writePrimaryAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n    surfaces: readonly string[],\n    focusRingAlpha: number | undefined,\n): void {\n    tokens[\"--tempest-primary\"] = \"var(--tempest-primary-500)\";\n    if (scheme === \"light\") {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-600)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-700)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-50)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 50, [600, 700, 800, 900])})`;\n    } else {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-400)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-300)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-200)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 100, [700, 800, 900])})`;\n    }\n\n    const foreground = readableForeground(scale[500]);\n    tokens[\"--tempest-primary-foreground\"] = foreground;\n    tokens[\"--tempest-text-on-primary\"] = foreground;\n    const ring = scale[pickFocusRingStep(scale, surfaces)];\n    tokens[\"--tempest-focus-ring-color\"] =\n        focusRingAlpha === undefined || focusRingAlpha >= 1\n            ? ring\n            : hexToRgbaString(ring, focusRingAlpha);\n    tokens[\"--tempest-selected-indicator\"] = ring;\n}\n\n/**\n * Emit the neutral surface/border/text aliases from a generated gray scale.\n *\n * `--tempest-bg` is pushed past the ramp on purpose: pure white in light mode and\n * a shade darker than `gray-50` in dark mode, so a raised surface still reads as\n * raised against the page.\n */\nfunction writeNeutralAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[\"--tempest-bg\"] = \"#ffffff\";\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-50)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-600)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-500)\";\n    } else {\n        tokens[\"--tempest-bg\"] = scale[50];\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-400)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-700)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-600)\";\n    }\n    tokens[\"--tempest-neutral-on-solid\"] = readableForeground(scale[700], \"#ffffff\", ON_SOLID_INK);\n}\n\nfunction renderBlock(selector: string, tokens: Record<string, string>): string {\n    const entries = Object.entries(tokens);\n    if (entries.length === 0) return \"\";\n    const body = entries.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\");\n    return `${selector} {\\n${body}\\n}`;\n}\n\n/**\n * Generate `--tempest-*` overrides from a small brand description.\n *\n * Only the families you pass are generated; everything else falls through to the\n * SDK's own tokens, so a theme stays a patch and not a fork of `colors.css`.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme } from \"tempest-react-sdk\";\n *\n * const theme = createTheme({\n *   primary: \"#7c3aed\",\n *   radius: \"lg\",\n *   chart: [\"#7c3aed\", \"#0ea5e9\", \"#22c55e\", \"#f59e0b\"],\n * });\n *\n * applyTheme(theme);\n * ```\n *\n * @param options - Brand colors plus optional radius / chart / focus-ring tuning.\n * @returns The light and dark token maps and the CSS text that carries them.\n */\nexport function createTheme(options: CreateThemeOptions = {}): GeneratedTheme {\n    const {\n        primary,\n        gray,\n        chart,\n        radius,\n        focusRingAlpha,\n        selector = \":root\",\n        darkSelector = '[data-tempest-theme=\"dark\"]',\n        inverse,\n        inverseSelector = INVERSE_SELECTOR,\n    } = options;\n\n    warnOnTranslucentFocusRing(focusRingAlpha);\n\n    const light: Record<string, string> = {};\n    const dark: Record<string, string> = {};\n\n    // `anchor: false`: a neutral ramp has to keep its tuned lightness curve.\n    // Anchoring it at the input compressed both halves and dropped\n    // text-muted-on-surface-3 to ~4.2:1 — below AA — which the browser axe\n    // sweep caught on the generated themes.\n    const grayScales = gray\n        ? {\n              light: createColorScale(gray, \"light\", { anchor: false, neutral: true }),\n              dark: createColorScale(gray, \"dark\", { anchor: false, neutral: true }),\n          }\n        : undefined;\n\n    if (primary) {\n        const lightScale = createColorScale(primary, \"light\");\n        const darkScale = createColorScale(primary, \"dark\");\n        writeScale(light, \"primary\", lightScale);\n        writeScale(dark, \"primary\", darkScale);\n        writePrimaryAliases(\n            light,\n            lightScale,\n            \"light\",\n            surfacesOf(\"light\", grayScales),\n            focusRingAlpha,\n        );\n        writePrimaryAliases(\n            dark,\n            darkScale,\n            \"dark\",\n            surfacesOf(\"dark\", grayScales),\n            focusRingAlpha,\n        );\n    }\n\n    if (grayScales) {\n        writeScale(light, \"gray\", grayScales.light);\n        writeScale(dark, \"gray\", grayScales.dark);\n        writeNeutralAliases(light, grayScales.light, \"light\");\n        writeNeutralAliases(dark, grayScales.dark, \"dark\");\n    }\n\n    for (const status of THEME_STATUSES) {\n        const value = options[status];\n        if (!value) continue;\n        writeStatus(light, status, createColorScale(value, \"light\"), \"light\");\n        writeStatus(dark, status, createColorScale(value, \"dark\"), \"dark\");\n    }\n\n    if (chart?.length) {\n        chart.forEach((color, index) => {\n            light[`--tempest-chart-${index + 1}`] = color;\n        });\n        // Declares how many series colors this theme owns. Without it the reader\n        // keeps walking into the SDK's built-in `--tempest-chart-7`/`-8`, so a\n        // 6-color brand palette silently mixes with two leftover defaults — which\n        // is exactly what a 7-series chart would show.\n        light[\"--tempest-chart-count\"] = String(chart.length);\n    }\n\n    /*\n     * Continuous scales follow the brand too.\n     *\n     * Without this a rebranded app gets its categorical slots recoloured and then a\n     * heatmap still painted in the SDK's blue — the one chart on the page that\n     * silently ignores the brand. Both scales derive from the first series hue (or\n     * the primary), stepped by perceptual lightness for each mode separately.\n     *\n     * Skipped entirely when the theme names no colour to derive from, so the\n     * built-in tokens survive instead of being overwritten with a guess.\n     */\n    const scaleSource = chart?.[0] ?? primary;\n    if (scaleSource) {\n        const coolHue = hueOf(scaleSource);\n        // The opposite pole: the brand's own danger colour when it has one, since a\n        // diverging scale's warm arm and \"bad\" should not disagree on screen.\n        const warmHue = options.danger ? hueOf(options.danger) : (coolHue + 180) % 360;\n        for (const [target, mode] of [\n            [light, \"light\"],\n            [dark, \"dark\"],\n        ] as const) {\n            buildRamp(coolHue, mode).forEach((stepColor, index) => {\n                target[`--tempest-chart-sequential-${index + 1}`] = stepColor;\n            });\n            const diverging = buildDivergingRamp({\n                coolHue,\n                warmHue,\n                mid: mode === \"light\" ? \"#e4e7ec\" : \"#262d3f\",\n                mode,\n            });\n            [...diverging.cool, diverging.mid, ...diverging.warm].forEach((stepColor, index) => {\n                target[`--tempest-chart-diverging-${index + 1}`] = stepColor;\n            });\n        }\n    }\n\n    if (radius) {\n        const steps = typeof radius === \"string\" ? RADIUS_PRESETS[radius] : radius;\n        for (const [step, value] of Object.entries(steps)) {\n            light[`--tempest-radius-${step}`] = value;\n        }\n    }\n\n    const inverseSurface =\n        primary && inverse\n            ? inverse({\n                  primary,\n                  statuses: {\n                      success: options.success,\n                      warning: options.warning,\n                      danger: options.danger,\n                      info: options.info,\n                  },\n                  chart,\n                  selector: inverseSelector,\n                  page: { selector, darkSelector },\n              })\n            : null;\n\n    const css = [\n        renderBlock(selector, light),\n        renderBlock(darkSelector, dark),\n        inverseSurface ? renderInverseSurface(inverseSelector, inverseSurface) : \"\",\n    ]\n        .filter(Boolean)\n        .join(\"\\n\\n\");\n\n    return inverseSurface\n        ? { light, dark, inverse: inverseSurface.tokens, css }\n        : { light, dark, css };\n}\n\n/**\n * Contrast ratio of `--tempest-primary-foreground` over the brand color.\n *\n * Exposed so an app (or a test) can assert its own brand clears WCAG AA (4.5) for\n * body text or AA-large (3.0) for button labels, instead of trusting the pick.\n *\n * @param options - The same input given to {@link createTheme}.\n * @returns The ratio, or `null` when no `primary` was provided.\n */\nexport function themeContrast(options: CreateThemeOptions): number | null {\n    if (!options.primary) return null;\n    const scale = createColorScale(options.primary, \"light\");\n    return contrastRatio(scale[500], readableForeground(scale[500]));\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-theme.cjs","names":["contrastRatio","isDevBuild","readableForeground","hexToRgbaString","ON_SOLID_INK","INVERSE_SELECTOR","createColorScale","THEME_STATUSES","hueOf","buildDivergingRamp","renderInverseSurface","require_dev_mode","require_color","require_data_viz_ramps","require_inverse_render","require_status_tokens","RADIUS_PRESETS","SCALE_STEPS","writeScale","step","name","scale","AA_TEXT_CONTRAST","pickOnSoftStep","candidates","softStep","INDICATOR_CONTRAST","SDK_SURFACES","FOCUS_RING_CANDIDATES","pickFocusRingStep","worstCase","surfaces","surface","best","bestRatio","measured","surfacesOf","grayScales","scheme","warnOnTranslucentFocusRing","focusRingAlpha","writePrimaryAliases","foreground","ring","writeNeutralAliases","renderBlock","entries","tokens","selector","value","createTheme","options","light","dark","gray","primary","lightScale","darkScale","status","chart","index","color","scaleSource","coolHue","warmHue","target","mode","stepColor","diverging","radius","steps","inverseSurface","inverse","inverseSelector","css","darkSelector","themeContrast"],"sources":["../../src/theme/create-theme.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — one pass that emits the whole token set — surfaces,\n * text, borders, states, the chart ramps — for both modes, with every value checked\n * against the surface it will sit on. The checks are what make the length: each\n * token is derived and then verified against the same background table.\n */\n/**\n * Theme factory: turns a handful of brand colors into the full set of\n * `--tempest-*` token overrides, for both light and dark.\n *\n * Rebranding used to mean hand-writing ~167 custom properties (and getting the\n * dark ramp inversion right by hand). `createTheme({ primary: \"#7c3aed\" })`\n * emits the same thing, derived in OKLCH so the ramp stays perceptually even.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToRgbaString,\n    readableForeground,\n    type ColorScale,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport {\n    INVERSE_SELECTOR,\n    renderInverseSurface,\n    type InverseSurfaceGenerator,\n} from \"./inverse-render\";\nimport { ON_SOLID_INK, THEME_STATUSES, writeStatus } from \"./status-tokens\";\n\n/** Radius presets, applied to the whole `--tempest-radius-*` family at once. */\nexport type ThemeRadius = \"none\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"full\";\n\nexport type { ThemeStatus } from \"./status-tokens\";\n\n/** Input for {@link createTheme}. Every field is optional — omitted families keep the built-in tokens. */\nexport interface CreateThemeOptions {\n    /** Brand color, used as the `500` step of the primary scale. */\n    primary?: string;\n    /** Neutral color, used as the `500` step of the gray scale (surfaces, borders, text). */\n    gray?: string;\n    /** Success color (`--tempest-success*`). */\n    success?: string;\n    /** Warning color (`--tempest-warning*`). */\n    warning?: string;\n    /** Danger color (`--tempest-danger*`). */\n    danger?: string;\n    /** Info color (`--tempest-info*`). */\n    info?: string;\n    /**\n     * Categorical series colors for `tempest-react-sdk/charts`, in cycle order.\n     * Written to `--tempest-chart-1` … `--tempest-chart-N`, so charts follow the\n     * theme instead of a hardcoded palette.\n     */\n    chart?: string[];\n    /** Corner radius scale. A preset name, or explicit per-step values. */\n    radius?: ThemeRadius | Partial<Record<\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", string>>;\n    /**\n     * Opacity of `--tempest-focus-ring-color`. Omit it — the default ring is opaque.\n     *\n     * A translucent ring has no contrast of its own; it has the contrast of\n     * whatever it composites over. Passing a value below `1` reintroduces the\n     * failure 0.61.0 fixed in the built-in tokens, and logs a warning in a\n     * development build. Kept because a translucent ring over a background you\n     * control is a legitimate choice.\n     */\n    focusRingAlpha?: number;\n    /** Selector the light tokens are written under. Default `\":root\"`. */\n    selector?: string;\n    /** Selector the dark tokens are written under. Default `'[data-tempest-theme=\"dark\"]'`. */\n    darkSelector?: string;\n    /**\n     * Also emit the inverse surface — the token set for a section painted in the\n     * brand color — by passing its generator, `createInverseSurface`. Off by\n     * default; ignored without `primary`.\n     *\n     * The generator is passed in rather than switched on with `true` so that\n     * `createTheme` never imports it: an app that does not paint a section in\n     * its brand does not ship the 1.68 kB brotli it costs.\n     *\n     * @example\n     * ```ts\n     * import { createInverseSurface, createTheme } from \"tempest-react-sdk\";\n     *\n     * createTheme({ primary: \"#03184b\", inverse: createInverseSurface });\n     * ```\n     */\n    inverse?: InverseSurfaceGenerator;\n    /** Selector the inverse tokens are written under. Default `'[data-tempest-tone=\"inverse\"]'`. */\n    inverseSelector?: string;\n}\n\n/** A generated theme: token maps per color scheme, plus the CSS text that carries them. */\nexport interface GeneratedTheme {\n    /** Light-scheme custom properties, without the leading `--`-less names (keys include `--`). */\n    light: Record<string, string>;\n    /** Dark-scheme custom properties. */\n    dark: Record<string, string>;\n    /**\n     * Inverse-surface custom properties — literal colors, identical under the\n     * light and the dark page scheme. Present only when the theme names a\n     * `primary` and passes `inverse`.\n     */\n    inverse?: Record<string, string>;\n    /** Both blocks rendered as CSS, ready for {@link applyTheme} or a stylesheet. */\n    css: string;\n}\n\nconst RADIUS_PRESETS: Record<ThemeRadius, Record<string, string>> = {\n    none: { xs: \"0\", sm: \"0\", md: \"0\", lg: \"0\", xl: \"0\", \"2xl\": \"0\" },\n    sm: { xs: \"1px\", sm: \"2px\", md: \"4px\", lg: \"6px\", xl: \"8px\", \"2xl\": \"12px\" },\n    md: { xs: \"2px\", sm: \"4px\", md: \"8px\", lg: \"12px\", xl: \"16px\", \"2xl\": \"24px\" },\n    lg: { xs: \"4px\", sm: \"6px\", md: \"12px\", lg: \"16px\", xl: \"22px\", \"2xl\": \"32px\" },\n    xl: { xs: \"6px\", sm: \"10px\", md: \"16px\", lg: \"24px\", xl: \"32px\", \"2xl\": \"44px\" },\n    full: { xs: \"4px\", sm: \"8px\", md: \"9999px\", lg: \"9999px\", xl: \"9999px\", \"2xl\": \"9999px\" },\n};\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\nfunction writeScale(tokens: Record<string, string>, name: string, scale: ColorScale): void {\n    for (const step of SCALE_STEPS) {\n        tokens[`--tempest-${name}-${step}`] = scale[step];\n    }\n}\n\n/** Minimum contrast for body text, WCAG 2.x AA. */\nconst AA_TEXT_CONTRAST = 4.5;\n\n/**\n * Choose the ramp step for text sitting on the soft tint.\n *\n * A fixed step does not survive an arbitrary brand color: the built-in blue only\n * reaches 4.37:1 at `500` over its own `50` tint, and a generated emerald lands\n * at 4.41:1 at `600` — both fail AA for body text by a hair. So the step is\n * picked by measuring, walking away from the tint until it clears AA, and\n * falling back to the most extreme candidate when even that cannot (a very light\n * or very desaturated brand).\n *\n * @param scale - The generated ramp.\n * @param softStep - Step used as `--tempest-primary-soft`.\n * @param candidates - Steps to try, in order of preference.\n * @returns The first candidate clearing {@link AA_TEXT_CONTRAST}, else the last.\n */\nfunction pickOnSoftStep(\n    scale: ColorScale,\n    softStep: ScaleStep,\n    candidates: ScaleStep[],\n): ScaleStep {\n    for (const step of candidates) {\n        if (contrastRatio(scale[softStep], scale[step]) >= AA_TEXT_CONTRAST) return step;\n    }\n    return candidates[candidates.length - 1];\n}\n\n/** Minimum contrast for a non-text indicator, WCAG 2.2 SC 1.4.11. */\nconst INDICATOR_CONTRAST = 3;\n\n/**\n * The four surfaces a focus ring can land on, as the SDK's own `colors.css`\n * paints them.\n *\n * Ported from `src/styles/colors.css` (`--tempest-bg`, `--tempest-surface`,\n * `--tempest-surface-2`, `--tempest-surface-3`, resolved through the gray ramp),\n * and pinned by a test that reads that file — a theme that only names `primary`\n * keeps these, so the ring has to be measured against them and not against a\n * guess. The light values resolve through `--tempest-gray-50/100/200`; the dark\n * ones are literals in the dark block.\n */\nconst SDK_SURFACES: Record<\"light\" | \"dark\", readonly string[]> = {\n    light: [\"#ffffff\", \"#f8f9fb\", \"#f1f3f6\", \"#e4e7ec\"],\n    dark: [\"#0b0d12\", \"#14171f\", \"#1d2230\", \"#262d3f\"],\n};\n\n/**\n * Ramp steps to try for the focus ring, in order.\n *\n * `500` first, because the ring should read as the brand when it can, then up\n * the ramp — which moves away from the surfaces in **both** schemes, because\n * `createColorScale` inverts the dark ramp: there `50` is the darkest step (it\n * is what `--tempest-bg` is made of) and `900` the lightest. Walking down in\n * dark mode looks like the right inversion and is the wrong direction; measured,\n * it left a near-black brand's ring at 1.04:1 over its own background.\n */\nconst FOCUS_RING_CANDIDATES: readonly ScaleStep[] = [500, 600, 700, 800, 900];\n\n/**\n * Choose the ramp step for the focus ring, by measuring it against the surfaces\n * it will actually be drawn on.\n *\n * A fixed step does not survive an arbitrary brand, and the measurement says so\n * loudly: of twelve brands checked against the four surfaces in both schemes —\n * 96 pairings — `500` opaque clears 3:1 in 58 of them, and `500` at the old\n * default alpha of 0.35 in 3. Picking the step by measurement clears all 96. The\n * brand from the report that opened this\n * (`#8100D7`) passes in light at 7.20:1 and fails in **dark** at 2.70:1 down to\n * 1.91:1 on `surface-3`; a yellow fails in light at 1.43:1. So the step is\n * picked the way {@link pickOnSoftStep} picks text on a tint: walk away from the\n * surfaces until the ring clears the floor against *all* of them.\n *\n * The fallback is the candidate with the best worst case rather than the last\n * one, because \"the most extreme step\" is not always the most contrasting one\n * once a brand is near-neutral.\n *\n * @param scale - The generated ramp.\n * @param surfaces - The four surfaces this theme will paint, opaque hex.\n * @returns The first candidate clearing {@link INDICATOR_CONTRAST} on every\n *   surface, else the candidate whose weakest pairing is strongest.\n */\nfunction pickFocusRingStep(scale: ColorScale, surfaces: readonly string[]): ScaleStep {\n    const worstCase = (step: ScaleStep): number =>\n        Math.min(...surfaces.map((surface) => contrastRatio(scale[step], surface)));\n    let best: ScaleStep = FOCUS_RING_CANDIDATES[0] as ScaleStep;\n    let bestRatio = -1;\n    for (const step of FOCUS_RING_CANDIDATES) {\n        const measured = worstCase(step);\n        if (measured >= INDICATOR_CONTRAST) return step;\n        if (measured > bestRatio) {\n            best = step;\n            bestRatio = measured;\n        }\n    }\n    return best;\n}\n\n/**\n * The surfaces this theme will actually paint, per scheme.\n *\n * A theme that names `gray` repaints all four, so measuring the ring against the\n * SDK's would be measuring the wrong backdrop — and a theme that does not keeps\n * the SDK's, which is the common case. The order and the ramp steps mirror\n * {@link writeNeutralAliases}, which is what emits them.\n *\n * @param scheme - Which scheme is being emitted.\n * @param grayScales - The generated neutral ramps, when the theme names one.\n * @returns Four opaque hex colors: bg, surface, surface-2, surface-3.\n */\nfunction surfacesOf(\n    scheme: \"light\" | \"dark\",\n    grayScales: { light: ColorScale; dark: ColorScale } | undefined,\n): readonly string[] {\n    if (!grayScales) return SDK_SURFACES[scheme];\n    const scale = grayScales[scheme];\n    return scheme === \"light\"\n        ? [\"#ffffff\", scale[50], scale[100], scale[200]]\n        : [scale[50], scale[100], scale[200], scale[300]];\n}\n\n/**\n * Warn, in a development build, that an alpha was asked for the focus ring.\n *\n * A translucent ring has no contrast of its own — it has the contrast of\n * whatever it composites over — and that is the failure this option used to\n * ship by default: measured at alpha `0.35`, twelve brands across four surfaces\n * and both schemes produced 96 pairings, of which 3 cleared the 3:1 of WCAG 2.2\n * SC 1.4.11. It stays available, because a translucent ring over a\n * known background is a legitimate choice, but it is a choice a theme now has to\n * make on purpose.\n *\n * The warning is the difficult part to notice otherwise: a failing focus ring is\n * visible, it just does not separate.\n *\n * @param focusRingAlpha - The opacity the caller asked for, if any.\n */\nfunction warnOnTranslucentFocusRing(focusRingAlpha: number | undefined): void {\n    if (focusRingAlpha === undefined || focusRingAlpha >= 1) return;\n    if (!isDevBuild()) return;\n    console.warn(\n        `[tempest-react-sdk] createTheme({ focusRingAlpha: ${focusRingAlpha} }) makes the focus ring ` +\n            \"translucent, so its contrast becomes whatever it composites over — measured below the 3:1 \" +\n            \"of WCAG 2.2 SC 1.4.11 on every surface the SDK paints. Drop the option to get the opaque \" +\n            \"ring, which is derived from your brand ramp and measured against those surfaces.\",\n    );\n}\n\n/**\n * Emit the primary aliases for one scheme.\n *\n * The dark scheme walks the ramp the other way (hover is *lighter*, the soft\n * tint is a dark shade, and readable text on that tint is a light shade) — the\n * same inversion the built-in `colors.css` dark block does by hand.\n *\n * The selected-state indicator is derived from the same measurement as the focus\n * ring and emitted as its own token. It never takes `focusRingAlpha`: a\n * translucent ring over a known background is a legitimate choice a theme can\n * make, while a translucent *state* indicator has the contrast of whatever it\n * composites over, which is the defect this token exists to end.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param scale - The generated primary ramp.\n * @param scheme - Which scheme is being emitted.\n * @param surfaces - The surfaces this theme paints, for the focus-ring measurement.\n * @param focusRingAlpha - Opacity asked for the ring, or `undefined` for opaque.\n */\nfunction writePrimaryAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n    surfaces: readonly string[],\n    focusRingAlpha: number | undefined,\n): void {\n    tokens[\"--tempest-primary\"] = \"var(--tempest-primary-500)\";\n    if (scheme === \"light\") {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-600)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-700)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-50)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 50, [600, 700, 800, 900])})`;\n    } else {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-400)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-300)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-200)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 100, [700, 800, 900])})`;\n    }\n\n    const foreground = readableForeground(scale[500]);\n    tokens[\"--tempest-primary-foreground\"] = foreground;\n    tokens[\"--tempest-text-on-primary\"] = foreground;\n    const ring = scale[pickFocusRingStep(scale, surfaces)];\n    tokens[\"--tempest-focus-ring-color\"] =\n        focusRingAlpha === undefined || focusRingAlpha >= 1\n            ? ring\n            : hexToRgbaString(ring, focusRingAlpha);\n    tokens[\"--tempest-selected-indicator\"] = ring;\n}\n\n/**\n * Emit the neutral surface/border/text aliases from a generated gray scale.\n *\n * `--tempest-bg` is pushed past the ramp on purpose: pure white in light mode and\n * a shade darker than `gray-50` in dark mode, so a raised surface still reads as\n * raised against the page.\n */\nfunction writeNeutralAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[\"--tempest-bg\"] = \"#ffffff\";\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-50)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-600)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-500)\";\n    } else {\n        tokens[\"--tempest-bg\"] = scale[50];\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-400)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-700)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-600)\";\n    }\n    tokens[\"--tempest-neutral-on-solid\"] = readableForeground(scale[700], \"#ffffff\", ON_SOLID_INK);\n}\n\nfunction renderBlock(selector: string, tokens: Record<string, string>): string {\n    const entries = Object.entries(tokens);\n    if (entries.length === 0) return \"\";\n    const body = entries.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\");\n    return `${selector} {\\n${body}\\n}`;\n}\n\n/**\n * Generate `--tempest-*` overrides from a small brand description.\n *\n * Only the families you pass are generated; everything else falls through to the\n * SDK's own tokens, so a theme stays a patch and not a fork of `colors.css`.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme } from \"tempest-react-sdk\";\n *\n * const theme = createTheme({\n *   primary: \"#7c3aed\",\n *   radius: \"lg\",\n *   chart: [\"#7c3aed\", \"#0ea5e9\", \"#22c55e\", \"#f59e0b\"],\n * });\n *\n * applyTheme(theme);\n * ```\n *\n * @param options - Brand colors plus optional radius / chart / focus-ring tuning.\n * @returns The light and dark token maps and the CSS text that carries them.\n */\nexport function createTheme(options: CreateThemeOptions = {}): GeneratedTheme {\n    const {\n        primary,\n        gray,\n        chart,\n        radius,\n        focusRingAlpha,\n        selector = \":root\",\n        darkSelector = '[data-tempest-theme=\"dark\"]',\n        inverse,\n        inverseSelector = INVERSE_SELECTOR,\n    } = options;\n\n    warnOnTranslucentFocusRing(focusRingAlpha);\n\n    const light: Record<string, string> = {};\n    const dark: Record<string, string> = {};\n\n    // `anchor: false`: a neutral ramp has to keep its tuned lightness curve.\n    // Anchoring it at the input compressed both halves and dropped\n    // text-muted-on-surface-3 to ~4.2:1 — below AA — which the browser axe\n    // sweep caught on the generated themes.\n    const grayScales = gray\n        ? {\n              light: createColorScale(gray, \"light\", { anchor: false, neutral: true }),\n              dark: createColorScale(gray, \"dark\", { anchor: false, neutral: true }),\n          }\n        : undefined;\n\n    if (primary) {\n        const lightScale = createColorScale(primary, \"light\");\n        const darkScale = createColorScale(primary, \"dark\");\n        writeScale(light, \"primary\", lightScale);\n        writeScale(dark, \"primary\", darkScale);\n        writePrimaryAliases(\n            light,\n            lightScale,\n            \"light\",\n            surfacesOf(\"light\", grayScales),\n            focusRingAlpha,\n        );\n        writePrimaryAliases(\n            dark,\n            darkScale,\n            \"dark\",\n            surfacesOf(\"dark\", grayScales),\n            focusRingAlpha,\n        );\n    }\n\n    if (grayScales) {\n        writeScale(light, \"gray\", grayScales.light);\n        writeScale(dark, \"gray\", grayScales.dark);\n        writeNeutralAliases(light, grayScales.light, \"light\");\n        writeNeutralAliases(dark, grayScales.dark, \"dark\");\n    }\n\n    for (const status of THEME_STATUSES) {\n        const value = options[status];\n        if (!value) continue;\n        writeStatus(light, status, createColorScale(value, \"light\"), \"light\");\n        writeStatus(dark, status, createColorScale(value, \"dark\"), \"dark\");\n    }\n\n    if (chart?.length) {\n        chart.forEach((color, index) => {\n            light[`--tempest-chart-${index + 1}`] = color;\n        });\n        // Declares how many series colors this theme owns. Without it the reader\n        // keeps walking into the SDK's built-in `--tempest-chart-7`/`-8`, so a\n        // 6-color brand palette silently mixes with two leftover defaults — which\n        // is exactly what a 7-series chart would show.\n        light[\"--tempest-chart-count\"] = String(chart.length);\n    }\n\n    /*\n     * Continuous scales follow the brand too.\n     *\n     * Without this a rebranded app gets its categorical slots recoloured and then a\n     * heatmap still painted in the SDK's blue — the one chart on the page that\n     * silently ignores the brand. Both scales derive from the first series hue (or\n     * the primary), stepped by perceptual lightness for each mode separately.\n     *\n     * Skipped entirely when the theme names no colour to derive from, so the\n     * built-in tokens survive instead of being overwritten with a guess.\n     */\n    const scaleSource = chart?.[0] ?? primary;\n    if (scaleSource) {\n        const coolHue = hueOf(scaleSource);\n        // The opposite pole: the brand's own danger colour when it has one, since a\n        // diverging scale's warm arm and \"bad\" should not disagree on screen.\n        const warmHue = options.danger ? hueOf(options.danger) : (coolHue + 180) % 360;\n        for (const [target, mode] of [\n            [light, \"light\"],\n            [dark, \"dark\"],\n        ] as const) {\n            buildRamp(coolHue, mode).forEach((stepColor, index) => {\n                target[`--tempest-chart-sequential-${index + 1}`] = stepColor;\n            });\n            const diverging = buildDivergingRamp({\n                coolHue,\n                warmHue,\n                mid: mode === \"light\" ? \"#e4e7ec\" : \"#262d3f\",\n                mode,\n            });\n            [...diverging.cool, diverging.mid, ...diverging.warm].forEach((stepColor, index) => {\n                target[`--tempest-chart-diverging-${index + 1}`] = stepColor;\n            });\n        }\n    }\n\n    if (radius) {\n        const steps = typeof radius === \"string\" ? RADIUS_PRESETS[radius] : radius;\n        for (const [step, value] of Object.entries(steps)) {\n            light[`--tempest-radius-${step}`] = value;\n        }\n    }\n\n    const inverseSurface =\n        primary && inverse\n            ? inverse({\n                  primary,\n                  statuses: {\n                      success: options.success,\n                      warning: options.warning,\n                      danger: options.danger,\n                      info: options.info,\n                  },\n                  chart,\n                  selector: inverseSelector,\n                  page: { selector, darkSelector },\n              })\n            : null;\n\n    const css = [\n        renderBlock(selector, light),\n        renderBlock(darkSelector, dark),\n        inverseSurface ? renderInverseSurface(inverseSelector, inverseSurface) : \"\",\n    ]\n        .filter(Boolean)\n        .join(\"\\n\\n\");\n\n    return inverseSurface\n        ? { light, dark, inverse: inverseSurface.tokens, css }\n        : { light, dark, css };\n}\n\n/**\n * Contrast ratio of `--tempest-primary-foreground` over the brand color.\n *\n * Exposed so an app (or a test) can assert its own brand clears WCAG AA (4.5) for\n * body text or AA-large (3.0) for button labels, instead of trusting the pick.\n *\n * @param options - The same input given to {@link createTheme}.\n * @returns The ratio, or `null` when no `primary` was provided.\n */\nexport function themeContrast(options: CreateThemeOptions): number | null {\n    if (!options.primary) return null;\n    const scale = createColorScale(options.primary, \"light\");\n    return contrastRatio(scale[500], readableForeground(scale[500]));\n}\n"],"mappings":"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"}

package/dist/theme/create-theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-theme.js","names":[],"sources":["../../src/theme/create-theme.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — one pass that emits the whole token set — surfaces,\n * text, borders, states, the chart ramps — for both modes, with every value checked\n * against the surface it will sit on. The checks are what make the length: each\n * token is derived and then verified against the same background table.\n */\n/**\n * Theme factory: turns a handful of brand colors into the full set of\n * `--tempest-*` token overrides, for both light and dark.\n *\n * Rebranding used to mean hand-writing ~167 custom properties (and getting the\n * dark ramp inversion right by hand). `createTheme({ primary: \"#7c3aed\" })`\n * emits the same thing, derived in OKLCH so the ramp stays perceptually even.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToRgbaString,\n    readableForeground,\n    type ColorScale,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport {\n    INVERSE_SELECTOR,\n    renderInverseSurface,\n    type InverseSurfaceGenerator,\n} from \"./inverse-render\";\nimport { ON_SOLID_INK, THEME_STATUSES, writeStatus } from \"./status-tokens\";\n\n/** Radius presets, applied to the whole `--tempest-radius-*` family at once. */\nexport type ThemeRadius = \"none\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"full\";\n\nexport type { ThemeStatus } from \"./status-tokens\";\n\n/** Input for {@link createTheme}. Every field is optional — omitted families keep the built-in tokens. */\nexport interface CreateThemeOptions {\n    /** Brand color, used as the `500` step of the primary scale. */\n    primary?: string;\n    /** Neutral color, used as the `500` step of the gray scale (surfaces, borders, text). */\n    gray?: string;\n    /** Success color (`--tempest-success*`). */\n    success?: string;\n    /** Warning color (`--tempest-warning*`). */\n    warning?: string;\n    /** Danger color (`--tempest-danger*`). */\n    danger?: string;\n    /** Info color (`--tempest-info*`). */\n    info?: string;\n    /**\n     * Categorical series colors for `tempest-react-sdk/charts`, in cycle order.\n     * Written to `--tempest-chart-1` … `--tempest-chart-N`, so charts follow the\n     * theme instead of a hardcoded palette.\n     */\n    chart?: string[];\n    /** Corner radius scale. A preset name, or explicit per-step values. */\n    radius?: ThemeRadius | Partial<Record<\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", string>>;\n    /**\n     * Opacity of `--tempest-focus-ring-color`. Omit it — the default ring is opaque.\n     *\n     * A translucent ring has no contrast of its own; it has the contrast of\n     * whatever it composites over. Passing a value below `1` reintroduces the\n     * failure 0.61.0 fixed in the built-in tokens, and logs a warning in a\n     * development build. Kept because a translucent ring over a background you\n     * control is a legitimate choice.\n     */\n    focusRingAlpha?: number;\n    /** Selector the light tokens are written under. Default `\":root\"`. */\n    selector?: string;\n    /** Selector the dark tokens are written under. Default `'[data-tempest-theme=\"dark\"]'`. */\n    darkSelector?: string;\n    /**\n     * Also emit the inverse surface — the token set for a section painted in the\n     * brand color — by passing its generator, `createInverseSurface`. Off by\n     * default; ignored without `primary`.\n     *\n     * The generator is passed in rather than switched on with `true` so that\n     * `createTheme` never imports it: an app that does not paint a section in\n     * its brand does not ship the 1.68 kB brotli it costs.\n     *\n     * @example\n     * ```ts\n     * import { createInverseSurface, createTheme } from \"tempest-react-sdk\";\n     *\n     * createTheme({ primary: \"#03184b\", inverse: createInverseSurface });\n     * ```\n     */\n    inverse?: InverseSurfaceGenerator;\n    /** Selector the inverse tokens are written under. Default `'[data-tempest-tone=\"inverse\"]'`. */\n    inverseSelector?: string;\n}\n\n/** A generated theme: token maps per color scheme, plus the CSS text that carries them. */\nexport interface GeneratedTheme {\n    /** Light-scheme custom properties, without the leading `--`-less names (keys include `--`). */\n    light: Record<string, string>;\n    /** Dark-scheme custom properties. */\n    dark: Record<string, string>;\n    /**\n     * Inverse-surface custom properties — literal colors, identical under the\n     * light and the dark page scheme. Present only when the theme names a\n     * `primary` and passes `inverse`.\n     */\n    inverse?: Record<string, string>;\n    /** Both blocks rendered as CSS, ready for {@link applyTheme} or a stylesheet. */\n    css: string;\n}\n\nconst RADIUS_PRESETS: Record<ThemeRadius, Record<string, string>> = {\n    none: { xs: \"0\", sm: \"0\", md: \"0\", lg: \"0\", xl: \"0\", \"2xl\": \"0\" },\n    sm: { xs: \"1px\", sm: \"2px\", md: \"4px\", lg: \"6px\", xl: \"8px\", \"2xl\": \"12px\" },\n    md: { xs: \"2px\", sm: \"4px\", md: \"8px\", lg: \"12px\", xl: \"16px\", \"2xl\": \"24px\" },\n    lg: { xs: \"4px\", sm: \"6px\", md: \"12px\", lg: \"16px\", xl: \"22px\", \"2xl\": \"32px\" },\n    xl: { xs: \"6px\", sm: \"10px\", md: \"16px\", lg: \"24px\", xl: \"32px\", \"2xl\": \"44px\" },\n    full: { xs: \"4px\", sm: \"8px\", md: \"9999px\", lg: \"9999px\", xl: \"9999px\", \"2xl\": \"9999px\" },\n};\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\nfunction writeScale(tokens: Record<string, string>, name: string, scale: ColorScale): void {\n    for (const step of SCALE_STEPS) {\n        tokens[`--tempest-${name}-${step}`] = scale[step];\n    }\n}\n\n/** Minimum contrast for body text, WCAG 2.x AA. */\nconst AA_TEXT_CONTRAST = 4.5;\n\n/**\n * Choose the ramp step for text sitting on the soft tint.\n *\n * A fixed step does not survive an arbitrary brand color: the built-in blue only\n * reaches 4.37:1 at `500` over its own `50` tint, and a generated emerald lands\n * at 4.41:1 at `600` — both fail AA for body text by a hair. So the step is\n * picked by measuring, walking away from the tint until it clears AA, and\n * falling back to the most extreme candidate when even that cannot (a very light\n * or very desaturated brand).\n *\n * @param scale - The generated ramp.\n * @param softStep - Step used as `--tempest-primary-soft`.\n * @param candidates - Steps to try, in order of preference.\n * @returns The first candidate clearing {@link AA_TEXT_CONTRAST}, else the last.\n */\nfunction pickOnSoftStep(\n    scale: ColorScale,\n    softStep: ScaleStep,\n    candidates: ScaleStep[],\n): ScaleStep {\n    for (const step of candidates) {\n        if (contrastRatio(scale[softStep], scale[step]) >= AA_TEXT_CONTRAST) return step;\n    }\n    return candidates[candidates.length - 1];\n}\n\n/** Minimum contrast for a non-text indicator, WCAG 2.2 SC 1.4.11. */\nconst INDICATOR_CONTRAST = 3;\n\n/**\n * The four surfaces a focus ring can land on, as the SDK's own `colors.css`\n * paints them.\n *\n * Ported from `src/styles/colors.css` (`--tempest-bg`, `--tempest-surface`,\n * `--tempest-surface-2`, `--tempest-surface-3`, resolved through the gray ramp),\n * and pinned by a test that reads that file — a theme that only names `primary`\n * keeps these, so the ring has to be measured against them and not against a\n * guess. The light values resolve through `--tempest-gray-50/100/200`; the dark\n * ones are literals in the dark block.\n */\nconst SDK_SURFACES: Record<\"light\" | \"dark\", readonly string[]> = {\n    light: [\"#ffffff\", \"#f8f9fb\", \"#f1f3f6\", \"#e4e7ec\"],\n    dark: [\"#0b0d12\", \"#14171f\", \"#1d2230\", \"#262d3f\"],\n};\n\n/**\n * Ramp steps to try for the focus ring, in order.\n *\n * `500` first, because the ring should read as the brand when it can, then up\n * the ramp — which moves away from the surfaces in **both** schemes, because\n * `createColorScale` inverts the dark ramp: there `50` is the darkest step (it\n * is what `--tempest-bg` is made of) and `900` the lightest. Walking down in\n * dark mode looks like the right inversion and is the wrong direction; measured,\n * it left a near-black brand's ring at 1.04:1 over its own background.\n */\nconst FOCUS_RING_CANDIDATES: readonly ScaleStep[] = [500, 600, 700, 800, 900];\n\n/**\n * Choose the ramp step for the focus ring, by measuring it against the surfaces\n * it will actually be drawn on.\n *\n * A fixed step does not survive an arbitrary brand, and the measurement says so\n * loudly: of twelve brands checked against the four surfaces in both schemes —\n * 96 pairings — `500` opaque clears 3:1 in 58 of them, and `500` at the old\n * default alpha of 0.35 in 3. Picking the step by measurement clears all 96. The\n * brand from the report that opened this\n * (`#8100D7`) passes in light at 7.20:1 and fails in **dark** at 2.70:1 down to\n * 1.91:1 on `surface-3`; a yellow fails in light at 1.43:1. So the step is\n * picked the way {@link pickOnSoftStep} picks text on a tint: walk away from the\n * surfaces until the ring clears the floor against *all* of them.\n *\n * The fallback is the candidate with the best worst case rather than the last\n * one, because \"the most extreme step\" is not always the most contrasting one\n * once a brand is near-neutral.\n *\n * @param scale - The generated ramp.\n * @param surfaces - The four surfaces this theme will paint, opaque hex.\n * @returns The first candidate clearing {@link INDICATOR_CONTRAST} on every\n *   surface, else the candidate whose weakest pairing is strongest.\n */\nfunction pickFocusRingStep(scale: ColorScale, surfaces: readonly string[]): ScaleStep {\n    const worstCase = (step: ScaleStep): number =>\n        Math.min(...surfaces.map((surface) => contrastRatio(scale[step], surface)));\n    let best: ScaleStep = FOCUS_RING_CANDIDATES[0] as ScaleStep;\n    let bestRatio = -1;\n    for (const step of FOCUS_RING_CANDIDATES) {\n        const measured = worstCase(step);\n        if (measured >= INDICATOR_CONTRAST) return step;\n        if (measured > bestRatio) {\n            best = step;\n            bestRatio = measured;\n        }\n    }\n    return best;\n}\n\n/**\n * The surfaces this theme will actually paint, per scheme.\n *\n * A theme that names `gray` repaints all four, so measuring the ring against the\n * SDK's would be measuring the wrong backdrop — and a theme that does not keeps\n * the SDK's, which is the common case. The order and the ramp steps mirror\n * {@link writeNeutralAliases}, which is what emits them.\n *\n * @param scheme - Which scheme is being emitted.\n * @param grayScales - The generated neutral ramps, when the theme names one.\n * @returns Four opaque hex colors: bg, surface, surface-2, surface-3.\n */\nfunction surfacesOf(\n    scheme: \"light\" | \"dark\",\n    grayScales: { light: ColorScale; dark: ColorScale } | undefined,\n): readonly string[] {\n    if (!grayScales) return SDK_SURFACES[scheme];\n    const scale = grayScales[scheme];\n    return scheme === \"light\"\n        ? [\"#ffffff\", scale[50], scale[100], scale[200]]\n        : [scale[50], scale[100], scale[200], scale[300]];\n}\n\n/**\n * Warn, in a development build, that an alpha was asked for the focus ring.\n *\n * A translucent ring has no contrast of its own — it has the contrast of\n * whatever it composites over — and that is the failure this option used to\n * ship by default: measured at alpha `0.35`, twelve brands across four surfaces\n * and both schemes produced 96 pairings, of which 3 cleared the 3:1 of WCAG 2.2\n * SC 1.4.11. It stays available, because a translucent ring over a\n * known background is a legitimate choice, but it is a choice a theme now has to\n * make on purpose.\n *\n * The warning is the difficult part to notice otherwise: a failing focus ring is\n * visible, it just does not separate.\n *\n * @param focusRingAlpha - The opacity the caller asked for, if any.\n */\nfunction warnOnTranslucentFocusRing(focusRingAlpha: number | undefined): void {\n    if (focusRingAlpha === undefined || focusRingAlpha >= 1) return;\n    if (!isDevBuild()) return;\n    console.warn(\n        `[tempest-react-sdk] createTheme({ focusRingAlpha: ${focusRingAlpha} }) makes the focus ring ` +\n            \"translucent, so its contrast becomes whatever it composites over — measured below the 3:1 \" +\n            \"of WCAG 2.2 SC 1.4.11 on every surface the SDK paints. Drop the option to get the opaque \" +\n            \"ring, which is derived from your brand ramp and measured against those surfaces.\",\n    );\n}\n\n/**\n * Emit the primary aliases for one scheme.\n *\n * The dark scheme walks the ramp the other way (hover is *lighter*, the soft\n * tint is a dark shade, and readable text on that tint is a light shade) — the\n * same inversion the built-in `colors.css` dark block does by hand.\n *\n * The selected-state indicator is derived from the same measurement as the focus\n * ring and emitted as its own token. It never takes `focusRingAlpha`: a\n * translucent ring over a known background is a legitimate choice a theme can\n * make, while a translucent *state* indicator has the contrast of whatever it\n * composites over, which is the defect this token exists to end.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param scale - The generated primary ramp.\n * @param scheme - Which scheme is being emitted.\n * @param surfaces - The surfaces this theme paints, for the focus-ring measurement.\n * @param focusRingAlpha - Opacity asked for the ring, or `undefined` for opaque.\n */\nfunction writePrimaryAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n    surfaces: readonly string[],\n    focusRingAlpha: number | undefined,\n): void {\n    tokens[\"--tempest-primary\"] = \"var(--tempest-primary-500)\";\n    if (scheme === \"light\") {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-600)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-700)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-50)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 50, [600, 700, 800, 900])})`;\n    } else {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-400)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-300)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-200)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 100, [700, 800, 900])})`;\n    }\n\n    const foreground = readableForeground(scale[500]);\n    tokens[\"--tempest-primary-foreground\"] = foreground;\n    tokens[\"--tempest-text-on-primary\"] = foreground;\n    const ring = scale[pickFocusRingStep(scale, surfaces)];\n    tokens[\"--tempest-focus-ring-color\"] =\n        focusRingAlpha === undefined || focusRingAlpha >= 1\n            ? ring\n            : hexToRgbaString(ring, focusRingAlpha);\n    tokens[\"--tempest-selected-indicator\"] = ring;\n}\n\n/**\n * Emit the neutral surface/border/text aliases from a generated gray scale.\n *\n * `--tempest-bg` is pushed past the ramp on purpose: pure white in light mode and\n * a shade darker than `gray-50` in dark mode, so a raised surface still reads as\n * raised against the page.\n */\nfunction writeNeutralAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[\"--tempest-bg\"] = \"#ffffff\";\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-50)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-600)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-500)\";\n    } else {\n        tokens[\"--tempest-bg\"] = scale[50];\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-400)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-700)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-600)\";\n    }\n    tokens[\"--tempest-neutral-on-solid\"] = readableForeground(scale[700], \"#ffffff\", ON_SOLID_INK);\n}\n\nfunction renderBlock(selector: string, tokens: Record<string, string>): string {\n    const entries = Object.entries(tokens);\n    if (entries.length === 0) return \"\";\n    const body = entries.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\");\n    return `${selector} {\\n${body}\\n}`;\n}\n\n/**\n * Generate `--tempest-*` overrides from a small brand description.\n *\n * Only the families you pass are generated; everything else falls through to the\n * SDK's own tokens, so a theme stays a patch and not a fork of `colors.css`.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme } from \"tempest-react-sdk\";\n *\n * const theme = createTheme({\n *   primary: \"#7c3aed\",\n *   radius: \"lg\",\n *   chart: [\"#7c3aed\", \"#0ea5e9\", \"#22c55e\", \"#f59e0b\"],\n * });\n *\n * applyTheme(theme);\n * ```\n *\n * @param options - Brand colors plus optional radius / chart / focus-ring tuning.\n * @returns The light and dark token maps and the CSS text that carries them.\n */\nexport function createTheme(options: CreateThemeOptions = {}): GeneratedTheme {\n    const {\n        primary,\n        gray,\n        chart,\n        radius,\n        focusRingAlpha,\n        selector = \":root\",\n        darkSelector = '[data-tempest-theme=\"dark\"]',\n        inverse,\n        inverseSelector = INVERSE_SELECTOR,\n    } = options;\n\n    warnOnTranslucentFocusRing(focusRingAlpha);\n\n    const light: Record<string, string> = {};\n    const dark: Record<string, string> = {};\n\n    // `anchor: false`: a neutral ramp has to keep its tuned lightness curve.\n    // Anchoring it at the input compressed both halves and dropped\n    // text-muted-on-surface-3 to ~4.2:1 — below AA — which the browser axe\n    // sweep caught on the generated themes.\n    const grayScales = gray\n        ? {\n              light: createColorScale(gray, \"light\", { anchor: false, neutral: true }),\n              dark: createColorScale(gray, \"dark\", { anchor: false, neutral: true }),\n          }\n        : undefined;\n\n    if (primary) {\n        const lightScale = createColorScale(primary, \"light\");\n        const darkScale = createColorScale(primary, \"dark\");\n        writeScale(light, \"primary\", lightScale);\n        writeScale(dark, \"primary\", darkScale);\n        writePrimaryAliases(\n            light,\n            lightScale,\n            \"light\",\n            surfacesOf(\"light\", grayScales),\n            focusRingAlpha,\n        );\n        writePrimaryAliases(\n            dark,\n            darkScale,\n            \"dark\",\n            surfacesOf(\"dark\", grayScales),\n            focusRingAlpha,\n        );\n    }\n\n    if (grayScales) {\n        writeScale(light, \"gray\", grayScales.light);\n        writeScale(dark, \"gray\", grayScales.dark);\n        writeNeutralAliases(light, grayScales.light, \"light\");\n        writeNeutralAliases(dark, grayScales.dark, \"dark\");\n    }\n\n    for (const status of THEME_STATUSES) {\n        const value = options[status];\n        if (!value) continue;\n        writeStatus(light, status, createColorScale(value, \"light\"), \"light\");\n        writeStatus(dark, status, createColorScale(value, \"dark\"), \"dark\");\n    }\n\n    if (chart?.length) {\n        chart.forEach((color, index) => {\n            light[`--tempest-chart-${index + 1}`] = color;\n        });\n        // Declares how many series colors this theme owns. Without it the reader\n        // keeps walking into the SDK's built-in `--tempest-chart-7`/`-8`, so a\n        // 6-color brand palette silently mixes with two leftover defaults — which\n        // is exactly what a 7-series chart would show.\n        light[\"--tempest-chart-count\"] = String(chart.length);\n    }\n\n    /*\n     * Continuous scales follow the brand too.\n     *\n     * Without this a rebranded app gets its categorical slots recoloured and then a\n     * heatmap still painted in the SDK's blue — the one chart on the page that\n     * silently ignores the brand. Both scales derive from the first series hue (or\n     * the primary), stepped by perceptual lightness for each mode separately.\n     *\n     * Skipped entirely when the theme names no colour to derive from, so the\n     * built-in tokens survive instead of being overwritten with a guess.\n     */\n    const scaleSource = chart?.[0] ?? primary;\n    if (scaleSource) {\n        const coolHue = hueOf(scaleSource);\n        // The opposite pole: the brand's own danger colour when it has one, since a\n        // diverging scale's warm arm and \"bad\" should not disagree on screen.\n        const warmHue = options.danger ? hueOf(options.danger) : (coolHue + 180) % 360;\n        for (const [target, mode] of [\n            [light, \"light\"],\n            [dark, \"dark\"],\n        ] as const) {\n            buildRamp(coolHue, mode).forEach((stepColor, index) => {\n                target[`--tempest-chart-sequential-${index + 1}`] = stepColor;\n            });\n            const diverging = buildDivergingRamp({\n                coolHue,\n                warmHue,\n                mid: mode === \"light\" ? \"#e4e7ec\" : \"#262d3f\",\n                mode,\n            });\n            [...diverging.cool, diverging.mid, ...diverging.warm].forEach((stepColor, index) => {\n                target[`--tempest-chart-diverging-${index + 1}`] = stepColor;\n            });\n        }\n    }\n\n    if (radius) {\n        const steps = typeof radius === \"string\" ? RADIUS_PRESETS[radius] : radius;\n        for (const [step, value] of Object.entries(steps)) {\n            light[`--tempest-radius-${step}`] = value;\n        }\n    }\n\n    const inverseSurface =\n        primary && inverse\n            ? inverse({\n                  primary,\n                  statuses: {\n                      success: options.success,\n                      warning: options.warning,\n                      danger: options.danger,\n                      info: options.info,\n                  },\n                  chart,\n                  selector: inverseSelector,\n                  page: { selector, darkSelector },\n              })\n            : null;\n\n    const css = [\n        renderBlock(selector, light),\n        renderBlock(darkSelector, dark),\n        inverseSurface ? renderInverseSurface(inverseSelector, inverseSurface) : \"\",\n    ]\n        .filter(Boolean)\n        .join(\"\\n\\n\");\n\n    return inverseSurface\n        ? { light, dark, inverse: inverseSurface.tokens, css }\n        : { light, dark, css };\n}\n\n/**\n * Contrast ratio of `--tempest-primary-foreground` over the brand color.\n *\n * Exposed so an app (or a test) can assert its own brand clears WCAG AA (4.5) for\n * body text or AA-large (3.0) for button labels, instead of trusting the pick.\n *\n * @param options - The same input given to {@link createTheme}.\n * @returns The ratio, or `null` when no `primary` was provided.\n */\nexport function themeContrast(options: CreateThemeOptions): number | null {\n    if (!options.primary) return null;\n    const scale = createColorScale(options.primary, \"light\");\n    return contrastRatio(scale[500], readableForeground(scale[500]));\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-theme.js","names":["RADIUS_PRESETS","SCALE_STEPS","writeScale","step","name","scale","AA_TEXT_CONTRAST","pickOnSoftStep","candidates","contrastRatio","softStep","INDICATOR_CONTRAST","SDK_SURFACES","FOCUS_RING_CANDIDATES","pickFocusRingStep","worstCase","surfaces","surface","best","bestRatio","measured","surfacesOf","grayScales","scheme","warnOnTranslucentFocusRing","focusRingAlpha","isDevBuild","writePrimaryAliases","foreground","readableForeground","ring","hexToRgbaString","writeNeutralAliases","ON_SOLID_INK","renderBlock","entries","tokens","selector","value","createTheme","INVERSE_SELECTOR","options","light","dark","gray","createColorScale","primary","lightScale","darkScale","status","THEME_STATUSES","writeStatus","chart","index","color","scaleSource","coolHue","hueOf","warmHue","target","mode","stepColor","diverging","buildDivergingRamp","radius","steps","inverseSurface","inverse","inverseSelector","css","darkSelector","renderInverseSurface","themeContrast"],"sources":["../../src/theme/create-theme.ts"],"sourcesContent":["/**\n * @tempest-limits file-lines — one pass that emits the whole token set — surfaces,\n * text, borders, states, the chart ramps — for both modes, with every value checked\n * against the surface it will sit on. The checks are what make the length: each\n * token is derived and then verified against the same background table.\n */\n/**\n * Theme factory: turns a handful of brand colors into the full set of\n * `--tempest-*` token overrides, for both light and dark.\n *\n * Rebranding used to mean hand-writing ~167 custom properties (and getting the\n * dark ramp inversion right by hand). `createTheme({ primary: \"#7c3aed\" })`\n * emits the same thing, derived in OKLCH so the ramp stays perceptually even.\n */\nimport {\n    contrastRatio,\n    createColorScale,\n    hexToRgbaString,\n    readableForeground,\n    type ColorScale,\n    type ScaleStep,\n} from \"./color\";\nimport { buildDivergingRamp, buildRamp, hueOf } from \"./data-viz-ramps\";\nimport { isDevBuild } from \"../utils/dev-mode\";\nimport {\n    INVERSE_SELECTOR,\n    renderInverseSurface,\n    type InverseSurfaceGenerator,\n} from \"./inverse-render\";\nimport { ON_SOLID_INK, THEME_STATUSES, writeStatus } from \"./status-tokens\";\n\n/** Radius presets, applied to the whole `--tempest-radius-*` family at once. */\nexport type ThemeRadius = \"none\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"full\";\n\nexport type { ThemeStatus } from \"./status-tokens\";\n\n/** Input for {@link createTheme}. Every field is optional — omitted families keep the built-in tokens. */\nexport interface CreateThemeOptions {\n    /** Brand color, used as the `500` step of the primary scale. */\n    primary?: string;\n    /** Neutral color, used as the `500` step of the gray scale (surfaces, borders, text). */\n    gray?: string;\n    /** Success color (`--tempest-success*`). */\n    success?: string;\n    /** Warning color (`--tempest-warning*`). */\n    warning?: string;\n    /** Danger color (`--tempest-danger*`). */\n    danger?: string;\n    /** Info color (`--tempest-info*`). */\n    info?: string;\n    /**\n     * Categorical series colors for `tempest-react-sdk/charts`, in cycle order.\n     * Written to `--tempest-chart-1` … `--tempest-chart-N`, so charts follow the\n     * theme instead of a hardcoded palette.\n     */\n    chart?: string[];\n    /** Corner radius scale. A preset name, or explicit per-step values. */\n    radius?: ThemeRadius | Partial<Record<\"xs\" | \"sm\" | \"md\" | \"lg\" | \"xl\" | \"2xl\", string>>;\n    /**\n     * Opacity of `--tempest-focus-ring-color`. Omit it — the default ring is opaque.\n     *\n     * A translucent ring has no contrast of its own; it has the contrast of\n     * whatever it composites over. Passing a value below `1` reintroduces the\n     * failure 0.61.0 fixed in the built-in tokens, and logs a warning in a\n     * development build. Kept because a translucent ring over a background you\n     * control is a legitimate choice.\n     */\n    focusRingAlpha?: number;\n    /** Selector the light tokens are written under. Default `\":root\"`. */\n    selector?: string;\n    /** Selector the dark tokens are written under. Default `'[data-tempest-theme=\"dark\"]'`. */\n    darkSelector?: string;\n    /**\n     * Also emit the inverse surface — the token set for a section painted in the\n     * brand color — by passing its generator, `createInverseSurface`. Off by\n     * default; ignored without `primary`.\n     *\n     * The generator is passed in rather than switched on with `true` so that\n     * `createTheme` never imports it: an app that does not paint a section in\n     * its brand does not ship the 1.68 kB brotli it costs.\n     *\n     * @example\n     * ```ts\n     * import { createInverseSurface, createTheme } from \"tempest-react-sdk\";\n     *\n     * createTheme({ primary: \"#03184b\", inverse: createInverseSurface });\n     * ```\n     */\n    inverse?: InverseSurfaceGenerator;\n    /** Selector the inverse tokens are written under. Default `'[data-tempest-tone=\"inverse\"]'`. */\n    inverseSelector?: string;\n}\n\n/** A generated theme: token maps per color scheme, plus the CSS text that carries them. */\nexport interface GeneratedTheme {\n    /** Light-scheme custom properties, without the leading `--`-less names (keys include `--`). */\n    light: Record<string, string>;\n    /** Dark-scheme custom properties. */\n    dark: Record<string, string>;\n    /**\n     * Inverse-surface custom properties — literal colors, identical under the\n     * light and the dark page scheme. Present only when the theme names a\n     * `primary` and passes `inverse`.\n     */\n    inverse?: Record<string, string>;\n    /** Both blocks rendered as CSS, ready for {@link applyTheme} or a stylesheet. */\n    css: string;\n}\n\nconst RADIUS_PRESETS: Record<ThemeRadius, Record<string, string>> = {\n    none: { xs: \"0\", sm: \"0\", md: \"0\", lg: \"0\", xl: \"0\", \"2xl\": \"0\" },\n    sm: { xs: \"1px\", sm: \"2px\", md: \"4px\", lg: \"6px\", xl: \"8px\", \"2xl\": \"12px\" },\n    md: { xs: \"2px\", sm: \"4px\", md: \"8px\", lg: \"12px\", xl: \"16px\", \"2xl\": \"24px\" },\n    lg: { xs: \"4px\", sm: \"6px\", md: \"12px\", lg: \"16px\", xl: \"22px\", \"2xl\": \"32px\" },\n    xl: { xs: \"6px\", sm: \"10px\", md: \"16px\", lg: \"24px\", xl: \"32px\", \"2xl\": \"44px\" },\n    full: { xs: \"4px\", sm: \"8px\", md: \"9999px\", lg: \"9999px\", xl: \"9999px\", \"2xl\": \"9999px\" },\n};\n\nconst SCALE_STEPS: ScaleStep[] = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900];\n\nfunction writeScale(tokens: Record<string, string>, name: string, scale: ColorScale): void {\n    for (const step of SCALE_STEPS) {\n        tokens[`--tempest-${name}-${step}`] = scale[step];\n    }\n}\n\n/** Minimum contrast for body text, WCAG 2.x AA. */\nconst AA_TEXT_CONTRAST = 4.5;\n\n/**\n * Choose the ramp step for text sitting on the soft tint.\n *\n * A fixed step does not survive an arbitrary brand color: the built-in blue only\n * reaches 4.37:1 at `500` over its own `50` tint, and a generated emerald lands\n * at 4.41:1 at `600` — both fail AA for body text by a hair. So the step is\n * picked by measuring, walking away from the tint until it clears AA, and\n * falling back to the most extreme candidate when even that cannot (a very light\n * or very desaturated brand).\n *\n * @param scale - The generated ramp.\n * @param softStep - Step used as `--tempest-primary-soft`.\n * @param candidates - Steps to try, in order of preference.\n * @returns The first candidate clearing {@link AA_TEXT_CONTRAST}, else the last.\n */\nfunction pickOnSoftStep(\n    scale: ColorScale,\n    softStep: ScaleStep,\n    candidates: ScaleStep[],\n): ScaleStep {\n    for (const step of candidates) {\n        if (contrastRatio(scale[softStep], scale[step]) >= AA_TEXT_CONTRAST) return step;\n    }\n    return candidates[candidates.length - 1];\n}\n\n/** Minimum contrast for a non-text indicator, WCAG 2.2 SC 1.4.11. */\nconst INDICATOR_CONTRAST = 3;\n\n/**\n * The four surfaces a focus ring can land on, as the SDK's own `colors.css`\n * paints them.\n *\n * Ported from `src/styles/colors.css` (`--tempest-bg`, `--tempest-surface`,\n * `--tempest-surface-2`, `--tempest-surface-3`, resolved through the gray ramp),\n * and pinned by a test that reads that file — a theme that only names `primary`\n * keeps these, so the ring has to be measured against them and not against a\n * guess. The light values resolve through `--tempest-gray-50/100/200`; the dark\n * ones are literals in the dark block.\n */\nconst SDK_SURFACES: Record<\"light\" | \"dark\", readonly string[]> = {\n    light: [\"#ffffff\", \"#f8f9fb\", \"#f1f3f6\", \"#e4e7ec\"],\n    dark: [\"#0b0d12\", \"#14171f\", \"#1d2230\", \"#262d3f\"],\n};\n\n/**\n * Ramp steps to try for the focus ring, in order.\n *\n * `500` first, because the ring should read as the brand when it can, then up\n * the ramp — which moves away from the surfaces in **both** schemes, because\n * `createColorScale` inverts the dark ramp: there `50` is the darkest step (it\n * is what `--tempest-bg` is made of) and `900` the lightest. Walking down in\n * dark mode looks like the right inversion and is the wrong direction; measured,\n * it left a near-black brand's ring at 1.04:1 over its own background.\n */\nconst FOCUS_RING_CANDIDATES: readonly ScaleStep[] = [500, 600, 700, 800, 900];\n\n/**\n * Choose the ramp step for the focus ring, by measuring it against the surfaces\n * it will actually be drawn on.\n *\n * A fixed step does not survive an arbitrary brand, and the measurement says so\n * loudly: of twelve brands checked against the four surfaces in both schemes —\n * 96 pairings — `500` opaque clears 3:1 in 58 of them, and `500` at the old\n * default alpha of 0.35 in 3. Picking the step by measurement clears all 96. The\n * brand from the report that opened this\n * (`#8100D7`) passes in light at 7.20:1 and fails in **dark** at 2.70:1 down to\n * 1.91:1 on `surface-3`; a yellow fails in light at 1.43:1. So the step is\n * picked the way {@link pickOnSoftStep} picks text on a tint: walk away from the\n * surfaces until the ring clears the floor against *all* of them.\n *\n * The fallback is the candidate with the best worst case rather than the last\n * one, because \"the most extreme step\" is not always the most contrasting one\n * once a brand is near-neutral.\n *\n * @param scale - The generated ramp.\n * @param surfaces - The four surfaces this theme will paint, opaque hex.\n * @returns The first candidate clearing {@link INDICATOR_CONTRAST} on every\n *   surface, else the candidate whose weakest pairing is strongest.\n */\nfunction pickFocusRingStep(scale: ColorScale, surfaces: readonly string[]): ScaleStep {\n    const worstCase = (step: ScaleStep): number =>\n        Math.min(...surfaces.map((surface) => contrastRatio(scale[step], surface)));\n    let best: ScaleStep = FOCUS_RING_CANDIDATES[0] as ScaleStep;\n    let bestRatio = -1;\n    for (const step of FOCUS_RING_CANDIDATES) {\n        const measured = worstCase(step);\n        if (measured >= INDICATOR_CONTRAST) return step;\n        if (measured > bestRatio) {\n            best = step;\n            bestRatio = measured;\n        }\n    }\n    return best;\n}\n\n/**\n * The surfaces this theme will actually paint, per scheme.\n *\n * A theme that names `gray` repaints all four, so measuring the ring against the\n * SDK's would be measuring the wrong backdrop — and a theme that does not keeps\n * the SDK's, which is the common case. The order and the ramp steps mirror\n * {@link writeNeutralAliases}, which is what emits them.\n *\n * @param scheme - Which scheme is being emitted.\n * @param grayScales - The generated neutral ramps, when the theme names one.\n * @returns Four opaque hex colors: bg, surface, surface-2, surface-3.\n */\nfunction surfacesOf(\n    scheme: \"light\" | \"dark\",\n    grayScales: { light: ColorScale; dark: ColorScale } | undefined,\n): readonly string[] {\n    if (!grayScales) return SDK_SURFACES[scheme];\n    const scale = grayScales[scheme];\n    return scheme === \"light\"\n        ? [\"#ffffff\", scale[50], scale[100], scale[200]]\n        : [scale[50], scale[100], scale[200], scale[300]];\n}\n\n/**\n * Warn, in a development build, that an alpha was asked for the focus ring.\n *\n * A translucent ring has no contrast of its own — it has the contrast of\n * whatever it composites over — and that is the failure this option used to\n * ship by default: measured at alpha `0.35`, twelve brands across four surfaces\n * and both schemes produced 96 pairings, of which 3 cleared the 3:1 of WCAG 2.2\n * SC 1.4.11. It stays available, because a translucent ring over a\n * known background is a legitimate choice, but it is a choice a theme now has to\n * make on purpose.\n *\n * The warning is the difficult part to notice otherwise: a failing focus ring is\n * visible, it just does not separate.\n *\n * @param focusRingAlpha - The opacity the caller asked for, if any.\n */\nfunction warnOnTranslucentFocusRing(focusRingAlpha: number | undefined): void {\n    if (focusRingAlpha === undefined || focusRingAlpha >= 1) return;\n    if (!isDevBuild()) return;\n    console.warn(\n        `[tempest-react-sdk] createTheme({ focusRingAlpha: ${focusRingAlpha} }) makes the focus ring ` +\n            \"translucent, so its contrast becomes whatever it composites over — measured below the 3:1 \" +\n            \"of WCAG 2.2 SC 1.4.11 on every surface the SDK paints. Drop the option to get the opaque \" +\n            \"ring, which is derived from your brand ramp and measured against those surfaces.\",\n    );\n}\n\n/**\n * Emit the primary aliases for one scheme.\n *\n * The dark scheme walks the ramp the other way (hover is *lighter*, the soft\n * tint is a dark shade, and readable text on that tint is a light shade) — the\n * same inversion the built-in `colors.css` dark block does by hand.\n *\n * The selected-state indicator is derived from the same measurement as the focus\n * ring and emitted as its own token. It never takes `focusRingAlpha`: a\n * translucent ring over a known background is a legitimate choice a theme can\n * make, while a translucent *state* indicator has the contrast of whatever it\n * composites over, which is the defect this token exists to end.\n *\n * @param tokens - The token map for this scheme, written in place.\n * @param scale - The generated primary ramp.\n * @param scheme - Which scheme is being emitted.\n * @param surfaces - The surfaces this theme paints, for the focus-ring measurement.\n * @param focusRingAlpha - Opacity asked for the ring, or `undefined` for opaque.\n */\nfunction writePrimaryAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n    surfaces: readonly string[],\n    focusRingAlpha: number | undefined,\n): void {\n    tokens[\"--tempest-primary\"] = \"var(--tempest-primary-500)\";\n    if (scheme === \"light\") {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-600)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-700)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-50)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 50, [600, 700, 800, 900])})`;\n    } else {\n        tokens[\"--tempest-primary-hover\"] = \"var(--tempest-primary-400)\";\n        tokens[\"--tempest-primary-active\"] = \"var(--tempest-primary-300)\";\n        tokens[\"--tempest-primary-soft\"] = \"var(--tempest-primary-100)\";\n        tokens[\"--tempest-primary-soft-hover\"] = \"var(--tempest-primary-200)\";\n        tokens[\"--tempest-primary-on-soft\"] =\n            `var(--tempest-primary-${pickOnSoftStep(scale, 100, [700, 800, 900])})`;\n    }\n\n    const foreground = readableForeground(scale[500]);\n    tokens[\"--tempest-primary-foreground\"] = foreground;\n    tokens[\"--tempest-text-on-primary\"] = foreground;\n    const ring = scale[pickFocusRingStep(scale, surfaces)];\n    tokens[\"--tempest-focus-ring-color\"] =\n        focusRingAlpha === undefined || focusRingAlpha >= 1\n            ? ring\n            : hexToRgbaString(ring, focusRingAlpha);\n    tokens[\"--tempest-selected-indicator\"] = ring;\n}\n\n/**\n * Emit the neutral surface/border/text aliases from a generated gray scale.\n *\n * `--tempest-bg` is pushed past the ramp on purpose: pure white in light mode and\n * a shade darker than `gray-50` in dark mode, so a raised surface still reads as\n * raised against the page.\n */\nfunction writeNeutralAliases(\n    tokens: Record<string, string>,\n    scale: ColorScale,\n    scheme: \"light\" | \"dark\",\n): void {\n    if (scheme === \"light\") {\n        tokens[\"--tempest-bg\"] = \"#ffffff\";\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-50)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-600)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-500)\";\n    } else {\n        tokens[\"--tempest-bg\"] = scale[50];\n        tokens[\"--tempest-surface\"] = \"var(--tempest-gray-100)\";\n        tokens[\"--tempest-surface-2\"] = \"var(--tempest-gray-200)\";\n        tokens[\"--tempest-surface-3\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border\"] = \"var(--tempest-gray-300)\";\n        tokens[\"--tempest-border-strong\"] = \"var(--tempest-gray-400)\";\n        tokens[\"--tempest-text\"] = \"var(--tempest-gray-900)\";\n        tokens[\"--tempest-text-muted\"] = \"var(--tempest-gray-700)\";\n        tokens[\"--tempest-text-subtle\"] = \"var(--tempest-gray-600)\";\n    }\n    tokens[\"--tempest-neutral-on-solid\"] = readableForeground(scale[700], \"#ffffff\", ON_SOLID_INK);\n}\n\nfunction renderBlock(selector: string, tokens: Record<string, string>): string {\n    const entries = Object.entries(tokens);\n    if (entries.length === 0) return \"\";\n    const body = entries.map(([name, value]) => `    ${name}: ${value};`).join(\"\\n\");\n    return `${selector} {\\n${body}\\n}`;\n}\n\n/**\n * Generate `--tempest-*` overrides from a small brand description.\n *\n * Only the families you pass are generated; everything else falls through to the\n * SDK's own tokens, so a theme stays a patch and not a fork of `colors.css`.\n *\n * @example\n * ```ts\n * import { applyTheme, createTheme } from \"tempest-react-sdk\";\n *\n * const theme = createTheme({\n *   primary: \"#7c3aed\",\n *   radius: \"lg\",\n *   chart: [\"#7c3aed\", \"#0ea5e9\", \"#22c55e\", \"#f59e0b\"],\n * });\n *\n * applyTheme(theme);\n * ```\n *\n * @param options - Brand colors plus optional radius / chart / focus-ring tuning.\n * @returns The light and dark token maps and the CSS text that carries them.\n */\nexport function createTheme(options: CreateThemeOptions = {}): GeneratedTheme {\n    const {\n        primary,\n        gray,\n        chart,\n        radius,\n        focusRingAlpha,\n        selector = \":root\",\n        darkSelector = '[data-tempest-theme=\"dark\"]',\n        inverse,\n        inverseSelector = INVERSE_SELECTOR,\n    } = options;\n\n    warnOnTranslucentFocusRing(focusRingAlpha);\n\n    const light: Record<string, string> = {};\n    const dark: Record<string, string> = {};\n\n    // `anchor: false`: a neutral ramp has to keep its tuned lightness curve.\n    // Anchoring it at the input compressed both halves and dropped\n    // text-muted-on-surface-3 to ~4.2:1 — below AA — which the browser axe\n    // sweep caught on the generated themes.\n    const grayScales = gray\n        ? {\n              light: createColorScale(gray, \"light\", { anchor: false, neutral: true }),\n              dark: createColorScale(gray, \"dark\", { anchor: false, neutral: true }),\n          }\n        : undefined;\n\n    if (primary) {\n        const lightScale = createColorScale(primary, \"light\");\n        const darkScale = createColorScale(primary, \"dark\");\n        writeScale(light, \"primary\", lightScale);\n        writeScale(dark, \"primary\", darkScale);\n        writePrimaryAliases(\n            light,\n            lightScale,\n            \"light\",\n            surfacesOf(\"light\", grayScales),\n            focusRingAlpha,\n        );\n        writePrimaryAliases(\n            dark,\n            darkScale,\n            \"dark\",\n            surfacesOf(\"dark\", grayScales),\n            focusRingAlpha,\n        );\n    }\n\n    if (grayScales) {\n        writeScale(light, \"gray\", grayScales.light);\n        writeScale(dark, \"gray\", grayScales.dark);\n        writeNeutralAliases(light, grayScales.light, \"light\");\n        writeNeutralAliases(dark, grayScales.dark, \"dark\");\n    }\n\n    for (const status of THEME_STATUSES) {\n        const value = options[status];\n        if (!value) continue;\n        writeStatus(light, status, createColorScale(value, \"light\"), \"light\");\n        writeStatus(dark, status, createColorScale(value, \"dark\"), \"dark\");\n    }\n\n    if (chart?.length) {\n        chart.forEach((color, index) => {\n            light[`--tempest-chart-${index + 1}`] = color;\n        });\n        // Declares how many series colors this theme owns. Without it the reader\n        // keeps walking into the SDK's built-in `--tempest-chart-7`/`-8`, so a\n        // 6-color brand palette silently mixes with two leftover defaults — which\n        // is exactly what a 7-series chart would show.\n        light[\"--tempest-chart-count\"] = String(chart.length);\n    }\n\n    /*\n     * Continuous scales follow the brand too.\n     *\n     * Without this a rebranded app gets its categorical slots recoloured and then a\n     * heatmap still painted in the SDK's blue — the one chart on the page that\n     * silently ignores the brand. Both scales derive from the first series hue (or\n     * the primary), stepped by perceptual lightness for each mode separately.\n     *\n     * Skipped entirely when the theme names no colour to derive from, so the\n     * built-in tokens survive instead of being overwritten with a guess.\n     */\n    const scaleSource = chart?.[0] ?? primary;\n    if (scaleSource) {\n        const coolHue = hueOf(scaleSource);\n        // The opposite pole: the brand's own danger colour when it has one, since a\n        // diverging scale's warm arm and \"bad\" should not disagree on screen.\n        const warmHue = options.danger ? hueOf(options.danger) : (coolHue + 180) % 360;\n        for (const [target, mode] of [\n            [light, \"light\"],\n            [dark, \"dark\"],\n        ] as const) {\n            buildRamp(coolHue, mode).forEach((stepColor, index) => {\n                target[`--tempest-chart-sequential-${index + 1}`] = stepColor;\n            });\n            const diverging = buildDivergingRamp({\n                coolHue,\n                warmHue,\n                mid: mode === \"light\" ? \"#e4e7ec\" : \"#262d3f\",\n                mode,\n            });\n            [...diverging.cool, diverging.mid, ...diverging.warm].forEach((stepColor, index) => {\n                target[`--tempest-chart-diverging-${index + 1}`] = stepColor;\n            });\n        }\n    }\n\n    if (radius) {\n        const steps = typeof radius === \"string\" ? RADIUS_PRESETS[radius] : radius;\n        for (const [step, value] of Object.entries(steps)) {\n            light[`--tempest-radius-${step}`] = value;\n        }\n    }\n\n    const inverseSurface =\n        primary && inverse\n            ? inverse({\n                  primary,\n                  statuses: {\n                      success: options.success,\n                      warning: options.warning,\n                      danger: options.danger,\n                      info: options.info,\n                  },\n                  chart,\n                  selector: inverseSelector,\n                  page: { selector, darkSelector },\n              })\n            : null;\n\n    const css = [\n        renderBlock(selector, light),\n        renderBlock(darkSelector, dark),\n        inverseSurface ? renderInverseSurface(inverseSelector, inverseSurface) : \"\",\n    ]\n        .filter(Boolean)\n        .join(\"\\n\\n\");\n\n    return inverseSurface\n        ? { light, dark, inverse: inverseSurface.tokens, css }\n        : { light, dark, css };\n}\n\n/**\n * Contrast ratio of `--tempest-primary-foreground` over the brand color.\n *\n * Exposed so an app (or a test) can assert its own brand clears WCAG AA (4.5) for\n * body text or AA-large (3.0) for button labels, instead of trusting the pick.\n *\n * @param options - The same input given to {@link createTheme}.\n * @returns The ratio, or `null` when no `primary` was provided.\n */\nexport function themeContrast(options: CreateThemeOptions): number | null {\n    if (!options.primary) return null;\n    const scale = createColorScale(options.primary, \"light\");\n    return contrastRatio(scale[500], readableForeground(scale[500]));\n}\n"],"mappings":"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"}

package/dist/theme/data-viz-ramps.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-viz-ramps.cjs","names":[],"sources":["../../src/theme/data-viz-ramps.ts"],"sourcesContent":["import { contrastRatio, hexToOklch, oklchToHex } from \"./color\";\n\n/** Number of steps in a sequential ramp. */\nexport const SEQUENTIAL_STEPS = 7;\n\n/** Steps per arm of a diverging scale, excluding the neutral midpoint. */\nexport const DIVERGING_ARM_STEPS = 4;\n\n/** A diverging scale: cool arm (extreme → near-mid), the midpoint, then the warm arm. */\nexport interface DivergingRamp {\n    cool: string[];\n    mid: string;\n    warm: string[];\n}\n\n/**\n * Lightness range a ramp spans, per mode.\n *\n * Dark mode is **selected, not flipped**: its own band, chosen for the dark surface.\n * Mechanically inverting the light ramp yields steps that are either invisible\n * against a near-black surface or so bright they read as highlights.\n */\nconst BAND = {\n    light: { from: 0.93, to: 0.34 },\n    dark: { from: 0.28, to: 0.86 },\n} as const;\n\n/**\n * Chroma shaped as a dome across the ramp.\n *\n * A constant chroma makes the pale end look muddy and the dark end look neon. The\n * dome keeps the extremes believable while the middle carries the hue, which is\n * what makes a heatmap readable at a glance.\n *\n * @param t - Position along the ramp, `0`–`1`.\n * @returns A multiplier for the peak chroma.\n */\nfunction chromaDome(t: number): number {\n    return 0.35 + 0.65 * (1 - Math.abs(2 * t - 1) ** 1.6);\n}\n\nexport interface BuildRampOptions {\n    /** How many steps to emit. Defaults to {@link SEQUENTIAL_STEPS}. */\n    steps?: number;\n    /** Chroma at the middle of the ramp. */\n    peakChroma?: number;\n}\n\n/**\n * Build a single-hue ramp with evenly spaced perceptual lightness.\n *\n * Even spacing in OKLCH lightness — not in RGB — is what makes equal data steps look\n * like equal colour steps.\n *\n * Steps come back in **token order**: index 0 is the end that means \"near zero\", so\n * it is the lightest on a light canvas and the darkest on a dark one. That is the\n * order `--tempest-chart-sequential-1…7` is written in, and it makes index 0 the step\n * nearest the surface in both modes — which is what `ordinalStart` walks from.\n * Returning a fixed light→dark order instead would put token 1 at opposite ends of\n * the scale depending on the mode, and a dark theme would paint every heatmap\n * inverted.\n *\n * @param hue - OKLCH hue in degrees.\n * @param mode - Which lightness band to span.\n * @param options - Shape of the ramp: `steps` (how many to emit) and `peakChroma`\n *   (chroma at the middle).\n * @returns Hex steps, near-zero end first.\n */\nexport function buildRamp(\n    hue: number,\n    mode: \"light\" | \"dark\",\n    { steps = SEQUENTIAL_STEPS, peakChroma = 0.19 }: BuildRampOptions = {},\n): string[] {\n    const band = BAND[mode];\n    const out: string[] = [];\n    for (let i = 0; i < steps; i += 1) {\n        const t = steps === 1 ? 0 : i / (steps - 1);\n        out.push(\n            oklchToHex({\n                l: band.from + (band.to - band.from) * t,\n                c: peakChroma * chromaDome(t),\n                h: hue,\n            }),\n        );\n    }\n    return out;\n}\n\n/**\n * The first index of `ramp` that clears `minContrast` against `surface`.\n *\n * A **sequential** ramp may let its near-zero end recede into the surface — that is\n * what \"almost nothing\" should look like on a heatmap. An **ordinal** ramp may not:\n * every step is a discrete mark a reader has to see. This is how a consumer finds\n * where the ordinal-safe slice of a sequential ramp begins.\n *\n * @param ramp - Hex steps in token order, near-zero end first.\n * @param surface - The chart surface the ramp sits on.\n * @param minContrast - Floor to clear. Default `2` — the ordinal floor.\n * @returns The first safe index, or `0` when every step already clears it.\n */\nexport function ordinalStart(ramp: string[], surface: string, minContrast = 2): number {\n    const index = ramp.findIndex((step) => contrastRatio(step, surface) >= minContrast);\n    return index < 0 ? ramp.length - 1 : index;\n}\n\n/**\n * Build a diverging scale from two opposing hues around a neutral midpoint.\n *\n * The midpoint is **grey, never a hue**: a coloured midpoint reads as a third\n * category instead of as \"no deviation\", which is the one thing a diverging scale\n * exists to show. The arms get equal step counts so neither side looks like it\n * carries more range than the other.\n *\n * @param params.coolHue - OKLCH hue for the negative arm.\n * @param params.warmHue - OKLCH hue for the positive arm.\n * @param params.mid - Neutral midpoint, in hex.\n * @param params.mode - Which lightness band to span.\n * @param params.steps - Steps per arm.\n * @returns The scale, each arm ordered extreme → nearest the midpoint.\n */\nexport function buildDivergingRamp({\n    coolHue,\n    warmHue,\n    mid,\n    mode,\n    steps = DIVERGING_ARM_STEPS,\n}: {\n    coolHue: number;\n    warmHue: number;\n    mid: string;\n    mode: \"light\" | \"dark\";\n    steps?: number;\n}): DivergingRamp {\n    /*\n     * Each arm spans from its extreme to just short of the midpoint, so the two\n     * arms together read as one continuous scale rather than two ramps abutting.\n     */\n    const band = mode === \"light\" ? { from: 0.86, to: 0.4 } : { from: 0.82, to: 0.42 };\n    const arm = (hue: number): string[] => {\n        const out: string[] = [];\n        for (let i = 0; i < steps; i += 1) {\n            const t = steps === 1 ? 0 : i / (steps - 1);\n            out.push(\n                oklchToHex({\n                    l: band.from + (band.to - band.from) * t,\n                    c: 0.17 * chromaDome(1 - t * 0.5),\n                    h: hue,\n                }),\n            );\n        }\n        return out.reverse();\n    };\n    return { cool: arm(coolHue), mid, warm: [...arm(warmHue)].reverse() };\n}\n\n/**\n * The hue of a hex colour, for feeding the ramp builders.\n *\n * @param hex - Any hex colour.\n * @returns Its OKLCH hue in degrees.\n */\nexport function hueOf(hex: string): number {\n    return hexToOklch(hex).h;\n}\n"],"mappings":"+BAsBA,IAAM,EAAO,CACT,MAAO,CAAE,KAAM,IAAM,GAAI,GAAK,EAC9B,KAAM,CAAE,KAAM,IAAM,GAAI,GAAK,CACjC,EAYA,SAAS,EAAW,EAAmB,CACnC,MAAO,KAAO,KAAQ,EAAI,KAAK,IAAI,EAAI,EAAI,CAAC,GAAK,IACrD,CA6BA,SAAgB,EACZ,EACA,EACA,CAAE,QAAA,EAA0B,aAAa,KAA2B,CAAC,EAC7D,CACR,IAAM,EAAO,EAAK,GACZ,EAAgB,CAAC,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,GAAK,EAAG,CAC/B,IAAM,EAAI,IAAU,EAAI,EAAI,GAAK,EAAQ,GACzC,EAAI,KACA,EAAA,WAAW,CACP,EAAG,EAAK,MAAQ,EAAK,GAAK,EAAK,MAAQ,EACvC,EAAG,EAAa,EAAW,CAAC,EAC5B,EAAG,CACP,CAAC,CACL,CACJ,CACA,OAAO,CACX,CAmCA,SAAgB,EAAmB,CAC/B,UACA,UACA,MACA,OACA,QAAA,GAOc,CAKd,IAAM,EAAO,IAAS,QAAU,CAAE,KAAM,IAAM,GAAI,EAAI,EAAI,CAAE,KAAM,IAAM,GAAI,GAAK,EAC3E,EAAO,GAA0B,CACnC,IAAM,EAAgB,CAAC,EACvB,IAAK,IAAI,EAAI,EAAG,EAAI,EAAO,GAAK,EAAG,CAC/B,IAAM,EAAI,IAAU,EAAI,EAAI,GAAK,EAAQ,GACzC,EAAI,KACA,EAAA,WAAW,CACP,EAAG,EAAK,MAAQ,EAAK,GAAK,EAAK,MAAQ,EACvC,EAAG,IAAO,EAAW,EAAI,EAAI,EAAG,EAChC,EAAG,CACP,CAAC,CACL,CACJ,CACA,OAAO,EAAI,QAAQ,CACvB,EACA,MAAO,CAAE,KAAM,EAAI,CAAO,EAAG,MAAK,KAAM,CAAC,GAAG,EAAI,CAAO,CAAC,CAAC,CAAC,QAAQ,CAAE,CACxE,CAQA,SAAgB,EAAM,EAAqB,CACvC,OAAO,EAAA,WAAW,CAAG,CAAC,CAAC,CAC3B"}
+{"version":3,"file":"data-viz-ramps.cjs","names":["oklchToHex","hexToOklch","require_color","BAND","chromaDome","t","buildRamp","band","mode","out","i","steps","peakChroma","hue","buildDivergingRamp","arm","coolHue","warmHue","hueOf","hex"],"sources":["../../src/theme/data-viz-ramps.ts"],"sourcesContent":["import { contrastRatio, hexToOklch, oklchToHex } from \"./color\";\n\n/** Number of steps in a sequential ramp. */\nexport const SEQUENTIAL_STEPS = 7;\n\n/** Steps per arm of a diverging scale, excluding the neutral midpoint. */\nexport const DIVERGING_ARM_STEPS = 4;\n\n/** A diverging scale: cool arm (extreme → near-mid), the midpoint, then the warm arm. */\nexport interface DivergingRamp {\n    cool: string[];\n    mid: string;\n    warm: string[];\n}\n\n/**\n * Lightness range a ramp spans, per mode.\n *\n * Dark mode is **selected, not flipped**: its own band, chosen for the dark surface.\n * Mechanically inverting the light ramp yields steps that are either invisible\n * against a near-black surface or so bright they read as highlights.\n */\nconst BAND = {\n    light: { from: 0.93, to: 0.34 },\n    dark: { from: 0.28, to: 0.86 },\n} as const;\n\n/**\n * Chroma shaped as a dome across the ramp.\n *\n * A constant chroma makes the pale end look muddy and the dark end look neon. The\n * dome keeps the extremes believable while the middle carries the hue, which is\n * what makes a heatmap readable at a glance.\n *\n * @param t - Position along the ramp, `0`–`1`.\n * @returns A multiplier for the peak chroma.\n */\nfunction chromaDome(t: number): number {\n    return 0.35 + 0.65 * (1 - Math.abs(2 * t - 1) ** 1.6);\n}\n\nexport interface BuildRampOptions {\n    /** How many steps to emit. Defaults to {@link SEQUENTIAL_STEPS}. */\n    steps?: number;\n    /** Chroma at the middle of the ramp. */\n    peakChroma?: number;\n}\n\n/**\n * Build a single-hue ramp with evenly spaced perceptual lightness.\n *\n * Even spacing in OKLCH lightness — not in RGB — is what makes equal data steps look\n * like equal colour steps.\n *\n * Steps come back in **token order**: index 0 is the end that means \"near zero\", so\n * it is the lightest on a light canvas and the darkest on a dark one. That is the\n * order `--tempest-chart-sequential-1…7` is written in, and it makes index 0 the step\n * nearest the surface in both modes — which is what `ordinalStart` walks from.\n * Returning a fixed light→dark order instead would put token 1 at opposite ends of\n * the scale depending on the mode, and a dark theme would paint every heatmap\n * inverted.\n *\n * @param hue - OKLCH hue in degrees.\n * @param mode - Which lightness band to span.\n * @param options - Shape of the ramp: `steps` (how many to emit) and `peakChroma`\n *   (chroma at the middle).\n * @returns Hex steps, near-zero end first.\n */\nexport function buildRamp(\n    hue: number,\n    mode: \"light\" | \"dark\",\n    { steps = SEQUENTIAL_STEPS, peakChroma = 0.19 }: BuildRampOptions = {},\n): string[] {\n    const band = BAND[mode];\n    const out: string[] = [];\n    for (let i = 0; i < steps; i += 1) {\n        const t = steps === 1 ? 0 : i / (steps - 1);\n        out.push(\n            oklchToHex({\n                l: band.from + (band.to - band.from) * t,\n                c: peakChroma * chromaDome(t),\n                h: hue,\n            }),\n        );\n    }\n    return out;\n}\n\n/**\n * The first index of `ramp` that clears `minContrast` against `surface`.\n *\n * A **sequential** ramp may let its near-zero end recede into the surface — that is\n * what \"almost nothing\" should look like on a heatmap. An **ordinal** ramp may not:\n * every step is a discrete mark a reader has to see. This is how a consumer finds\n * where the ordinal-safe slice of a sequential ramp begins.\n *\n * @param ramp - Hex steps in token order, near-zero end first.\n * @param surface - The chart surface the ramp sits on.\n * @param minContrast - Floor to clear. Default `2` — the ordinal floor.\n * @returns The first safe index, or `0` when every step already clears it.\n */\nexport function ordinalStart(ramp: string[], surface: string, minContrast = 2): number {\n    const index = ramp.findIndex((step) => contrastRatio(step, surface) >= minContrast);\n    return index < 0 ? ramp.length - 1 : index;\n}\n\n/**\n * Build a diverging scale from two opposing hues around a neutral midpoint.\n *\n * The midpoint is **grey, never a hue**: a coloured midpoint reads as a third\n * category instead of as \"no deviation\", which is the one thing a diverging scale\n * exists to show. The arms get equal step counts so neither side looks like it\n * carries more range than the other.\n *\n * @param params.coolHue - OKLCH hue for the negative arm.\n * @param params.warmHue - OKLCH hue for the positive arm.\n * @param params.mid - Neutral midpoint, in hex.\n * @param params.mode - Which lightness band to span.\n * @param params.steps - Steps per arm.\n * @returns The scale, each arm ordered extreme → nearest the midpoint.\n */\nexport function buildDivergingRamp({\n    coolHue,\n    warmHue,\n    mid,\n    mode,\n    steps = DIVERGING_ARM_STEPS,\n}: {\n    coolHue: number;\n    warmHue: number;\n    mid: string;\n    mode: \"light\" | \"dark\";\n    steps?: number;\n}): DivergingRamp {\n    /*\n     * Each arm spans from its extreme to just short of the midpoint, so the two\n     * arms together read as one continuous scale rather than two ramps abutting.\n     */\n    const band = mode === \"light\" ? { from: 0.86, to: 0.4 } : { from: 0.82, to: 0.42 };\n    const arm = (hue: number): string[] => {\n        const out: string[] = [];\n        for (let i = 0; i < steps; i += 1) {\n            const t = steps === 1 ? 0 : i / (steps - 1);\n            out.push(\n                oklchToHex({\n                    l: band.from + (band.to - band.from) * t,\n                    c: 0.17 * chromaDome(1 - t * 0.5),\n                    h: hue,\n                }),\n            );\n        }\n        return out.reverse();\n    };\n    return { cool: arm(coolHue), mid, warm: [...arm(warmHue)].reverse() };\n}\n\n/**\n * The hue of a hex colour, for feeding the ramp builders.\n *\n * @param hex - Any hex colour.\n * @returns Its OKLCH hue in degrees.\n */\nexport function hueOf(hex: string): number {\n    return hexToOklch(hex).h;\n}\n"],"mappings":"A,+BAsBA,IAAMG,EAAO,CACT,MAAO,CAAE,KAAM,IAAM,GAAI,GAAK,EAC9B,KAAM,CAAE,KAAM,IAAM,GAAI,GAAK,CACjC,EAYA,SAASC,EAAW,EAAmB,CACnC,MAAO,KAAO,KAAQ,EAAI,KAAK,IAAI,EAAIC,EAAI,CAAC,GAAK,IACrD,CA6BA,SAAgBC,EACZ,EACA,EACA,CAAE,QAAA,EAA0B,aAAa,KAA2B,CAAC,EAC7D,CACR,IAAMC,EAAOJ,EAAKK,GACZC,EAAgB,CAAC,EACvB,IAAK,IAAIC,EAAI,EAAGA,EAAIC,EAAO,GAAK,EAAG,CAC/B,IAAMN,EAAIM,IAAU,EAAI,EAAID,GAAKC,EAAQ,GACzCF,EAAI,KACAT,EAAAA,WAAW,CACP,EAAGO,EAAK,MAAQA,EAAK,GAAKA,EAAK,MAAQF,EACvC,EAAGO,EAAaR,EAAWC,CAAC,EAC5B,EAAGQ,CACP,CAAC,CACL,CACJ,CACA,OAAOJ,CACX,CAmCA,SAAgBK,EAAmB,CAC/B,UACA,UACA,MACA,OACA,QAAA,GAOc,CAKd,IAAMP,EAAOC,IAAS,QAAU,CAAE,KAAM,IAAM,GAAI,EAAI,EAAI,CAAE,KAAM,IAAM,GAAI,GAAK,EAC3EO,EAAO,GAA0B,CACnC,IAAMN,EAAgB,CAAC,EACvB,IAAK,IAAI,EAAI,EAAG,EAAIE,EAAO,GAAK,EAAG,CAC/B,IAAMN,EAAIM,IAAU,EAAI,EAAI,GAAKA,EAAQ,GACzCF,EAAI,KACAT,EAAAA,WAAW,CACP,EAAGO,EAAK,MAAQA,EAAK,GAAKA,EAAK,MAAQF,EACvC,EAAG,IAAOD,EAAW,EAAIC,EAAI,EAAG,EAChC,EAAGQ,CACP,CAAC,CACL,CACJ,CACA,OAAOJ,EAAI,QAAQ,CACvB,EACA,MAAO,CAAE,KAAMM,EAAIC,CAAO,EAAG,MAAK,KAAM,CAAC,GAAGD,EAAIE,CAAO,CAAC,CAAC,CAAC,QAAQ,CAAE,CACxE,CAQA,SAAgBC,EAAM,EAAqB,CACvC,OAAOjB,EAAAA,WAAWkB,CAAG,CAAC,CAAC,CAC3B,C"}