tformula 0.1.0

package/README.md

@@ -0,0 +1,255 @@
+# TFormula
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+Render LaTeX from **any CLI agent** directly inside your terminal.
+
+> **Ghostty is the recommended terminal.** TFormula is developed and tested
+> primarily with Ghostty and also works with terminals that implement the Kitty
+> graphics protocol, including Kitty and WezTerm.
+
+TFormula is a terminal-agnostic PTY proxy. It does not use Codex, Claude,
+Gemini, or any other agent-specific API.
+
+The child program still sees a normal terminal. TFormula forwards its ANSI
+output unchanged, maintains a headless copy of the terminal screen, detects
+visible TeX, renders it locally with MathJax, and places the result over the
+source text using the Kitty graphics protocol. The original text remains in
+the terminal buffer for copying.
+
+## Quick start in Ghostty
+
+Open Ghostty and run an agent immediately without a global install:
+
+```sh
+npx --yes tformula@latest codex
+```
+
+Or install the short `tformula` command once:
+
+```sh
+npm install --global tformula
+```
+
+Then place `tformula` before whichever agent command you already use:
+
+| Agent | Command |
+|---|---|
+| OpenAI Codex | `tformula codex` |
+| Claude Code | `tformula claude` |
+| Cursor Agent | `tformula agent` |
+| Pi coding agent | `tformula pi` |
+| Gemini CLI | `tformula gemini` |
+| OpenCode | `tformula opencode` |
+| Aider | `tformula aider` |
+| Goose | `tformula goose` |
+| Qwen Code | `tformula qwen` |
+| Any other CLI agent | `tformula -- <agent-command> [args...]` |
+
+The agent itself must already be installed and available on your `PATH`.
+TFormula simply wraps the command; it has no agent-specific integration.
+
+To use npx instead, replace `tformula` in any row with
+`npx --yes tformula@latest`. For example:
+
+```sh
+npx --yes tformula@latest codex
+npx --yes tformula@latest claude
+npx --yes tformula@latest agent
+npx --yes tformula@latest pi
+npx --yes tformula@latest gemini
+npx --yes tformula@latest opencode
+npx --yes tformula@latest aider
+npx --yes tformula@latest goose
+npx --yes tformula@latest -- claude --resume
+npx --yes tformula@latest --shell
+```
+
+`--shell` starts an enhanced login shell, so commands launched inside that shell
+can be wrapped without creating an alias for each agent:
+
+```sh
+tformula --shell
+```
+
+Running `tformula` without arguments is equivalent to `tformula --shell`.
+
+## Requirements
+
+- Ghostty recommended; Kitty, WezTerm, or another Kitty-graphics terminal
+- macOS or Linux
+- Node.js 20 or newer
+- The CLI agent you want to run
+
+The current implementation has been developed against Ghostty 1.3.1.
+
+## Install from this checkout
+
+```sh
+npm install
+npm run check
+npm link
+tformula codex
+```
+
+## Formula sizing
+
+At startup and after terminal resize events, TFormula queries the terminal for
+its cell dimensions in pixels. MathJax's natural `ex` dimensions are mapped to
+the terminal cell height, so an ordinary mathematical symbol has approximately
+the same visual size as neighboring terminal text. Fractions, sums, and other
+tall constructs retain their natural proportions.
+
+Formulas are never enlarged merely to fill the source rectangle. They are only
+scaled down when they would exceed the columns or rows already occupied by the
+source. This is necessary because inserting terminal rows behind a full-screen
+TUI would desynchronize its cursor coordinates.
+
+Formula scans are coalesced during streaming output instead of waiting for the
+terminal to become completely idle. Unrelated status-bar or spinner updates do
+not cancel formulas that remain unchanged on screen. Long PTY output bursts are
+forwarded at line-boundary checkpoints of roughly one third of the terminal
+height. TFormula completes a formula scan at each checkpoint before forwarding
+more rows, so rendered images enter scrollback together with their source text
+instead of being missed after an entire response scrolls past. When the terminal
+grid or cell pixel size changes, TFormula replaces only the affected Kitty
+placements.
+The underlying PNG is retained and shared by every placement with the same
+formula, size, and colors. Normal resizing only replaces images still in the
+live viewport; off-screen placements are preserved so the terminal can scroll
+and scale them with its own scrollback. Replacement is transactional: the old
+placement is deleted only after the new cached variant is ready, and xterm
+markers track its source rows through terminal reflow. A rapid sequence of font
+size changes therefore keeps the previous rendered formula instead of exposing
+the underlying TeX. `CSI 2J` invalidates visible placements,
+while `CSI 3J` and `RIS` invalidate all placements and cached terminal images.
+TFormula reserves a private image-ID range and deletes that complete range on
+full reset and shutdown, including interrupted transmissions.
+
+When an agent emits display math as a single standalone `$$...$$` or
+`\[...\]` line, TFormula borrows adjacent blank terminal rows when available.
+This gives fractions and derivatives enough vertical space to retain the same
+base glyph size as simple equations. Inline math and display delimiters mixed
+with prose are never expanded, so neighboring text is not covered.
+
+A trailing inline formula can similarly use one following blank row for tall
+fraction content. TFormula absorbs terminal punctuation into that overlay so it
+stays next to the rendered expression. The common reciprocal-root form
+`1/\sqrt{...}` is typeset as `\frac{1}{\sqrt{...}}`; slashes in ordinary units
+such as `m/s` are left unchanged.
+
+If a terminal does not answer pixel-size queries, TFormula falls back to 9x18
+pixels. You can override that explicitly:
+
+```sh
+tformula --cell-size 10x20 claude
+```
+
+The default text-relative scale is 1.0. It can be adjusted without changing the
+terminal font:
+
+```sh
+tformula --scale 1.1 codex
+TFORMULA_SCALE=0.9 tformula --shell
+```
+
+## Formula cache
+
+Math rendering is content-addressed and shared by every TFormula-wrapped Agent
+run for the current user. A normalized formula is typeset to SVG once. Each
+terminal-ready PNG variant is then rasterized once for its exact display mode,
+cell dimensions, scale, foreground, background, and source rectangle. Returning
+to an earlier terminal font size reuses the existing PNG instead of invoking
+MathJax or the rasterizer again.
+
+Cache writes use per-item cross-process locks and atomic renames, so concurrent
+Agents can safely request the same formula. In a live terminal session, one PNG
+is uploaded once and reused by independent Kitty placements wherever the same
+variant appears. The original TeX text remains in terminal scrollback.
+
+On macOS the disk cache defaults to `~/Library/Caches/TFormula`; on Linux it
+uses `$XDG_CACHE_HOME/tformula` or `~/.cache/tformula`. Override the location or
+the default 256 MB limit with:
+
+```sh
+TFORMULA_CACHE_DIR=/path/to/cache tformula codex
+TFORMULA_CACHE_MAX_MB=512 tformula claude
+```
+
+## Detection
+
+TFormula recognizes these explicit forms:
+
+```text
+\[ ... \]
+$$ ... $$
+\( ... \)
+$ ... $
+```
+
+Some agent TUIs consume the backslashes around `\[` and `\]` while rendering
+Markdown. For that case TFormula conservatively recognizes a bare `[`/`]`
+block only when its body contains strong TeX features such as `\frac`, `\sum`,
+subscripts, superscripts, or braced arguments.
+
+The same compatibility rule applies when a TUI turns inline delimiters such as
+`\(\rho\)` into `(\rho)`. TFormula renders the parenthesized span only when its
+contents contain a recognized TeX command or similarly strong math structure;
+ordinary prose in parentheses remains unchanged.
+
+Short equations such as `E=mc^2`, `p=0`, and `c^2` are also recognized from
+their operator structure. A single letter is inferred only in a symbol
+definition item, where forms such as `- (E)：energy` are unambiguous.
+
+Consecutive definition items such as `- (\rho)：电荷密度` are rendered as one
+compact two-column MathJax array. This keeps symbols, colons, and descriptions
+aligned even though their original TeX source strings have different widths.
+Math expressions embedded in a description, including units written with
+`\text{...}`, remain mathematical content inside that array.
+
+Single-dollar expressions also require mathematical structure, which prevents
+ordinary prices such as `$12.50` from being rendered.
+
+## Options
+
+```text
+--shell                 Start the login shell
+--no-math               Run only as a transparent PTY proxy
+--scale <number>        Formula-to-terminal text scale (0.5 to 2.0)
+--cell-size <WxH>       Override terminal cell pixels
+-C, --cwd <directory>  Child working directory
+--debug                 Print detection and sizing diagnostics
+```
+
+Use `--` when an agent command or its arguments could be mistaken for TFormula
+options:
+
+```sh
+tformula -- claude --resume
+```
+
+## Safety and fallback behavior
+
+- MathJax and fonts are installed locally; rendering does not use a CDN.
+- Formula length is limited to 8192 characters.
+- Commands that can load or embed external content, including `\require`,
+  `\href`, `\url`, and MathJax HTML/style commands, are rejected.
+- A parse or render failure leaves the original LaTeX visible.
+- On terminals without Kitty graphics support, TFormula remains a transparent
+  PTY proxy.
+
+## Development
+
+```sh
+npm run build
+npm test
+npm run check
+```
+
+The test suite covers delimiter inference, false-positive filtering, Unicode
+column positions, terminal response parsing, text-relative geometry, Kitty
+encoding, MathJax-to-PNG rendering, and generic command wrapping.
+
+For an end-to-end diagnostic, add `--debug`. A successful render reports the
+terminal cell size, source location, and generated pixel rectangle without
+printing the formula image bytes.

