Link right after "@throws" is rendered as plain text instead of a link

[wpazderski]

Search terms

throws, link

Expected Behavior

Links that occur right after @throws should be rendered as links (e.g. @throws {@link AnError})

Actual Behavior

In some cases TypeDoc renders it as plain text instead of a link and prints the following warning:
[warning] Failed to resolve link to "(...)" in comment for (...)

Steps to reproduce the bug

It looks like if the following conditions are met:

• entryPointStrategy is set to expand,
• any *.ts file is present in a directory above the target file (Example.ts in this case - see the repo link below), but inside the directory specified in entryPoints

then the link that occurs right after @throws is rendered as plain text instead of a link (for imported classes):

/**
 * {@link RendersAsLink}
 * @throws {@link RendersAsPlainText} - {@link RendersAsLink}
 */

Reproduction: https://github.com/wpazderski/tmp-typedoc-bug

Environment

• Typedoc version: 0.28.9
• TypeScript version: 5.9.2
• Node.js version: 24.1.0
• OS: MacOS

[Gerrit0]

This is unfortunately due to a conflict in how TypeDoc parses comments and how TypeScript parses comments. TypeScript expects the @throws tag to look like @throws {Type}, so is parsing your text there as a type rather than realizing it is a tag.

Personally, I think TypeScript really ought to check for a tag here, which would fix this issue.... TypeDoc could theoretically work around it by using checker.resolveName instead of the current strategy of extracting where TypeScript detects @link tags, but unfortunately that comes with the cost of having to re-implement how TypeScript figures out link resolution.

The diff to make this work in TypeScript itself is tiny, so I'm going to propose that and see what they say...