fix(no-restricted-syntax): update jsdoccomment to be able to use new descriptionStartLine, descriptionEndLine, and hasPreterminalDescription properties; fixes #830

Author: brettz9

README.md

@@ -9641,6 +9641,16 @@ const MyComponent = ({ children }) => {
 }
 // "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."}]}]
 // Message: The `FunctionComponent` type is not allowed. Please use `FC` instead.
+
+/** Some text and more */
+// "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[descriptionStartLine=0][descriptionEndLine=0]","context":"any","message":"Requiring descriptive text on 0th line only"}]}]
+// Message: Requiring descriptive text on 0th line only
+
+/** Some text and
+* more
+*/
+// "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[descriptionStartLine=0][hasPreterminalDescription=0]","context":"any","message":"Requiring descriptive text on 0th line and no preterminal description"}]}]
+// Message: Requiring descriptive text on 0th line and no preterminal description
 ````
 
 The following patterns are not considered problems:
@@ -9699,6 +9709,13 @@ const MY_ENUM = Object.freeze({
 /** Does something very important. */
 function foo(): string;
 // "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[endLine=0][description!=/^\\S[\\s\\S]*\\S\\s$/]"}]}]
+
+/** Some text and more */
+// "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[descriptionStartLine=0][descriptionEndLine=1]","context":"any","message":"Requiring descriptive text on 0th line and no final newline"}]}]
+
+/** Some text and
+* more */
+// "jsdoc/no-restricted-syntax": ["error"|"warn", {"contexts":[{"comment":"JsdocBlock[descriptionStartLine=0][hasPreterminalDescription=0]","context":"any","message":"Requiring descriptive text on 0th line and no preterminal description"}]}]
 ````
 
 

package.json

@@ -5,7 +5,7 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.33.4",
+    "@es-joy/jsdoccomment": "~0.35.0",
     "comment-parser": "1.3.1",
     "debug": "^4.3.4",
     "escape-string-regexp": "^4.0.0",

test/rules/assertions/noRestrictedSyntax.js

@@ -372,6 +372,52 @@ export default {
       ],
       parser: require.resolve('@es-joy/jsdoc-eslint-parser/typescript.js'),
     },
+    {
+      code: `
+        /** Some text and more */
+      `,
+      errors: [
+        {
+          line: 2,
+          message: 'Requiring descriptive text on 0th line only',
+        },
+      ],
+      options: [
+        {
+          contexts: [
+            {
+              comment: 'JsdocBlock[descriptionStartLine=0][descriptionEndLine=0]',
+              context: 'any',
+              message: 'Requiring descriptive text on 0th line only',
+            },
+          ],
+        },
+      ],
+    },
+    {
+      code: `
+        /** Some text and
+        * more
+        */
+      `,
+      errors: [
+        {
+          line: 2,
+          message: 'Requiring descriptive text on 0th line and no preterminal description',
+        },
+      ],
+      options: [
+        {
+          contexts: [
+            {
+              comment: 'JsdocBlock[descriptionStartLine=0][hasPreterminalDescription=0]',
+              context: 'any',
+              message: 'Requiring descriptive text on 0th line and no preterminal description',
+            },
+          ],
+        },
+      ],
+    },
   ],
   valid: [
     {
@@ -531,5 +577,38 @@ export default {
       ],
       parser: require.resolve('@typescript-eslint/parser'),
     },
+    {
+      code: `
+        /** Some text and more */
+      `,
+      options: [
+        {
+          contexts: [
+            {
+              comment: 'JsdocBlock[descriptionStartLine=0][descriptionEndLine=1]',
+              context: 'any',
+              message: 'Requiring descriptive text on 0th line and no final newline',
+            },
+          ],
+        },
+      ],
+    },
+    {
+      code: `
+        /** Some text and
+        * more */
+      `,
+      options: [
+        {
+          contexts: [
+            {
+              comment: 'JsdocBlock[descriptionStartLine=0][hasPreterminalDescription=0]',
+              context: 'any',
+              message: 'Requiring descriptive text on 0th line and no preterminal description',
+            },
+          ],
+        },
+      ],
+    },
   ],
 };