fix(no-restricted-syntax, no-missing-syntax): update jsdoccomment…

… to avoid breaking on bad types (at least until jsdoc-type-pratt-parser may support all expected); fixes #842

Also updates devDep.

README.md

@@ -9261,6 +9261,12 @@ const MY_ENUM = Object.freeze({
   VAL_A: "myvala"
 } as const);
 // "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[postDelimiter=\"\"]:has(JsdocTag ~ JsdocTag[tag=/private|protected/])","context":"any","message":"Access modifier tags must come first"},{"comment":"JsdocBlock[postDelimiter=\"\"]:has(JsdocTag[tag=\"enum\"])","context":":declaration:not(TSEnumDeclaration):not(:has(ObjectExpression)), :function","message":"@enum is only allowed on potential enum types"}]}]
+
+/**
+ * @param {(...args: any[]) => any} fn
+ * @returns {(...args: any[]) => any}
+ */
+// "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock:has(JsdocTag[tag=\"type\"]:has([value=/FunctionComponent/]))","context":"any","message":"The `FunctionComponent` type is not allowed. Please use `FC` instead."}]}]
 ````
 
 

package.json

@@ -5,7 +5,7 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.20.0",
+    "@es-joy/jsdoccomment": "~0.20.1",
     "comment-parser": "1.3.0",
     "debug": "^4.3.3",
     "escape-string-regexp": "^4.0.0",
@@ -17,7 +17,7 @@
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
     "@babel/cli": "^7.17.3",
-    "@babel/core": "^7.17.4",
+    "@babel/core": "^7.17.5",
     "@babel/eslint-parser": "^7.17.0",
     "@babel/node": "^7.16.8",
     "@babel/plugin-syntax-class-properties": "^7.12.13",

test/rules/assertions/noRestrictedSyntax.js

@@ -471,5 +471,24 @@ export default {
       ],
       parser: require.resolve('@typescript-eslint/parser'),
     },
+    {
+      code: `
+        /**
+         * @param {(...args: any[]) => any} fn
+         * @returns {(...args: any[]) => any}
+         */
+      `,
+      options: [
+        {
+          contexts: [
+            {
+              comment: 'JsdocBlock:has(JsdocTag[tag="type"]:has([value=/FunctionComponent/]))',
+              context: 'any',
+              message: 'The `FunctionComponent` type is not allowed. Please use `FC` instead.',
+            },
+          ],
+        },
+      ],
+    },
   ],
 };