@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/theme/ansi16.js

@@ -0,0 +1,181 @@
+/**
+ * Polarity-preserving ANSI16 degradation for semantic roles.
+ *
+ * Nearest-RGB quantization collapses hue (error→yellow, etc.). This table
+ * pins each role to a hue-preserving slot so category is never lost.
+ * Legibility > category preservation > tier separation.
+ *
+ * Literal RGB (syntax highlight, no role) degrades via nearest-RGB on the
+ * classic 0–15 xterm palette — hue-preserving slots stay role-only.
+ */
+import invariant from "tiny-invariant";
+import { REFERENCE_GROUND } from "./salience.js";
+/**
+ * Named ANSI slot → theme role whose hue/chroma we keep. Bright and dim
+ * share a role; SGR 1 is weight. Inverse of {@link ansi16Slot} (role → slot).
+ * Black/white land on furniture/voice, not a claimed gray RGB.
+ */
+export const ANSI16_ROLE = [
+    "muted",
+    "error",
+    "success",
+    "warning",
+    "code",
+    "running",
+    "auto",
+    "foreground",
+    "muted",
+    "error",
+    "success",
+    "emphasis",
+    "code",
+    "running",
+    "accent",
+    "foreground",
+];
+/** Prominence ≥ this → loud tier; below → soft. */
+export const LOUD_THRESHOLD = 0.8;
+/** Classic + bright xterm defaults for indices 0–15 (same as ansi256 decode). */
+const ANSI16_RGB = [
+    { r: 0, g: 0, b: 0 },
+    { r: 205, g: 0, b: 0 },
+    { r: 0, g: 205, b: 0 },
+    { r: 205, g: 205, b: 0 },
+    { r: 0, g: 0, b: 238 },
+    { r: 205, g: 0, b: 205 },
+    { r: 0, g: 205, b: 205 },
+    { r: 229, g: 229, b: 229 },
+    { r: 127, g: 127, b: 127 },
+    { r: 255, g: 0, b: 0 },
+    { r: 0, g: 255, b: 0 },
+    { r: 255, g: 255, b: 0 },
+    { r: 92, g: 92, b: 255 },
+    { r: 255, g: 0, b: 255 },
+    { r: 0, g: 255, b: 255 },
+    { r: 255, g: 255, b: 255 },
+];
+/** Nearest ANSI16 index for an sRGB triple (0–255). Euclidean in sRGB. */
+export function nearestAnsi16(r, g, b) {
+    let best = 0;
+    let bestD = Infinity;
+    for (let i = 0; i < 16; i++) {
+        const p = ANSI16_RGB[i];
+        const dr = r - p.r;
+        const dg = g - p.g;
+        const db = b - p.b;
+        const d = dr * dr + dg * dg + db * db;
+        if (d < bestD) {
+            bestD = d;
+            best = i;
+            if (d === 0)
+                return best;
+        }
+    }
+    return best;
+}
+export function nearestAnsi16FromRgb(rgb) {
+    return nearestAnsi16(rgb.r, rgb.g, rgb.b);
+}
+/** Decode ANSI16 index to approximate RGB (xterm defaults). */
+export function ansi16ToRgb(index) {
+    invariant(index >= 0, `ansi16 index cannot be negative: ${index}`);
+    invariant(index <= 15, `ansi16 index cannot overflow: ${index}`);
+    return { ...ANSI16_RGB[index] };
+}
+const SLOT_TABLE = {
+    dark: {
+        loud: {
+            error: 9,
+            diff_del: 9,
+            success: 10,
+            diff_add: 10,
+            warning: 11,
+            accent: 14,
+            running: 13,
+            auto: 14,
+            attention: 11,
+            emphasis: 15,
+            code: 12,
+            foreground: 7,
+            chrome: 7,
+            surface: 8,
+            muted: 8,
+            border: 8,
+        },
+        soft: {
+            error: 1,
+            diff_del: 1,
+            success: 2,
+            diff_add: 2,
+            warning: 3,
+            accent: 6,
+            running: 5,
+            auto: 6,
+            attention: 3,
+            emphasis: 7,
+            code: 4,
+            foreground: 8,
+            chrome: 8,
+            surface: 8,
+            muted: 8,
+            border: 8,
+        },
+    },
+    light: {
+        loud: {
+            error: 1,
+            diff_del: 1,
+            success: 2,
+            diff_add: 2,
+            warning: 3,
+            accent: 4,
+            running: 5,
+            auto: 6,
+            attention: 3,
+            emphasis: 0,
+            code: 4,
+            foreground: 8,
+            chrome: 8,
+            surface: 7,
+            muted: 7,
+            border: 7,
+        },
+        soft: {
+            error: 9,
+            diff_del: 9,
+            success: 2,
+            diff_add: 2,
+            warning: 3,
+            accent: 12,
+            running: 5,
+            auto: 6,
+            attention: 3,
+            emphasis: 8,
+            code: 12,
+            foreground: 8,
+            chrome: 8,
+            surface: 7,
+            muted: 7,
+            border: 7,
+        },
+    },
+};
+/**
+ * Canvas polarity from ground OKLCH L.
+ * `null` / undefined → reference ground polarity (dark).
+ */
+export function canvasPolarity(groundLightness) {
+    const g = groundLightness ?? REFERENCE_GROUND;
+    return g < 0.5 ? "dark" : "light";
+}
+function tierOf(prominence) {
+    return prominence >= LOUD_THRESHOLD ? "loud" : "soft";
+}
+/** Resolve role → ANSI16 slot for polarity + prominence. */
+export function ansi16Slot(role, polarity, prominence = 1) {
+    const tier = tierOf(prominence);
+    const slot = SLOT_TABLE[polarity][tier][role];
+    invariant(slot !== undefined, `unknown ANSI16 role: ${role}`);
+    return slot;
+}
+//# sourceMappingURL=ansi16.js.map

