eslint-plugin-jsdoc 52.0.3 → 52.0.4

package/dist/rules/checkParamNames.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkParamNames.js","names":[],"sources":["../../src/rules/checkParamNames.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\n/**\n * @param {string} targetTagName\n * @param {boolean} allowExtraTrailingParamDocs\n * @param {boolean} checkDestructured\n * @param {boolean} checkRestProperty\n * @param {RegExp} checkTypesRegex\n * @param {boolean} disableExtraPropertyReporting\n * @param {boolean} disableMissingParamChecks\n * @param {boolean} enableFixer\n * @param {import('../jsdocUtils.js').ParamNameInfo[]} functionParameterNames\n * @param {import('comment-parser').Block} jsdoc\n * @param {import('../iterateJsdoc.js').Utils} utils\n * @param {import('../iterateJsdoc.js').Report} report\n * @returns {boolean}\n */\nconst validateParameterNames = (\n  targetTagName,\n  allowExtraTrailingParamDocs,\n  checkDestructured,\n  checkRestProperty,\n  checkTypesRegex,\n  disableExtraPropertyReporting,\n  disableMissingParamChecks,\n  enableFixer,\n  functionParameterNames, jsdoc, utils, report,\n) => {\n  const paramTags = Object.entries(jsdoc.tags).filter(([\n    , tag,\n  ]) => {\n    return tag.tag === targetTagName;\n  });\n  const paramTagsNonNested = paramTags.filter(([\n    , tag,\n  ]) => {\n    return !tag.name.includes('.');\n  });\n\n  let dotted = 0;\n  let thisOffset = 0;\n\n  // eslint-disable-next-line complexity\n  return paramTags.some(([\n    , tag,\n  ], index) => {\n    /** @type {import('../iterateJsdoc.js').Integer} */\n    let tagsIndex;\n    const dupeTagInfo = paramTags.find(([\n      tgsIndex,\n      tg,\n    ], idx) => {\n      tagsIndex = Number(tgsIndex);\n\n      return tg.name === tag.name && idx !== index;\n    });\n    if (dupeTagInfo) {\n      utils.reportJSDoc(`Duplicate @${targetTagName} \"${tag.name}\"`, dupeTagInfo[1], enableFixer ? () => {\n        utils.removeTag(tagsIndex);\n      } : null);\n\n      return true;\n    }\n\n    if (tag.name.includes('.')) {\n      dotted++;\n\n      return false;\n    }\n\n    let functionParameterName = functionParameterNames[index - dotted + thisOffset];\n    if (functionParameterName === 'this' && tag.name.trim() !== 'this') {\n      ++thisOffset;\n      functionParameterName = functionParameterNames[index - dotted + thisOffset];\n    }\n\n    if (!functionParameterName) {\n      if (allowExtraTrailingParamDocs) {\n        return false;\n      }\n\n      report(\n        `@${targetTagName} \"${tag.name}\" does not match an existing function parameter.`,\n        null,\n        tag,\n      );\n\n      return true;\n    }\n\n    if (\n      typeof functionParameterName === 'object' &&\n        'name' in functionParameterName &&\n        Array.isArray(functionParameterName.name)\n    ) {\n      const actualName = tag.name.trim();\n      const expectedName = functionParameterName.name[index];\n      if (actualName === expectedName) {\n        thisOffset--;\n        return false;\n      }\n\n      report(\n        `Expected @${targetTagName} name to be \"${expectedName}\". Got \"${actualName}\".`,\n        null,\n        tag,\n      );\n      return true;\n    }\n\n    if (Array.isArray(functionParameterName)) {\n      if (!checkDestructured) {\n        return false;\n      }\n\n      if (tag.type && tag.type.search(checkTypesRegex) === -1) {\n        return false;\n      }\n\n      const [\n        parameterName,\n        {\n          annotationParamName,\n          hasPropertyRest,\n          names: properties,\n          rests,\n        },\n      ] =\n        /**\n         * @type {[string | undefined, import('../jsdocUtils.js').FlattendRootInfo & {\n         *   annotationParamName?: string | undefined;\n          }]} */ (functionParameterName);\n      if (annotationParamName !== undefined) {\n        const name = tag.name.trim();\n        if (name !== annotationParamName) {\n          report(`@${targetTagName} \"${name}\" does not match parameter name \"${annotationParamName}\"`, null, tag);\n        }\n      }\n\n      const tagName = parameterName === undefined ? tag.name.trim() : parameterName;\n      const expectedNames = properties.map((name) => {\n        return `${tagName}.${name}`;\n      });\n      const actualNames = paramTags.map(([\n        , paramTag,\n      ]) => {\n        return paramTag.name.trim();\n      });\n      const actualTypes = paramTags.map(([\n        , paramTag,\n      ]) => {\n        return paramTag.type;\n      });\n\n      const missingProperties = [];\n\n      /** @type {string[]} */\n      const notCheckingNames = [];\n\n      for (const [\n        idx,\n        name,\n      ] of expectedNames.entries()) {\n        if (notCheckingNames.some((notCheckingName) => {\n          return name.startsWith(notCheckingName);\n        })) {\n          continue;\n        }\n\n        const actualNameIdx = actualNames.findIndex((actualName) => {\n          return utils.comparePaths(name)(actualName);\n        });\n        if (actualNameIdx === -1) {\n          if (!checkRestProperty && rests[idx]) {\n            continue;\n          }\n\n          const missingIndex = actualNames.findIndex((actualName) => {\n            return utils.pathDoesNotBeginWith(name, actualName);\n          });\n          const line = tag.source[0].number - 1 + (missingIndex > -1 ? missingIndex : actualNames.length);\n          missingProperties.push({\n            name,\n            tagPlacement: {\n              line: line === 0 ? 1 : line,\n            },\n          });\n        } else if (actualTypes[actualNameIdx].search(checkTypesRegex) === -1 && actualTypes[actualNameIdx] !== '') {\n          notCheckingNames.push(name);\n        }\n      }\n\n      const hasMissing = missingProperties.length;\n      if (hasMissing) {\n        for (const {\n          name: missingProperty,\n          tagPlacement,\n        } of missingProperties) {\n          report(`Missing @${targetTagName} \"${missingProperty}\"`, null, tagPlacement);\n        }\n      }\n\n      if (!hasPropertyRest || checkRestProperty) {\n        /** @type {[string, import('comment-parser').Spec][]} */\n        const extraProperties = [];\n        for (const [\n          idx,\n          name,\n        ] of actualNames.entries()) {\n          const match = name.startsWith(tag.name.trim() + '.');\n          if (\n            match && !expectedNames.some(\n              utils.comparePaths(name),\n            ) && !utils.comparePaths(name)(tag.name) &&\n            (!disableExtraPropertyReporting || properties.some((prop) => {\n              return prop.split('.').length >= name.split('.').length - 1;\n            }))\n          ) {\n            extraProperties.push([\n              name, paramTags[idx][1],\n            ]);\n          }\n        }\n\n        if (extraProperties.length) {\n          for (const [\n            extraProperty,\n            tg,\n          ] of extraProperties) {\n            report(`@${targetTagName} \"${extraProperty}\" does not exist on ${tag.name}`, null, tg);\n          }\n\n          return true;\n        }\n      }\n\n      return hasMissing;\n    }\n\n    let funcParamName;\n    if (typeof functionParameterName === 'object') {\n      const {\n        name,\n      } = functionParameterName;\n      funcParamName = name;\n    } else {\n      funcParamName = functionParameterName;\n    }\n\n    if (funcParamName !== tag.name.trim()) {\n      // Todo: Improve for array or object child items\n      const actualNames = paramTagsNonNested.map(([\n        , {\n          name,\n        },\n      ]) => {\n        return name.trim();\n      });\n\n      const expectedNames = functionParameterNames.map((item, idx) => {\n        if (/**\n             * @type {[string|undefined, (import('../jsdocUtils.js').FlattendRootInfo & {\n             *   annotationParamName?: string,\n              })]} */ (item)?.[1]?.names) {\n          return actualNames[idx];\n        }\n\n        return item;\n      }).filter((item) => {\n        return item !== 'this';\n      });\n\n      // When disableMissingParamChecks is true tag names can be omitted.\n      // Report when the tag names do not match the expected names or they are used out of order.\n      if (disableMissingParamChecks) {\n        const usedExpectedNames = expectedNames.map((a) => {\n          return a?.toString();\n        }).filter((expectedName) => {\n          return expectedName && actualNames.includes(expectedName);\n        });\n        const usedInOrder = actualNames.every((actualName, idx) => {\n          return actualName === usedExpectedNames[idx];\n        });\n        if (usedInOrder) {\n          return false;\n        }\n      }\n\n      report(\n        `Expected @${targetTagName} names to be \"${\n          expectedNames.map((expectedName) => {\n            return typeof expectedName === 'object' &&\n              'name' in expectedName &&\n              expectedName.restElement ?\n              '...' + expectedName.name :\n              expectedName;\n          }).join(', ')\n        }\". Got \"${actualNames.join(', ')}\".`,\n        null,\n        tag,\n      );\n\n      return true;\n    }\n\n    return false;\n  });\n};\n\n/**\n * @param {string} targetTagName\n * @param {boolean} _allowExtraTrailingParamDocs\n * @param {{\n *   name: string,\n *   idx: import('../iterateJsdoc.js').Integer\n * }[]} jsdocParameterNames\n * @param {import('comment-parser').Block} jsdoc\n * @param {Function} report\n * @returns {boolean}\n */\nconst validateParameterNamesDeep = (\n  targetTagName, _allowExtraTrailingParamDocs,\n  jsdocParameterNames, jsdoc, report,\n) => {\n  /** @type {string} */\n  let lastRealParameter;\n\n  return jsdocParameterNames.some(({\n    idx,\n    name: jsdocParameterName,\n  }) => {\n    const isPropertyPath = jsdocParameterName.includes('.');\n\n    if (isPropertyPath) {\n      if (!lastRealParameter) {\n        report(`@${targetTagName} path declaration (\"${jsdocParameterName}\") appears before any real parameter.`, null, jsdoc.tags[idx]);\n\n        return true;\n      }\n\n      let pathRootNodeName = jsdocParameterName.slice(0, jsdocParameterName.indexOf('.'));\n\n      if (pathRootNodeName.endsWith('[]')) {\n        pathRootNodeName = pathRootNodeName.slice(0, -2);\n      }\n\n      if (pathRootNodeName !== lastRealParameter) {\n        report(\n          `@${targetTagName} path declaration (\"${jsdocParameterName}\") root node name (\"${pathRootNodeName}\") ` +\n          `does not match previous real parameter name (\"${lastRealParameter}\").`,\n          null,\n          jsdoc.tags[idx],\n        );\n\n        return true;\n      }\n    } else {\n      lastRealParameter = jsdocParameterName;\n    }\n\n    return false;\n  });\n};\n\nconst allowedNodes = [\n  'ArrowFunctionExpression', 'FunctionDeclaration', 'FunctionExpression', 'TSDeclareFunction',\n  // Add this to above defaults\n  'TSMethodSignature',\n];\n\nexport default iterateJsdoc(({\n  context,\n  jsdoc,\n  node,\n  report,\n  utils,\n}) => {\n  const {\n    allowExtraTrailingParamDocs,\n    checkDestructured = true,\n    checkRestProperty = false,\n    checkTypesPattern = '/^(?:[oO]bject|[aA]rray|PlainObject|Generic(?:Object|Array))$/',\n    disableExtraPropertyReporting = false,\n    disableMissingParamChecks = false,\n    enableFixer = false,\n    useDefaultObjectProperties = false,\n  } = context.options[0] || {};\n\n  // Although we might just remove global settings contexts from applying to\n  //   this rule (as they can cause problems with `getFunctionParameterNames`\n  //   checks if they are not functions but say variables), the user may\n  //   instead wish to narrow contexts in those settings, so this check\n  //   is still useful\n  if (!allowedNodes.includes(/** @type {import('estree').Node} */ (node).type)) {\n    return;\n  }\n\n  const checkTypesRegex = utils.getRegexFromString(checkTypesPattern);\n\n  const jsdocParameterNamesDeep = utils.getJsdocTagsDeep('param');\n  if (!jsdocParameterNamesDeep || !jsdocParameterNamesDeep.length) {\n    return;\n  }\n\n  const functionParameterNames = utils.getFunctionParameterNames(useDefaultObjectProperties);\n\n  const targetTagName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'param',\n  }));\n  const isError = validateParameterNames(\n    targetTagName,\n    allowExtraTrailingParamDocs,\n    checkDestructured,\n    checkRestProperty,\n    checkTypesRegex,\n    disableExtraPropertyReporting,\n    disableMissingParamChecks,\n    enableFixer,\n    functionParameterNames,\n    jsdoc,\n    utils,\n    report,\n  );\n\n  if (isError || !checkDestructured) {\n    return;\n  }\n\n  validateParameterNamesDeep(\n    targetTagName, allowExtraTrailingParamDocs, jsdocParameterNamesDeep, jsdoc, report,\n  );\n}, {\n  contextDefaults: allowedNodes,\n  meta: {\n    docs: {\n      description: 'Ensures that parameter names in JSDoc match those in the function declaration.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-param-names.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          allowExtraTrailingParamDocs: {\n            type: 'boolean',\n          },\n          checkDestructured: {\n            type: 'boolean',\n          },\n          checkRestProperty: {\n            type: 'boolean',\n          },\n          checkTypesPattern: {\n            type: 'string',\n          },\n          disableExtraPropertyReporting: {\n            type: 'boolean',\n          },\n          disableMissingParamChecks: {\n            type: 'boolean',\n          },\n          enableFixer: {\n            type: 'boolean',\n          },\n          useDefaultObjectProperties: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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"}

package/dist/rules/checkPropertyNames.js

@@ -1,88 +0,0 @@
-import iterateJsdoc from "../iterateJsdoc.js";
-
-//#region src/rules/checkPropertyNames.js
-/**
-* @param {string} targetTagName
-* @param {boolean} enableFixer
-* @param {import('comment-parser').Block} jsdoc
-* @param {import('../iterateJsdoc.js').Utils} utils
-* @returns {boolean}
-*/
-const validatePropertyNames = (targetTagName, enableFixer, jsdoc, utils) => {
-	const propertyTags = Object.entries(jsdoc.tags).filter(([, tag]) => {
-		return tag.tag === targetTagName;
-	});
-	return propertyTags.some(([, tag], index) => {
-		/** @type {import('../iterateJsdoc.js').Integer} */
-		let tagsIndex;
-		const dupeTagInfo = propertyTags.find(([tgsIndex, tg], idx) => {
-			tagsIndex = Number(tgsIndex);
-			return tg.name === tag.name && idx !== index;
-		});
-		if (dupeTagInfo) {
-			utils.reportJSDoc(`Duplicate @${targetTagName} "${tag.name}"`, dupeTagInfo[1], enableFixer ? () => {
-				utils.removeTag(tagsIndex);
-			} : null);
-			return true;
-		}
-		return false;
-	});
-};
-/**
-* @param {string} targetTagName
-* @param {{
-*   idx: number;
-*   name: string;
-*   type: string;
-* }[]} jsdocPropertyNames
-* @param {import('comment-parser').Block} jsdoc
-* @param {Function} report
-*/
-const validatePropertyNamesDeep = (targetTagName, jsdocPropertyNames, jsdoc, report) => {
-	/** @type {string} */
-	let lastRealProperty;
-	return jsdocPropertyNames.some(({ idx, name: jsdocPropertyName }) => {
-		const isPropertyPath = jsdocPropertyName.includes(".");
-		if (isPropertyPath) {
-			if (!lastRealProperty) {
-				report(`@${targetTagName} path declaration ("${jsdocPropertyName}") appears before any real property.`, null, jsdoc.tags[idx]);
-				return true;
-			}
-			let pathRootNodeName = jsdocPropertyName.slice(0, jsdocPropertyName.indexOf("."));
-			if (pathRootNodeName.endsWith("[]")) pathRootNodeName = pathRootNodeName.slice(0, -2);
-			if (pathRootNodeName !== lastRealProperty) {
-				report(`@${targetTagName} path declaration ("${jsdocPropertyName}") root node name ("${pathRootNodeName}") does not match previous real property name ("${lastRealProperty}").`, null, jsdoc.tags[idx]);
-				return true;
-			}
-		} else lastRealProperty = jsdocPropertyName;
-		return false;
-	});
-};
-var checkPropertyNames_default = iterateJsdoc(({ context, jsdoc, report, utils }) => {
-	const { enableFixer = false } = context.options[0] || {};
-	const jsdocPropertyNamesDeep = utils.getJsdocTagsDeep("property");
-	if (!jsdocPropertyNamesDeep || !jsdocPropertyNamesDeep.length) return;
-	const targetTagName = utils.getPreferredTagName({ tagName: "property" });
-	const isError = validatePropertyNames(targetTagName, enableFixer, jsdoc, utils);
-	if (isError) return;
-	validatePropertyNamesDeep(targetTagName, jsdocPropertyNamesDeep, jsdoc, report);
-}, {
-	iterateAllJsdocs: true,
-	meta: {
-		docs: {
-			description: "Ensures that property names in JSDoc are not duplicated on the same block and that nested properties have defined roots.",
-			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-property-names.md#repos-sticky-header"
-		},
-		fixable: "code",
-		schema: [{
-			additionalProperties: false,
-			properties: { enableFixer: { type: "boolean" } },
-			type: "object"
-		}],
-		type: "suggestion"
-	}
-});
-
-//#endregion
-export { checkPropertyNames_default as default };
-//# sourceMappingURL=checkPropertyNames.js.map

package/dist/rules/checkPropertyNames.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkPropertyNames.js","names":[],"sources":["../../src/rules/checkPropertyNames.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\n/**\n * @param {string} targetTagName\n * @param {boolean} enableFixer\n * @param {import('comment-parser').Block} jsdoc\n * @param {import('../iterateJsdoc.js').Utils} utils\n * @returns {boolean}\n */\nconst validatePropertyNames = (\n  targetTagName,\n  enableFixer,\n  jsdoc, utils,\n) => {\n  const propertyTags = Object.entries(jsdoc.tags).filter(([\n    , tag,\n  ]) => {\n    return tag.tag === targetTagName;\n  });\n\n  return propertyTags.some(([\n    , tag,\n  ], index) => {\n    /** @type {import('../iterateJsdoc.js').Integer} */\n    let tagsIndex;\n    const dupeTagInfo = propertyTags.find(([\n      tgsIndex,\n      tg,\n    ], idx) => {\n      tagsIndex = Number(tgsIndex);\n\n      return tg.name === tag.name && idx !== index;\n    });\n    if (dupeTagInfo) {\n      utils.reportJSDoc(`Duplicate @${targetTagName} \"${tag.name}\"`, dupeTagInfo[1], enableFixer ? () => {\n        utils.removeTag(tagsIndex);\n      } : null);\n\n      return true;\n    }\n\n    return false;\n  });\n};\n\n/**\n * @param {string} targetTagName\n * @param {{\n *   idx: number;\n *   name: string;\n *   type: string;\n * }[]} jsdocPropertyNames\n * @param {import('comment-parser').Block} jsdoc\n * @param {Function} report\n */\nconst validatePropertyNamesDeep = (\n  targetTagName,\n  jsdocPropertyNames, jsdoc, report,\n) => {\n  /** @type {string} */\n  let lastRealProperty;\n\n  return jsdocPropertyNames.some(({\n    idx,\n    name: jsdocPropertyName,\n  }) => {\n    const isPropertyPath = jsdocPropertyName.includes('.');\n\n    if (isPropertyPath) {\n      if (!lastRealProperty) {\n        report(`@${targetTagName} path declaration (\"${jsdocPropertyName}\") appears before any real property.`, null, jsdoc.tags[idx]);\n\n        return true;\n      }\n\n      let pathRootNodeName = jsdocPropertyName.slice(0, jsdocPropertyName.indexOf('.'));\n\n      if (pathRootNodeName.endsWith('[]')) {\n        pathRootNodeName = pathRootNodeName.slice(0, -2);\n      }\n\n      if (pathRootNodeName !== lastRealProperty) {\n        report(\n          `@${targetTagName} path declaration (\"${jsdocPropertyName}\") root node name (\"${pathRootNodeName}\") ` +\n          `does not match previous real property name (\"${lastRealProperty}\").`,\n          null,\n          jsdoc.tags[idx],\n        );\n\n        return true;\n      }\n    } else {\n      lastRealProperty = jsdocPropertyName;\n    }\n\n    return false;\n  });\n};\n\nexport default iterateJsdoc(({\n  context,\n  jsdoc,\n  report,\n  utils,\n}) => {\n  const {\n    enableFixer = false,\n  } = context.options[0] || {};\n  const jsdocPropertyNamesDeep = utils.getJsdocTagsDeep('property');\n  if (!jsdocPropertyNamesDeep || !jsdocPropertyNamesDeep.length) {\n    return;\n  }\n\n  const targetTagName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'property',\n  }));\n  const isError = validatePropertyNames(\n    targetTagName,\n    enableFixer,\n    jsdoc,\n    utils,\n  );\n\n  if (isError) {\n    return;\n  }\n\n  validatePropertyNamesDeep(\n    targetTagName, jsdocPropertyNamesDeep, jsdoc, report,\n  );\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Ensures that property names in JSDoc are not duplicated on the same block and that nested properties have defined roots.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-property-names.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          enableFixer: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;;;;;;;;AASA,MAAM,wBAAwB,CAC5B,eACA,aACA,OAAO,UACJ;CACH,MAAM,eAAe,OAAO,QAAQ,MAAM,KAAK,CAAC,OAAO,CAAC,GACpD,IACH,KAAK;AACJ,SAAO,IAAI,QAAQ;CACpB,EAAC;AAEF,QAAO,aAAa,KAAK,CAAC,GACtB,IACH,EAAE,UAAU;;EAEX,IAAI;EACJ,MAAM,cAAc,aAAa,KAAK,CAAC,CACrC,UACA,GACD,EAAE,QAAQ;GACT,YAAY,OAAO,SAAS;AAE5B,UAAO,GAAG,SAAS,IAAI,QAAQ,QAAQ;EACxC,EAAC;AACF,MAAI,aAAa;GACf,MAAM,YAAY,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,IAAI,KAAK,CAAC,CAAC,EAAE,YAAY,IAAI,cAAc,MAAM;IACjG,MAAM,UAAU,UAAU;GAC3B,IAAG,KAAK;AAET,UAAO;EACR;AAED,SAAO;CACR,EAAC;AACH;;;;;;;;;;;AAYD,MAAM,4BAA4B,CAChC,eACA,oBAAoB,OAAO,WACxB;;CAEH,IAAI;AAEJ,QAAO,mBAAmB,KAAK,CAAC,EAC9B,KACA,MAAM,mBACP,KAAK;EACJ,MAAM,iBAAiB,kBAAkB,SAAS,IAAI;AAEtD,MAAI,gBAAgB;AAClB,OAAI,CAAC,kBAAkB;IACrB,OAAO,CAAC,CAAC,EAAE,cAAc,oBAAoB,EAAE,kBAAkB,oCAAoC,CAAC,EAAE,MAAM,MAAM,KAAK,KAAK;AAE9H,WAAO;GACR;GAED,IAAI,mBAAmB,kBAAkB,MAAM,GAAG,kBAAkB,QAAQ,IAAI,CAAC;AAEjF,OAAI,iBAAiB,SAAS,KAAK,EACjC,mBAAmB,iBAAiB,MAAM,GAAG,GAAG;AAGlD,OAAI,qBAAqB,kBAAkB;IACzC,OACE,CAAC,CAAC,EAAE,cAAc,oBAAoB,EAAE,kBAAkB,oBAAoB,EAAE,iBAAiB,gDAAG,EACpD,iBAAiB,GAAG,CAAC,EACrE,MACA,MAAM,KAAK,KACZ;AAED,WAAO;GACR;EACF,OACC,mBAAmB;AAGrB,SAAO;CACR,EAAC;AACH;AAED,iCAAe,aAAa,CAAC,EAC3B,SACA,OACA,QACA,OACD,KAAK;CACJ,MAAM,EACJ,cAAc,OACf,GAAG,QAAQ,QAAQ,MAAM,CAAE;CAC5B,MAAM,yBAAyB,MAAM,iBAAiB,WAAW;AACjE,KAAI,CAAC,0BAA0B,CAAC,uBAAuB,OACrD;CAGF,MAAM,gBAAuC,MAAM,oBAAoB,EACrE,SAAS,WACV,EAAC;CACF,MAAM,UAAU,sBACd,eACA,aACA,OACA,MACD;AAED,KAAI,QACF;CAGF,0BACE,eAAe,wBAAwB,OAAO,OAC/C;AACF,GAAE;CACD,kBAAkB;CAClB,MAAM;EACJ,MAAM;GACJ,aAAa;GACb,KAAK;EACN;EACD,SAAS;EACT,QAAQ,CACN;GACE,sBAAsB;GACtB,YAAY,EACV,aAAa,EACX,MAAM,UACP,EACF;GACD,MAAM;EACP,CACF;EACD,MAAM;CACP;AACF,EAAC"}

