ptywright 0.1.0 → 0.2.0

package/src/terminal/style.ts

@@ -1,121 +0,0 @@
-import type { Terminal } from "@xterm/headless";
-
-export type Color =
-  | { mode: "default" }
-  | { mode: "palette"; value: number }
-  | { mode: "rgb"; value: number };
-
-export type CellStyle = {
-  fg: Color;
-  bg: Color;
-  bold: boolean;
-  dim: boolean;
-  italic: boolean;
-  underline: boolean;
-  inverse: boolean;
-  strikethrough: boolean;
-};
-
-export const DEFAULT_STYLE: CellStyle = {
-  fg: { mode: "default" },
-  bg: { mode: "default" },
-  bold: false,
-  dim: false,
-  italic: false,
-  underline: false,
-  inverse: false,
-  strikethrough: false,
-};
-
-export function extractStyle(
-  cell: ReturnType<Terminal["buffer"]["active"]["getNullCell"]>,
-): CellStyle {
-  const fg = extractColor(
-    cell.isFgDefault(),
-    cell.isFgPalette(),
-    cell.isFgRGB(),
-    cell.getFgColor(),
-  );
-  const bg = extractColor(
-    cell.isBgDefault(),
-    cell.isBgPalette(),
-    cell.isBgRGB(),
-    cell.getBgColor(),
-  );
-
-  const style: CellStyle = {
-    fg,
-    bg,
-    bold: cell.isBold() !== 0,
-    dim: cell.isDim() !== 0,
-    italic: cell.isItalic() !== 0,
-    underline: cell.isUnderline() !== 0,
-    inverse: cell.isInverse() !== 0,
-    strikethrough: cell.isStrikethrough() !== 0,
-  };
-
-  return isDefaultStyle(style) ? DEFAULT_STYLE : style;
-}
-
-export function isDefaultStyle(style: CellStyle): boolean {
-  return (
-    style.fg.mode === "default" &&
-    style.bg.mode === "default" &&
-    !style.bold &&
-    !style.dim &&
-    !style.italic &&
-    !style.underline &&
-    !style.inverse &&
-    !style.strikethrough
-  );
-}
-
-export function styleKey(style: CellStyle): string {
-  const fg = style.fg.mode === "default" ? "d" : `${style.fg.mode}:${style.fg.value}`;
-  const bg = style.bg.mode === "default" ? "d" : `${style.bg.mode}:${style.bg.value}`;
-  return [
-    fg,
-    bg,
-    style.bold ? "b" : "",
-    style.dim ? "d" : "",
-    style.italic ? "i" : "",
-    style.underline ? "u" : "",
-    style.inverse ? "r" : "",
-    style.strikethrough ? "s" : "",
-  ].join("|");
-}
-
-export function findMeaningfulEndCol(
-  line: ReturnType<Terminal["buffer"]["active"]["getLine"]>,
-  cols: number,
-  nullCell: ReturnType<Terminal["buffer"]["active"]["getNullCell"]>,
-): number {
-  if (!line) return 0;
-
-  for (let x = cols - 1; x >= 0; x -= 1) {
-    const cell = line.getCell(x, nullCell);
-    if (!cell) continue;
-    if (cell.getWidth() === 0) continue;
-
-    const chars = cell.getChars();
-    const style = extractStyle(cell);
-    const meaningful = (chars !== "" && chars !== " ") || !isDefaultStyle(style);
-    if (meaningful) {
-      return x + 1;
-    }
-  }
-
-  return 0;
-}
-
-function extractColor(
-  isDefault: boolean,
-  isPalette: boolean,
-  isRgb: boolean,
-  value: number,
-): Color {
-  if (isDefault) return { mode: "default" };
-  if (isRgb) return { mode: "rgb", value };
-  if (isPalette) return { mode: "palette", value };
-  return { mode: "default" };
-}

package/src/terminal/view.ts

