@inhuman.tools/quickdraw 0.0.0-stage → 0.3.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/theme/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AASH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,KAAK,GAAG,EAA4B,MAAM,qBAAqB,CAAC;AAEzE,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,aAAa,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAUF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAqGzC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,UAAU,GAAG,SAAS,CA8KzE;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,CAElF"}

package/dist/theme/resolver.js

@@ -0,0 +1,366 @@
+/**
+ * ColorResolver — single choke-point resolve of role intents → concrete
+ * style fields. Dual-dirty: re-run on an existing Frame without layout().
+ *
+ * Style may carry:
+ *   - role (+ prominence) — re-solved against current Theme + depth
+ *   - bgRole (+ bgProminence) — background identity, resolved via the BG ladder
+ *   - literal fg / fgRgb / bg / bgRgb — passed through, optionally region-dimmed.
+ *     fgRgb + role: hue/chroma from the literal (syntax tokens), apparent
+ *     lightness from the role — same weight as body at that FgP. fgRgb
+ *     alone stays claimed color.
+ *
+ * Layout stays theme-free: it only needs a resolveStyle callback.
+ *
+ * ## Pipeline (fixed order — G2)
+ *
+ *   1. solve(role, tier, ground)      — baked into `Theme.rgb`/`colors` at
+ *                                        build time (buildTheme/solvePalette);
+ *                                        this resolver only *consumes* it.
+ *   2. prominence compose (own × region) — `effectiveP = ownP * regionP`.
+ *      Region is the multiplicative fade of ALL paint (backdrop model, decision
+ *      1): a de-emphasized region fades fg AND bg by the same `regionProminence`.
+ *   3. bold H-K compensation          — {@link compensateBoldRgb} on the
+ *      role FG path (role alone, or fgRgb recast onto a role). Never
+ *      bgRole/bgRgb, never fgRgb with no role.
+ *   4. bg resolve                     — `bgRole`+`bgProminence` (BgP: fill
+ *      solidity of painted furniture, composed with region only — never with
+ *      FG's own prominence) via the ELEVATION law ({@link elevateBgRgb}):
+ *      ground raised a small AL step toward the role's hue, never the role's
+ *      text color faded. Else literal `bg`/`bgRgb` (region-faded, never
+ *      role-faded).
+ *   5. selection recolor              — perception-preserving highlight on
+ *      the solved RGB (identity-preserving AL shift on fg, fill/recolor on
+ *      bg) *before* depth emit so ansi16/256 get a real shift, not a no-op
+ *      on missing fgRgb. Composing after bold compensation means a
+ *      bold+selected cell shifts once, from the already-compensated base —
+ *      no double-shift.
+ *   6. depth degradation              — truecolor rgb → ansi256 index →
+ *      ansi16 hue-preserving slot → mono (no color SGR at all, NO_COLOR);
+ *      `dim` is *emitted* here as the ansi16-and-mono-shared degradation of
+ *      low FG prominence, never *authored* by a role. Mono still runs the
+ *      full solve upstream (tier/prominence math, bold H-K compensation,
+ *      selection) — only the final color escape is withheld; bold/italic/
+ *      strike/underline attributes are untouched and always pass through
+ *      (capabilities/src/types.ts:5-10 is the mono attribute-policy SSOT).
+ *      Selected roles at ansi16 emit via nearest-RGB (not the role slot
+ *      table) so the AL shift is visible in the index.
+ *
+ * Region (step 2) vs bg (step 4) are never interchangeable: region says "how
+ * much of the room is present", bg says "how solid is the furniture painted
+ * into it". A call site names which one it means.
+ */
+import invariant from "tiny-invariant";
+import { ansi16Slot, ansi16ToRgb, canvasPolarity, nearestAnsi16FromRgb } from "./ansi16.js";
+import { ansi256ToRgb, nearestAnsi256FromRgb } from "./ansi256.js";
+import { fadeTowardSurfaceRgb, mixTowardTintRgb, regionDimRgb } from "./region.js";
+import { apparentLightness, hexToRgb, oklchToHex, rgbToOklch, solveLightness } from "./salience.js";
+import { selectionFillRgb, selectionRecolorBgRgb, selectionRecolorRgb } from "./selection.js";
+import { FgP, ROLES } from "../lexicon/index.js";
+/** Foreground prominence at/below which ansi16 degrades to `dim` (G2 step 6). */
+const DIM_THRESHOLD = FgP.ghost;
+function clamp01(p) {
+    if (!Number.isFinite(p))
+        return 1;
+    return Math.min(1, Math.max(0, p));
+}
+/**
+ * Bold H-K compensation (enabler 7). Irradiation (Helmholtz 1867, observed by
+ * Galileo 1632) makes light-on-dark strokes look brighter/heavier than their
+ * measured lightness; on dark surfaces this compounds with sRGB gamma
+ * spreading (`typography.md`: "the double effect means dark theme display
+ * text at conventional bold weights appears significantly over-weighted").
+ * The resolver counters by nudging the solved apparent lightness back toward
+ * ground by a fixed budget so bold reads as *weight*, not as an accent bump.
+ * Polarity-aware: the shift is toward ground on EITHER polarity (dark ground
+ * pulls down, light ground pushes up) — never away from it.
+ *
+ * Delta derivation anchor (G10): Delta's surface-adaptive weight already
+ * solves the same irradiation family for font weight — `--font-weight`
+ * (`delta/delta-css/src/typography.css:78-81`) linearly interpolates
+ * `--⚙️weight-dark-surface` (360) → `--⚙️weight-light-surface` (420) by
+ * surface lightness (`typography-configuration-properties.css:30-58`); that
+ * 360/420 ratio is ≈0.85, the "0.85 multiplier" family cited in
+ * design-science typography notes (CSS-Tricks anchor, irradiation
+ * illusion). Font weight and terminal apparent-lightness are
+ * different render channels for the same perceptual correction, so the
+ * multiplier doesn't transfer directly — `BOLD_AL_COMPENSATION` is the AL
+ * budget's own starting point (an ~4% AL pull, not a weight ratio), picked
+ * as a small fraction of the JND (0.074, `dark-theme.md`) so it visibly
+ * de-weights bold without crossing into a second contrast step. Tunable —
+ * see the `bold-compensation` storybook story for the eyeball-tuning rig.
+ */
+export const BOLD_AL_COMPENSATION = 0.04;
+function compensateBoldRgb(rgb, ground) {
+    const { l, c, h } = rgbToOklch(rgb.r, rgb.g, rgb.b);
+    const al = apparentLightness(l, c, h);
+    const sign = canvasPolarity(ground) === "dark" ? 1 : -1;
+    const newAl = al - sign * BOLD_AL_COMPENSATION;
+    const newL = solveLightness(newAl, c, h);
+    return hexToRgb(oklchToHex(newL, c, h));
+}
+/** Keep token H/C; land on the role's apparent lightness (body-weight syntax). */
+function recastToRoleAl(literal, roleRgb) {
+    const tok = rgbToOklch(literal.r, literal.g, literal.b);
+    const role = rgbToOklch(roleRgb.r, roleRgb.g, roleRgb.b);
+    const targetAl = apparentLightness(role.l, role.c, role.h);
+    const l = solveLightness(targetAl, tok.c, tok.h);
+    return hexToRgb(oklchToHex(l, tok.c, tok.h));
+}
+/**
+ * Max apparent-lightness elevation of a solid background above ground.
+ * Backgrounds obey the ELEVATION law, not the contrast law: a surface is the
+ * ground raised a small step toward the role's identity — never the role's
+ * text color faded. Deriving bg from the FG tier solve painted panels at
+ * text contrast (recede ≈ AL 0.55): huge mid-gray slabs on a dark terminal.
+ * Anchors (dark-theme design notes): Material
+ * elevation overlays run 5–15% lightness above base, each step clearing the
+ * ~7.4% brightness JND; the reference panel (xterm 235 over a #121212
+ * ground) sat ≈ +0.07 AL — reproduced here at BgP.panel (0.85 × 0.09).
+ * (Historical hex above is comment prose: color-parity-ignore.)
+ */
+const BG_ELEVATION_MAX = 0.09;
+/**
+ * Background chroma budget: fraction of the role's chroma kept at p=0, plus
+ * slope × p. 0.35 left even a mist Diff wash at ~45% of role C — a tinted
+ * slab, not atmosphere toward ground. 0.12 lets low-p washes dissolve;
+ * panel still picks up identity through the slope (0.12 + 0.35 × 0.85).
+ */
+const BG_CHROMA_BASE = 0.12;
+const BG_CHROMA_SLOPE = 0.35;
+/**
+ * Elevate ground toward a role's identity: target AL = ground ± elevation
+ * (away from ground on either polarity), hue kept, chroma cut to an
+ * atmospheric fraction. H-K-correct via solveLightness.
+ */
+function elevateBgRgb(roleRgb, ground, solidity) {
+    const p = clamp01(solidity);
+    const { c, h } = rgbToOklch(roleRgb.r, roleRgb.g, roleRgb.b);
+    const sign = canvasPolarity(ground) === "dark" ? 1 : -1;
+    const targetAl = ground + sign * BG_ELEVATION_MAX * p;
+    const bgC = c * (BG_CHROMA_BASE + BG_CHROMA_SLOPE * p);
+    const l = solveLightness(targetAl, bgC, h);
+    return hexToRgb(oklchToHex(l, bgC, h));
+}
+function emitFg(rgb, depth, role, effectiveP, ground, out) {
+    if (depth === "mono") {
+        // NO_COLOR (capabilities/src/types.ts:5-10): role/prominence solving
+        // still ran (tier math, bold H-K compensation happened upstream) but no
+        // fg color escape is emitted at all — not even an index. Attributes
+        // (bold/italic/strike/underline) are untouched by this function and
+        // pass through on `out` unconditionally; `dim` is still applied by the
+        // caller as the mono/ansi16-shared low-prominence degradation (step 5).
+        return;
+    }
+    if (depth === "ansi16") {
+        // Roles: hue-preserving slot table. Literals (syntax): nearest RGB.
+        out.fg = role ? ansi16Slot(role, canvasPolarity(ground), effectiveP) : nearestAnsi16FromRgb(rgb);
+        return;
+    }
+    if (depth === "ansi256") {
+        out.fg = nearestAnsi256FromRgb(rgb);
+        return;
+    }
+    out.fgRgb = rgb;
+}
+/** Emit bg at declared depth — never truecolor under ansi16/256, never any
+ * color field under mono (NO_COLOR: attributes only, see emitFg). */
+function emitBg(rgb, depth, out) {
+    if (depth === "mono") {
+        return;
+    }
+    if (depth === "truecolor") {
+        out.bgRgb = rgb;
+    }
+    else if (depth === "ansi16") {
+        out.bg = nearestAnsi16FromRgb(rgb);
+    }
+    else {
+        out.bg = nearestAnsi256FromRgb(rgb);
+    }
+}
+/**
+ * Resolve one style: role → concrete color at depth; apply region dim.
+ * Returns a new style with concrete fg/fgRgb (role kept for dual-dirty).
+ */
+export function resolveStyle(style, ctx) {
+    const depth = ctx.depth ?? "truecolor";
+    const regionP = clamp01(style.regionProminence ?? ctx.regionProminence ?? 1);
+    const ownP = clamp01(style.prominence ?? 1);
+    const effectiveP = ownP * regionP;
+    const out = {
+        bold: style.bold,
+        strike: style.strike,
+        italic: style.italic,
+        underline: style.underline,
+        href: style.href,
+        role: style.role,
+        prominence: style.prominence,
+        bgRole: style.bgRole,
+        bgProminence: style.bgProminence,
+        surfaceRole: style.surfaceRole,
+        surfaceProminence: style.surfaceProminence,
+        fuseRole: style.fuseRole,
+        fuseProminence: style.fuseProminence,
+        tintRole: style.tintRole,
+        tint: style.tint,
+        regionProminence: style.regionProminence,
+        selected: style.selected,
+        cast: style.cast,
+        // Procedural bg is present-loop concern — never resolve away
+        bgFx: style.bgFx,
+        bgFxU: style.bgFxU,
+        bgFxV: style.bgFxV,
+    };
+    const ground = ctx.theme.ground;
+    // ── Surface / BG first: opacity target for FG prominence ──────────────
+    // Local surface (panel under ShadowStream, cell bgRole, etc.) beats theme
+    // ground. Order: explicit surfaceRole → cell bgRole/bgRgb → theme ground.
+    let bgRgb;
+    let bgIndexPassthrough;
+    if (style.bgRole && ROLES.has(style.bgRole)) {
+        const bgRole = style.bgRole;
+        invariant(ctx.theme.colors[bgRole], `theme missing role: ${bgRole}`);
+        const bgOwnP = clamp01(style.bgProminence ?? 1);
+        bgRgb = elevateBgRgb(ctx.theme.rgb[bgRole], ground, bgOwnP * regionP);
+    }
+    else if (style.bgRgb) {
+        bgRgb = { ...style.bgRgb };
+        if (regionP < 1) {
+            bgRgb = regionDimRgb(bgRgb, ground, regionP);
+        }
+    }
+    else if (style.bg !== undefined) {
+        if (style.selected) {
+            bgRgb = style.bg <= 15 ? ansi16ToRgb(style.bg) : ansi256ToRgb(style.bg);
+        }
+        else {
+            bgIndexPassthrough = style.bg;
+        }
+    }
+    let fadeSurface;
+    if (style.fuseRole && ROLES.has(style.fuseRole)) {
+        // FG→FG fuse (progress rail into contour). Not BG elevation.
+        // Target is fuseProminence × region so the dissolve matches the
+        // already-dimmed contour; omitting region leaves the rail at full-room
+        // brightness behind a modal.
+        const fr = style.fuseRole;
+        invariant(ctx.theme.colors[fr], `theme missing role: ${fr}`);
+        const fp = clamp01(style.fuseProminence ?? FgP.ghost) * regionP;
+        const full = ctx.theme.rgb[fr];
+        fadeSurface = fp >= 1 ? { ...full } : regionDimRgb(full, ground, fp);
+    }
+    else if (style.surfaceRole && ROLES.has(style.surfaceRole)) {
+        const sr = style.surfaceRole;
+        invariant(ctx.theme.colors[sr], `theme missing role: ${sr}`);
+        const sp = clamp01(style.surfaceProminence ?? 1);
+        fadeSurface = elevateBgRgb(ctx.theme.rgb[sr], ground, sp * regionP);
+    }
+    else if (bgRgb) {
+        fadeSurface = bgRgb;
+    }
+    else if (style.surfaceRgb) {
+        fadeSurface = style.surfaceRgb;
+    }
+    else {
+        fadeSurface = ctx.theme.groundRgb;
+    }
+    function tintFg(rgb) {
+        const amount = typeof style.tint === "number" && Number.isFinite(style.tint) ? clamp01(style.tint) : 0;
+        if (!(amount > 0) || !style.tintRole || !ROLES.has(style.tintRole))
+            return rgb;
+        const hot = ctx.theme.rgb[style.tintRole];
+        return hot ? mixTowardTintRgb(rgb, hot, amount) : rgb;
+    }
+    /** Prominence fade: toward local surface when known, else theme ground L. */
+    function fadeFg(rgb, p) {
+        if (p >= 1)
+            return rgb;
+        if (fadeSurface) {
+            return fadeTowardSurfaceRgb(rgb, fadeSurface, p, {
+                // Quadratic de-chroma on FG→FG fuse so the hot hue doesn't
+                // plateau then drop as a last step (region γ is sublinear).
+                chromaExp: style.fuseRole ? 2 : undefined,
+            });
+        }
+        return regionDimRgb(rgb, ground, p);
+    }
+    // fgRgb + role: token hue/chroma, role apparent-lightness (syntax).
+    // fgRgb alone: claimed color. Role alone: semantic chrome.
+    let fgRgb;
+    let fgRole;
+    let fgIsRole = false;
+    if (style.fgRgb) {
+        fgRgb = { ...style.fgRgb };
+        const withRole = style.role && ROLES.has(style.role);
+        if (withRole) {
+            const role = style.role;
+            const roleRgb = ctx.theme.rgb[role];
+            invariant(roleRgb, `theme missing role: ${role}`);
+            fgRgb = recastToRoleAl(fgRgb, roleRgb);
+            // Nearest-RGB at ansi16 — a role slot would collapse every token.
+        }
+        fgRgb = tintFg(fgRgb);
+        if (effectiveP < 1) {
+            fgRgb = fadeFg(fgRgb, effectiveP);
+        }
+        if (withRole && style.bold) {
+            fgRgb = compensateBoldRgb(fgRgb, ground);
+        }
+        out.dim = withRole && (depth === "ansi16" || depth === "mono") && effectiveP <= DIM_THRESHOLD ? true : style.dim;
+    }
+    else if (style.role && ROLES.has(style.role)) {
+        const role = style.role;
+        const fullHex = ctx.theme.colors[role];
+        invariant(fullHex, `theme missing role: ${role}`);
+        fgRole = role;
+        fgIsRole = true;
+        fgRgb = tintFg(ctx.theme.rgb[role]);
+        if (effectiveP < 1) {
+            fgRgb = fadeFg(fgRgb, effectiveP);
+        }
+        // FG only — never touch bgRole/bgRgb (elevation law owns surfaces).
+        if (style.bold) {
+            fgRgb = compensateBoldRgb(fgRgb, ground);
+        }
+        // dim is banned as an authoring channel for roles (enabler 6).
+        if ((depth === "ansi16" || depth === "mono") && effectiveP <= DIM_THRESHOLD) {
+            out.dim = true;
+        }
+    }
+    else if (style.fg === undefined) {
+        out.dim = style.dim;
+    }
+    else {
+        if (style.selected) {
+            fgRgb = style.fg <= 15 ? ansi16ToRgb(style.fg) : ansi256ToRgb(style.fg);
+        }
+        else {
+            out.fg = style.fg;
+        }
+        out.dim = style.dim;
+    }
+    if (style.selected && fgRgb) {
+        fgRgb = selectionRecolorRgb(fgRgb, ground);
+    }
+    if (fgRgb) {
+        const emitRole = style.selected && fgIsRole ? undefined : fgRole;
+        emitFg(fgRgb, depth, emitRole, effectiveP, ground, out);
+    }
+    // BG emit (already resolved above for fade target).
+    if (style.selected) {
+        bgRgb = bgRgb ? selectionRecolorBgRgb(bgRgb, ground) : selectionFillRgb(ground);
+    }
+    if (bgRgb) {
+        emitBg(bgRgb, depth, out);
+    }
+    else if (bgIndexPassthrough !== undefined) {
+        out.bg = bgIndexPassthrough;
+    }
+    return out;
+}
+/** Bind a resolveStyle callback for paintFrame / dual-dirty. */
+export function makeStyleResolver(ctx) {
+    return (style) => resolveStyle(style, ctx);
+}
+//# sourceMappingURL=resolver.js.map

