fix(documentation): do not remove JSDoc types in Vue JS files

[ShGKme]

• Fix: Types are removed from JSDoc in .vue when there it has no lang="ts" #980
• Currently npm run lint breaks many Vue + JS files if TS config is used

Half-working solution

• jsdoc/require-property-type makes no harm in TS, there are no @property
• In .vue files (that can be both TS and JS):
  • Use jsdoc/no-types only if there are TS types
  • Use jsdoc/require-param-type only if there are no TS types
  • Disable jsdoc/require-returns-type (because a return type is often inferred, not specified)
  • Allow type-tags in jsdoc/check-tag-names (because it can be used in a JS component)

So it doesn't break existing JS components (like before).
But it applies only ~half of JSDoc + TS rules in TS components.

Alternative

Generate files on the fly by checking <script lang> to distinguish between JS and TS Vue files.

[ShGKme]

I'll add tests if the idea is fine

[susnux]

I like the idea! Did not check yet!

[susnux]

seems to work 🚀

[susnux]

what is missing here @ShGKme ?

[ShGKme]

what is missing here @ShGKme ?

My willing to add tests here with all the cases.
I'll do it now.

Oh, and a general dislike of the solution, as it is a half-solution. For example, it just disables jsdoc/require-returns-type at all.

[ShGKme]

• Rebased onto main
• Added tests
• No changes in the rules