@depup/eslint-plugin-jsdoc 65.3.6-depup.0 → 65.3.11-depup.0

package/README.md

@@ -13,8 +13,8 @@ npm install @depup/eslint-plugin-jsdoc
 
 | Field | Value |
 |-------|-------|
-| Original | [eslint-plugin-jsdoc](https://www.npmjs.com/package/eslint-plugin-jsdoc) @ 65.3.6 |
-| Processed | 2026-10-15 |
+| Original | [eslint-plugin-jsdoc](https://www.npmjs.com/package/eslint-plugin-jsdoc) @ 65.3.11 |
+| Processed | 2026-10-18 |
 | Smoke test | passed |
 | Deps updated | 2 |
 

package/changes.json

@@ -9,6 +9,6 @@
       "to": "^8.71.2"
     }
   },
-  "timestamp": "2026-10-15T16:11:27.506Z",
+  "timestamp": "2026-10-18T00:53:28.969Z",
   "totalUpdated": 2
 }

package/dist/jsdocUtils.d.ts

@@ -166,6 +166,13 @@ export function getAllTags(jsdoc: import("./iterateJsdoc.js").JsdocBlockWithInli
     line?: number | undefined;
     column?: number | undefined;
 }))[];
+/**
+ * Gets the default types of GCC Generic/Template types, e.g., `T[]` for
+ *   `@template [U=T[]]`
+ * @param {import('comment-parser').Spec} tag
+ * @returns {string[]}
+ */
+export function getClosureTemplateTagDefaults(tag: import("comment-parser").Spec): string[];
 /**
  * @param {import('./iterateJsdoc.js').Context[]} contexts
  * @param {import('./iterateJsdoc.js').CheckJsdoc} checkJsdoc

package/package.json

@@ -168,7 +168,7 @@
     "test-cov": "TIMING=1 c8 --reporter text pnpm run test-no-cov",
     "test-index": "pnpm run test-no-cov test/rules/index.js"
   },
-  "version": "65.3.6-depup.0",
+  "version": "65.3.11-depup.0",
   "depup": {
     "changes": {
       "@es-joy/jsdoccomment": {
@@ -182,8 +182,8 @@
     },
     "depsUpdated": 2,
     "originalPackage": "eslint-plugin-jsdoc",
-    "originalVersion": "65.3.6",
-    "processedAt": "2026-10-15T16:11:49.178Z",
+    "originalVersion": "65.3.11",
+    "processedAt": "2026-10-18T00:53:45.692Z",
     "smokeTest": "passed"
   }
 }

package/src/iterateJsdoc.js

@@ -1891,7 +1891,7 @@ const getUtils = (
   utils.findContext = (contexts, comment) => {
     const foundContext = contexts.find((cntxt) => {
       return typeof cntxt === 'string' ?
-        esquery.matches(
+        cntxt === 'any' || esquery.matches(
           /** @type {Node} */ (node),
           esquery.parse(cntxt),
           undefined,
@@ -2667,7 +2667,9 @@ export default function iterateJsdoc (iterator, ruleConfig) {
           return iterateAllJsdocs(
             iterator,
             ruleConfig,
-            hasObjectAny ? /** @type {ContextObject[]} */ (contexts) : null,
+            hasObjectAny || ruleConfig.matchContext ?
+              /** @type {ContextObject[]} */ (contexts) :
+              null,
             ruleConfig.matchContext,
           ).create(context);
         }

package/src/jsdocUtils.js

