@alchemy.run/sigil 0.0.0-alpha.1 → 0.0.0-alpha.2

package/dist/yoga.d.ts

@@ -0,0 +1,2 @@
+import { C as Unit, S as PositionType, T as constants, _ as Justify, a as Config, b as NodeType, c as Dimension, d as Edge, f as Errata, g as Gutter, h as GridTrackType, i as Node, l as Direction, m as FlexDirection, n as DirtiedFunction, o as Align, p as ExperimentalFeature, r as MeasureFunction, s as BoxSizing, t as Yoga, u as Display, v as LogLevel, w as Wrap, x as Overflow, y as MeasureMode } from "./index-DDVME65c.js";
+export { Align, BoxSizing, type Config, Dimension, Direction, type DirtiedFunction, Display, Edge, Errata, ExperimentalFeature, FlexDirection, GridTrackType, Gutter, Justify, LogLevel, type MeasureFunction, MeasureMode, type Node, NodeType, Overflow, PositionType, Unit, Wrap, Yoga, constants };

package/dist/yoga.js

@@ -0,0 +1,2 @@
+import { _ as Overflow, a as Direction, b as Wrap, c as Errata, d as GridTrackType, f as Gutter, g as NodeType, h as MeasureMode, i as Dimension, l as ExperimentalFeature, m as LogLevel, n as Align, o as Display, p as Justify, r as BoxSizing, s as Edge, t as Yoga, u as FlexDirection, v as PositionType, x as constants, y as Unit } from "./yoga-5jKhYCJC.js";
+export { Align, BoxSizing, Dimension, Direction, Display, Edge, Errata, ExperimentalFeature, FlexDirection, GridTrackType, Gutter, Justify, LogLevel, MeasureMode, NodeType, Overflow, PositionType, Unit, Wrap, Yoga, constants };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alchemy.run/sigil",
-  "version": "0.0.0-alpha.1",
+  "version": "0.0.0-alpha.2",
   "description": "React for CLIs. A self-contained fork of Ink with an integrated TypeScript Yoga layout engine.",
   "keywords": [
     "cli",
@@ -27,13 +27,36 @@
     "url": "alchemy-run/sigil"
   },
   "files": [
+    "src",
     "dist",
     "THIRD_PARTY_NOTICES.md"
   ],
   "type": "module",
+  "imports": {
+    "#/": "./src"
+  },
   "exports": {
-    "types": "./dist/index.d.mts",
-    "default": "./dist/index.mjs"
+    ".": {
+      "typescript": "./src/index.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./ansi": {
+      "typescript": "./src/ansi/index.ts",
+      "bun": "./src/ansi/index.ts",
+      "import": "./dist/ansi.js",
+      "types": "./dist/ansi.d.ts",
+      "default": "./dist/ansi.js"
+    },
+    "./yoga": {
+      "typescript": "./src/yoga/index.ts",
+      "bun": "./src/yoga/index.ts",
+      "import": "./dist/yoga.js",
+      "types": "./dist/yoga.d.ts",
+      "default": "./dist/yoga.js"
+    }
   },
   "publishConfig": {
     "access": "public"
@@ -44,20 +67,19 @@
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
-    "@types/react": "^19.2.14",
+    "@types/react": "^19.2.18",
     "@types/react-reconciler": "^0.33.0",
     "@types/scheduler": "^0.26.0",
     "@types/ws": "^8.18.1",
-    "boxen": "^8.0.1",
-    "node-pty": "^1.2.0-beta.12",
-    "react": "^19.2.4",
+    "react": "^19.2.8",
     "react-devtools-core": "^7.0.1",
-    "react-router": "^7.14.0",
+    "react-router": "^8.3.0",
     "tsx": "^4.21.0",
     "typescript": "^7.0.2",
     "vite-plus": "^0.2.9",
-    "vitest": "4.1.10",
-    "ws": "^8.20.0"
+    "vitest": "4.1.11",
+    "ws": "^8.20.0",
+    "zigpty": "^0.2.1"
   },
   "peerDependencies": {
     "@types/react": ">=19.2.0",
@@ -87,12 +109,10 @@
     "format": "vp fmt .",
     "check": "vp check",
     "typecheck": "tsc --noEmit",
-    "example": "NODE_NO_WARNINGS=1 node --import=tsx",
-    "benchmark": "NODE_NO_WARNINGS=1 node --import=tsx",
-    "inspect": "vp dlx react-devtools",
-    "build:reference": "NODE_NO_WARNINGS=1 node --import=tsx scripts/build-reference.ts",
-    "fuzz": "NODE_NO_WARNINGS=1 node --import=tsx test/yoga/fuzz/typescript.ts",
-    "fuzz:differential": "vp run build:reference && NODE_NO_WARNINGS=1 node --import=tsx test/yoga/fuzz/differential.ts",
-    "fuzz:loop": "vp run build:reference && NODE_NO_WARNINGS=1 node --import=tsx test/yoga/fuzz/loop.ts"
+    "inspect": "vpx react-devtools",
+    "build:reference": "tsx scripts/build-reference.ts",
+    "fuzz": "tsx test/yoga/fuzz/typescript.ts",
+    "fuzz:differential": "vpr build:reference && tsx test/yoga/fuzz/differential.ts",
+    "fuzz:loop": "vpr build:reference && tsx test/yoga/fuzz/loop.ts"
   }
 }