package/dist/rules/checkSyntax.js

@@ -1,25 +0,0 @@
-import iterateJsdoc from "../iterateJsdoc.js";
-
-//#region src/rules/checkSyntax.js
-var checkSyntax_default = iterateJsdoc(({ jsdoc, report, settings }) => {
-	const { mode } = settings;
-	if (mode === "jsdoc" || mode === "typescript") {
-		for (const tag of jsdoc.tags) if (tag.type.slice(-1) === "=") {
-			report("Syntax should not be Google Closure Compiler style.", null, tag);
-			break;
-		}
-	}
-}, {
-	iterateAllJsdocs: true,
-	meta: {
-		docs: {
-			description: "Reports against syntax not valid for the mode (e.g., Google Closure Compiler in non-Closure mode).",
-			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-syntax.md#repos-sticky-header"
-		},
-		type: "suggestion"
-	}
-});
-
-//#endregion
-export { checkSyntax_default as default };
-//# sourceMappingURL=checkSyntax.js.map

package/dist/rules/checkSyntax.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkSyntax.js","names":[],"sources":["../../src/rules/checkSyntax.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\n\nexport default iterateJsdoc(({\n  jsdoc,\n  report,\n  settings,\n}) => {\n  const {\n    mode,\n  } = settings;\n\n  // Don't check for \"permissive\" and \"closure\"\n  if (mode === 'jsdoc' || mode === 'typescript') {\n    for (const tag of jsdoc.tags) {\n      if (tag.type.slice(-1) === '=') {\n        report('Syntax should not be Google Closure Compiler style.', null, tag);\n        break;\n      }\n    }\n  }\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Reports against syntax not valid for the mode (e.g., Google Closure Compiler in non-Closure mode).',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-syntax.md#repos-sticky-header',\n    },\n    type: 'suggestion',\n  },\n});\n"],"mappings":";;;AAEA,0BAAe,aAAa,CAAC,EAC3B,OACA,QACA,UACD,KAAK;CACJ,MAAM,EACJ,MACD,GAAG;AAGJ,KAAI,SAAS,WAAW,SAAS,cAC/B;OAAK,MAAM,OAAO,MAAM,KACtB,KAAI,IAAI,KAAK,MAAM,GAAG,KAAK,KAAK;GAC9B,OAAO,uDAAuD,MAAM,IAAI;AACxE;EACD;CACF;AAEJ,GAAE;CACD,kBAAkB;CAClB,MAAM;EACJ,MAAM;GACJ,aAAa;GACb,KAAK;EACN;EACD,MAAM;CACP;AACF,EAAC"}

package/dist/rules/checkTagNames.js

@@ -1,191 +0,0 @@
-import iterateJsdoc from "../iterateJsdoc.js";
-import escapeStringRegexp from "escape-string-regexp";
-
-//#region src/rules/checkTagNames.js
-const jsxTagNames = new Set([
-	"jsx",
-	"jsxFrag",
-	"jsxImportSource",
-	"jsxRuntime"
-]);
-const typedTagsAlwaysUnnecessary = new Set([
-	"augments",
-	"callback",
-	"class",
-	"enum",
-	"implements",
-	"private",
-	"property",
-	"protected",
-	"public",
-	"readonly",
-	"this",
-	"type",
-	"typedef"
-]);
-const typedTagsNeedingName = new Set(["template"]);
-const typedTagsUnnecessaryOutsideDeclare = new Set([
-	"abstract",
-	"access",
-	"class",
-	"constant",
-	"constructs",
-	"default",
-	"enum",
-	"export",
-	"exports",
-	"function",
-	"global",
-	"inherits",
-	"instance",
-	"interface",
-	"member",
-	"memberof",
-	"memberOf",
-	"method",
-	"mixes",
-	"mixin",
-	"module",
-	"name",
-	"namespace",
-	"override",
-	"property",
-	"requires",
-	"static",
-	"this"
-]);
-var checkTagNames_default = iterateJsdoc(({ context, jsdoc, jsdocNode, node, report, settings, sourceCode, utils }) => {
-	const { definedTags = [], enableFixer = true, jsxTags, typed } = context.options[0] || {};
-	/** @type {(string|undefined)[]} */
-	let definedPreferredTags = [];
-	const { structuredTags, tagNamePreference } = settings;
-	const definedStructuredTags = Object.keys(structuredTags);
-	const definedNonPreferredTags = Object.keys(tagNamePreference);
-	if (definedNonPreferredTags.length) definedPreferredTags = Object.values(tagNamePreference).map((preferredTag) => {
-		if (typeof preferredTag === "string") return preferredTag;
-		if (!preferredTag) return void 0;
-		if (typeof preferredTag !== "object") utils.reportSettings("Invalid `settings.jsdoc.tagNamePreference`. Values must be falsy, a string, or an object.");
-		return preferredTag.replacement;
-	}).filter(Boolean);
-	/**
-	* @param {import('eslint').Rule.Node} subNode
-	* @returns {boolean}
-	*/
-	const isInAmbientContext = (subNode) => {
-		return subNode.type === "Program" ? context.getFilename().endsWith(".d.ts") : Boolean(
-			/** @type {import('@typescript-eslint/types').TSESTree.VariableDeclaration} */
-			subNode.declare
-		) || isInAmbientContext(subNode.parent);
-	};
-	/**
-	* @param {import('comment-parser').Spec} jsdocTag
-	* @returns {boolean}
-	*/
-	const tagIsRedundantWhenTyped = (jsdocTag) => {
-		if (!typedTagsUnnecessaryOutsideDeclare.has(jsdocTag.tag)) return false;
-		if (jsdocTag.tag === "default") return false;
-		if (node === null) return false;
-		if (context.getFilename().endsWith(".d.ts") && [
-			null,
-			"Program",
-			void 0
-		].includes(node?.parent?.type)) return false;
-		if (isInAmbientContext(node)) return false;
-		return true;
-	};
-	/**
-	* @param {string} message
-	* @param {import('comment-parser').Spec} jsdocTag
-	* @param {import('../iterateJsdoc.js').Integer} tagIndex
-	* @param {Partial<import('comment-parser').Tokens>} [additionalTagChanges]
-	* @returns {void}
-	*/
-	const reportWithTagRemovalFixer = (message, jsdocTag, tagIndex, additionalTagChanges) => {
-		utils.reportJSDoc(message, jsdocTag, enableFixer ? () => {
-			if (jsdocTag.description.trim()) utils.changeTag(jsdocTag, {
-				postType: "",
-				type: "",
-				...additionalTagChanges
-			});
-			else utils.removeTag(tagIndex, { removeEmptyBlock: true });
-		} : null, true);
-	};
-	/**
-	* @param {import('comment-parser').Spec} jsdocTag
-	* @param {import('../iterateJsdoc.js').Integer} tagIndex
-	* @returns {boolean}
-	*/
-	const checkTagForTypedValidity = (jsdocTag, tagIndex) => {
-		if (typedTagsAlwaysUnnecessary.has(jsdocTag.tag)) {
-			reportWithTagRemovalFixer(`'@${jsdocTag.tag}' is redundant when using a type system.`, jsdocTag, tagIndex, {
-				postTag: "",
-				tag: ""
-			});
-			return true;
-		}
-		if (tagIsRedundantWhenTyped(jsdocTag)) {
-			reportWithTagRemovalFixer(`'@${jsdocTag.tag}' is redundant outside of ambient (\`declare\`/\`.d.ts\`) contexts when using a type system.`, jsdocTag, tagIndex);
-			return true;
-		}
-		if (typedTagsNeedingName.has(jsdocTag.tag) && !jsdocTag.name) {
-			reportWithTagRemovalFixer(`'@${jsdocTag.tag}' without a name is redundant when using a type system.`, jsdocTag, tagIndex);
-			return true;
-		}
-		return false;
-	};
-	for (let tagIndex = 0; tagIndex < jsdoc.tags.length; tagIndex += 1) {
-		const jsdocTag = jsdoc.tags[tagIndex];
-		const tagName = jsdocTag.tag;
-		if (jsxTags && jsxTagNames.has(tagName)) continue;
-		if (typed && checkTagForTypedValidity(jsdocTag, tagIndex)) continue;
-		const validTags = [
-			...definedTags,
-			...definedPreferredTags,
-			...definedNonPreferredTags,
-			...definedStructuredTags,
-			...typed ? typedTagsNeedingName : []
-		];
-		if (utils.isValidTag(tagName, validTags)) {
-			let preferredTagName = utils.getPreferredTagName({
-				allowObjectReturn: true,
-				defaultMessage: `Blacklisted tag found (\`@${tagName}\`)`,
-				tagName
-			});
-			if (!preferredTagName) continue;
-			let message;
-			if (typeof preferredTagName === "object") ({message, replacement: preferredTagName} = preferredTagName);
-			if (!message) message = `Invalid JSDoc tag (preference). Replace "${tagName}" JSDoc tag with "${preferredTagName}".`;
-			if (preferredTagName !== tagName) report(message, (fixer) => {
-				const replacement = sourceCode.getText(jsdocNode).replace(new RegExp(`@${escapeStringRegexp(tagName)}\\b`, "v"), `@${preferredTagName}`);
-				return fixer.replaceText(jsdocNode, replacement);
-			}, jsdocTag);
-		} else report(`Invalid JSDoc tag name "${tagName}".`, null, jsdocTag);
-	}
-}, {
-	iterateAllJsdocs: true,
-	meta: {
-		docs: {
-			description: "Reports invalid block tag names.",
-			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-tag-names.md#repos-sticky-header"
-		},
-		fixable: "code",
-		schema: [{
-			additionalProperties: false,
-			properties: {
-				definedTags: {
-					items: { type: "string" },
-					type: "array"
-				},
-				enableFixer: { type: "boolean" },
-				jsxTags: { type: "boolean" },
-				typed: { type: "boolean" }
-			},
-			type: "object"
-		}],
-		type: "suggestion"
-	}
-});
-
-//#endregion
-export { checkTagNames_default as default };
-//# sourceMappingURL=checkTagNames.js.map

package/dist/rules/checkTagNames.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkTagNames.js","names":[],"sources":["../../src/rules/checkTagNames.js"],"sourcesContent":["import iterateJsdoc from '../iterateJsdoc.js';\nimport escapeStringRegexp from 'escape-string-regexp';\n\n// https://babeljs.io/docs/en/babel-plugin-transform-react-jsx/\nconst jsxTagNames = new Set([\n  'jsx',\n  'jsxFrag',\n  'jsxImportSource',\n  'jsxRuntime',\n]);\n\nconst typedTagsAlwaysUnnecessary = new Set([\n  'augments',\n  'callback',\n  'class',\n  'enum',\n  'implements',\n  'private',\n  'property',\n  'protected',\n  'public',\n  'readonly',\n  'this',\n  'type',\n  'typedef',\n]);\n\nconst typedTagsNeedingName = new Set([\n  'template',\n]);\n\nconst typedTagsUnnecessaryOutsideDeclare = new Set([\n  'abstract',\n  'access',\n  'class',\n  'constant',\n  'constructs',\n  'default',\n  'enum',\n  'export',\n  'exports',\n  'function',\n  'global',\n  'inherits',\n  'instance',\n  'interface',\n  'member',\n  'memberof',\n  'memberOf',\n  'method',\n  'mixes',\n  'mixin',\n  'module',\n  'name',\n  'namespace',\n  'override',\n  'property',\n  'requires',\n  'static',\n  'this',\n]);\n\nexport default iterateJsdoc(({\n  context,\n  jsdoc,\n  jsdocNode,\n  node,\n  report,\n  settings,\n  sourceCode,\n  utils,\n}) => {\n  const\n    /**\n     * @type {{\n     *   definedTags: string[],\n     *   enableFixer: boolean,\n     *   jsxTags: boolean,\n     *   typed: boolean\n     }} */ {\n      definedTags = [],\n      enableFixer = true,\n      jsxTags,\n      typed,\n    } = context.options[0] || {};\n\n  /** @type {(string|undefined)[]} */\n  let definedPreferredTags = [];\n  const {\n    structuredTags,\n    tagNamePreference,\n  } = settings;\n  const definedStructuredTags = Object.keys(structuredTags);\n  const definedNonPreferredTags = Object.keys(tagNamePreference);\n  if (definedNonPreferredTags.length) {\n    definedPreferredTags = Object.values(tagNamePreference).map((preferredTag) => {\n      if (typeof preferredTag === 'string') {\n        // May become an empty string but will be filtered out below\n        return preferredTag;\n      }\n\n      if (!preferredTag) {\n        return undefined;\n      }\n\n      if (typeof preferredTag !== 'object') {\n        utils.reportSettings(\n          'Invalid `settings.jsdoc.tagNamePreference`. Values must be falsy, a string, or an object.',\n        );\n      }\n\n      return preferredTag.replacement;\n    })\n      .filter(Boolean);\n  }\n\n  /**\n   * @param {import('eslint').Rule.Node} subNode\n   * @returns {boolean}\n   */\n  const isInAmbientContext = (subNode) => {\n    return subNode.type === 'Program' ?\n      context.getFilename().endsWith('.d.ts') :\n      Boolean(\n        /** @type {import('@typescript-eslint/types').TSESTree.VariableDeclaration} */ (\n          subNode\n        ).declare,\n      ) || isInAmbientContext(subNode.parent);\n  };\n\n  /**\n   * @param {import('comment-parser').Spec} jsdocTag\n   * @returns {boolean}\n   */\n  const tagIsRedundantWhenTyped = (jsdocTag) => {\n    if (!typedTagsUnnecessaryOutsideDeclare.has(jsdocTag.tag)) {\n      return false;\n    }\n\n    if (jsdocTag.tag === 'default') {\n      return false;\n    }\n\n    if (node === null) {\n      return false;\n    }\n\n    if (context.getFilename().endsWith('.d.ts') && [\n      null, 'Program', undefined,\n    ].includes(node?.parent?.type)) {\n      return false;\n    }\n\n    if (isInAmbientContext(/** @type {import('eslint').Rule.Node} */ (node))) {\n      return false;\n    }\n\n    return true;\n  };\n\n  /**\n   * @param {string} message\n   * @param {import('comment-parser').Spec} jsdocTag\n   * @param {import('../iterateJsdoc.js').Integer} tagIndex\n   * @param {Partial<import('comment-parser').Tokens>} [additionalTagChanges]\n   * @returns {void}\n   */\n  const reportWithTagRemovalFixer = (message, jsdocTag, tagIndex, additionalTagChanges) => {\n    utils.reportJSDoc(message, jsdocTag, enableFixer ? () => {\n      if (jsdocTag.description.trim()) {\n        utils.changeTag(jsdocTag, {\n          postType: '',\n          type: '',\n          ...additionalTagChanges,\n        });\n      } else {\n        utils.removeTag(tagIndex, {\n          removeEmptyBlock: true,\n        });\n      }\n    } : null, true);\n  };\n\n  /**\n   * @param {import('comment-parser').Spec} jsdocTag\n   * @param {import('../iterateJsdoc.js').Integer} tagIndex\n   * @returns {boolean}\n   */\n  const checkTagForTypedValidity = (jsdocTag, tagIndex) => {\n    if (typedTagsAlwaysUnnecessary.has(jsdocTag.tag)) {\n      reportWithTagRemovalFixer(\n        `'@${jsdocTag.tag}' is redundant when using a type system.`,\n        jsdocTag,\n        tagIndex,\n        {\n          postTag: '',\n          tag: '',\n        },\n      );\n      return true;\n    }\n\n    if (tagIsRedundantWhenTyped(jsdocTag)) {\n      reportWithTagRemovalFixer(\n        `'@${jsdocTag.tag}' is redundant outside of ambient (\\`declare\\`/\\`.d.ts\\`) contexts when using a type system.`,\n        jsdocTag,\n        tagIndex,\n      );\n      return true;\n    }\n\n    if (typedTagsNeedingName.has(jsdocTag.tag) && !jsdocTag.name) {\n      reportWithTagRemovalFixer(\n        `'@${jsdocTag.tag}' without a name is redundant when using a type system.`,\n        jsdocTag,\n        tagIndex,\n      );\n      return true;\n    }\n\n    return false;\n  };\n\n  for (let tagIndex = 0; tagIndex < jsdoc.tags.length; tagIndex += 1) {\n    const jsdocTag = jsdoc.tags[tagIndex];\n    const tagName = jsdocTag.tag;\n    if (jsxTags && jsxTagNames.has(tagName)) {\n      continue;\n    }\n\n    if (typed && checkTagForTypedValidity(jsdocTag, tagIndex)) {\n      continue;\n    }\n\n    const validTags = [\n      ...definedTags,\n      ...(/** @type {string[]} */ (definedPreferredTags)),\n      ...definedNonPreferredTags,\n      ...definedStructuredTags,\n      ...typed ? typedTagsNeedingName : [],\n    ];\n\n    if (utils.isValidTag(tagName, validTags)) {\n      let preferredTagName = utils.getPreferredTagName({\n        allowObjectReturn: true,\n        defaultMessage: `Blacklisted tag found (\\`@${tagName}\\`)`,\n        tagName,\n      });\n      if (!preferredTagName) {\n        continue;\n      }\n\n      let message;\n      if (typeof preferredTagName === 'object') {\n        ({\n          message,\n          replacement: preferredTagName,\n        } = /** @type {{message: string; replacement?: string | undefined;}} */ (\n          preferredTagName\n        ));\n      }\n\n      if (!message) {\n        message = `Invalid JSDoc tag (preference). Replace \"${tagName}\" JSDoc tag with \"${preferredTagName}\".`;\n      }\n\n      if (preferredTagName !== tagName) {\n        report(message, (fixer) => {\n          const replacement = sourceCode.getText(jsdocNode).replace(\n            new RegExp(`@${escapeStringRegexp(tagName)}\\\\b`, 'v'),\n            `@${preferredTagName}`,\n          );\n\n          return fixer.replaceText(jsdocNode, replacement);\n        }, jsdocTag);\n      }\n    } else {\n      report(`Invalid JSDoc tag name \"${tagName}\".`, null, jsdocTag);\n    }\n  }\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Reports invalid block tag names.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-tag-names.md#repos-sticky-header',\n    },\n    fixable: 'code',\n    schema: [\n      {\n        additionalProperties: false,\n        properties: {\n          definedTags: {\n            items: {\n              type: 'string',\n            },\n            type: 'array',\n          },\n          enableFixer: {\n            type: 'boolean',\n          },\n          jsxTags: {\n            type: 'boolean',\n          },\n          typed: {\n            type: 'boolean',\n          },\n        },\n        type: 'object',\n      },\n    ],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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"}

package/dist/rules/checkTemplateNames.js

@@ -1,124 +0,0 @@
-import { getTags } from "../jsdocUtils.js";
-import iterateJsdoc, { parseComment } from "../iterateJsdoc.js";
-import { getJSDocComment, parse, traverse, tryParse } from "@es-joy/jsdoccomment";
-
-//#region src/rules/checkTemplateNames.js
-var checkTemplateNames_default = iterateJsdoc(({ jsdoc, node, report, settings, sourceCode, utils }) => {
-	const { mode } = settings;
-	const templateTags = utils.getTags("template");
-	const usedNames = /* @__PURE__ */ new Set();
-	/**
-	* @param {string} potentialType
-	*/
-	const checkForUsedTypes = (potentialType) => {
-		let parsedType;
-		try {
-			parsedType = mode === "permissive" ? tryParse(potentialType) : parse(potentialType, mode);
-		} catch {
-			return;
-		}
-		traverse(parsedType, (nde) => {
-			const { type, value } = nde;
-			if (type === "JsdocTypeName") usedNames.add(value);
-		});
-	};
-	const checkParamsAndReturnsTags = (jsdc = jsdoc) => {
-		const paramName = utils.getPreferredTagName({ tagName: "param" });
-		const paramTags = getTags(jsdc, paramName);
-		for (const paramTag of paramTags) checkForUsedTypes(paramTag.type);
-		const returnsName = utils.getPreferredTagName({ tagName: "returns" });
-		const returnsTags = getTags(jsdc, returnsName);
-		for (const returnsTag of returnsTags) checkForUsedTypes(returnsTag.type);
-	};
-	const checkTemplateTags = () => {
-		for (const tag of templateTags) {
-			const { name } = tag;
-			const names = name.split(/,\s*/v);
-			for (const nme of names) if (!usedNames.has(nme)) report(`@template ${nme} not in use`, null, tag);
-		}
-	};
-	/**
-	* @param {import('@typescript-eslint/types').TSESTree.FunctionDeclaration|
-	*   import('@typescript-eslint/types').TSESTree.ClassDeclaration|
-	*   import('@typescript-eslint/types').TSESTree.TSInterfaceDeclaration|
-	*   import('@typescript-eslint/types').TSESTree.TSTypeAliasDeclaration} aliasDeclaration
-	* @param {boolean} [checkParamsAndReturns]
-	*/
-	const checkParameters = (aliasDeclaration, checkParamsAndReturns) => {
-		/* c8 ignore next -- Guard */
-		const { params } = aliasDeclaration.typeParameters ?? { params: [] };
-		for (const { name: { name } } of params) usedNames.add(name);
-		if (checkParamsAndReturns) checkParamsAndReturnsTags();
-		else if (aliasDeclaration.type === "ClassDeclaration")
- /* c8 ignore next -- TS */
-		for (const nde of aliasDeclaration?.body?.body ?? []) {
-			const commentNode = getJSDocComment(sourceCode, nde, settings);
-			if (!commentNode) continue;
-			const innerJsdoc = parseComment(commentNode, "");
-			checkParamsAndReturnsTags(innerJsdoc);
-			const typeName = utils.getPreferredTagName({ tagName: "type" });
-			const typeTags = getTags(innerJsdoc, typeName);
-			for (const typeTag of typeTags) checkForUsedTypes(typeTag.type);
-		}
-		checkTemplateTags();
-	};
-	const handleTypeAliases = () => {
-		const nde = node;
-		if (!nde) return;
-		switch (nde.type) {
-			case "ClassDeclaration":
-			case "TSInterfaceDeclaration":
-			case "TSTypeAliasDeclaration":
-				checkParameters(nde);
-				break;
-			case "ExportDefaultDeclaration":
-			case "ExportNamedDeclaration":
-				switch (nde.declaration?.type) {
-					case "ClassDeclaration":
-					case "TSInterfaceDeclaration":
-					case "TSTypeAliasDeclaration":
-						checkParameters(nde.declaration);
-						break;
-					case "FunctionDeclaration":
-						checkParameters(nde.declaration, true);
-						break;
-				}
-				break;
-			case "FunctionDeclaration":
-				checkParameters(nde, true);
-				break;
-		}
-	};
-	const callbackTags = utils.getTags("callback");
-	const functionTags = utils.getTags("function");
-	if (callbackTags.length || functionTags.length) {
-		checkParamsAndReturnsTags();
-		checkTemplateTags();
-		return;
-	}
-	const typedefTags = utils.getTags("typedef");
-	if (!typedefTags.length || typedefTags.length >= 2) {
-		handleTypeAliases();
-		return;
-	}
-	const potentialTypedefType = typedefTags[0].type;
-	checkForUsedTypes(potentialTypedefType);
-	const propertyName = utils.getPreferredTagName({ tagName: "property" });
-	const propertyTags = utils.getTags(propertyName);
-	for (const propertyTag of propertyTags) checkForUsedTypes(propertyTag.type);
-	checkTemplateTags();
-}, {
-	iterateAllJsdocs: true,
-	meta: {
-		docs: {
-			description: "Checks that any `@template` names are actually used in the connected `@typedef` or type alias.",
-			url: "https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-template-names.md#repos-sticky-header"
-		},
-		schema: [],
-		type: "suggestion"
-	}
-});
-
-//#endregion
-export { checkTemplateNames_default as default };
-//# sourceMappingURL=checkTemplateNames.js.map

package/dist/rules/checkTemplateNames.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"checkTemplateNames.js","names":["tryParseType","parseType"],"sources":["../../src/rules/checkTemplateNames.js"],"sourcesContent":["import iterateJsdoc, {\n  parseComment,\n} from '../iterateJsdoc.js';\nimport {\n  getTags,\n} from '../jsdocUtils.js';\nimport {\n  getJSDocComment,\n  parse as parseType,\n  traverse,\n  tryParse as tryParseType,\n} from '@es-joy/jsdoccomment';\n\nexport default iterateJsdoc(({\n  jsdoc,\n  node,\n  report,\n  settings,\n  sourceCode,\n  utils,\n}) => {\n  const {\n    mode,\n  } = settings;\n\n  const templateTags = utils.getTags('template');\n\n  const usedNames = new Set();\n  /**\n   * @param {string} potentialType\n   */\n  const checkForUsedTypes = (potentialType) => {\n    let parsedType;\n    try {\n      parsedType = mode === 'permissive' ?\n        tryParseType(/** @type {string} */ (potentialType)) :\n        parseType(/** @type {string} */ (potentialType), mode);\n    } catch {\n      return;\n    }\n\n    traverse(parsedType, (nde) => {\n      const {\n        type,\n        value,\n      } = /** @type {import('jsdoc-type-pratt-parser').NameResult} */ (nde);\n      if (type === 'JsdocTypeName') {\n        usedNames.add(value);\n      }\n    });\n  };\n\n  const checkParamsAndReturnsTags = (jsdc = jsdoc) => {\n    const paramName = /** @type {string} */ (utils.getPreferredTagName({\n      tagName: 'param',\n    }));\n    const paramTags = getTags(jsdc, paramName);\n    for (const paramTag of paramTags) {\n      checkForUsedTypes(paramTag.type);\n    }\n\n    const returnsName = /** @type {string} */ (utils.getPreferredTagName({\n      tagName: 'returns',\n    }));\n    const returnsTags = getTags(jsdc, returnsName);\n    for (const returnsTag of returnsTags) {\n      checkForUsedTypes(returnsTag.type);\n    }\n  };\n\n  const checkTemplateTags = () => {\n    for (const tag of templateTags) {\n      const {\n        name,\n      } = tag;\n      const names = name.split(/,\\s*/v);\n      for (const nme of names) {\n        if (!usedNames.has(nme)) {\n          report(`@template ${nme} not in use`, null, tag);\n        }\n      }\n    }\n  };\n\n  /**\n   * @param {import('@typescript-eslint/types').TSESTree.FunctionDeclaration|\n   *   import('@typescript-eslint/types').TSESTree.ClassDeclaration|\n   *   import('@typescript-eslint/types').TSESTree.TSInterfaceDeclaration|\n   *   import('@typescript-eslint/types').TSESTree.TSTypeAliasDeclaration} aliasDeclaration\n   * @param {boolean} [checkParamsAndReturns]\n   */\n  const checkParameters = (aliasDeclaration, checkParamsAndReturns) => {\n    /* c8 ignore next -- Guard */\n    const {\n      params,\n    } = aliasDeclaration.typeParameters ?? {\n      params: [],\n    };\n    for (const {\n      name: {\n        name,\n      },\n    } of params) {\n      usedNames.add(name);\n    }\n\n    if (checkParamsAndReturns) {\n      checkParamsAndReturnsTags();\n    } else if (aliasDeclaration.type === 'ClassDeclaration') {\n      /* c8 ignore next -- TS */\n      for (const nde of aliasDeclaration?.body?.body ?? []) {\n        // @ts-expect-error Should be ok\n        const commentNode = getJSDocComment(sourceCode, nde, settings);\n        if (!commentNode) {\n          continue;\n        }\n\n        const innerJsdoc = parseComment(commentNode, '');\n        checkParamsAndReturnsTags(innerJsdoc);\n\n        const typeName = /** @type {string} */ (utils.getPreferredTagName({\n          tagName: 'type',\n        }));\n        const typeTags = getTags(innerJsdoc, typeName);\n        for (const typeTag of typeTags) {\n          checkForUsedTypes(typeTag.type);\n        }\n      }\n    }\n\n    checkTemplateTags();\n  };\n\n  const handleTypeAliases = () => {\n    const nde = /** @type {import('@typescript-eslint/types').TSESTree.Node} */ (\n      node\n    );\n    if (!nde) {\n      return;\n    }\n\n    switch (nde.type) {\n      case 'ClassDeclaration':\n      case 'TSInterfaceDeclaration':\n      case 'TSTypeAliasDeclaration':\n        checkParameters(nde);\n        break;\n      case 'ExportDefaultDeclaration':\n      case 'ExportNamedDeclaration':\n        switch (nde.declaration?.type) {\n          case 'ClassDeclaration':\n          case 'TSInterfaceDeclaration':\n          case 'TSTypeAliasDeclaration':\n            checkParameters(nde.declaration);\n            break;\n          case 'FunctionDeclaration':\n            checkParameters(nde.declaration, true);\n            break;\n        }\n\n        break;\n      case 'FunctionDeclaration':\n        checkParameters(nde, true);\n        break;\n    }\n  };\n\n  const callbackTags = utils.getTags('callback');\n  const functionTags = utils.getTags('function');\n  if (callbackTags.length || functionTags.length) {\n    checkParamsAndReturnsTags();\n    checkTemplateTags();\n    return;\n  }\n\n  const typedefTags = utils.getTags('typedef');\n  if (!typedefTags.length || typedefTags.length >= 2) {\n    handleTypeAliases();\n    return;\n  }\n\n  const potentialTypedefType = typedefTags[0].type;\n  checkForUsedTypes(potentialTypedefType);\n\n  const propertyName = /** @type {string} */ (utils.getPreferredTagName({\n    tagName: 'property',\n  }));\n  const propertyTags = utils.getTags(propertyName);\n  for (const propertyTag of propertyTags) {\n    checkForUsedTypes(propertyTag.type);\n  }\n\n  checkTemplateTags();\n}, {\n  iterateAllJsdocs: true,\n  meta: {\n    docs: {\n      description: 'Checks that any `@template` names are actually used in the connected `@typedef` or type alias.',\n      url: 'https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-template-names.md#repos-sticky-header',\n    },\n    schema: [],\n    type: 'suggestion',\n  },\n});\n"],"mappings":"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"}