@@ -1,49 +0,0 @@
-import type { SnapshotScope } from "./snapshot";
-
-export type TerminalMeta = {
-  cols: number;
-  rows: number;
-  bufferType: "normal" | "alternate";
-  viewportY: number;
-  baseY: number;
-  length: number;
-  cursorX: number;
-  cursorY: number;
-};
-
-export type SnapshotViewOptions = {
-  sessionId: string;
-  scope: SnapshotScope;
-  hash: string;
-  lines: string[];
-  meta: TerminalMeta;
-  lineNumbers?: boolean;
-};
-
-export function formatSnapshotView(options: SnapshotViewOptions): string {
-  const lineNumbers = options.lineNumbers ?? true;
-
-  const cursorAbsY = options.meta.baseY + options.meta.cursorY;
-  const cursorViewportRow = cursorAbsY - options.meta.viewportY;
-  const cursorViewportCol = options.meta.cursorX;
-
-  const header = [
-    `session=${options.sessionId}`,
-    `scope=${options.scope}`,
-    `size=${options.meta.cols}x${options.meta.rows}`,
-    `buffer=${options.meta.bufferType}`,
-    `cursor=${cursorViewportCol + 1},${cursorViewportRow + 1}`,
-    `hash=${options.hash}`,
-  ].join(" ");
-
-  const digits = Math.max(2, String(options.lines.length).length);
-  const out: string[] = [header];
-
-  for (let i = 0; i < options.lines.length; i += 1) {
-    const n = i + 1;
-    const prefix = lineNumbers ? `${String(n).padStart(digits, "0")}│ ` : "";
-    out.push(`${prefix}${options.lines[i] ?? ""}`);
-  }
-
-  return out.join("\n");
-}

package/src/trace/asciicast.ts

@@ -1,20 +0,0 @@
-export type AsciicastHeader = {
-  version: 2;
-  width: number;
-  height: number;
-  timestamp?: number;
-  env?: Record<string, string>;
-  title?: string;
-  command?: string;
-  term?: string;
-};
-
-export type AsciicastEvent = [timeSeconds: number, type: "o" | "i" | "m" | "r", data: string];
-
-export function encodeAsciicast(header: AsciicastHeader, events: AsciicastEvent[]): string {
-  const lines: string[] = [JSON.stringify(header)];
-  for (const event of events) {
-    lines.push(JSON.stringify(event));
-  }
-  return `${lines.join("\n")}\n`;
-}

package/src/trace/asciinema_player_assets.ts

