eslint-plugin-jsdoc 57.1.0 → 57.1.1

package/dist/generateRuleTypes.cjs

@@ -7,6 +7,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 let str = 'export interface Rules {\n';
 for (const [ruleName, rule] of Object.entries(_index.default.rules)) {
   if (rule.meta?.schema?.[0]) {
+    str += `  /** ${rule.meta.docs.description} */\n`;
     str += `  "jsdoc/${ruleName}": `;
     const ts = await (0, _jsonSchemaToTypescript.compile)({
       items: rule.meta.schema,

package/dist/generateRuleTypes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"generateRuleTypes.cjs","names":["_index","_interopRequireDefault","require","_jsonSchemaToTypescript","_promises","e","__esModule","default","str","ruleName","rule","Object","entries","index","rules","meta","schema","ts","compile","items","type","bannerComment","replace","replaceAll","trimEnd","writeFile","__dirname","console","log"],"sources":["../src/bin/generateRuleTypes.js"],"sourcesContent":["import index from '../index.js';\nimport {\n  compile,\n} from 'json-schema-to-typescript';\nimport {\n  writeFile,\n} from 'node:fs/promises';\n\nlet str = 'export interface Rules {\\n';\n\nfor (const [\n  ruleName,\n  rule,\n] of Object.entries(index.rules)) {\n  if (rule.meta?.schema?.[0]) {\n    str += `  \"jsdoc/${ruleName}\": `;\n    const ts = await compile({\n      items: rule.meta.schema,\n      type: 'array',\n    }, 'Test', {\n      bannerComment: '',\n    });\n\n    str += ts\n      .replace(/^export type Test = ?/v, '')\n      .replace(/^export interface Test /v, '')\n      .replaceAll('\\n', '\\n  ').trimEnd().replace(/;$/v, '') +\n        ';\\n\\n';\n  }\n}\n\nstr = str.replace(/\\n$/v, '') + '}\\n';\n\nawait writeFile(import.meta.dirname + '/../rules.d.ts', str);\n\n// eslint-disable-next-line no-console -- Todo\nconsole.log('str', str);\n"],"mappings":";;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,uBAAA,GAAAD,OAAA;AAGA,IAAAE,SAAA,GAAAF,OAAA;AAE0B,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE1B,IAAIG,GAAG,GAAG,4BAA4B;AAEtC,KAAK,MAAM,CACTC,QAAQ,EACRC,IAAI,CACL,IAAIC,MAAM,CAACC,OAAO,CAACC,cAAK,CAACC,KAAK,CAAC,EAAE;EAChC,IAAIJ,IAAI,CAACK,IAAI,EAAEC,MAAM,GAAG,CAAC,CAAC,EAAE;IAC1BR,GAAG,IAAI,YAAYC,QAAQ,KAAK;IAChC,MAAMQ,EAAE,GAAG,MAAM,IAAAC,+BAAO,EAAC;MACvBC,KAAK,EAAET,IAAI,CAACK,IAAI,CAACC,MAAM;MACvBI,IAAI,EAAE;IACR,CAAC,EAAE,MAAM,EAAE;MACTC,aAAa,EAAE;IACjB,CAAC,CAAC;IAEFb,GAAG,IAAIS,EAAE,CACNK,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CACrCA,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CACvCC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAACC,OAAO,CAAC,CAAC,CAACF,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACpD,OAAO;EACb;AACF;AAEAd,GAAG,GAAGA,GAAG,CAACc,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK;AAErC,MAAM,IAAAG,mBAAS,EAACC,SAAA,GAAsB,gBAAgB,EAAElB,GAAG,CAAC;;AAE5D;AACAmB,OAAO,CAACC,GAAG,CAAC,KAAK,EAAEpB,GAAG,CAAC","ignoreList":[]}
+{"version":3,"file":"generateRuleTypes.cjs","names":["_index","_interopRequireDefault","require","_jsonSchemaToTypescript","_promises","e","__esModule","default","str","ruleName","rule","Object","entries","index","rules","meta","schema","docs","description","ts","compile","items","type","bannerComment","replace","replaceAll","trimEnd","writeFile","__dirname","console","log"],"sources":["../src/bin/generateRuleTypes.js"],"sourcesContent":["import index from '../index.js';\nimport {\n  compile,\n} from 'json-schema-to-typescript';\nimport {\n  writeFile,\n} from 'node:fs/promises';\n\nlet str = 'export interface Rules {\\n';\n\nfor (const [\n  ruleName,\n  rule,\n] of Object.entries(index.rules)) {\n  if (rule.meta?.schema?.[0]) {\n    str += `  /** ${rule.meta.docs.description} */\\n`;\n    str += `  \"jsdoc/${ruleName}\": `;\n    const ts = await compile({\n      items: rule.meta.schema,\n      type: 'array',\n    }, 'Test', {\n      bannerComment: '',\n    });\n\n    str += ts\n      .replace(/^export type Test = ?/v, '')\n      .replace(/^export interface Test /v, '')\n      .replaceAll('\\n', '\\n  ').trimEnd().replace(/;$/v, '') +\n        ';\\n\\n';\n  }\n}\n\nstr = str.replace(/\\n$/v, '') + '}\\n';\n\nawait writeFile(import.meta.dirname + '/../rules.d.ts', str);\n\n// eslint-disable-next-line no-console -- Todo\nconsole.log('str', str);\n"],"mappings":";;AAAA,IAAAA,MAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,uBAAA,GAAAD,OAAA;AAGA,IAAAE,SAAA,GAAAF,OAAA;AAE0B,SAAAD,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAE1B,IAAIG,GAAG,GAAG,4BAA4B;AAEtC,KAAK,MAAM,CACTC,QAAQ,EACRC,IAAI,CACL,IAAIC,MAAM,CAACC,OAAO,CAACC,cAAK,CAACC,KAAK,CAAC,EAAE;EAChC,IAAIJ,IAAI,CAACK,IAAI,EAAEC,MAAM,GAAG,CAAC,CAAC,EAAE;IAC1BR,GAAG,IAAI,SAASE,IAAI,CAACK,IAAI,CAACE,IAAI,CAACC,WAAW,OAAO;IACjDV,GAAG,IAAI,YAAYC,QAAQ,KAAK;IAChC,MAAMU,EAAE,GAAG,MAAM,IAAAC,+BAAO,EAAC;MACvBC,KAAK,EAAEX,IAAI,CAACK,IAAI,CAACC,MAAM;MACvBM,IAAI,EAAE;IACR,CAAC,EAAE,MAAM,EAAE;MACTC,aAAa,EAAE;IACjB,CAAC,CAAC;IAEFf,GAAG,IAAIW,EAAE,CACNK,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CACrCA,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CACvCC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAACC,OAAO,CAAC,CAAC,CAACF,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GACpD,OAAO;EACb;AACF;AAEAhB,GAAG,GAAGA,GAAG,CAACgB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK;AAErC,MAAM,IAAAG,mBAAS,EAACC,SAAA,GAAsB,gBAAgB,EAAEpB,GAAG,CAAC;;AAE5D;AACAqB,OAAO,CAACC,GAAG,CAAC,KAAK,EAAEtB,GAAG,CAAC","ignoreList":[]}

package/dist/rules.d.ts

@@ -1,4 +1,5 @@
 export interface Rules {
+  /** Reports invalid alignment of JSDoc block asterisks. */
   "jsdoc/check-alignment": 
     | []
     | [
@@ -7,6 +8,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that (JavaScript) examples within JSDoc adhere to ESLint rules. */
   "jsdoc/check-examples": 
     | []
     | [
@@ -33,6 +35,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid padding inside JSDoc blocks. */
   "jsdoc/check-indentation": 
     | []
     | [
@@ -41,6 +44,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid alignment of JSDoc block lines. */
   "jsdoc/check-line-alignment": 
     | []
     | ["always" | "never" | "any"]
@@ -61,6 +65,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that parameter names in JSDoc match those in the function declaration. */
   "jsdoc/check-param-names": 
     | []
     | [
@@ -76,6 +81,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that property names in JSDoc are not duplicated on the same block and that nested properties have defined roots. */
   "jsdoc/check-property-names": 
     | []
     | [
@@ -84,6 +90,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid block tag names. */
   "jsdoc/check-tag-names": 
     | []
     | [
@@ -95,6 +102,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid types. */
   "jsdoc/check-types": 
     | []
     | [
@@ -108,6 +116,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule checks the values for a handful of tags: `@version`, `@since`, `@license` and `@author`. */
   "jsdoc/check-values": 
     | []
     | [
@@ -119,6 +128,7 @@ export interface Rules {
         }
       ];
 
+  /** Converts non-JSDoc comments preceding or following nodes into JSDoc ones */
   "jsdoc/convert-to-jsdoc-comments": 
     | []
     | [
@@ -151,6 +161,7 @@ export interface Rules {
         }
       ];
 
+  /** Expects specific tags to be empty of any content. */
   "jsdoc/empty-tags": 
     | []
     | [
@@ -159,6 +170,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports an issue with any non-constructor function using `@implements`. */
   "jsdoc/implements-on-classes": 
     | []
     | [
@@ -173,6 +185,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports doc comments that only restate their attached name. */
   "jsdoc/informative-docs": 
     | []
     | [
@@ -189,6 +202,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces minimum number of newlines before JSDoc comment blocks */
   "jsdoc/lines-before-block": 
     | []
     | [
@@ -201,6 +215,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces a regular expression pattern on descriptions. */
   "jsdoc/match-description": 
     | []
     | [
@@ -238,6 +253,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports the name portion of a JSDoc tag if matching or not matching a given regular expression. */
   "jsdoc/match-name": 
     | []
     | [
@@ -254,6 +270,7 @@ export interface Rules {
         }
       ];
 
+  /** Controls how and whether jsdoc blocks can be expressed as single or multiple line blocks. */
   "jsdoc/multiline-blocks": 
     | []
     | [
@@ -270,6 +287,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule checks for multi-line-style comments which fail to meet the criteria of a jsdoc block. */
   "jsdoc/no-bad-blocks": 
     | []
     | [
@@ -279,6 +297,7 @@ export interface Rules {
         }
       ];
 
+  /** Removes empty blocks with nothing but possibly line breaks */
   "jsdoc/no-blank-blocks": 
     | []
     | [
@@ -287,6 +306,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports defaults being used on the relevant portion of `@param` or `@default`. */
   "jsdoc/no-defaults": 
     | []
     | [
@@ -302,6 +322,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports when certain comment structures are always expected. */
   "jsdoc/no-missing-syntax": 
     | []
     | [
@@ -318,6 +339,7 @@ export interface Rules {
         }
       ];
 
+  /** Prevents use of multiple asterisks at the beginning of lines. */
   "jsdoc/no-multi-asterisks": 
     | []
     | [
@@ -328,6 +350,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports when certain comment structures are present. */
   "jsdoc/no-restricted-syntax": 
     | []
     | [
@@ -343,6 +366,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports types being used on `@param` or `@returns`. */
   "jsdoc/no-types": 
     | []
     | [
@@ -357,6 +381,7 @@ export interface Rules {
         }
       ];
 
+  /** Checks that types in jsdoc comments are defined. */
   "jsdoc/no-undefined-types": 
     | []
     | [
@@ -367,6 +392,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each JSDoc line starts with an `*`. */
   "jsdoc/require-asterisk-prefix": 
     | []
     | ["always" | "never" | "any"]
@@ -381,6 +407,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all functions have a description. */
   "jsdoc/require-description": 
     | []
     | [
@@ -400,6 +427,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that block description, explicit `@description`, and `@param`/`@returns` tag descriptions are written in complete sentences. */
   "jsdoc/require-description-complete-sentence": 
     | []
     | [
@@ -410,6 +438,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all functions have examples. */
   "jsdoc/require-example": 
     | []
     | [
@@ -430,6 +459,7 @@ export interface Rules {
         }
       ];
 
+  /** Checks that all files have one `@file`, `@fileoverview`, or `@overview` tag at the beginning of the file. */
   "jsdoc/require-file-overview": 
     | []
     | [
@@ -448,6 +478,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a hyphen before the `@param` description. */
   "jsdoc/require-hyphen-before-param-description": 
     | []
     | ["always" | "never"]
@@ -466,6 +497,7 @@ export interface Rules {
         }
       ];
 
+  /** Require JSDoc comments */
   "jsdoc/require-jsdoc": 
     | []
     | [
@@ -507,6 +539,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all function parameters are documented. */
   "jsdoc/require-param": 
     | []
     | [
@@ -536,6 +569,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each `@param` tag has a `description` value. */
   "jsdoc/require-param-description": 
     | []
     | [
@@ -552,6 +586,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all function parameters have names. */
   "jsdoc/require-param-name": 
     | []
     | [
@@ -566,6 +601,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each `@param` tag has a `type` value. */
   "jsdoc/require-param-type": 
     | []
     | [
@@ -582,6 +618,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that returns are documented. */
   "jsdoc/require-returns": 
     | []
     | [
@@ -611,6 +648,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a return statement in function body if a `@returns` tag is specified in jsdoc comment. */
   "jsdoc/require-returns-check": 
     | []
     | [
@@ -621,6 +659,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that the `@returns` tag has a `description` value. */
   "jsdoc/require-returns-description": 
     | []
     | [
@@ -635,6 +674,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that `@returns` tag has `type` value. */
   "jsdoc/require-returns-type": 
     | []
     | [
@@ -649,6 +689,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires template tags for each generic type parameter */
   "jsdoc/require-template": 
     | []
     | [
@@ -658,6 +699,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that throw statements are documented. */
   "jsdoc/require-throws": 
     | []
     | [
@@ -673,6 +715,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires yields are documented. */
   "jsdoc/require-yields": 
     | []
     | [
@@ -693,6 +736,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a yield statement in function body if a `@yields` tag is specified in jsdoc comment. */
   "jsdoc/require-yields-check": 
     | []
     | [
@@ -710,6 +754,7 @@ export interface Rules {
         }
       ];
 
+  /** Sorts tags by a specified sequence according to tag name. */
   "jsdoc/sort-tags": 
     | []
     | [
@@ -724,6 +769,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces lines (or no lines) between tags. */
   "jsdoc/tag-lines": 
     | []
     | ["always" | "any" | "never"]
@@ -747,6 +793,7 @@ export interface Rules {
         }
       ];
 
+  /** Auto-escape certain characters that are input within block and tag descriptions. */
   "jsdoc/text-escaping": 
     | []
     | [
@@ -756,6 +803,7 @@ export interface Rules {
         }
       ];
 
+  /** Formats JSDoc type values. */
   "jsdoc/type-formatting": 
     | []
     | [
@@ -776,6 +824,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires all types to be valid JSDoc or Closure compiler types without syntax errors. */
   "jsdoc/valid-types": 
     | []
     | [

package/package.json

@@ -172,5 +172,5 @@
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "57.1.0"
+  "version": "57.1.1"
 }

package/src/rules.d.ts

@@ -1,4 +1,5 @@
 export interface Rules {
+  /** Reports invalid alignment of JSDoc block asterisks. */
   "jsdoc/check-alignment": 
     | []
     | [
@@ -7,6 +8,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that (JavaScript) examples within JSDoc adhere to ESLint rules. */
   "jsdoc/check-examples": 
     | []
     | [
@@ -33,6 +35,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid padding inside JSDoc blocks. */
   "jsdoc/check-indentation": 
     | []
     | [
@@ -41,6 +44,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid alignment of JSDoc block lines. */
   "jsdoc/check-line-alignment": 
     | []
     | ["always" | "never" | "any"]
@@ -61,6 +65,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that parameter names in JSDoc match those in the function declaration. */
   "jsdoc/check-param-names": 
     | []
     | [
@@ -76,6 +81,7 @@ export interface Rules {
         }
       ];
 
+  /** Ensures that property names in JSDoc are not duplicated on the same block and that nested properties have defined roots. */
   "jsdoc/check-property-names": 
     | []
     | [
@@ -84,6 +90,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid block tag names. */
   "jsdoc/check-tag-names": 
     | []
     | [
@@ -95,6 +102,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports invalid types. */
   "jsdoc/check-types": 
     | []
     | [
@@ -108,6 +116,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule checks the values for a handful of tags: `@version`, `@since`, `@license` and `@author`. */
   "jsdoc/check-values": 
     | []
     | [
@@ -119,6 +128,7 @@ export interface Rules {
         }
       ];
 
+  /** Converts non-JSDoc comments preceding or following nodes into JSDoc ones */
   "jsdoc/convert-to-jsdoc-comments": 
     | []
     | [
@@ -151,6 +161,7 @@ export interface Rules {
         }
       ];
 
+  /** Expects specific tags to be empty of any content. */
   "jsdoc/empty-tags": 
     | []
     | [
@@ -159,6 +170,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports an issue with any non-constructor function using `@implements`. */
   "jsdoc/implements-on-classes": 
     | []
     | [
@@ -173,6 +185,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports doc comments that only restate their attached name. */
   "jsdoc/informative-docs": 
     | []
     | [
@@ -189,6 +202,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces minimum number of newlines before JSDoc comment blocks */
   "jsdoc/lines-before-block": 
     | []
     | [
@@ -201,6 +215,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces a regular expression pattern on descriptions. */
   "jsdoc/match-description": 
     | []
     | [
@@ -238,6 +253,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports the name portion of a JSDoc tag if matching or not matching a given regular expression. */
   "jsdoc/match-name": 
     | []
     | [
@@ -254,6 +270,7 @@ export interface Rules {
         }
       ];
 
+  /** Controls how and whether jsdoc blocks can be expressed as single or multiple line blocks. */
   "jsdoc/multiline-blocks": 
     | []
     | [
@@ -270,6 +287,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule checks for multi-line-style comments which fail to meet the criteria of a jsdoc block. */
   "jsdoc/no-bad-blocks": 
     | []
     | [
@@ -279,6 +297,7 @@ export interface Rules {
         }
       ];
 
+  /** Removes empty blocks with nothing but possibly line breaks */
   "jsdoc/no-blank-blocks": 
     | []
     | [
@@ -287,6 +306,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports defaults being used on the relevant portion of `@param` or `@default`. */
   "jsdoc/no-defaults": 
     | []
     | [
@@ -302,6 +322,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports when certain comment structures are always expected. */
   "jsdoc/no-missing-syntax": 
     | []
     | [
@@ -318,6 +339,7 @@ export interface Rules {
         }
       ];
 
+  /** Prevents use of multiple asterisks at the beginning of lines. */
   "jsdoc/no-multi-asterisks": 
     | []
     | [
@@ -328,6 +350,7 @@ export interface Rules {
         }
       ];
 
+  /** Reports when certain comment structures are present. */
   "jsdoc/no-restricted-syntax": 
     | []
     | [
@@ -343,6 +366,7 @@ export interface Rules {
         }
       ];
 
+  /** This rule reports types being used on `@param` or `@returns`. */
   "jsdoc/no-types": 
     | []
     | [
@@ -357,6 +381,7 @@ export interface Rules {
         }
       ];
 
+  /** Checks that types in jsdoc comments are defined. */
   "jsdoc/no-undefined-types": 
     | []
     | [
@@ -367,6 +392,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each JSDoc line starts with an `*`. */
   "jsdoc/require-asterisk-prefix": 
     | []
     | ["always" | "never" | "any"]
@@ -381,6 +407,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all functions have a description. */
   "jsdoc/require-description": 
     | []
     | [
@@ -400,6 +427,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that block description, explicit `@description`, and `@param`/`@returns` tag descriptions are written in complete sentences. */
   "jsdoc/require-description-complete-sentence": 
     | []
     | [
@@ -410,6 +438,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all functions have examples. */
   "jsdoc/require-example": 
     | []
     | [
@@ -430,6 +459,7 @@ export interface Rules {
         }
       ];
 
+  /** Checks that all files have one `@file`, `@fileoverview`, or `@overview` tag at the beginning of the file. */
   "jsdoc/require-file-overview": 
     | []
     | [
@@ -448,6 +478,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a hyphen before the `@param` description. */
   "jsdoc/require-hyphen-before-param-description": 
     | []
     | ["always" | "never"]
@@ -466,6 +497,7 @@ export interface Rules {
         }
       ];
 
+  /** Require JSDoc comments */
   "jsdoc/require-jsdoc": 
     | []
     | [
@@ -507,6 +539,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all function parameters are documented. */
   "jsdoc/require-param": 
     | []
     | [
@@ -536,6 +569,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each `@param` tag has a `description` value. */
   "jsdoc/require-param-description": 
     | []
     | [
@@ -552,6 +586,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that all function parameters have names. */
   "jsdoc/require-param-name": 
     | []
     | [
@@ -566,6 +601,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that each `@param` tag has a `type` value. */
   "jsdoc/require-param-type": 
     | []
     | [
@@ -582,6 +618,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that returns are documented. */
   "jsdoc/require-returns": 
     | []
     | [
@@ -611,6 +648,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a return statement in function body if a `@returns` tag is specified in jsdoc comment. */
   "jsdoc/require-returns-check": 
     | []
     | [
@@ -621,6 +659,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that the `@returns` tag has a `description` value. */
   "jsdoc/require-returns-description": 
     | []
     | [
@@ -635,6 +674,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that `@returns` tag has `type` value. */
   "jsdoc/require-returns-type": 
     | []
     | [
@@ -649,6 +689,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires template tags for each generic type parameter */
   "jsdoc/require-template": 
     | []
     | [
@@ -658,6 +699,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires that throw statements are documented. */
   "jsdoc/require-throws": 
     | []
     | [
@@ -673,6 +715,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires yields are documented. */
   "jsdoc/require-yields": 
     | []
     | [
@@ -693,6 +736,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires a yield statement in function body if a `@yields` tag is specified in jsdoc comment. */
   "jsdoc/require-yields-check": 
     | []
     | [
@@ -710,6 +754,7 @@ export interface Rules {
         }
       ];
 
+  /** Sorts tags by a specified sequence according to tag name. */
   "jsdoc/sort-tags": 
     | []
     | [
@@ -724,6 +769,7 @@ export interface Rules {
         }
       ];
 
+  /** Enforces lines (or no lines) between tags. */
   "jsdoc/tag-lines": 
     | []
     | ["always" | "any" | "never"]
@@ -747,6 +793,7 @@ export interface Rules {
         }
       ];
 
+  /** Auto-escape certain characters that are input within block and tag descriptions. */
   "jsdoc/text-escaping": 
     | []
     | [
@@ -756,6 +803,7 @@ export interface Rules {
         }
       ];
 
+  /** Formats JSDoc type values. */
   "jsdoc/type-formatting": 
     | []
     | [
@@ -776,6 +824,7 @@ export interface Rules {
         }
       ];
 
+  /** Requires all types to be valid JSDoc or Closure compiler types without syntax errors. */
   "jsdoc/valid-types": 
     | []
     | [