ptywright 0.1.1 → 0.3.0

package/src/terminal/ansi.ts

@@ -1,142 +0,0 @@
-import type { Terminal } from "@xterm/headless";
-
-import type { SnapshotScope } from "./snapshot";
-import type { CellStyle } from "./style";
-import {
-  DEFAULT_STYLE,
-  extractStyle,
-  findMeaningfulEndCol,
-  isDefaultStyle,
-  styleKey,
-} from "./style";
-
-export type AnsiRenderedLine = {
-  ansi: string;
-  plain: string;
-  hasStyle: boolean;
-};
-
-export type SnapshotAnsiOptions = {
-  scope?: SnapshotScope;
-  trimRight?: boolean;
-};
-
-const ESC = "\x1b";
-const SGR_RESET = `${ESC}[0m`;
-
-export function renderAnsiLines(
-  terminal: Terminal,
-  options?: SnapshotAnsiOptions,
-): AnsiRenderedLine[] {
-  const scope = options?.scope ?? "visible";
-  const trimRight = options?.trimRight ?? false;
-
-  const buffer = terminal.buffer.active;
-  const nullCell = buffer.getNullCell();
-
-  let startY = 0;
-  let count = buffer.length;
-  if (scope === "visible") {
-    startY = buffer.viewportY;
-    count = terminal.rows;
-  }
-
-  const out: AnsiRenderedLine[] = [];
-  for (let i = 0; i < count; i += 1) {
-    const y = startY + i;
-    const line = buffer.getLine(y);
-    out.push(renderLine(line, terminal.cols, nullCell, trimRight));
-  }
-
-  return out;
-}
-
-function renderLine(
-  line: ReturnType<Terminal["buffer"]["active"]["getLine"]>,
-  cols: number,
-  nullCell: ReturnType<Terminal["buffer"]["active"]["getNullCell"]>,
-  trimRight: boolean,
-): AnsiRenderedLine {
-  let endCol = cols;
-  if (trimRight) {
-    endCol = findMeaningfulEndCol(line, cols, nullCell);
-  }
-
-  let ansi = "";
-  let plain = "";
-  let hasStyle = false;
-  let usedSgr = false;
-
-  const defaultKey = styleKey(DEFAULT_STYLE);
-  let currentKey = defaultKey;
-  for (let x = 0; x < endCol; x += 1) {
-    const cell = line?.getCell(x, nullCell);
-    if (!cell) {
-      plain += " ";
-      ansi += " ";
-      continue;
-    }
-
-    const width = cell.getWidth();
-    if (width === 0) {
-      continue;
-    }
-
-    const chars = cell.getChars() || " ";
-    const style = extractStyle(cell);
-    const isDefault = isDefaultStyle(style);
-    if (!isDefault) {
-      hasStyle = true;
-    }
-
-    const key = styleKey(style);
-    if (key !== currentKey) {
-      ansi += isDefault ? SGR_RESET : toSgr(style);
-      usedSgr = true;
-      currentKey = key;
-    }
-
-    ansi += chars;
-    plain += chars;
-  }
-
-  if (usedSgr && currentKey !== defaultKey) {
-    ansi += SGR_RESET;
-  }
-
-  return { ansi, plain, hasStyle };
-}
-
-function toSgr(style: CellStyle): string {
-  const codes: string[] = ["0"];
-
-  if (style.bold) codes.push("1");
-  if (style.dim) codes.push("2");
-  if (style.italic) codes.push("3");
-  if (style.underline) codes.push("4");
-  if (style.inverse) codes.push("7");
-  if (style.strikethrough) codes.push("9");
-
-  if (style.fg.mode === "palette") {
-    codes.push(`38;5;${style.fg.value}`);
-  } else if (style.fg.mode === "rgb") {
-    const [r, g, b] = rgb(style.fg.value);
-    codes.push(`38;2;${r};${g};${b}`);
-  }
-
-  if (style.bg.mode === "palette") {
-    codes.push(`48;5;${style.bg.value}`);
-  } else if (style.bg.mode === "rgb") {
-    const [r, g, b] = rgb(style.bg.value);
-    codes.push(`48;2;${r};${g};${b}`);
-  }
-
-  return `${ESC}[${codes.join(";")}m`;
-}
-
-function rgb(value: number): [number, number, number] {
-  const r = (value >> 16) & 0xff;
-  const g = (value >> 8) & 0xff;
-  const b = value & 0xff;
-  return [r, g, b];
-}

