@epilot/spark-ui 1.0.0-alpha.7 → 1.0.0-alpha.9

package/dist/generate-radix-colors-C5mWRWnQ.d.cts

@@ -0,0 +1,33 @@
+"use client";
+
+//#region src/lib/generate-radix-colors.d.ts
+type ArrayOf12<T> = [T, T, T, T, T, T, T, T, T, T, T, T];
+declare const generateRadixColors: ({
+  appearance,
+  ...args
+}: {
+  appearance: "light" | "dark";
+  accent: string;
+  gray: string;
+  background: string;
+}) => {
+  accentScale: ArrayOf12<string>;
+  accentScaleAlpha: ArrayOf12<string>;
+  accentScaleWideGamut: ArrayOf12<string>;
+  accentScaleAlphaWideGamut: ArrayOf12<string>;
+  accentContrast: string;
+  grayScale: ArrayOf12<string>;
+  grayScaleAlpha: ArrayOf12<string>;
+  grayScaleWideGamut: ArrayOf12<string>;
+  grayScaleAlphaWideGamut: ArrayOf12<string>;
+  graySurface: string;
+  graySurfaceWideGamut: string;
+  accentSurface: string;
+  accentSurfaceWideGamut: string;
+  background: string;
+};
+declare function transposeProgressionStart(to: number, arr: number[], curve: [number, number, number, number]): number[];
+declare function transposeProgressionEnd(to: number, arr: number[], curve: [number, number, number, number]): number[];
+//#endregion
+export { transposeProgressionEnd as n, transposeProgressionStart as r, generateRadixColors as t };
+//# sourceMappingURL=generate-radix-colors-C5mWRWnQ.d.cts.map

package/dist/{accent-colors-CjHCf8fH.cjs → lib/accent-colors.cjs}

