chore: update jsdoccomment, are-docs-informative, debug, espree, semver, devDeps (#1391)

Also:
- chore: reapplies part of eslint-config-canonical

Author: brettz9

.README/rules/check-line-alignment.md

@@ -58,7 +58,7 @@ Disables `wrapIndent`; existing wrap indentation is preserved without changes.
 |||
 |---|---|
 |Context|everywhere|
-|Options|string ("always", "never", "any") followed by object with `customSpacings`, `preserveMainDescriptionPostDelimiter`, `tags`, `wrapIndent`, `disableWrapIndent`|
+|Options|string ("always", "never", "any") followed by object with `customSpacings`, `disableWrapIndent`, `preserveMainDescriptionPostDelimiter`, `tags`, `wrapIndent`|
 |Tags|`param`, `property`, `returns` and others added by `tags`|
 |Aliases|`arg`, `argument`, `prop`, `return`|
 |Recommended|false|

.ncurc.cjs

@@ -8,6 +8,6 @@ module.exports = {
     // todo[engine:node@>=20]: Can reenable
     'glob',
     // todo[engine:node@>=20]: Can reenable
-    'rimraf'
+    'rimraf',
   ],
 };

docs/rules/check-line-alignment.md

@@ -86,7 +86,7 @@ Disables `wrapIndent`; existing wrap indentation is preserved without changes.
 |||
 |---|---|
 |Context|everywhere|
-|Options|string ("always", "never", "any") followed by object with `customSpacings`, `preserveMainDescriptionPostDelimiter`, `tags`, `wrapIndent`, `disableWrapIndent`|
+|Options|string ("always", "never", "any") followed by object with `customSpacings`, `disableWrapIndent`, `preserveMainDescriptionPostDelimiter`, `tags`, `wrapIndent`|
 |Tags|`param`, `property`, `returns` and others added by `tags`|
 |Aliases|`arg`, `argument`, `prop`, `return`|
 |Recommended|false|

docs/rules/convert-to-jsdoc-comments.md

@@ -118,7 +118,7 @@ function quux () {}
 
 // A single line comment
 function quux () {}
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"lineOrBlockStyle":"line","enforceJsdocLineStyle":"single"}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"enforceJsdocLineStyle":"single","lineOrBlockStyle":"line"}]
 // Message: Line comments should be JSDoc-style.
 
 /* A single line comment */
@@ -128,7 +128,7 @@ function quux () {}
 
 /* A single line comment */
 function quux () {}
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"lineOrBlockStyle":"block","enforceJsdocLineStyle":"single"}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"enforceJsdocLineStyle":"single","lineOrBlockStyle":"block"}]
 // Message: Block comments should be JSDoc-style.
 
 // A single line comment
@@ -160,21 +160,21 @@ export class User {
 // Message: Block comments should be JSDoc-style.
 
 /* A single line comment */ function quux () {}
-// Settings: {"jsdoc":{"minLines":0,"maxLines":0}}
+// Settings: {"jsdoc":{"maxLines":0,"minLines":0}}
 // "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"enforceJsdocLineStyle":"single"}]
 // Message: Block comments should be JSDoc-style.
 
 var a = []; // Test comment
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsBeforeAndAfter":[],"contextsAfter":["VariableDeclarator"]}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsAfter":["VariableDeclarator"],"contextsBeforeAndAfter":[]}]
 // Message: Line comments should be JSDoc-style.
 
 var a = []; // Test comment
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsBeforeAndAfter":[],"contextsAfter":[{"context":"VariableDeclarator","inlineCommentBlock":true}]}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsAfter":[{"context":"VariableDeclarator","inlineCommentBlock":true}],"contextsBeforeAndAfter":[]}]
 // Message: Line comments should be JSDoc-style.
 
 var a = []; // Test comment