package/src/terminal/keys.ts

@@ -1,180 +0,0 @@
-const CSI = "\x1b[";
-const SS3 = "\x1bO";
-
-function ctrlChar(letter: string): string {
-  const upper = letter.toUpperCase();
-  const code = upper.charCodeAt(0);
-  if (code < 65 || code > 90) {
-    throw new Error(`Unsupported ctrl key: ${letter}`);
-  }
-  return String.fromCharCode(code - 64);
-}
-
-export function encodeKey(key: string): string {
-  const normalized = key.trim();
-
-  if (normalized.length === 1) {
-    return normalized;
-  }
-
-  // Back-compat: "c-x" style.
-  const ctrlMatch = /^c-(.)$/i.exec(normalized);
-  if (ctrlMatch) {
-    return ctrlChar(ctrlMatch[1] ?? "");
-  }
-
-  const parsed = parseKeySpec(normalized);
-  const mod = modifierParam(parsed.modifiers);
-
-  const keyName = parsed.key.toLowerCase();
-
-  if (keyName === "enter" || keyName === "return") return "\r";
-  if (keyName === "esc" || keyName === "escape") return "\x1b";
-  if (keyName === "backspace") return "\x7f";
-
-  if (keyName === "space") return " ";
-
-  if (keyName === "tab") {
-    return parsed.modifiers.shift ? `${CSI}Z` : "\t";
-  }
-
-  if (keyName === "backtab" || keyName === "btab") {
-    return `${CSI}Z`;
-  }
-
-  const arrowFinal = arrowKeyFinal(keyName);
-  if (arrowFinal) {
-    if (mod === null) return `${CSI}${arrowFinal}`;
-    return `${CSI}1;${mod}${arrowFinal}`;
-  }
-
-  const homeEndFinal = homeEndFinalChar(keyName);
-  if (homeEndFinal) {
-    if (mod === null) return `${CSI}${homeEndFinal}`;
-    return `${CSI}1;${mod}${homeEndFinal}`;
-  }
-
-  const tildeCode = tildeKeyCode(keyName);
-  if (tildeCode) {
-    if (mod === null) return `${CSI}${tildeCode}~`;
-    return `${CSI}${tildeCode};${mod}~`;
-  }
-
-  const functionKey = functionKeySpec(keyName);
-  if (functionKey) {
-    if (mod === null) return functionKey.base;
-    return functionKey.modified(mod);
-  }
-
-  // Ctrl/Alt modifiers for single characters.
-  if (parsed.key.length === 1) {
-    let outChar = parsed.key;
-    if (parsed.modifiers.shift && /^[a-z]$/i.test(outChar)) {
-      outChar = outChar.toUpperCase();
-    }
-
-    let encoded = outChar;
-    if (parsed.modifiers.ctrl && /^[a-z]$/i.test(outChar)) {
-      encoded = ctrlChar(outChar);
-    }
-    if (parsed.modifiers.alt) {
-      encoded = `\x1b${encoded}`;
-    }
-    return encoded;
-  }
-
-  throw new Error(`Unsupported key: ${key}`);
-}
-
-type KeyModifiers = { shift: boolean; alt: boolean; ctrl: boolean };
-
-function parseKeySpec(spec: string): { modifiers: KeyModifiers; key: string } {
-  const tokens = spec
-    .trim()
-    .split(/[+-]/g)
-    .map((t) => t.trim())
-    .filter(Boolean);
-
-  const modifiers: KeyModifiers = { shift: false, alt: false, ctrl: false };
-  const keys: string[] = [];
-
-  for (const token of tokens) {
-    const lower = token.toLowerCase();
-    if (lower === "shift") {
-      modifiers.shift = true;
-      continue;
-    }
-    if (lower === "alt" || lower === "meta") {
-      modifiers.alt = true;
-      continue;
-    }
-    if (lower === "ctrl" || lower === "control") {
-      modifiers.ctrl = true;
-      continue;
-    }
-    keys.push(token);
-  }
-
-  const key = keys.join("+").trim();
-  if (!key) throw new Error(`Unsupported key: ${spec}`);
-  return { modifiers, key };
-}
-
-function modifierParam(mods: KeyModifiers): number | null {
-  if (!mods.shift && !mods.alt && !mods.ctrl) return null;
-  return 1 + (mods.shift ? 1 : 0) + (mods.alt ? 2 : 0) + (mods.ctrl ? 4 : 0);
-}
-
-function arrowKeyFinal(key: string): "A" | "B" | "C" | "D" | null {
-  if (key === "up") return "A";
-  if (key === "down") return "B";
-  if (key === "right") return "C";
-  if (key === "left") return "D";
-  return null;
-}
-
-function homeEndFinalChar(key: string): "H" | "F" | null {
-  if (key === "home") return "H";
-  if (key === "end") return "F";
-  return null;
-}
-
-function tildeKeyCode(key: string): "5" | "6" | "2" | "3" | null {
-  if (key === "pageup" || key === "pgup") return "5";
-  if (key === "pagedown" || key === "pgdn") return "6";
-  if (key === "insert" || key === "ins") return "2";
-  if (key === "delete" || key === "del") return "3";
-  return null;
-}
-
-function functionKeySpec(key: string): { base: string; modified: (mod: number) => string } | null {
-  const match = /^f(\d{1,2})$/.exec(key);
-  if (!match) return null;
-
-  const n = Number(match[1]);
-  if (!Number.isFinite(n) || n < 1 || n > 12) return null;
-
-  // F1..F4
-  if (n === 1) return { base: `${SS3}P`, modified: (m) => `${CSI}1;${m}P` };
-  if (n === 2) return { base: `${SS3}Q`, modified: (m) => `${CSI}1;${m}Q` };
-  if (n === 3) return { base: `${SS3}R`, modified: (m) => `${CSI}1;${m}R` };
-  if (n === 4) return { base: `${SS3}S`, modified: (m) => `${CSI}1;${m}S` };
-
-  const tildeCodes: Record<number, string> = {
-    5: "15",
-    6: "17",
-    7: "18",
-    8: "19",
-    9: "20",
-    10: "21",
-    11: "23",
-    12: "24",
-  };
-  const code = tildeCodes[n];
-  if (!code) return null;
-
-  return {
-    base: `${CSI}${code}~`,
-    modified: (m) => `${CSI}${code};${m}~`,
-  };
-}

