resolveLinkSpanAt static method

ResolvedTerminalLink? resolveLinkSpanAt({
  1. required VirtualLineLookup lookup,
  2. required int col,
  3. required int virtualRow,
})

Resolves a hyperlink span at ([col], [virtualRow]) across soft-wrapped rows in lookup, preferring contiguous OSC 8 uris spans first and falling back to plain-text http://, https://, and mailto: tokens.

Implementation

static ResolvedTerminalLink? resolveLinkSpanAt({
  required VirtualLineLookup lookup,
  required int col,
  required int virtualRow,
}) {
  if (col < 0 || virtualRow < 0) return null;
  final clickedLine = lookup(virtualRow);
  if (clickedLine == null || col >= clickedLine.characters.length) {
    return null;
  }

  final snappedCol = col > 0 && clickedLine.characters[col].isEmpty
      ? col - 1
      : col;
  final (wrapStart, wrapEnd) = _softWrapBounds(lookup, virtualRow);
  final osc8Uri = _supportedOsc8UriAt(clickedLine, snappedCol);
  if (osc8Uri != null) {
    return _expandOsc8Span(
      lookup,
      osc8Uri,
      snappedCol,
      virtualRow,
      wrapStart,
      wrapEnd,
    );
  }

  if (clickedLine.characters[snappedCol].isEmpty) return null;
  return _matchPlainLinkSpan(
    lookup,
    snappedCol,
    virtualRow,
    wrapStart,
    wrapEnd,
  );
}