build: migrate JSDoc linting off removed core rules

Replace deprecated ESLint core rules `require-jsdoc` and `valid-jsdoc`
(removed in ESLint v9) with `eslint-plugin-jsdoc` equivalents:

- `require-jsdoc` → `jsdoc/require-jsdoc` (same option schema)
- `valid-jsdoc` → individual `jsdoc/*` rules:
  - `jsdoc/require-description` (replaces `matchDescription`)
  - `jsdoc/require-param-description` (replaces `requireParamDescription`)
  - `jsdoc/require-returns-type` (replaces `requireReturnType`)
  - `jsdoc/require-returns-description` (replaces `requireReturnDescription`)
  - `jsdoc/check-tag-names` (validates tag names)
- Register `jsdoc` plugin in `etc/eslint/plugins/index.js`
- Update override files that disable `require-jsdoc` for tests,
  benchmarks, examples, and markdown

Ref: stdlib-js/metr-issue-tracker#54

Author: Planeshifter

etc/eslint/overrides/index.js

@@ -89,7 +89,7 @@ var overrides = [
 				'skipComments': true
 			}],
 			'no-restricted-syntax': restrictedSyntaxConfig,
-			'require-jsdoc': 'off',
+			'jsdoc/require-jsdoc': 'off',
 			'stdlib/jsdoc-private-annotation': 'off',
 			'stdlib/jsdoc-doctest': 'off',
 			'stdlib/no-unnecessary-nested-functions': 'off'
@@ -101,7 +101,7 @@ var overrides = [
 			'no-new-wrappers': 'warn',
 			'vars-on-top': 'off',
 			'no-console': 'off',
-			'require-jsdoc': 'off',
+			'jsdoc/require-jsdoc': 'off',
 			'stdlib/jsdoc-private-annotation': 'off',
 			'stdlib/jsdoc-doctest': 'off',
 			'stdlib/no-unnecessary-nested-functions': 'off',
@@ -119,7 +119,7 @@ var overrides = [
 				'skipComments': true
 			}],
 			'no-restricted-syntax': restrictedSyntaxConfig,
-			'require-jsdoc': 'off',
+			'jsdoc/require-jsdoc': 'off',
 			'stdlib/jsdoc-private-annotation': 'off',
 			'stdlib/jsdoc-doctest': 'off',
 			'stdlib/no-unnecessary-nested-functions': 'off',
@@ -155,7 +155,7 @@ var overrides = [
 			'no-tabs': 'error',
 			'no-undef': 'off',
 			'no-unused-vars': 'off',
-			'require-jsdoc': 'off',
+			'jsdoc/require-jsdoc': 'off',
 			'stdlib/jsdoc-private-annotation': 'off',
 			'stdlib/jsdoc-return-annotations-values': 'off',
 			'stdlib/no-unnecessary-nested-functions': 'off',

etc/eslint/plugins/index.js

@@ -20,6 +20,7 @@
 
 // ESLint plugins:
 var plugins = [
+	'jsdoc',
 	'n',
 	'stdlib',
 	'@cspell'

etc/eslint/rules/programmer_errors.js

@@ -839,26 +839,54 @@ rules[ 'require-atomic-updates' ] = 'error';
 rules[ 'use-isnan' ] = 'error';
 
 /**
-* Require valid JSDoc.
+* Require a JSDoc description.
 *
-* @name valid-jsdoc
+* @name jsdoc/require-description
 * @memberof rules
-* @type {Array}
-* @see [valid-jsdoc]{@link https://eslint.org/docs/rules/valid-jsdoc}
-*/
-rules[ 'valid-jsdoc' ] = [ 'error', {
-	'prefer': {
-		'arg': 'param',
-		'argument': 'param',
-		'class': 'constructor',
-		'return': 'returns'
-	},
-	'requireReturn': false,
-	'requireReturnType': true,
-	'matchDescription': '.+',
-	'requireParamDescription': true,
-	'requireReturnDescription': true
-}];
+* @type {string}
+* @see [require-description]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-description.md}
+*/
+rules[ 'jsdoc/require-description' ] = 'error';
+
+/**
+* Require `@param` description.
+*
+* @name jsdoc/require-param-description
+* @memberof rules
+* @type {string}
+* @see [require-param-description]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-param-description.md}
+*/
+rules[ 'jsdoc/require-param-description' ] = 'error';
+
+/**
+* Require `@returns` type.
+*
+* @name jsdoc/require-returns-type
+* @memberof rules
+* @type {string}
+* @see [require-returns-type]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-type.md}
+*/
+rules[ 'jsdoc/require-returns-type' ] = 'error';
+
+/**
+* Require `@returns` description.
+*
+* @name jsdoc/require-returns-description
+* @memberof rules
+* @type {string}
+* @see [require-returns-description]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns-description.md}
+*/
+rules[ 'jsdoc/require-returns-description' ] = 'error';
+
+/**
+* Enforce valid JSDoc tag names.
+*
+* @name jsdoc/check-tag-names
+* @memberof rules
+* @type {string}
+* @see [check-tag-names]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-tag-names.md}
+*/
+rules[ 'jsdoc/check-tag-names' ] = 'error';
 
 /**
 * Only allow the result of `typeof` to be compared against a select subset of known strings (e.g., 'string', 'undefined', etc.).

etc/eslint/rules/style.js

@@ -1848,12 +1848,12 @@ rules[ 'quotes' ] = [ 'error', 'single', {
 /**
 * Require JSDoc comments.
 *
-* @name require-jsdoc
+* @name jsdoc/require-jsdoc
 * @memberof rules
 * @type {Array}
-* @see [require-jsdoc]{@link https://eslint.org/docs/rules/require-jsdoc}
+* @see [require-jsdoc]{@link https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-jsdoc.md}
 */
-rules[ 'require-jsdoc' ] = [ 'error', {
+rules[ 'jsdoc/require-jsdoc' ] = [ 'error', {
 	'require': {
 		'FunctionDeclaration': true,
 		'ClassDeclaration': true,