package/src/terminal/mask.ts

@@ -1,70 +0,0 @@
-export type TextMaskRule = {
-  regex: string;
-  flags?: string;
-  replacement?: string;
-  preserveLength?: boolean;
-};
-
-type CompiledMaskRule = {
-  regex: RegExp;
-  replacement: string;
-  preserveLength: boolean;
-};
-
-export function applyTextMaskRules(lines: string[], rules?: TextMaskRule[]): string[] {
-  if (!rules || rules.length === 0) return lines;
-
-  const compiled = compileMaskRules(rules);
-  if (compiled.length === 0) return lines;
-
-  return lines.map((line) => applyCompiledMaskRules(line, compiled));
-}
-
-function compileMaskRules(rules: TextMaskRule[]): CompiledMaskRule[] {
-  const compiled: CompiledMaskRule[] = [];
-
-  for (const rule of rules) {
-    if (!rule.regex.trim()) continue;
-
-    const preserveLength = rule.preserveLength ?? false;
-    const replacement = preserveLength
-      ? firstChar(rule.replacement)
-      : (rule.replacement ?? "<masked>");
-
-    const flags = normalizeFlags(rule.flags);
-    let regex: RegExp;
-    try {
-      regex = new RegExp(rule.regex, flags);
-    } catch (error) {
-      throw new Error(
-        `invalid mask rule regex=${JSON.stringify(rule.regex)} flags=${JSON.stringify(rule.flags ?? "")}: ${(error as Error).message}`,
-      );
-    }
-
-    compiled.push({ regex, replacement, preserveLength });
-  }
-
-  return compiled;
-}
-
-function normalizeFlags(flags?: string): string {
-  const value = flags?.trim() ? flags.trim() : "g";
-  const set = new Set(value.split(""));
-  set.add("g");
-  return [...set].join("");
-}
-
-function firstChar(value?: string): string {
-  const trimmed = value?.trim();
-  return trimmed && trimmed.length > 0 ? trimmed[0] : "█";
-}
-
-function applyCompiledMaskRules(line: string, rules: CompiledMaskRule[]): string {
-  let out = line;
-  for (const rule of rules) {
-    out = out.replace(rule.regex, (match) =>
-      rule.preserveLength ? rule.replacement.repeat(match.length) : rule.replacement,
-    );
-  }
-  return out;
-}

