@depup/eslint-plugin-jsdoc 64.3.6-depup.1 → 64.3.9-depup.0

package/README.md

@@ -13,16 +13,17 @@ npm install @depup/eslint-plugin-jsdoc
 
 | Field | Value |
 |-------|-------|
-| Original | [eslint-plugin-jsdoc](https://www.npmjs.com/package/eslint-plugin-jsdoc) @ 64.3.6 |
-| Processed | 2026-09-08 |
+| Original | [eslint-plugin-jsdoc](https://www.npmjs.com/package/eslint-plugin-jsdoc) @ 64.3.9 |
+| Processed | 2026-09-10 |
 | Smoke test | passed |
-| Deps updated | 1 |
+| Deps updated | 2 |
 
 ## Dependency Changes
 
 | Dependency | From | To |
 |------------|------|-----|
 | @typescript-eslint/utils | ^8.69.0 | ^8.70.0 |
+| comment-parser | 1.4.8 | ^1.4.9 |
 
 ---
 

package/changes.json

@@ -3,8 +3,12 @@
     "@typescript-eslint/utils": {
       "from": "^8.69.0",
       "to": "^8.70.0"
+    },
+    "comment-parser": {
+      "from": "1.4.8",
+      "to": "^1.4.9"
     }
   },
-  "timestamp": "2026-09-08T00:33:24.758Z",
-  "totalUpdated": 1
+  "timestamp": "2026-09-10T16:09:48.569Z",
+  "totalUpdated": 2
 }

package/package.json

@@ -9,7 +9,7 @@
     "@es-joy/resolve.exports": "1.2.0",
     "@typescript-eslint/utils": "^8.70.0",
     "are-docs-informative": "^0.1.1",
-    "comment-parser": "1.4.8",
+    "comment-parser": "^1.4.9",
     "debug": "^4.4.3",
     "escape-string-regexp": "^5.0.0",
     "espree": "^11.2.0",
@@ -162,18 +162,22 @@
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "64.3.6-depup.1",
+  "version": "64.3.9-depup.0",
   "depup": {
     "changes": {
       "@typescript-eslint/utils": {
         "from": "^8.69.0",
         "to": "^8.70.0"
+      },
+      "comment-parser": {
+        "from": "1.4.8",
+        "to": "^1.4.9"
       }
     },
-    "depsUpdated": 1,
+    "depsUpdated": 2,
     "originalPackage": "eslint-plugin-jsdoc",
-    "originalVersion": "64.3.6",
-    "processedAt": "2026-09-08T00:33:51.285Z",
+    "originalVersion": "64.3.9",
+    "processedAt": "2026-09-10T16:10:23.622Z",
     "smokeTest": "passed"
   }
 }

package/src/getJsdocProcessorPlugin.js

@@ -151,16 +151,22 @@ export const getJsdocProcessorPlugin = (options = {}) => {
   }
 
   /**
-   * @type {{
+   * @typedef {{
    *   targetTagName: string,
    *   ext: string,
    *   codeStartLine: number,
    *   codeStartCol: number,
    *   nonJSPrefacingCols: number,
    *   commentLineCols: [number, number]
-   * }[]}
+   * }} OtherInfo
+   */
+
+  /**
+   * Keyed by filename, as the same plugin instance preprocesses many files
+   *   (including the example files it produces) before postprocessing them.
+   * @type {Map<string, OtherInfo[]>}
    */
-  const otherInfo = [];
+  const otherInfoByFilename = new Map();
 
   /** @type {import('eslint').Linter.LintMessage[]} */
   let extraMessages = [];