@@ -1,44 +0,0 @@
-import { copyFileSync, existsSync, mkdirSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { createRequire } from "node:module";
-
-export type EnsureAsciinemaPlayerAssetsResult = {
-  ok: boolean;
-  copied: boolean;
-  cssPath: string;
-  jsPath: string;
-  error?: string;
-};
-
-export function ensureAsciinemaPlayerAssets(reportPath: string): EnsureAsciinemaPlayerAssetsResult {
-  const dir = dirname(reportPath);
-  const cssPath = join(dir, "asciinema-player.css");
-  const jsPath = join(dir, "asciinema-player.min.js");
-
-  const cssExists = existsSync(cssPath);
-  const jsExists = existsSync(jsPath);
-  if (cssExists && jsExists) {
-    return { ok: true, copied: false, cssPath, jsPath };
-  }
-
-  try {
-    mkdirSync(dir, { recursive: true });
-
-    const require = createRequire(import.meta.url);
-    const resolvedCss = require.resolve("asciinema-player/dist/bundle/asciinema-player.css");
-    const resolvedJs = require.resolve("asciinema-player/dist/bundle/asciinema-player.min.js");
-
-    if (!cssExists) copyFileSync(resolvedCss, cssPath);
-    if (!jsExists) copyFileSync(resolvedJs, jsPath);
-
-    return { ok: true, copied: true, cssPath, jsPath };
-  } catch (error) {
-    return {
-      ok: false,
-      copied: false,
-      cssPath,
-      jsPath,
-      error: (error as Error).message,
-    };
-  }
-}

package/src/trace/cast_to_txt.ts

@@ -1,116 +0,0 @@
-function parseArgs(argv: string[]): { inPath: string; outPath?: string; stripAnsi: boolean } {
-  const out: Partial<{ inPath: string; outPath?: string; stripAnsi: boolean }> = {
-    stripAnsi: true,
-  };
-
-  for (let i = 0; i < argv.length; i += 1) {
-    const arg = argv[i];
-    const next = argv[i + 1];
-
-    if (!out.inPath && arg && !arg.startsWith("-")) {
-      out.inPath = arg;
-      continue;
-    }
-
-    if (arg === "--in" && next) {
-      out.inPath = next;
-      i += 1;
-      continue;
-    }
-
-    if (arg === "--out" && next) {
-      out.outPath = next;
-      i += 1;
-      continue;
-    }
-
-    if (arg === "--strip-ansi") {
-      out.stripAnsi = true;
-      continue;
-    }
-
-    if (arg === "--keep-ansi") {
-      out.stripAnsi = false;
-      continue;
-    }
-
-    throw new Error(`unknown arg: ${arg ?? ""}`);
-  }
-
-  if (!out.inPath) throw new Error("missing <castPath> (or --in <path>)");
-  return out as { inPath: string; outPath?: string; stripAnsi: boolean };
-}
-
-type AsciicastHeader = {
-  version?: number;
-};
-
-type AsciicastEvent = [timeSeconds: number, type: "o" | "i" | "m" | "r", data: string];
-
-function stripAnsi(text: string): string {
-  // CSI: ESC [ ... @-~ (includes SGR, cursor, erase, etc)
-  // eslint-disable-next-line no-control-regex
-  const csi = /\u001b\[[0-?]*[ -/]*[@-~]/g;
-  // OSC: ESC ] ... BEL or ST (ESC \)
-  // eslint-disable-next-line no-control-regex
-  const osc = /\u001b\][\s\S]*?(?:\u0007|\u001b\\)/g;
-  // Two-byte escapes: SS3 (ESC O) + final
-  // eslint-disable-next-line no-control-regex
-  const ss3 = /\u001bO[@-~]/g;
-
-  return text.replace(osc, "").replace(csi, "").replace(ss3, "");
-}
-
-async function run(args: { inPath: string; outPath?: string; stripAnsi: boolean }): Promise<void> {
-  const input = await Bun.file(args.inPath).text();
-  const lines = input.split("\n").filter((l) => l.length > 0);
-  if (lines.length === 0) throw new Error("empty cast");
-
-  let header: AsciicastHeader | null = null;
-  try {
-    header = JSON.parse(lines[0] ?? "") as AsciicastHeader;
-  } catch {
-    throw new Error("invalid cast header JSON");
-  }
-
-  if (header?.version !== 2) {
-    throw new Error(`unsupported asciicast version: ${header?.version ?? "unknown"}`);
-  }
-
-  let out = "";
-  for (const line of lines.slice(1)) {
-    let parsed: unknown;
-    try {
-      parsed = JSON.parse(line);
-    } catch {
-      continue;
-    }
-
-    if (!Array.isArray(parsed) || parsed.length < 3) continue;
-    const event = parsed as Partial<AsciicastEvent>;
-    if (event[1] !== "o") continue;
-    if (typeof event[2] !== "string") continue;
-
-    out += event[2];
-  }
-
-  const rendered = args.stripAnsi ? stripAnsi(out) : out;
-
-  if (args.outPath) {
-    await Bun.write(args.outPath, rendered);
-  } else {
-    process.stdout.write(rendered);
-    if (!rendered.endsWith("\n")) process.stdout.write("\n");
-  }
-}
-
-if (import.meta.main) {
-  try {
-    const args = parseArgs(process.argv.slice(2));
-    await run(args);
-  } catch (error) {
-    // eslint-disable-next-line no-console
-    console.error((error as Error).message);
-    process.exitCode = 1;
-  }
-}

package/src/trace/recorder.ts

@@ -1,110 +0,0 @@
-import type { AsciicastEvent, AsciicastHeader } from "./asciicast";
-import { encodeAsciicast } from "./asciicast";
-
-export type TraceRecorderOptions = {
-  maxEvents?: number;
-  maxDataChars?: number;
-  mergeOutput?: boolean;
-  timePrecisionMs?: number;
-};
-
-export type TraceSnapshot = {
-  header: AsciicastHeader;
-  events: AsciicastEvent[];
-  cast: string;
-  droppedEvents: number;
-  droppedDataChars: number;
-};
-
-const DEFAULT_MAX_EVENTS = 50_000;
-const DEFAULT_MAX_DATA_CHARS = 5_000_000;
-const DEFAULT_TIME_PRECISION_MS = 1;
-
-export class TraceRecorder {
-  private readonly header: AsciicastHeader;
-  private readonly startedAtMs: number;
-  private readonly maxEvents: number;
-  private readonly maxDataChars: number;
-  private readonly mergeOutput: boolean;
-  private readonly timePrecisionMs: number;
-
-  private readonly events: AsciicastEvent[] = [];
-  private dataChars = 0;
-  private droppedEvents = 0;
-  private droppedDataChars = 0;
-
-  constructor(header: AsciicastHeader, options?: TraceRecorderOptions) {
-    this.header = header;
-    this.startedAtMs = performance.now();
-    this.maxEvents = Math.max(1, Math.trunc(options?.maxEvents ?? DEFAULT_MAX_EVENTS));
-    this.maxDataChars = Math.max(1, Math.trunc(options?.maxDataChars ?? DEFAULT_MAX_DATA_CHARS));
-    this.mergeOutput = options?.mergeOutput ?? true;
-    this.timePrecisionMs = Math.max(
-      1,
-      Math.trunc(options?.timePrecisionMs ?? DEFAULT_TIME_PRECISION_MS),
-    );
-  }
-
-  recordOutput(data: string): void {
-    this.addEvent("o", data);
-  }
-
-  recordInput(data: string): void {
-    this.addEvent("i", data);
-  }
-
-  recordResize(cols: number, rows: number): void {
-    this.addEvent("r", `${cols}x${rows}`);
-  }
-
-  mark(label?: string): void {
-    this.addEvent("m", label ?? "");
-  }
-
-  snapshot(options?: { tailEvents?: number }): TraceSnapshot {
-    const tailEvents = options?.tailEvents;
-    const events = tailEvents
-      ? this.events.slice(-Math.max(0, Math.trunc(tailEvents)))
-      : [...this.events];
-    return {
-      header: this.header,
-      events,
-      cast: encodeAsciicast(this.header, events),
-      droppedEvents: this.droppedEvents,
-      droppedDataChars: this.droppedDataChars,
-    };
-  }
-
-  private addEvent(type: AsciicastEvent[1], data: string): void {
-    const timeSeconds = this.nowSeconds();
-
-    const last = this.events.at(-1);
-    if (this.mergeOutput && type === "o" && last && last[1] === "o" && last[0] === timeSeconds) {
-      last[2] += data;
-      this.dataChars += data.length;
-      this.trim();
-      return;
-    }
-
-    this.events.push([timeSeconds, type, data]);
-    this.dataChars += data.length;
-    this.trim();
-  }
-
-  private nowSeconds(): number {
-    const elapsedMs = performance.now() - this.startedAtMs;
-    const quantized = Math.round(elapsedMs / this.timePrecisionMs) * this.timePrecisionMs;
-    return quantized / 1000;
-  }
-
-  private trim(): void {
-    while (this.events.length > this.maxEvents || this.dataChars > this.maxDataChars) {
-      const removed = this.events.shift();
-      if (!removed) break;
-      const chars = removed[2].length;
-      this.dataChars -= chars;
-      this.droppedEvents += 1;
-      this.droppedDataChars += chars;
-    }
-  }
-}