package/src/terminal/mouse.ts

@@ -1,75 +0,0 @@
-const ESC = "\x1b";
-
-export type MouseButton = "left" | "middle" | "right";
-
-export type MouseAction = "down" | "up" | "move" | "click" | "scroll_up" | "scroll_down";
-
-export type MouseModifiers = {
-  shift?: boolean;
-  alt?: boolean;
-  ctrl?: boolean;
-};
-
-export type MouseEvent = {
-  action: MouseAction;
-  x: number;
-  y: number;
-  button?: MouseButton;
-  modifiers?: MouseModifiers;
-};
-
-export function encodeSgrMouse(event: MouseEvent): string {
-  const x = clampInt(event.x, 1, 500);
-  const y = clampInt(event.y, 1, 300);
-
-  if (event.action === "click") {
-    const press = encodeSingleSgrMouse({ ...event, action: "down" }, x, y);
-    const release = encodeSingleSgrMouse({ ...event, action: "up" }, x, y);
-    return `${press}${release}`;
-  }
-
-  return encodeSingleSgrMouse(event, x, y);
-}
-
-function encodeSingleSgrMouse(event: MouseEvent, x: number, y: number): string {
-  const modifiers = event.modifiers;
-  const modifierBits =
-    (modifiers?.shift ? 4 : 0) + (modifiers?.alt ? 8 : 0) + (modifiers?.ctrl ? 16 : 0);
-
-  const buttonCode = buttonToCode(event.button ?? "left");
-
-  if (event.action === "down") {
-    return `${ESC}[<${buttonCode + modifierBits};${x};${y}M`;
-  }
-
-  if (event.action === "up") {
-    return `${ESC}[<${buttonCode + modifierBits};${x};${y}m`;
-  }
-
-  if (event.action === "scroll_up") {
-    return `${ESC}[<${64 + modifierBits};${x};${y}M`;
-  }
-
-  if (event.action === "scroll_down") {
-    return `${ESC}[<${65 + modifierBits};${x};${y}M`;
-  }
-
-  // move
-  // 32 indicates motion. When no button is pressed, use "3".
-  const motionButton = event.button ? buttonCode : 3;
-  return `${ESC}[<${32 + motionButton + modifierBits};${x};${y}M`;
-}
-
-function buttonToCode(button: MouseButton): number {
-  if (button === "left") return 0;
-  if (button === "middle") return 1;
-  return 2;
-}
-
-function clampInt(value: number, min: number, max: number): number {
-  if (!Number.isFinite(value)) return min;
-  const int = Math.trunc(value);
-  if (int < min) return min;
-  if (int > max) return max;
-  return int;
-}

package/src/terminal/snapshot.ts

