fix(require-jsdoc): update jsdoccomment (and espree) to get comment-finding for overloaded functions; fixes #1369 (#1406)

Author: brettz9

docs/rules/require-jsdoc.md

@@ -1909,5 +1909,27 @@ class Abc {
   }
 }
 // "jsdoc/require-jsdoc": ["error"|"warn", {"publicOnly":true,"require":{"ClassDeclaration":true}}]
+
+/**
+ * Array map function with overload for NonEmptyArray
+ * @example
+ * const data = [{value: 'value'}] as const;
+ * const result1: NonEmptyReadonlyArray<'value'> = arrayMap(data, (value) => value.value); // pick type from data
+ * const result2: NonEmptyReadonlyArray<'value'> = arrayMap<'value', typeof data>(data, (value) => value.value); // enforce output type
+ * @template Target - The type of the array to map to
+ * @template Source - The type of the array to map from
+ * @param {Source} data - The array to map
+ * @param {MapCallback<Target, Source>} callback - Callback function to map data from the array
+ * @returns {AnyArrayType<Target>} Mapped array
+ * @since v0.2.0
+ */
+export function arrayMap<Target, Source extends NonEmptyArray<unknown> | NonEmptyReadonlyArray<unknown>>(
+  data: Source,
+  callback: MapCallback<Target, Source>,
+): NonEmptyArray<Target>;
+export function arrayMap<Target, Source extends Array<unknown>>(data: Source, callback: MapCallback<Target, Source>): Array<Target>;
+export function arrayMap<Target, Source extends AnyArrayType>(data: Source, callback: MapCallback<Target, Source>): AnyArrayType<Target> {
+  return data.map(callback);
+}
 ````
 

package.json

@@ -5,12 +5,12 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.50.2",
+    "@es-joy/jsdoccomment": "~0.51.1",
     "are-docs-informative": "^0.0.2",
     "comment-parser": "1.4.1",
     "debug": "^4.4.1",
     "escape-string-regexp": "^4.0.0",
-    "espree": "^10.3.0",
+    "espree": "^10.4.0",
     "esquery": "^1.6.0",
     "parse-imports-exports": "^0.2.4",
     "semver": "^7.7.2",
@@ -20,7 +20,7 @@
   "devDependencies": {
     "@babel/cli": "^7.27.2",
     "@babel/core": "^7.27.4",
-    "@babel/eslint-parser": "^7.27.1",
+    "@babel/eslint-parser": "^7.27.5",
     "@babel/node": "^7.27.1",
     "@babel/plugin-syntax-class-properties": "^7.12.13",
     "@babel/plugin-transform-flow-strip-types": "^7.27.1",
@@ -36,39 +36,39 @@
     "@types/eslint": "^9.6.1",
     "@types/espree": "^10.1.0",
     "@types/esquery": "^1.5.4",
-    "@types/estree": "^1.0.7",
+    "@types/estree": "^1.0.8",
     "@types/json-schema": "^7.0.15",
     "@types/lodash.defaultsdeep": "^4.6.9",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.15.29",
+    "@types/node": "^24.0.3",
     "@types/semver": "^7.7.0",
     "@types/spdx-expression-parse": "^3.0.5",
-    "@typescript-eslint/types": "^8.33.0",
+    "@typescript-eslint/types": "^8.34.1",
     "babel-plugin-add-module-exports": "^1.0.4",
     "babel-plugin-istanbul": "^7.0.0",
-    "babel-plugin-transform-import-meta": "^2.3.2",
+    "babel-plugin-transform-import-meta": "^2.3.3",
     "c8": "^10.1.3",
     "camelcase": "^8.0.0",
     "chai": "^5.2.0",
     "cross-env": "^7.0.3",
     "decamelize": "^6.0.0",
-    "eslint": "9.28.0",
+    "eslint": "9.29.0",
     "eslint-config-canonical": "~44.9.5",
     "gitdown": "^4.1.1",
-    "glob": "^11.0.2",
+    "glob": "^11.0.3",
     "globals": "^16.2.0",
     "husky": "^9.1.7",
     "jsdoc-type-pratt-parser": "^4.1.0",
     "json-schema": "^0.4.0",
-    "lint-staged": "^16.1.0",
+    "lint-staged": "^16.1.2",
     "lodash.defaultsdeep": "^4.6.1",
-    "mocha": "^11.5.0",
+    "mocha": "^11.7.0",
     "open-editor": "^5.1.0",
     "replace": "^1.2.2",
     "rimraf": "^6.0.1",
     "semantic-release": "^24.2.5",
     "typescript": "5.8.3",
-    "typescript-eslint": "^8.33.0"
+    "typescript-eslint": "^8.34.1"
   },
   "engines": {
     "node": ">=20.11.0"