tformula 0.1.0

package/dist/geometry.js

@@ -0,0 +1,47 @@
+/**
+ * MathJax dimensions are expressed in ex units. A terminal glyph's x-height is
+ * approximately 45% of its cell height. This keeps ordinary symbols aligned
+ * with terminal text while allowing fractions to use their natural extra height.
+ */
+export function calculateFormulaGeometry(input) {
+    const canvasWidth = Math.max(1, Math.round(input.columns * input.cell.width));
+    const canvasHeight = Math.max(1, Math.round(input.rows * input.cell.height));
+    const exPx = input.cell.height * 0.45 * input.scale;
+    const naturalHeight = Math.max(1, input.naturalHeightEx * exPx);
+    const naturalWidth = Math.max(1, naturalHeight * input.aspectRatio);
+    const horizontalPadding = input.display ? input.cell.width : Math.min(2, input.cell.width * 0.15);
+    // A multi-row display region already has whitespace reserved by the TUI.
+    // Use its full height so tall fractions keep the same glyph scale as simple
+    // equations. Inline formulas retain padding for adjacent terminal text.
+    const verticalPadding = input.display && input.rows > 1
+        ? 0
+        : Math.max(1, input.cell.height * 0.08);
+    const availableWidth = Math.max(1, canvasWidth - horizontalPadding * 2);
+    const availableHeight = Math.max(1, canvasHeight - verticalPadding * 2);
+    // Never enlarge merely to fill the source rectangle; only shrink to fit.
+    const fit = Math.min(1, availableWidth / naturalWidth, availableHeight / naturalHeight);
+    const formulaWidth = Math.max(1, Math.round(naturalWidth * fit));
+    const formulaHeight = Math.max(1, Math.round(naturalHeight * fit));
+    const depthRatio = Math.max(0, Math.min(1, input.depthEx / input.naturalHeightEx));
+    const scaledDepth = formulaHeight * depthRatio;
+    // Terminal protocols expose cell dimensions, but not font ascent. A baseline
+    // near 78% of the cell height matches the usual terminal font metrics. Honor
+    // MathJax's depth below that baseline so rho, J, and subscripted symbols line
+    // up with neighboring terminal text instead of centering unlike bounding boxes.
+    const inlineBaseline = input.cell.height * 0.78;
+    const baselineOffsetY = Math.round(inlineBaseline - (formulaHeight - scaledDepth));
+    const maxOffsetY = Math.max(0, canvasHeight - formulaHeight);
+    return {
+        canvasWidth,
+        canvasHeight,
+        formulaWidth,
+        formulaHeight,
+        offsetX: input.leftAlign
+            ? Math.round(horizontalPadding)
+            : Math.round((canvasWidth - formulaWidth) / 2),
+        offsetY: input.display
+            ? Math.round((canvasHeight - formulaHeight) / 2)
+            : Math.max(0, Math.min(maxOffsetY, baselineOffsetY))
+    };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

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

package/dist/kitty.d.ts

@@ -0,0 +1,15 @@
+export declare const TFORMULA_Z_INDEX = 20260713;
+export declare const TFORMULA_IMAGE_ID_MIN = 1400000000;
+export declare const TFORMULA_IMAGE_ID_MAX = 1999999999;
+export declare function kittyDeleteImage(imageId: number): string;
+/** Delete one placement while retaining the shared image data in the terminal. */
+export declare function kittyDeletePlacement(imageId: number, placementId: number): string;
+export declare function kittyDeleteByZIndex(): string;
+export declare function kittyDeleteRange(firstImageId?: number, lastImageId?: number): string;
+export declare function kittyTransmitAndPlace(png: Uint8Array, imageId: number, columns: number, rows: number): string;
+/** Upload PNG data without creating a placement. */
+export declare function kittyTransmitImage(png: Uint8Array, imageId: number): string;
+/** Place image data that has already been uploaded to the terminal. */
+export declare function kittyPlaceImage(imageId: number, placementId: number, columns: number, rows: number): string;
+export declare function cursorPosition(row: number, column: number): string;
+export declare function synchronizedOutput(content: string): string;

package/dist/kitty.js

@@ -0,0 +1,61 @@
+const ESC = "\x1b";
+const APC_START = `${ESC}_G`;
+const ST = `${ESC}\\`;
+export const TFORMULA_Z_INDEX = 20_260_713;
+export const TFORMULA_IMAGE_ID_MIN = 1_400_000_000;
+export const TFORMULA_IMAGE_ID_MAX = 1_999_999_999;
+export function kittyDeleteImage(imageId) {
+    return `${APC_START}a=d,d=I,i=${imageId},q=2${ST}`;
+}
+/** Delete one placement while retaining the shared image data in the terminal. */
+export function kittyDeletePlacement(imageId, placementId) {
+    return `${APC_START}a=d,d=i,i=${imageId},p=${placementId},q=2${ST}`;
+}
+export function kittyDeleteByZIndex() {
+    return `${APC_START}a=d,d=Z,z=${TFORMULA_Z_INDEX},q=2${ST}`;
+}
+export function kittyDeleteRange(firstImageId = TFORMULA_IMAGE_ID_MIN, lastImageId = TFORMULA_IMAGE_ID_MAX) {
+    return `${APC_START}a=d,d=R,x=${firstImageId},y=${lastImageId},q=2${ST}`;
+}
+export function kittyTransmitAndPlace(png, imageId, columns, rows) {
+    const base64 = Buffer.from(png).toString("base64");
+    const chunkSize = 4096;
+    const chunks = [];
+    for (let offset = 0; offset < base64.length; offset += chunkSize) {
+        chunks.push(base64.slice(offset, offset + chunkSize));
+    }
+    if (chunks.length === 0)
+        chunks.push("");
+    return chunks.map((chunk, index) => {
+        const first = index === 0;
+        const more = index < chunks.length - 1 ? 1 : 0;
+        const controls = first
+            ? `a=T,f=100,t=d,i=${imageId},q=2,c=${columns},r=${rows},C=1,z=${TFORMULA_Z_INDEX},m=${more}`
+            : `m=${more},q=2`;
+        return `${APC_START}${controls};${chunk}${ST}`;
+    }).join("");
+}
+/** Upload PNG data without creating a placement. */
+export function kittyTransmitImage(png, imageId) {
+    const base64 = Buffer.from(png).toString("base64");
+    const chunks = base64.match(/.{1,4096}/gu) ?? [""];
+    return chunks.map((chunk, index) => {
+        const first = index === 0;
+        const more = index < chunks.length - 1 ? 1 : 0;
+        const controls = first
+            ? `a=t,f=100,t=d,i=${imageId},q=2,m=${more}`
+            : `m=${more},q=2`;
+        return `${APC_START}${controls};${chunk}${ST}`;
+    }).join("");
+}
+/** Place image data that has already been uploaded to the terminal. */
+export function kittyPlaceImage(imageId, placementId, columns, rows) {
+    return `${APC_START}a=p,i=${imageId},p=${placementId},q=2,c=${columns},r=${rows},C=1,z=${TFORMULA_Z_INDEX}${ST}`;
+}
+export function cursorPosition(row, column) {
+    return `${ESC}[${Math.max(1, row)};${Math.max(1, column)}H`;
+}
+export function synchronizedOutput(content) {
+    return `${ESC}[?2026h${content}${ESC}[?2026l`;
+}
+//# sourceMappingURL=kitty.js.map

package/dist/kitty.js.map

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

package/dist/math-renderer.d.ts

@@ -0,0 +1,18 @@
+import type { FormulaRegion, RenderedFormula, TerminalCapabilities } from "./types.js";
+import { FormulaCache } from "./formula-cache.js";
+interface SvgDimensions {
+    aspectRatio: number;
+    heightEx: number;
+    depthEx: number;
+}
+export declare function readSvgDimensions(svg: string): SvgDimensions;
+export declare function normalizeLatexForRendering(latex: string): string;
+export declare function renderMathJaxSvg(latex: string, display: boolean, _containerWidth: number, cache?: FormulaCache): Promise<string>;
+export declare class MathRenderer {
+    #private;
+    readonly persistentCache: FormulaCache;
+    constructor(persistentCache?: FormulaCache);
+    render(region: FormulaRegion, columns: number, rows: number, capabilities: TerminalCapabilities, scale: number, foreground?: string, background?: string): Promise<RenderedFormula>;
+    clear(): void;
+}
+export {};

package/dist/math-renderer.js

@@ -0,0 +1,204 @@
+import { Resvg } from "@resvg/resvg-js";
+import { calculateFormulaGeometry } from "./geometry.js";
+import { formulaCacheKey, sharedFormulaCache } from "./formula-cache.js";
+let mathJaxPromise;
+const MATHJAX_CACHE_VERSION = "mathjax-4.1.3-svg-v1";
+const PNG_CACHE_VERSION = "resvg-2.6.2-terminal-canvas-v1";
+const CANONICAL_CONTAINER_WIDTH = 100_000;
+function mathJaxCacheRequest(latex, display) {
+    const normalized = safeLatex(normalizeLatexForRendering(latex).trim());
+    const source = display ? normalized : `\\textstyle{${normalized}}`;
+    return {
+        source,
+        svgKey: formulaCacheKey({
+            version: MATHJAX_CACHE_VERSION,
+            source,
+            display: true,
+            em: 16,
+            ex: 8,
+            containerWidth: CANONICAL_CONTAINER_WIDTH,
+            fontCache: "local"
+        })
+    };
+}
+async function getMathJax() {
+    if (!mathJaxPromise) {
+        mathJaxPromise = import("@mathjax/src").then(async (module) => {
+            const mathJax = module.default;
+            await mathJax.init({
+                loader: { load: ["input/tex", "output/svg"] },
+                tex: { maxBuffer: 8192 },
+                svg: { fontCache: "local" }
+            });
+            return mathJax;
+        });
+    }
+    return mathJaxPromise;
+}
+function parseLength(value) {
+    const match = value?.match(/^([\d.]+)(ex|em|px)?$/u);
+    return match ? { value: Number(match[1]), unit: match[2] ?? "px" } : undefined;
+}
+export function readSvgDimensions(svg) {
+    const width = parseLength(svg.match(/\bwidth="([^"]+)"/u)?.[1]);
+    const height = parseLength(svg.match(/\bheight="([^"]+)"/u)?.[1]);
+    const viewBox = svg.match(/\bviewBox="[^\s]+\s+[^\s]+\s+([\d.]+)\s+([\d.]+)"/u);
+    const fallbackRatio = viewBox ? Number(viewBox[1]) / Number(viewBox[2]) : 1;
+    if (!width || !height)
+        return { aspectRatio: fallbackRatio, heightEx: 1.8, depthEx: 0 };
+    const unitToEx = (length) => {
+        if (length.unit === "ex")
+            return length.value;
+        if (length.unit === "em")
+            return length.value * 2;
+        return length.value / 8;
+    };
+    const widthEx = unitToEx(width);
+    const heightEx = unitToEx(height);
+    const verticalAlign = svg.match(/vertical-align:\s*(-?[\d.]+)(ex|em|px)?/u);
+    const verticalAlignEx = verticalAlign
+        ? unitToEx({ value: Number(verticalAlign[1]), unit: verticalAlign[2] ?? "px" })
+        : 0;
+    return {
+        aspectRatio: Number.isFinite(widthEx / heightEx) ? widthEx / heightEx : fallbackRatio,
+        heightEx,
+        depthEx: Math.max(0, -verticalAlignEx)
+    };
+}
+function safeLatex(latex) {
+    if (latex.length > 8192)
+        throw new Error("formula exceeds the 8192 character limit");
+    if (/\\(?:require|href|url|html|class|cssId|style)\b/iu.test(latex)) {
+        throw new Error("formula contains a disabled command");
+    }
+    return latex;
+}
+export function normalizeLatexForRendering(latex) {
+    const marker = /(?<![A-Za-z0-9.])1\s*\/\s*\\sqrt\s*\{/gu;
+    let normalized = latex;
+    let searchFrom = 0;
+    while (searchFrom < normalized.length) {
+        marker.lastIndex = searchFrom;
+        const match = marker.exec(normalized);
+        if (!match || match.index === undefined)
+            break;
+        const openBrace = marker.lastIndex - 1;
+        let depth = 1;
+        let closeBrace = -1;
+        for (let index = openBrace + 1; index < normalized.length; index += 1) {
+            if (normalized[index] === "{" && normalized[index - 1] !== "\\")
+                depth += 1;
+            if (normalized[index] === "}" && normalized[index - 1] !== "\\")
+                depth -= 1;
+            if (depth === 0) {
+                closeBrace = index;
+                break;
+            }
+        }
+        if (closeBrace < 0)
+            break;
+        const sqrtOffset = match[0].indexOf("\\sqrt");
+        const sqrt = normalized.slice(match.index + sqrtOffset, closeBrace + 1);
+        const replacement = `\\frac{1}{${sqrt}}`;
+        normalized = normalized.slice(0, match.index) + replacement + normalized.slice(closeBrace + 1);
+        searchFrom = match.index + replacement.length;
+    }
+    return normalized;
+}
+function escapeAttribute(value) {
+    return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;");
+}
+function resizeNestedSvg(svg, x, y, width, height) {
+    return svg.replace(/^<svg\b([^>]*)>/u, (_all, attributes) => {
+        const cleaned = attributes
+            .replace(/\s(?:width|height|x|y|style)="[^"]*"/gu, "")
+            .replace(/\sxmlns="[^"]*"/u, "");
+        return `<svg x="${x}" y="${y}" width="${width}" height="${height}"${cleaned}>`;
+    });
+}
+export async function renderMathJaxSvg(latex, display, _containerWidth, cache = sharedFormulaCache) {
+    // MathJax 4.1 can treat top-level relation and binary operators as inline
+    // line-break opportunities and return only the first fragment when called
+    // with display:false. Convert in display mode and force textstyle instead;
+    // this preserves complete inline expressions without enlarging their glyphs.
+    const { source, svgKey } = mathJaxCacheRequest(latex, display);
+    return cache.getOrCreateSvg(svgKey, async () => {
+        const mathJax = await getMathJax();
+        const node = await mathJax.tex2svgPromise(source, {
+            display: true,
+            em: 16,
+            ex: 8,
+            containerWidth: CANONICAL_CONTAINER_WIDTH
+        });
+        const adaptor = mathJax.startup.adaptor;
+        const svgNode = adaptor.tags(node, "svg")[0];
+        if (!svgNode)
+            throw new Error("MathJax produced no SVG");
+        return adaptor.serializeXML(svgNode);
+    });
+}
+export class MathRenderer {
+    persistentCache;
+    #cache = new Map();
+    constructor(persistentCache = sharedFormulaCache) {
+        this.persistentCache = persistentCache;
+    }
+    async render(region, columns, rows, capabilities, scale, foreground = capabilities.foreground, background = capabilities.background) {
+        const { svgKey } = mathJaxCacheRequest(region.latex, region.display);
+        const cacheKey = formulaCacheKey({
+            version: PNG_CACHE_VERSION,
+            svgKey,
+            display: region.display,
+            compact: Boolean(region.compact),
+            columns,
+            rows,
+            cell: { width: capabilities.cell.width, height: capabilities.cell.height },
+            scale,
+            foreground,
+            background
+        });
+        const cached = this.#cache.get(cacheKey);
+        if (cached)
+            return cached;
+        const formulaSvg = await renderMathJaxSvg(region.latex, region.display, Math.max(80, columns * 16), this.persistentCache);
+        const dimensions = readSvgDimensions(formulaSvg);
+        const geometry = calculateFormulaGeometry({
+            aspectRatio: dimensions.aspectRatio,
+            naturalHeightEx: dimensions.heightEx,
+            depthEx: dimensions.depthEx,
+            columns,
+            rows,
+            cell: capabilities.cell,
+            scale,
+            display: region.display,
+            leftAlign: region.compact
+        });
+        const nested = resizeNestedSvg(formulaSvg, geometry.offsetX, geometry.offsetY, geometry.formulaWidth, geometry.formulaHeight);
+        const wrapper = [
+            `<svg xmlns="http://www.w3.org/2000/svg" width="${geometry.canvasWidth}" height="${geometry.canvasHeight}" viewBox="0 0 ${geometry.canvasWidth} ${geometry.canvasHeight}">`,
+            `<rect width="100%" height="100%" fill="${escapeAttribute(background)}"/>`,
+            `<g color="${escapeAttribute(foreground)}" fill="${escapeAttribute(foreground)}">${nested}</g>`,
+            "</svg>"
+        ].join("");
+        const png = await this.persistentCache.getOrCreatePng(cacheKey, async () => new Resvg(wrapper, {
+            background: background,
+            fitTo: { mode: "original" }
+        }).render().asPng());
+        const rendered = {
+            png,
+            cacheKey,
+            columns,
+            rows,
+            widthPx: geometry.canvasWidth,
+            heightPx: geometry.canvasHeight
+        };
+        this.#cache.set(cacheKey, rendered);
+        if (this.#cache.size > 256)
+            this.#cache.delete(this.#cache.keys().next().value);
+        return rendered;
+    }
+    clear() {
+        this.#cache.clear();
+    }
+}
+//# sourceMappingURL=math-renderer.js.map

package/dist/math-renderer.js.map

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

package/dist/output-checkpoints.d.ts

@@ -0,0 +1,15 @@
+export interface OutputSlice {
+    data: string;
+    checkpoint: boolean;
+}
+/**
+ * Splits a streaming PTY transcript only at line boundaries. A checkpoint lets
+ * the renderer place formulas before a large burst scrolls them out of view.
+ * The line count is retained across PTY chunks.
+ */
+export declare class OutputCheckpointSplitter {
+    #private;
+    constructor(lineInterval: number);
+    setLineInterval(lineInterval: number): void;
+    push(data: string): OutputSlice[];
+}

package/dist/output-checkpoints.js

@@ -0,0 +1,36 @@
+/**
+ * Splits a streaming PTY transcript only at line boundaries. A checkpoint lets
+ * the renderer place formulas before a large burst scrolls them out of view.
+ * The line count is retained across PTY chunks.
+ */
+export class OutputCheckpointSplitter {
+    #lineInterval;
+    #linesSinceCheckpoint = 0;
+    constructor(lineInterval) {
+        this.#lineInterval = 1;
+        this.setLineInterval(lineInterval);
+    }
+    setLineInterval(lineInterval) {
+        this.#lineInterval = Math.max(1, Math.floor(lineInterval));
+    }
+    push(data) {
+        if (!data)
+            return [];
+        const slices = [];
+        let sliceStart = 0;
+        for (let index = 0; index < data.length; index += 1) {
+            if (data[index] !== "\n")
+                continue;
+            this.#linesSinceCheckpoint += 1;
+            if (this.#linesSinceCheckpoint < this.#lineInterval)
+                continue;
+            slices.push({ data: data.slice(sliceStart, index + 1), checkpoint: true });
+            sliceStart = index + 1;
+            this.#linesSinceCheckpoint = 0;
+        }
+        if (sliceStart < data.length)
+            slices.push({ data: data.slice(sliceStart), checkpoint: false });
+        return slices;
+    }
+}
+//# sourceMappingURL=output-checkpoints.js.map

package/dist/output-checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-checkpoints.js","sourceRoot":"","sources":["../src/output-checkpoints.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,wBAAwB;IACnC,aAAa,CAAS;IACtB,qBAAqB,GAAG,CAAC,CAAC;IAE1B,YAAY,YAAoB;QAC9B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;IACrC,CAAC;IAED,eAAe,CAAC,YAAoB;QAClC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,CAAC;QACrB,MAAM,MAAM,GAAkB,EAAE,CAAC;QACjC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI;gBAAE,SAAS;YACnC,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC;YAChC,IAAI,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,aAAa;gBAAE,SAAS;YAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC;YACvB,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,UAAU,GAAG,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/F,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/probe.d.ts

@@ -0,0 +1,30 @@
+import type { TerminalCapabilities } from "./types.js";
+interface ParsedResponses {
+    cell?: {
+        width: number;
+        height: number;
+    };
+    windowPixels?: {
+        width: number;
+        height: number;
+    };
+    foreground?: string;
+    background?: string;
+    residual: string;
+}
+declare function parseRgb(value: string): string | undefined;
+export declare function parseTerminalResponses(input: string): ParsedResponses;
+declare function supportsKittyGraphics(env: NodeJS.ProcessEnv): boolean;
+export interface ProbeResult {
+    capabilities: TerminalCapabilities;
+    pendingInput: string;
+}
+export declare function probeTerminal(cellOverride?: {
+    width: number;
+    height: number;
+}, timeoutMs?: number): Promise<ProbeResult>;
+export declare const probeInternals: {
+    parseRgb: typeof parseRgb;
+    supportsKittyGraphics: typeof supportsKittyGraphics;
+};
+export {};

package/dist/probe.js

@@ -0,0 +1,97 @@
+const DEFAULT_CELL = { width: 9, height: 18, source: "fallback" };
+const DEFAULT_FOREGROUND = "#d8dee9";
+const DEFAULT_BACKGROUND = "#1e1e2e";
+function normalizeRgbComponent(value) {
+    const parsed = Number.parseInt(value, 16);
+    const maximum = (16 ** value.length) - 1;
+    return Math.round((parsed / maximum) * 255);
+}
+function parseRgb(value) {
+    const match = value.match(/^rgb:([0-9a-f]{1,4})\/([0-9a-f]{1,4})\/([0-9a-f]{1,4})$/iu);
+    if (!match)
+        return undefined;
+    return `#${match.slice(1, 4).map((part) => normalizeRgbComponent(part).toString(16).padStart(2, "0")).join("")}`;
+}
+export function parseTerminalResponses(input) {
+    let residual = input;
+    let cell;
+    let windowPixels;
+    let foreground;
+    let background;
+    residual = residual.replace(/\x1b\[6;(\d+);(\d+)t/gu, (_all, height, width) => {
+        cell = { width: Number(width), height: Number(height) };
+        return "";
+    });
+    residual = residual.replace(/\x1b\[4;(\d+);(\d+)t/gu, (_all, height, width) => {
+        windowPixels = { width: Number(width), height: Number(height) };
+        return "";
+    });
+    residual = residual.replace(/\x1b\](10|11);([^\x07\x1b]+)(?:\x07|\x1b\\)/gu, (_all, slot, value) => {
+        const color = parseRgb(value);
+        if (slot === "10")
+            foreground = color;
+        if (slot === "11")
+            background = color;
+        return "";
+    });
+    return { cell, windowPixels, foreground, background, residual };
+}
+function supportsKittyGraphics(env) {
+    const identity = `${env.TERM ?? ""} ${env.TERM_PROGRAM ?? ""}`.toLowerCase();
+    return /ghostty|kitty|wezterm/u.test(identity);
+}
+export async function probeTerminal(cellOverride, timeoutMs = 180) {
+    const tty = Boolean(process.stdin.isTTY && process.stdout.isTTY);
+    const fallback = {
+        kittyGraphics: supportsKittyGraphics(process.env),
+        foreground: DEFAULT_FOREGROUND,
+        background: DEFAULT_BACKGROUND,
+        cell: cellOverride
+            ? { ...cellOverride, source: "override" }
+            : DEFAULT_CELL
+    };
+    if (!tty || typeof process.stdin.setRawMode !== "function") {
+        return { capabilities: fallback, pendingInput: "" };
+    }
+    const wasRaw = process.stdin.isRaw;
+    const chunks = [];
+    const onData = (chunk) => {
+        chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+    };
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("data", onData);
+    // Cell pixels, text-area pixels, foreground, and background.
+    process.stdout.write("\x1b[16t\x1b[14t\x1b]10;?\x1b\\\x1b]11;?\x1b\\");
+    await new Promise((resolve) => setTimeout(resolve, timeoutMs));
+    process.stdin.off("data", onData);
+    if (!wasRaw)
+        process.stdin.setRawMode(false);
+    process.stdin.pause();
+    const parsed = parseTerminalResponses(Buffer.concat(chunks).toString("utf8"));
+    let cell = fallback.cell;
+    if (!cellOverride && parsed.cell && parsed.cell.width > 0 && parsed.cell.height > 0) {
+        cell = { ...parsed.cell, source: "cell-query" };
+    }
+    else if (!cellOverride && parsed.windowPixels) {
+        const cols = Math.max(1, process.stdout.columns ?? 80);
+        const rows = Math.max(1, process.stdout.rows ?? 24);
+        cell = {
+            width: parsed.windowPixels.width / cols,
+            height: parsed.windowPixels.height / rows,
+            source: "window-query"
+        };
+    }
+    return {
+        capabilities: {
+            ...fallback,
+            foreground: parsed.foreground ?? fallback.foreground,
+            background: parsed.background ?? fallback.background,
+            cell,
+            windowPixels: parsed.windowPixels
+        },
+        pendingInput: parsed.residual
+    };
+}
+export const probeInternals = { parseRgb, supportsKittyGraphics };
+//# sourceMappingURL=probe.js.map

package/dist/probe.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,2 @@
+import type { CliOptions, TerminalCapabilities } from "./types.js";
+export declare function runProxy(options: CliOptions, initialCapabilities: TerminalCapabilities, pendingInput?: string): Promise<number>;