Function unresolvedPublicSeeDiagnostic

packages/tools/jsdocs/src/Jsdocs.ts:2345–2353

(link: JSDocApiSeeLink)

}

function unresolvedPublicSeeDiagnostic(link: JSDocApiSeeLink): JSDocModelDiagnostic | undefined {
  if (link.resolution._tag === "Resolved" || link.range === undefined) return undefined
  const message = link.resolution.reason === "ambiguous"
    ? `@see link ${link.raw} is ambiguous; it must resolve to exactly one public JSDoc API. Candidates: ${
      link.resolution.candidates.join(", ")
    }`
    : `@see link ${link.raw} does not resolve to a public JSDoc API. Check that the target is exported and has valid public JSDoc.`
  return { ...diagnostic("public-see-target", message), range: link.range }
}

function appendPublicSeeDiagnostics(
  files: ReadonlyArray<JSDocModelFile>,