feat: extend eslint-config-prettier

Author: BPScott

.changeset/old-doors-kiss.md

@@ -4,16 +4,14 @@
 
 Add recommended config for the flat config format.
 
-If you are using flat config, import the recommended config from `eslint-plugin-prettier/recommended`. Note that in contrast to the legacy recommended config, the flat recommended config does not add `eslint-config-prettier` automatically, consumers will need to explictly add that themselves.
+If you are using flat config, import the recommended config from `eslint-plugin-prettier/recommended`. Like the legacy format recommended config, this automatically includes the contents of `eslint-config-prettier`.
 
 ```js
 // eslint.config.js
 const eslintPluginPrettierRecommended = require('eslint-plugin-prettier/recommended');
-const eslintConfigPrettier = require('eslint-config-prettier');
 
 module.exports = [
   // Any other config imports go at the top
   eslintPluginPrettierRecommended,
-  eslintConfigPrettier,
 ];
 ```

README.md

@@ -43,7 +43,7 @@ npm install --save-dev --save-exact prettier
 
 **_`eslint-plugin-prettier` does not install Prettier or ESLint for you._** _You must install these yourself._
 
-This plugin works best if you disable all other ESLint rules relating to code formatting, and only enable rules that detect potential bugs. If another active ESLint rule disagrees with `prettier` about how code should be formatted, it will be impossible to avoid lint errors. You should use [`eslint-config-prettier``](https://github.com/prettier/eslint-config-prettier) to disable all formatting-related ESLint rules.
+This plugin works best if you disable all other ESLint rules relating to code formatting, and only enable rules that detect potential bugs. If another active ESLint rule disagrees with `prettier` about how code should be formatted, it will be impossible to avoid lint errors. Our recommended configuration automatically enables [`eslint-config-prettier`](https://github.com/prettier/eslint-config-prettier) to disable all formatting-related ESLint rules.
 
 ## Configuration (legacy: `.eslintrc*`)
 
@@ -65,18 +65,16 @@ This will:
 
 ## Configuration (new: `eslint.config.js`)
 
-For [flat configuration](https://eslint.org/docs/latest/use/configure/configuration-files-new), this plugin ships with an `eslint-plugin-prettier/recommended` config that sets up `eslint-plugin-prettier`. Note that unlike the legacy recommended configuration, the flat config does not configure [eslint-config-prettier](https://github.com/prettier/eslint-config-prettier) for you, and you should import and configure that within your own config.
+For [flat configuration](https://eslint.org/docs/latest/use/configure/configuration-files-new), this plugin ships with an `eslint-plugin-prettier/recommended` config that sets up both `eslint-plugin-prettier` and [`eslint-config-prettier`](https://github.com/prettier/eslint-config-prettier) in one go.
 
-Import `eslint-plugin-prettier/recommended` and `eslint-config-prettier` and add them as the _last_ items in the configuration array in your `eslint.config.js` file so that `eslint-config-prettier` has the opportunity to override other configs:
+Import `eslint-plugin-prettier/recommended` and add it as the _last_ item in the configuration array in your `eslint.config.js` file so that `eslint-config-prettier` has the opportunity to override other configs:
 
 ```js
 const eslintPluginPrettierRecommended = require('eslint-plugin-prettier/recommended');
-const eslintConfigPrettier = require('eslint-config-prettier');
 
 module.exports = [
   // Any other config imports go at the top
   eslintPluginPrettierRecommended,
-  eslintConfigPrettier,
 ];
 ```
 

eslint.config.js

@@ -3,7 +3,6 @@ const eslintPluginN = require('eslint-plugin-n');
 const eslintPluginEslintComments = require('@eslint-community/eslint-plugin-eslint-comments');
 const eslintPluginEslintPluginRecommended = require('eslint-plugin-eslint-plugin/configs/recommended');
 const eslintPluginMdx = require('eslint-plugin-mdx');
-const eslintConfigPrettier = require('eslint-config-prettier');
 const eslintPluginPrettierRecommended = require('./recommended');
 
 module.exports = [
@@ -21,7 +20,6 @@ module.exports = [
   eslintPluginMdx.flat,
   eslintPluginMdx.flatCodeBlocks,
   eslintPluginPrettierRecommended,
-  eslintConfigPrettier,
   {
     rules: {
       'eslint-plugin/report-message-format': ['error', '^[^a-z].*\\.$'],

recommended.js

@@ -1,13 +1,15 @@
+const eslintConfigPrettier = require('eslint-config-prettier');
 const eslintPluginPrettier = require('./eslint-plugin-prettier');
 
-// This diverges from the legacy format recommended config, as it does not
-// extend from the `eslint-config-prettier` ruleset. When using the flat config
-// the consumer should add eslint-config-prettier to their own root config.
+// Merge the contents of eslint-config-prettier into every
 module.exports = {
+  ...eslintConfigPrettier,
   plugins: {
+    ...eslintConfigPrettier?.plugins,
     prettier: eslintPluginPrettier,
   },
   rules: {
+    ...eslintConfigPrettier?.rules,
     'prettier/prettier': 'error',
     'arrow-body-style': 'off',
     'prefer-arrow-callback': 'off',