package/dist/theme/ansi16.js.map

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

package/dist/theme/ansi256.d.ts

@@ -0,0 +1,15 @@
+/**
+ * xterm 256-color nearest match for non-truecolor terminals.
+ *
+ * Palette: 0–15 system (skipped for matching — cube+gray only for
+ * semantic colors; 16–231 6³ cube; 232–255 grayscale). Matching in
+ * sRGB Euclidean distance is good enough for TUI chrome; OKLCH match
+ * would be nicer but cube steps dominate error either way.
+ */
+import type { Rgb } from "../lexicon/index.js";
+/** Nearest xterm-256 index for an sRGB triple (0–255). */
+export declare function nearestAnsi256(r: number, g: number, b: number): number;
+export declare function nearestAnsi256FromRgb(rgb: Rgb): number;
+/** Decode a 256-index back to approximate RGB (for tests / dimming). */
+export declare function ansi256ToRgb(index: number): Rgb;
+//# sourceMappingURL=ansi256.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ansi256.d.ts","sourceRoot":"","sources":["../../src/theme/ansi256.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AA8B/C,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAetE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAEtD;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAmC/C"}

package/dist/theme/ansi256.js

@@ -0,0 +1,94 @@
+/**
+ * xterm 256-color nearest match for non-truecolor terminals.
+ *
+ * Palette: 0–15 system (skipped for matching — cube+gray only for
+ * semantic colors; 16–231 6³ cube; 232–255 grayscale). Matching in
+ * sRGB Euclidean distance is good enough for TUI chrome; OKLCH match
+ * would be nicer but cube steps dominate error either way.
+ */
+import invariant from "tiny-invariant";
+/** Build the 240 matchable entries (cube + gray). System 0–15 omitted. */
+function buildPalette() {
+    const out = [];
+    // 6×6×6 cube: levels 0,95,135,175,215,255
+    const levels = [0, 95, 135, 175, 215, 255];
+    for (let ri = 0; ri < 6; ri++) {
+        for (let gi = 0; gi < 6; gi++) {
+            for (let bi = 0; bi < 6; bi++) {
+                const index = 16 + 36 * ri + 6 * gi + bi;
+                out.push({
+                    index,
+                    r: levels[ri],
+                    g: levels[gi],
+                    b: levels[bi],
+                });
+            }
+        }
+    }
+    // grayscale ramp 232–255
+    for (let i = 0; i < 24; i++) {
+        const v = 8 + i * 10;
+        out.push({ index: 232 + i, r: v, g: v, b: v });
+    }
+    return out;
+}
+const PALETTE = buildPalette();
+/** Nearest xterm-256 index for an sRGB triple (0–255). */
+export function nearestAnsi256(r, g, b) {
+    let best = 16;
+    let bestD = Infinity;
+    for (const p of PALETTE) {
+        const dr = r - p.r;
+        const dg = g - p.g;
+        const db = b - p.b;
+        const d = dr * dr + dg * dg + db * db;
+        if (d < bestD) {
+            bestD = d;
+            best = p.index;
+            if (d === 0)
+                return best;
+        }
+    }
+    return best;
+}
+export function nearestAnsi256FromRgb(rgb) {
+    return nearestAnsi256(rgb.r, rgb.g, rgb.b);
+}
+/** Decode a 256-index back to approximate RGB (for tests / dimming). */
+export function ansi256ToRgb(index) {
+    invariant(index >= 0, `ansi256 index cannot be negative: ${index}`);
+    invariant(index <= 255, `ansi256 index cannot overflow: ${index}`);
+    if (index < 16) {
+        // classic + bright — xterm defaults
+        const basic = [
+            { r: 0, g: 0, b: 0 },
+            { r: 205, g: 0, b: 0 },
+            { r: 0, g: 205, b: 0 },
+            { r: 205, g: 205, b: 0 },
+            { r: 0, g: 0, b: 238 },
+            { r: 205, g: 0, b: 205 },
+            { r: 0, g: 205, b: 205 },
+            { r: 229, g: 229, b: 229 },
+            { r: 127, g: 127, b: 127 },
+            { r: 255, g: 0, b: 0 },
+            { r: 0, g: 255, b: 0 },
+            { r: 255, g: 255, b: 0 },
+            { r: 92, g: 92, b: 255 },
+            { r: 255, g: 0, b: 255 },
+            { r: 0, g: 255, b: 255 },
+            { r: 255, g: 255, b: 255 },
+        ];
+        return basic[index];
+    }
+    if (index < 232) {
+        const n = index - 16;
+        const levels = [0, 95, 135, 175, 215, 255];
+        const ri = Math.floor(n / 36);
+        const gi = Math.floor((n % 36) / 6);
+        const bi = n % 6;
+        return { r: levels[ri], g: levels[gi], b: levels[bi] };
+    }
+    const v = 8 + (index - 232) * 10;
+    return { r: v, g: v, b: v };
+}
+//# sourceMappingURL=ansi256.js.map