package/dist/theme/resolver.js.map

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

package/dist/theme/salience.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 type { Oklch, Polarity, Rgb, Tier } from "../lexicon/index.js";
+/** H-K chroma scale (≈ Fairchild–Pirrotta k; magnitude is Delta's budget). */
+export declare 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 declare const TIER_DELTAS: {
+    readonly alarm: 0.33;
+    readonly recede: 0.35;
+    readonly differentiate: 0.42;
+    readonly baseline: 0.57;
+    readonly anchor: 0.65;
+};
+/** Reference near-black ground the tier deltas were derived against. */
+export declare const REFERENCE_GROUND = 0.2;
+export declare function hueFactor(h: number): number;
+/** Amount of L to subtract so a chromatic color sits level with gray at same L. */
+export declare function hkCompensation(c: number, h: number): number;
+/**
+ * Perceived / apparent lightness (chromatic looks *brighter* than measured L).
+ * Inverse of solveLightness for fixed (C,h).
+ */
+export declare function apparentLightness(l: number, c: number, h: number): number;
+/**
+ * Nominal OKLCH L that lands (C, h) on a target apparent lightness.
+ * Chromatic → lower measured L (same as bake-darcula / Delta CSS subtract).
+ */
+export declare function solveLightness(targetAl: number, c: number, h: number): number;
+/**
+ * Target apparent lightness for a tier against ground, with headroom
+ * compression when the ground leaves less than the full delta range.
+ */
+export declare function tierTarget(tier: Tier, ground: number, polarity?: Polarity): number;
+export type SolveOpts = {
+    ground?: number;
+    polarity?: Polarity;
+};
+/**
+ * Solve (C, h) on a salience tier against ground → sRGB hex.
+ */
+export declare function solve(tier: Tier, c: number, h: number, opts?: SolveOpts): string;
+export type Seed = {
+    name: string;
+    h: number;
+    c: number;
+    tier: Tier;
+};
+/** Solve a seed list into `{ name → hex }`. */
+export declare function solvePalette(seeds: readonly Seed[], opts?: SolveOpts): Record<string, string>;
+/**
+ * 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 declare function inSrgb(l: number, c: number, h: number): boolean;
+/**
+ * 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 declare function fitOklchToSrgb(l: number, c: number, h: number): {
+    l: number;
+    c: number;
+    h: number;
+};
+export declare function oklchToHex(l: number, c: number, h: number): string;
+export declare function hexToOklch(hex: string): Oklch;
+export declare function hexToRgb(hex: string): Rgb;
+/** sRGB → OKLCH L from 0–255 channel triple (OSC 11 ground path). */
+export declare function rgbToOklch(r: number, g: number, b: number): Oklch;
+//# sourceMappingURL=salience.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"salience.d.ts","sourceRoot":"","sources":["../../src/theme/salience.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAKtE,8EAA8E;AAC9E,eAAO,MAAM,IAAI,OAAO,CAAC;AAEzB;;;;;GAKG;AACH,eAAO,MAAM,WAAW;;;;;;CAMiB,CAAC;AAE1C,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAiBpC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3C;AAED,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE7E;AAQD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAiB,GAAG,MAAM,CAK1F;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,SAAc,GAAG,MAAM,CAMpF;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;CACZ,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,GAAE,SAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjG;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAU/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAuBnG;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAYlE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAW7C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAUzC;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAUjE"}