xo 0.44.0 → 0.46.2

package/config/plugins.cjs

@@ -3,7 +3,7 @@
 module.exports = {
 	// Repeated here from eslint-config-xo in case some plugins set something different
 	parserOptions: {
-		ecmaVersion: 2021,
+		ecmaVersion: 'latest',
 		sourceType: 'module',
 		ecmaFeatures: {
 			jsx: true,
@@ -14,7 +14,8 @@ module.exports = {
 		'no-use-extend-native',
 		'ava',
 		'unicorn',
-		'promise',
+		// Disabled as the plugin doesn't support ESLint 8 yet.
+		// 'promise',
 		'import',
 		'node',
 		'eslint-comments',
@@ -173,17 +174,19 @@ module.exports = {
 		// TODO: Temporarily disabled as the rule is buggy.
 		'function-call-argument-newline': 'off',
 
-		'promise/param-names': 'error',
-		'promise/no-return-wrap': [
-			'error',
-			{
-				allowReject: true,
-			},
-		],
-		'promise/no-new-statics': 'error',
-		'promise/no-return-in-finally': 'error',
-		'promise/valid-params': 'error',
-		'promise/prefer-await-to-then': 'error',
+		// Disabled as the plugin doesn't support ESLint 8 yet.
+		// 'promise/param-names': 'error',
+		// 'promise/no-return-wrap': [
+		// 	'error',
+		// 	{
+		// 		allowReject: true,
+		// 	},
+		// ],
+		// 'promise/no-new-statics': 'error',
+		// 'promise/no-return-in-finally': 'error',
+		// 'promise/valid-params': 'error',
+		// 'promise/prefer-await-to-then': 'error',
+
 		'import/default': 'error',
 		'import/export': 'error',
 		'import/extensions': [
@@ -200,9 +203,8 @@ module.exports = {
 		],
 		'import/first': 'error',
 
-		// Disabled as it doesn't work with TypeScript.
-		// This issue and some others: https://github.com/benmosher/eslint-plugin-import/issues/1341
-		// 'import/named': 'error',
+		// Enabled, but disabled on TypeScript (https://github.com/xojs/xo/issues/576)
+		'import/named': 'error',
 
 		'import/namespace': [
 			'error',

package/index.js

@@ -1,7 +1,7 @@
 import path from 'node:path';
 import {ESLint} from 'eslint';
 import {globby, isGitIgnoredSync} from 'globby';
-import {isEqual} from 'lodash-es';
+import {isEqual, groupBy} from 'lodash-es';
 import micromatch from 'micromatch';
 import arrify from 'arrify';
 import slash from 'slash';
@@ -12,30 +12,6 @@ import {
 } from './lib/options-manager.js';
 import {mergeReports, processReport, getIgnoredReport} from './lib/report.js';
 
-const runEslint = async (lint, options) => {
-	const {filePath, eslintOptions, isQuiet} = options;
-	const {cwd, baseConfig: {ignorePatterns}} = eslintOptions;
-
-	if (
-		filePath
-		&& (
-			micromatch.isMatch(path.relative(cwd, filePath), ignorePatterns)
-			|| isGitIgnoredSync({cwd, ignore: ignorePatterns})(filePath)
-		)
-	) {
-		return getIgnoredReport(filePath);
-	}
-
-	const eslint = new ESLint(eslintOptions);
-
-	if (filePath && await eslint.isPathIgnored(filePath)) {
-		return getIgnoredReport(filePath);
-	}
-
-	const report = await lint(eslint);
-	return processReport(report, {isQuiet});
-};
-
 const globFiles = async (patterns, options) => {
 	const {ignores, extensions, cwd} = (await mergeWithFileConfig(options)).options;
 
@@ -59,32 +35,76 @@ const getConfig = async options => {
 
 const lintText = async (string, options) => {
 	options = await parseOptions(options);
-	const {filePath, warnIgnored, eslintOptions} = options;
-	const {ignorePatterns} = eslintOptions.baseConfig;
+	const {filePath, warnIgnored, eslintOptions, isQuiet} = options;
+	const {cwd, baseConfig: {ignorePatterns}} = eslintOptions;
 
 	if (typeof filePath !== 'string' && !isEqual(getIgnores({}), ignorePatterns)) {
 		throw new Error('The `ignores` option requires the `filePath` option to be defined.');
 	}
 
-	return runEslint(
-		eslint => eslint.lintText(string, {filePath, warnIgnored}),
-		options,
-	);
-};
+	if (
+		filePath
+		&& (
+			micromatch.isMatch(path.relative(cwd, filePath), ignorePatterns)
+			|| isGitIgnoredSync({cwd, ignore: ignorePatterns})(filePath)
+		)
+	) {
+		return getIgnoredReport(filePath);
+	}
 
-const lintFile = async (filePath, options) => runEslint(
-	eslint => eslint.lintFiles([filePath]),
-	await parseOptions({...options, filePath}),
-);
+	const eslint = new ESLint(eslintOptions);
+
+	if (filePath && await eslint.isPathIgnored(filePath)) {
+		return getIgnoredReport(filePath);
+	}
+
+	const report = await eslint.lintText(string, {filePath, warnIgnored});
+	return processReport(report, {isQuiet});
+};
 
 const lintFiles = async (patterns, options) => {
 	const files = await globFiles(patterns, options);
 
-	const reports = await Promise.all(
-		files.map(filePath => lintFile(filePath, options)),
+	const allOptions = await Promise.all(
+		files.map(filePath => parseOptions({...options, filePath})),
 	);
 
-	const report = mergeReports(reports.filter(({isIgnored}) => !isIgnored));
+	// Files with same `xoConfigPath` can lint together
+	// https://github.com/xojs/xo/issues/599
+	const groups = groupBy(allOptions, 'eslintConfigId');
+
+	const reports = await Promise.all(
+		Object.values(groups)
+			.map(async filesWithOptions => {
+				const options = filesWithOptions[0];
+				const eslint = new ESLint(options.eslintOptions);
+				const files = [];
+
+				for (const options of filesWithOptions) {
+					const {filePath, eslintOptions} = options;
+					const {cwd, baseConfig: {ignorePatterns}} = eslintOptions;
+					if (filePath
+						&& (
+							micromatch.isMatch(path.relative(cwd, filePath), ignorePatterns)
+							|| isGitIgnoredSync({cwd, ignore: ignorePatterns})(filePath)
+						)) {
+						continue;
+					}
+
+					// eslint-disable-next-line no-await-in-loop
+					if ((await eslint.isPathIgnored(filePath))) {
+						continue;
+					}
+
+					files.push(filePath);
+				}
+
+				const report = await eslint.lintFiles(files);
+
+				return processReport(report, {isQuiet: options.isQuiet});
+			}));
+
+	const report = mergeReports(reports);
 
 	return report;
 };

package/lib/constants.js

@@ -106,13 +106,6 @@ const ENGINE_RULES = {
 	},
 };
 
-const PRETTIER_CONFIG_OVERRIDE = {
-	'eslint-plugin-babel': 'prettier/babel',
-	'eslint-plugin-flowtype': 'prettier/flowtype',
-	'eslint-plugin-standard': 'prettier/standard',
-	'eslint-plugin-vue': 'prettier/vue',
-};
-
 const MODULE_NAME = 'xo';
 
 const CONFIG_FILES = [
@@ -144,7 +137,6 @@ export {
 	DEFAULT_EXTENSION,
 	TYPESCRIPT_EXTENSION,
 	ENGINE_RULES,
-	PRETTIER_CONFIG_OVERRIDE,
 	MODULE_NAME,
 	CONFIG_FILES,
 	MERGE_OPTIONS_CONCAT,

package/lib/options-manager.js

@@ -1,11 +1,10 @@
+import {existsSync, promises as fs} from 'node:fs';
 import process from 'node:process';
 import os from 'node:os';
 import path from 'node:path';
-import fsExtra from 'fs-extra';
 import arrify from 'arrify';
 import {mergeWith, flow, pick} from 'lodash-es';
-import pathExists from 'path-exists';
-import findUp from 'find-up';
+import {findUpSync} from 'find-up';
 import findCacheDir from 'find-cache-dir';
 import prettier from 'prettier';
 import semver from 'semver';
@@ -22,7 +21,6 @@ import {
 	DEFAULT_EXTENSION,
 	TYPESCRIPT_EXTENSION,
 	ENGINE_RULES,
-	PRETTIER_CONFIG_OVERRIDE,
 	MODULE_NAME,
 	CONFIG_FILES,
 	MERGE_OPTIONS_CONCAT,
@@ -52,6 +50,7 @@ const DEFAULT_CONFIG = {
 	cache: true,
 	cacheLocation: path.join(cacheLocation(), 'xo-cache.json'),
 	globInputPaths: false,
+	resolvePluginsRelativeTo: __dirname,
 	baseConfig: {
 		extends: [
 			resolveLocalConfig('xo'),
@@ -117,22 +116,57 @@ const mergeWithFileConfig = async options => {
 	options = mergeOptions(options, xoOptions, enginesOptions);
 	options.cwd = xoConfigPath && path.dirname(xoConfigPath) !== options.cwd ? path.resolve(options.cwd, path.dirname(xoConfigPath)) : options.cwd;
 
+	// Very simple way to ensure eslint is ran minimal times across
+	// all linted files, once for each unique configuration - xo config path + override hash + tsconfig path
+	let eslintConfigId = xoConfigPath;
 	if (options.filePath) {
-		({options} = applyOverrides(options.filePath, options));
+		const overrides = applyOverrides(options.filePath, options);
+		options = overrides.options;
+
+		if (overrides.hash) {
+			eslintConfigId += overrides.hash;
+		}
 	}
 
 	const prettierOptions = options.prettier ? await prettier.resolveConfig(searchPath, {editorconfig: true}) || {} : {};
 
 	if (options.filePath && isTypescript(options.filePath)) {
-		const tsConfigExplorer = cosmiconfig([], {searchPlaces: ['tsconfig.json'], loaders: {'.json': (_, content) => JSON5.parse(content)}});
-		const {config: tsConfig, filepath: tsConfigPath} = (await tsConfigExplorer.search(options.filePath)) || {};
+		// We can skip looking up the tsconfig if we have it defined
+		// in our parser options already. Otherwise we can look it up and create it as normal
+		const {project: tsConfigProjectPath, tsconfigRootDir} = options.parserOptions || {};
+
+		let tsConfig;
+		let tsConfigPath;
+		if (tsConfigProjectPath) {
+			tsConfigPath = path.resolve(options.cwd, tsConfigProjectPath);
+			tsConfig = await json.load(tsConfigPath);
+		} else {
+			const tsConfigExplorer = cosmiconfig([], {
+				searchPlaces: ['tsconfig.json'],
+				loaders: {'.json': (_, content) => JSON5.parse(content)},
+				stopDir: tsconfigRootDir,
+			});
+			const searchResults = (await tsConfigExplorer.search(options.filePath)) || {};
+			tsConfigPath = searchResults.filepath;
+			tsConfig = searchResults.config;
+		}
+
+		if (tsConfigPath) {
+			options.tsConfigPath = tsConfigPath;
+			eslintConfigId += tsConfigPath;
+		} else {
+			const {path: tsConfigCachePath, hash: tsConfigHash} = await getTsConfigCachePath([eslintConfigId], tsConfigPath, options.cwd);
+			eslintConfigId += tsConfigHash;
+			options.tsConfigPath = tsConfigCachePath;
+			const config = makeTSConfig(tsConfig, tsConfigPath, [options.filePath]);
+			await fs.mkdir(path.dirname(options.tsConfigPath), {recursive: true});
+			await fs.writeFile(options.tsConfigPath, JSON.stringify(config));
+		}
 
-		options.tsConfigPath = await getTsConfigCachePath([options.filePath], options.tsConfigPath, options.cwd);
 		options.ts = true;
-		await fsExtra.outputJson(options.tsConfigPath, makeTSConfig(tsConfig, tsConfigPath, [options.filePath]));
 	}
 
-	return {options, prettierOptions};
+	return {options, prettierOptions, eslintConfigId};
 };
 
 /**
@@ -141,10 +175,14 @@ Hashing based on https://github.com/eslint/eslint/blob/cf38d0d939b62f3670cdd59f0
 */
 const getTsConfigCachePath = async (files, tsConfigPath, cwd) => {
 	const {version} = await json.load('../package.json');
-	return path.join(
-		cacheLocation(cwd),
-		`tsconfig.${murmur(`${version}_${nodeVersion}_${stringify({files: files.sort(), tsConfigPath})}`).result().toString(36)}.json`,
-	);
+	const tsConfigHash = murmur(`${version}_${nodeVersion}_${stringify({files: files.sort(), tsConfigPath})}`).result().toString(36);
+	return {
+		path: path.join(
+			cacheLocation(cwd),
+			`tsconfig.${tsConfigHash}.json`,
+		),
+		hash: tsConfigHash,
+	};
 };
 
 const makeTSConfig = (tsConfig, tsConfigPath, files) => {
@@ -207,7 +245,7 @@ const mergeOptions = (options, xoOptions = {}, enginesOptions = {}) => {
 		...options,
 	});
 
-	mergedOptions.extensions = DEFAULT_EXTENSION.concat(mergedOptions.extensions || []);
+	mergedOptions.extensions = [...DEFAULT_EXTENSION, ...(mergedOptions.extensions || [])];
 	mergedOptions.ignores = getIgnores(mergedOptions);
 
 	return mergedOptions;
@@ -350,6 +388,10 @@ const buildXOConfig = options => config => {
 
 		// Does not work when the TS definition exports a default const.
 		config.baseConfig.rules['import/default'] = 'off';
+
+		// Disabled as it doesn't work with TypeScript.
+		// This issue and some others: https://github.com/benmosher/eslint-plugin-import/issues/1341
+		config.baseConfig.rules['import/named'] = 'off';
 	}
 
 	config.baseConfig.settings['import/resolver'] = gatherImportResolvers(options);
@@ -361,7 +403,7 @@ const buildExtendsConfig = options => config => {
 	if (options.extends && options.extends.length > 0) {
 		const configs = options.extends.map(name => {
 			// Don't do anything if it's a filepath
-			if (pathExists.sync(name)) {
+			if (existsSync(name)) {
 				return name;
 			}
 
@@ -390,19 +432,11 @@ const buildPrettierConfig = (options, prettierConfig) => config => {
 		// The prettier plugin uses Prettier to format the code with `--fix`
 		config.baseConfig.plugins.push('prettier');
 
-		// The prettier config overrides ESLint stylistic rules that are handled by Prettier
-		config.baseConfig.extends.push('prettier');
+		// The prettier plugin overrides ESLint stylistic rules that are handled by Prettier
+		config.baseConfig.extends.push('plugin:prettier/recommended');
 
 		// The `prettier/prettier` rule reports errors if the code is not formatted in accordance to Prettier
 		config.baseConfig.rules['prettier/prettier'] = ['error', mergeWithPrettierConfig(options, prettierConfig)];
-
-		// If the user has the React, Flowtype, or Standard plugin, add the corresponding Prettier rule overrides
-		// See https://github.com/prettier/eslint-config-prettier for the list of plugins overrrides
-		for (const [plugin, prettierConfig] of Object.entries(PRETTIER_CONFIG_OVERRIDE)) {
-			if (options.cwd && resolveFrom.silent(plugin, options.cwd)) {
-				config.baseConfig.extends.push(prettierConfig);
-			}
-		}
 	}
 
 	return config;
@@ -428,7 +462,7 @@ const mergeWithPrettierConfig = (options, prettierOptions) => {
 		{
 			singleQuote: true,
 			bracketSpacing: false,
-			jsxBracketSameLine: false,
+			bracketSameLine: false,
 			trailingComma: 'all',
 			tabWidth: normalizeSpaces(options),
 			useTabs: !options.space,
@@ -441,7 +475,7 @@ const mergeWithPrettierConfig = (options, prettierOptions) => {
 
 const buildTSConfig = options => config => {
 	if (options.ts) {
-		config.baseConfig.extends.push('xo-typescript');
+		config.baseConfig.extends.push(require.resolve('eslint-config-xo-typescript'));
 		config.baseConfig.parser = require.resolve('@typescript-eslint/parser');
 		config.baseConfig.parserOptions = {
 			...config.baseConfig.parserOptions,
@@ -487,11 +521,11 @@ const findApplicableOverrides = (path, overrides) => {
 	const applicable = [];
 
 	for (const override of overrides) {
-		hash <<= 1;
+		hash <<= 1; // eslint-disable-line no-bitwise
 
 		if (micromatch.isMatch(path, override.files)) {
 			applicable.push(override);
-			hash |= 1;
+			hash |= 1; // eslint-disable-line no-bitwise
 		}
 	}
 
@@ -501,7 +535,7 @@ const findApplicableOverrides = (path, overrides) => {
 	};
 };
 
-const getIgnores = ({ignores}) => DEFAULT_IGNORES.concat(ignores || []);
+const getIgnores = ({ignores}) => [...DEFAULT_IGNORES, ...(ignores || [])];
 
 const gatherImportResolvers = options => {
 	let resolvers = {};
@@ -521,7 +555,7 @@ const gatherImportResolvers = options => {
 		webpackResolverSettings = options.webpack === true ? {} : options.webpack;
 	} else if (!(options.webpack === false || resolvers.webpack)) {
 		// If a webpack config file exists, add the import resolver automatically
-		const webpackConfigPath = findUp.sync('webpack.config.js', {cwd: options.cwd});
+		const webpackConfigPath = findUpSync('webpack.config.js', {cwd: options.cwd});
 		if (webpackConfigPath) {
 			webpackResolverSettings = {config: webpackConfigPath};
 		}
@@ -542,13 +576,14 @@ const gatherImportResolvers = options => {
 
 const parseOptions = async options => {
 	options = normalizeOptions(options);
-	const {options: foundOptions, prettierOptions} = await mergeWithFileConfig(options);
+	const {options: foundOptions, prettierOptions, eslintConfigId} = await mergeWithFileConfig(options);
 	const {filePath, warnIgnored, ...eslintOptions} = buildConfig(foundOptions, prettierOptions);
 	return {
 		filePath,
 		warnIgnored,
 		isQuiet: options.quiet,
 		eslintOptions,
+		eslintConfigId,
 	};
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "xo",
-	"version": "0.44.0",
+	"version": "0.46.2",
 	"description": "JavaScript/TypeScript linter (ESLint wrapper) with great defaults",
 	"license": "MIT",
 	"repository": "xojs/xo",
@@ -16,6 +16,7 @@
 		"node": ">=12.20"
 	},
 	"scripts": {
+		"test:clean": "find ./test -type d -name 'node_modules' -prune -not -path ./test/fixtures/project/node_modules -exec rm -rf '{}' +",
 		"test": "node cli.js && nyc ava"
 	},
 	"files": [
@@ -51,59 +52,59 @@
 		"javascript",
 		"typescript"
 	],
+	"bundledDependencies": [
+		"@typescript-eslint/eslint-plugin",
+		"@typescript-eslint/parser",
+		"eslint-config-xo-typescript"
+	],
 	"dependencies": {
-		"@eslint/eslintrc": "^1.0.0",
-		"@typescript-eslint/eslint-plugin": "^4.29.0",
-		"@typescript-eslint/parser": "^4.29.0",
+		"@eslint/eslintrc": "^1.0.3",
+		"@typescript-eslint/eslint-plugin": "^5.2.0",
+		"@typescript-eslint/parser": "^5.2.0",
 		"arrify": "^3.0.0",
-		"cosmiconfig": "^7.0.0",
-		"debug": "^4.3.2",
+		"cosmiconfig": "^7.0.1",
 		"define-lazy-prop": "^3.0.0",
-		"eslint": "^7.32.0",
+		"eslint": "^8.1.0",
 		"eslint-config-prettier": "^8.3.0",
-		"eslint-config-xo": "^0.38.0",
-		"eslint-config-xo-typescript": "^0.44.0",
+		"eslint-config-xo": "^0.39.0",
+		"eslint-config-xo-typescript": "^0.47.1",
 		"eslint-formatter-pretty": "^4.1.0",
-		"eslint-import-resolver-webpack": "^0.13.1",
-		"eslint-plugin-ava": "^12.0.0",
+		"eslint-import-resolver-webpack": "^0.13.2",
+		"eslint-plugin-ava": "^13.1.0",
 		"eslint-plugin-eslint-comments": "^3.2.0",
-		"eslint-plugin-import": "^2.23.4",
+		"eslint-plugin-import": "^2.25.2",
 		"eslint-plugin-no-use-extend-native": "^0.5.0",
 		"eslint-plugin-node": "^11.1.0",
-		"eslint-plugin-prettier": "^3.4.0",
-		"eslint-plugin-promise": "^5.1.0",
-		"eslint-plugin-unicorn": "^35.0.0",
-		"esm-utils": "^1.1.0",
-		"find-cache-dir": "^3.3.1",
-		"find-up": "^5.0.0",
-		"fs-extra": "^10.0.0",
+		"eslint-plugin-prettier": "^4.0.0",
+		"eslint-plugin-unicorn": "^37.0.1",
+		"esm-utils": "^2.0.0",
+		"find-cache-dir": "^3.3.2",
+		"find-up": "^6.2.0",
 		"get-stdin": "^9.0.0",
-		"globby": "^12.0.0",
+		"globby": "^12.0.2",
 		"imurmurhash": "^0.1.4",
-		"is-path-inside": "^4.0.0",
 		"json-stable-stringify-without-jsonify": "^1.0.1",
 		"json5": "^2.2.0",
 		"lodash-es": "^4.17.21",
 		"meow": "^10.1.1",
 		"micromatch": "^4.0.4",
 		"open-editor": "^3.0.0",
-		"path-exists": "^4.0.0",
-		"prettier": "^2.3.2",
+		"prettier": "^2.4.1",
 		"semver": "^7.3.5",
 		"slash": "^4.0.0",
 		"to-absolute-glob": "^2.0.2",
-		"typescript": "^4.3.5"
+		"typescript": "^4.4.4"
 	},
 	"devDependencies": {
 		"ava": "^3.15.0",
 		"eslint-config-xo-react": "^0.25.0",
-		"eslint-plugin-react": "^7.24.0",
+		"eslint-plugin-react": "^7.26.1",
 		"eslint-plugin-react-hooks": "^4.2.0",
 		"execa": "^5.1.1",
 		"nyc": "^15.1.0",
 		"proxyquire": "^2.1.3",
 		"temp-write": "^5.0.0",
-		"webpack": "^5.49.0"
+		"webpack": "^5.60.0"
 	},
 	"xo": {
 		"ignores": [

package/readme.md

@@ -169,14 +169,14 @@ module.exports = {
 };
 ```
 
-[Globals](https://eslint.org/docs/user-guide/configuring#specifying-globals) and [rules](https://eslint.org/docs/user-guide/configuring#configuring-rules) can be configured inline in files.
+[Globals](https://eslint.org/docs/user-guide/configuring/language-options#specifying-globals) and [rules](https://eslint.org/docs/user-guide/configuring/rules#configuring-rules) can be configured inline in files.
 
 ### envs
 
 Type: `string[]`\
 Default: `['es2021', 'node']`
 
-Which [environments](https://eslint.org/docs/user-guide/configuring#specifying-environments) your code is designed to run in. Each environment brings with it a certain set of predefined global variables.
+Which [environments](https://eslint.org/docs/user-guide/configuring/language-options#specifying-environments) your code is designed to run in. Each environment brings with it a certain set of predefined global variables.
 
 ### globals
 
@@ -188,7 +188,7 @@ Additional global variables your code accesses during execution.
 
 Type: `string[]`
 
-Some [paths](lib/options-manager.js) are ignored by default, including paths in `.gitignore` and [.eslintignore](https://eslint.org/docs/user-guide/configuring#eslintignore). Additional ignores can be added here.
+Some [paths](lib/options-manager.js) are ignored by default, including paths in `.gitignore` and [.eslintignore](https://eslint.org/docs/user-guide/configuring/ignoring-code#the-eslintignore-file). Additional ignores can be added here.
 
 ### space
 
@@ -221,14 +221,23 @@ Default: `false`
 
 Format code with [Prettier](https://github.com/prettier/prettier).
 
-The [Prettier options](https://prettier.io/docs/en/options.html) will be read from the [Prettier config](https://prettier.io/docs/en/configuration.html) and if **not set** will be determined as follow:
+[Prettier options](https://prettier.io/docs/en/options.html) will be based on your [Prettier config](https://prettier.io/docs/en/configuration.html). XO will then **merge** your options with its own defaults:
 - [semi](https://prettier.io/docs/en/options.html#semicolons): based on [semicolon](#semicolon) option
 - [useTabs](https://prettier.io/docs/en/options.html#tabs): based on [space](#space) option
 - [tabWidth](https://prettier.io/docs/en/options.html#tab-width): based on [space](#space) option
 - [trailingComma](https://prettier.io/docs/en/options.html#trailing-commas): `all`
 - [singleQuote](https://prettier.io/docs/en/options.html#quotes): `true`
 - [bracketSpacing](https://prettier.io/docs/en/options.html#bracket-spacing): `false`
-- [jsxBracketSameLine](https://prettier.io/docs/en/options.html#jsx-brackets): `false`
+
+To stick with Prettier's defaults, add this to your Prettier config:
+
+```js
+module.exports = {
+	trailingComma: 'es5',
+	singleQuote: false,
+	bracketSpacing: true,
+};
+```
 
 If contradicting options are set for both Prettier and XO an error will be thrown.
 
@@ -245,13 +254,13 @@ If set to `false`, no rules specific to a Node.js version will be enabled.
 
 Type: `string[]`
 
-Include third-party [plugins](https://eslint.org/docs/user-guide/configuring.html#configuring-plugins).
+Include third-party [plugins](https://eslint.org/docs/user-guide/configuring/plugins#configuring-plugins).
 
 ### extends
 
 Type: `string | string[]`
 
-Use one or more [shareable configs](https://eslint.org/docs/developer-guide/shareable-configs.html) or [plugin configs](https://eslint.org/docs/user-guide/configuring#using-the-configuration-from-a-plugin) to override any of the default rules (like `rules` above).
+Use one or more [shareable configs](https://eslint.org/docs/developer-guide/shareable-configs) or [plugin configs](https://eslint.org/docs/user-guide/configuring/configuration-files#using-a-configuration-from-a-plugin) to override any of the default rules (like `rules` above).
 
 ### extensions
 
@@ -263,7 +272,7 @@ Allow more extensions to be linted besides `.js`, `.jsx`, `.mjs`, and `.cjs`. Ma
 
 Type: `object`
 
-[Shared ESLint settings](https://eslint.org/docs/user-guide/configuring#adding-shared-settings) exposed to rules.
+[Shared ESLint settings](https://eslint.org/docs/user-guide/configuring/configuration-files#adding-shared-settings) exposed to rules.
 
 ### parser
 
@@ -275,7 +284,7 @@ ESLint parser. For example, [`@babel/eslint-parser`](https://github.com/babel/ba
 
 Type: `string`
 
-[ESLint processor.](https://eslint.org/docs/user-guide/configuring#specifying-processor)
+[ESLint processor.](https://eslint.org/docs/user-guide/configuring/plugins#specifying-processor)
 
 ### webpack