package/dist/theme/ansi256.js.map

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

package/dist/theme/ground.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Terminal ground attunement (theme math).
+ *
+ * OSC 11 parse lives in ../capabilities/index.js; OKLCH L conversion here.
+ */
+/** OKLCH L from OSC 11 / any sRGB background (0–255 channels). */
+export declare function groundFromRgb(r: number, g: number, b: number): number;
+//# sourceMappingURL=ground.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ground.d.ts","sourceRoot":"","sources":["../../src/theme/ground.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/theme/ground.js

@@ -0,0 +1,11 @@
+/**
+ * Terminal ground attunement (theme math).
+ *
+ * OSC 11 parse lives in ../capabilities/index.js; OKLCH L conversion here.
+ */
+import { rgbToOklch } from "./salience.js";
+/** OKLCH L from OSC 11 / any sRGB background (0–255 channels). */
+export function groundFromRgb(r, g, b) {
+    return rgbToOklch(r, g, b).l;
+}
+//# sourceMappingURL=ground.js.map

package/dist/theme/ground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ground.js","sourceRoot":"","sources":["../../src/theme/ground.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,kEAAkE;AAClE,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAC3D,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/theme/index.d.ts

@@ -0,0 +1,10 @@
+export * from "./salience.js";
+export * from "./seeds.js";
+export * from "./ansi16.js";
+export * from "./theme.js";
+export * from "./ansi256.js";
+export * from "./region.js";
+export * from "./selection.js";
+export * from "./resolver.js";
+export * from "./ground.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/theme/index.js

@@ -0,0 +1,10 @@
+export * from "./salience.js";
+export * from "./seeds.js";
+export * from "./ansi16.js";
+export * from "./theme.js";
+export * from "./ansi256.js";
+export * from "./region.js";
+export * from "./selection.js";
+export * from "./resolver.js";
+export * from "./ground.js";
+//# sourceMappingURL=index.js.map

