#3113·typedoc

Link tags in line comments are not resolved via TypeScript

Author: marijnhCreated May 29, 2026Updated May 31, 2026

Search terms

@link line comment useTsLinkResolution

Expected Behavior

If I use line comments for my doc comments, I'd expect TypeScript-driven resolution of @link targets to still work.

Actual Behavior

Only the old, built-in resolution is used in this case.

In fact, the machinery needed to do this seems to be entirely absent from lineLexer.ts. Is this intentional, or an oversight? (If you want, I can look into adding it. In that case, I'd like to know why these lexers exist as completely separate code, rather than being unified, since they seem very similar.)

Steps to reproduce the bug

Set commentStyle to "line", and use a @link that requires TypeScript to resolve (I ran across this trying to reference an import from a sibling package included in the build). TypeDoc will never call getSymbolAtLocation for it, and thus fail to resolve it.

Environment

  • TypeDoc version: 0.28.19
  • TypeScript version: 6.0.3
  • Node.js version: 22.20.0
  • OS: Debian Linux