@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/theme/salience.js

@@ -0,0 +1,208 @@
+/**
+ * Helmholtz–Kohlrausch salience solver.
+ *
+ * Palette seeds are (hue, chroma, tier). Each tier is an apparent-lightness
+ * contrast delta from ground; the solver compensates H-K so chromatic colors
+ * match achromatic brightness on the same tier.
+ *
+ *   perceived_AL = L + 0.14 · C · hue_factor(h)   // chromatic looks brighter
+ *   L_nominal    = target_AL − 0.14 · C · hue_factor(h)
+ *
+ * Hue weight is the **Nayatani 3-harmonic** (SSOT: Delta foundation.css +
+ * postcss-oklch-plus / helmholtz-kohlrausch-models.md).
+ *
+ * Ground is runtime input — pair with OSC 11 for terminal-attuned palettes.
+ * Color math via culori (OKLCH ↔ sRGB).
+ */
+import { converter, formatHex, parse } from "culori";
+import invariant from "tiny-invariant";
+const toOklch = converter("oklch");
+const toRgb = converter("rgb");
+/** H-K chroma scale (≈ Fairchild–Pirrotta k; magnitude is Delta's budget). */
+export const HK_K = 0.14;
+/**
+ * Apparent-lightness contrast deltas per tier at the reference ground.
+ * At L_ground = 0.2 these target recede≈0.55 … anchor≈0.85.
+ * Tier names are vocabulary (../lexicon/index.js); the deltas are
+ * solver calibration and live here.
+ */
+export const TIER_DELTAS = {
+    alarm: 0.33,
+    recede: 0.35,
+    differentiate: 0.42,
+    baseline: 0.57,
+    anchor: 0.65,
+};
+/** Reference near-black ground the tier deltas were derived against. */
+export const REFERENCE_GROUND = 0.2;
+const AL_MIN = 0.03;
+const AL_MAX = 0.97;
+const MAX_DELTA = 0.65;
+/**
+ * Nayatani-1997 VAC hue weight — 3-harmonic Fourier fit in OKLCH hue degrees.
+ * SSOT coefficients: delta/delta-css foundation.css `--🧮hue-factor` and
+ * commons/packages/postcss-oklch-plus `nayataniHueFactor` (R²≈0.98 vs VAC q(θ),
+ * mean 0.779 preserves Delta compensation budget).
+ * Inherently ~[0.54, 0.92] — no clamp.
+ */
+const NAY_A0 = 0.779_11;
+const NAY_COS = [0.080_91, 0.062_02, -0.014_15];
+const NAY_SIN = [-0.135_93, -0.003_65, 0.033_77];
+export function hueFactor(h) {
+    let v = NAY_A0;
+    const rad = (h * Math.PI) / 180;
+    for (let k = 1; k <= 3; k++) {
+        const r = k * rad;
+        v += NAY_COS[k - 1] * Math.cos(r) + NAY_SIN[k - 1] * Math.sin(r);
+    }
+    return v;
+}
+/** Amount of L to subtract so a chromatic color sits level with gray at same L. */
+export function hkCompensation(c, h) {
+    return HK_K * Math.max(0, c) * hueFactor(h);
+}
+/**
+ * Perceived / apparent lightness (chromatic looks *brighter* than measured L).
+ * Inverse of solveLightness for fixed (C,h).
+ */
+export function apparentLightness(l, c, h) {
+    return l + hkCompensation(c, h);
+}
+/**
+ * Nominal OKLCH L that lands (C, h) on a target apparent lightness.
+ * Chromatic → lower measured L (same as bake-darcula / Delta CSS subtract).
+ */
+export function solveLightness(targetAl, c, h) {
+    return targetAl - hkCompensation(c, h);
+}
+function resolvePolaritySign(ground, polarity) {
+    if (polarity === "up")
+        return 1;
+    if (polarity === "down")
+        return -1;
+    return ground < 0.5 ? 1 : -1;
+}
+/**
+ * Target apparent lightness for a tier against ground, with headroom
+ * compression when the ground leaves less than the full delta range.
+ */
+export function tierTarget(tier, ground, polarity = "auto") {
+    const sign = resolvePolaritySign(ground, polarity);
+    const headroom = sign === 1 ? AL_MAX - ground : ground - AL_MIN;
+    const scale = Math.min(1, Math.max(0, headroom / MAX_DELTA));
+    return ground + sign * TIER_DELTAS[tier] * scale;
+}
+/**
+ * Solve (C, h) on a salience tier against ground → sRGB hex.
+ */
+export function solve(tier, c, h, opts = {}) {
+    const ground = opts.ground ?? REFERENCE_GROUND;
+    const polarity = opts.polarity ?? "auto";
+    const target = tierTarget(tier, ground, polarity);
+    const l = solveLightness(target, c, h);
+    return oklchToHex(l, c, h);
+}
+/** Solve a seed list into `{ name → hex }`. */
+export function solvePalette(seeds, opts = {}) {
+    const out = {};
+    for (const s of seeds) {
+        out[s.name] = solve(s.tier, s.c, s.h, opts);
+    }
+    return out;
+}
+/**
+ * True when OKLCH (l,c,h) is inside sRGB (linear channels in [0,1]).
+ * Culori `formatHex` / RGB conversion is *not* this check — it channel-clips.
+ */
+export function inSrgb(l, c, h) {
+    const rgb = toRgb({
+        mode: "oklch",
+        l,
+        c: Math.max(0, c),
+        h,
+    });
+    if (!rgb)
+        return false;
+    const eps = 1e-4;
+    return rgb.r >= -eps && rgb.r <= 1 + eps && rgb.g >= -eps && rgb.g <= 1 + eps && rgb.b >= -eps && rgb.b <= 1 + eps;
+}
+/**
+ * Map OKLCH into sRGB by shrinking chroma at fixed hue, then re-solving L
+ * so H-K apparent lightness matches the request. Channel-clip (culori
+ * formatHex, nearest-legal RGB) rotates hue — yellow at low L becomes
+ * rust `#542400` (h 77 → 51). We never do that.
+ */
+export function fitOklchToSrgb(l, c, h) {
+    const clampedL = Math.min(0.999, Math.max(0.001, l));
+    const reqC = Math.max(0, c);
+    if (reqC === 0 || inSrgb(clampedL, reqC, h)) {
+        return { l: clampedL, c: reqC, h };
+    }
+    const targetAl = apparentLightness(clampedL, reqC, h);
+    let lo = 0;
+    let hi = reqC;
+    let bestL = Math.min(0.999, Math.max(0.001, solveLightness(targetAl, 0, h)));
+    let bestC = 0;
+    for (let i = 0; i < 24; i++) {
+        const mid = (lo + hi) / 2;
+        const lMid = Math.min(0.999, Math.max(0.001, solveLightness(targetAl, mid, h)));
+        if (inSrgb(lMid, mid, h)) {
+            bestC = mid;
+            bestL = lMid;
+            lo = mid;
+        }
+        else {
+            hi = mid;
+        }
+    }
+    return { l: bestL, c: bestC, h };
+}
+export function oklchToHex(l, c, h) {
+    const fitted = fitOklchToSrgb(l, c, h);
+    const hex = formatHex({
+        mode: "oklch",
+        l: fitted.l,
+        c: fitted.c,
+        h: fitted.h,
+    });
+    if (!hex) {
+        return formatHex({ mode: "oklch", l: fitted.l, c: 0, h: 0 }) ?? "#808080";
+    }
+    return hex;
+}
+export function hexToOklch(hex) {
+    const parsed = parse(hex.startsWith("#") ? hex : `#${hex}`);
+    invariant(parsed, `invalid hex color: ${hex}`);
+    const o = toOklch(parsed);
+    invariant(o, `oklch convert failed: ${hex}`);
+    invariant(o.l !== undefined, `oklch convert missing L: ${hex}`);
+    return {
+        l: o.l,
+        c: o.c ?? 0,
+        h: o.h ?? 0,
+    };
+}
+export function hexToRgb(hex) {
+    const parsed = parse(hex.startsWith("#") ? hex : `#${hex}`);
+    invariant(parsed, `invalid hex color: ${hex}`);
+    const r = toRgb(parsed);
+    invariant(r, `rgb convert failed: ${hex}`);
+    return {
+        r: Math.round(Math.min(1, Math.max(0, r.r ?? 0)) * 255),
+        g: Math.round(Math.min(1, Math.max(0, r.g ?? 0)) * 255),
+        b: Math.round(Math.min(1, Math.max(0, r.b ?? 0)) * 255),
+    };
+}
+/** sRGB → OKLCH L from 0–255 channel triple (OSC 11 ground path). */
+export function rgbToOklch(r, g, b) {
+    const o = toOklch({
+        mode: "rgb",
+        r: r / 255,
+        g: g / 255,
+        b: b / 255,
+    });
+    invariant(o, `oklch convert failed for rgb(${r},${g},${b})`);
+    invariant(o.l !== undefined, `oklch convert missing L for rgb(${r},${g},${b})`);
+    return { l: o.l, c: o.c ?? 0, h: o.h ?? 0 };
+}
+//# sourceMappingURL=salience.js.map

