Class LinkDetector

lib/link-detector.ts:14–219

 * Manages link detection across multiple providers with intelligent caching
 */
export class LinkDetector {
  private providers: ILinkProvider[] = [];

  // Cache links by hyperlink_id for fast lookups
  // Key format: `h${hyperlinkId}` for OSC 8 links
  // Key format: `r${row}:${startX}-${endX}` for regex links (future)
  private linkCache = new Map<string, ILink>();

  // Track which rows have been scanned to avoid redundant provider calls
  private scannedRows = new Set<number>();

  // Terminal instance for buffer access
  constructor(private terminal: ITerminalForLinkDetector) {}

  /**
   * Register a link provider
   */
  registerProvider(provider: ILinkProvider): void {
    this.providers.push(provider);
    this.invalidateCache(); // New provider may detect different links
  }

  /**
   * Get link at the specified buffer position
   * @param col Column (0-based)
   * @param row Absolute row in buffer (0-based)
   * @returns Link at position, or undefined if none
   */
  async getLinkAt(col: number, row: number): Promise<ILink | undefined> {
    // First, check if this cell has a hyperlink_id (fast path for OSC 8)
    const line = this.terminal.buffer.active.getLine(row);
    if (!line || col < 0 || col >= line.length) {
      return undefined;
    }

    const cell = line.getCell(col);
    if (!cell) {
      return undefined;
    }
    const hyperlinkId = cell.getHyperlinkId();

    if (hyperlinkId > 0) {
      // Fast path: check cache by hyperlink_id
      const cacheKey = `h${hyperlinkId}`;
      if (this.linkCache.has(cacheKey)) {
        return this.linkCache.get(cacheKey);
      }
    }

    // Slow path: scan this row if not already scanned
    if (!this.scannedRows.has(row)) {
      await this.scanRow(row);
    }

    // Check cache again (hyperlinkId or position-based)
    if (hyperlinkId > 0) {
      const cacheKey = `h${hyperlinkId}`;
      const link = this.linkCache.get(cacheKey);