@@ -1,4 +1,5 @@
 "use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region src/lib/accent-colors.ts
 const accentByColor = {
 	accent: void 0,
@@ -8,11 +9,6 @@ const accentByColor = {
 	danger: "red"
 };
 //#endregion
-Object.defineProperty(exports, "accentByColor", {
-	enumerable: true,
-	get: function() {
-		return accentByColor;
-	}
-});
+exports.accentByColor = accentByColor;
 
-//# sourceMappingURL=accent-colors-CjHCf8fH.cjs.map
+//# sourceMappingURL=accent-colors.cjs.map

package/dist/lib/accent-colors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-colors.cjs","names":[],"sources":["../../src/lib/accent-colors.ts"],"sourcesContent":["export type SparkAccentColor =\n  | 'accent'\n  | 'neutral'\n  | 'success'\n  | 'warning'\n  | 'danger'\n\nexport const accentByColor: Record<\n  SparkAccentColor,\n  'gray' | 'red' | 'green' | 'orange' | undefined\n> = {\n  accent: undefined,\n  neutral: 'gray',\n  success: 'green',\n  warning: 'orange',\n  danger: 'red',\n}\n"],"mappings":";;;AAOA,MAAa,gBAGT;CACF,QAAQ,KAAA;CACR,SAAS;CACT,SAAS;CACT,SAAS;CACT,QAAQ;CACT"}

package/dist/lib/accent-colors.d.cts

@@ -0,0 +1,8 @@
+"use client";
+
+//#region src/lib/accent-colors.d.ts
+type SparkAccentColor = 'accent' | 'neutral' | 'success' | 'warning' | 'danger';
+declare const accentByColor: Record<SparkAccentColor, 'gray' | 'red' | 'green' | 'orange' | undefined>;
+//#endregion
+export { SparkAccentColor, accentByColor };
+//# sourceMappingURL=accent-colors.d.cts.map

package/dist/lib/accent-colors.d.ts

@@ -0,0 +1,8 @@
+"use client";
+
+//#region src/lib/accent-colors.d.ts
+type SparkAccentColor = 'accent' | 'neutral' | 'success' | 'warning' | 'danger';
+declare const accentByColor: Record<SparkAccentColor, 'gray' | 'red' | 'green' | 'orange' | undefined>;
+//#endregion
+export { SparkAccentColor, accentByColor };
+//# sourceMappingURL=accent-colors.d.ts.map

package/dist/{accent-colors-Ch2J0EEY.js → lib/accent-colors.js}

@@ -8,6 +8,6 @@ const accentByColor = {
 	danger: "red"
 };
 //#endregion
-export { accentByColor as t };
+export { accentByColor };
 
-//# sourceMappingURL=accent-colors-Ch2J0EEY.js.map
+//# sourceMappingURL=accent-colors.js.map

package/dist/lib/accent-colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-colors.js","names":[],"sources":["../../src/lib/accent-colors.ts"],"sourcesContent":["export type SparkAccentColor =\n  | 'accent'\n  | 'neutral'\n  | 'success'\n  | 'warning'\n  | 'danger'\n\nexport const accentByColor: Record<\n  SparkAccentColor,\n  'gray' | 'red' | 'green' | 'orange' | undefined\n> = {\n  accent: undefined,\n  neutral: 'gray',\n  success: 'green',\n  warning: 'orange',\n  danger: 'red',\n}\n"],"mappings":";;AAOA,MAAa,gBAGT;CACF,QAAQ,KAAA;CACR,SAAS;CACT,SAAS;CACT,SAAS;CACT,QAAQ;CACT"}

package/dist/lib/accent-theme.cjs

@@ -0,0 +1,130 @@
+"use client";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_chunk = require("../chunk-aJGBMT86.cjs");
+const require_lib_generate_radix_colors = require("./generate-radix-colors.cjs");
+let _radix_ui_colors = require("@radix-ui/colors");
+_radix_ui_colors = require_chunk.__toESM(_radix_ui_colors, 1);
+let colorjs_io = require("colorjs.io");
+colorjs_io = require_chunk.__toESM(colorjs_io, 1);
+//#region src/lib/accent-theme.ts
+/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */
+const CURATED_ACCENTS = {
+	blue: _radix_ui_colors.blue.blue9,
+	indigo: _radix_ui_colors.indigo.indigo9,
+	violet: _radix_ui_colors.violet.violet9,
+	purple: _radix_ui_colors.purple.purple9,
+	cyan: _radix_ui_colors.cyan.cyan9,
+	teal: _radix_ui_colors.teal.teal9,
+	green: _radix_ui_colors.green.green9,
+	grass: _radix_ui_colors.grass.grass9,
+	orange: _radix_ui_colors.orange.orange9,
+	red: _radix_ui_colors.red.red9,
+	pink: _radix_ui_colors.pink.pink9,
+	gray: _radix_ui_colors.gray.gray9
+};
+/** ECP `DesignUtils` generator inputs, so a generated scale matches live portals. */
+const DEFAULTS = {
+	light: {
+		gray: "#333333",
+		background: "#ffffff"
+	},
+	dark: {
+		gray: "#8b8d98",
+		background: "#000000"
+	}
+};
+/** Generate the Radix-style accent scale for one appearance from a single accent color. */
+function generateAccentScale(accent, appearance) {
+	const scale = require_lib_generate_radix_colors.generateRadixColors({
+		appearance,
+		accent,
+		gray: DEFAULTS[appearance].gray,
+		background: DEFAULTS[appearance].background
+	});
+	return {
+		...scale,
+		accentContrast: readableContrast(scale, MIN_TEXT_CONTRAST),
+		accentOnSolid: readableContrast(scale, MIN_GRAPHIC_CONTRAST)
+	};
+}
+const MIN_TEXT_CONTRAST = 4.5;
+const MIN_GRAPHIC_CONTRAST = 3;
+function readableContrast(scale, min) {
+	const step9 = new colorjs_io.default(scale.accentScale[8]);
+	const [, chroma, hue] = step9.to("oklch").coords;
+	const tinted = (lightness) => new colorjs_io.default("oklch", [
+		lightness,
+		Math.max(.08 * (chroma ?? 0), .04),
+		hue ?? 0
+	]).to("srgb").toString({ format: "hex" });
+	const candidates = [
+		scale.accentContrast,
+		tinted(.25),
+		tinted(.15)
+	];
+	const ratios = candidates.map((c) => new colorjs_io.default(c).contrast(step9, "WCAG21"));
+	const passing = ratios.findIndex((r) => r >= min);
+	if (passing !== -1) return candidates[passing];
+	return candidates[ratios.indexOf(Math.max(...ratios))];
+}
+/** sRGB `--spark-*` declarations for a generated accent scale. */
+function accentSparkVars(scale) {
+	return sparkVars(scale.accentScale, scale.accentScaleAlpha, scale.accentContrast, scale.accentOnSolid, scale.accentSurface, scale.background);
+}
+/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */
+function accentSparkVarsP3(scale) {
+	return sparkVars(scale.accentScaleWideGamut, scale.accentScaleAlphaWideGamut, scale.accentContrast, scale.accentOnSolid, scale.accentSurfaceWideGamut, scale.background);
+}
+/** Radix's `grayColor="auto"` pairing (accent family → gray), mapped to our 6 neutrals. */
+const NEUTRAL_BY_ACCENT = {
+	blue: "slate",
+	indigo: "slate",
+	cyan: "slate",
+	violet: "mauve",
+	purple: "mauve",
+	pink: "mauve",
+	red: "mauve",
+	teal: "sage",
+	green: "sage",
+	grass: "olive",
+	orange: "sand",
+	gray: "gray"
+};
+/** Radix's "auto" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */
+function getMatchingNeutral(accent) {
+	const byName = NEUTRAL_BY_ACCENT[accent];
+	if (byName) return byName;
+	try {
+		const [, chroma, hueRaw] = new colorjs_io.default(accent).to("oklch").coords;
+		if (!chroma || chroma < .04) return "gray";
+		const hue = ((hueRaw ?? 0) % 360 + 360) % 360;
+		if (hue >= 300 || hue < 35) return "mauve";
+		if (hue < 115) return "sand";
+		if (hue < 145) return "olive";
+		if (hue < 200) return "sage";
+		return "slate";
+	} catch {
+		return "slate";
+	}
+}
+function sparkVars(steps, alpha, contrast, onSolid, surface, background) {
+	const indicator = steps[8];
+	return [
+		...steps.map((c, i) => `--spark-${i + 1}: ${c};`),
+		...alpha.map((c, i) => `--spark-a${i + 1}: ${c};`),
+		`--spark-contrast: ${contrast};`,
+		`--spark-on-solid: ${onSolid};`,
+		`--spark-surface: ${surface};`,
+		`--spark-background: ${background};`,
+		`--spark-indicator: ${indicator};`,
+		`--spark-track: ${indicator};`
+	];
+}
+//#endregion
+exports.CURATED_ACCENTS = CURATED_ACCENTS;
+exports.accentSparkVars = accentSparkVars;
+exports.accentSparkVarsP3 = accentSparkVarsP3;
+exports.generateAccentScale = generateAccentScale;
+exports.getMatchingNeutral = getMatchingNeutral;
+
+//# sourceMappingURL=accent-theme.cjs.map

package/dist/lib/accent-theme.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-theme.cjs","names":["RadixColors","generateRadixColors","Color"],"sources":["../../src/lib/accent-theme.ts"],"sourcesContent":["// Accent is the one runtime knob (colour math, not a CSS-var swap): generate the\n// `--spark-*` scale with the same Radix algorithm live portals use, apply as inline vars.\nimport * as RadixColors from '@radix-ui/colors'\nimport Color from 'colorjs.io'\nimport { generateRadixColors } from './generate-radix-colors'\nimport type { SparkNeutral } from './theme-types'\n\n/** Shape returned by the vendored Radix generator (it doesn't export a named type). */\nexport type GeneratedColors = ReturnType<typeof generateRadixColors>\n\n/**\n * generateAccentScale output: the raw scale, but with two readable foregrounds on the\n * solid (step-9) fill, each meeting a different WCAG bar:\n * - `accentContrast` — 4.5:1 (WCAG 1.4.3), for button/label **text**.\n * - `accentOnSolid` — 3:1 (WCAG 1.4.11), for a **graphical glyph** (the checkbox check).\n * A checkmark is graphical, not text, so it uses the looser-but-correct 3:1 bar: white\n * where it clears 3:1 (most accents, incl. neutral & red — the convention), and a dark\n * accent-tint where white is too weak (e.g. orange). Using the 4.5:1 text contrast for\n * the glyph over-darkened it (a black tick on a red/neutral checkbox).\n */\nexport type SparkAccentScale = GeneratedColors & { accentOnSolid: string }\n\nexport type Appearance = 'light' | 'dark'\n\n/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */\nexport const CURATED_ACCENTS: Record<string, string> = {\n  blue: RadixColors.blue.blue9,\n  indigo: RadixColors.indigo.indigo9,\n  violet: RadixColors.violet.violet9,\n  purple: RadixColors.purple.purple9,\n  cyan: RadixColors.cyan.cyan9,\n  teal: RadixColors.teal.teal9,\n  green: RadixColors.green.green9,\n  grass: RadixColors.grass.grass9,\n  orange: RadixColors.orange.orange9,\n  red: RadixColors.red.red9,\n  pink: RadixColors.pink.pink9,\n  gray: RadixColors.gray.gray9,\n}\n\n/** ECP `DesignUtils` generator inputs, so a generated scale matches live portals. */\nconst DEFAULTS: Record<Appearance, { gray: string; background: string }> = {\n  light: { gray: '#333333', background: '#ffffff' },\n  // Matches ECP DesignUtils' DEFAULT_DARK_BACKGROUND_COLOR -- the alpha ramp\n  // is composited against this, so it must match what's actually painted.\n  dark: { gray: '#8b8d98', background: '#000000' },\n}\n\n/** Generate the Radix-style accent scale for one appearance from a single accent color. */\nexport function generateAccentScale(\n  accent: string,\n  appearance: Appearance,\n): SparkAccentScale {\n  const scale = generateRadixColors({\n    appearance,\n    accent,\n    gray: DEFAULTS[appearance].gray,\n    background: DEFAULTS[appearance].background,\n  })\n  // accentContrast → 4.5:1 (button text); accentOnSolid → 3:1 (graphical glyph,\n  // see SparkAccentScale). Same picker, different WCAG threshold.\n  return {\n    ...scale,\n    accentContrast: readableContrast(scale, MIN_TEXT_CONTRAST),\n    accentOnSolid: readableContrast(scale, MIN_GRAPHIC_CONTRAST),\n  }\n}\n\nconst MIN_TEXT_CONTRAST = 4.5 // WCAG 1.4.3 — button / label text\nconst MIN_GRAPHIC_CONTRAST = 3 // WCAG 1.4.11 — a check / indicator glyph on a solid fill\n\n// Pick the readable foreground on step 9: prefer the generator's native contrast\n// (usually white), else fall to progressively darker accent-tinted inks until one\n// clears `min`. Text uses 4.5:1; a graphical glyph (the checkmark) uses 3:1 — which\n// keeps white on most accents (incl. neutral 3.32:1, red 3.91:1) but flips to a dark\n// tint where white is too weak (e.g. orange, 2.97:1). The vendored generator keeps\n// white at APCA Lc >= 40, which can sit below both WCAG thresholds — hence this guard.\nfunction readableContrast(scale: GeneratedColors, min: number): string {\n  const step9 = new Color(scale.accentScale[8]!)\n  const [, chroma, hue] = step9.to('oklch').coords\n  const tinted = (lightness: number) =>\n    new Color('oklch', [\n      lightness,\n      Math.max(0.08 * (chroma ?? 0), 0.04),\n      hue ?? 0,\n    ])\n      .to('srgb')\n      .toString({ format: 'hex' })\n  const candidates = [scale.accentContrast, tinted(0.25), tinted(0.15)]\n  const ratios = candidates.map((c) => new Color(c).contrast(step9, 'WCAG21'))\n  const passing = ratios.findIndex((r) => r >= min)\n  if (passing !== -1) return candidates[passing]!\n  return candidates[ratios.indexOf(Math.max(...ratios))]!\n}\n\n/** sRGB `--spark-*` declarations for a generated accent scale. */\nexport function accentSparkVars(scale: SparkAccentScale): string[] {\n  return sparkVars(\n    scale.accentScale,\n    scale.accentScaleAlpha,\n    scale.accentContrast,\n    scale.accentOnSolid,\n    scale.accentSurface,\n    scale.background,\n  )\n}\n\n/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */\nexport function accentSparkVarsP3(scale: SparkAccentScale): string[] {\n  return sparkVars(\n    scale.accentScaleWideGamut,\n    scale.accentScaleAlphaWideGamut,\n    scale.accentContrast,\n    scale.accentOnSolid,\n    scale.accentSurfaceWideGamut,\n    scale.background,\n  )\n}\n\n/** Radix's `grayColor=\"auto\"` pairing (accent family → gray), mapped to our 6 neutrals. */\nconst NEUTRAL_BY_ACCENT: Record<string, SparkNeutral> = {\n  blue: 'slate',\n  indigo: 'slate',\n  cyan: 'slate',\n  violet: 'mauve',\n  purple: 'mauve',\n  pink: 'mauve',\n  red: 'mauve',\n  teal: 'sage',\n  green: 'sage',\n  grass: 'olive',\n  orange: 'sand',\n  gray: 'gray',\n}\n\n/** Radix's \"auto\" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */\nexport function getMatchingNeutral(accent: string): SparkNeutral {\n  const byName = NEUTRAL_BY_ACCENT[accent]\n  if (byName) return byName\n  try {\n    const [, chroma, hueRaw] = new Color(accent).to('oklch').coords\n    if (!chroma || chroma < 0.04) return 'gray'\n    const hue = (((hueRaw ?? 0) % 360) + 360) % 360\n    if (hue >= 300 || hue < 35) return 'mauve'\n    if (hue < 115) return 'sand'\n    if (hue < 145) return 'olive'\n    if (hue < 200) return 'sage'\n    return 'slate'\n  } catch {\n    return 'slate'\n  }\n}\n\nfunction sparkVars(\n  steps: string[],\n  alpha: string[],\n  contrast: string,\n  onSolid: string,\n  surface: string,\n  background: string,\n): string[] {\n  const indicator = steps[8]! // step 9 — the brand step (matches --spark-indicator/-track)\n  return [\n    ...steps.map((c, i) => `--spark-${i + 1}: ${c};`),\n    ...alpha.map((c, i) => `--spark-a${i + 1}: ${c};`),\n    `--spark-contrast: ${contrast};`,\n    `--spark-on-solid: ${onSolid};`,\n    `--spark-surface: ${surface};`,\n    `--spark-background: ${background};`,\n    `--spark-indicator: ${indicator};`,\n    `--spark-track: ${indicator};`,\n  ]\n}\n"],"mappings":";;;;;;;;;;AAyBA,MAAa,kBAA0C;CACrD,MAAMA,iBAAY,KAAK;CACvB,QAAQA,iBAAY,OAAO;CAC3B,QAAQA,iBAAY,OAAO;CAC3B,QAAQA,iBAAY,OAAO;CAC3B,MAAMA,iBAAY,KAAK;CACvB,MAAMA,iBAAY,KAAK;CACvB,OAAOA,iBAAY,MAAM;CACzB,OAAOA,iBAAY,MAAM;CACzB,QAAQA,iBAAY,OAAO;CAC3B,KAAKA,iBAAY,IAAI;CACrB,MAAMA,iBAAY,KAAK;CACvB,MAAMA,iBAAY,KAAK;CACxB;;AAGD,MAAM,WAAqE;CACzE,OAAO;EAAE,MAAM;EAAW,YAAY;EAAW;CAGjD,MAAM;EAAE,MAAM;EAAW,YAAY;EAAW;CACjD;;AAGD,SAAgB,oBACd,QACA,YACkB;CAClB,MAAM,QAAQC,kCAAAA,oBAAoB;EAChC;EACA;EACA,MAAM,SAAS,YAAY;EAC3B,YAAY,SAAS,YAAY;EAClC,CAAC;AAGF,QAAO;EACL,GAAG;EACH,gBAAgB,iBAAiB,OAAO,kBAAkB;EAC1D,eAAe,iBAAiB,OAAO,qBAAqB;EAC7D;;AAGH,MAAM,oBAAoB;AAC1B,MAAM,uBAAuB;AAQ7B,SAAS,iBAAiB,OAAwB,KAAqB;CACrE,MAAM,QAAQ,IAAIC,WAAAA,QAAM,MAAM,YAAY,GAAI;CAC9C,MAAM,GAAG,QAAQ,OAAO,MAAM,GAAG,QAAQ,CAAC;CAC1C,MAAM,UAAU,cACd,IAAIA,WAAAA,QAAM,SAAS;EACjB;EACA,KAAK,IAAI,OAAQ,UAAU,IAAI,IAAK;EACpC,OAAO;EACR,CAAC,CACC,GAAG,OAAO,CACV,SAAS,EAAE,QAAQ,OAAO,CAAC;CAChC,MAAM,aAAa;EAAC,MAAM;EAAgB,OAAO,IAAK;EAAE,OAAO,IAAK;EAAC;CACrE,MAAM,SAAS,WAAW,KAAK,MAAM,IAAIA,WAAAA,QAAM,EAAE,CAAC,SAAS,OAAO,SAAS,CAAC;CAC5E,MAAM,UAAU,OAAO,WAAW,MAAM,KAAK,IAAI;AACjD,KAAI,YAAY,GAAI,QAAO,WAAW;AACtC,QAAO,WAAW,OAAO,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC;;;AAIvD,SAAgB,gBAAgB,OAAmC;AACjE,QAAO,UACL,MAAM,aACN,MAAM,kBACN,MAAM,gBACN,MAAM,eACN,MAAM,eACN,MAAM,WACP;;;AAIH,SAAgB,kBAAkB,OAAmC;AACnE,QAAO,UACL,MAAM,sBACN,MAAM,2BACN,MAAM,gBACN,MAAM,eACN,MAAM,wBACN,MAAM,WACP;;;AAIH,MAAM,oBAAkD;CACtD,MAAM;CACN,QAAQ;CACR,MAAM;CACN,QAAQ;CACR,QAAQ;CACR,MAAM;CACN,KAAK;CACL,MAAM;CACN,OAAO;CACP,OAAO;CACP,QAAQ;CACR,MAAM;CACP;;AAGD,SAAgB,mBAAmB,QAA8B;CAC/D,MAAM,SAAS,kBAAkB;AACjC,KAAI,OAAQ,QAAO;AACnB,KAAI;EACF,MAAM,GAAG,QAAQ,UAAU,IAAIA,WAAAA,QAAM,OAAO,CAAC,GAAG,QAAQ,CAAC;AACzD,MAAI,CAAC,UAAU,SAAS,IAAM,QAAO;EACrC,MAAM,QAAS,UAAU,KAAK,MAAO,OAAO;AAC5C,MAAI,OAAO,OAAO,MAAM,GAAI,QAAO;AACnC,MAAI,MAAM,IAAK,QAAO;AACtB,MAAI,MAAM,IAAK,QAAO;AACtB,MAAI,MAAM,IAAK,QAAO;AACtB,SAAO;SACD;AACN,SAAO;;;AAIX,SAAS,UACP,OACA,OACA,UACA,SACA,SACA,YACU;CACV,MAAM,YAAY,MAAM;AACxB,QAAO;EACL,GAAG,MAAM,KAAK,GAAG,MAAM,WAAW,IAAI,EAAE,IAAI,EAAE,GAAG;EACjD,GAAG,MAAM,KAAK,GAAG,MAAM,YAAY,IAAI,EAAE,IAAI,EAAE,GAAG;EAClD,qBAAqB,SAAS;EAC9B,qBAAqB,QAAQ;EAC7B,oBAAoB,QAAQ;EAC5B,uBAAuB,WAAW;EAClC,sBAAsB,UAAU;EAChC,kBAAkB,UAAU;EAC7B"}

package/dist/lib/accent-theme.d.cts

@@ -0,0 +1,35 @@
+"use client";
+
+import { o as SparkNeutral } from "../theme-types-BwSJKdsB.cjs";
+import { t as generateRadixColors } from "../generate-radix-colors-C5mWRWnQ.cjs";
+
+//#region src/lib/accent-theme.d.ts
+/** Shape returned by the vendored Radix generator (it doesn't export a named type). */
+type GeneratedColors = ReturnType<typeof generateRadixColors>;
+/**
+ * generateAccentScale output: the raw scale, but with two readable foregrounds on the
+ * solid (step-9) fill, each meeting a different WCAG bar:
+ * - `accentContrast` — 4.5:1 (WCAG 1.4.3), for button/label **text**.
+ * - `accentOnSolid` — 3:1 (WCAG 1.4.11), for a **graphical glyph** (the checkbox check).
+ * A checkmark is graphical, not text, so it uses the looser-but-correct 3:1 bar: white
+ * where it clears 3:1 (most accents, incl. neutral & red — the convention), and a dark
+ * accent-tint where white is too weak (e.g. orange). Using the 4.5:1 text contrast for
+ * the glyph over-darkened it (a black tick on a red/neutral checkbox).
+ */
+type SparkAccentScale = GeneratedColors & {
+  accentOnSolid: string;
+};
+type Appearance = 'light' | 'dark';
+/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */
+declare const CURATED_ACCENTS: Record<string, string>;
+/** Generate the Radix-style accent scale for one appearance from a single accent color. */
+declare function generateAccentScale(accent: string, appearance: Appearance): SparkAccentScale;
+/** sRGB `--spark-*` declarations for a generated accent scale. */
+declare function accentSparkVars(scale: SparkAccentScale): string[];
+/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */
+declare function accentSparkVarsP3(scale: SparkAccentScale): string[];
+/** Radix's "auto" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */
+declare function getMatchingNeutral(accent: string): SparkNeutral;
+//#endregion
+export { Appearance, CURATED_ACCENTS, GeneratedColors, SparkAccentScale, accentSparkVars, accentSparkVarsP3, generateAccentScale, getMatchingNeutral };
+//# sourceMappingURL=accent-theme.d.cts.map

package/dist/lib/accent-theme.d.ts

@@ -0,0 +1,35 @@
+"use client";
+
+import { o as SparkNeutral } from "../theme-types-BKlzRiyw.js";
+import { t as generateRadixColors } from "../generate-radix-colors-BW09KT9m.js";
+
+//#region src/lib/accent-theme.d.ts
+/** Shape returned by the vendored Radix generator (it doesn't export a named type). */
+type GeneratedColors = ReturnType<typeof generateRadixColors>;
+/**
+ * generateAccentScale output: the raw scale, but with two readable foregrounds on the
+ * solid (step-9) fill, each meeting a different WCAG bar:
+ * - `accentContrast` — 4.5:1 (WCAG 1.4.3), for button/label **text**.
+ * - `accentOnSolid` — 3:1 (WCAG 1.4.11), for a **graphical glyph** (the checkbox check).
+ * A checkmark is graphical, not text, so it uses the looser-but-correct 3:1 bar: white
+ * where it clears 3:1 (most accents, incl. neutral & red — the convention), and a dark
+ * accent-tint where white is too weak (e.g. orange). Using the 4.5:1 text contrast for
+ * the glyph over-darkened it (a black tick on a red/neutral checkbox).
+ */
+type SparkAccentScale = GeneratedColors & {
+  accentOnSolid: string;
+};
+type Appearance = 'light' | 'dark';
+/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */
+declare const CURATED_ACCENTS: Record<string, string>;
+/** Generate the Radix-style accent scale for one appearance from a single accent color. */
+declare function generateAccentScale(accent: string, appearance: Appearance): SparkAccentScale;
+/** sRGB `--spark-*` declarations for a generated accent scale. */
+declare function accentSparkVars(scale: SparkAccentScale): string[];
+/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */
+declare function accentSparkVarsP3(scale: SparkAccentScale): string[];
+/** Radix's "auto" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */
+declare function getMatchingNeutral(accent: string): SparkNeutral;
+//#endregion
+export { Appearance, CURATED_ACCENTS, GeneratedColors, SparkAccentScale, accentSparkVars, accentSparkVarsP3, generateAccentScale, getMatchingNeutral };
+//# sourceMappingURL=accent-theme.d.ts.map

package/dist/lib/accent-theme.js

@@ -0,0 +1,122 @@
+"use client";
+import { generateRadixColors } from "./generate-radix-colors.js";
+import * as RadixColors from "@radix-ui/colors";
+import Color from "colorjs.io";
+//#region src/lib/accent-theme.ts
+/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */
+const CURATED_ACCENTS = {
+	blue: RadixColors.blue.blue9,
+	indigo: RadixColors.indigo.indigo9,
+	violet: RadixColors.violet.violet9,
+	purple: RadixColors.purple.purple9,
+	cyan: RadixColors.cyan.cyan9,
+	teal: RadixColors.teal.teal9,
+	green: RadixColors.green.green9,
+	grass: RadixColors.grass.grass9,
+	orange: RadixColors.orange.orange9,
+	red: RadixColors.red.red9,
+	pink: RadixColors.pink.pink9,
+	gray: RadixColors.gray.gray9
+};
+/** ECP `DesignUtils` generator inputs, so a generated scale matches live portals. */
+const DEFAULTS = {
+	light: {
+		gray: "#333333",
+		background: "#ffffff"
+	},
+	dark: {
+		gray: "#8b8d98",
+		background: "#000000"
+	}
+};
+/** Generate the Radix-style accent scale for one appearance from a single accent color. */
+function generateAccentScale(accent, appearance) {
+	const scale = generateRadixColors({
+		appearance,
+		accent,
+		gray: DEFAULTS[appearance].gray,
+		background: DEFAULTS[appearance].background
+	});
+	return {
+		...scale,
+		accentContrast: readableContrast(scale, MIN_TEXT_CONTRAST),
+		accentOnSolid: readableContrast(scale, MIN_GRAPHIC_CONTRAST)
+	};
+}
+const MIN_TEXT_CONTRAST = 4.5;
+const MIN_GRAPHIC_CONTRAST = 3;
+function readableContrast(scale, min) {
+	const step9 = new Color(scale.accentScale[8]);
+	const [, chroma, hue] = step9.to("oklch").coords;
+	const tinted = (lightness) => new Color("oklch", [
+		lightness,
+		Math.max(.08 * (chroma ?? 0), .04),
+		hue ?? 0
+	]).to("srgb").toString({ format: "hex" });
+	const candidates = [
+		scale.accentContrast,
+		tinted(.25),
+		tinted(.15)
+	];
+	const ratios = candidates.map((c) => new Color(c).contrast(step9, "WCAG21"));
+	const passing = ratios.findIndex((r) => r >= min);
+	if (passing !== -1) return candidates[passing];
+	return candidates[ratios.indexOf(Math.max(...ratios))];
+}
+/** sRGB `--spark-*` declarations for a generated accent scale. */
+function accentSparkVars(scale) {
+	return sparkVars(scale.accentScale, scale.accentScaleAlpha, scale.accentContrast, scale.accentOnSolid, scale.accentSurface, scale.background);
+}
+/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */
+function accentSparkVarsP3(scale) {
+	return sparkVars(scale.accentScaleWideGamut, scale.accentScaleAlphaWideGamut, scale.accentContrast, scale.accentOnSolid, scale.accentSurfaceWideGamut, scale.background);
+}
+/** Radix's `grayColor="auto"` pairing (accent family → gray), mapped to our 6 neutrals. */
+const NEUTRAL_BY_ACCENT = {
+	blue: "slate",
+	indigo: "slate",
+	cyan: "slate",
+	violet: "mauve",
+	purple: "mauve",
+	pink: "mauve",
+	red: "mauve",
+	teal: "sage",
+	green: "sage",
+	grass: "olive",
+	orange: "sand",
+	gray: "gray"
+};
+/** Radix's "auto" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */
+function getMatchingNeutral(accent) {
+	const byName = NEUTRAL_BY_ACCENT[accent];
+	if (byName) return byName;
+	try {
+		const [, chroma, hueRaw] = new Color(accent).to("oklch").coords;
+		if (!chroma || chroma < .04) return "gray";
+		const hue = ((hueRaw ?? 0) % 360 + 360) % 360;
+		if (hue >= 300 || hue < 35) return "mauve";
+		if (hue < 115) return "sand";
+		if (hue < 145) return "olive";
+		if (hue < 200) return "sage";
+		return "slate";
+	} catch {
+		return "slate";
+	}
+}
+function sparkVars(steps, alpha, contrast, onSolid, surface, background) {
+	const indicator = steps[8];
+	return [
+		...steps.map((c, i) => `--spark-${i + 1}: ${c};`),
+		...alpha.map((c, i) => `--spark-a${i + 1}: ${c};`),
+		`--spark-contrast: ${contrast};`,
+		`--spark-on-solid: ${onSolid};`,
+		`--spark-surface: ${surface};`,
+		`--spark-background: ${background};`,
+		`--spark-indicator: ${indicator};`,
+		`--spark-track: ${indicator};`
+	];
+}
+//#endregion
+export { CURATED_ACCENTS, accentSparkVars, accentSparkVarsP3, generateAccentScale, getMatchingNeutral };
+
+//# sourceMappingURL=accent-theme.js.map

package/dist/lib/accent-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accent-theme.js","names":[],"sources":["../../src/lib/accent-theme.ts"],"sourcesContent":["// Accent is the one runtime knob (colour math, not a CSS-var swap): generate the\n// `--spark-*` scale with the same Radix algorithm live portals use, apply as inline vars.\nimport * as RadixColors from '@radix-ui/colors'\nimport Color from 'colorjs.io'\nimport { generateRadixColors } from './generate-radix-colors'\nimport type { SparkNeutral } from './theme-types'\n\n/** Shape returned by the vendored Radix generator (it doesn't export a named type). */\nexport type GeneratedColors = ReturnType<typeof generateRadixColors>\n\n/**\n * generateAccentScale output: the raw scale, but with two readable foregrounds on the\n * solid (step-9) fill, each meeting a different WCAG bar:\n * - `accentContrast` — 4.5:1 (WCAG 1.4.3), for button/label **text**.\n * - `accentOnSolid` — 3:1 (WCAG 1.4.11), for a **graphical glyph** (the checkbox check).\n * A checkmark is graphical, not text, so it uses the looser-but-correct 3:1 bar: white\n * where it clears 3:1 (most accents, incl. neutral & red — the convention), and a dark\n * accent-tint where white is too weak (e.g. orange). Using the 4.5:1 text contrast for\n * the glyph over-darkened it (a black tick on a red/neutral checkbox).\n */\nexport type SparkAccentScale = GeneratedColors & { accentOnSolid: string }\n\nexport type Appearance = 'light' | 'dark'\n\n/** Curated name → source color. `blue` = Radix blue; the no-attribute default `--spark-*` stays the epilot brand. */\nexport const CURATED_ACCENTS: Record<string, string> = {\n  blue: RadixColors.blue.blue9,\n  indigo: RadixColors.indigo.indigo9,\n  violet: RadixColors.violet.violet9,\n  purple: RadixColors.purple.purple9,\n  cyan: RadixColors.cyan.cyan9,\n  teal: RadixColors.teal.teal9,\n  green: RadixColors.green.green9,\n  grass: RadixColors.grass.grass9,\n  orange: RadixColors.orange.orange9,\n  red: RadixColors.red.red9,\n  pink: RadixColors.pink.pink9,\n  gray: RadixColors.gray.gray9,\n}\n\n/** ECP `DesignUtils` generator inputs, so a generated scale matches live portals. */\nconst DEFAULTS: Record<Appearance, { gray: string; background: string }> = {\n  light: { gray: '#333333', background: '#ffffff' },\n  // Matches ECP DesignUtils' DEFAULT_DARK_BACKGROUND_COLOR -- the alpha ramp\n  // is composited against this, so it must match what's actually painted.\n  dark: { gray: '#8b8d98', background: '#000000' },\n}\n\n/** Generate the Radix-style accent scale for one appearance from a single accent color. */\nexport function generateAccentScale(\n  accent: string,\n  appearance: Appearance,\n): SparkAccentScale {\n  const scale = generateRadixColors({\n    appearance,\n    accent,\n    gray: DEFAULTS[appearance].gray,\n    background: DEFAULTS[appearance].background,\n  })\n  // accentContrast → 4.5:1 (button text); accentOnSolid → 3:1 (graphical glyph,\n  // see SparkAccentScale). Same picker, different WCAG threshold.\n  return {\n    ...scale,\n    accentContrast: readableContrast(scale, MIN_TEXT_CONTRAST),\n    accentOnSolid: readableContrast(scale, MIN_GRAPHIC_CONTRAST),\n  }\n}\n\nconst MIN_TEXT_CONTRAST = 4.5 // WCAG 1.4.3 — button / label text\nconst MIN_GRAPHIC_CONTRAST = 3 // WCAG 1.4.11 — a check / indicator glyph on a solid fill\n\n// Pick the readable foreground on step 9: prefer the generator's native contrast\n// (usually white), else fall to progressively darker accent-tinted inks until one\n// clears `min`. Text uses 4.5:1; a graphical glyph (the checkmark) uses 3:1 — which\n// keeps white on most accents (incl. neutral 3.32:1, red 3.91:1) but flips to a dark\n// tint where white is too weak (e.g. orange, 2.97:1). The vendored generator keeps\n// white at APCA Lc >= 40, which can sit below both WCAG thresholds — hence this guard.\nfunction readableContrast(scale: GeneratedColors, min: number): string {\n  const step9 = new Color(scale.accentScale[8]!)\n  const [, chroma, hue] = step9.to('oklch').coords\n  const tinted = (lightness: number) =>\n    new Color('oklch', [\n      lightness,\n      Math.max(0.08 * (chroma ?? 0), 0.04),\n      hue ?? 0,\n    ])\n      .to('srgb')\n      .toString({ format: 'hex' })\n  const candidates = [scale.accentContrast, tinted(0.25), tinted(0.15)]\n  const ratios = candidates.map((c) => new Color(c).contrast(step9, 'WCAG21'))\n  const passing = ratios.findIndex((r) => r >= min)\n  if (passing !== -1) return candidates[passing]!\n  return candidates[ratios.indexOf(Math.max(...ratios))]!\n}\n\n/** sRGB `--spark-*` declarations for a generated accent scale. */\nexport function accentSparkVars(scale: SparkAccentScale): string[] {\n  return sparkVars(\n    scale.accentScale,\n    scale.accentScaleAlpha,\n    scale.accentContrast,\n    scale.accentOnSolid,\n    scale.accentSurface,\n    scale.background,\n  )\n}\n\n/** Wide-gamut (P3) `--spark-*` declarations — for a `color-gamut: p3` `@supports` block. */\nexport function accentSparkVarsP3(scale: SparkAccentScale): string[] {\n  return sparkVars(\n    scale.accentScaleWideGamut,\n    scale.accentScaleAlphaWideGamut,\n    scale.accentContrast,\n    scale.accentOnSolid,\n    scale.accentSurfaceWideGamut,\n    scale.background,\n  )\n}\n\n/** Radix's `grayColor=\"auto\"` pairing (accent family → gray), mapped to our 6 neutrals. */\nconst NEUTRAL_BY_ACCENT: Record<string, SparkNeutral> = {\n  blue: 'slate',\n  indigo: 'slate',\n  cyan: 'slate',\n  violet: 'mauve',\n  purple: 'mauve',\n  pink: 'mauve',\n  red: 'mauve',\n  teal: 'sage',\n  green: 'sage',\n  grass: 'olive',\n  orange: 'sand',\n  gray: 'gray',\n}\n\n/** Radix's \"auto\" gray: curated names use Radix's table; a custom hex is classified by OKLCH hue. */\nexport function getMatchingNeutral(accent: string): SparkNeutral {\n  const byName = NEUTRAL_BY_ACCENT[accent]\n  if (byName) return byName\n  try {\n    const [, chroma, hueRaw] = new Color(accent).to('oklch').coords\n    if (!chroma || chroma < 0.04) return 'gray'\n    const hue = (((hueRaw ?? 0) % 360) + 360) % 360\n    if (hue >= 300 || hue < 35) return 'mauve'\n    if (hue < 115) return 'sand'\n    if (hue < 145) return 'olive'\n    if (hue < 200) return 'sage'\n    return 'slate'\n  } catch {\n    return 'slate'\n  }\n}\n\nfunction sparkVars(\n  steps: string[],\n  alpha: string[],\n  contrast: string,\n  onSolid: string,\n  surface: string,\n  background: string,\n): string[] {\n  const indicator = steps[8]! // step 9 — the brand step (matches --spark-indicator/-track)\n  return [\n    ...steps.map((c, i) => `--spark-${i + 1}: ${c};`),\n    ...alpha.map((c, i) => `--spark-a${i + 1}: ${c};`),\n    `--spark-contrast: ${contrast};`,\n    `--spark-on-solid: ${onSolid};`,\n    `--spark-surface: ${surface};`,\n    `--spark-background: ${background};`,\n    `--spark-indicator: ${indicator};`,\n    `--spark-track: ${indicator};`,\n  ]\n}\n"],"mappings":"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"}