-// Settings: {"jsdoc":{"minLines":0,"maxLines":0}}
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsBeforeAndAfter":[],"contextsAfter":[{"context":"VariableDeclarator","inlineCommentBlock":true}]}]
+// Settings: {"jsdoc":{"maxLines":0,"minLines":0}}
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsAfter":[{"context":"VariableDeclarator","inlineCommentBlock":true}],"contextsBeforeAndAfter":[]}]
 // Message: Line comments should be JSDoc-style.
 
 // Test comment
@@ -230,11 +230,11 @@ function quux () {}
 
 /* A single line comment */
 function quux () {}
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"lineOrBlockStyle":"line","enforceJsdocLineStyle":"single"}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"enforceJsdocLineStyle":"single","lineOrBlockStyle":"line"}]
 
 // A single line comment
 function quux () {}
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"lineOrBlockStyle":"block","enforceJsdocLineStyle":"single"}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"enforceJsdocLineStyle":"single","lineOrBlockStyle":"block"}]
 
 // @ts-expect-error
 function quux () {}
@@ -245,6 +245,6 @@ function quux () {}
 
 // Test comment
 var a = [];
-// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsBeforeAndAfter":[],"contextsAfter":["VariableDeclarator"]}]
+// "jsdoc/convert-to-jsdoc-comments": ["error"|"warn", {"contextsAfter":["VariableDeclarator"],"contextsBeforeAndAfter":[]}]
 ````
 

docs/rules/informative-docs.md

@@ -278,7 +278,7 @@ let emoji;
  */
 export function packageNameFromPath(path) {
   const base = basename(path);
-  return /^vd+(.d+)?$/.exec(base) || /^tsd.d/.exec(base) ? basename(dirname(path)) : base;
+  return /^v\d+(\.\d+)?$/.exec(base) || /^ts\d\.\d/.exec(base) ? basename(dirname(path)) : base;
 }
 // Message: This description only repeats the name it describes.
 
