Function clampCommentLines

src/codeScan/util/diffLineRanges.ts:240–294

(
  filepath: string,
  startLine: number | null | undefined,
  endLine: number | null | undefined,
  ranges: FileLineRanges,
)

 * @returns Clamped line numbers, or null if file not in diff
 */
export function clampCommentLines(
  filepath: string,
  startLine: number | null | undefined,
  endLine: number | null | undefined,
  ranges: FileLineRanges,
): ClampedLines | null {
  const fileRanges = ranges.get(filepath);
  if (!fileRanges || fileRanges.length === 0 || endLine == null) {
    return null;
  }

  // Clamp the end line
  const clampedEndLine = clampToValidLine(filepath, endLine, ranges);
  if (clampedEndLine === null) {
    return null;
  }

  // If no start line, it's a single-line comment
  if (startLine == null) {
    return {
      startLine: null,
      line: clampedEndLine,
    };
  }

  // Clamp the start line
  const clampedStartLine = clampToValidLine(filepath, startLine, ranges);
  if (clampedStartLine === null) {
    return {
      startLine: null,
      line: clampedEndLine,
    };
  }

  // Ensure start <= end (if start > end after clamping, make it single-line)
  if (clampedStartLine > clampedEndLine) {
    return {
      startLine: null,
      line: clampedEndLine,
    };
  }

  // If start and end are the same, make it single-line
  if (clampedStartLine === clampedEndLine) {
    return {
      startLine: null,
      line: clampedEndLine,
    };
  }

  return {
    startLine: clampedStartLine,
    line: clampedEndLine,
  };
}