package/dist/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/theme/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/theme/region.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Region prominence dimming — fade colors toward terminal ground.
+ *
+ * When a region is de-emphasized (modal backdrop, unfocused pane), both
+ * fg and bg fade: apparent lightness toward ground, chroma by p^γ.
+ * γ = ln(0.65)/ln(0.45): at overlay keep 0.45, chroma is 0.65 of source
+ * (0.45^γ = 0.65).
+ *
+ * p == 1.0 is identity (no work). Transparent bg (absent) never dims.
+ */
+import { type Rgb } from "../lexicon/index.js";
+/** Closed-form chroma exponent: ln(0.65)/ln(0.45). */
+export declare const REGION_GAMMA: number;
+/**
+ * Fade a hex color toward ground OKLCH L at prominence p.
+ * Returns new hex. At p=1 returns input unchanged (byte-identity path).
+ */
+export declare function regionDimHex(hex: string, groundL: number, prominence: number): string;
+export declare function regionDimRgb(rgb: Rgb, groundL: number, prominence: number): Rgb;
+/**
+ * Opacity substitute over an arbitrary **local surface** (panel, wash, cell
+ * bg) — not only the terminal theme ground.
+ *
+ * At `p = 1` the fg is identity; at `p = 0` the result is the surface color
+ * (true "into opacity" against that backdrop). Intermediate: apparent
+ * lightness and chroma lerp toward the surface (chroma with REGION_GAMMA);
+ * hue stays the fg's until fully dissolved so identity reads while fading.
+ *
+ * Use this whenever text sits on painted furniture. {@link regionDimRgb}
+ * toward theme ground is wrong there — it dissolves into a different
+ * color than the cell behind the glyph.
+ */
+export declare function fadeTowardSurfaceRgb(fg: Rgb, surface: Rgb, prominence: number, opts?: {
+    chromaExp?: number;
+}): Rgb;
+/**
+ * Mix a fill toward a hotter role. Hue takes the tint's identity immediately
+ * so chroma growth reads as one glow, not a hue sweep through red. Chroma
+ * and apparent lightness lerp with `t`.
+ */
+export declare function mixTowardTintRgb(base: Rgb, tint: Rgb, t: number): Rgb;
+//# sourceMappingURL=region.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"region.d.ts","sourceRoot":"","sources":["../../src/theme/region.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C,sDAAsD;AACtD,eAAO,MAAM,YAAY,QAAkC,CAAC;AAiB5D;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAYrF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,GAAG,CAI/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAmBlH;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAarE"}

package/dist/theme/region.js