@@ -287,7 +287,7 @@ export function packageNameFromPath(path) {
  */
 export default function packageNameFromPath(path) {
   const base = basename(path);
-  return /^vd+(.d+)?$/.exec(base) || /^tsd.d/.exec(base) ? basename(dirname(path)) : base;
+  return /^v\d+(\.\d+)?$/.exec(base) || /^ts\d\.\d/.exec(base) ? basename(dirname(path)) : base;
 }
 // Message: This description only repeats the name it describes.
 ````

docs/rules/require-jsdoc.md

@@ -1018,15 +1018,15 @@ export type LoginOptions = CmdOptions<{
   username?: string;
   password?: string;
 }>;
-// "jsdoc/require-jsdoc": ["error"|"warn", {"publicOnly":{"ancestorsOnly":true},"contexts":["TSTypeAliasDeclaration","TSInterfaceDeclaration","TSMethodSignature","TSPropertySignature"]}]
+// "jsdoc/require-jsdoc": ["error"|"warn", {"contexts":["TSTypeAliasDeclaration","TSInterfaceDeclaration","TSMethodSignature","TSPropertySignature"],"publicOnly":{"ancestorsOnly":true}}]
 // Message: Missing JSDoc comment.
 
 type Props = {
   variant: string
 }
 
 export type { Props as ComponentProps };
-// "jsdoc/require-jsdoc": ["error"|"warn", {"publicOnly":{"esm":true},"require":{"FunctionDeclaration":true,"FunctionExpression":true,"ArrowFunctionExpression":true,"ClassDeclaration":true,"ClassExpression":true,"MethodDefinition":true},"contexts":["VariableDeclaration","TSTypeAliasDeclaration","TSPropertySignature","TSInterfaceDeclaration","TSMethodSignature","TSEnumDeclaration"],"enableFixer":true}]
+// "jsdoc/require-jsdoc": ["error"|"warn", {"contexts":["VariableDeclaration","TSTypeAliasDeclaration","TSPropertySignature","TSInterfaceDeclaration","TSMethodSignature","TSEnumDeclaration"],"enableFixer":true,"publicOnly":{"esm":true},"require":{"ArrowFunctionExpression":true,"ClassDeclaration":true,"ClassExpression":true,"FunctionDeclaration":true,"FunctionExpression":true,"MethodDefinition":true}}]
 // Message: Missing JSDoc comment.
 ````
 
@@ -1901,7 +1901,7 @@ export class MyClass {
 
   #myPrivateProp = 5;
 }
-// "jsdoc/require-jsdoc": ["error"|"warn", {"publicOnly":true,"contexts":["PropertyDefinition"],"require":{"MethodDefinition":true}}]
+// "jsdoc/require-jsdoc": ["error"|"warn", {"contexts":["PropertyDefinition"],"publicOnly":true,"require":{"MethodDefinition":true}}]
 
 class Abc {
   static {

eslint.config.js

@@ -1,82 +1,86 @@
-import globals from 'globals';
 import jsdoc from './src/index.js';
-// import canonical from 'eslint-config-canonical';
-// import canonicalJsdoc from 'eslint-config-canonical/jsdoc.js';
+import {
+  recommended as canonical,
+} from 'eslint-config-canonical/canonical';
+import {
+  recommended as canonicalJsdoc,
+} from 'eslint-config-canonical/jsdoc';
+import globals from 'globals';
 
 const common = {
   linterOptions: {
-    reportUnusedDisableDirectives: 'off'
-  },
-  plugins: {
-    jsdoc
+    reportUnusedDisableDirectives: 'off',
   },
 };
 
 export default [
-  // canonical,
-  // canonicalJsdoc,
+  ...canonical,
+  ...canonicalJsdoc,
   ...jsdoc.configs['examples-and-default-expressions'],
   {
     // Must be by itself
-    ignores: ['dist/**', '.ignore/**/*.js'],
+    ignores: [
+      'dist/**', '.ignore/**', '**/*.d.ts',
+    ],
   },
   {
     ...common,
     languageOptions: {
       ecmaVersion: 'latest',
+      globals: globals.node,
       sourceType: 'module',
-      globals: globals.node
-    },
-    settings: {
-      jsdoc: {
-        mode: 'typescript'
-      }
     },
     rules: {
-      'array-element-newline': 0,
+      '@stylistic/array-element-newline': 0,
+      '@stylistic/no-extra-parens': 0,
       'filenames/match-regex': 0,
       'import/extensions': 0,
       'import/no-useless-path-segments': 0,
+      'linebreak-style': 0,
+      'no-inline-comments': 0,
       'prefer-named-capture-group': 0,
+      'unicorn/import-index': 0,
       'unicorn/no-array-reduce': 0,
       'unicorn/no-unsafe-regex': 0,
       'unicorn/prefer-array-some': 0,
       'unicorn/prevent-abbreviations': 0,
-      'unicorn/import-index': 0,
-      'linebreak-style': 0,
-      'no-inline-comments': 0,
-      'no-extra-parens': 0
-    }
+    },
   },
   {
     ...common,
-    files: ['.ncurc.cjs'],
+    files: [
+      '.ncurc.cjs',
+    ],
     languageOptions: {
       parserOptions: {
         ecmaFeatures: {
-          impliedStrict: false
+          impliedStrict: false,
         },
       },
-      sourceType: 'script'
+      sourceType: 'script',
     },
     rules: {
+      'canonical/filename-match-regex': 0,
       'import/no-commonjs': 0,
       strict: [
         'error',
-        'global'
-      ]
-    }
+        'global',
+      ],
+    },
   },
   {
     ...common,
-    files: ['test/**/*.js'],
+    files: [
+      'test/**/*.js',
+    ],
     languageOptions: {
       ecmaVersion: 'latest',
-      sourceType: 'module'
+      globals: globals.mocha,
+      sourceType: 'module',
     },
     rules: {
       'no-restricted-syntax': 0,
-      'unicorn/prevent-abbreviations': 0
-    }
+      'unicorn/prevent-abbreviations': 0,
+    },
   },
 ];

package.json

@@ -5,31 +5,31 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "@es-joy/jsdoccomment": "~0.50.1",
-    "are-docs-informative": "^0.0.2",
+    "@es-joy/jsdoccomment": "~0.50.2",
+    "are-docs-informative": "^0.1.0",
     "comment-parser": "1.4.1",
