tformula 0.1.0

package/dist/detect.js

@@ -0,0 +1,342 @@
+import stringWidth from "string-width";
+const COMMAND_RE = /\\(?:frac|dfrac|tfrac|sum|prod|int|iint|iiint|log|ln|exp|sqrt|lim|begin|end|left|right|mathrm|mathbf|mathbb|mathcal|operatorname|overline|underline|hat|bar|vec|partial|nabla|infty|alpha|beta|gamma|delta|epsilon|varepsilon|zeta|eta|theta|vartheta|iota|kappa|lambda|mu|nu|xi|omicron|pi|varpi|rho|varrho|sigma|varsigma|tau|upsilon|phi|varphi|chi|psi|omega)(?![A-Za-z])/gu;
+function mathScore(value) {
+    let score = 0;
+    score += (value.match(COMMAND_RE)?.length ?? 0) * 3;
+    score += Math.min(3, value.match(/[\^_][{A-Za-z0-9(]/gu)?.length ?? 0);
+    score += Math.min(2, value.match(/\\[A-Za-z]+/gu)?.length ?? 0);
+    if (/\{[^{}]+\}/u.test(value))
+        score += 1;
+    if (/[=≈≠≤≥∑∫√∞]|\\(?:le|ge|neq|approx|cdot|times)/u.test(value))
+        score += 1;
+    if (/\b[A-Z]\s*\([^)]*\)/u.test(value))
+        score += 1;
+    return score;
+}
+function visualColumn(line, utf16Index) {
+    return stringWidth(line.slice(0, utf16Index));
+}
+function visualEnd(line, start, end) {
+    const startCol = visualColumn(line, start);
+    return [startCol, startCol + Math.max(1, stringWidth(line.slice(start, end)))];
+}
+function normalizeLatex(parts) {
+    return parts.map((part) => part.trim()).filter(Boolean).join("\n");
+}
+function parenthesizedSegments(line) {
+    const segments = [];
+    for (let start = 0; start < line.length; start += 1) {
+        if (line[start] !== "(" || line[start - 1] === "\\")
+            continue;
+        let depth = 1;
+        for (let end = start + 1; end < line.length; end += 1) {
+            if (line[end] === "(" && line[end - 1] !== "\\")
+                depth += 1;
+            if (line[end] === ")" && line[end - 1] !== "\\")
+                depth -= 1;
+            if (depth !== 0)
+                continue;
+            const body = line.slice(start + 1, end).trim();
+            if (body)
+                segments.push({ start, end: end + 1, body });
+            start = end;
+            break;
+        }
+    }
+    return segments;
+}
+function looksLikeAsciiMath(value) {
+    const compact = value.replace(/\\[ ,;:!]/gu, "").trim();
+    if (!/[A-Za-z0-9]/u.test(compact))
+        return false;
+    if (!/^[A-Za-z0-9\s.,+*/=<>^_{}()[\]|\\-]+$/u.test(compact))
+        return false;
+    if (/[=<>]/u.test(compact))
+        return true;
+    if (/^[A-Za-z](?:[_^](?:[A-Za-z0-9]|\{[A-Za-z0-9]+\}))+$/u.test(compact))
+        return true;
+    const operand = String.raw `(?:\d+(?:\.\d+)?|[A-Za-z])`;
+    return new RegExp(`^${operand}(?:[+*/-]${operand})+$`, "u").test(compact.replace(/\s+/gu, ""));
+}
+function isLikelyMath(value) {
+    return mathScore(value) >= 3 || looksLikeAsciiMath(value);
+}
+function inferredParenthesizedMath(line) {
+    return parenthesizedSegments(line).filter((segment) => isLikelyMath(segment.body));
+}
+function escapeTexText(value) {
+    const replacements = {
+        "\\": "\\backslash{}",
+        "{": "\\{",
+        "}": "\\}",
+        "$": "\\$",
+        "&": "\\&",
+        "#": "\\#",
+        "%": "\\%",
+        "_": "\\_",
+        "^": "\\^{}",
+        "~": "\\~{}"
+    };
+    return value.replace(/[\\{}$&#%_^~]/gu, (character) => replacements[character]);
+}
+function descriptionToLatex(value) {
+    const parts = [];
+    let cursor = 0;
+    for (const segment of parenthesizedSegments(value)) {
+        if (!isLikelyMath(segment.body))
+            continue;
+        const prose = value.slice(cursor, segment.start);
+        if (prose)
+            parts.push(`\\text{${escapeTexText(prose)}}`);
+        parts.push(segment.body);
+        cursor = segment.end;
+    }
+    const prose = value.slice(cursor);
+    if (prose)
+        parts.push(`\\text{${escapeTexText(prose)}}`);
+    return parts.join("");
+}
+function isDefinitionSymbol(value) {
+    return isLikelyMath(value) || /^[A-Za-z](?:[_^](?:[A-Za-z0-9]|\{[A-Za-z0-9]+\}))?$/u.test(value);
+}
+function definitionItem(line) {
+    for (const segment of parenthesizedSegments(line)) {
+        if (!isDefinitionSymbol(segment.body))
+            continue;
+        const prefix = line.slice(0, segment.start);
+        if (!/^\s*(?:[-*•]\s+|\d+[.)]\s+)$/u.test(prefix))
+            continue;
+        const suffix = line.slice(segment.end);
+        const description = suffix.match(/^\s*([：:]\s*\S.*)$/u)?.[1];
+        if (!description)
+            continue;
+        return {
+            body: segment.body,
+            descriptionLatex: descriptionToLatex(description),
+            startCol: visualColumn(line, segment.start),
+            lineWidth: stringWidth(line)
+        };
+    }
+    return undefined;
+}
+function inferredDefinitionGroup(lines, startRow) {
+    const items = [];
+    for (let row = startRow; row < lines.length; row += 1) {
+        const item = definitionItem(lines[row] ?? "");
+        if (!item || (items[0] && item.startCol !== items[0].startCol))
+            break;
+        items.push(item);
+    }
+    if (items.length < 2)
+        return undefined;
+    const latexRows = items
+        .map((item) => `${item.body} & ${item.descriptionLatex}`)
+        .join("\\\\");
+    return {
+        startRow,
+        endRow: startRow + items.length - 1,
+        startCol: items[0].startCol,
+        endCol: Math.max(...items.map((item) => item.lineWidth)),
+        latex: `\\begin{array}{ll}${latexRows}\\end{array}`,
+        display: false,
+        confidence: "inferred",
+        compact: true
+    };
+}
+function isStandaloneDisplayLine(line) {
+    const trimmed = line.trim();
+    return /^(?:\\\[[\s\S]+\\\]|\$\$[^$]+\$\$)$/u.test(trimmed);
+}
+function expandStandaloneDisplayRegions(lines, regions) {
+    const claimedRows = new Set();
+    for (const region of regions) {
+        for (let row = region.startRow; row <= region.endRow; row += 1)
+            claimedRows.add(row);
+    }
+    return regions.map((region) => {
+        if (!region.display
+            || region.startRow !== region.endRow
+            || !isStandaloneDisplayLine(lines[region.startRow] ?? "")) {
+            return region;
+        }
+        let startRow = region.startRow;
+        let endRow = region.endRow;
+        const previousRow = startRow - 1;
+        const nextRow = endRow + 1;
+        if (previousRow >= 0
+            && !(lines[previousRow] ?? "").trim()
+            && !claimedRows.has(previousRow)) {
+            startRow = previousRow;
+            claimedRows.add(previousRow);
+        }
+        if (nextRow < lines.length
+            && !(lines[nextRow] ?? "").trim()
+            && !claimedRows.has(nextRow)) {
+            endRow = nextRow;
+            claimedRows.add(nextRow);
+        }
+        if (startRow === region.startRow && endRow === region.endRow)
+            return region;
+        return {
+            ...region,
+            startRow,
+            endRow,
+            startCol: 0,
+            endCol: Math.max(...lines.slice(startRow, endRow + 1).map((line) => stringWidth(line)), 1)
+        };
+    });
+}
+function trailingInlineRegion(lines, row, line, startIndex, endIndex, latex, confidence) {
+    const suffix = line.slice(endIndex);
+    const trailing = suffix.match(/^([.,;:!?，。；：！？]?)\s*$/u);
+    let regionEndIndex = endIndex;
+    let regionLatex = latex;
+    let endRow = row;
+    let compact = false;
+    if (trailing) {
+        const punctuation = trailing[1] ?? "";
+        if (punctuation) {
+            regionLatex += `\\text{${escapeTexText(punctuation)}}`;
+            regionEndIndex += punctuation.length;
+        }
+        compact = true;
+        if (row + 1 < lines.length && !(lines[row + 1] ?? "").trim())
+            endRow = row + 1;
+    }
+    const [startCol, endCol] = visualEnd(line, startIndex, regionEndIndex);
+    return {
+        startRow: row,
+        endRow,
+        startCol,
+        endCol,
+        latex: regionLatex,
+        display: false,
+        confidence,
+        ...(compact ? { compact: true } : {})
+    };
+}
+/**
+ * Detect formulas in the post-ANSI terminal screen. Explicit TeX delimiters are
+ * preferred. A conservative inferred form handles TUIs that turn `\[`/`\]`
+ * into bare bracket lines while leaving the TeX body visible.
+ */
+export function detectFormulaRegions(lines) {
+    const regions = [];
+    let inCodeFence = false;
+    for (let row = 0; row < lines.length; row += 1) {
+        const line = lines[row] ?? "";
+        const trimmed = line.trim();
+        if (/^```/u.test(trimmed)) {
+            inCodeFence = !inCodeFence;
+            continue;
+        }
+        if (inCodeFence || !trimmed)
+            continue;
+        // Definition lists need group-level layout: the source TeX tokens have
+        // different character widths, so independently overlaying each token
+        // leaves the colons and descriptions staggered. A compact MathJax array
+        // aligns both columns without changing the child terminal's cell layout.
+        const definitionGroup = inferredDefinitionGroup(lines, row);
+        if (definitionGroup) {
+            regions.push(definitionGroup);
+            row = definitionGroup.endRow;
+            continue;
+        }
+        const blockStart = trimmed === "\\[" || trimmed === "$$" || trimmed === "[";
+        if (blockStart) {
+            const explicit = trimmed !== "[";
+            const closing = trimmed === "$$" ? "$$" : trimmed === "\\[" ? "\\]" : "]";
+            const body = [];
+            let endRow = -1;
+            for (let candidate = row + 1; candidate < Math.min(lines.length, row + 16); candidate += 1) {
+                const candidateTrimmed = (lines[candidate] ?? "").trim();
+                if (candidateTrimmed === closing || (closing === "\\]" && candidateTrimmed === "]")) {
+                    endRow = candidate;
+                    break;
+                }
+                body.push(lines[candidate] ?? "");
+            }
+            const latex = normalizeLatex(body);
+            if (endRow > row && latex && (explicit || isLikelyMath(latex))) {
+                regions.push({
+                    startRow: row,
+                    endRow,
+                    startCol: 0,
+                    endCol: Math.max(...lines.slice(row, endRow + 1).map((value) => stringWidth(value)), 1),
+                    latex,
+                    display: true,
+                    confidence: explicit ? "explicit" : "inferred"
+                });
+                row = endRow;
+                continue;
+            }
+        }
+        const explicitPatterns = [
+            { regex: /\\\[([\s\S]+?)\\\]/gu, display: true },
+            { regex: /\$\$([^$]+?)\$\$/gu, display: true },
+            { regex: /\\\((.+?)\\\)/gu, display: false }
+        ];
+        for (const { regex, display } of explicitPatterns) {
+            for (const match of line.matchAll(regex)) {
+                if (match.index === undefined || !match[1]?.trim())
+                    continue;
+                const matchEnd = match.index + match[0].length;
+                if (!display) {
+                    regions.push(trailingInlineRegion(lines, row, line, match.index, matchEnd, match[1].trim(), "explicit"));
+                }
+                else {
+                    const [startCol, endCol] = visualEnd(line, match.index, matchEnd);
+                    regions.push({
+                        startRow: row,
+                        endRow: row,
+                        startCol,
+                        endCol,
+                        latex: match[1].trim(),
+                        display,
+                        confidence: "explicit"
+                    });
+                }
+            }
+        }
+        // Several terminal Markdown renderers consume the backslashes in \(...\)
+        // and leave forms such as `(\mathbf E)` or `(\rho)`. Only infer these
+        // when the body has strong TeX evidence, so ordinary prose parentheses
+        // remain untouched.
+        for (const segment of inferredParenthesizedMath(line)) {
+            const [startCol, endCol] = visualEnd(line, segment.start, segment.end);
+            regions.push({
+                startRow: row,
+                endRow: row,
+                startCol,
+                endCol,
+                latex: segment.body,
+                display: false,
+                confidence: "inferred"
+            });
+        }
+        // Single-dollar inline math is intentionally conservative to avoid prices.
+        const inlineDollar = /(?<!\$)\$([^$\n]+?)\$(?!\$)/gu;
+        for (const match of line.matchAll(inlineDollar)) {
+            if (match.index === undefined || !match[1] || mathScore(match[1]) < 2)
+                continue;
+            regions.push(trailingInlineRegion(lines, row, line, match.index, match.index + match[0].length, match[1].trim(), "explicit"));
+        }
+    }
+    return expandStandaloneDisplayRegions(lines, regions);
+}
+export const detectorInternals = {
+    descriptionToLatex,
+    definitionItem,
+    escapeTexText,
+    expandStandaloneDisplayRegions,
+    inferredDefinitionGroup,
+    inferredParenthesizedMath,
+    isLikelyMath,
+    isStandaloneDisplayLine,
+    looksLikeAsciiMath,
+    mathScore,
+    parenthesizedSegments,
+    trailingInlineRegion,
+    visualColumn
+};
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,cAAc,CAAC;AAGvC,MAAM,UAAU,GAAG,iXAAiX,CAAC;AAErY,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IACvE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAC1C,IAAI,gDAAgD,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IAC7E,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,IAAY,EAAE,UAAkB;IACpD,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACzD,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAQD,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAwD,EAAE,CAAC;IACzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI;YAAE,SAAS;QAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,IAAI,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;YACtD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,IAAI,CAAC,CAAC;YAC5D,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI;gBAAE,KAAK,IAAI,CAAC,CAAC;YAC5D,IAAI,KAAK,KAAK,CAAC;gBAAE,SAAS;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,IAAI;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,KAAK,GAAG,GAAG,CAAC;YACZ,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,CAAC,wCAAwC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1E,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,sDAAsD,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACtF,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAA,4BAA4B,CAAC;IACvD,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,YAAY,OAAO,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAY;IAC7C,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AACrF,CAAC;AASD,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,YAAY,GAA2B;QAC3C,IAAI,EAAE,eAAe;QACrB,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,OAAO;QACZ,GAAG,EAAE,OAAO;KACb,CAAC;IACF,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,CAAE,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,OAAO,IAAI,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IACvB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,sDAAsD,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,KAAK,MAAM,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC;YAAE,SAAS;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,+BAA+B,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,SAAS;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW;YAAE,SAAS;QAC3B,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,gBAAgB,EAAE,kBAAkB,CAAC,WAAW,CAAC;YACjD,QAAQ,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;YAC3C,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC;SAC7B,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAe,EAAE,QAAgB;IAChE,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,KAAK,IAAI,GAAG,GAAG,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YAAE,MAAM;QACtE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEvC,MAAM,SAAS,GAAG,KAAK;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;SACxD,IAAI,CAAC,MAAM,CAAC,CAAC;IAChB,OAAO;QACL,QAAQ;QACR,MAAM,EAAE,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;QACnC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAE,CAAC,QAAQ;QAC5B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,KAAK,EAAE,qBAAqB,SAAS,cAAc;QACnD,OAAO,EAAE,KAAK;QACd,UAAU,EAAE,UAAU;QACtB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAY;IAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,sCAAsC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,8BAA8B,CACrC,KAAe,EACf,OAAwB;IAExB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,IAAI,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvF,CAAC;IAED,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,CAAC,OAAO;eACd,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,MAAM;eACjC,CAAC,uBAAuB,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC5D,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAC/B,IAAI,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,MAAM,WAAW,GAAG,QAAQ,GAAG,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,CAAC;QAC3B,IAAI,WAAW,IAAI,CAAC;eACf,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;eAClC,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACnC,QAAQ,GAAG,WAAW,CAAC;YACvB,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,CAAC,MAAM;eACrB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;eAC9B,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,MAAM,GAAG,OAAO,CAAC;YACjB,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,QAAQ,KAAK,MAAM,CAAC,QAAQ,IAAI,MAAM,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC;QAE5E,OAAO;YACL,GAAG,MAAM;YACT,QAAQ;YACR,MAAM;YACN,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;SAC3F,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAe,EACf,GAAW,EACX,IAAY,EACZ,UAAkB,EAClB,QAAgB,EAChB,KAAa,EACb,UAAuC;IAEvC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACzD,IAAI,cAAc,GAAG,QAAQ,CAAC;IAC9B,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,MAAM,GAAG,GAAG,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACtC,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,IAAI,UAAU,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC;YACvD,cAAc,IAAI,WAAW,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YAAE,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC;IACvE,OAAO;QACL,QAAQ,EAAE,GAAG;QACb,MAAM;QACN,QAAQ;QACR,MAAM;QACN,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,KAAK;QACd,UAAU;QACV,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAe;IAClD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,WAAW,GAAG,KAAK,CAAC;IAExB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,WAAW,IAAI,CAAC,OAAO;YAAE,SAAS;QAEtC,uEAAuE;QACvE,qEAAqE;QACrE,wEAAwE;QACxE,yEAAyE;QACzE,MAAM,eAAe,GAAG,uBAAuB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC9B,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,GAAG,CAAC;QAC5E,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,OAAO,KAAK,GAAG,CAAC;YACjC,MAAM,OAAO,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;YAC1E,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;YAEhB,KAAK,IAAI,SAAS,GAAG,GAAG,GAAG,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC;gBAC3F,MAAM,gBAAgB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzD,IAAI,gBAAgB,KAAK,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,IAAI,gBAAgB,KAAK,GAAG,CAAC,EAAE,CAAC;oBACpF,MAAM,GAAG,SAAS,CAAC;oBACnB,MAAM;gBACR,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;YACpC,CAAC;YAED,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,MAAM,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC,QAAQ,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBAC/D,OAAO,CAAC,IAAI,CAAC;oBACX,QAAQ,EAAE,GAAG;oBACb,MAAM;oBACN,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;oBACvF,KAAK;oBACL,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU;iBAC/C,CAAC,CAAC;gBACH,GAAG,GAAG,MAAM,CAAC;gBACb,SAAS;YACX,CAAC;QACH,CAAC;QAED,MAAM,gBAAgB,GAA+C;YACnE,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,IAAI,EAAE;YAChD,EAAE,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE;YAC9C,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE;SAC7C,CAAC;QAEF,KAAK,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,gBAAgB,EAAE,CAAC;YAClD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;oBAAE,SAAS;gBAC7D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAC/B,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAK,CAAC,KAAK,EACX,QAAQ,EACR,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EACf,UAAU,CACX,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;oBAClE,OAAO,CAAC,IAAI,CAAC;wBACX,QAAQ,EAAE,GAAG;wBACb,MAAM,EAAE,GAAG;wBACX,QAAQ;wBACR,MAAM;wBACN,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;wBACtB,OAAO;wBACP,UAAU,EAAE,UAAU;qBACvB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,yEAAyE;QACzE,sEAAsE;QACtE,uEAAuE;QACvE,oBAAoB;QACpB,KAAK,MAAM,OAAO,IAAI,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YACvE,OAAO,CAAC,IAAI,CAAC;gBACX,QAAQ,EAAE,GAAG;gBACb,MAAM,EAAE,GAAG;gBACX,QAAQ;gBACR,MAAM;gBACN,KAAK,EAAE,OAAO,CAAC,IAAI;gBACnB,OAAO,EAAE,KAAK;gBACd,UAAU,EAAE,UAAU;aACvB,CAAC,CAAC;QACL,CAAC;QAED,2EAA2E;QAC3E,MAAM,YAAY,GAAG,+BAA+B,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;gBAAE,SAAS;YAChF,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAC/B,KAAK,EACL,GAAG,EACH,IAAI,EACJ,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAC7B,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EACf,UAAU,CACX,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,8BAA8B,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kBAAkB;IAClB,cAAc;IACd,aAAa;IACb,8BAA8B;IAC9B,uBAAuB;IACvB,yBAAyB;IACzB,YAAY;IACZ,uBAAuB;IACvB,kBAAkB;IAClB,SAAS;IACT,qBAAqB;IACrB,oBAAoB;IACpB,YAAY;CACb,CAAC"}

package/dist/formula-cache.d.ts

@@ -0,0 +1,18 @@
+export interface FormulaCacheOptions {
+    root?: string;
+    memoryEntries?: number;
+    maxDiskBytes?: number;
+}
+export declare function formulaCacheKey(value: unknown): string;
+export declare class FormulaCache {
+    #private;
+    readonly root: string;
+    constructor(options?: FormulaCacheOptions);
+    getSvg(key: string): Promise<string | undefined>;
+    getPng(key: string): Promise<Buffer | undefined>;
+    getOrCreateSvg(key: string, create: () => Promise<string>): Promise<string>;
+    getOrCreatePng(key: string, create: () => Promise<Uint8Array>): Promise<Buffer>;
+    clearMemory(): void;
+    clearDisk(): Promise<void>;
+}
+export declare const sharedFormulaCache: FormulaCache;

package/dist/formula-cache.js

@@ -0,0 +1,238 @@
+import { createHash, randomUUID } from "node:crypto";
+import { constants } from "node:fs";
+import { mkdir, open, readdir, readFile, rename, rm, stat, unlink, utimes, writeFile } from "node:fs/promises";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+const CACHE_SCHEMA = "v1";
+const DEFAULT_MAX_DISK_BYTES = 256 * 1024 * 1024;
+const LOCK_STALE_MS = 30_000;
+const LOCK_POLL_MS = 30;
+const CLEANUP_WRITE_INTERVAL = 32;
+function defaultCacheRoot() {
+    if (process.env.TFORMULA_CACHE_DIR)
+        return process.env.TFORMULA_CACHE_DIR;
+    // Test runs must never populate or depend on the user's real cache.
+    if (process.env.VITEST)
+        return join(tmpdir(), `tformula-vitest-${process.pid}`);
+    if (process.platform === "darwin")
+        return join(homedir(), "Library", "Caches", "TFormula");
+    return join(process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache"), "tformula");
+}
+function configuredMaxDiskBytes() {
+    const megabytes = Number(process.env.TFORMULA_CACHE_MAX_MB);
+    return Number.isFinite(megabytes) && megabytes > 0
+        ? Math.floor(megabytes * 1024 * 1024)
+        : DEFAULT_MAX_DISK_BYTES;
+}
+export function formulaCacheKey(value) {
+    return createHash("sha256").update(JSON.stringify(value)).digest("hex");
+}
+function isValid(kind, data) {
+    if (kind === "svg")
+        return /<svg(?:\s|>)/u.test(data.subarray(0, 256).toString("utf8"));
+    return data.length >= 24
+        && data.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]))
+        && data.subarray(12, 16).toString("ascii") === "IHDR";
+}
+function sleep(milliseconds) {
+    return new Promise((resolve) => setTimeout(resolve, milliseconds));
+}
+function isCode(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+export class FormulaCache {
+    root;
+    #memoryEntries;
+    #maxDiskBytes;
+    #memory = new Map();
+    #inFlight = new Map();
+    #cleanupRunning = false;
+    #hasCleaned = false;
+    #writesSinceCleanup = 0;
+    constructor(options = {}) {
+        this.root = join(options.root ?? defaultCacheRoot(), CACHE_SCHEMA);
+        this.#memoryEntries = Math.max(1, options.memoryEntries ?? 256);
+        this.#maxDiskBytes = Math.max(0, options.maxDiskBytes ?? configuredMaxDiskBytes());
+    }
+    async getSvg(key) {
+        const data = await this.#read("svg", key);
+        return data?.toString("utf8");
+    }
+    async getPng(key) {
+        return this.#read("png", key);
+    }
+    async getOrCreateSvg(key, create) {
+        const data = await this.#getOrCreate("svg", key, async () => Buffer.from(await create(), "utf8"));
+        return data.toString("utf8");
+    }
+    async getOrCreatePng(key, create) {
+        return this.#getOrCreate("png", key, async () => Buffer.from(await create()));
+    }
+    clearMemory() {
+        this.#memory.clear();
+    }
+    async clearDisk() {
+        this.#memory.clear();
+        await rm(this.root, { force: true, recursive: true });
+    }
+    #memoryKey(kind, key) {
+        return `${kind}:${key}`;
+    }
+    #path(kind, key) {
+        const extension = kind === "svg" ? "svg" : "png";
+        return join(this.root, kind, key.slice(0, 2), `${key}.${extension}`);
+    }
+    #remember(kind, key, data) {
+        const memoryKey = this.#memoryKey(kind, key);
+        this.#memory.delete(memoryKey);
+        this.#memory.set(memoryKey, data);
+        while (this.#memory.size > this.#memoryEntries) {
+            this.#memory.delete(this.#memory.keys().next().value);
+        }
+        return data;
+    }
+    async #read(kind, key) {
+        const memoryKey = this.#memoryKey(kind, key);
+        const memory = this.#memory.get(memoryKey);
+        if (memory)
+            return this.#remember(kind, key, memory);
+        const path = this.#path(kind, key);
+        try {
+            const data = await readFile(path);
+            if (!isValid(kind, data)) {
+                await rm(path, { force: true });
+                return undefined;
+            }
+            const now = new Date();
+            void utimes(path, now, now).catch(() => undefined);
+            return this.#remember(kind, key, data);
+        }
+        catch (error) {
+            if (isCode(error, "ENOENT"))
+                return undefined;
+            throw error;
+        }
+    }
+    async #getOrCreate(kind, key, create) {
+        const cached = await this.#read(kind, key);
+        if (cached)
+            return cached;
+        const inFlightKey = this.#memoryKey(kind, key);
+        const existing = this.#inFlight.get(inFlightKey);
+        if (existing)
+            return existing;
+        const promise = this.#createWithLock(kind, key, create).finally(() => {
+            this.#inFlight.delete(inFlightKey);
+        });
+        this.#inFlight.set(inFlightKey, promise);
+        return promise;
+    }
+    async #createWithLock(kind, key, create) {
+        const path = this.#path(kind, key);
+        const lockPath = `${path}.lock`;
+        await mkdir(dirname(path), { recursive: true });
+        let lock;
+        while (!lock) {
+            try {
+                lock = await open(lockPath, constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY);
+                await lock.writeFile(`${process.pid}\n`);
+            }
+            catch (error) {
+                if (!isCode(error, "EEXIST"))
+                    throw error;
+                const cached = await this.#read(kind, key);
+                if (cached)
+                    return cached;
+                try {
+                    const lockInfo = await stat(lockPath);
+                    if (Date.now() - lockInfo.mtimeMs > LOCK_STALE_MS) {
+                        await unlink(lockPath).catch(() => undefined);
+                        continue;
+                    }
+                }
+                catch (statError) {
+                    if (!isCode(statError, "ENOENT"))
+                        throw statError;
+                    continue;
+                }
+                await sleep(LOCK_POLL_MS);
+            }
+        }
+        try {
+            const cached = await this.#read(kind, key);
+            if (cached)
+                return cached;
+            const data = await create();
+            if (!isValid(kind, data))
+                throw new Error(`refusing to cache invalid ${kind} data`);
+            const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
+            try {
+                await writeFile(temporary, data, { flag: "wx" });
+                await rename(temporary, path);
+            }
+            finally {
+                await rm(temporary, { force: true });
+            }
+            this.#startCleanup();
+            return this.#remember(kind, key, data);
+        }
+        finally {
+            await lock.close().catch(() => undefined);
+            await unlink(lockPath).catch(() => undefined);
+        }
+    }
+    #startCleanup() {
+        if (this.#maxDiskBytes === 0)
+            return;
+        this.#writesSinceCleanup += 1;
+        if (this.#cleanupRunning || (this.#hasCleaned
+            && this.#writesSinceCleanup < CLEANUP_WRITE_INTERVAL))
+            return;
+        this.#cleanupRunning = true;
+        this.#writesSinceCleanup = 0;
+        void this.#trimDisk()
+            .catch(() => undefined)
+            .finally(() => {
+            this.#cleanupRunning = false;
+            this.#hasCleaned = true;
+            if (this.#writesSinceCleanup >= CLEANUP_WRITE_INTERVAL)
+                this.#startCleanup();
+        });
+    }
+    async #trimDisk() {
+        const entries = [];
+        const visit = async (directory) => {
+            let children;
+            try {
+                children = await readdir(directory, { withFileTypes: true });
+            }
+            catch (error) {
+                if (isCode(error, "ENOENT"))
+                    return;
+                throw error;
+            }
+            await Promise.all(children.map(async (child) => {
+                const path = join(directory, child.name);
+                if (child.isDirectory())
+                    return visit(path);
+                if (child.name.endsWith(".lock") || child.name.endsWith(".tmp"))
+                    return;
+                const info = await stat(path);
+                entries.push({ path, size: info.size, mtimeMs: info.mtimeMs });
+            }));
+        };
+        await visit(this.root);
+        let total = entries.reduce((sum, entry) => sum + entry.size, 0);
+        if (total <= this.#maxDiskBytes)
+            return;
+        entries.sort((left, right) => left.mtimeMs - right.mtimeMs);
+        for (const entry of entries) {
+            if (total <= this.#maxDiskBytes)
+                break;
+            await rm(entry.path, { force: true });
+            total -= entry.size;
+        }
+    }
+}
+export const sharedFormulaCache = new FormulaCache();
+//# sourceMappingURL=formula-cache.js.map

package/dist/formula-cache.js.map

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

package/dist/geometry.d.ts

@@ -0,0 +1,26 @@
+import type { CellMetrics } from "./types.js";
+export interface FormulaGeometryInput {
+    aspectRatio: number;
+    naturalHeightEx: number;
+    depthEx: number;
+    columns: number;
+    rows: number;
+    cell: CellMetrics;
+    scale: number;
+    display: boolean;
+    leftAlign?: boolean;
+}
+export interface FormulaGeometry {
+    canvasWidth: number;
+    canvasHeight: number;
+    formulaWidth: number;
+    formulaHeight: number;
+    offsetX: number;
+    offsetY: number;
+}
+/**
+ * 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 declare function calculateFormulaGeometry(input: FormulaGeometryInput): FormulaGeometry;