feat: update jsdoccomment, debug, devDeps.; fixes #1304

Author: brettz9

docs/rules/require-hyphen-before-param-description.md

@@ -277,5 +277,13 @@ function quux () {
 function main(argv) {
 };
 // "jsdoc/require-hyphen-before-param-description": ["error"|"warn", "never"]
+
+/**
+ * @template {any} T - Arg 1
+ * @template {string | number} K - Arg 2
+ * @template {any} [R=(K extends keyof T ? T[K] : never)] - Arg 3  ->  Errors here
+ * @typedef {any} Test
+ */
+// "jsdoc/require-hyphen-before-param-description": ["error"|"warn", "always",{"tags":{"template":"always"}}]
 ````
 

package.json

@@ -5,10 +5,10 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.46.0",
+    "@es-joy/jsdoccomment": "~0.48.0",
     "are-docs-informative": "^0.0.2",
     "comment-parser": "1.4.1",
-    "debug": "^4.3.5",
+    "debug": "^4.3.6",
     "escape-string-regexp": "^4.0.0",
     "espree": "^10.1.0",
     "esquery": "^1.6.0",
@@ -20,31 +20,31 @@
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
     "@babel/cli": "^7.24.8",
-    "@babel/core": "^7.24.9",
-    "@babel/eslint-parser": "^7.24.8",
-    "@babel/node": "^7.24.8",
+    "@babel/core": "^7.25.2",
+    "@babel/eslint-parser": "^7.25.1",
+    "@babel/node": "^7.25.0",
     "@babel/plugin-syntax-class-properties": "^7.12.13",
-    "@babel/plugin-transform-flow-strip-types": "^7.24.7",
-    "@babel/preset-env": "^7.24.8",
+    "@babel/plugin-transform-flow-strip-types": "^7.25.2",
+    "@babel/preset-env": "^7.25.3",
     "@es-joy/escodegen": "^3.5.1",
     "@es-joy/jsdoc-eslint-parser": "^0.21.1",
-    "@hkdobrev/run-if-changed": "^0.3.1",
+    "@hkdobrev/run-if-changed": "^0.6.0",
     "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^10.1.0",
+    "@semantic-release/github": "^10.1.4",
     "@semantic-release/npm": "^12.0.1",
-    "@types/chai": "^4.3.16",
+    "@types/chai": "^4.3.17",
     "@types/debug": "^4.1.12",
-    "@types/eslint": "^8.56.10",
+    "@types/eslint": "^9.6.0",
     "@types/espree": "^10.1.0",
     "@types/esquery": "^1.5.4",
     "@types/estree": "^1.0.5",
     "@types/json-schema": "^7.0.15",
     "@types/lodash.defaultsdeep": "^4.6.9",
     "@types/mocha": "^10.0.7",
-    "@types/node": "^20.14.11",
+    "@types/node": "^22.2.0",
     "@types/semver": "^7.5.8",
     "@types/spdx-expression-parse": "^3.0.5",
-    "@typescript-eslint/types": "^7.16.1",
+    "@typescript-eslint/types": "^8.1.0",
     "babel-plugin-add-module-exports": "^1.0.4",
     "babel-plugin-istanbul": "^7.0.0",
     "babel-plugin-transform-import-meta": "^2.2.1",
@@ -53,23 +53,23 @@
     "chai": "^5.1.1",
     "cross-env": "^7.0.3",
     "decamelize": "^6.0.0",
-    "eslint": "9.7.0",
-    "eslint-config-canonical": "~43.0.14",
+    "eslint": "9.9.0",
+    "eslint-config-canonical": "~43.0.15",
     "gitdown": "^4.1.1",
     "glob": "^10.4.2",
-    "globals": "^15.8.0",
-    "husky": "^9.1.1",
-    "jsdoc-type-pratt-parser": "^4.0.0",
+    "globals": "^15.9.0",
+    "husky": "^9.1.4",
+    "jsdoc-type-pratt-parser": "^4.1.0",
     "json-schema": "^0.4.0",
-    "lint-staged": "^15.2.7",
+    "lint-staged": "^15.2.9",
     "lodash.defaultsdeep": "^4.6.1",
-    "mocha": "^10.6.0",
+    "mocha": "^10.7.3",
     "open-editor": "^5.0.0",
     "replace": "^1.2.2",
     "rimraf": "^5.0.7",
     "semantic-release": "^24.0.0",
     "typescript": "5.5.x",
-    "typescript-eslint": "^8.0.0-alpha.34"
+    "typescript-eslint": "^8.1.0"
   },
   "engines": {
     "node": ">=18"

pnpm-lock.yaml

@@ -86,7 +86,7 @@ const getLinesCols = (text) => {
  * @property {string} [exampleCodeRegex]
  * @property {string} [rejectExampleCodeRegex]
  * @property {"script"|"module"} [sourceType]
- * @property {import('eslint').Linter.FlatConfigParserModule} [parser]
+ * @property {import('eslint').Linter.ESTreeParser|import('eslint').Linter.NonESTreeParser} [parser]
  */
 
 /**
@@ -486,7 +486,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
             // May be running a second time so catch and ignore
             try {
               ast = parser
-                // @ts-expect-error Ok
+                // @ts-expect-error Should be present
                 ? parser.parseForESLint(text, {
                   ecmaVersion: 'latest',
                   sourceType,

src/getJsdocProcessorPlugin.js

@@ -20,8 +20,11 @@ const isNewPromiseExpression = (node) => {
  */
 const isVoidPromise = (node) => {
   return /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeArguments?.params?.[0]?.type === 'TSVoidKeyword'
-    /* c8 ignore next */
-    || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (node)?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';
+    /* c8 ignore next 4 */
+    || /** @type {import('@typescript-eslint/types').TSESTree.TSTypeReference} */ (
+      node
+    // @ts-expect-error Ok
+    )?.typeParameters?.params?.[0]?.type === 'TSVoidKeyword';
 };
 
 const undefinedKeywords = new Set([

src/utils/hasReturnValue.js

@@ -591,5 +591,23 @@ export default {
         'never',
       ],
     },
+    {
+      code: `
+        /**
+         * @template {any} T - Arg 1
+         * @template {string | number} K - Arg 2
+         * @template {any} [R=(K extends keyof T ? T[K] : never)] - Arg 3  ->  Errors here
+         * @typedef {any} Test
+         */
+      `,
+      options: [
+        'always',
+        {
+          tags: {
+            template: 'always'
+          }
+        }
+      ],
+    },
   ],
 };