package/src/ansi/chalk.ts

@@ -0,0 +1,179 @@
+// Terminal string styling with a chalk-compatible API for the styles Ink uses.
+// Ported from `chalk` (MIT, Sindre Sorhus) without the chaining builder —
+// Ink only ever applies one style per call.
+import { ESC } from "./escapes.ts";
+import {
+  background,
+  backgroundColorNames,
+  foreground,
+  foregroundColorNames,
+  hexToRgb,
+  modifierNames,
+  rgbToAnsi,
+  rgbToAnsi256,
+  styles,
+  type BackgroundColorName,
+  type ForegroundColorName,
+  type ModifierName,
+} from "./sgr.ts";
+import {
+  supportsColor as supportsColorDetection,
+  type ColorInfo,
+  type ColorSupportLevel,
+} from "./supports-color.ts";
+
+export type { BackgroundColorName, ForegroundColorName, ModifierName };
+
+export type StyleFunction = (text: string) => string;
+
+const { stdout: stdoutColor } = supportsColorDetection;
+
+// `level` → color model for hex/rgb downsampling
+const levelMapping = ["ansi", "ansi", "ansi256", "ansi16m"] as const;
+type ColorModel = (typeof levelMapping)[number];
+
+const state = {
+  level: stdoutColor ? stdoutColor.level : 0,
+};
+
+// Replace every occurrence of `substring` with `substring + replacer`,
+// re-opening a style after a nested close code would have ended it.
+const stringReplaceAll = (string: string, substring: string, replacer: string): string => {
+  let index = string.indexOf(substring);
+  if (index === -1) {
+    return string;
+  }
+
+  const substringLength = substring.length;
+  let endIndex = 0;
+  let returnValue = "";
+  do {
+    returnValue += string.slice(endIndex, index) + substring + replacer;
+    endIndex = index + substringLength;
+    index = string.indexOf(substring, endIndex);
+  } while (index !== -1);
+
+  returnValue += string.slice(endIndex);
+  return returnValue;
+};
+
+// Close the style before every line break and reopen it after, to prevent
+// background bleed across lines (https://github.com/chalk/chalk/pull/92).
+const stringEncaseCRLFWithFirstIndex = (
+  string: string,
+  prefix: string,
+  postfix: string,
+  index: number,
+): string => {
+  let endIndex = 0;
+  let returnValue = "";
+  do {
+    const gotCR = string[index - 1] === "\r";
+    returnValue +=
+      string.slice(endIndex, gotCR ? index - 1 : index) +
+      prefix +
+      (gotCR ? "\r\n" : "\n") +
+      postfix;
+    endIndex = index + 1;
+    index = string.indexOf("\n", endIndex);
+  } while (index !== -1);
+
+  returnValue += string.slice(endIndex);
+  return returnValue;
+};
+
+const applyStyle = (open: string, close: string, text: string): string => {
+  if (state.level <= 0 || !text) {
+    return text;
+  }
+
+  let string = text;
+
+  if (string.includes(ESC)) {
+    // Re-open the style wherever the text already contains its close code,
+    // otherwise only the part before that code would stay styled.
+    string = stringReplaceAll(string, close, open);
+  }
+
+  const lfIndex = string.indexOf("\n");
+  if (lfIndex !== -1) {
+    string = stringEncaseCRLFWithFirstIndex(string, close, open, lfIndex);
+  }
+
+  return open + string + close;
+};
+
+const styleFunction = (open: string, close: string): StyleFunction => {
+  return (text) => applyStyle(open, close, text);
+};
+
+const foregroundOpen = (model: ColorModel, args: number[] | [string]): string => {
+  return colorOpen(model, args, foreground, rgbToAnsi256, rgbToAnsi);
+};
+
+const backgroundOpen = (model: ColorModel, args: number[] | [string]): string => {
+  return colorOpen(model, args, background, rgbToAnsi256, rgbToAnsi);
+};
+
+const colorOpen = (
+  model: ColorModel,
+  args: number[] | [string],
+  space: typeof foreground,
+  toAnsi256: typeof rgbToAnsi256,
+  toAnsi: typeof rgbToAnsi,
+): string => {
+  const rgb = (typeof args[0] === "string" ? hexToRgb(args[0]) : args) as [number, number, number];
+
+  if (model === "ansi16m") {
+    return space.ansi16m(...rgb);
+  }
+
+  if (model === "ansi256") {
+    return space.ansi256(toAnsi256(...rgb));
+  }
+
+  return space.ansi(toAnsi(...rgb));
+};
+
+type NamedStyles = Record<ModifierName | ForegroundColorName | BackgroundColorName, StyleFunction>;
+
+export type Chalk = NamedStyles & {
+  level: ColorSupportLevel;
+  hex: (color: string) => StyleFunction;
+  bgHex: (color: string) => StyleFunction;
+  rgb: (red: number, green: number, blue: number) => StyleFunction;
+  bgRgb: (red: number, green: number, blue: number) => StyleFunction;
+  ansi256: (code: number) => StyleFunction;
+  bgAnsi256: (code: number) => StyleFunction;
+};
+
+const named = {} as NamedStyles;
+
+for (const name of [...modifierNames, ...foregroundColorNames, ...backgroundColorNames]) {
+  named[name] = styleFunction(styles[name].open, styles[name].close);
+}
+
+export const chalk: Chalk = {
+  ...named,
+
+  get level(): ColorSupportLevel {
+    return state.level;
+  },
+  set level(level: ColorSupportLevel) {
+    state.level = level;
+  },
+
+  hex: (color) =>
+    styleFunction(foregroundOpen(levelMapping[state.level], [color]), foreground.close),
+  bgHex: (color) =>
+    styleFunction(backgroundOpen(levelMapping[state.level], [color]), background.close),
+  rgb: (red, green, blue) =>
+    styleFunction(foregroundOpen(levelMapping[state.level], [red, green, blue]), foreground.close),
+  bgRgb: (red, green, blue) =>
+    styleFunction(backgroundOpen(levelMapping[state.level], [red, green, blue]), background.close),
+  // Like chalk, 256-color styles always emit 8-bit codes (level only gates level 0).
+  ansi256: (code) => styleFunction(foreground.ansi256(code), foreground.close),
+  bgAnsi256: (code) => styleFunction(background.ansi256(code), background.close),
+};
+
+export const supportsColor: ColorInfo = stdoutColor;

