@depup/eslint-plugin-jsdoc 64.3.9-depup.0 → 64.4.0-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) @ 64.3.9 |
-| Processed | 2026-09-10 |
+| Original | [eslint-plugin-jsdoc](https://www.npmjs.com/package/eslint-plugin-jsdoc) @ 64.4.0 |
+| Processed | 2026-09-14 |
 | Smoke test | passed |
 | Deps updated | 2 |
 

package/changes.json

@@ -9,6 +9,6 @@
       "to": "^1.4.9"
     }
   },
-  "timestamp": "2026-09-10T16:09:48.569Z",
+  "timestamp": "2026-09-14T16:10:26.510Z",
   "totalUpdated": 2
 }

package/dist/rules.d.ts

@@ -447,7 +447,7 @@ export interface Rules {
           /**
            * An array of prefixes to allow at the beginning of a comment.
            *
-           * Defaults to `['@ts-', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']`.
+           * Defaults to `['@ts-', '@license', '@license-end', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']`.
            *
            * Supplying your own value overrides the defaults.
            */
@@ -1060,8 +1060,11 @@ export interface Rules {
            * An array of directives that will not be reported if present at the beginning of
            * a multi-comment block and at-sign `/* @`.
            *
-           * Defaults to `['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck']`
-           * (some directives [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)).
+           * Defaults to `['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck',
+           * 'license', 'license-end', 'licstart', 'licend', 'source',]`
+           *
+           * (directives that are either [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)
+           * or by the [LibreJS standard](https://www.gnu.org/software/librejs/free-your-javascript.html)).
            */
           ignore?: string[];
           /**

package/package.json

@@ -162,7 +162,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": "64.3.9-depup.0",
+  "version": "64.4.0-depup.0",
   "depup": {
     "changes": {
       "@typescript-eslint/utils": {
@@ -176,8 +176,8 @@
     },
     "depsUpdated": 2,
     "originalPackage": "eslint-plugin-jsdoc",
-    "originalVersion": "64.3.9",
-    "processedAt": "2026-09-10T16:10:23.622Z",
+    "originalVersion": "64.4.0",
+    "processedAt": "2026-09-14T16:10:51.988Z",
     "smokeTest": "passed"
   }
 }

package/src/rules/convertToJsdocComments.js

@@ -45,7 +45,8 @@ export default {
 
     const {
       allowedPrefixes = [
-        '@ts-', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-',
+        '@ts-', '@license', '@license-end',
+        'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-',
       ],
       contexts = settings.contexts || [],
       contextsAfter = /** @type {string[]} */ ([]),
@@ -163,8 +164,11 @@ export default {
      * @param {import('eslint').Rule.Node} node
      * @param {AddComment} addComment
      * @param {import('../iterateJsdoc.js').Context[]} ctxts
+     * @param {Token} [locComment] Comment to anchor the report location to,
+     *   e.g., the first comment of a stacked group of line comments, so the
+     *   report does not read as though only the last line were at fault.
      */
-    const reportings = (comment, node, addComment, ctxts) => {
+    const reportings = (comment, node, addComment, ctxts, locComment) => {
       const fixer = getFixer(node, comment, addComment, ctxts);
 
       if (comment.type === 'Block') {
@@ -181,33 +185,89 @@ export default {
           return;
         }
 
-        report('lineCommentsJsdocStyle', comment, node, fixer);
+        report('lineCommentsJsdocStyle', locComment ?? comment, node, fixer);
       }
     };
 
+    /**
+     * Walks backward from a `//` comment which immediately precedes a node,
+     * collecting any directly adjacent (no intervening blank line) `//`
+     * comments stacked above it, so that the fixer can convert the whole
+     * run into a single JSDoc block instead of leaving all but the last
+     * line behind.
+     * @param {Token} comment
+     * @returns {Token[]}
+     */
+    const getPrecedingLineCommentGroup = (comment) => {
+      const group = [
+        comment,
+      ];
+      let current = comment;
+
+      for (;;) {
+        const prev = /** @type {Token|null} */ (
+          sourceCode.getTokenBefore(
+            /** @type {import('eslint').AST.Token} */ (current),
+            {
+              includeComments: true,
+            },
+          )
+        );
+
+        if (
+          !prev ||
+          prev.type !== 'Line' ||
+          // @ts-expect-error Ok
+          prev.loc.end.line !== current.loc.start.line - 1 ||
+          /** @type {string[]} */
+          (allowedPrefixes).some((prefix) => {
+            return prev.value.trimStart().startsWith(prefix);
+          })
+        ) {
+          break;
+        }
+
+        group.unshift(prev);
+        current = prev;
+      }
+
+      return group;
+    };
+
     /**
      * Builds the opening portion of the JSDoc comment, i.e. everything before
-     * the closing delimiter.
+     * the closing delimiter. When more than one comment is supplied (e.g., a
+     * stacked group of `//` lines), each is rendered on its own JSDoc line.
      * @param {string} indent
-     * @param {Token} comment
+     * @param {Token[]} comments
      * @param {boolean|undefined} inlineCommentBlock
      * @returns {string}
      */
-    const getCommentOpening = (indent, comment, inlineCommentBlock) => {
+    const getCommentOpening = (indent, comments, inlineCommentBlock) => {
       if (inlineCommentBlock || enforceJsdocLineStyle === 'single') {
-        return `/** ${comment.value.trim()} `;
+        return `/** ${comments.map((comment) => {
+          return comment.value.trim();
+        }).join(' ')} `;
       }
 
-      const body = comment.value.trimEnd();
+      if (comments.length === 1) {
+        const body = comments[0].value.trimEnd();
+
+        // When the comment's text already begins on its own line (e.g. a
+        // multi-line block comment), there is no need for the fixer to add a
+        // leading blank `*` line.
+        if ((/^[ \t]*\n/v).test(body)) {
+          return `/**${body.replace(/^[ \t]+/v, '')}\n${indent}`;
+        }
 
-      // When the comment's text already begins on its own line (e.g. a
-      // multi-line block comment), there is no need for the fixer to add a
-      // leading blank `*` line.
-      if ((/^[ \t]*\n/v).test(body)) {
-        return `/**${body.replace(/^[ \t]+/v, '')}\n${indent}`;
+        return `/**\n${indent}*${body}\n${indent}`;
       }
 
-      return `/**\n${indent}*${body}\n${indent}`;
+      const inner = comments.map((comment) => {
+        return `${indent}*${comment.value.trimEnd()}`;
+      }).join('\n');
+
+      return `/**\n${inner}\n${indent}`;
     };
 
     /**
@@ -228,19 +288,29 @@ export default {
 
       reportingNonJsdoc = true;
 
+      const commentGroup = comment.type === 'Line' ?
+        getPrecedingLineCommentGroup(/** @type {Token} */ (comment)) :
+        [
+          /** @type {Token} */ (comment),
+        ];
+
       /** @type {AddComment} */
       const addComment = (inlineCommentBlock, commentToAdd, indent, lines, fixer) => {
-        const insertion = getCommentOpening(indent, commentToAdd, inlineCommentBlock) +
+        const insertion = getCommentOpening(indent, commentGroup, inlineCommentBlock) +
             `*/${'\n'.repeat((lines || 1) - 1)}`;
 
-        return fixer.replaceText(
-          /** @type {import('eslint').AST.Token} */
-          (commentToAdd),
+        return fixer.replaceTextRange(
+          [
+            /* c8 ignore next -- Guard */
+            commentGroup[0].range?.[0] ?? 0,
+            /* c8 ignore next -- Guard */
+            commentToAdd.range?.[1] ?? 0,
+          ],
           insertion,
         );
       };
 
-      reportings(comment, node, addComment, contexts);
+      reportings(comment, node, addComment, contexts, commentGroup[0]);
     };
 
     /**
@@ -263,7 +333,9 @@ export default {
 
       /** @type {AddComment} */
       const addComment = (inlineCommentBlock, commentToAdd, indent, lines, fixer) => {
-        const insertion = getCommentOpening(indent, commentToAdd, inlineCommentBlock) +
+        const insertion = getCommentOpening(indent, [
+          /** @type {Token} */ (commentToAdd),
+        ], inlineCommentBlock) +
             `*/${'\n'.repeat((lines || 1) - 1)}${lines ? `\n${indent.slice(1)}` : ' '}`;
 
         return [
@@ -328,7 +400,7 @@ export default {
           allowedPrefixes: {
             description: `An array of prefixes to allow at the beginning of a comment.
 
-Defaults to \`['@ts-', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']\`.
+Defaults to \`['@ts-', '@license', '@license-end', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']\`.
 
 Supplying your own value overrides the defaults.`,
             items: {

package/src/rules/noBadBlocks.js

@@ -21,6 +21,11 @@ export default iterateJsdoc(({
         'ts-expect-error',
         'ts-ignore',
         'ts-nocheck',
+        'license',
+        'license-end',
+        'licstart',
+        'licend',
+        'source',
       ],
       preventAllMultiAsteriskBlocks = false,
     } = {},
@@ -105,8 +110,11 @@ export default iterateJsdoc(({
             description: `An array of directives that will not be reported if present at the beginning of
 a multi-comment block and at-sign \`/* @\`.
 
-Defaults to \`['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck']\`
-(some directives [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)).`,
+Defaults to \`['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck',
+'license', 'license-end', 'licstart', 'licend', 'source',]\`
+
+(directives that are either [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)
+or by the [LibreJS standard](https://www.gnu.org/software/librejs/free-your-javascript.html)).`,
             items: {
               type: 'string',
             },

package/src/rules.d.ts

@@ -447,7 +447,7 @@ export interface Rules {
           /**
            * An array of prefixes to allow at the beginning of a comment.
            *
-           * Defaults to `['@ts-', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']`.
+           * Defaults to `['@ts-', '@license', '@license-end', 'istanbul ', 'c8 ', 'v8 ', 'eslint', 'prettier-']`.
            *
            * Supplying your own value overrides the defaults.
            */
@@ -1060,8 +1060,11 @@ export interface Rules {
            * An array of directives that will not be reported if present at the beginning of
            * a multi-comment block and at-sign `/* @`.
            *
-           * Defaults to `['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck']`
-           * (some directives [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)).
+           * Defaults to `['ts-check', 'ts-expect-error', 'ts-ignore', 'ts-nocheck',
+           * 'license', 'license-end', 'licstart', 'licend', 'source',]`
+           *
+           * (directives that are either [used by TypeScript](https://www.typescriptlang.org/docs/handbook/intro-to-js-ts.html#ts-check)
+           * or by the [LibreJS standard](https://www.gnu.org/software/librejs/free-your-javascript.html)).
            */
           ignore?: string[];
           /**