package/dist/theme/salience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"salience.js","sourceRoot":"","sources":["../../src/theme/salience.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACrD,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAKvC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;AACnC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;AAE/B,8EAA8E;AAC9E,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC;AAEzB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,IAAI;CAC2B,CAAC;AAE1C,wEAAwE;AACxE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAEpC,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,MAAM,GAAG,IAAI,CAAC;AACpB,MAAM,SAAS,GAAG,IAAI,CAAC;AAEvB;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,QAAQ,CAAC;AACxB,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAU,CAAC;AACzD,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AAE1D,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,GAAG,MAAM,CAAC;IACf,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAClB,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS;IACjD,OAAO,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC/D,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,CAAS,EAAE,CAAS;IACnE,OAAO,QAAQ,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAc,EAAE,QAAkB;IAC7D,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAChC,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,CAAC,CAAC,CAAC;IACnC,OAAO,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,MAAc,EAAE,WAAqB,MAAM;IAChF,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,CAAC;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;IAC7D,OAAO,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;AACnD,CAAC;AAOD;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,IAAU,EAAE,CAAS,EAAE,CAAS,EAAE,OAAkB,EAAE;IAC1E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC;IACzC,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC7B,CAAC;AASD,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,KAAsB,EAAE,OAAkB,EAAE;IACvE,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,EAAE,OAAO;QACb,CAAC;QACD,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IACH,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC;IACjB,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;AACrH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,IAAI,CAAC;IACd,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YACzB,KAAK,GAAG,GAAG,CAAC;YACZ,KAAK,GAAG,IAAI,CAAC;YACb,EAAE,GAAG,GAAG,CAAC;QACX,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACxD,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,SAAS,CAAC;QACpB,IAAI,EAAE,OAAO;QACb,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,CAAC,EAAE,MAAM,CAAC,CAAC;QACX,CAAC,EAAE,MAAM,CAAC,CAAC;KACZ,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,SAAS,CAAC;IAC5E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC5D,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,SAAS,CAAC,CAAC,EAAE,yBAAyB,GAAG,EAAE,CAAC,CAAC;IAC7C,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,4BAA4B,GAAG,EAAE,CAAC,CAAC;IAChE,OAAO;QACL,CAAC,EAAE,CAAC,CAAC,CAAC;QACN,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACX,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;IAC5D,SAAS,CAAC,MAAM,EAAE,sBAAsB,GAAG,EAAE,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACxB,SAAS,CAAC,CAAC,EAAE,uBAAuB,GAAG,EAAE,CAAC,CAAC;IAC3C,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACvD,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACvD,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACxD,MAAM,CAAC,GAAG,OAAO,CAAC;QAChB,IAAI,EAAE,KAAK;QACX,CAAC,EAAE,CAAC,GAAG,GAAG;QACV,CAAC,EAAE,CAAC,GAAG,GAAG;QACV,CAAC,EAAE,CAAC,GAAG,GAAG;KACX,CAAC,CAAC;IACH,SAAS,CAAC,CAAC,EAAE,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7D,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,mCAAmC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC"}

