eslint-plugin-jsdoc 61.1.11 → 61.2.0

package/src/rules/noUndefinedTypes.js

@@ -466,6 +466,16 @@ export default iterateJsdoc(({
     return utils.isNamepathOrUrlReferencingTag(tag);
   }).map(tagToParsedType('namepathOrURL'));
 
+  const definedNamesAndNamepaths = new Set(utils.filterTags(({
+    tag,
+  }) => {
+    return utils.isNameOrNamepathDefiningTag(tag);
+  }).map(({
+    name,
+  }) => {
+    return name;
+  }));
+
   const tagsWithTypes = /** @type {TypeAndTagInfo[]} */ ([
     ...typeTags,
     ...namepathReferencingTags,
@@ -520,6 +530,7 @@ export default iterateJsdoc(({
       if (type === 'JsdocTypeName') {
         const structuredTypes = structuredTags[tag.tag]?.type;
         if (!allDefinedTypes.has(val) &&
+          !definedNamesAndNamepaths.has(val) &&
           (!Array.isArray(structuredTypes) || !structuredTypes.includes(val))
         ) {
           const parent =

package/src/rules/requireFileOverview.js

@@ -207,7 +207,7 @@ will be checked, but you must use \`file\` on the configuration object).`,
     state,
   }) {
     if (!state.hasNonComment) {
-      state.hasNonComment = node.range[0];
+      state.hasNonComment = /** @type {[number, number]} */ (node.range)?.[0];
     }
   },
 });

package/src/rules/requireJsdoc.js

@@ -670,6 +670,7 @@ export default {
 
         const decorator = getDecorator(
           /** @type {import('eslint').Rule.Node} */
+          // @ts-expect-error Bug?
           (baseNode),
         );
         if (decorator) {

package/src/rules/requireParam.js

@@ -74,7 +74,7 @@ export default iterateJsdoc(({
       return;
     }
 
-    if (node && node.parent.type === 'VariableDeclarator' &&
+    if (node && node.parent?.type === 'VariableDeclarator' &&
         'typeAnnotation' in node.parent.id && node.parent.id.typeAnnotation) {
       return;
     }

package/src/rules/sortTags.js

@@ -5,11 +5,13 @@ export default iterateJsdoc(({
   context,
   jsdoc,
   utils,
+// eslint-disable-next-line complexity -- Temporary
 }) => {
   const
     /**
      * @type {{
      *   linesBetween: import('../iterateJsdoc.js').Integer,
+     *   tagExceptions: Record<string, number>,
      *   tagSequence: {
      *     tags: string[]
      *   }[],
@@ -22,6 +24,7 @@ export default iterateJsdoc(({
       linesBetween = 1,
       reportIntraTagGroupSpacing = true,
       reportTagGroupSpacing = true,
+      tagExceptions = {},
       tagSequence = defaultTagOrder,
     } = context.options[0] || {};
 
@@ -328,7 +331,7 @@ export default iterateJsdoc(({
       }
 
       const ct = countTagEmptyLines(tag);
-      if (ct) {
+      if (ct && (!tagExceptions[tag.tag] || tagExceptions[tag.tag] < ct)) {
         const fixer = () => {
           let foundFirstTag = false;
 
@@ -548,6 +551,15 @@ will not have spacing applied regardless. For adding line breaks there, you
 may wish to use the \`endLines\` option of the \`tag-lines\` rule.`,
             type: 'boolean',
           },
+          tagExceptions: {
+            description: 'Allows specification by tag of a specific higher maximum number of lines. Keys are tags and values are the maximum number of lines allowed for such tags. Overrides `linesBetween`. Defaults to no special exceptions per tag.',
+            patternProperties: {
+              '.*': {
+                type: 'number',
+              },
+            },
+            type: 'object',
+          },
           tagSequence: {
             description: `An array of tag group objects indicating the preferred sequence for sorting tags.
 

package/src/rules.d.ts

@@ -2660,6 +2660,16 @@ export interface Rules {
            * may wish to use the `endLines` option of the `tag-lines` rule.
            */
           reportTagGroupSpacing?: boolean;
+          /**
+           * Allows specification by tag of a specific higher maximum number of lines. Keys are tags and values are the maximum number of lines allowed for such tags. Overrides `linesBetween`. Defaults to no special exceptions per tag.
+           */
+          tagExceptions?: {
+            /**
+             * This interface was referenced by `undefined`'s JSON-Schema definition
+             * via the `patternProperty` ".*".
+             */
+            [k: string]: number;
+          };
           /**
            * An array of tag group objects indicating the preferred sequence for sorting tags.
            *