Comment by Nenad Vićentić on "Typescript... or jsdocs ?"

While I wholeheartedly agree with you on Tailwind vs modern CSS, this is different case.

All the functionality you are using via JSDocs is enabled and implemented by TypeScript compiler (probably the one built-in into Visual Studio Code?). Using JSDocs gives you only the advantage that you don't have to transpile source files.

But, since you are already using ESBuild for minification and source-maps, you could have used TypeScript syntax, instead of JSDocs as well. Also, your jsconfig.json is derivate of tsconfig.json.

There is a nice post from Rob Eisenberg how to integrate full TypeScript compiler with ESBuild: "An ESBuild Setup for TypeScript"

Also, if you follow trends, NodeJS can now execute TypeScript files out of the box. For example: node --experimental-strip-types build/copy-files.mts. Even ESBuild can handle "simple" TypeScript files without a full TypeScript compiler.

But the point you are right about - mapping types, npm packages, etc... can become quite complicated. Specially because NMP/Node support multiple standard and non-standard JavaScript module types.

So, unlike Tailwind, TypeScript has usefull functionality that does not exist in native JavaScript. And it seems that all the industry is converging on idea that some kind of type notation should exist in JavaScript natively.

While I might just as well use Typescript since I have all the tooling in place, it would bring very little benefits over using a couple of jsdocs tags (for me, and for my use cases, anyway.. i can very well understand in larger projects or with a team that typescript makes more sense). Using typescript also forces you to follow updates or potential breaking changes... one less thing to worry about for me :-) But maybe some day I will see a decisive benefit and decide to switch, who knows :-D

Thomas Portelange That's fine. I am not trying to persue you to change coding style that makes you more productive. And you, clearly, do the coding well.

I'm pointing out that both Typescript and JSDoc types are powered by the same TypeScript Language Service in your code editor. Which means that even when using JavaScript with JSDoc types, you are actually using TypeScript engine under the hood. Only in a "light" mode that suits your preferences.

Nenad Vićentić ;-) I might give it a test run and see how it goes in one of my project, i'm really curious to see if that would make me "more productive" but I'm not really sure that will be the case

Search Hashnode