package/dist/theme/seeds.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Semantic seed table — hue carries identity, tier carries importance.
+ * Compensated-Darcula family (same seeds as SalienceTheme).
+ *
+ * Role names and default tiers are vocabulary
+ * (../lexicon/index.js); the hue/chroma numbers are palette
+ * calibration and live here.
+ */
+import { type Seed } from "./salience.js";
+import type { Rgb, SemanticRole } from "../lexicon/index.js";
+export type SeedRow = Seed & {
+    name: SemanticRole;
+};
+/**
+ * Core semantic seeds. Hues: orange 62 (warning, Apple systemOrange
+ * #FF9500 → OKLCH h≈62.6; 15° from emphasis 77), yellow 77 (emphasis),
+ * yellow-green 110 (attention), green 134 (success), blue 211
+ * (auto classifier-on), blue 242 (accent), azure 270 (code),
+ * neutral-blue 250 (text), red 25.
+ * Warning is baseline so orange stays orange — differentiate L collapses
+ * it to rust, which reads as dim error. `code` is baseline: same
+ * apparent-lightness as body; azure is identity, not recede.
+ * `auto` is baseline cyan-blue so the chip cannot mute into accent.
+ * `attention` is anchor yellow-green — look-here must stay brighter than
+ * classifier-on; alarm L turns 110 olive.
+ */
+export declare const DEFAULT_SEEDS: [{
+    readonly name: "foreground";
+    readonly h: 250;
+    readonly c: 0.022;
+    readonly tier: "baseline";
+}, {
+    readonly name: "accent";
+    readonly h: 242;
+    readonly c: 0.074;
+    readonly tier: "differentiate";
+}, {
+    readonly name: "error";
+    readonly h: 25;
+    readonly c: 0.16;
+    readonly tier: "alarm";
+}, {
+    readonly name: "warning";
+    readonly h: 62;
+    readonly c: 0.17;
+    readonly tier: "baseline";
+}, {
+    readonly name: "success";
+    readonly h: 134;
+    readonly c: 0.075;
+    readonly tier: "differentiate";
+}, {
+    readonly name: "emphasis";
+    readonly h: 77;
+    readonly c: 0.125;
+    readonly tier: "anchor";
+}, {
+    readonly name: "muted";
+    readonly h: 250;
+    readonly c: 0;
+    readonly tier: "recede";
+}, {
+    readonly name: "border";
+    readonly h: 250;
+    readonly c: 0;
+    readonly tier: "recede";
+}, {
+    readonly name: "chrome";
+    readonly h: 250;
+    readonly c: 0.01;
+    readonly tier: "recede";
+}, {
+    readonly name: "surface";
+    readonly h: 250;
+    readonly c: 0;
+    readonly tier: "recede";
+}, {
+    readonly name: "code";
+    readonly h: 270;
+    readonly c: 0.065;
+    readonly tier: "baseline";
+}, {
+    readonly name: "diff_add";
+    readonly h: 134;
+    readonly c: 0.09;
+    readonly tier: "differentiate";
+}, {
+    readonly name: "diff_del";
+    readonly h: 25;
+    readonly c: 0.14;
+    readonly tier: "alarm";
+}, {
+    readonly name: "running";
+    readonly h: 320;
+    readonly c: 0.1;
+    readonly tier: "differentiate";
+}, {
+    readonly name: "auto";
+    readonly h: 211;
+    readonly c: 0.12;
+    readonly tier: "baseline";
+}, {
+    readonly name: "attention";
+    readonly h: 110;
+    readonly c: 0.16;
+    readonly tier: "anchor";
+}];
+/**
+ * Role hue/chroma as an RGB sample. Apparent lightness is dummy (L=0.5);
+ * paint pairs this with a surrounding role so the resolver recasts AL.
+ */
+export declare function seedHueRgb(role: SemanticRole): Rgb;
+//# sourceMappingURL=seeds.d.ts.map

