Function computeJSDocInputHash

repos/effect/packages/tools/jsdocs/src/Jsdocs.ts:1774–1824

(options: ExtractJSDocsOptions)

  >()
  for (const link of collectJSDocLinks(sourceFile, block)) {
    const text = link.getText(sourceFile)
    const target = extractInlineLinkTarget(text)
    if (target === "" || urlRegex.test(target)) continue
    const symbol = resolveJSDocLinkSymbol(link, linkContext.checker)
    const info = symbol === undefined ? undefined : inlineLinkSymbol(symbol, linkContext.cwd, linkContext.checker)
    const items = resolved.get(text) ?? []
    items.push(info === undefined ? { range: [link.pos, link.end] } : { range: [link.pos, link.end], symbol: info })
    resolved.set(text, items)
  }
  return {
    ...tags,
    see: tags.see.map((tag) => ({
      ...tag,
      links: tag.links.map((link) => {
        const items = resolved.get(link.raw)
        const info = items?.shift()
        if (info === undefined) return link
        return info.symbol === undefined
          ? { ...link, range: info.range }
          : { ...link, range: info.range, symbol: info.symbol }
      })
    }))
  }
}

function attachSeeLinkSymbols<T extends ParsedDeclarationTags | ParsedNamespaceTags | ParsedMemberTags>(
  tags: T,
  node: ts.Node,
  block: JSDocBlock,
  linkContext: { readonly checker: ts.TypeChecker; readonly entry: ProgramCacheEntry; readonly cwd: string }
): T {
  return attachSeeLinkSymbolsFromSourceFile(tags, node.getSourceFile(), block, linkContext)
}

/**
 * JSDoc diagnostic paired with its source range.
 *
 * @category models
 * @since 4.0.0
 */
export interface JSDocModelDiagnostic extends JSDocDiagnostic {
  readonly range: readonly [number, number]
}

/**
 * Parsed JSDoc and diagnostics for one source file in a model.
 *
 * @category models
 * @since 4.0.0
 */
export interface JSDocModelFile extends ParsedJSDocFile {
  readonly file: string
  readonly hash: string
  readonly diagnostics: ReadonlyArray<JSDocModelDiagnostic>