unfortunately i cant comment since i dont have 50rep but there’s no special @ts-self-types. You just need to: Add // @ts-check to your .js files or define the types in a .d.ts next to the file and avoid @ts-check if only using declarations. As for a way to make JSDoc types work directly with deno doc / JSR, No, not currently. deno doc and JSR ignore JSDoc types. They only parse TypeScript declarations with what i am aware of.

Use .ts for new libraries if publishing on JSR. If you want .js compatibility, keep .js as the implementation and .d.ts for API or for better maintainability, consider generating .d.ts from .ts and bundling for JSR.