@juliusbrussee/caveman-tui 0.65.2

package/dist/terminal-detect.js

@@ -0,0 +1,315 @@
+/**
+ * Terminal identity and background detection.
+ *
+ * Covers cavekit-terminal-blend R1 (background luminance detection via OSC 11,
+ * COLORFGBG, and CAVE_TERM_BG override) and R2 (terminal program identity).
+ */
+function _getEnv(name) {
+    const v = process.env[name];
+    return v === undefined || v === "" ? undefined : v;
+}
+function classifyProgram(env) {
+    const termProgram = env.TERM_PROGRAM?.toLowerCase();
+    const termProgramVersion = env.TERM_PROGRAM_VERSION;
+    if (env.GHOSTTY_RESOURCES_DIR || termProgram === "ghostty") {
+        return { program: "ghostty", version: termProgramVersion };
+    }
+    if (env.KITTY_WINDOW_ID || env.TERM?.toLowerCase().includes("kitty")) {
+        return { program: "kitty", version: termProgramVersion };
+    }
+    if (env.WEZTERM_EXECUTABLE || termProgram === "wezterm") {
+        return { program: "wezterm", version: termProgramVersion };
+    }
+    if (env.ALACRITTY_LOG || termProgram === "alacritty") {
+        return { program: "alacritty", version: termProgramVersion };
+    }
+    if (termProgram === "iterm.app" || env.ITERM_SESSION_ID) {
+        return { program: "iterm2", version: termProgramVersion };
+    }
+    if (termProgram === "apple_terminal") {
+        return { program: "apple-terminal", version: termProgramVersion };
+    }
+    if (env.VTE_VERSION) {
+        return { program: "vte", version: env.VTE_VERSION };
+    }
+    if (env.WT_SESSION) {
+        return { program: "windows-terminal" };
+    }
+    if (env.VSCODE_INJECTION || termProgram === "vscode") {
+        return { program: "vscode", version: termProgramVersion };
+    }
+    if (env.CMUX_SESSION || env.CMUX || termProgram === "cmux") {
+        return { program: "cmux", version: termProgramVersion };
+    }
+    if (env.TERM === "linux") {
+        return { program: "linux-console" };
+    }
+    return { program: "unknown" };
+}
+export function detectTerminalIdentity(env = process.env) {
+    const tmux = Boolean(env.TMUX);
+    const screen = Boolean(env.STY);
+    const multiplexer = tmux ? "tmux" : screen ? "screen" : "none";
+    const host = classifyProgram(env);
+    let program = host.program;
+    let hostProgram;
+    if (tmux) {
+        hostProgram = host.program !== "unknown" ? host.program : undefined;
+        program = "tmux";
+    }
+    else if (screen) {
+        hostProgram = host.program !== "unknown" ? host.program : undefined;
+        program = "screen";
+    }
+    return {
+        program,
+        hostProgram,
+        version: host.version,
+        multiplexer,
+        isSsh: Boolean(env.SSH_TTY || env.SSH_CONNECTION),
+        raw: {
+            TERM_PROGRAM: env.TERM_PROGRAM,
+            TERM_PROGRAM_VERSION: env.TERM_PROGRAM_VERSION,
+            TERM: env.TERM,
+            COLORTERM: env.COLORTERM,
+            COLORFGBG: env.COLORFGBG,
+            TMUX: env.TMUX,
+            STY: env.STY,
+            SSH_TTY: env.SSH_TTY,
+            GHOSTTY_RESOURCES_DIR: env.GHOSTTY_RESOURCES_DIR,
+            KITTY_WINDOW_ID: env.KITTY_WINDOW_ID,
+            WEZTERM_EXECUTABLE: env.WEZTERM_EXECUTABLE,
+            ITERM_SESSION_ID: env.ITERM_SESSION_ID,
+            VTE_VERSION: env.VTE_VERSION,
+            WT_SESSION: env.WT_SESSION,
+        },
+    };
+}
+/** WCAG 2.x relative luminance from sRGB 0-255 components. */
+export function relativeLuminance(r, g, b) {
+    const toLinear = (c) => {
+        const s = c / 255;
+        return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+    };
+    return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
+}
+function classifyLuminance(lum) {
+    return lum >= 0.5 ? "light" : "dark";
+}
+function parseOsc11Response(data) {
+    // Match: ESC ]11;rgb:RRRR/GGGG/BBBB (BEL | ESC \)
+    // Components may be 1-4 hex digits (commonly 4).
+    const match = data.match(/\x1b\]11;rgb:([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})(?:\x07|\x1b\\)/);
+    if (!match)
+        return null;
+    const normalize = (hex) => {
+        const v = parseInt(hex, 16);
+        const max = (1 << (hex.length * 4)) - 1;
+        return Math.round((v / max) * 255);
+    };
+    return { r: normalize(match[1]), g: normalize(match[2]), b: normalize(match[3]) };
+}
+function parseColorFgBg(raw) {
+    if (!raw)
+        return null;
+    const parts = raw.split(";");
+    const bg = parts[parts.length - 1];
+    const n = parseInt(bg, 10);
+    if (!Number.isFinite(n))
+        return null;
+    // 0-6 and 8 = dark variants; 7 and 9-15 = light variants (per xterm convention).
+    if (n >= 0 && n <= 6)
+        return "dark";
+    if (n === 8)
+        return "dark";
+    if (n === 7)
+        return "light";
+    if (n >= 9 && n <= 15)
+        return "light";
+    return null;
+}
+function parseOverride(raw) {
+    if (!raw)
+        return null;
+    const v = raw.trim().toLowerCase();
+    if (v === "dark") {
+        return { r: 0, g: 0, b: 0, luminance: 0, classification: "dark", source: "override" };
+    }
+    if (v === "light") {
+        return { r: 255, g: 255, b: 255, luminance: 1, classification: "light", source: "override" };
+    }
+    // Accept #rrggbb
+    const hex = v.startsWith("#") ? v.slice(1) : v;
+    if (/^[0-9a-f]{6}$/.test(hex)) {
+        const r = parseInt(hex.slice(0, 2), 16);
+        const g = parseInt(hex.slice(2, 4), 16);
+        const b = parseInt(hex.slice(4, 6), 16);
+        const lum = relativeLuminance(r, g, b);
+        return { r, g, b, luminance: lum, classification: classifyLuminance(lum), source: "override" };
+    }
+    return null;
+}
+/**
+ * Query the terminal's background color. Tries CAVE_TERM_BG override, then OSC 11,
+ * then COLORFGBG. Returns null when no signal is available. Total wall time capped
+ * by timeoutMs (default 200ms for the OSC 11 part; env lookups are instant).
+ */
+export async function queryTerminalBackground(terminal, timeoutMs = 200, env = process.env) {
+    // 1. CAVE_TERM_BG override wins unconditionally.
+    const override = parseOverride(env.CAVE_TERM_BG);
+    if (override)
+        return override;
+    // 2. OSC 11 query (when we have a terminal and it's a TTY)
+    if (terminal && typeof terminal.queryOsc === "function") {
+        try {
+            const response = await terminal.queryOsc("\x1b]11;?\x07", "\x1b]11;", Math.min(timeoutMs, 150));
+            if (response) {
+                const rgb = parseOsc11Response(response);
+                if (rgb) {
+                    const lum = relativeLuminance(rgb.r, rgb.g, rgb.b);
+                    return {
+                        r: rgb.r,
+                        g: rgb.g,
+                        b: rgb.b,
+                        luminance: lum,
+                        classification: classifyLuminance(lum),
+                        source: "osc11",
+                    };
+                }
+            }
+        }
+        catch {
+            // Fall through to COLORFGBG.
+        }
+    }
+    // 3. COLORFGBG parse
+    const fgbg = parseColorFgBg(env.COLORFGBG);
+    if (fgbg) {
+        return {
+            r: fgbg === "dark" ? 0 : 255,
+            g: fgbg === "dark" ? 0 : 255,
+            b: fgbg === "dark" ? 0 : 255,
+            luminance: fgbg === "dark" ? 0 : 1,
+            classification: fgbg,
+            source: "colorfgbg",
+        };
+    }
+    return null;
+}
+/**
+ * Standalone OSC 11 query that works before the TUI has started.
+ *
+ * Briefly installs its own stdin listener in raw mode, writes the OSC 11
+ * query, waits up to `timeoutMs` for the response, then restores stdin.
+ * Returns null on timeout / non-TTY / parse failure.
+ *
+ * Use this during startup when we need the background classification before
+ * theme init but haven't yet constructed a ProcessTerminal.
+ */
+export function queryOsc11Standalone(timeoutMs = 150) {
+    return new Promise((resolve) => {
+        if (!process.stdout.isTTY || !process.stdin.isTTY) {
+            resolve(null);
+            return;
+        }
+        const wasRaw = process.stdin.isRaw;
+        let settled = false;
+        let buffer = "";
+        let timer;
+        const cleanup = () => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            try {
+                process.stdin.removeListener("data", onData);
+                if (process.stdin.setRawMode && !wasRaw) {
+                    process.stdin.setRawMode(false);
+                }
+                process.stdin.pause();
+            }
+            catch {
+                // swallow
+            }
+        };
+        const onData = (chunk) => {
+            buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            const rgb = parseOsc11Response(buffer);
+            if (rgb) {
+                cleanup();
+                const lum = relativeLuminance(rgb.r, rgb.g, rgb.b);
+                resolve({
+                    r: rgb.r,
+                    g: rgb.g,
+                    b: rgb.b,
+                    luminance: lum,
+                    classification: classifyLuminance(lum),
+                    source: "osc11",
+                });
+            }
+        };
+        try {
+            if (process.stdin.setRawMode)
+                process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.on("data", onData);
+            process.stdout.write("\x1b]11;?\x07");
+        }
+        catch {
+            cleanup();
+            resolve(null);
+            return;
+        }
+        timer = setTimeout(() => {
+            cleanup();
+            resolve(null);
+        }, timeoutMs);
+    });
+}
+/**
+ * One-call probe: identity + background + final classification (with "dark" fallback).
+ * The classification field is always concrete per R1.
+ */
+export async function probeTerminal(options) {
+    const env = options.env ?? process.env;
+    const identity = detectTerminalIdentity(env);
+    const timeoutMs = options.timeoutMs ?? 200;
+    const useStandalone = options.useStandaloneOsc ?? !options.terminal;
+    // Override first (R1 AC7)
+    const override = parseOverride(env.CAVE_TERM_BG);
+    if (override) {
+        return { identity, background: override, classification: override.classification };
+    }
+    // Pre-TUI OSC 11 (R1 AC1+2)
+    if (useStandalone) {
+        const osc = await queryOsc11Standalone(Math.min(timeoutMs, 150));
+        if (osc) {
+            return { identity, background: osc, classification: osc.classification };
+        }
+    }
+    else if (options.terminal) {
+        const bg = await queryTerminalBackground(options.terminal, timeoutMs, env);
+        if (bg)
+            return { identity, background: bg, classification: bg.classification };
+    }
+    // COLORFGBG (R1 AC3)
+    const fgbg = parseColorFgBg(env.COLORFGBG);
+    if (fgbg) {
+        return {
+            identity,
+            background: {
+                r: fgbg === "dark" ? 0 : 255,
+                g: fgbg === "dark" ? 0 : 255,
+                b: fgbg === "dark" ? 0 : 255,
+                luminance: fgbg === "dark" ? 0 : 1,
+                classification: fgbg,
+                source: "colorfgbg",
+            },
+            classification: fgbg,
+        };
+    }
+    // Fallback (R1 AC4)
+    return { identity, background: null, classification: "dark" };
+}
+//# sourceMappingURL=terminal-detect.js.map

