- Complete testing coverage; Update README

Author: brettz9

README.md

@@ -5648,6 +5648,14 @@ function b () {}
  * @aCustomTag {anotherType|otherType} foo
  */
 // Settings: {"jsdoc":{"structuredTags":{"aCustomTag":{"type":["otherType","anotherType"]}}}}
+
+/**
+ * Bad types handled by `valid-types` instead.
+ * @param {str(} foo
+ */
+function quux (foo) {
+
+}
 ````
 
 
@@ -9248,6 +9256,14 @@ class Test {
     return this;
   }
 }
+
+/**
+ * Bad types ignored here and handled instead by `valid-types`.
+ * @param {string(} foo - Bar.
+ */
+function quux(foo) {
+
+}
 ````
 
 
@@ -19499,14 +19515,6 @@ function quux() {
 // Settings: {"jsdoc":{"structuredTags":{"see":{"name":"namepath-referencing","required":["name"]}}}}
 // Message: Syntax error in namepath: foo%
 
-/**
- * @alias module:abc#event:foo-bar
- */
-function quux() {
-
-}
-// Message: Syntax error in namepath: module:abc#event:foo-bar
-
 /**
  * @mixes module:namespace.SomeClass~
  */

test/rules/assertions/checkTypes.js

@@ -23,6 +23,31 @@ export default {
         },
       },
     },
+    {
+      code: `
+          /**
+           * @param {abc} foo
+           */
+          function quux (foo) {
+
+          }
+      `,
+      errors: [
+        {
+          line: 1,
+          message: 'Invalid `settings.jsdoc.preferredTypes`. Values must be falsy, a string, or an object.',
+        },
+      ],
+      ignoreReadme: true,
+      settings: {
+        jsdoc: {
+          mode: 'permissive',
+          preferredTypes: {
+            abc: 100,
+          },
+        },
+      },
+    },
     {
       code: `
           /**
@@ -2631,5 +2656,16 @@ export default {
         },
       },
     },
+    {
+      code: `
+          /**
+           * Bad types handled by \`valid-types\` instead.
+           * @param {str(} foo
+           */
+          function quux (foo) {
+
+          }
+      `,
+    },
   ],
 };

test/rules/assertions/noUndefinedTypes.js

@@ -997,5 +997,33 @@ export default {
       `,
       parser: require.resolve('@typescript-eslint/parser'),
     },
+    {
+      code: `
+          /**
+           * Bad types ignored here and handled instead by \`valid-types\`.
+           * @param {string(} foo - Bar.
+           */
+          function quux(foo) {
+
+          }
+      `,
+    },
+    {
+      code: `
+          /**
+           * Bad types ignored here and handled instead by \`valid-types\`.
+           * @param {string(} foo - Bar.
+           */
+          function quux(foo) {
+
+          }
+      `,
+      ignoreReadme: true,
+      settings: {
+        jsdoc: {
+          mode: 'permissive',
+        },
+      },
+    },
   ],
 };