@@ -1637,10 +1637,24 @@ const splitTopLevelCommas = (str) => {
 const parseClosureTemplateTag = (tag) => {
   return splitTopLevelCommas(tag.name)
     .map((type) => {
-      return type.trim().replace(/^\[?(?<name>.*?)=.*$/v, '$<name>');
+      return type.trim().replace(/^\[?\s*(?<name>.*?)\s*=.*$/v, '$<name>');
     });
 };
 
+/**
+ * Gets the default types of GCC Generic/Template types, e.g., `T[]` for
+ *   `@template [U=T[]]`
+ * @param {import('comment-parser').Spec} tag
+ * @returns {string[]}
+ */
+const getClosureTemplateTagDefaults = (tag) => {
+  return splitTopLevelCommas(tag.name)
+    .map((type) => {
+      return type.trim().replace(/^\[?[^=]*(?:=(?<dflt>.*?)\]?)?$/v, '$<dflt>').trim();
+    })
+    .filter(Boolean);
+};
+
 /**
  * @typedef {true|string[]} DefaultContexts
  */
@@ -2200,6 +2214,7 @@ export {
   flattenRoots,
   forEachPreferredTag,
   getAllTags,
+  getClosureTemplateTagDefaults,
   getContextObject,
   getDocumentNamepathDefiningTags,
   getFunctionParameterNames,

package/src/rules/checkTemplateNames.js

@@ -2,6 +2,7 @@ import iterateJsdoc, {
   parseComment,
 } from '../iterateJsdoc.js';
 import {
+  getClosureTemplateTagDefaults,
   getTags,
 } from '../jsdocUtils.js';
 import {
@@ -46,13 +47,21 @@ export default iterateJsdoc(({
       return;
     }
 
-    traverse(parsedType, (nde) => {
+    traverse(parsedType, (nde, parentNode) => {
       const {
         type,
         value,
       } = /** @type {import('jsdoc-type-pratt-parser').NameResult} */ (nde);
       if (type === 'JsdocTypeName') {
         usedNames.add(value);
+      // An unquoted index of an indexed access type, e.g., `K` in `T[K]`
+      } else if (
+        type === 'JsdocTypeProperty' &&
+        parentNode?.type === 'JsdocTypeNamePath' &&
+        parentNode.pathType === 'property-brackets' &&
+        !(/** @type {import('jsdoc-type-pratt-parser').PropertyResult} */ (nde).meta.quote)
+      ) {
+        usedNames.add(value);
       }
     });
   };
@@ -76,6 +85,16 @@ export default iterateJsdoc(({
   };
 
   const checkTemplateTags = () => {
+    // A template name may be used only within the constraint or default of
+    //   another template, e.g., `T` in `@template {keyof T} K` or
+    //   `@template [U=T[]]`
+    for (const tag of templateTags) {
+      checkForUsedTypes(tag.type);
+      for (const defaultType of getClosureTemplateTagDefaults(tag)) {
+        checkForUsedTypes(defaultType);
+      }
+    }
+
     for (const tag of templateTags) {
       const names = utils.parseClosureTemplateTag(tag);
       for (const nme of names) {

package/src/rules/noMissingSyntax.js

@@ -65,7 +65,7 @@ export default iterateJsdoc(({
 
   setDefaults(state);
 
-  incrementSelector(state, contextStr, String(comment));
+  incrementSelector(state, contextStr, comment ?? '');
 }, {
   contextSelected: true,
   exit ({

package/src/rules/noUnnecessaryTypeAssertion.js

@@ -77,11 +77,10 @@ export default iterateJsdoc(({
 
       // eslint-disable-next-line no-console -- Warning user
       console.warn('⚠️ typescript is not installed. `jsdoc/no-unnecessary-type-assertion` will not work. To disable this warning, you must disable the rule.');
+      return;
     } finally {
       tsAttempted = true;
     }
-
-    return;
   }
 
   const types = utils.getTags('type');

package/src/rules/preferImportTag.js

@@ -204,11 +204,11 @@ export default iterateJsdoc(({
       }
 
       /**
-       * @param {string} name
+       * @param {string} matchingName An identifier (escape module specifiers
+       *   with `toValidIdentifier` before passing them)
        * @param {string[]} extrPathSegments
        */
-      const getFixer = (name, extrPathSegments) => {
-        const matchingName = toValidIdentifier(name);
+      const getFixer = (matchingName, extrPathSegments) => {
         return () => {
           /** @type {import('jsdoc-type-pratt-parser').NamePathResult|undefined} */
           let node = nodes.at(0);
@@ -434,7 +434,7 @@ export default iterateJsdoc(({
           'Inline `import()` found; prefer `@import`',
           tag,
           enableFixer ? (fixer) => {
-            getFixer(element.value, [])();
+            getFixer(toValidIdentifier(element.value), [])();
             return createImportInserter(
               `/** @import * as ${toValidIdentifier(element.value)} from '${element.value}'; */`,
             )(fixer);
@@ -449,9 +449,9 @@ export default iterateJsdoc(({
           'Inline `import()` found; prefer `@import`',
           tag,
           enableFixer ? (fixer) => {
-            getFixer(element.value, [])();
+            getFixer(toValidIdentifier(element.value), [])();
             return createImportInserter(
-              `/** @import ${element.value} from '${element.value}'; */`,
+              `/** @import ${toValidIdentifier(element.value)} from '${element.value}'; */`,
             )(fixer);
           } : null,
         );
@@ -463,12 +463,12 @@ export default iterateJsdoc(({
         tag,
         enableFixer ? (fixer) => {
           if (outputType === 'namespaced-import') {
-            getFixer(element.value, [
+            getFixer(toValidIdentifier(element.value), [
               ...pathSegments,
             ])();
           } else {
             getFixer(
-              /** @type {string} */ (pathSegments.at(-1)),
+              toValidIdentifier(/** @type {string} */ (pathSegments.at(-1))),
               pathSegments.slice(0, -1),
             )();
           }