package/dist/theme/seeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.d.ts","sourceRoot":"","sources":["../../src/theme/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAwB,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEpD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBI,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,GAAG,CAIlD"}

package/dist/theme/seeds.js

@@ -0,0 +1,52 @@
+/**
+ * Semantic seed table — hue carries identity, tier carries importance.
+ * Compensated-Darcula family (same seeds as SalienceTheme).
+ *
+ * Role names and default tiers are vocabulary
+ * (../lexicon/index.js); the hue/chroma numbers are palette
+ * calibration and live here.
+ */
+import invariant from "tiny-invariant";
+import { hexToRgb, oklchToHex } from "./salience.js";
+/**
+ * Core semantic seeds. Hues: orange 62 (warning, Apple systemOrange
+ * #FF9500 → OKLCH h≈62.6; 15° from emphasis 77), yellow 77 (emphasis),
+ * yellow-green 110 (attention), green 134 (success), blue 211
+ * (auto classifier-on), blue 242 (accent), azure 270 (code),
+ * neutral-blue 250 (text), red 25.
+ * Warning is baseline so orange stays orange — differentiate L collapses
+ * it to rust, which reads as dim error. `code` is baseline: same
+ * apparent-lightness as body; azure is identity, not recede.
+ * `auto` is baseline cyan-blue so the chip cannot mute into accent.
+ * `attention` is anchor yellow-green — look-here must stay brighter than
+ * classifier-on; alarm L turns 110 olive.
+ */
+export const DEFAULT_SEEDS = [
+    { name: "foreground", h: 250, c: 0.022, tier: "baseline" },
+    { name: "accent", h: 242, c: 0.074, tier: "differentiate" },
+    { name: "error", h: 25, c: 0.16, tier: "alarm" },
+    { name: "warning", h: 62, c: 0.17, tier: "baseline" },
+    { name: "success", h: 134, c: 0.075, tier: "differentiate" },
+    { name: "emphasis", h: 77, c: 0.125, tier: "anchor" },
+    { name: "muted", h: 250, c: 0, tier: "recede" },
+    { name: "border", h: 250, c: 0, tier: "recede" },
+    // extended roles (same hue families as ANSI16 pins)
+    { name: "chrome", h: 250, c: 0.01, tier: "recede" },
+    { name: "surface", h: 250, c: 0, tier: "recede" },
+    { name: "code", h: 270, c: 0.065, tier: "baseline" },
+    { name: "diff_add", h: 134, c: 0.09, tier: "differentiate" },
+    { name: "diff_del", h: 25, c: 0.14, tier: "alarm" },
+    { name: "running", h: 320, c: 0.1, tier: "differentiate" },
+    { name: "auto", h: 211, c: 0.12, tier: "baseline" },
+    { name: "attention", h: 110, c: 0.16, tier: "anchor" },
+];
+/**
+ * Role hue/chroma as an RGB sample. Apparent lightness is dummy (L=0.5);
+ * paint pairs this with a surrounding role so the resolver recasts AL.
+ */
+export function seedHueRgb(role) {
+    const seed = DEFAULT_SEEDS.find((row) => row.name === role);
+    invariant(seed, `unknown seed role: ${role}`);
+    return hexToRgb(oklchToHex(0.5, seed.c, seed.h));
+}
+//# sourceMappingURL=seeds.js.map

