Here are some basic tips for beginners trying to use TypeScript tooling against plain JavaScript + JSDoc files.
TypeScript-style documentation syntax is JSDoc, it's just a different dialect of JSDoc as far as which
JSDoc tags have formally defined behavior, what the types are (there are many more available in
the TypeScript flavor), and what the allowable syntax is (the TypeScript team tried to hew closely
to JSDoc, but they avoided @module
in favor of allowing import()
of third party types and they
don't yet support certain tags
in a type-aware way--though for doc tools unrelated to type-checking it might not matter).