fix(valid-types, no-undefined-types, check-types): have mode default to typescript when typescript-eslint/parser is on; fixes gajus#593

Author: brettz9

.README/README.md

@@ -130,7 +130,9 @@ how many line breaks to add when a block is missing.
 
 ### Mode
 
-- `settings.jsdoc.mode` - Set to `jsdoc` (the default), `typescript`, or `closure`.
+- `settings.jsdoc.mode` - Set to `typescript`, `closure`, or `jsdoc` (the
+  default unless the `@typescript-eslint` parser is in use in which case
+  `typescript` will be the default).
   Note that if you do not wish to use separate `.eslintrc.*` files for a project
   containing both JavaScript and TypeScript, you can also use [`overrides`](https://eslint.org/docs/user-guide/configuring). You may also set to `"permissive"` to
   try to be as accommodating to any of the styles, but this is not recommended.

README.md

@@ -188,7 +188,9 @@ how many line breaks to add when a block is missing.
 <a name="eslint-plugin-jsdoc-settings-mode"></a>
 ### Mode
 
-- `settings.jsdoc.mode` - Set to `jsdoc` (the default), `typescript`, or `closure`.
+- `settings.jsdoc.mode` - Set to `typescript`, `closure`, or `jsdoc` (the
+  default unless the `@typescript-eslint` parser is in use in which case
+  `typescript` will be the default).
   Note that if you do not wish to use separate `.eslintrc.*` files for a project
   containing both JavaScript and TypeScript, you can also use [`overrides`](https://eslint.org/docs/user-guide/configuring). You may also set to `"permissive"` to
   try to be as accommodating to any of the styles, but this is not recommended.
@@ -13691,6 +13693,13 @@ function quux () {}
 function foo(bar) {}
 // Settings: {"jsdoc":{"mode":"typescript"}}
 
+/**
+ * Foo function.
+ *
+ * @param {[number, string]} bar - The bar array.
+ */
+function foo(bar) {}
+
 /**
  * Foo function.
  *

src/iterateJsdoc.js

@@ -434,7 +434,8 @@ const getSettings = (context) => {
     augmentsExtendsReplacesDocs: context.settings.jsdoc?.augmentsExtendsReplacesDocs,
 
     // Many rules, e.g., `check-tag-names`
-    mode: context.settings.jsdoc?.mode ?? 'jsdoc',
+    mode: context.settings.jsdoc?.mode ??
+      (context.parserPath.includes('@typescript-eslint') ? 'typescript' : 'jsdoc'),
   };
   /* eslint-enable sort-keys-fix/sort-keys-fix */
 

test/rules/assertions/validTypes.js

@@ -742,6 +742,17 @@ export default {
         },
       },
     },
+    {
+      code: `
+      /**
+       * Foo function.
+       *
+       * @param {[number, string]} bar - The bar array.
+       */
+      function foo(bar) {}
+      `,
+      parser: require.resolve('@typescript-eslint/parser'),
+    },
     {
       code: `
       /**