package/dist/theme/seeds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeds.js","sourceRoot":"","sources":["../../src/theme/seeds.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAa,MAAM,eAAe,CAAC;AAKhE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;IAC1D,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE;IAC3D,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;IAChD,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IACrD,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,EAAE;IAC5D,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE;IACrD,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/C,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChD,oDAAoD;IACpD,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE;IACjD,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE;IACpD,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE;IAC5D,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;IACnD,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE;IAC1D,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;IACnD,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;CAC1B,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAkB;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,IAAI,EAAE,sBAAsB,IAAI,EAAE,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/theme/selection.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Selection recolor — perception-preserving highlight via the HK salience
+ * pipeline. NOT reverse-video, NOT alpha-blend of an opaque tint over content.
+ *
+ * Two channels, different jobs:
+ *
+ *  1. **FG** — identity-preserving active shift: lerp apparent lightness toward
+ *     the anchor tier, **keep chroma** (hue stays exact — Zed #17313). The
+ *     8–10% AL budget is for the *foreground*, not a prominence scalar.
+ *
+ *  2. **BG** — a real selection fill. Most terminal cells have no painted bg
+ *     (transparent → terminal ground). Without a fill, selection is invisible
+ *     except as a tiny fg delta. Fill is ground lifted toward a mild accent
+ *     wash so the block reads as selected while remaining theme-coherent.
+ *
+ * The region-dim formula `c * p^γ` must NOT be reused with `p = SELECTION_SHIFT`.
+ * Region prominence is "how much color remains" (1 = full, 0 = gone). Selection
+ * shift is "how far to move AL" (0.09 = 9% of the way). Feeding 0.09 into the
+ * prominence power law crushed chroma to ~27% and made selection look like
+ * desaturated grey — the failure mode reported on the LLM-pick story.
+ *
+ * Shift budget (fg AL), from dark-theme design notes:
+ *   "active states increase 8-10% lightness."
+ */
+import { type Rgb } from "../lexicon/index.js";
+/**
+ * Active-state lightness shift for **foreground** — fraction of the way from
+ * current AL toward the selection target AL. 0.09 ≈ 9% (active-state budget).
+ */
+export declare const SELECTION_SHIFT = 0.09;
+/**
+ * How far to lift (dark themes) or drop (light themes) ground AL when minting
+ * a selection fill. Large enough to read as a block highlight at a glance;
+ * small enough not to compete with accent/emphasis content.
+ */
+export declare const SELECTION_FILL_AL_DELTA = 0.16;
+/**
+ * Mild chroma on the selection fill (OKLCH C). Accent-hue wash, not a neon
+ * bar. 0.045 sits under most role chromas so selected text still wins.
+ */
+export declare const SELECTION_FILL_CHROMA = 0.045;
+/**
+ * Accent hue for the selection wash (OKLCH H). Matches seed `accent` (~242°
+ * blue) so the fill feels like the same system, not a foreign reverse-video.
+ */
+export declare const SELECTION_FILL_HUE = 242;
+/**
+ * Target apparent lightness for selected **foreground**. Top of the tier
+ * ladder (`anchor`) so selected text reads active without leaving the palette.
+ */
+export declare function selectionTargetAl(ground: number): number;
+/**
+ * Target apparent lightness for the selection **fill** (background).
+ * Dark themes: lift ground up. Light themes: drop ground down. Symmetric
+ * so selection remains visible under either polarity.
+ */
+export declare function selectionFillTargetAl(ground: number): number;
+/**
+ * Recolor a **foreground** sRGB color for selection.
+ *
+ * - Hue preserved EXACTLY.
+ * - Chroma preserved (identity of colored content — diff-red stays red and
+ *   saturated, not washed grey).
+ * - Apparent lightness lerps toward the selection target by `shift`.
+ * - At `shift === 0` the function is byte-identity.
+ */
+export declare function selectionRecolorRgb(rgb: Rgb, ground: number, shift?: number): Rgb;
+/**
+ * Mint a selection **fill** color from theme ground (and optional accent hue).
+ * Used when a cell has no painted background (the common terminal case).
+ */
+export declare function selectionFillRgb(ground: number, opts?: {
+    hue?: number;
+    chroma?: number;
+}): Rgb;
+/**
+/**
+ * Minimum |ΔAL| between a painted bg and its selected recolor.
+ * Same step as the empty-cell fill (`SELECTION_FILL_AL_DELTA`). The
+ * toward-fill lerp alone lands ~0.063 on a wash — under the 0.074
+ * brightness JND, so selection on a Diff row is invisible.
+ */
+export declare const SELECTION_BG_MIN_AL_STEP = 0.16;
+/**
+ * Recolor an existing **background** for selection: lift/drop AL toward the
+ * fill target, inject a mild accent chroma while preserving any strong
+ * existing hue (so a colored panel bg stays itself, just selected).
+ *
+ * Painted cells cannot reuse the empty-cell fill target as the only aim —
+ * elevation already sits near `ground ± 0.16`. Take the further of the
+ * lerp and a minimum AL step so the block still reads as selected.
+ */
+export declare function selectionRecolorBgRgb(rgb: Rgb, ground: number, shift?: number): Rgb;
+//# sourceMappingURL=selection.d.ts.map

package/dist/theme/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/theme/selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAwB,GAAG,GAAG,CAYlG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,GAAG,CAMlG;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,OAA0B,CAAC;AAEhE;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAa,GAAG,GAAG,CAiBzF"}

package/dist/theme/selection.js

@@ -0,0 +1,135 @@
+/**
+ * Selection recolor — perception-preserving highlight via the HK salience
+ * pipeline. NOT reverse-video, NOT alpha-blend of an opaque tint over content.
+ *
+ * Two channels, different jobs:
+ *
+ *  1. **FG** — identity-preserving active shift: lerp apparent lightness toward
+ *     the anchor tier, **keep chroma** (hue stays exact — Zed #17313). The
+ *     8–10% AL budget is for the *foreground*, not a prominence scalar.
+ *
+ *  2. **BG** — a real selection fill. Most terminal cells have no painted bg
+ *     (transparent → terminal ground). Without a fill, selection is invisible
+ *     except as a tiny fg delta. Fill is ground lifted toward a mild accent
+ *     wash so the block reads as selected while remaining theme-coherent.
+ *
+ * The region-dim formula `c * p^γ` must NOT be reused with `p = SELECTION_SHIFT`.
+ * Region prominence is "how much color remains" (1 = full, 0 = gone). Selection
+ * shift is "how far to move AL" (0.09 = 9% of the way). Feeding 0.09 into the
+ * prominence power law crushed chroma to ~27% and made selection look like
+ * desaturated grey — the failure mode reported on the LLM-pick story.
+ *
+ * Shift budget (fg AL), from dark-theme design notes:
+ *   "active states increase 8-10% lightness."
+ */
+import { apparentLightness, hexToRgb, oklchToHex, rgbToOklch, solveLightness, tierTarget } from "./salience.js";
+/**
+ * Active-state lightness shift for **foreground** — fraction of the way from
+ * current AL toward the selection target AL. 0.09 ≈ 9% (active-state budget).
+ */
+export const SELECTION_SHIFT = 0.09;
+/**
+ * How far to lift (dark themes) or drop (light themes) ground AL when minting
+ * a selection fill. Large enough to read as a block highlight at a glance;
+ * small enough not to compete with accent/emphasis content.
+ */
+export const SELECTION_FILL_AL_DELTA = 0.16;
+/**
+ * Mild chroma on the selection fill (OKLCH C). Accent-hue wash, not a neon
+ * bar. 0.045 sits under most role chromas so selected text still wins.
+ */
+export const SELECTION_FILL_CHROMA = 0.045;
+/**
+ * Accent hue for the selection wash (OKLCH H). Matches seed `accent` (~242°
+ * blue) so the fill feels like the same system, not a foreign reverse-video.
+ */
+export const SELECTION_FILL_HUE = 242;
+/**
+ * Target apparent lightness for selected **foreground**. Top of the tier
+ * ladder (`anchor`) so selected text reads active without leaving the palette.
+ */
+export function selectionTargetAl(ground) {
+    return tierTarget("anchor", ground);
+}
+/**
+ * Target apparent lightness for the selection **fill** (background).
+ * Dark themes: lift ground up. Light themes: drop ground down. Symmetric
+ * so selection remains visible under either polarity.
+ */
+export function selectionFillTargetAl(ground) {
+    if (ground < 0.5) {
+        return Math.min(0.55, ground + SELECTION_FILL_AL_DELTA);
+    }
+    return Math.max(0.45, ground - SELECTION_FILL_AL_DELTA);
+}
+/**
+ * Recolor a **foreground** sRGB color for selection.
+ *
+ * - Hue preserved EXACTLY.
+ * - Chroma preserved (identity of colored content — diff-red stays red and
+ *   saturated, not washed grey).
+ * - Apparent lightness lerps toward the selection target by `shift`.
+ * - At `shift === 0` the function is byte-identity.
+ */
+export function selectionRecolorRgb(rgb, ground, shift = SELECTION_SHIFT) {
+    if (!Number.isFinite(shift) || shift <= 0)
+        return rgb;
+    const t = Math.min(1, shift);
+    const { l, c, h } = rgbToOklch(rgb.r, rgb.g, rgb.b);
+    const al = apparentLightness(l, c, h);
+    const targetAl = selectionTargetAl(ground);
+    const newAl = al + (targetAl - al) * t;
+    // Keep chroma. Region-dim's p^γ law does not apply here (see file header).
+    const newC = c;
+    const newL = solveLightness(newAl, newC, h);
+    const hex = oklchToHex(newL, newC, h);
+    return hexToRgb(hex);
+}
+/**
+ * Mint a selection **fill** color from theme ground (and optional accent hue).
+ * Used when a cell has no painted background (the common terminal case).
+ */
+export function selectionFillRgb(ground, opts = {}) {
+    const h = opts.hue ?? SELECTION_FILL_HUE;
+    const c = opts.chroma ?? SELECTION_FILL_CHROMA;
+    const al = selectionFillTargetAl(ground);
+    const l = solveLightness(al, c, h);
+    return hexToRgb(oklchToHex(l, c, h));
+}
+/**
+/**
+ * Minimum |ΔAL| between a painted bg and its selected recolor.
+ * Same step as the empty-cell fill (`SELECTION_FILL_AL_DELTA`). The
+ * toward-fill lerp alone lands ~0.063 on a wash — under the 0.074
+ * brightness JND, so selection on a Diff row is invisible.
+ */
+export const SELECTION_BG_MIN_AL_STEP = SELECTION_FILL_AL_DELTA;
+/**
+ * Recolor an existing **background** for selection: lift/drop AL toward the
+ * fill target, inject a mild accent chroma while preserving any strong
+ * existing hue (so a colored panel bg stays itself, just selected).
+ *
+ * Painted cells cannot reuse the empty-cell fill target as the only aim —
+ * elevation already sits near `ground ± 0.16`. Take the further of the
+ * lerp and a minimum AL step so the block still reads as selected.
+ */
+export function selectionRecolorBgRgb(rgb, ground, shift = 0.55) {
+    if (!Number.isFinite(shift) || shift <= 0)
+        return rgb;
+    const t = Math.min(1, shift);
+    const { l, c, h } = rgbToOklch(rgb.r, rgb.g, rgb.b);
+    const al = apparentLightness(l, c, h);
+    const targetAl = selectionFillTargetAl(ground);
+    const towardFill = al + (targetAl - al) * t;
+    const dark = ground < 0.5;
+    const stepped = dark ? al + SELECTION_BG_MIN_AL_STEP : al - SELECTION_BG_MIN_AL_STEP;
+    const newAl = dark ? Math.max(towardFill, stepped) : Math.min(towardFill, stepped);
+    // If the bg is nearly achromatic, adopt the selection wash hue/chroma.
+    // If it already carries color, keep its hue and blend chroma toward the wash.
+    const achromatic = c < 0.01;
+    const newH = achromatic ? SELECTION_FILL_HUE : h;
+    const newC = achromatic ? SELECTION_FILL_CHROMA : c + (SELECTION_FILL_CHROMA - c) * (t * 0.5);
+    const newL = solveLightness(newAl, newC, newH);
+    return hexToRgb(oklchToHex(newL, newC, newH));
+}
+//# sourceMappingURL=selection.js.map

package/dist/theme/selection.js.map

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