Function formatScreenshotDiffHints

src/utils/output.ts:500–525

(data: ScreenshotDiffResult)

}

function formatScreenshotDiffHints(data: ScreenshotDiffResult): string[] {
  const hints: string[] = [];
  const clusters = data.ocr?.movementClusters ?? [];
  for (const cluster of clusters.slice(0, 2)) {
    hints.push(
      `text movement cluster: ${formatQuotedList(cluster.texts)} dx=${formatRange(cluster.xRange)}px ` +
        `dy=${formatRange(cluster.yRange)}px`,
    );
  }

  const controlDeltas = (data.nonTextDeltas ?? [])
    .filter((delta) => ['icon', 'toggle', 'chevron'].includes(delta.likelyKind))
    .slice(0, 3);
  if (controlDeltas.length > 0) {
    hints.push(`non-text controls: ${controlDeltas.map(formatNonTextHint).join('; ')}`);
  }

  const boundaryDeltas = (data.nonTextDeltas ?? [])
    .filter((delta) => delta.likelyKind === 'separator')
    .slice(0, 2);
  if (boundaryDeltas.length > 0) {
    hints.push(`non-text boundaries: ${boundaryDeltas.map(formatNonTextHint).join('; ')}`);
  }

  return hints.slice(0, 6);
}

function formatNonTextHint(delta: {
  likelyKind: string;