@xtyle/core 0.5.0

package/dist/batteries.js

@@ -0,0 +1,339 @@
+// packages/xtyle/src/batteries.ts
+import { makeXtyleAlgorithm, makeXtylePipelineAlgorithm, toPreset } from "@xtyle/core/authoring";
+import { derive, deriveTraced, emit, emitCss, emitJson } from "@xtyle/core";
+
+// algorithms/xtyle-default/src/preset.ts
+var spec = { id: "xtyle-default" };
+
+// algorithms/xtyle-hc/src/preset.ts
+var spec2 = {
+  id: "xtyle-hc",
+  contrast: { floor: 7, textOnFill: 7 },
+  vibrancy: 1,
+  chroma: { accent: 1.8, status: 1.7, palette: 1.7, neutral: 5e-3, accentTint: 0.6 },
+  elevation: { alphaBoost: 0.05 },
+  extreme: true
+};
+
+// algorithms/xtyle-quiet/src/preset.ts
+var spec3 = {
+  id: "xtyle-quiet",
+  vibrancy: 0.12,
+  chroma: { accent: 0.5, status: 0.55, palette: 0.6, neutral: 5e-3, accentTint: 0.18 },
+  elevation: { strength: 0.6, alphaBoost: -0.04 }
+};
+
+// algorithms/xtyle-loud/src/preset.ts
+var spec4 = {
+  id: "xtyle-loud",
+  vibrancy: 0.9,
+  chroma: { accent: 1.6, status: 1.5, palette: 1.5, neutral: 0.02, accentTint: 0.5 },
+  elevation: { strength: 1.6, alphaBoost: 0.12 }
+};
+
+// algorithms/nxi-nite/src/preset.ts
+var spec5 = {
+  id: "nxi-nite",
+  knobs: [
+    "scheme",
+    "accentShiftStep",
+    "accentSplit",
+    "contrastBand",
+    "vibrancy",
+    "typeScale",
+    "radiusScale",
+    "density",
+    "cues",
+    "fonts",
+    "anchors",
+    "hour"
+  ]
+};
+
+// algorithms/nxi-nite/src/passes.ts
+import {
+  contrast,
+  formatCss,
+  oklch,
+  toOklchColor,
+  withLightness
+} from "@xtyle/core/authoring";
+import {
+  borderForContrast,
+  BORDER_SEPARATION,
+  DIVIDER_SEPARATION,
+  SURFACE_SEPARATION,
+  enforceContrastFloor,
+  settlePass,
+  TOKEN_CATEGORIES
+} from "@xtyle/core/authoring";
+var DEFAULT_HOUR = 12;
+var FLOOR = 4.5 + 0.2;
+var WARM_HUE = 65;
+var COOL_HUE = 250;
+var DIM_AMPLITUDE = 0.12;
+var WARMTH_AMPLITUDE = 18;
+function hourOf(knobs) {
+  const raw = typeof knobs.hour === "number" ? knobs.hour : DEFAULT_HOUR;
+  return Math.min(24, Math.max(0, raw));
+}
+function nightness(hour) {
+  return Math.cos(hour / 24 * 2 * Math.PI);
+}
+function phaseOf(ctx) {
+  return nightness(hourOf(ctx.knobs ?? {}));
+}
+var DIM_LADDER = ["--bg-sunken", "--body-bg", "--bg-0", "--bg-1", "--bg-2", "--bg-3"];
+var DIM_EXTRA = ["--surface-overlay", "--field-bg"];
+var SURFACE_TOKENS = [...DIM_LADDER, ...DIM_EXTRA];
+var WARMTH_TOKENS = SURFACE_TOKENS;
+function isColor(name) {
+  return TOKEN_CATEGORIES[name] === "color";
+}
+function asColor(value) {
+  if (!value || value === "none") return null;
+  try {
+    const o = toOklchColor(value);
+    if (Number.isNaN(o.l) || Number.isNaN(o.c) || Number.isNaN(o.h)) return null;
+    return o;
+  } catch {
+    return null;
+  }
+}
+function hasAlpha(value) {
+  if (value.startsWith("#")) return value.length === 9 || value.length === 5;
+  return /rgba?\([^)]*,\s*[0-9.]+\s*\)/.test(value);
+}
+function shiftHue(hue, target, degrees) {
+  let d = ((target - hue) % 360 + 360) % 360;
+  if (d > 180) d -= 360;
+  const move = Math.sign(d) * Math.min(Math.abs(d), degrees);
+  return ((hue + move) % 360 + 360) % 360;
+}
+function relLuminance(value) {
+  return contrast(value, "#000000") * 0.05 - 0.05;
+}
+function achievableFloor(declaredFloor, bgValue) {
+  const ceiling = Math.max(contrast("#000000", bgValue), contrast("#ffffff", bgValue));
+  return Math.min(declaredFloor, ceiling - 0.05);
+}
+function matchLuminance(color, targetL) {
+  const lum = (l) => relLuminance(formatCss(withLightness(color, l)));
+  let lo = 0;
+  let hi = 1;
+  for (let i = 0; i < 24; i++) {
+    const mid = (lo + hi) / 2;
+    if (lum(mid) < targetL) lo = mid;
+    else hi = mid;
+  }
+  return withLightness(color, (lo + hi) / 2);
+}
+function warmthRun(register, ctx) {
+  const n = phaseOf(ctx);
+  if (n === 0) return { ...register };
+  const target = n >= 0 ? WARM_HUE : COOL_HUE;
+  const degrees = Math.abs(n) * WARMTH_AMPLITUDE;
+  const tintChroma = Math.abs(n) * 0.012;
+  const out = { ...register };
+  for (const name of WARMTH_TOKENS) {
+    const value = register[name];
+    if (value === void 0) continue;
+    if (ctx.pinned[name] !== void 0) continue;
+    if (!isColor(name) || hasAlpha(value)) continue;
+    const color = asColor(value);
+    if (!color) continue;
+    if (value === "#ffffff" || value === "#000000") continue;
+    const targetLum = relLuminance(value);
+    const sourceHue = color.c < 0.01 ? target : color.h;
+    const newHue = shiftHue(sourceHue, target, degrees);
+    const newChroma = Math.max(color.c, color.c < 0.01 ? tintChroma : 0);
+    const tinted = oklch(color.l, newChroma, newHue, color.alpha);
+    out[name] = formatCss(matchLuminance(tinted, targetLum));
+  }
+  return out;
+}
+function dimRun(register, ctx) {
+  const n = phaseOf(ctx);
+  const desired = Math.max(0, n) * DIM_AMPLITUDE;
+  if (desired === 0) return { ...register };
+  const ladderPinned = DIM_LADDER.some((name) => ctx.pinned[name] !== void 0);
+  const pole = ctx.scheme === "dark" ? 0 : 1;
+  const targets = ladderPinned ? DIM_EXTRA : SURFACE_TOKENS;
+  const dimmed = (value, t2) => {
+    const color = asColor(value);
+    if (!color) return null;
+    return formatCss(withLightness(color, color.l + (pole - color.l) * t2));
+  };
+  const inks = RESTORE_PAIRS.filter((p) => ctx.pinned[p.fg] === void 0).map((p) => ({ value: register[p.fg], floor: p.floor })).filter((x) => x.value !== void 0 && !hasAlpha(x.value));
+  const textSurfaces = targets.filter(
+    (s) => s === "--bg-0" || s === "--bg-1" || s === "--bg-2"
+  );
+  const bg0Value = register["--bg-0"];
+  const bg0Dims = !ladderPinned && bg0Value !== void 0 && !hasAlpha(bg0Value);
+  const fills = bg0Dims ? FILL_TOKENS.filter((name) => ctx.pinned[name] === void 0).map((name) => register[name]).filter((v) => v !== void 0 && !hasAlpha(v)) : [];
+  const inkSafe = (t2) => textSurfaces.every((surface) => {
+    const sv = register[surface];
+    if (sv === void 0 || hasAlpha(sv)) return true;
+    const sdim = dimmed(sv, t2);
+    if (sdim === null) return true;
+    return inks.every(
+      ({ value, floor }) => contrast(value, sdim) >= Math.min(floor, contrast(value, sv)) - 5e-3
+    );
+  });
+  const fillSafe = (t2) => {
+    if (!bg0Dims || bg0Value === void 0) return true;
+    const sdim = dimmed(bg0Value, t2);
+    if (sdim === null) return true;
+    return fills.every(
+      (f) => contrast(f, sdim) >= Math.min(SURFACE_SEPARATION, contrast(f, bg0Value)) - 5e-3
+    );
+  };
+  const safe = (t2) => inkSafe(t2) && fillSafe(t2);
+  let t = desired;
+  if (!safe(t)) {
+    let lo = 0;
+    let hi = desired;
+    for (let i = 0; i < 24; i++) {
+      const mid = (lo + hi) / 2;
+      if (safe(mid)) lo = mid;
+      else hi = mid;
+    }
+    t = lo;
+  }
+  if (t === 0) return { ...register };
+  const out = { ...register };
+  for (const name of targets) {
+    if (ctx.pinned[name] !== void 0) continue;
+    if (!isColor(name)) continue;
+    const value = register[name];
+    if (value === void 0 || hasAlpha(value)) continue;
+    const moved = dimmed(value, t);
+    if (moved !== null) out[name] = moved;
+  }
+  return out;
+}
+var RESTORE_PAIRS = [
+  { fg: "--fg-0", bg: "--bg-0", floor: FLOOR },
+  { fg: "--fg-1", bg: "--bg-0", floor: FLOOR },
+  { fg: "--fg-2", bg: "--bg-0", floor: FLOOR },
+  { fg: "--fg-3", bg: "--bg-0", floor: FLOOR },
+  { fg: "--placeholder", bg: "--bg-0", floor: FLOOR },
+  { fg: "--fg-disabled", bg: "--bg-0", floor: FLOOR },
+  { fg: "--accent-text", bg: "--bg-0", floor: FLOOR },
+  { fg: "--neutral-text", bg: "--bg-0", floor: FLOOR },
+  { fg: "--link", bg: "--bg-0", floor: FLOOR },
+  { fg: "--link-hover", bg: "--bg-0", floor: FLOOR },
+  // The vivid on-surface tone inks clear AA by a tight margin (that's the point), so the
+  // night shift can tip them under where the muted `-text` inks survive on headroom. Restore
+  // them against `--bg-2`, the most-elevated same-side panel and therefore the hardest case —
+  // clearing it clears the nearer panels too.
+  { fg: "--success-vivid", bg: "--bg-2", floor: FLOOR },
+  { fg: "--warn-vivid", bg: "--bg-2", floor: FLOOR },
+  { fg: "--danger-vivid", bg: "--bg-2", floor: FLOOR },
+  { fg: "--info-vivid", bg: "--bg-2", floor: FLOOR },
+  { fg: "--neutral-vivid", bg: "--bg-2", floor: FLOOR }
+];
+var BORDER_RESTORE = [
+  { border: "--line", surface: "--bg-0", floor: BORDER_SEPARATION },
+  { border: "--line-2", surface: "--bg-0", floor: DIVIDER_SEPARATION },
+  { border: "--field-border", surface: "--field-bg", floor: BORDER_SEPARATION }
+];
+var FILL_TOKENS = ["--accent", "--neutral", "--success", "--warn", "--danger", "--info"];
+function clearBounded(fgValue, bgValue, bg0Value, scheme, floor) {
+  const reachable = achievableFloor(floor, bgValue);
+  if (contrast(fgValue, bgValue) >= reachable - 0.01) return fgValue;
+  const fg = asColor(fgValue);
+  const bg = asColor(bgValue);
+  if (!fg || !bg) return fgValue;
+  const repaired = formatCss(enforceContrastFloor(fg, bg, scheme, reachable));
+  if (contrast(repaired, bg0Value) < contrast(fgValue, bg0Value) - 0.01) return fgValue;
+  return repaired;
+}
+function contrastRestoreRun(register, ctx) {
+  const out = { ...register };
+  const bg0Value = out["--bg-0"];
+  if (bg0Value === void 0) return out;
+  for (const { fg, bg, floor } of RESTORE_PAIRS) {
+    if (ctx.pinned[fg] !== void 0) continue;
+    const fgValue = out[fg];
+    const bgValue = out[bg];
+    if (fgValue === void 0 || bgValue === void 0 || hasAlpha(fgValue)) continue;
+    out[fg] = clearBounded(fgValue, bgValue, bg0Value, ctx.scheme, floor);
+  }
+  for (const { border, surface, floor } of BORDER_RESTORE) {
+    if (ctx.pinned[border] !== void 0) continue;
+    const borderValue = out[border];
+    const surfaceValue = out[surface];
+    if (borderValue === void 0 || surfaceValue === void 0 || hasAlpha(borderValue)) continue;
+    const seed = asColor(borderValue);
+    const surf = asColor(surfaceValue);
+    if (!seed || !surf) continue;
+    out[border] = formatCss(borderForContrast(seed, surf, floor));
+  }
+  return out;
+}
+function warmthPass() {
+  return { name: "warmth", run: warmthRun };
+}
+function dimPass() {
+  return { name: "dim", run: dimRun };
+}
+function contrastRestorePass() {
+  return { name: "contrast-restore", run: contrastRestoreRun };
+}
+function nxiNitePasses(preset, opts) {
+  return [settlePass(preset, opts), warmthPass(), dimPass(), contrastRestorePass()];
+}
+
+// packages/xtyle/src/batteries.ts
+import { resolveBundledAlgorithm, snapshotBundledAlgorithm } from "@xtyle/core/host/bundle";
+var xtyleDefault = makeXtyleAlgorithm(toPreset(spec));
+var xtyleHc = makeXtyleAlgorithm(toPreset(spec2));
+var xtyleQuiet = makeXtyleAlgorithm(toPreset(spec3));
+var xtyleLoud = makeXtyleAlgorithm(toPreset(spec4));
+var nxiNite = makeXtylePipelineAlgorithm(toPreset(spec5), nxiNitePasses);
+var algorithms = {
+  [xtyleDefault.id]: xtyleDefault,
+  [xtyleHc.id]: xtyleHc,
+  [xtyleQuiet.id]: xtyleQuiet,
+  [xtyleLoud.id]: xtyleLoud,
+  [nxiNite.id]: nxiNite
+};
+function getAlgorithm(id) {
+  const algorithm = algorithms[id];
+  if (!algorithm) {
+    throw new Error(
+      `xtyle: unknown algorithm "${id}" (known: ${Object.keys(algorithms).join(", ")})`
+    );
+  }
+  return algorithm;
+}
+var warnedResolveFailures = /* @__PURE__ */ new Set();
+function hostedAlgorithm(id) {
+  const snapshot = snapshotBundledAlgorithm(id);
+  if (snapshot) return snapshot;
+  const baked = getAlgorithm(id);
+  void resolveBundledAlgorithm(id).catch((error) => {
+    if (warnedResolveFailures.has(id)) return;
+    warnedResolveFailures.add(id);
+    console.warn(`xtyle: hosted mod "${id}" failed to resolve; deriving through the baked oracle.`, error);
+  });
+  return baked;
+}
+export {
+  algorithms,
+  derive,
+  deriveTraced,
+  emit,
+  emitCss,
+  emitJson,
+  getAlgorithm,
+  hostedAlgorithm,
+  nxiNite,
+  resolveBundledAlgorithm as resolveAlgorithm,
+  snapshotBundledAlgorithm as snapshotAlgorithm,
+  xtyleDefault,
+  xtyleHc,
+  xtyleLoud,
+  xtyleQuiet
+};

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,202 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync } from "node:fs";
+import process from "node:process";
+import { auditRegister } from "./audit.js";
+import { coverage } from "./coverage.js";
+import { derive } from "./index.js";
+import { emit, emitters } from "./emit/index.js";
+import { buildThemeFile, serializeThemeFile } from "./theme-file.js";
+import { gauntlet, GAUNTLET_DEPTH_RUNS, resolveDepth } from "./gauntlet.js";
+import { availableAlgorithms, resolveAlgorithm } from "./host/registry.js";
+import { bakedAlgorithm } from "./baked.js";
+import { constraintsFrom } from "./constraints.js";
+function parse(argv) {
+    const args = {
+        command: argv[0] ?? "help",
+        format: "css",
+        mode: "baked",
+        algorithm: "xtyle-default",
+    };
+    for (let i = 1; i < argv.length; i++) {
+        const arg = argv[i];
+        const next = argv[i + 1];
+        switch (arg) {
+            case "--bg":
+                args.bg = next;
+                i++;
+                break;
+            case "--fg":
+                args.fg = next;
+                i++;
+                break;
+            case "--accent":
+                args.accent = next;
+                i++;
+                break;
+            case "--set":
+            case "--constraint": {
+                const eq = next?.indexOf("=") ?? -1;
+                if (next && eq > 0) {
+                    const rawKey = next.slice(0, eq).trim();
+                    const key = rawKey.startsWith("--") ? rawKey : `--${rawKey}`;
+                    (args.overrides ??= {})[key] = next.slice(eq + 1);
+                }
+                else if (next !== undefined) {
+                    process.stderr.write(`xtyle: ignoring malformed --set "${next}" (expected token=value)\n`);
+                }
+                i++;
+                break;
+            }
+            case "--format":
+            case "-f":
+                args.format = next ?? "css";
+                i++;
+                break;
+            case "--name":
+                args.name = next;
+                i++;
+                break;
+            case "--out":
+            case "-o":
+                args.out = next;
+                i++;
+                break;
+            case "--runs":
+                args.runs = Number.parseInt(next ?? "100", 10);
+                i++;
+                break;
+            case "--depth":
+                args.depth = next;
+                i++;
+                break;
+            case "--mode":
+                args.mode = next === "hosted" ? "hosted" : "baked";
+                i++;
+                break;
+            case "--algorithm":
+            case "-a":
+                args.algorithm = next ?? "xtyle-default";
+                i++;
+                break;
+        }
+    }
+    return args;
+}
+function resolveForMode(id, mode) {
+    return mode === "hosted" ? resolveAlgorithm(id) : bakedAlgorithm(id);
+}
+function usage() {
+    process.stdout.write([
+        "xtyle: themable-derivation engine",
+        "",
+        "usage:",
+        "  xtyle derive [-a <algorithm>] [--bg <c>] [--fg <c>] [--accent <c>] [--set <token>=<value>]... [--format css|json|theme|prism|monaco] [--name <s>] [--out <file>]",
+        "  xtyle gauntlet [-a <algorithm>|all] [--mode baked|hosted] [--depth quick|standard|full] [--runs <n>]",
+        "  xtyle coverage --consumed <a,b,c> [-a <algorithm>] [--bg <c>] [--accent <c>] [--set <token>=<value>]...",
+        "  xtyle audit [-a <algorithm>] [--bg <c>] [--accent <c>] [--set <token>=<value>]... [--level AA|AAA] [--large-text]",
+        "",
+        "  --set pins any token (repeatable): --set --accent-2=#7c3aed --set font-sans='Inter, sans-serif'",
+        "        the leading -- is optional (--set radius-md=10px). Alias: --constraint.",
+        "  xtyle list",
+        "  xtyle mcp",
+        "",
+        `algorithms: ${availableAlgorithms().join(", ")}`,
+        `emitters: ${emitters().join(", ")}`,
+        "",
+    ].join("\n"));
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    const args = parse(argv);
+    if (args.command === "help" || args.command === "--help" || args.command === "-h") {
+        usage();
+        return;
+    }
+    if (args.command === "list") {
+        for (const id of availableAlgorithms())
+            process.stdout.write(`${id}\n`);
+        return;
+    }
+    if (args.command === "mcp") {
+        if (argv.includes("--help") || argv.includes("-h")) {
+            process.stdout.write([
+                "xtyle mcp: start the MCP server (stdio transport)",
+                "",
+                "Exposes the engine the CLI runs to MCP clients: tools for derive, coverage,",
+                "audit, components, gauntlet, and list-algorithms, plus the concept docs and every",
+                "component manifest as resources.",
+                "",
+                "Configure your client to run: xtyle mcp (or npx -y @xtyle/core xtyle mcp)",
+                "",
+            ].join("\n"));
+            return;
+        }
+        const { createServer } = await import("./mcp/server.js");
+        const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+        const version = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8")).version;
+        await createServer(version).connect(new StdioServerTransport());
+        return;
+    }
+    if (args.command === "derive") {
+        const algorithm = await resolveAlgorithm(args.algorithm);
+        const constraints = constraintsFrom(args);
+        const register = derive(algorithm, { constraints });
+        const output = args.format === "theme"
+            ? serializeThemeFile(buildThemeFile({
+                meta: { name: args.name ?? `${args.algorithm} theme`, generator: "@xtyle/core" },
+                recipe: { algorithm: args.algorithm, overrides: constraints },
+                register,
+            }))
+            : emit(register, args.format);
+        if (args.out) {
+            writeFileSync(args.out, output);
+            process.stdout.write(`wrote ${Object.keys(register).length} tokens to ${args.out}\n`);
+        }
+        else {
+            process.stdout.write(output);
+        }
+        return;
+    }
+    if (args.command === "gauntlet") {
+        const depth = resolveDepth(args.depth);
+        const runs = args.runs ?? GAUNTLET_DEPTH_RUNS[depth];
+        const ids = args.algorithm === "all" ? availableAlgorithms() : [args.algorithm];
+        const reports = [];
+        for (const id of ids) {
+            const algorithm = await resolveForMode(id, args.mode);
+            reports.push(gauntlet(algorithm, { runs }));
+        }
+        const ok = reports.every((r) => r.ok);
+        const out = ids.length === 1 ? { mode: args.mode, depth, runs, ...reports[0] } : { mode: args.mode, depth, runs, ok, reports };
+        process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
+        process.exitCode = ok ? 0 : 1;
+        return;
+    }
+    if (args.command === "coverage") {
+        const algorithm = await resolveAlgorithm(args.algorithm);
+        const consumedArg = argv[argv.indexOf("--consumed") + 1] ?? "";
+        const consumed = consumedArg.split(",").map((s) => s.trim()).filter(Boolean);
+        const register = derive(algorithm, { constraints: constraintsFrom(args) });
+        const result = coverage(consumed, register);
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        process.exitCode = result.covered ? 0 : 1;
+        return;
+    }
+    if (args.command === "audit") {
+        const algorithm = await resolveAlgorithm(args.algorithm);
+        const register = derive(algorithm, { constraints: constraintsFrom(args) });
+        const levelIndex = argv.indexOf("--level");
+        const level = levelIndex >= 0 && argv[levelIndex + 1] === "AAA" ? "AAA" : "AA";
+        const result = auditRegister(register, { level, largeText: argv.includes("--large-text") });
+        process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
+        process.exitCode = result.passes ? 0 : 1;
+        return;
+    }
+    usage();
+    process.exitCode = 1;
+}
+main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,45 @@
+export interface OklchColor {
+    l: number;
+    c: number;
+    h: number;
+    alpha: number;
+}
+/**
+ * Parses any CSS color string (or passes an `OklchColor` through) into an `OklchColor`. Hex follows CSS:
+ * `#RGB` / `#RRGGBB`, and an 8-digit `#RRGGBBAA` is alpha-*last*. Alpha-first ARGB (`#AARRGGBB`) is not a
+ * CSS format and parses wrong; convert it with `argbToRgbHex` first. Throws on an unparseable input.
+ */
+export declare function toOklchColor(input: string | OklchColor): OklchColor;
+export declare function oklch(l: number, c: number, h: number, alpha?: number): OklchColor;
+export declare function withLightness(color: OklchColor, l: number): OklchColor;
+export declare function withAlpha(color: OklchColor, alpha: number): OklchColor;
+export declare function rotateHue(color: OklchColor, deg: number): OklchColor;
+/**
+ * The signed shortest-path hue difference `to - from`, normalized to `(-180, 180]`.
+ * Positive turns counter-clockwise on the OKLCH hue wheel; negative clockwise.
+ */
+export declare function hueDelta(from: number, to: number): number;
+export declare function lightness(input: string | OklchColor): number;
+/**
+ * Converts an alpha-first ARGB hex (`#AARRGGBB`, the Material Color Utilities / Android
+ * `Color.toArgb()` / Jetpack Compose serialization) to a CSS `#RRGGBB` by dropping the leading alpha
+ * byte. Passes a `#RRGGBB` through and expands a `#RGB` shorthand, so any hex out of an ARGB pipeline
+ * can be routed through it before `contrast` or `toOklchColor`, which read CSS hex only: an 8-digit
+ * input is taken as CSS alpha-*last* `#RRGGBBAA`, so an un-converted ARGB color parses silently wrong
+ * (its alpha byte becomes red). Throws on a non-hex string.
+ */
+export declare function argbToRgbHex(hex: string): string;
+/**
+ * The WCAG 2.x contrast ratio (1..21) between two colors, each a CSS color string or an `OklchColor`.
+ * Alpha is ignored (WCAG contrast is defined on opaque colors). Hex is read as CSS: `#RGB` / `#RRGGBB`,
+ * and an 8-digit `#RRGGBBAA` is alpha-*last*. Alpha-first ARGB (`#AARRGGBB`, common out of Material
+ * Color Utilities / Android) is NOT a CSS format and parses silently wrong here; convert it with
+ * `argbToRgbHex` first.
+ */
+export declare function contrast(a: string | OklchColor, b: string | OklchColor): number;
+export declare function clampToGamut(color: OklchColor): OklchColor;
+export declare function formatCss(input: string | OklchColor): string;
+export declare function schemeOf(bg: string | OklchColor): "dark" | "light";
+export declare function pickReadable(fill: string | OklchColor, options: Array<string | OklchColor>, floor?: number): string;
+export declare function clamp01(value: number): number;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACd;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAYnE;AAED,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,UAAU,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,CAEtE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAEtE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAEpE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAE5D;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUhD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAG/E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAY1D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAc5D;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,EACnC,KAAK,SAAM,GACT,MAAM,CAYR;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7C"}