package/src/ansi/cursor.ts

@@ -0,0 +1,48 @@
+// Derived from `cli-cursor` + `restore-cursor` (MIT, Sindre Sorhus),
+// collapsed into one module. Restores the cursor on process exit once
+// `hide()` has been called, like `restore-cursor` did.
+import process from "node:process";
+
+import { signalExit } from "../signal-exit.ts";
+import { cursorHide, cursorShow } from "./escapes.ts";
+
+type CursorStream = {
+  isTTY?: boolean;
+  write: (data: string) => unknown;
+};
+
+let restoreRegistered = false;
+
+const registerRestore = (): void => {
+  if (restoreRegistered) {
+    return;
+  }
+
+  restoreRegistered = true;
+
+  signalExit(
+    () => {
+      process.stderr.write(cursorShow);
+    },
+    { alwaysLast: true },
+  );
+};
+
+export const cliCursor = {
+  show(writableStream: CursorStream = process.stderr): void {
+    if (!writableStream.isTTY) {
+      return;
+    }
+
+    writableStream.write(cursorShow);
+  },
+
+  hide(writableStream: CursorStream = process.stderr): void {
+    if (!writableStream.isTTY) {
+      return;
+    }
+
+    registerRestore();
+    writableStream.write(cursorHide);
+  },
+};

