Function appendPublicSeeDiagnostics

packages/tools/jsdocs/src/Jsdocs.ts:2355–2381

(
  files: ReadonlyArray<JSDocModelFile>,
  apis: ReadonlyArray<JSDocApi>
)

}

function appendPublicSeeDiagnostics(
  files: ReadonlyArray<JSDocModelFile>,
  apis: ReadonlyArray<JSDocApi>
): { readonly files: ReadonlyArray<JSDocModelFile>; readonly added: boolean } {
  const diagnosticsByFile = new Map(files.map((file) => [file.file, [...file.diagnostics]]))
  let added = false
  for (const api of apis) {
    const diagnostics = diagnosticsByFile.get(api.source.file)
    if (diagnostics === undefined) continue
    for (const tag of api.see) {
      for (const link of tag.links) {
        const item = unresolvedPublicSeeDiagnostic(link)
        if (item === undefined || diagnostics.some((diagnostic) => sameDiagnostic(diagnostic, item))) continue
        diagnostics.push(item)
        added = true
      }
    }
  }
  if (!added) return { files, added }
  return {
    added,
    files: files.map((file) => ({
      ...file,
      diagnostics: diagnosticsByFile.get(file.file) ?? file.diagnostics
    }))
  }
}

function moduleSeeTags(
  file: JSDocModelFile,