package/README.zh-CN.md

@@ -0,0 +1,221 @@
+# TFormula
+
+[English](README.md) | [简体中文](README.zh-CN.md)
+
+直接在终端中渲染**任意 CLI Agent** 输出的 LaTeX 公式。
+
+> **推荐在 Ghostty 中使用。** TFormula 主要基于 Ghostty 开发和测试，也支持
+> Kitty、WezTerm 等实现了 Kitty Graphics Protocol 的终端。
+
+TFormula 是一个与 Agent 无关的 PTY 代理。它不调用 Codex、Claude、Gemini
+或其他 Agent 的专用 API，因此只要 Agent 能在终端中运行，就可以尝试使用
+TFormula 包装。
+
+Agent 看到的仍然是普通终端。TFormula 原样转发 ANSI 输出，同时维护一份
+headless 终端画面，检测其中的 TeX，使用本地 MathJax 渲染，再通过 Kitty
+图形协议把公式图片覆盖到原始文字上。原始 LaTeX 仍保留在终端缓冲区中，
+可以正常复制。
+
+## 在 Ghostty 中快速开始
+
+打开 Ghostty，无需全局安装即可直接运行：
+
+```sh
+npx --yes tformula@latest codex
+```
+
+也可以先全局安装一次，以后使用更短的命令：
+
+```sh
+npm install --global tformula
+```
+
+然后把 `tformula` 放在你平时使用的 Agent 命令前面：
+
+| Agent | 命令 |
+|---|---|
+| OpenAI Codex | `tformula codex` |
+| Claude Code | `tformula claude` |
+| Cursor Agent | `tformula agent` |
+| Pi coding agent | `tformula pi` |
+| Gemini CLI | `tformula gemini` |
+| OpenCode | `tformula opencode` |
+| Aider | `tformula aider` |
+| Goose | `tformula goose` |
+| Qwen Code | `tformula qwen` |
+| 任意其他 CLI Agent | `tformula -- <agent命令> [参数...]` |
+
+相应的 Agent 本身需要已经安装，并且可以从当前 `PATH` 中找到。TFormula
+只负责包装命令，不负责安装 Agent。
+
+如果不想全局安装，把上表中的 `tformula` 换成
+`npx --yes tformula@latest` 即可。例如：
+
+```sh
+npx --yes tformula@latest codex
+npx --yes tformula@latest claude
+npx --yes tformula@latest agent
+npx --yes tformula@latest pi
+npx --yes tformula@latest gemini
+npx --yes tformula@latest opencode
+npx --yes tformula@latest aider
+npx --yes tformula@latest goose
+npx --yes tformula@latest -- claude --resume
+npx --yes tformula@latest --shell
+```
+
+`--shell` 会启动一个增强的登录 Shell。在这个 Shell 中启动命令时，不需要
+为每一个 Agent 单独创建别名：
+
+```sh
+tformula --shell
+```
+
+不带参数运行 `tformula` 等价于 `tformula --shell`。
+
+## 环境要求
+
+- 推荐 Ghostty；也支持 Kitty、WezTerm 或其他兼容 Kitty 图形协议的终端
+- macOS 或 Linux
+- Node.js 20 或更高版本
+- 需要运行的 CLI Agent
+
+当前实现主要基于 Ghostty 1.3.1 开发和验证。
+
+## 从源码安装
+
+```sh
+git clone https://github.com/mikewang817/TFormula.git
+cd TFormula
+npm install
+npm run check
+npm link
+tformula codex
+```
+
+## 公式大小
+
+TFormula 会在启动时以及终端尺寸变化后查询单元格的像素尺寸，再把 MathJax
+公式的自然 `ex` 高度映射到终端文字高度。因此普通数学符号会与周围文字大小
+接近，而分式、求和与导数仍保留自然的上下结构。
+
+公式不会为了填满源码区域而强制放大；只有在超出原始行列范围时才会缩小。
+这是因为全屏 TUI 中不能随意插入额外行，否则会破坏 Agent 的光标坐标。
+
+对于很长的 Agent 输出，TFormula 大约每输出三分之一屏就建立一个检查点，
+先完成公式检测和 placement，再继续输出。这样公式会与文字一起进入 scrollback，
+不会因为整段回复一次滚过屏幕而漏掉。
+
+当使用 `CMD +` 或 `CMD -` 改变字体大小时，新尺寸图片准备完成之前，旧公式
+会继续保留。替换操作是事务式的：只有新 placement 可以创建时，才删除旧
+placement。xterm marker 会在终端 reflow 后继续跟踪公式所在行，因此滚出屏幕
+的已渲染公式不会退回 LaTeX 源码。
+
+如果终端无法返回单元格像素尺寸，默认使用 9×18 像素。也可以手动指定：
+
+```sh
+tformula --cell-size 10x20 claude
+```
+
+默认公式比例为 1.0，可以独立调整：
+
+```sh
+tformula --scale 1.1 codex
+TFORMULA_SCALE=0.9 tformula --shell
+```
+
+## 公式缓存
+
+公式缓存采用内容寻址方式，并由当前用户启动的所有 TFormula Agent 进程共享：
+
+- 同一个规范化公式只进行一次 MathJax SVG 排版。
+- 每一种精确的字号、颜色、终端单元格和显示区域只生成一次 PNG。
+- 多个 Agent 同时请求相同公式时，通过跨进程文件锁避免重复生成。
+- 同一终端会话中的相同 PNG 只上传一次，不同位置共用图片数据并创建各自的
+  placement。
+- 缩放回之前使用过的字号时，直接复用已有 PNG。
+
+macOS 默认缓存目录：
+
+```text
+~/Library/Caches/TFormula
+```
+
+Linux 默认使用：
+
+```text
+$XDG_CACHE_HOME/tformula
+```
+
+或：
+
+```text
+~/.cache/tformula
+```
+
+可以修改目录或默认的 256 MB 上限：
+
+```sh
+TFORMULA_CACHE_DIR=/path/to/cache tformula codex
+TFORMULA_CACHE_MAX_MB=512 tformula claude
+```
+
+## 可识别的公式
+
+TFormula 支持这些显式形式：
+
+```text
+\[ ... \]
+$$ ... $$
+\( ... \)
+$ ... $
+```
+
+某些 Agent TUI 在渲染 Markdown 时会吃掉 `\[`、`\]` 或 `\(`、`\)` 外层的
+反斜杠。为兼容这种情况，TFormula 也会谨慎识别：
+
+- 包含 `\frac`、`\sum`、上下标或花括号参数的裸 `[` / `]` 公式块；
+- 包含明确 TeX 命令或数学结构的 `(\rho)` 等括号表达式；
+- `E=mc^2`、`p=0`、`c^2` 等短方程；
+- `- (\rho)：电荷密度` 等符号定义项；
+- 连续符号定义列表，并将其渲染为对齐的两列表格。
+
+普通文字括号和 `$12.50` 等价格不会被当作公式。
+
+## 命令选项
+
+```text
+--shell                 启动登录 Shell
+--no-math               仅作为透明 PTY 代理，不渲染公式
+--scale <number>        公式相对终端文字的比例，范围 0.5～2.0
+--cell-size <WxH>       手动指定终端单元格像素尺寸
+-C, --cwd <directory>  指定 Agent 的工作目录
+--debug                 输出检测与尺寸调试信息
+```
+
+当 Agent 参数可能被误认为 TFormula 参数时，使用 `--` 分隔：
+
+```sh
+tformula -- claude --resume
+tformula -- opencode --continue
+```
+
+## 安全与降级行为
+
+- MathJax 和字体全部在本地运行，不使用 CDN。
+- 单个公式最长 8192 个字符。
+- 禁止 `\require`、`\href`、`\url` 以及 MathJax HTML/样式命令等可能加载
+  外部内容的命令。
+- 解析或渲染失败时保留原始 LaTeX，不阻断 Agent。
+- 终端不支持 Kitty 图形协议时，TFormula 会退化为透明 PTY 代理。
+
+## 开发
+
+```sh
+npm run build
+npm test
+npm run check
+```
+
+需要端到端诊断时添加 `--debug`。成功渲染会报告终端单元格尺寸、源码位置和
+最终像素矩形，但不会打印图片数据。

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import type { CliOptions } from "./types.js";
+export declare function parseArgs(argv: string[]): CliOptions | "help" | "version";