package/src/ansi/east-asian-width.ts

@@ -0,0 +1,215 @@
+// East Asian Width lookup, plus string-width's full-width test.
+// Ported from `get-east-asian-width` and `is-fullwidth-code-point`
+// (MIT, Sindre Sorhus). The range tables are generated from Unicode data.
+
+export type EastAsianWidthType =
+  | "ambiguous"
+  | "fullwidth"
+  | "halfwidth"
+  | "narrow"
+  | "neutral"
+  | "wide";
+
+// Binary search on a sorted flat array of inclusive [start, end] pairs.
+const isInRange = (ranges: readonly number[], codePoint: number): boolean => {
+  let low = 0;
+  let high = Math.floor(ranges.length / 2) - 1;
+  while (low <= high) {
+    const mid = Math.floor((low + high) / 2);
+    const i = mid * 2;
+    if (codePoint < ranges[i]!) {
+      high = mid - 1;
+    } else if (codePoint > ranges[i + 1]!) {
+      low = mid + 1;
+    } else {
+      return true;
+    }
+  }
+
+  return false;
+};
+
+export const ambiguousMinimalCodePoint = 161;
+export const ambiguousMaximumCodePoint = 1114109;
+export const ambiguousRanges: readonly number[] = [
+  161, 161, 164, 164, 167, 168, 170, 170, 173, 174, 176, 180, 182, 186, 188, 191, 198, 198, 208,
+  208, 215, 216, 222, 225, 230, 230, 232, 234, 236, 237, 240, 240, 242, 243, 247, 250, 252, 252,
+  254, 254, 257, 257, 273, 273, 275, 275, 283, 283, 294, 295, 299, 299, 305, 307, 312, 312, 319,
+  322, 324, 324, 328, 331, 333, 333, 338, 339, 358, 359, 363, 363, 462, 462, 464, 464, 466, 466,
+  468, 468, 470, 470, 472, 472, 474, 474, 476, 476, 593, 593, 609, 609, 708, 708, 711, 711, 713,
+  715, 717, 717, 720, 720, 728, 731, 733, 733, 735, 735, 768, 879, 913, 929, 931, 937, 945, 961,
+  963, 969, 1025, 1025, 1040, 1103, 1105, 1105, 8208, 8208, 8211, 8214, 8216, 8217, 8220, 8221,
+  8224, 8226, 8228, 8231, 8240, 8240, 8242, 8243, 8245, 8245, 8251, 8251, 8254, 8254, 8308, 8308,
+  8319, 8319, 8321, 8324, 8364, 8364, 8451, 8451, 8453, 8453, 8457, 8457, 8467, 8467, 8470, 8470,
+  8481, 8482, 8486, 8486, 8491, 8491, 8531, 8532, 8539, 8542, 8544, 8555, 8560, 8569, 8585, 8585,
+  8592, 8601, 8632, 8633, 8658, 8658, 8660, 8660, 8679, 8679, 8704, 8704, 8706, 8707, 8711, 8712,
+  8715, 8715, 8719, 8719, 8721, 8721, 8725, 8725, 8730, 8730, 8733, 8736, 8739, 8739, 8741, 8741,
+  8743, 8748, 8750, 8750, 8756, 8759, 8764, 8765, 8776, 8776, 8780, 8780, 8786, 8786, 8800, 8801,
+  8804, 8807, 8810, 8811, 8814, 8815, 8834, 8835, 8838, 8839, 8853, 8853, 8857, 8857, 8869, 8869,
+  8895, 8895, 8978, 8978, 9312, 9449, 9451, 9547, 9552, 9587, 9600, 9615, 9618, 9621, 9632, 9633,
+  9635, 9641, 9650, 9651, 9654, 9655, 9660, 9661, 9664, 9665, 9670, 9672, 9675, 9675, 9678, 9681,
+  9698, 9701, 9711, 9711, 9733, 9734, 9737, 9737, 9742, 9743, 9756, 9756, 9758, 9758, 9792, 9792,
+  9794, 9794, 9824, 9825, 9827, 9829, 9831, 9834, 9836, 9837, 9839, 9839, 9886, 9887, 9919, 9919,
+  9926, 9933, 9935, 9939, 9941, 9953, 9955, 9955, 9960, 9961, 9963, 9969, 9972, 9972, 9974, 9977,
+  9979, 9980, 9982, 9983, 10045, 10045, 10102, 10111, 11094, 11097, 12872, 12879, 57344, 63743,
+  65024, 65039, 65533, 65533, 127232, 127242, 127248, 127277, 127280, 127337, 127344, 127373,
+  127375, 127376, 127387, 127404, 917760, 917999, 983040, 1048573, 1048576, 1114109,
+];
+
+export const fullwidthMinimalCodePoint = 12288;
+export const fullwidthMaximumCodePoint = 65510;
+export const fullwidthRanges: readonly number[] = [12288, 12288, 65281, 65376, 65504, 65510];
+
+export const halfwidthMinimalCodePoint = 8361;
+export const halfwidthMaximumCodePoint = 65518;
+export const halfwidthRanges: readonly number[] = [
+  8361, 8361, 65377, 65470, 65474, 65479, 65482, 65487, 65490, 65495, 65498, 65500, 65512, 65518,
+];
+
+export const narrowMinimalCodePoint = 32;
+export const narrowMaximumCodePoint = 10630;
+export const narrowRanges: readonly number[] = [
+  32, 126, 162, 163, 165, 166, 172, 172, 175, 175, 10214, 10221, 10629, 10630,
+];
+
+export const wideMinimalCodePoint = 4352;
+export const wideMaximumCodePoint = 262141;
+export const wideRanges: readonly number[] = [
+  4352, 4447, 8986, 8987, 9001, 9002, 9193, 9196, 9200, 9200, 9203, 9203, 9725, 9726, 9748, 9749,
+  9776, 9783, 9800, 9811, 9855, 9855, 9866, 9871, 9875, 9875, 9889, 9889, 9898, 9899, 9917, 9918,
+  9924, 9925, 9934, 9934, 9940, 9940, 9962, 9962, 9970, 9971, 9973, 9973, 9978, 9978, 9981, 9981,
+  9989, 9989, 9994, 9995, 10024, 10024, 10060, 10060, 10062, 10062, 10067, 10069, 10071, 10071,
+  10133, 10135, 10160, 10160, 10175, 10175, 11035, 11036, 11088, 11088, 11093, 11093, 11904, 11929,
+  11931, 12019, 12032, 12245, 12272, 12287, 12289, 12350, 12353, 12438, 12441, 12543, 12549, 12591,
+  12593, 12686, 12688, 12773, 12783, 12830, 12832, 12871, 12880, 42124, 42128, 42182, 43360, 43388,
+  44032, 55203, 63744, 64255, 65040, 65049, 65072, 65106, 65108, 65126, 65128, 65131, 94176, 94180,
+  94192, 94198, 94208, 101589, 101631, 101662, 101760, 101874, 110576, 110579, 110581, 110587,
+  110589, 110590, 110592, 110882, 110898, 110898, 110928, 110930, 110933, 110933, 110948, 110951,
+  110960, 111355, 119552, 119638, 119648, 119670, 126980, 126980, 127183, 127183, 127374, 127374,
+  127377, 127386, 127488, 127490, 127504, 127547, 127552, 127560, 127568, 127569, 127584, 127589,
+  127744, 127776, 127789, 127797, 127799, 127868, 127870, 127891, 127904, 127946, 127951, 127955,
+  127968, 127984, 127988, 127988, 127992, 128062, 128064, 128064, 128066, 128252, 128255, 128317,
+  128331, 128334, 128336, 128359, 128378, 128378, 128405, 128406, 128420, 128420, 128507, 128591,
+  128640, 128709, 128716, 128716, 128720, 128722, 128725, 128728, 128732, 128735, 128747, 128748,
+  128756, 128764, 128992, 129003, 129008, 129008, 129292, 129338, 129340, 129349, 129351, 129535,
+  129648, 129660, 129664, 129674, 129678, 129734, 129736, 129736, 129741, 129756, 129759, 129770,
+  129775, 129784, 131072, 196605, 196608, 262141,
+];
+
+const commonCjkCodePoint = 0x4e_00;
+const [wideFastPathStart, wideFastPathEnd] = /* #__PURE__ */ findWideFastPathRange(wideRanges);
+
+// Use a hot-path range so common `isWide` calls can skip binary search.
+// The range containing U+4E00 covers common CJK ideographs;
+// fallback to the largest range for resilience to Unicode table changes.
+function findWideFastPathRange(ranges: readonly number[]): [number, number] {
+  let fastPathStart = ranges[0]!;
+  let fastPathEnd = ranges[1]!;
+
+  for (let index = 0; index < ranges.length; index += 2) {
+    const start = ranges[index]!;
+    const end = ranges[index + 1]!;
+
+    if (commonCjkCodePoint >= start && commonCjkCodePoint <= end) {
+      return [start, end];
+    }
+
+    if (end - start > fastPathEnd - fastPathStart) {
+      fastPathStart = start;
+      fastPathEnd = end;
+    }
+  }
+
+  return [fastPathStart, fastPathEnd];
+}
+
+export const isAmbiguous = (codePoint: number): boolean => {
+  if (codePoint < ambiguousMinimalCodePoint || codePoint > ambiguousMaximumCodePoint) {
+    return false;
+  }
+
+  return isInRange(ambiguousRanges, codePoint);
+};
+
+export const isFullWidth = (codePoint: number): boolean => {
+  if (codePoint < fullwidthMinimalCodePoint || codePoint > fullwidthMaximumCodePoint) {
+    return false;
+  }
+
+  return isInRange(fullwidthRanges, codePoint);
+};
+
+const isHalfWidth = (codePoint: number): boolean => {
+  if (codePoint < halfwidthMinimalCodePoint || codePoint > halfwidthMaximumCodePoint) {
+    return false;
+  }
+
+  return isInRange(halfwidthRanges, codePoint);
+};
+
+const isNarrow = (codePoint: number): boolean => {
+  if (codePoint < narrowMinimalCodePoint || codePoint > narrowMaximumCodePoint) {
+    return false;
+  }
+
+  return isInRange(narrowRanges, codePoint);
+};
+
+export const isWide = (codePoint: number): boolean => {
+  if (codePoint >= wideFastPathStart && codePoint <= wideFastPathEnd) {
+    return true;
+  }
+
+  if (codePoint < wideMinimalCodePoint || codePoint > wideMaximumCodePoint) {
+    return false;
+  }
+
+  return isInRange(wideRanges, codePoint);
+};
+
+export function getCategory(codePoint: number): EastAsianWidthType {
+  if (isAmbiguous(codePoint)) {
+    return "ambiguous";
+  }
+
+  if (isFullWidth(codePoint)) {
+    return "fullwidth";
+  }
+
+  if (isHalfWidth(codePoint)) {
+    return "halfwidth";
+  }
+
+  if (isNarrow(codePoint)) {
+    return "narrow";
+  }
+
+  if (isWide(codePoint)) {
+    return "wide";
+  }
+
+  return "neutral";
+}
+
+export function eastAsianWidthType(codePoint: number): EastAsianWidthType {
+  return getCategory(codePoint);
+}
+
+export function eastAsianWidth(
+  codePoint: number,
+  { ambiguousAsWide = false }: { ambiguousAsWide?: boolean } = {},
+): 1 | 2 {
+  if (isFullWidth(codePoint) || isWide(codePoint) || (ambiguousAsWide && isAmbiguous(codePoint))) {
+    return 2;
+  }
+
+  return 1;
+}
+
+export function isFullwidthCodePoint(codePoint: number): boolean {
+  if (!Number.isInteger(codePoint)) {
+    return false;
+  }
+
+  return isFullWidth(codePoint) || isWide(codePoint);
+}

