Link terminal file paths to workspace previews (#1174)

2026-05-25 19:12:43 +08:00
parent 1e68283565
commit e40ad0c00e
12 changed files with 1098 additions and 7 deletions
@@ -0,0 +1,207 @@
+import type { IBufferCell, Terminal } from "@xterm/xterm";
+import { describe, expect, it, vi } from "vitest";
+import { createTerminalLocalFileLinkProvider } from "./terminal-local-link-provider";
+
+describe("createTerminalLocalFileLinkProvider", () => {
+  it("resolves before exposing a local file link", async () => {
+    const terminal = createTerminal(["file.ts:42"]);
+    const resolveLink = vi.fn(async () => ({ path: "/repo/src/file.ts", lineStart: 42 }));
+    const openLink = vi.fn();
+    const provider = createTerminalLocalFileLinkProvider(terminal, { resolveLink, openLink });
+
+    const links = await provideLinks(provider, 1);
+
+    expect(resolveLink).toHaveBeenCalledWith({
+      text: "file.ts:42",
+      path: "file.ts",
+      lineStart: 42,
+    });
+    expect(links).toHaveLength(1);
+    expect(links?.[0]?.text).toBe("file.ts:42");
+  });
+
+  it("decorates the full parsed link span", async () => {
+    const terminal = createTerminal(["echo README.md:5"]);
+    const provider = createTerminalLocalFileLinkProvider(terminal, {
+      resolveLink: vi.fn(async () => ({ path: "/repo/README.md", lineStart: 5 })),
+      openLink: vi.fn(),
+    });
+
+    const [link] = (await provideLinks(provider, 1)) ?? [];
+
+    expect(link?.range).toEqual({
+      start: { x: 6, y: 1 },
+      end: { x: 16, y: 1 },
+    });
+  });
+
+  it("opens resolved links with assistant-style disposition semantics", async () => {
+    const terminal = createTerminal(["src/file.ts:42"]);
+    const target = { path: "/repo/src/file.ts", lineStart: 42 };
+    const openLink = vi.fn();
+    const provider = createTerminalLocalFileLinkProvider(terminal, {
+      resolveLink: vi.fn(async () => target),
+      openLink,
+    });
+
+    const [link] = (await provideLinks(provider, 1)) ?? [];
+    link?.activate({ preventDefault: vi.fn(), ctrlKey: true } as unknown as MouseEvent, link.text);
+
+    expect(openLink).toHaveBeenCalledWith(target, "side", expect.anything());
+  });
+
+  it("does not expose unresolved candidates as links", async () => {
+    const terminal = createTerminal(["missing.ts:42"]);
+    const provider = createTerminalLocalFileLinkProvider(terminal, {
+      resolveLink: vi.fn(async () => null),
+      openLink: vi.fn(),
+    });
+
+    await expect(provideLinks(provider, 1)).resolves.toBeUndefined();
+  });
+});
+
+function provideLinks(
+  provider: ReturnType<typeof createTerminalLocalFileLinkProvider>,
+  bufferLineNumber: number,
+) {
+  return new Promise<Parameters<Parameters<typeof provider.provideLinks>[1]>[0]>((resolve) => {
+    provider.provideLinks(bufferLineNumber, resolve);
+  });
+}
+
+function createTerminal(lines: string[]): Terminal {
+  const bufferLines = lines.map((line) => new FakeBufferLine(line));
+  return {
+    cols: 80,
+    buffer: {
+      active: {
+        length: bufferLines.length,
+        getLine: (index: number) => bufferLines[index],
+        getNullCell: () => new FakeBufferCell(""),
+      },
+    },
+  } as unknown as Terminal;
+}
+
+class FakeBufferLine {
+  readonly isWrapped = false;
+  readonly length: number;
+
+  constructor(private readonly text: string) {
+    this.length = text.length;
+  }
+
+  getCell(x: number, cell?: IBufferCell): IBufferCell | undefined {
+    const value = this.text[x] ?? "";
+    if (cell instanceof FakeBufferCell) {
+      cell.setValue(value);
+      return cell as unknown as IBufferCell;
+    }
+    return new FakeBufferCell(value) as unknown as IBufferCell;
+  }
+
+  translateToString(): string {
+    return this.text;
+  }
+}
+
+class FakeBufferCell {
+  constructor(private value: string) {}
+
+  setValue(value: string): void {
+    this.value = value;
+  }
+
+  getChars(): string {
+    return this.value;
+  }
+
+  getWidth(): number {
+    return this.value ? 1 : 0;
+  }
+
+  getCode(): number {
+    return this.value.codePointAt(0) ?? 0;
+  }
+
+  getFgColorMode(): number {
+    return 0;
+  }
+
+  getBgColorMode(): number {
+    return 0;
+  }
+
+  getFgColor(): number {
+    return 0;
+  }
+
+  getBgColor(): number {
+    return 0;
+  }
+
+  isAttributeDefault(): boolean {
+    return true;
+  }
+
+  isFgDefault(): boolean {
+    return true;
+  }
+
+  isBgDefault(): boolean {
+    return true;
+  }
+
+  isFgRGB(): boolean {
+    return false;
+  }
+
+  isBgRGB(): boolean {
+    return false;
+  }
+
+  isFgPalette(): boolean {
+    return false;
+  }
+
+  isBgPalette(): boolean {
+    return false;
+  }
+
+  isBold(): boolean {
+    return false;
+  }
+
+  isItalic(): boolean {
+    return false;
+  }
+
+  isDim(): boolean {
+    return false;
+  }
+
+  isUnderline(): boolean {
+    return false;
+  }
+
+  isBlink(): boolean {
+    return false;
+  }
+
+  isInverse(): boolean {
+    return false;
+  }
+
+  isInvisible(): boolean {
+    return false;
+  }
+
+  isStrikethrough(): boolean {
+    return false;
+  }
+
+  isOverline(): boolean {
+    return false;
+  }
+}