package/dist/terminal-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-detect.js","sourceRoot":"","sources":["../src/terminal-detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkDH,SAAS,OAAO,CAAC,IAAY,EAAsB;IAClD,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,CACnD;AAED,SAAS,eAAe,CAAC,GAAsB,EAAkD;IAChG,MAAM,WAAW,GAAG,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IACpD,MAAM,kBAAkB,GAAG,GAAG,CAAC,oBAAoB,CAAC;IAEpD,IAAI,GAAG,CAAC,qBAAqB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,GAAG,CAAC,eAAe,IAAI,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC1D,CAAC;IACD,IAAI,GAAG,CAAC,kBAAkB,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,GAAG,CAAC,aAAa,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9D,CAAC;IACD,IAAI,WAAW,KAAK,WAAW,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,WAAW,KAAK,gBAAgB,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACrB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACxC,CAAC;IACD,IAAI,GAAG,CAAC,gBAAgB,IAAI,WAAW,KAAK,QAAQ,EAAE,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,IAAI,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAAA,CAC9B;AAED,MAAM,UAAU,sBAAsB,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAoB;IAC9F,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,WAAW,GAAgB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IAE5E,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO,GAAoB,IAAI,CAAC,OAAO,CAAC;IAC5C,IAAI,WAAwC,CAAC;IAE7C,IAAI,IAAI,EAAE,CAAC;QACV,WAAW,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,OAAO,GAAG,MAAM,CAAC;IAClB,CAAC;SAAM,IAAI,MAAM,EAAE,CAAC;QACnB,WAAW,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,OAAO,GAAG,QAAQ,CAAC;IACpB,CAAC;IAED,OAAO;QACN,OAAO;QACP,WAAW;QACX,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW;QACX,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,CAAC;QACjD,GAAG,EAAE;YACJ,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,oBAAoB,EAAE,GAAG,CAAC,oBAAoB;YAC9C,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;YAChD,eAAe,EAAE,GAAG,CAAC,eAAe;YACpC,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;YAC1C,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,UAAU,EAAE,GAAG,CAAC,UAAU;SAC1B;KACD,CAAC;AAAA,CACF;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS,EAAU;IAC1E,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAClB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;IAAA,CAC/D,CAAC;IACF,OAAO,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;AAAA,CAC1E;AAED,SAAS,iBAAiB,CAAC,GAAW,EAA4B;IACjE,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AAAA,CACrC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAA8C;IACrF,kDAAkD;IAClD,iDAAiD;IACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;IACnH,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;IAAA,CACnC,CAAC;IACF,OAAO,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAAA,CAClF;AAED,SAAS,cAAc,CAAC,GAAuB,EAAmC;IACjF,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,iFAAiF;IACjF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,OAAO,CAAC;IACtC,OAAO,IAAI,CAAC;AAAA,CACZ;AAED,SAAS,aAAa,CAAC,GAAuB,EAA6B;IAC1E,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC9F,CAAC;IACD,iBAAiB;IACjB,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACvC,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,cAAc,EAAE,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAChG,CAAC;IACD,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC5C,QAAgC,EAChC,SAAS,GAAG,GAAG,EACf,GAAG,GAAsB,OAAO,CAAC,GAAG,EACC;IACrC,iDAAiD;IACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,OAAQ,QAA8C,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QAChG,IAAI,CAAC;YACJ,MAAM,QAAQ,GAAG,MAChB,QAGA,CAAC,QAAQ,CAAC,eAAe,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;YAClE,IAAI,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBACzC,IAAI,GAAG,EAAE,CAAC;oBACT,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;oBACnD,OAAO;wBACN,CAAC,EAAE,GAAG,CAAC,CAAC;wBACR,CAAC,EAAE,GAAG,CAAC,CAAC;wBACR,CAAC,EAAE,GAAG,CAAC,CAAC;wBACR,SAAS,EAAE,GAAG;wBACd,cAAc,EAAE,iBAAiB,CAAC,GAAG,CAAC;wBACtC,MAAM,EAAE,OAAO;qBACf,CAAC;gBACH,CAAC;YACF,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,6BAA6B;QAC9B,CAAC;IACF,CAAC;IAED,qBAAqB;IACrB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC;QACV,OAAO;YACN,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;YAC5B,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;YAC5B,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;YAC5B,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClC,cAAc,EAAE,IAAI;YACpB,MAAM,EAAE,WAAW;SACnB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAS,GAAG,GAAG,EAAsC;IACzF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;QACR,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QACnC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,KAAiC,CAAC;QAEtC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;YACrB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,CAAC;gBACJ,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC7C,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC;oBACzC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACR,UAAU;YACX,CAAC;QAAA,CACD,CAAC;QAEF,MAAM,MAAM,GAAG,CAAC,KAAsB,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACrE,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,GAAG,EAAE,CAAC;gBACT,OAAO,EAAE,CAAC;gBACV,MAAM,GAAG,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnD,OAAO,CAAC;oBACP,CAAC,EAAE,GAAG,CAAC,CAAC;oBACR,CAAC,EAAE,GAAG,CAAC,CAAC;oBACR,CAAC,EAAE,GAAG,CAAC,CAAC;oBACR,SAAS,EAAE,GAAG;oBACd,cAAc,EAAE,iBAAiB,CAAC,GAAG,CAAC;oBACtC,MAAM,EAAE,OAAO;iBACf,CAAC,CAAC;YACJ,CAAC;QAAA,CACD,CAAC;QAEF,IAAI,CAAC;YACJ,IAAI,OAAO,CAAC,KAAK,CAAC,UAAU;gBAAE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC7D,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC;YACd,OAAO;QACR,CAAC;QAED,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;YACxB,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC,CAAC;QAAA,CACd,EAAE,SAAS,CAAC,CAAC;IAAA,CACd,CAAC,CAAC;AAAA,CACH;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAMnC,EAAwB;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;IAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,gBAAgB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEpE,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;IACpF,CAAC;IAED,4BAA4B;IAC5B,IAAI,aAAa,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QACjE,IAAI,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC;QAC1E,CAAC;IACF,CAAC;SAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC7B,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC3E,IAAI,EAAE;YAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,CAAC,cAAc,EAAE,CAAC;IAChF,CAAC;IAED,qBAAqB;IACrB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,IAAI,EAAE,CAAC;QACV,OAAO;YACN,QAAQ;YACR,UAAU,EAAE;gBACX,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;gBAC5B,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;gBAC5B,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;gBAC5B,SAAS,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClC,cAAc,EAAE,IAAI;gBACpB,MAAM,EAAE,WAAW;aACnB;YACD,cAAc,EAAE,IAAI;SACpB,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC;AAAA,CAC9D","sourcesContent":["/**\n * Terminal identity and background detection.\n *\n * Covers cavekit-terminal-blend R1 (background luminance detection via OSC 11,\n * COLORFGBG, and CAVE_TERM_BG override) and R2 (terminal program identity).\n */\n\nimport type { ProcessTerminal } from \"./terminal.js\";\n\nexport type TerminalProgram =\n\t| \"ghostty\"\n\t| \"iterm2\"\n\t| \"apple-terminal\"\n\t| \"kitty\"\n\t| \"wezterm\"\n\t| \"alacritty\"\n\t| \"vte\"\n\t| \"tmux\"\n\t| \"screen\"\n\t| \"linux-console\"\n\t| \"cmux\"\n\t| \"windows-terminal\"\n\t| \"vscode\"\n\t| \"unknown\";\n\nexport type Multiplexer = \"tmux\" | \"screen\" | \"none\";\nexport type BackgroundClassification = \"dark\" | \"light\";\n\nexport interface TerminalIdentity {\n\tprogram: TerminalProgram;\n\t/** Outer host terminal when running under a multiplexer. */\n\thostProgram?: TerminalProgram;\n\tversion?: string;\n\tmultiplexer: Multiplexer;\n\tisSsh: boolean;\n\traw: Record<string, string | undefined>;\n}\n\nexport interface TerminalBackground {\n\tr: number;\n\tg: number;\n\tb: number;\n\t/** Relative luminance per WCAG 2.x (0-1). */\n\tluminance: number;\n\tclassification: BackgroundClassification;\n\tsource: \"osc11\" | \"colorfgbg\" | \"override\";\n}\n\nexport interface ProbeResult {\n\tidentity: TerminalIdentity;\n\tbackground: TerminalBackground | null;\n\t/** Final classification — always a concrete value (falls back to \"dark\"). */\n\tclassification: BackgroundClassification;\n}\n\nfunction _getEnv(name: string): string | undefined {\n\tconst v = process.env[name];\n\treturn v === undefined || v === \"\" ? undefined : v;\n}\n\nfunction classifyProgram(env: NodeJS.ProcessEnv): { program: TerminalProgram; version?: string } {\n\tconst termProgram = env.TERM_PROGRAM?.toLowerCase();\n\tconst termProgramVersion = env.TERM_PROGRAM_VERSION;\n\n\tif (env.GHOSTTY_RESOURCES_DIR || termProgram === \"ghostty\") {\n\t\treturn { program: \"ghostty\", version: termProgramVersion };\n\t}\n\tif (env.KITTY_WINDOW_ID || env.TERM?.toLowerCase().includes(\"kitty\")) {\n\t\treturn { program: \"kitty\", version: termProgramVersion };\n\t}\n\tif (env.WEZTERM_EXECUTABLE || termProgram === \"wezterm\") {\n\t\treturn { program: \"wezterm\", version: termProgramVersion };\n\t}\n\tif (env.ALACRITTY_LOG || termProgram === \"alacritty\") {\n\t\treturn { program: \"alacritty\", version: termProgramVersion };\n\t}\n\tif (termProgram === \"iterm.app\" || env.ITERM_SESSION_ID) {\n\t\treturn { program: \"iterm2\", version: termProgramVersion };\n\t}\n\tif (termProgram === \"apple_terminal\") {\n\t\treturn { program: \"apple-terminal\", version: termProgramVersion };\n\t}\n\tif (env.VTE_VERSION) {\n\t\treturn { program: \"vte\", version: env.VTE_VERSION };\n\t}\n\tif (env.WT_SESSION) {\n\t\treturn { program: \"windows-terminal\" };\n\t}\n\tif (env.VSCODE_INJECTION || termProgram === \"vscode\") {\n\t\treturn { program: \"vscode\", version: termProgramVersion };\n\t}\n\tif (env.CMUX_SESSION || env.CMUX || termProgram === \"cmux\") {\n\t\treturn { program: \"cmux\", version: termProgramVersion };\n\t}\n\tif (env.TERM === \"linux\") {\n\t\treturn { program: \"linux-console\" };\n\t}\n\treturn { program: \"unknown\" };\n}\n\nexport function detectTerminalIdentity(env: NodeJS.ProcessEnv = process.env): TerminalIdentity {\n\tconst tmux = Boolean(env.TMUX);\n\tconst screen = Boolean(env.STY);\n\tconst multiplexer: Multiplexer = tmux ? \"tmux\" : screen ? \"screen\" : \"none\";\n\n\tconst host = classifyProgram(env);\n\tlet program: TerminalProgram = host.program;\n\tlet hostProgram: TerminalProgram | undefined;\n\n\tif (tmux) {\n\t\thostProgram = host.program !== \"unknown\" ? host.program : undefined;\n\t\tprogram = \"tmux\";\n\t} else if (screen) {\n\t\thostProgram = host.program !== \"unknown\" ? host.program : undefined;\n\t\tprogram = \"screen\";\n\t}\n\n\treturn {\n\t\tprogram,\n\t\thostProgram,\n\t\tversion: host.version,\n\t\tmultiplexer,\n\t\tisSsh: Boolean(env.SSH_TTY || env.SSH_CONNECTION),\n\t\traw: {\n\t\t\tTERM_PROGRAM: env.TERM_PROGRAM,\n\t\t\tTERM_PROGRAM_VERSION: env.TERM_PROGRAM_VERSION,\n\t\t\tTERM: env.TERM,\n\t\t\tCOLORTERM: env.COLORTERM,\n\t\t\tCOLORFGBG: env.COLORFGBG,\n\t\t\tTMUX: env.TMUX,\n\t\t\tSTY: env.STY,\n\t\t\tSSH_TTY: env.SSH_TTY,\n\t\t\tGHOSTTY_RESOURCES_DIR: env.GHOSTTY_RESOURCES_DIR,\n\t\t\tKITTY_WINDOW_ID: env.KITTY_WINDOW_ID,\n\t\t\tWEZTERM_EXECUTABLE: env.WEZTERM_EXECUTABLE,\n\t\t\tITERM_SESSION_ID: env.ITERM_SESSION_ID,\n\t\t\tVTE_VERSION: env.VTE_VERSION,\n\t\t\tWT_SESSION: env.WT_SESSION,\n\t\t},\n\t};\n}\n\n/** WCAG 2.x relative luminance from sRGB 0-255 components. */\nexport function relativeLuminance(r: number, g: number, b: number): number {\n\tconst toLinear = (c: number): number => {\n\t\tconst s = c / 255;\n\t\treturn s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;\n\t};\n\treturn 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);\n}\n\nfunction classifyLuminance(lum: number): BackgroundClassification {\n\treturn lum >= 0.5 ? \"light\" : \"dark\";\n}\n\nfunction parseOsc11Response(data: string): { r: number; g: number; b: number } | null {\n\t// Match: ESC ]11;rgb:RRRR/GGGG/BBBB (BEL | ESC \\)\n\t// Components may be 1-4 hex digits (commonly 4).\n\tconst match = data.match(/\\x1b\\]11;rgb:([0-9a-fA-F]{1,4})\\/([0-9a-fA-F]{1,4})\\/([0-9a-fA-F]{1,4})(?:\\x07|\\x1b\\\\)/);\n\tif (!match) return null;\n\tconst normalize = (hex: string): number => {\n\t\tconst v = parseInt(hex, 16);\n\t\tconst max = (1 << (hex.length * 4)) - 1;\n\t\treturn Math.round((v / max) * 255);\n\t};\n\treturn { r: normalize(match[1]), g: normalize(match[2]), b: normalize(match[3]) };\n}\n\nfunction parseColorFgBg(raw: string | undefined): BackgroundClassification | null {\n\tif (!raw) return null;\n\tconst parts = raw.split(\";\");\n\tconst bg = parts[parts.length - 1];\n\tconst n = parseInt(bg, 10);\n\tif (!Number.isFinite(n)) return null;\n\t// 0-6 and 8 = dark variants; 7 and 9-15 = light variants (per xterm convention).\n\tif (n >= 0 && n <= 6) return \"dark\";\n\tif (n === 8) return \"dark\";\n\tif (n === 7) return \"light\";\n\tif (n >= 9 && n <= 15) return \"light\";\n\treturn null;\n}\n\nfunction parseOverride(raw: string | undefined): TerminalBackground | null {\n\tif (!raw) return null;\n\tconst v = raw.trim().toLowerCase();\n\tif (v === \"dark\") {\n\t\treturn { r: 0, g: 0, b: 0, luminance: 0, classification: \"dark\", source: \"override\" };\n\t}\n\tif (v === \"light\") {\n\t\treturn { r: 255, g: 255, b: 255, luminance: 1, classification: \"light\", source: \"override\" };\n\t}\n\t// Accept #rrggbb\n\tconst hex = v.startsWith(\"#\") ? v.slice(1) : v;\n\tif (/^[0-9a-f]{6}$/.test(hex)) {\n\t\tconst r = parseInt(hex.slice(0, 2), 16);\n\t\tconst g = parseInt(hex.slice(2, 4), 16);\n\t\tconst b = parseInt(hex.slice(4, 6), 16);\n\t\tconst lum = relativeLuminance(r, g, b);\n\t\treturn { r, g, b, luminance: lum, classification: classifyLuminance(lum), source: \"override\" };\n\t}\n\treturn null;\n}\n\n/**\n * Query the terminal's background color. Tries CAVE_TERM_BG override, then OSC 11,\n * then COLORFGBG. Returns null when no signal is available. Total wall time capped\n * by timeoutMs (default 200ms for the OSC 11 part; env lookups are instant).\n */\nexport async function queryTerminalBackground(\n\tterminal: ProcessTerminal | null,\n\ttimeoutMs = 200,\n\tenv: NodeJS.ProcessEnv = process.env,\n): Promise<TerminalBackground | null> {\n\t// 1. CAVE_TERM_BG override wins unconditionally.\n\tconst override = parseOverride(env.CAVE_TERM_BG);\n\tif (override) return override;\n\n\t// 2. OSC 11 query (when we have a terminal and it's a TTY)\n\tif (terminal && typeof (terminal as unknown as { queryOsc?: unknown }).queryOsc === \"function\") {\n\t\ttry {\n\t\t\tconst response = await (\n\t\t\t\tterminal as unknown as {\n\t\t\t\t\tqueryOsc: (seq: string, prefix: string, ms: number) => Promise<string | null>;\n\t\t\t\t}\n\t\t\t).queryOsc(\"\\x1b]11;?\\x07\", \"\\x1b]11;\", Math.min(timeoutMs, 150));\n\t\t\tif (response) {\n\t\t\t\tconst rgb = parseOsc11Response(response);\n\t\t\t\tif (rgb) {\n\t\t\t\t\tconst lum = relativeLuminance(rgb.r, rgb.g, rgb.b);\n\t\t\t\t\treturn {\n\t\t\t\t\t\tr: rgb.r,\n\t\t\t\t\t\tg: rgb.g,\n\t\t\t\t\t\tb: rgb.b,\n\t\t\t\t\t\tluminance: lum,\n\t\t\t\t\t\tclassification: classifyLuminance(lum),\n\t\t\t\t\t\tsource: \"osc11\",\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t}\n\t\t} catch {\n\t\t\t// Fall through to COLORFGBG.\n\t\t}\n\t}\n\n\t// 3. COLORFGBG parse\n\tconst fgbg = parseColorFgBg(env.COLORFGBG);\n\tif (fgbg) {\n\t\treturn {\n\t\t\tr: fgbg === \"dark\" ? 0 : 255,\n\t\t\tg: fgbg === \"dark\" ? 0 : 255,\n\t\t\tb: fgbg === \"dark\" ? 0 : 255,\n\t\t\tluminance: fgbg === \"dark\" ? 0 : 1,\n\t\t\tclassification: fgbg,\n\t\t\tsource: \"colorfgbg\",\n\t\t};\n\t}\n\n\treturn null;\n}\n\n/**\n * Standalone OSC 11 query that works before the TUI has started.\n *\n * Briefly installs its own stdin listener in raw mode, writes the OSC 11\n * query, waits up to `timeoutMs` for the response, then restores stdin.\n * Returns null on timeout / non-TTY / parse failure.\n *\n * Use this during startup when we need the background classification before\n * theme init but haven't yet constructed a ProcessTerminal.\n */\nexport function queryOsc11Standalone(timeoutMs = 150): Promise<TerminalBackground | null> {\n\treturn new Promise((resolve) => {\n\t\tif (!process.stdout.isTTY || !process.stdin.isTTY) {\n\t\t\tresolve(null);\n\t\t\treturn;\n\t\t}\n\n\t\tconst wasRaw = process.stdin.isRaw;\n\t\tlet settled = false;\n\t\tlet buffer = \"\";\n\t\tlet timer: NodeJS.Timeout | undefined;\n\n\t\tconst cleanup = () => {\n\t\t\tif (settled) return;\n\t\t\tsettled = true;\n\t\t\tif (timer) clearTimeout(timer);\n\t\t\ttry {\n\t\t\t\tprocess.stdin.removeListener(\"data\", onData);\n\t\t\t\tif (process.stdin.setRawMode && !wasRaw) {\n\t\t\t\t\tprocess.stdin.setRawMode(false);\n\t\t\t\t}\n\t\t\t\tprocess.stdin.pause();\n\t\t\t} catch {\n\t\t\t\t// swallow\n\t\t\t}\n\t\t};\n\n\t\tconst onData = (chunk: Buffer | string) => {\n\t\t\tbuffer += typeof chunk === \"string\" ? chunk : chunk.toString(\"utf8\");\n\t\t\tconst rgb = parseOsc11Response(buffer);\n\t\t\tif (rgb) {\n\t\t\t\tcleanup();\n\t\t\t\tconst lum = relativeLuminance(rgb.r, rgb.g, rgb.b);\n\t\t\t\tresolve({\n\t\t\t\t\tr: rgb.r,\n\t\t\t\t\tg: rgb.g,\n\t\t\t\t\tb: rgb.b,\n\t\t\t\t\tluminance: lum,\n\t\t\t\t\tclassification: classifyLuminance(lum),\n\t\t\t\t\tsource: \"osc11\",\n\t\t\t\t});\n\t\t\t}\n\t\t};\n\n\t\ttry {\n\t\t\tif (process.stdin.setRawMode) process.stdin.setRawMode(true);\n\t\t\tprocess.stdin.resume();\n\t\t\tprocess.stdin.on(\"data\", onData);\n\t\t\tprocess.stdout.write(\"\\x1b]11;?\\x07\");\n\t\t} catch {\n\t\t\tcleanup();\n\t\t\tresolve(null);\n\t\t\treturn;\n\t\t}\n\n\t\ttimer = setTimeout(() => {\n\t\t\tcleanup();\n\t\t\tresolve(null);\n\t\t}, timeoutMs);\n\t});\n}\n\n/**\n * One-call probe: identity + background + final classification (with \"dark\" fallback).\n * The classification field is always concrete per R1.\n */\nexport async function probeTerminal(options: {\n\tterminal?: ProcessTerminal | null;\n\ttimeoutMs?: number;\n\tenv?: NodeJS.ProcessEnv;\n\t/** Whether to run the standalone OSC 11 query (needs raw stdin). Default: true when no terminal is supplied. */\n\tuseStandaloneOsc?: boolean;\n}): Promise<ProbeResult> {\n\tconst env = options.env ?? process.env;\n\tconst identity = detectTerminalIdentity(env);\n\tconst timeoutMs = options.timeoutMs ?? 200;\n\tconst useStandalone = options.useStandaloneOsc ?? !options.terminal;\n\n\t// Override first (R1 AC7)\n\tconst override = parseOverride(env.CAVE_TERM_BG);\n\tif (override) {\n\t\treturn { identity, background: override, classification: override.classification };\n\t}\n\n\t// Pre-TUI OSC 11 (R1 AC1+2)\n\tif (useStandalone) {\n\t\tconst osc = await queryOsc11Standalone(Math.min(timeoutMs, 150));\n\t\tif (osc) {\n\t\t\treturn { identity, background: osc, classification: osc.classification };\n\t\t}\n\t} else if (options.terminal) {\n\t\tconst bg = await queryTerminalBackground(options.terminal, timeoutMs, env);\n\t\tif (bg) return { identity, background: bg, classification: bg.classification };\n\t}\n\n\t// COLORFGBG (R1 AC3)\n\tconst fgbg = parseColorFgBg(env.COLORFGBG);\n\tif (fgbg) {\n\t\treturn {\n\t\t\tidentity,\n\t\t\tbackground: {\n\t\t\t\tr: fgbg === \"dark\" ? 0 : 255,\n\t\t\t\tg: fgbg === \"dark\" ? 0 : 255,\n\t\t\t\tb: fgbg === \"dark\" ? 0 : 255,\n\t\t\t\tluminance: fgbg === \"dark\" ? 0 : 1,\n\t\t\t\tclassification: fgbg,\n\t\t\t\tsource: \"colorfgbg\",\n\t\t\t},\n\t\t\tclassification: fgbg,\n\t\t};\n\t}\n\n\t// Fallback (R1 AC4)\n\treturn { identity, background: null, classification: \"dark\" };\n}\n"]}