package/src/ansi/escapes.ts

@@ -0,0 +1,128 @@
+import os from "node:os";
+// Derived from `ansi-escapes` (MIT, Sindre Sorhus), reduced to the escapes Ink uses.
+import process from "node:process";
+
+// Control characters and sequence introducers. This module is the single
+// home for escape sequences: everything else imports these instead of
+// spelling out `\u001B[...` inline.
+export const ESC = "\u001B";
+export const BEL = "\u0007";
+export const DEL = "\u007F";
+/** Control Sequence Introducer. */
+export const CSI = `${ESC}[`;
+/** Operating System Command. */
+export const OSC = `${ESC}]`;
+/** String Terminator. */
+export const ST = `${ESC}\\`;
+/** Single-byte C1 forms of CSI and ST. */
+export const C1_CSI = "\u009B";
+export const C1_ST = "\u009C";
+
+const sep = ";";
+
+export const cursorTo = (x: number, y?: number): string => {
+  if (typeof y !== "number") {
+    return CSI + (x + 1) + "G";
+  }
+
+  return CSI + (y + 1) + sep + (x + 1) + "H";
+};
+
+export const cursorUp = (count = 1): string => CSI + count + "A";
+export const cursorDown = (count = 1): string => CSI + count + "B";
+export const cursorLeft = CSI + "G";
+export const cursorNextLine = CSI + "E";
+
+export const eraseEndLine = CSI + "K";
+export const eraseLine = CSI + "2K";
+export const eraseScreen = CSI + "2J";
+
+export const eraseLines = (count: number): string => {
+  let clear = "";
+
+  for (let i = 0; i < count; i++) {
+    clear += eraseLine + (i < count - 1 ? cursorUp() : "");
+  }
+
+  if (count) {
+    clear += cursorLeft;
+  }
+
+  return clear;
+};
+
+// Windows 10 builds before 10586 don't support the `3J` escape.
+const isOldWindows = (): boolean => {
+  if (process.platform !== "win32") {
+    return false;
+  }
+
+  const parts = os.release().split(".");
+  const major = Number(parts[0]);
+  const build = Number(parts[2] ?? 0);
+
+  if (major < 10) {
+    return true;
+  }
+
+  return major === 10 && build < 10_586;
+};
+
+export const clearTerminal = isOldWindows()
+  ? `${eraseScreen}${CSI}0f`
+  : // 1. Erases the screen (only done in case `2` is not supported)
+    // 2. Erases the whole screen including scrollback buffer
+    // 3. Moves cursor to the top-left position
+    `${eraseScreen}${CSI}3J${CSI}H`;
+
+export const enterAlternativeScreen = CSI + "?1049h";
+export const exitAlternativeScreen = CSI + "?1049l";
+
+export const cursorShow = CSI + "?25h";
+export const cursorHide = CSI + "?25l";
+
+export const enableBracketedPaste = CSI + "?2004h";
+export const disableBracketedPaste = CSI + "?2004l";
+
+// Markers the terminal wraps around pasted input while bracketed paste is on.
+export const pasteStart = CSI + "200~";
+export const pasteEnd = CSI + "201~";
+
+// Synchronized update mode (DEC mode 2026): begin / end synchronized update.
+export const bsu = CSI + "?2026h";
+export const esu = CSI + "?2026l";
+
+// Kitty keyboard protocol: query support, push a flag set, pop it off.
+export const kittyQuery = CSI + "?u";
+export const pushKittyKeyboard = (flags: number): string => `${CSI}>${flags}u`;
+export const popKittyKeyboard = CSI + "<u";
+
+export const link = (text: string, url: string): string =>
+  [OSC, "8", sep, sep, url, BEL, text, OSC, "8", sep, sep, BEL].join("");
+
+export const ansiEscapes = {
+  cursorTo,
+  cursorUp,
+  cursorDown,
+  cursorLeft,
+  cursorNextLine,
+  eraseEndLine,
+  eraseLine,
+  eraseScreen,
+  eraseLines,
+  clearTerminal,
+  enterAlternativeScreen,
+  exitAlternativeScreen,
+  cursorShow,
+  cursorHide,
+  enableBracketedPaste,
+  disableBracketedPaste,
+  pasteStart,
+  pasteEnd,
+  bsu,
+  esu,
+  kittyQuery,
+  pushKittyKeyboard,
+  popKittyKeyboard,
+  link,
+};