@wordpress/eslint-plugin 25.0.0 → 25.0.1-next.v.202604201441.0

package/README.md

@@ -14,7 +14,11 @@ npm install @wordpress/eslint-plugin --save-dev
 
 ## Usage
 
-### Flat config (ESLint v10+, recommended)
+**Minimum ESLint version:** `^9.0.0 || ^10.0.0`
+
+> **Upgrading from an older version?** See the [ESLint v10 migration guide](https://github.com/WordPress/gutenberg/blob/HEAD/docs/how-to-guides/eslint-v10-migration.md) for a comprehensive walkthrough of the breaking changes, migration steps, and troubleshooting.
+
+### Flat config (ESLint v9+, recommended)
 
 Create an `eslint.config.mjs` file in your project root:
 
@@ -41,7 +45,7 @@ export default [
 
 Refer to the [ESLint flat config documentation](https://eslint.org/docs/latest/use/configure/configuration-files) for more information.
 
-### Legacy eslintrc (ESLint v9, deprecated)
+### Legacy eslintrc (ESLint v9 only, deprecated)
 
 If you are still using ESLint v9 with the legacy `.eslintrc.*` format, a compatibility wrapper is available:
 
@@ -52,7 +56,9 @@ const wordpress = require( '@wordpress/eslint-plugin/eslintrc' );
 module.exports = wordpress.configs.recommended;
 ```
 
-> **Note:** The eslintrc wrapper is deprecated and will be removed in a future major version. Please migrate to flat config.
+All config presets are available through the wrapper (e.g., `wordpress.configs.esnext`, `wordpress.configs[ 'recommended-with-formatting' ]`).
+
+> **Note:** The eslintrc wrapper is deprecated and will be removed in the next major version. ESLint v10 does not support `.eslintrc.*` files at all. Please migrate to flat config.
 
 ### About the recommended preset
 
@@ -151,8 +157,14 @@ If you are upgrading from a previous version that used `.eslintrc.*` files:
 3. Convert `overrides` to separate config objects with `files` patterns.
 4. Replace `env` with `languageOptions.globals` using the [`globals`](https://www.npmjs.com/package/globals) package.
 5. Delete your `.eslintignore` file and move patterns into an `ignores` config object.
+6. Update rule prefixes in inline comments: `eslint-comments/*` has been renamed to `@eslint-community/eslint-comments/*`. For example:
+    ```diff
+    - /* eslint-disable eslint-comments/no-unlimited-disable */
+    + /* eslint-disable @eslint-community/eslint-comments/no-unlimited-disable */
+    ```
+7. Remove any `/* eslint-env */` comments — they are no longer supported in ESLint v10. Use `languageOptions.globals` in your config instead.
 
-See the [ESLint migration guide](https://eslint.org/docs/latest/use/configure/migration-guide) for full details.
+For a comprehensive walkthrough with examples and troubleshooting, see the [Gutenberg ESLint v10 migration guide](https://github.com/WordPress/gutenberg/blob/HEAD/docs/how-to-guides/eslint-v10-migration.md). See also the [ESLint migration guide](https://eslint.org/docs/latest/use/configure/migration-guide) for general flat config details.
 
 ## Contributing to this package
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/eslint-plugin",
-	"version": "25.0.0",
+	"version": "25.0.1-next.v.202604201441.0+dab6d8c07",
 	"description": "ESLint plugin for WordPress development.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -44,9 +44,9 @@
 		"@babel/eslint-parser": "^7.28.6",
 		"@eslint-community/eslint-plugin-eslint-comments": "^4.4.0",
 		"@eslint/compat": "^2.0.0",
-		"@wordpress/babel-preset-default": "^8.44.0",
-		"@wordpress/prettier-config": "^4.44.0",
-		"@wordpress/theme": "^0.11.0",
+		"@wordpress/babel-preset-default": "^8.44.1-next.v.202604201441.0+dab6d8c07",
+		"@wordpress/prettier-config": "^4.44.1-next.v.202604201441.0+dab6d8c07",
+		"@wordpress/theme": "^0.11.1-next.v.202604201441.0+dab6d8c07",
 		"cosmiconfig": "^7.0.0",
 		"eslint-config-prettier": "^10.0.0",
 		"eslint-import-resolver-typescript": "^4.4.4",
@@ -83,5 +83,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "b862d8c84121a47bbeff882f6c87e61681ce2e0d"
+	"gitHead": "c788005ba4ee2a34851c1217c51602656aa7c3a6"
 }

package/rules/use-recommended-components.js

@@ -24,6 +24,10 @@ const ALLOWLIST = {
  */
 const DENYLIST = {
 	'@wordpress/components': {
+		__experimentalHeading: 'Use `Text` from `@wordpress/ui` instead.',
+		__experimentalHStack: 'Use `Stack` from `@wordpress/ui` instead.',
+		__experimentalText: 'Use `Text` from `@wordpress/ui` instead.',
+		__experimentalVStack: 'Use `Stack` from `@wordpress/ui` instead.',
 		__experimentalZStack:
 			'{{ name }} is planned for deprecation. Write your own CSS instead.',
 	},