package/dist/terminal-image.d.ts

@@ -0,0 +1,68 @@
+export type ImageProtocol = "kitty" | "iterm2" | null;
+export interface TerminalCapabilities {
+    images: ImageProtocol;
+    trueColor: boolean;
+    hyperlinks: boolean;
+}
+export interface CellDimensions {
+    widthPx: number;
+    heightPx: number;
+}
+export interface ImageDimensions {
+    widthPx: number;
+    heightPx: number;
+}
+export interface ImageRenderOptions {
+    maxWidthCells?: number;
+    maxHeightCells?: number;
+    preserveAspectRatio?: boolean;
+    /** Kitty image ID. If provided, reuses/replaces existing image with this ID. */
+    imageId?: number;
+}
+export declare function getCellDimensions(): CellDimensions;
+export declare function setCellDimensions(dims: CellDimensions): void;
+export declare function detectCapabilities(): TerminalCapabilities;
+export declare function getCapabilities(): TerminalCapabilities;
+export declare function resetCapabilitiesCache(): void;
+export declare function isImageLine(line: string): boolean;
+/**
+ * Generate a random image ID for Kitty graphics protocol.
+ * Uses random IDs to avoid collisions between different module instances
+ * (e.g., main app vs extensions).
+ */
+export declare function allocateImageId(): number;
+export declare function encodeKitty(base64Data: string, options?: {
+    columns?: number;
+    rows?: number;
+    imageId?: number;
+}): string;
+/**
+ * Delete a Kitty graphics image by ID.
+ * Uses uppercase 'I' to also free the image data.
+ */
+export declare function deleteKittyImage(imageId: number): string;
+/**
+ * Delete all visible Kitty graphics images.
+ * Uses uppercase 'A' to also free the image data.
+ */
+export declare function deleteAllKittyImages(): string;
+export declare function encodeITerm2(base64Data: string, options?: {
+    width?: number | string;
+    height?: number | string;
+    name?: string;
+    preserveAspectRatio?: boolean;
+    inline?: boolean;
+}): string;
+export declare function calculateImageRows(imageDimensions: ImageDimensions, targetWidthCells: number, cellDimensions?: CellDimensions): number;
+export declare function getPngDimensions(base64Data: string): ImageDimensions | null;
+export declare function getJpegDimensions(base64Data: string): ImageDimensions | null;
+export declare function getGifDimensions(base64Data: string): ImageDimensions | null;
+export declare function getWebpDimensions(base64Data: string): ImageDimensions | null;
+export declare function getImageDimensions(base64Data: string, mimeType: string): ImageDimensions | null;
+export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): {
+    sequence: string;
+    rows: number;
+    imageId?: number;
+} | null;
+export declare function imageFallback(mimeType: string, dimensions?: ImageDimensions, filename?: string): string;
+//# sourceMappingURL=terminal-image.d.ts.map

