Compatibility

paratext (the ansi-escapes surface), paratext/terminal-link and paratext/term-img are graded, not described as compatible. Each is run against its incumbent's own test suite, by compat-oracle, in CI.

The counts are compat-oracle's baselines, the pass count each drop-in is held to. The family's compatibility page is generated from the oracle's last run and is the authority for the current figures.

How a suite is gradedCopy Anchor Link

1. The incumbent's repository is cloned at the release tag of the graded version and its test file copied into packages/compat-oracle/vendor/. No incumbent ships its tests to npm. Each copy's PROVENANCE file names the tag, the commit and the command that reproduces it.
2. The only edit is the import that reaches the library: it is rewritten to a shim generated per run. Assertions and fixtures are upstream's, byte for byte.
3. A control run points the shim at the real incumbent first, which proves the harness and sets the total every rate is measured against.
4. The target run points the same shim at paratext's path.

term-img: 18 of 18, file paths includedCopy Anchor Link

Until 2026-09-30 this row read 12 / 18. The six cases that failed — iTerm2 support, WezTerm support, Konsole support, Rio support, VSCode support and handles options parameter correctly — each hand a file path to a terminal the suite has just declared supported, and paratext/term-img took image bytes only (decision D-030). It now reads a path with node:fs, at the point term-img calls fs.readFileSync (decision D-20260930-paratext-term-img-path). It is the one entry that imports node:fs: the root and every other subpath touch nothing but strings, and weight.test.ts fails if that changes.

Known differencesCopy Anchor Link

• The root's OSC members project off a terminal. link, image and setCwd from paratext return the incumbent's bytes where the terminal is believed to understand them, and the static projection everywhere else; ansi-escapes returns the bytes everywhere. The CSI half is byte-exact and never degrades (The ansi-escapes surface).
• iTerm and ConEmu are declared and undefined. A program that imports them loads; one that calls them is a compile error in TypeScript.
• paratext/term-img also reads a file URL. term-img answers Image required to one.
• paratext/term-img reads iTerm2's whole version number. term-img takes the first character, which would read iTerm2 10 as 1; nothing in the suite tells the two apart.
• paratext/terminal-link needs argv and platform for two of supports-hyperlinks' rules — the --no-hyperlink flag and the Windows check — and reads them from the process, as the incumbent does.

Types and CommonJSCopy Anchor Link

Each path exports its incumbent's names and types. Every entry is ESM with a default condition, so require('paratext/terminal-link') works from CommonJS on Node 22.13+.