package/dist/cli.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { realpathSync } from "node:fs";
+import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
+import { probeTerminal } from "./probe.js";
+import { runProxy } from "./proxy.js";
+const { version: VERSION } = createRequire(import.meta.url)("../package.json");
+const HELP = `TFormula ${VERSION}
+
+Render LaTeX produced by any terminal agent while preserving the original TUI.
+
+Usage:
+  tformula [options] [--] [command ...]
+  tformula --shell
+
+Examples:
+  tformula codex
+  tformula claude
+  tformula -- gemini --model gemini-2.5-pro
+  tformula --shell
+
+Options:
+  --shell                 Start the login shell (default when no command is given)
+  --no-math               Run only as a transparent PTY proxy
+  --scale <number>         Formula-to-terminal text scale, default 1.0
+  --cell-size <WxH>        Override terminal cell pixels, for example 9x18
+  -C, --cwd <directory>    Child working directory
+  --debug                  Print diagnostics
+  -h, --help               Show help
+  -V, --version            Show version
+
+TFormula queries the terminal's actual cell pixel size. Formulas keep their
+natural MathJax proportions and are only reduced when they do not fit.
+`;
+function fail(message) {
+    process.stderr.write(`tformula: ${message}\n`);
+    process.exit(2);
+}
+export function parseArgs(argv) {
+    let cwd = process.cwd();
+    let renderMath = true;
+    let debug = false;
+    let scale = Number(process.env.TFORMULA_SCALE ?? "1");
+    let cellOverride;
+    let forceShell = false;
+    const commandParts = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const value = argv[index];
+        if (value === "--") {
+            commandParts.push(...argv.slice(index + 1));
+            break;
+        }
+        if (commandParts.length > 0 || !value.startsWith("-")) {
+            commandParts.push(value);
+            continue;
+        }
+        if (value === "-h" || value === "--help")
+            return "help";
+        if (value === "-V" || value === "--version")
+            return "version";
+        if (value === "--shell")
+            forceShell = true;
+        else if (value === "--no-math")
+            renderMath = false;
+        else if (value === "--debug")
+            debug = true;
+        else if (value === "--scale")
+            scale = Number(argv[++index]);
+        else if (value === "-C" || value === "--cwd")
+            cwd = argv[++index] ?? fail(`${value} requires a directory`);
+        else if (value === "--cell-size") {
+            const raw = argv[++index] ?? fail("--cell-size requires WIDTHxHEIGHT");
+            const match = raw.match(/^(\d+(?:\.\d+)?)x(\d+(?:\.\d+)?)$/u);
+            if (!match)
+                fail("--cell-size must look like 9x18");
+            cellOverride = { width: Number(match[1]), height: Number(match[2]) };
+        }
+        else
+            fail(`unknown option ${value}`);
+    }
+    if (!Number.isFinite(scale) || scale < 0.5 || scale > 2)
+        fail("--scale must be between 0.5 and 2");
+    if (forceShell && commandParts.length > 0)
+        fail("--shell cannot be combined with a command");
+    const shell = process.env.SHELL || "/bin/zsh";
+    const command = forceShell || commandParts.length === 0 ? shell : commandParts[0];
+    const args = forceShell || commandParts.length === 0 ? ["-l"] : commandParts.slice(1);
+    return { command, args, cwd, renderMath, debug, scale, cellOverride };
+}
+async function main() {
+    const parsed = parseArgs(process.argv.slice(2));
+    if (parsed === "help") {
+        process.stdout.write(HELP);
+        return;
+    }
+    if (parsed === "version") {
+        process.stdout.write(`${VERSION}\n`);
+        return;
+    }
+    const { capabilities, pendingInput } = await probeTerminal(parsed.cellOverride);
+    const exitCode = await runProxy(parsed, capabilities, pendingInput);
+    process.exitCode = exitCode;
+}
+let invokedDirectly = false;
+if (process.argv[1]) {
+    try {
+        // npm link invokes this file through a symlink in the global bin folder.
+        invokedDirectly = realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        invokedDirectly = false;
+    }
+}
+if (invokedDirectly) {
+    main().catch((error) => {
+        process.stderr.write(`tformula: ${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/detect.d.ts

@@ -0,0 +1,47 @@
+import type { FormulaRegion } from "./types.js";
+declare function mathScore(value: string): number;
+declare function visualColumn(line: string, utf16Index: number): number;
+interface ParenthesizedSegment {
+    start: number;
+    end: number;
+    body: string;
+}
+declare function parenthesizedSegments(line: string): ParenthesizedSegment[];
+declare function looksLikeAsciiMath(value: string): boolean;
+declare function isLikelyMath(value: string): boolean;
+declare function inferredParenthesizedMath(line: string): ParenthesizedSegment[];
+interface DefinitionItem {
+    body: string;
+    descriptionLatex: string;
+    startCol: number;
+    lineWidth: number;
+}
+declare function escapeTexText(value: string): string;
+declare function descriptionToLatex(value: string): string;
+declare function definitionItem(line: string): DefinitionItem | undefined;
+declare function inferredDefinitionGroup(lines: string[], startRow: number): FormulaRegion | undefined;
+declare function isStandaloneDisplayLine(line: string): boolean;
+declare function expandStandaloneDisplayRegions(lines: string[], regions: FormulaRegion[]): FormulaRegion[];
+declare function trailingInlineRegion(lines: string[], row: number, line: string, startIndex: number, endIndex: number, latex: string, confidence: FormulaRegion["confidence"]): FormulaRegion;
+/**
+ * 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 declare function detectFormulaRegions(lines: string[]): FormulaRegion[];
+export declare const detectorInternals: {
+    descriptionToLatex: typeof descriptionToLatex;
+    definitionItem: typeof definitionItem;
+    escapeTexText: typeof escapeTexText;
+    expandStandaloneDisplayRegions: typeof expandStandaloneDisplayRegions;
+    inferredDefinitionGroup: typeof inferredDefinitionGroup;
+    inferredParenthesizedMath: typeof inferredParenthesizedMath;
+    isLikelyMath: typeof isLikelyMath;
+    isStandaloneDisplayLine: typeof isStandaloneDisplayLine;
+    looksLikeAsciiMath: typeof looksLikeAsciiMath;
+    mathScore: typeof mathScore;
+    parenthesizedSegments: typeof parenthesizedSegments;
+    trailingInlineRegion: typeof trailingInlineRegion;
+    visualColumn: typeof visualColumn;
+};
+export {};