package/dist/terminal-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-image.d.ts","sourceRoot":"","sources":["../src/terminal-image.ts"],"names":[],"mappings":"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","sourcesContent":["export type ImageProtocol = \"kitty\" | \"iterm2\" | null;\n\nexport interface TerminalCapabilities {\n\timages: ImageProtocol;\n\ttrueColor: boolean;\n\thyperlinks: boolean;\n}\n\nexport interface CellDimensions {\n\twidthPx: number;\n\theightPx: number;\n}\n\nexport interface ImageDimensions {\n\twidthPx: number;\n\theightPx: number;\n}\n\nexport interface ImageRenderOptions {\n\tmaxWidthCells?: number;\n\tmaxHeightCells?: number;\n\tpreserveAspectRatio?: boolean;\n\t/** Kitty image ID. If provided, reuses/replaces existing image with this ID. */\n\timageId?: number;\n}\n\nlet cachedCapabilities: TerminalCapabilities | null = null;\n\n// Default cell dimensions - updated by TUI when terminal responds to query\nlet cellDimensions: CellDimensions = { widthPx: 9, heightPx: 18 };\n\nexport function getCellDimensions(): CellDimensions {\n\treturn cellDimensions;\n}\n\nexport function setCellDimensions(dims: CellDimensions): void {\n\tcellDimensions = dims;\n}\n\nexport function detectCapabilities(): TerminalCapabilities {\n\tconst termProgram = process.env.TERM_PROGRAM?.toLowerCase() || \"\";\n\tconst term = process.env.TERM?.toLowerCase() || \"\";\n\tconst colorTerm = process.env.COLORTERM?.toLowerCase() || \"\";\n\n\tif (process.env.KITTY_WINDOW_ID || termProgram === \"kitty\") {\n\t\treturn { images: \"kitty\", trueColor: true, hyperlinks: true };\n\t}\n\n\tif (termProgram === \"ghostty\" || term.includes(\"ghostty\") || process.env.GHOSTTY_RESOURCES_DIR) {\n\t\treturn { images: \"kitty\", trueColor: true, hyperlinks: true };\n\t}\n\n\tif (process.env.WEZTERM_PANE || termProgram === \"wezterm\") {\n\t\treturn { images: \"kitty\", trueColor: true, hyperlinks: true };\n\t}\n\n\tif (process.env.ITERM_SESSION_ID || termProgram === \"iterm.app\") {\n\t\treturn { images: \"iterm2\", trueColor: true, hyperlinks: true };\n\t}\n\n\tif (termProgram === \"vscode\") {\n\t\treturn { images: null, trueColor: true, hyperlinks: true };\n\t}\n\n\tif (termProgram === \"alacritty\") {\n\t\treturn { images: null, trueColor: true, hyperlinks: true };\n\t}\n\n\tconst trueColor = colorTerm === \"truecolor\" || colorTerm === \"24bit\";\n\treturn { images: null, trueColor, hyperlinks: true };\n}\n\nexport function getCapabilities(): TerminalCapabilities {\n\tif (!cachedCapabilities) {\n\t\tcachedCapabilities = detectCapabilities();\n\t}\n\treturn cachedCapabilities;\n}\n\nexport function resetCapabilitiesCache(): void {\n\tcachedCapabilities = null;\n}\n\nconst KITTY_PREFIX = \"\\x1b_G\";\nconst ITERM2_PREFIX = \"\\x1b]1337;File=\";\n\nexport function isImageLine(line: string): boolean {\n\t// Fast path: sequence at line start (single-row images)\n\tif (line.startsWith(KITTY_PREFIX) || line.startsWith(ITERM2_PREFIX)) {\n\t\treturn true;\n\t}\n\t// Slow path: sequence elsewhere (multi-row images have cursor-up prefix)\n\treturn line.includes(KITTY_PREFIX) || line.includes(ITERM2_PREFIX);\n}\n\n/**\n * Generate a random image ID for Kitty graphics protocol.\n * Uses random IDs to avoid collisions between different module instances\n * (e.g., main app vs extensions).\n */\nexport function allocateImageId(): number {\n\t// Use random ID in range [1, 0xffffffff] to avoid collisions\n\treturn Math.floor(Math.random() * 0xfffffffe) + 1;\n}\n\nexport function encodeKitty(\n\tbase64Data: string,\n\toptions: {\n\t\tcolumns?: number;\n\t\trows?: number;\n\t\timageId?: number;\n\t} = {},\n): string {\n\tconst CHUNK_SIZE = 4096;\n\n\tconst params: string[] = [\"a=T\", \"f=100\", \"q=2\"];\n\n\tif (options.columns) params.push(`c=${options.columns}`);\n\tif (options.rows) params.push(`r=${options.rows}`);\n\tif (options.imageId) params.push(`i=${options.imageId}`);\n\n\tif (base64Data.length <= CHUNK_SIZE) {\n\t\treturn `\\x1b_G${params.join(\",\")};${base64Data}\\x1b\\\\`;\n\t}\n\n\tconst chunks: string[] = [];\n\tlet offset = 0;\n\tlet isFirst = true;\n\n\twhile (offset < base64Data.length) {\n\t\tconst chunk = base64Data.slice(offset, offset + CHUNK_SIZE);\n\t\tconst isLast = offset + CHUNK_SIZE >= base64Data.length;\n\n\t\tif (isFirst) {\n\t\t\tchunks.push(`\\x1b_G${params.join(\",\")},m=1;${chunk}\\x1b\\\\`);\n\t\t\tisFirst = false;\n\t\t} else if (isLast) {\n\t\t\tchunks.push(`\\x1b_Gm=0;${chunk}\\x1b\\\\`);\n\t\t} else {\n\t\t\tchunks.push(`\\x1b_Gm=1;${chunk}\\x1b\\\\`);\n\t\t}\n\n\t\toffset += CHUNK_SIZE;\n\t}\n\n\treturn chunks.join(\"\");\n}\n\n/**\n * Delete a Kitty graphics image by ID.\n * Uses uppercase 'I' to also free the image data.\n */\nexport function deleteKittyImage(imageId: number): string {\n\treturn `\\x1b_Ga=d,d=I,i=${imageId}\\x1b\\\\`;\n}\n\n/**\n * Delete all visible Kitty graphics images.\n * Uses uppercase 'A' to also free the image data.\n */\nexport function deleteAllKittyImages(): string {\n\treturn `\\x1b_Ga=d,d=A\\x1b\\\\`;\n}\n\nexport function encodeITerm2(\n\tbase64Data: string,\n\toptions: {\n\t\twidth?: number | string;\n\t\theight?: number | string;\n\t\tname?: string;\n\t\tpreserveAspectRatio?: boolean;\n\t\tinline?: boolean;\n\t} = {},\n): string {\n\tconst params: string[] = [`inline=${options.inline !== false ? 1 : 0}`];\n\n\tif (options.width !== undefined) params.push(`width=${options.width}`);\n\tif (options.height !== undefined) params.push(`height=${options.height}`);\n\tif (options.name) {\n\t\tconst nameBase64 = Buffer.from(options.name).toString(\"base64\");\n\t\tparams.push(`name=${nameBase64}`);\n\t}\n\tif (options.preserveAspectRatio === false) {\n\t\tparams.push(\"preserveAspectRatio=0\");\n\t}\n\n\treturn `\\x1b]1337;File=${params.join(\";\")}:${base64Data}\\x07`;\n}\n\nexport function calculateImageRows(\n\timageDimensions: ImageDimensions,\n\ttargetWidthCells: number,\n\tcellDimensions: CellDimensions = { widthPx: 9, heightPx: 18 },\n): number {\n\tconst targetWidthPx = targetWidthCells * cellDimensions.widthPx;\n\tconst scale = targetWidthPx / imageDimensions.widthPx;\n\tconst scaledHeightPx = imageDimensions.heightPx * scale;\n\tconst rows = Math.ceil(scaledHeightPx / cellDimensions.heightPx);\n\treturn Math.max(1, rows);\n}\n\nexport function getPngDimensions(base64Data: string): ImageDimensions | null {\n\ttry {\n\t\tconst buffer = Buffer.from(base64Data, \"base64\");\n\n\t\tif (buffer.length < 24) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (buffer[0] !== 0x89 || buffer[1] !== 0x50 || buffer[2] !== 0x4e || buffer[3] !== 0x47) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst width = buffer.readUInt32BE(16);\n\t\tconst height = buffer.readUInt32BE(20);\n\n\t\treturn { widthPx: width, heightPx: height };\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function getJpegDimensions(base64Data: string): ImageDimensions | null {\n\ttry {\n\t\tconst buffer = Buffer.from(base64Data, \"base64\");\n\n\t\tif (buffer.length < 2) {\n\t\t\treturn null;\n\t\t}\n\n\t\tif (buffer[0] !== 0xff || buffer[1] !== 0xd8) {\n\t\t\treturn null;\n\t\t}\n\n\t\tlet offset = 2;\n\t\twhile (offset < buffer.length - 9) {\n\t\t\tif (buffer[offset] !== 0xff) {\n\t\t\t\toffset++;\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst marker = buffer[offset + 1];\n\n\t\t\tif (marker >= 0xc0 && marker <= 0xc2) {\n\t\t\t\tconst height = buffer.readUInt16BE(offset + 5);\n\t\t\t\tconst width = buffer.readUInt16BE(offset + 7);\n\t\t\t\treturn { widthPx: width, heightPx: height };\n\t\t\t}\n\n\t\t\tif (offset + 3 >= buffer.length) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\tconst length = buffer.readUInt16BE(offset + 2);\n\t\t\tif (length < 2) {\n\t\t\t\treturn null;\n\t\t\t}\n\t\t\toffset += 2 + length;\n\t\t}\n\n\t\treturn null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function getGifDimensions(base64Data: string): ImageDimensions | null {\n\ttry {\n\t\tconst buffer = Buffer.from(base64Data, \"base64\");\n\n\t\tif (buffer.length < 10) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst sig = buffer.slice(0, 6).toString(\"ascii\");\n\t\tif (sig !== \"GIF87a\" && sig !== \"GIF89a\") {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst width = buffer.readUInt16LE(6);\n\t\tconst height = buffer.readUInt16LE(8);\n\n\t\treturn { widthPx: width, heightPx: height };\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function getWebpDimensions(base64Data: string): ImageDimensions | null {\n\ttry {\n\t\tconst buffer = Buffer.from(base64Data, \"base64\");\n\n\t\tif (buffer.length < 30) {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst riff = buffer.slice(0, 4).toString(\"ascii\");\n\t\tconst webp = buffer.slice(8, 12).toString(\"ascii\");\n\t\tif (riff !== \"RIFF\" || webp !== \"WEBP\") {\n\t\t\treturn null;\n\t\t}\n\n\t\tconst chunk = buffer.slice(12, 16).toString(\"ascii\");\n\t\tif (chunk === \"VP8 \") {\n\t\t\tif (buffer.length < 30) return null;\n\t\t\tconst width = buffer.readUInt16LE(26) & 0x3fff;\n\t\t\tconst height = buffer.readUInt16LE(28) & 0x3fff;\n\t\t\treturn { widthPx: width, heightPx: height };\n\t\t} else if (chunk === \"VP8L\") {\n\t\t\tif (buffer.length < 25) return null;\n\t\t\tconst bits = buffer.readUInt32LE(21);\n\t\t\tconst width = (bits & 0x3fff) + 1;\n\t\t\tconst height = ((bits >> 14) & 0x3fff) + 1;\n\t\t\treturn { widthPx: width, heightPx: height };\n\t\t} else if (chunk === \"VP8X\") {\n\t\t\tif (buffer.length < 30) return null;\n\t\t\tconst width = (buffer[24] | (buffer[25] << 8) | (buffer[26] << 16)) + 1;\n\t\t\tconst height = (buffer[27] | (buffer[28] << 8) | (buffer[29] << 16)) + 1;\n\t\t\treturn { widthPx: width, heightPx: height };\n\t\t}\n\n\t\treturn null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\nexport function getImageDimensions(base64Data: string, mimeType: string): ImageDimensions | null {\n\tif (mimeType === \"image/png\") {\n\t\treturn getPngDimensions(base64Data);\n\t}\n\tif (mimeType === \"image/jpeg\") {\n\t\treturn getJpegDimensions(base64Data);\n\t}\n\tif (mimeType === \"image/gif\") {\n\t\treturn getGifDimensions(base64Data);\n\t}\n\tif (mimeType === \"image/webp\") {\n\t\treturn getWebpDimensions(base64Data);\n\t}\n\treturn null;\n}\n\nexport function renderImage(\n\tbase64Data: string,\n\timageDimensions: ImageDimensions,\n\toptions: ImageRenderOptions = {},\n): { sequence: string; rows: number; imageId?: number } | null {\n\tconst caps = getCapabilities();\n\n\tif (!caps.images) {\n\t\treturn null;\n\t}\n\n\tconst maxWidth = options.maxWidthCells ?? 80;\n\tconst rows = calculateImageRows(imageDimensions, maxWidth, getCellDimensions());\n\n\tif (caps.images === \"kitty\") {\n\t\t// Only use imageId if explicitly provided - static images don't need IDs\n\t\tconst sequence = encodeKitty(base64Data, { columns: maxWidth, rows, imageId: options.imageId });\n\t\treturn { sequence, rows, imageId: options.imageId };\n\t}\n\n\tif (caps.images === \"iterm2\") {\n\t\tconst sequence = encodeITerm2(base64Data, {\n\t\t\twidth: maxWidth,\n\t\t\theight: \"auto\",\n\t\t\tpreserveAspectRatio: options.preserveAspectRatio ?? true,\n\t\t});\n\t\treturn { sequence, rows };\n\t}\n\n\treturn null;\n}\n\nexport function imageFallback(mimeType: string, dimensions?: ImageDimensions, filename?: string): string {\n\tconst parts: string[] = [];\n\tif (filename) parts.push(filename);\n\tparts.push(`[${mimeType}]`);\n\tif (dimensions) parts.push(`${dimensions.widthPx}x${dimensions.heightPx}`);\n\treturn `[Image: ${parts.join(\" \")}]`;\n}\n"]}