@@ -0,0 +1,105 @@
+/**
+ * Region prominence dimming — fade colors toward terminal ground.
+ *
+ * When a region is de-emphasized (modal backdrop, unfocused pane), both
+ * fg and bg fade: apparent lightness toward ground, chroma by p^γ.
+ * γ = ln(0.65)/ln(0.45): at overlay keep 0.45, chroma is 0.65 of source
+ * (0.45^γ = 0.65).
+ *
+ * p == 1.0 is identity (no work). Transparent bg (absent) never dims.
+ */
+import { apparentLightness, hexToOklch, hexToRgb, oklchToHex, rgbToOklch, solveLightness } from "./salience.js";
+/** Closed-form chroma exponent: ln(0.65)/ln(0.45). */
+export const REGION_GAMMA = Math.log(0.65) / Math.log(0.45);
+function clamp01(p) {
+    if (!Number.isFinite(p))
+        return 1;
+    return Math.min(1, Math.max(0, p));
+}
+function rgbToHex(rgb) {
+    return `#${[rgb.r, rgb.g, rgb.b]
+        .map((x) => Math.max(0, Math.min(255, Math.round(x)))
+        .toString(16)
+        .padStart(2, "0"))
+        .join("")}`;
+}
+/**
+ * Fade a hex color toward ground OKLCH L at prominence p.
+ * Returns new hex. At p=1 returns input unchanged (byte-identity path).
+ */
+export function regionDimHex(hex, groundL, prominence) {
+    const p = clamp01(prominence);
+    if (p >= 1)
+        return hex;
+    if (p <= 0) {
+        return oklchToHex(groundL, 0, 0);
+    }
+    const { l, c, h } = hexToOklch(hex);
+    const al = apparentLightness(l, c, h);
+    const fadedAl = groundL + (al - groundL) * p;
+    const fadedC = c * p ** REGION_GAMMA;
+    const fadedL = solveLightness(fadedAl, fadedC, h);
+    return oklchToHex(fadedL, fadedC, h);
+}
+export function regionDimRgb(rgb, groundL, prominence) {
+    const p = clamp01(prominence);
+    if (p >= 1)
+        return rgb;
+    return hexToRgb(regionDimHex(rgbToHex(rgb), groundL, p));
+}
+/**
+ * Opacity substitute over an arbitrary **local surface** (panel, wash, cell
+ * bg) — not only the terminal theme ground.
+ *
+ * At `p = 1` the fg is identity; at `p = 0` the result is the surface color
+ * (true "into opacity" against that backdrop). Intermediate: apparent
+ * lightness and chroma lerp toward the surface (chroma with REGION_GAMMA);
+ * hue stays the fg's until fully dissolved so identity reads while fading.
+ *
+ * Use this whenever text sits on painted furniture. {@link regionDimRgb}
+ * toward theme ground is wrong there — it dissolves into a different
+ * color than the cell behind the glyph.
+ */
+export function fadeTowardSurfaceRgb(fg, surface, prominence, opts) {
+    const p = clamp01(prominence);
+    if (p >= 1)
+        return { ...fg };
+    if (p <= 0)
+        return { ...surface };
+    const f = rgbToOklch(fg.r, fg.g, fg.b);
+    const s = rgbToOklch(surface.r, surface.g, surface.b);
+    const fgAl = apparentLightness(f.l, f.c, f.h);
+    const sAl = apparentLightness(s.l, s.c, s.h);
+    const fadedAl = sAl + (fgAl - sAl) * p;
+    // Default: region-dim γ (sublinear — chroma lingers). Fuse-into-contour
+    // passes 2 so chroma dies faster than lightness (no late orange step).
+    const exp = opts?.chromaExp ?? REGION_GAMMA;
+    const tC = p ** exp;
+    const fadedC = s.c + (f.c - s.c) * tC;
+    // Hue: keep fg identity while any of the ink remains.
+    const fadedH = f.h;
+    const fadedL = solveLightness(fadedAl, fadedC, fadedH);
+    return hexToRgb(oklchToHex(fadedL, fadedC, fadedH));
+}
+/**
+ * Mix a fill toward a hotter role. Hue takes the tint's identity immediately
+ * so chroma growth reads as one glow, not a hue sweep through red. Chroma
+ * and apparent lightness lerp with `t`.
+ */
+export function mixTowardTintRgb(base, tint, t) {
+    const p = typeof t === "number" && Number.isFinite(t) ? Math.max(0, Math.min(1, t)) : 0;
+    if (p <= 0)
+        return { ...base };
+    if (p >= 1)
+        return { ...tint };
+    const b = rgbToOklch(base.r, base.g, base.b);
+    const hot = rgbToOklch(tint.r, tint.g, tint.b);
+    const bAl = apparentLightness(b.l, b.c, b.h);
+    const hotAl = apparentLightness(hot.l, hot.c, hot.h);
+    const fadedAl = bAl + (hotAl - bAl) * p;
+    const fadedC = b.c + (hot.c - b.c) * p;
+    const fadedH = hot.h;
+    const fadedL = solveLightness(fadedAl, fadedC, fadedH);
+    return hexToRgb(oklchToHex(fadedL, fadedC, fadedH));
+}
+//# sourceMappingURL=region.js.map

package/dist/theme/region.js.map

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

package/dist/theme/resolver.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 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 type { Theme } from "./theme.js";
+import type { ColorDepth } from "../capabilities/index.js";
+import { type Rgb } from "../lexicon/index.js";
+/** Buffer-compatible style fragment (mirrors ../buffer/index.js Style). */
+export type StyleLike = {
+    bold?: boolean;
+    dim?: boolean;
+    strike?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    href?: string;
+    fg?: number;
+    fgRgb?: Rgb;
+    bg?: number;
+    bgRgb?: Rgb;
+    bgFx?: string;
+    bgFxU?: number;
+    bgFxV?: number;
+    role?: string;
+    prominence?: number;
+    bgRole?: string;
+    bgProminence?: number;
+    surfaceRole?: string;
+    surfaceRgb?: Rgb;
+    surfaceProminence?: number;
+    fuseRole?: string;
+    fuseProminence?: number;
+    tintRole?: string;
+    tint?: number;
+    regionProminence?: number;
+    selected?: boolean;
+    cast?: "transparent";
+};
+export type ResolveCtx = {
+    theme: Theme;
+    depth?: ColorDepth;
+    /** Default region prominence when style has none (1.0 = full). */
+    regionProminence?: number;
+};
+/**
+ * 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 declare const BOLD_AL_COMPENSATION = 0.04;
+/**
+ * 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 declare function resolveStyle(style: StyleLike, ctx: ResolveCtx): StyleLike;
+/** Bind a resolveStyle callback for paintFrame / dual-dirty. */
+export declare function makeStyleResolver(ctx: ResolveCtx): (style: StyleLike) => StyleLike;
+//# sourceMappingURL=resolver.d.ts.map