Show error when JSDoc tags use unknown Symbols

Suggestion

Raise error when JSDoc tags reference unknown types

🔍 Search Terms

List of keywords you searched for before creating this issue. Write them down here so that others can find this suggestion more easily and help provide feedback.

is:issue is:open in:title jsdoc error
is:issue is:open in:title jsdoc validate

✅ Viability Checklist

My suggestion meets these guidelines:

• This wouldn't be a breaking change in existing TypeScript/JavaScript code
• This wouldn't change the runtime behavior of existing JavaScript code
• This could be implemented without emitting different JS based on the types of the expressions
• This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
• This feature would agree with the rest of TypeScript's Design Goals.

⭐ Suggestion

Just like unknown symbols are compilation errors, raise also errors when using unknown symbols within JSDoc comments

📃 Motivating Example

      class TestWebsite {}

      /** @link {TestWebsite-Bogus} */
      /** @see {TestWebsite-Bogus} */
      /** @type {TestWebsite-Bous} */

There is no error on those references

💻 Use Cases

Typescript already takes type hints from JSDoc comments. Why not close the loop and also type-check JSDoc??

My most frequent code documentation case is referencing symbols and files within comments. However since these are never validated it is normal that with time and some refactorings those references become invalid.

It would be of a great help getting compilation errors on comment references. After all wrong/bad code documentation is worst than no documentation. JSDoc deserves static validation too!

Beginne damit, den Vorschlag und seine JSDoc-Beispiele zu überprüfen, und ermittle anschließend die vorhandenen Tests zur JSDoc-Typprüfung und zu Diagnosen; das Issue nennt keine Dateien oder Test-Einstiegspunkte. Als abgeschlossen gilt die Aufgabe, wenn unbekannte Symbole, auf die von JSDoc-Tags wie @link, @see und @type verwiesen wird, Kompilierungsfehler erzeugen, ohne das erzeugte JavaScript zu ändern.