@@ -1,196 +0,0 @@
-import type { Terminal } from "@xterm/headless";
-
-import type { CellStyle } from "./style";
-import { extractStyle, findMeaningfulEndCol, isDefaultStyle, styleKey } from "./style";
-
-export type SnapshotScope = "visible" | "buffer";
-
-export type TerminalSnapshotStyleRun = {
-  startCol: number;
-  endCol: number;
-  style: CellStyle;
-};
-
-export type TerminalSnapshotGrid = {
-  cols: number;
-  rows: number;
-  bufferType: "normal" | "alternate";
-  cursorX: number;
-  cursorY: number;
-  viewportY: number;
-  lines: string[];
-  styleRuns?: TerminalSnapshotStyleRun[][];
-};
-
-function snapshotVisibleLines(terminal: Terminal, trimRight: boolean): string[] {
-  const buffer = terminal.buffer.active;
-  const nullCell = buffer.getNullCell();
-
-  const startY = buffer.viewportY;
-  const lines: string[] = [];
-
-  for (let row = 0; row < terminal.rows; row += 1) {
-    const line = buffer.getLine(startY + row);
-    lines.push(snapshotPlainLine(line, terminal.cols, nullCell, trimRight));
-  }
-
-  return lines;
-}
-
-function snapshotVisibleStyleRuns(
-  terminal: Terminal,
-  trimRight: boolean,
-): TerminalSnapshotStyleRun[][] {
-  const buffer = terminal.buffer.active;
-  const nullCell = buffer.getNullCell();
-
-  const startY = buffer.viewportY;
-  const out: TerminalSnapshotStyleRun[][] = [];
-
-  for (let row = 0; row < terminal.rows; row += 1) {
-    const line = buffer.getLine(startY + row);
-    out.push(snapshotStyleRuns(line, terminal.cols, nullCell, trimRight));
-  }
-
-  return out;
-}
-
-function snapshotBufferLines(terminal: Terminal, trimRight: boolean): string[] {
-  const buffer = terminal.buffer.active;
-  const lines: string[] = [];
-  for (let y = 0; y < buffer.length; y += 1) {
-    const line = buffer.getLine(y);
-    lines.push(line ? line.translateToString(trimRight, 0, terminal.cols) : "");
-  }
-  return lines;
-}
-
-export function snapshotLines(
-  terminal: Terminal,
-  options?: { scope?: SnapshotScope; trimRight?: boolean },
-): string[] {
-  const trimRight = options?.trimRight ?? true;
-  const scope = options?.scope ?? "visible";
-  return scope === "buffer"
-    ? snapshotBufferLines(terminal, trimRight)
-    : snapshotVisibleLines(terminal, trimRight);
-}
-
-export function snapshotGrid(
-  terminal: Terminal,
-  options?: { trimRight?: boolean; includeStyles?: boolean },
-): TerminalSnapshotGrid {
-  const trimRight = options?.trimRight ?? true;
-  const includeStyles = options?.includeStyles ?? false;
-
-  const buffer = terminal.buffer.active;
-  const lines = snapshotVisibleLines(terminal, trimRight);
-
-  return {
-    cols: terminal.cols,
-    rows: terminal.rows,
-    bufferType: buffer.type,
-    cursorX: buffer.cursorX,
-    cursorY: buffer.cursorY,
-    viewportY: buffer.viewportY,
-    lines,
-    styleRuns: includeStyles ? snapshotVisibleStyleRuns(terminal, trimRight) : undefined,
-  };
-}
-
-function snapshotPlainLine(
-  line: ReturnType<Terminal["buffer"]["active"]["getLine"]>,
-  cols: number,
-  nullCell: ReturnType<Terminal["buffer"]["active"]["getNullCell"]>,
-  trimRight: boolean,
-): string {
-  let endCol = cols;
-  if (trimRight) {
-    endCol = findMeaningfulEndCol(line, cols, nullCell);
-  }
-
-  let out = "";
-  for (let x = 0; x < endCol; x += 1) {
-    const cell = line?.getCell(x, nullCell);
-    if (!cell) {
-      out += " ";
-      continue;
-    }
-
-    const width = cell.getWidth();
-    if (width === 0) {
-      continue;
-    }
-
-    out += cell.getChars() || " ";
-  }
-
-  return out;
-}
-
-function snapshotStyleRuns(
-  line: ReturnType<Terminal["buffer"]["active"]["getLine"]>,
-  cols: number,
-  nullCell: ReturnType<Terminal["buffer"]["active"]["getNullCell"]>,
-  trimRight: boolean,
-): TerminalSnapshotStyleRun[] {
-  let endCol = cols;
-  if (trimRight) {
-    endCol = findMeaningfulEndCol(line, cols, nullCell);
-  }
-
-  const out: TerminalSnapshotStyleRun[] = [];
-
-  let currentKey: string | null = null;
-  let currentRun: { startCol: number; endCol: number; style: CellStyle } | null = null;
-
-  for (let x = 0; x < endCol; x += 1) {
-    const cell = line?.getCell(x, nullCell);
-    if (!cell) {
-      if (currentRun) {
-        out.push(currentRun);
-        currentRun = null;
-        currentKey = null;
-      }
-      continue;
-    }
-
-    const width = cell.getWidth();
-    if (width === 0) {
-      continue;
-    }
-
-    const style = extractStyle(cell);
-    if (isDefaultStyle(style)) {
-      if (currentRun) {
-        out.push(currentRun);
-        currentRun = null;
-        currentKey = null;
-      }
-      continue;
-    }
-
-    const key = styleKey(style);
-    if (currentRun && key === currentKey) {
-      currentRun.endCol = x + width;
-      continue;
-    }
-
-    if (currentRun) {
-      out.push(currentRun);
-    }
-
-    currentKey = key;
-    currentRun = {
-      startCol: x,
-      endCol: x + width,
-      style,
-    };
-  }
-
-  if (currentRun) {
-    out.push(currentRun);
-  }
-
-  return out;
-}