-    "debug": "^4.3.6",
+    "debug": "^4.4.1",
     "escape-string-regexp": "^4.0.0",
-    "espree": "^10.1.0",
+    "espree": "^10.3.0",
     "esquery": "^1.6.0",
     "parse-imports-exports": "^0.2.4",
-    "semver": "^7.6.3",
+    "semver": "^7.7.2",
     "spdx-expression-parse": "^4.0.0"
   },
   "description": "JSDoc linting rules for ESLint.",
   "devDependencies": {
-    "@babel/cli": "^7.24.8",
-    "@babel/core": "^7.25.2",
-    "@babel/eslint-parser": "^7.25.1",
-    "@babel/node": "^7.25.0",
+    "@babel/cli": "^7.27.2",
+    "@babel/core": "^7.27.4",
+    "@babel/eslint-parser": "^7.27.1",
+    "@babel/node": "^7.27.1",
     "@babel/plugin-syntax-class-properties": "^7.12.13",
-    "@babel/plugin-transform-flow-strip-types": "^7.25.2",
-    "@babel/preset-env": "^7.25.3",
+    "@babel/plugin-transform-flow-strip-types": "^7.27.1",
+    "@babel/preset-env": "^7.27.2",
     "@es-joy/escodegen": "^3.5.1",
     "@es-joy/jsdoc-eslint-parser": "^0.21.1",
-    "@hkdobrev/run-if-changed": "^0.6.0",
-    "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^11.0.0",
+    "@hkdobrev/run-if-changed": "^0.6.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/github": "^11.0.3",
     "@semantic-release/npm": "^12.0.1",
     "@types/chai": "^5.2.2",
     "@types/debug": "^4.1.12",
@@ -40,35 +40,35 @@
     "@types/json-schema": "^7.0.15",
     "@types/lodash.defaultsdeep": "^4.6.9",
     "@types/mocha": "^10.0.10",
-    "@types/node": "^22.15.18",
+    "@types/node": "^22.15.29",
     "@types/semver": "^7.7.0",
     "@types/spdx-expression-parse": "^3.0.5",
-    "@typescript-eslint/types": "^8.32.1",
+    "@typescript-eslint/types": "^8.33.0",
     "babel-plugin-add-module-exports": "^1.0.4",
     "babel-plugin-istanbul": "^7.0.0",
-    "babel-plugin-transform-import-meta": "^2.2.1",
-    "c8": "^10.1.2",
+    "babel-plugin-transform-import-meta": "^2.3.2",
+    "c8": "^10.1.3",
     "camelcase": "^8.0.0",
-    "chai": "^5.1.1",
+    "chai": "^5.2.0",
     "cross-env": "^7.0.3",
     "decamelize": "^6.0.0",
-    "eslint": "9.9.0",
-    "eslint-config-canonical": "~43.0.15",
+    "eslint": "9.28.0",
+    "eslint-config-canonical": "~44.9.5",
     "gitdown": "^4.1.1",
     "glob": "^10.4.2",
-    "globals": "^15.9.0",
-    "husky": "^9.1.4",
+    "globals": "^16.2.0",
+    "husky": "^9.1.7",
     "jsdoc-type-pratt-parser": "^4.1.0",
     "json-schema": "^0.4.0",
-    "lint-staged": "^15.2.9",
+    "lint-staged": "^16.1.0",
     "lodash.defaultsdeep": "^4.6.1",
-    "mocha": "^10.7.3",
-    "open-editor": "^5.0.0",
+    "mocha": "^11.5.0",
+    "open-editor": "^5.1.0",
     "replace": "^1.2.2",
     "rimraf": "^5.0.7",
-    "semantic-release": "^24.1.1",
-    "typescript": "5.8.x",
-    "typescript-eslint": "^8.32.1"
+    "semantic-release": "^24.2.5",
+    "typescript": "5.8.3",
+    "typescript-eslint": "^8.33.0"
   },
   "engines": {
     "node": ">=18"