Merge branch 'WordPress:trunk' into trunk

Author: dd32

.eslintignore

@@ -1,29 +1,60 @@
-module.exports = {
-	rules: {
-		'require-jsdoc': 'off',
-		'valid-jsdoc': [ 'error', {
-			prefer: {
-				arg: 'param',
-				argument: 'param',
-				extends: 'augments',
-				returns: 'return',
+/**
+ * ESLint v10 flat config file for JSDoc linting.
+ * This config is based on the original valid-jsdoc rules.
+ */
+
+const jsdocPlugin = require( 'eslint-plugin-jsdoc' );
+
+module.exports = [
+	{
+		plugins: {
+			jsdoc: jsdocPlugin,
+		},
+		settings: {
+			jsdoc: {
+				tagNamePreference: {
+					'arg': 'param',
+					'argument': 'param',
+					'extends': 'augments',
+					'returns': 'return',
+				},
+				preferredTypes: {
+					'array': 'Array',
+					'bool': 'boolean',
+					'Boolean': 'boolean',
+					'float': 'number',
+					'Float': 'number',
+					'function': 'Function',
+					'int': 'number',
+					'integer': 'number',
+					'Integer': 'number',
+					'Number': 'number',
+					'object': 'Object',
+					'String': 'string',
+					'Void': 'void',
+				},
 			},
-			preferType: {
-				array: 'Array',
-				bool: 'boolean',
-				Boolean: 'boolean',
-				float: 'number',
-				Float: 'number',
-				int: 'number',
-				integer: 'number',
-				Integer: 'number',
-				Number: 'number',
-				object: 'Object',
-				String: 'string',
-				Void: 'void',
-			},
-			requireParamDescription: false,
-			requireReturn: false,
-		} ],
+		},
+		rules: {
+			'jsdoc/check-param-names': 'error',
+			'jsdoc/check-types': 'error',
+			'jsdoc/check-tag-names': [ 'error', {
+				definedTags: [
+					'memberOf',
+					'output',
+					'ticket',
+					'link',
+				],
+			} ],
+			'jsdoc/require-param': [ 'error', {
+				enableFixer: false,
+			} ],
+			'jsdoc/require-param-type': 'error',
+			'jsdoc/require-returns-check': 'error',
+			'jsdoc/require-returns-description': 'error',
+			'jsdoc/require-returns': 'error',
+			'jsdoc/require-returns-type': 'error',
+			'jsdoc/check-syntax': 'error',
+		},
 	},
-};
+];

.eslintrc-jsdoc.js

@@ -0,0 +1,38 @@
+/**
+ * ESLint v10 flat config entry point.
+ *
+ * This minimal config focuses only on JSDoc linting by importing
+ * the configuration from .eslintrc-jsdoc.js.
+ *
+ * General JavaScript linting is not performed here.
+ */
+
+const jsdocConfig = require( './.eslintrc-jsdoc.js' );
+
+module.exports = [
+	...jsdocConfig,
+	{
+		ignores: [
+			'build/**',
+			'**/build/**',
+			'node_modules/**',
+			'tests/**',
+			'vendor/**',
+			'tools/**',
+			'jsdoc/**',
+			'artifacts/**',
+			'coverage/**',
+			'.cache/**',
+			'src/wp-includes/blocks/**/*.js',
+			'src/wp-includes/blocks/**/*.js.map',
+			'src/wp-content/themes/**',
+			'src/wp-content/plugins/**',
+			'src/wp-content/mu-plugins/**',
+			'src/wp-content/upgrade/**',
+			'src/wp-content/uploads/**',
+			'src/js/_enqueues/vendor/**',
+			'src/wp-admin/js/**',
+			'src/wp-includes/js/**',
+		],
+	},
+];