@@ -169,8 +175,9 @@ export const getJsdocProcessorPlugin = (options = {}) => {
    * @param {JsdocBlockWithInline} jsdoc
    * @param {string} jsFileName
    * @param {[number, number]} commentLineCols
+   * @param {OtherInfo[]} otherInfo
    */
-  const getTextsAndFileNames = (jsdoc, jsFileName, commentLineCols) => {
+  const getTextsAndFileNames = (jsdoc, jsFileName, commentLineCols, otherInfo) => {
     /**
      * @type {TextAndFileName[]}
      */
@@ -529,8 +536,12 @@ export const getJsdocProcessorPlugin = (options = {}) => {
         postprocess ([
           jsMessages,
           ...messages
-        // eslint-disable-next-line no-unused-vars -- Placeholder
         ], filename) {
+          const otherInfo = /** @type {OtherInfo[]} */ (
+            otherInfoByFilename.get(filename)
+          );
+          otherInfoByFilename.delete(filename);
+
           for (const [
             idx,
             message,
@@ -559,7 +570,11 @@ export const getJsdocProcessorPlugin = (options = {}) => {
                 // fix: {range: [number, number], text: string}
                 // suggestions: {desc: , messageId:, fix: }[],
               } = msg;
+
+              // Ranges are relative to the example file, so drop them rather
+              //   than let them be applied to the parent file
               delete msg.fix;
+              delete msg.suggestions;
 
               const [
                 codeCtxLine,
@@ -600,6 +615,10 @@ export const getJsdocProcessorPlugin = (options = {}) => {
          */
         preprocess (text, filename) {
           try {
+            /** @type {OtherInfo[]} */
+            const otherInfo = [];
+            otherInfoByFilename.set(filename, otherInfo);
+
             let ast;
 
             // May be running a second time so catch and ignore
@@ -663,6 +682,7 @@ export const getJsdocProcessorPlugin = (options = {}) => {
                   jsdoc,
                   filename,
                   commentLineCols[idx],
+                  otherInfo,
                 );
               }).filter(
                 /**

package/src/rules/noUndefinedTypes.js

@@ -482,31 +482,35 @@ export default iterateJsdoc(({
     .concat(tsModuleVariables)
     .concat(/** @type {string[]} */ (definedPreferredTypes))
     .concat((() => {
-      // Other methods are not in scope, but we need them, and we grab them here
-      if (node?.type === 'MethodDefinition') {
-        return /** @type {import('estree').ClassBody} */ (node.parent).body.flatMap((methodOrProp) => {
-          if (methodOrProp.type === 'MethodDefinition') {
-            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern
-            if (methodOrProp.key.type === 'Identifier') {
-              return [
-                methodOrProp.key.name,
-                `${/** @type {import('estree').ClassDeclaration} */ (
-                  node.parent?.parent
-                )?.id?.name}.${methodOrProp.key.name}`,
-              ];
-            }
-          }
+      // Other class members are not in scope, but we need them (e.g., for a
+      //   sibling property or method referenced by `{@link}`, or a member
+      //   referenced by `{@link}` from the class's own JSDoc block), and we
+      //   grab them here
+      /** @type {import('estree').ClassBody|undefined} */
+      let classBody;
+      /** @type {string|undefined} */
+      let className;
+      if (node?.type === 'MethodDefinition' || node?.type === 'PropertyDefinition') {
+        classBody = /** @type {import('estree').ClassBody} */ (node.parent);
+        className = /** @type {import('estree').ClassDeclaration} */ (
+          node.parent?.parent
+        )?.id?.name;
+      } else if (node?.type === 'ClassDeclaration' || node?.type === 'ClassExpression') {
+        classBody = node.body;
+        className = node.id?.name;
+      }
 
-          if (methodOrProp.type === 'PropertyDefinition') {
-            // eslint-disable-next-line unicorn/no-lonely-if -- Pattern
-            if (methodOrProp.key.type === 'Identifier') {
-              return [
-                methodOrProp.key.name,
-                `${/** @type {import('estree').ClassDeclaration} */ (
-                  node.parent?.parent
-                )?.id?.name}.${methodOrProp.key.name}`,
-              ];
-            }
+      if (classBody) {
+        return classBody.body.flatMap((methodOrProp) => {
+          if (
+            (methodOrProp.type === 'MethodDefinition' ||
+            methodOrProp.type === 'PropertyDefinition') &&
+            methodOrProp.key.type === 'Identifier'
+          ) {
+            return [
+              methodOrProp.key.name,
+              `${className}.${methodOrProp.key.name}`,
+            ];
           }
           /* c8 ignore next 2 -- Not yet built */