@antfu/eslint-config 9.5.0 → 9.5.1

package/README.md

@@ -336,36 +336,38 @@ And that's it! Or you can configure each integration individually, for example:
 import antfu from '@antfu/eslint-config'
 
 export default antfu({
-  // Type of the project. 'lib' for libraries, the default is 'app'
+  /** Type of the project. 'lib' for libraries, the default is 'app' */
   type: 'lib',
 
-  // `.eslintignore` is no longer supported in Flat config, use `ignores` instead
-  // The `ignores` option in the option (first argument) is specifically treated to always be global ignores
-  // And will **extend** the config's default ignores, not override them
-  // You can also pass a function to modify the default ignores
+  /**
+   * `.eslintignore` is no longer supported in Flat config, use `ignores` instead
+   * The `ignores` option in the option (first argument) is specifically treated to always be global ignores
+   * And will **extend** the config's default ignores, not override them
+   * You can also pass a function to modify the default ignores
+   */
   ignores: [
     '**/fixtures',
     // ...globs
   ],
 
-  // Parse the `.gitignore` file to get the ignores, on by default
+  /** Parse the `.gitignore` file to get the ignores, on by default */
   gitignore: true,
 
   // Enable stylistic formatting rules
   // stylistic: true,
 
-  // Or customize the stylistic rules
+  /** Or customize the stylistic rules */
   stylistic: {
     indent: 2, // 4, or 'tab'
     quotes: 'single', // or 'double'
     braceStyle: 'stroustrup', // '1tbs', or 'allman'
   },
 
-  // TypeScript and Vue are autodetected, you can also explicitly enable them:
+  /** TypeScript and Vue are autodetected, you can also explicitly enable them: */
   typescript: true,
   vue: true,
 
-  // Disable jsonc and yaml support
+  /** Disable jsonc and yaml support */
   jsonc: false,
   yaml: false,
 })
@@ -514,14 +516,14 @@ export default antfu(
     typescript: true
   },
   {
-    // Remember to specify the file glob here, otherwise it might cause the vue plugin to handle non-vue files
+    /** Remember to specify the file glob here, otherwise it might cause the vue plugin to handle non-vue files */
     files: ['**/*.vue'],
     rules: {
       'vue/operator-linebreak': ['error', 'before'],
     },
   },
   {
-    // Without `files`, they are general rules for all files (Markdown excluded — see note below)
+    /** Without `files`, they are general rules for all files (Markdown excluded, see note below) */
     rules: {
       'style/semi': ['error', 'never'],
     },
@@ -548,7 +550,7 @@ export default antfu({
     overrides: {
       'ts/consistent-type-definitions': ['error', 'interface'],
     },
-    // type aware rules overrides should write here
+    /** type aware rules overrides should write here */
     overridesTypeAware: {
       'ts/no-unsafe-assignment': ['warn'],
     }
@@ -841,8 +843,10 @@ import antfu from '@antfu/eslint-config'
 export default antfu({
   antislop: {
     sonarjs: false,
-    // an object enables `eslint-plugin-slop` and is forwarded to it
-    // via `settings.slop`, for example to only inspect recently changed code
+    /**
+     * an object enables `eslint-plugin-slop` and is forwarded to it
+     * via `settings.slop`, for example to only inspect recently changed code
+     */
     slop: {
       inspection: { mode: 'recent-changes', tracebackCommits: 5 },
     },

package/dist/cli.mjs

@@ -8,7 +8,7 @@ import { cac } from "cac";
 import parse from "parse-gitignore";
 import { execSync } from "node:child_process";
 //#region package.json
-var version = "9.5.0";
+var version = "9.5.1";
 //#endregion
 //#region src/cli/constants.ts
 const vscodeSettingsString = `
@@ -188,21 +188,22 @@ async function updatePackageJson(result) {
 	const pkgContent = await fsPromises.readFile(pathPackageJSON, "utf-8");
 	const pkg = JSON.parse(pkgContent);
 	pkg.devDependencies ??= {};
-	pkg.devDependencies["@antfu/eslint-config"] = `^${version}`;
-	pkg.devDependencies.eslint ??= versionsMap.eslint;
+	const devDependencies = pkg.devDependencies;
+	devDependencies["@antfu/eslint-config"] = `^${version}`;
+	devDependencies.eslint ??= versionsMap.eslint;
 	const addedPackages = [];
 	if (result.extra.length) result.extra.forEach((item) => {
 		switch (item) {
 			case "formatter":
 				[...dependenciesMap.formatter, ...result.frameworks.includes("astro") ? dependenciesMap.formatterAstro : []].forEach((f) => {
 					if (!f) return;
-					pkg.devDependencies[f] = versionsMap[f];
+					devDependencies[f] = versionsMap[f];
 					addedPackages.push(f);
 				});
 				break;
 			case "unocss":
 				dependenciesMap.unocss.forEach((f) => {
-					pkg.devDependencies[f] = versionsMap[f];
+					devDependencies[f] = versionsMap[f];
 					addedPackages.push(f);
 				});
 				break;
@@ -211,7 +212,7 @@ async function updatePackageJson(result) {
 	for (const framework of result.frameworks) {
 		const deps = dependenciesMap[framework];
 		if (deps) deps.forEach((f) => {
-			pkg.devDependencies[f] = versionsMap[f];
+			devDependencies[f] = versionsMap[f];
 			addedPackages.push(f);
 		});
 	}
@@ -259,7 +260,7 @@ async function run(options = {}) {
 	if (!argSkipPrompt) {
 		result = await p.group({
 			uncommittedConfirmed: () => {
-				if (argSkipPrompt || isGitClean()) return Promise.resolve(true);
+				if (isGitClean()) return Promise.resolve(true);
 				return p.confirm({
 					initialValue: false,
 					message: "There are uncommitted changes in the current repository, are you sure to continue?"

package/dist/index.d.mts

@@ -23418,7 +23418,7 @@ type Yoda = [] | [("always" | "never")] | [("always" | "never"), {
   onlyEquality?: boolean;
 }];
 // Names of all the configs
-type ConfigNames = 'antfu/gitignore' | 'antfu/ignores' | 'antfu/javascript/setup' | 'antfu/javascript/rules' | 'antfu/eslint-comments/rules' | 'antfu/command/rules' | 'antfu/perfectionist/setup' | 'antfu/node/setup' | 'antfu/node/rules' | 'antfu/jsdoc/setup' | 'antfu/jsdoc/rules' | 'antfu/imports/rules' | 'antfu/e18e/rules' | 'antfu/unicorn/setup' | 'antfu/unicorn/rules' | 'antfu/jsx/setup' | 'antfu/typescript/setup' | 'antfu/typescript/parser' | 'antfu/typescript/type-aware-parser' | 'antfu/typescript/rules' | 'antfu/typescript/rules-type-aware' | 'antfu/typescript/erasable-syntax-only' | 'antfu/antislop/rules' | 'antfu/stylistic/rules' | 'antfu/regexp/rules' | 'antfu/test/setup' | 'antfu/test/rules' | 'antfu/vue/setup' | 'antfu/vue/rules' | 'antfu/react/setup' | 'antfu/react/rules' | 'antfu/react/typescript' | 'antfu/react/type-aware-rules' | 'antfu/nextjs/setup' | 'antfu/nextjs/rules' | 'antfu/solid/setup' | 'antfu/solid/rules' | 'antfu/svelte/setup' | 'antfu/svelte/rules' | 'antfu/unocss' | 'antfu/astro/setup' | 'antfu/astro/rules' | 'antfu/angular/setup' | 'antfu/angular/rules/ts' | 'antfu/angular/rules/template' | 'antfu/jsonc/setup' | 'antfu/jsonc/rules' | 'antfu/sort/package-json' | 'antfu/sort/tsconfig-json' | 'antfu/pnpm/package-json' | 'antfu/pnpm/pnpm-workspace-yaml' | 'antfu/pnpm/pnpm-workspace-yaml-stylistic' | 'antfu/pnpm/pnpm-workspace-yaml-sort' | 'antfu/yaml/setup' | 'antfu/yaml/rules' | 'antfu/toml/setup' | 'antfu/toml/rules' | 'antfu/markdown/setup' | 'antfu/markdown/processor' | 'antfu/markdown/parser' | 'antfu/markdown/rules' | 'antfu/markdown/disables/code' | 'antfu/formatter/setup' | 'antfu/formatter/css' | 'antfu/formatter/scss' | 'antfu/formatter/less' | 'antfu/formatter/html' | 'antfu/formatter/xml' | 'antfu/formatter/svg' | 'antfu/formatter/markdown' | 'antfu/formatter/astro' | 'antfu/formatter/astro/disables' | 'antfu/formatter/graphql' | 'antfu/disables/scripts' | 'antfu/disables/cli' | 'antfu/disables/bin' | 'antfu/disables/dts' | 'antfu/disables/cjs' | 'antfu/disables/config-files';
+type ConfigNames = 'antfu/gitignore' | 'antfu/ignores' | 'antfu/javascript/setup' | 'antfu/javascript/rules' | 'antfu/eslint-comments/rules' | 'antfu/command/rules' | 'antfu/perfectionist/setup' | 'antfu/node/setup' | 'antfu/node/rules' | 'antfu/jsdoc/setup' | 'antfu/jsdoc/rules' | 'antfu/imports/rules' | 'antfu/e18e/rules' | 'antfu/unicorn/setup' | 'antfu/unicorn/rules' | 'antfu/jsx/setup' | 'antfu/typescript/setup' | 'antfu/typescript/parser' | 'antfu/typescript/type-aware-parser' | 'antfu/typescript/rules' | 'antfu/typescript/rules-type-aware' | 'antfu/typescript/erasable-syntax-only' | 'antfu/antislop/setup' | 'antfu/antislop/rules/universal' | 'antfu/antislop/rules/javascript' | 'antfu/stylistic/rules' | 'antfu/regexp/rules' | 'antfu/test/setup' | 'antfu/test/rules' | 'antfu/vue/setup' | 'antfu/vue/rules' | 'antfu/react/setup' | 'antfu/react/rules' | 'antfu/react/typescript' | 'antfu/react/type-aware-rules' | 'antfu/nextjs/setup' | 'antfu/nextjs/rules' | 'antfu/solid/setup' | 'antfu/solid/rules' | 'antfu/svelte/setup' | 'antfu/svelte/rules' | 'antfu/unocss' | 'antfu/astro/setup' | 'antfu/astro/rules' | 'antfu/angular/setup' | 'antfu/angular/rules/ts' | 'antfu/angular/rules/template' | 'antfu/jsonc/setup' | 'antfu/jsonc/rules' | 'antfu/sort/package-json' | 'antfu/sort/tsconfig-json' | 'antfu/pnpm/package-json' | 'antfu/pnpm/pnpm-workspace-yaml' | 'antfu/pnpm/pnpm-workspace-yaml-stylistic' | 'antfu/pnpm/pnpm-workspace-yaml-sort' | 'antfu/yaml/setup' | 'antfu/yaml/rules' | 'antfu/toml/setup' | 'antfu/toml/rules' | 'antfu/markdown/setup' | 'antfu/markdown/processor' | 'antfu/markdown/parser' | 'antfu/markdown/rules' | 'antfu/markdown/disables/code' | 'antfu/formatter/setup' | 'antfu/formatter/css' | 'antfu/formatter/scss' | 'antfu/formatter/less' | 'antfu/formatter/html' | 'antfu/formatter/xml' | 'antfu/formatter/svg' | 'antfu/formatter/markdown' | 'antfu/formatter/astro' | 'antfu/formatter/astro/disables' | 'antfu/formatter/graphql' | 'antfu/disables/scripts' | 'antfu/disables/cli' | 'antfu/disables/bin' | 'antfu/disables/dts' | 'antfu/disables/cjs' | 'antfu/disables/config-files';
 //#endregion
 //#region src/vender/prettier-types.d.ts
 /**
@@ -23492,7 +23492,7 @@ interface VendoredPrettierOptionsRequired {
   /**
    * Provide ability to support new languages to prettier.
    */
-  plugins: Array<string | any>;
+  plugins: Array<string | Record<string, unknown>>;
   /**
    * How to handle whitespaces in HTML.
    * @default "css"
@@ -23727,6 +23727,14 @@ interface OptionsAntislop extends OptionsOverrides {
    * @default true
    */
   sonarjs?: boolean;
+  /**
+   * Maximum allowed cognitive complexity for `sonarjs/cognitive-complexity`.
+   *
+   * Pass `false` to disable the rule entirely.
+   *
+   * @default 15
+   */
+  cognitiveComplexity?: number | false;
 }
 interface OptionsUnicorn extends OptionsOverrides {
   /**
@@ -24156,6 +24164,7 @@ declare function resolveSubOptions<K extends keyof OptionsConfig>(options: Optio
 declare function getOverrides<K extends keyof OptionsConfig>(options: OptionsConfig, key: K): Partial<Linter.RulesRecord & RuleOptions>;
 //#endregion
 //#region src/config-presets.d.ts
+/** @keep-sorted */
 declare const CONFIG_PRESET_FULL_ON: OptionsConfig;
 declare const CONFIG_PRESET_FULL_OFF: OptionsConfig;
 //#endregion
@@ -24178,7 +24187,7 @@ declare function comments(): Promise<TypedFlatConfigItem[]>;
 declare function disables(): Promise<TypedFlatConfigItem[]>;
 //#endregion
 //#region src/configs/formatters.d.ts
-declare function formatters(options?: OptionsFormatters | true, stylistic?: StylisticConfig): Promise<TypedFlatConfigItem[]>;
+declare function formatters(rawOptions?: OptionsFormatters | true, stylistic?: StylisticConfig): Promise<TypedFlatConfigItem[]>;
 //#endregion
 //#region src/configs/ignores.d.ts
 declare function ignores(userIgnores?: string[] | ((originals: string[]) => string[]), ignoreTypeScript?: boolean): Promise<TypedFlatConfigItem[]>;

package/dist/index.mjs

@@ -307,51 +307,71 @@ async function angular(options = {}) {
 //#endregion
 //#region src/configs/antislop.ts
 async function antislop(options = {}) {
-	const { overrides = {}, slop = true, sonarjs = true, typescript = false } = options;
+	const { cognitiveComplexity = 15, overrides = {}, slop = true, sonarjs = true } = options;
 	await ensurePackages([...slop ? ["eslint-plugin-slop"] : [], ...sonarjs ? ["eslint-plugin-sonarjs"] : []]);
 	const [pluginSlop, pluginSonarjs] = await Promise.all([slop ? interopDefault(import("eslint-plugin-slop")) : void 0, sonarjs ? interopDefault(import("eslint-plugin-sonarjs")) : void 0]);
-	return [{
-		name: "antfu/antislop/rules",
-		plugins: {
-			...slop ? { slop: pluginSlop } : {},
-			...sonarjs ? { sonarjs: pluginSonarjs } : {}
+	return [
+		{
+			name: "antfu/antislop/setup",
+			plugins: {
+				...slop ? { slop: pluginSlop } : {},
+				...sonarjs ? { sonarjs: pluginSonarjs } : {}
+			},
+			...typeof slop === "object" ? { settings: { slop } } : {}
 		},
-		...typeof slop === "object" ? { settings: { slop } } : {},
-		rules: {
-			...slop ? {
-				"slop/max-comment-length": "error",
-				"slop/no-chained-type-assertions": "error",
-				"slop/no-em-dash": "error",
-				"slop/no-jargon": "error",
-				"slop/no-trivial-functions": "error",
-				"slop/no-trivial-type-aliases": "error",
-				"slop/prefer-jsdoc": "error"
-			} : {},
-			...sonarjs ? {
-				"sonarjs/cognitive-complexity": "error",
-				"sonarjs/no-all-duplicated-branches": "error",
-				"sonarjs/no-collapsible-if": "error",
-				"sonarjs/no-commented-code": "error",
-				"sonarjs/no-dead-store": "error",
-				"sonarjs/no-duplicated-branches": "error",
-				"sonarjs/no-element-overwrite": "error",
-				"sonarjs/no-empty-collection": "error",
-				"sonarjs/no-gratuitous-expressions": "error",
-				"sonarjs/no-identical-conditions": "error",
-				"sonarjs/no-identical-expressions": "error",
-				"sonarjs/no-identical-functions": "error",
-				"sonarjs/no-invariant-returns": "error",
-				"sonarjs/no-inverted-boolean-check": "error",
-				"sonarjs/no-redundant-boolean": "error",
-				"sonarjs/no-redundant-jump": "error",
-				"sonarjs/no-unused-collection": "error",
-				"sonarjs/no-use-of-empty-return-value": "error",
-				"sonarjs/prefer-single-boolean-return": "error"
-			} : {},
-			...typescript ? { "ts/no-explicit-any": "error" } : {},
-			...overrides
+		...slop ? [{
+			files: [
+				...GLOB_ALL_SRC,
+				GLOB_JSONC,
+				GLOB_TOML,
+				GLOB_GRAPHQL
+			],
+			/**
+			* Markdown code fences are already scanned as part of the raw
+			* Markdown text, so exclude the virtual embedded-code files to
+			* avoid reporting the same em dash twice
+			*/
+			ignores: [GLOB_MARKDOWN_CODE],
+			name: "antfu/antislop/rules/universal",
+			rules: { "slop/no-em-dash": "error" }
+		}] : [],
+		{
+			files: [GLOB_SRC],
+			name: "antfu/antislop/rules/javascript",
+			rules: {
+				...slop ? {
+					"slop/max-comment-length": "error",
+					"slop/no-chained-type-assertions": "error",
+					"slop/no-jargon": "error",
+					"slop/no-trivial-functions": "error",
+					"slop/no-trivial-type-aliases": "error",
+					"slop/prefer-jsdoc": "error"
+				} : {},
+				...sonarjs ? {
+					...cognitiveComplexity === false ? {} : { "sonarjs/cognitive-complexity": ["error", cognitiveComplexity] },
+					"sonarjs/no-all-duplicated-branches": "error",
+					"sonarjs/no-collapsible-if": "error",
+					"sonarjs/no-commented-code": "error",
+					"sonarjs/no-dead-store": "error",
+					"sonarjs/no-duplicated-branches": "error",
+					"sonarjs/no-element-overwrite": "error",
+					"sonarjs/no-empty-collection": "error",
+					"sonarjs/no-gratuitous-expressions": "error",
+					"sonarjs/no-identical-conditions": "error",
+					"sonarjs/no-identical-expressions": "error",
+					"sonarjs/no-identical-functions": "error",
+					"sonarjs/no-invariant-returns": "error",
+					"sonarjs/no-inverted-boolean-check": "error",
+					"sonarjs/no-redundant-boolean": "error",
+					"sonarjs/no-redundant-jump": "error",
+					"sonarjs/no-unused-collection": "error",
+					"sonarjs/no-use-of-empty-return-value": "error",
+					"sonarjs/prefer-single-boolean-return": "error"
+				} : {},
+				...overrides
+			}
 		}
-	}];
+	];
 }
 //#endregion
 //#region src/configs/astro.ts
@@ -379,7 +399,12 @@ async function astro(options = {}) {
 		name: "antfu/astro/rules",
 		processor: "astro/client-side-ts",
 		rules: {
+			/**
+			* Astro uses top level await for e.g. data fetching
+			* https://docs.astro.build/en/guides/data-fetching/#fetch-in-astro
+			*/
 			"antfu/no-top-level-await": "off",
+			/** use recommended rules */
 			"astro/missing-client-only-directive-value": "error",
 			"astro/no-conflict-set-directives": "error",
 			"astro/no-deprecated-astro-canonicalurl": "error",
@@ -537,26 +562,136 @@ function mergePrettierOptions(options, overrides) {
 		plugins: [...overrides.plugins || [], ...options.plugins || []]
 	};
 }
-async function formatters(options = {}, stylistic = {}) {
-	if (options === true) {
-		const isPrettierPluginXmlInScope = isPackageInScope("@prettier/plugin-xml");
-		options = {
-			astro: isPackageInScope("prettier-plugin-astro"),
-			css: true,
-			graphql: true,
-			html: true,
-			markdown: true,
-			slidev: isPackageExists("@slidev/cli"),
-			svg: isPrettierPluginXmlInScope,
-			xml: isPrettierPluginXmlInScope
-		};
-	}
-	await ensurePackages([
+function buildCssConfigs(prettierOptions) {
+	return [
+		[
+			[GLOB_CSS, GLOB_POSTCSS],
+			"css",
+			"antfu/formatter/css"
+		],
+		[
+			[GLOB_SCSS],
+			"scss",
+			"antfu/formatter/scss"
+		],
+		[
+			[GLOB_LESS],
+			"less",
+			"antfu/formatter/less"
+		]
+	].map(([files, parser, name]) => ({
+		files: [...files],
+		languageOptions: { parser: parserPlain },
+		name,
+		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser })] }
+	}));
+}
+function buildXmlLikeConfig(prettierOptions, prettierXmlOptions, files, name) {
+	return {
+		files,
+		languageOptions: { parser: parserPlain },
+		name,
+		rules: { "format/prettier": ["error", mergePrettierOptions({
+			...prettierXmlOptions,
+			...prettierOptions
+		}, {
+			parser: "xml",
+			plugins: ["@prettier/plugin-xml"]
+		})] }
+	};
+}
+function buildMarkdownConfigs(options, prettierOptions, dprintOptions) {
+	const formater = options.markdown === true ? "prettier" : options.markdown;
+	const GLOB_SLIDEV = !options.slidev ? [] : options.slidev === true ? ["**/slides.md"] : options.slidev.files;
+	const configs = [{
+		files: [GLOB_MARKDOWN],
+		ignores: GLOB_SLIDEV,
+		languageOptions: { parser: parserPlain },
+		name: "antfu/formatter/markdown",
+		rules: { [`format/${formater}`]: ["error", formater === "prettier" ? mergePrettierOptions(prettierOptions, {
+			embeddedLanguageFormatting: "off",
+			parser: "markdown"
+		}) : {
+			...dprintOptions,
+			language: "markdown"
+		}] }
+	}];
+	if (options.slidev) configs.push({
+		files: GLOB_SLIDEV,
+		languageOptions: { parser: parserPlain },
+		name: "antfu/formatter/slidev",
+		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
+			embeddedLanguageFormatting: "off",
+			parser: "slidev",
+			plugins: ["prettier-plugin-slidev"]
+		})] }
+	});
+	return configs;
+}
+function buildAstroConfigs(prettierOptions) {
+	return [{
+		files: [GLOB_ASTRO],
+		languageOptions: { parser: parserPlain },
+		name: "antfu/formatter/astro",
+		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
+			parser: "astro",
+			plugins: ["prettier-plugin-astro"]
+		})] }
+	}, {
+		files: [GLOB_ASTRO, GLOB_ASTRO_TS],
+		name: "antfu/formatter/astro/disables",
+		rules: {
+			"style/arrow-parens": "off",
+			"style/block-spacing": "off",
+			"style/comma-dangle": "off",
+			"style/indent": "off",
+			"style/no-multi-spaces": "off",
+			"style/quotes": "off",
+			"style/semi": "off"
+		}
+	}];
+}
+function resolveFormattersOptions(options) {
+	if (options !== true) return options;
+	const isPrettierPluginXmlInScope = isPackageInScope("@prettier/plugin-xml");
+	return {
+		astro: isPackageInScope("prettier-plugin-astro"),
+		css: true,
+		graphql: true,
+		html: true,
+		markdown: true,
+		slidev: isPackageExists("@slidev/cli"),
+		svg: isPrettierPluginXmlInScope,
+		xml: isPrettierPluginXmlInScope
+	};
+}
+function buildHtmlConfig(prettierOptions) {
+	return {
+		files: [GLOB_HTML],
+		languageOptions: { parser: parserPlain },
+		name: "antfu/formatter/html",
+		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "html" })] }
+	};
+}
+function buildGraphqlConfig(prettierOptions) {
+	return {
+		files: [GLOB_GRAPHQL],
+		languageOptions: { parser: parserPlain },
+		name: "antfu/formatter/graphql",
+		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "graphql" })] }
+	};
+}
+function getFormattersPackagesToEnsure(options) {
+	return [
 		"eslint-plugin-format",
 		options.markdown && options.slidev ? "prettier-plugin-slidev" : void 0,
 		options.astro ? "prettier-plugin-astro" : void 0,
 		options.xml || options.svg ? "@prettier/plugin-xml" : void 0
-	]);
+	];
+}
+async function formatters(rawOptions = {}, stylistic = {}) {
+	const options = resolveFormattersOptions(rawOptions);
+	await ensurePackages(getFormattersPackagesToEnsure(options));
 	if (options.slidev && options.markdown !== true && options.markdown !== "prettier") throw new Error("`slidev` option only works when `markdown` is enabled with `prettier`");
 	const { indent, quotes, semi } = {
 		...StylisticConfigDefaults,
@@ -587,109 +722,13 @@ async function formatters(options = {}, stylistic = {}) {
 		name: "antfu/formatter/setup",
 		plugins: { format: await interopDefault(import("eslint-plugin-format")) }
 	}];
-	if (options.css) configs.push({
-		files: [GLOB_CSS, GLOB_POSTCSS],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/css",
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "css" })] }
-	}, {
-		files: [GLOB_SCSS],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/scss",
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "scss" })] }
-	}, {
-		files: [GLOB_LESS],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/less",
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "less" })] }
-	});
-	if (options.html) configs.push({
-		files: [GLOB_HTML],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/html",
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "html" })] }
-	});
-	if (options.xml) configs.push({
-		files: [GLOB_XML],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/xml",
-		rules: { "format/prettier": ["error", mergePrettierOptions({
-			...prettierXmlOptions,
-			...prettierOptions
-		}, {
-			parser: "xml",
-			plugins: ["@prettier/plugin-xml"]
-		})] }
-	});
-	if (options.svg) configs.push({
-		files: [GLOB_SVG],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/svg",
-		rules: { "format/prettier": ["error", mergePrettierOptions({
-			...prettierXmlOptions,
-			...prettierOptions
-		}, {
-			parser: "xml",
-			plugins: ["@prettier/plugin-xml"]
-		})] }
-	});
-	if (options.markdown) {
-		const formater = options.markdown === true ? "prettier" : options.markdown;
-		const GLOB_SLIDEV = !options.slidev ? [] : options.slidev === true ? ["**/slides.md"] : options.slidev.files;
-		configs.push({
-			files: [GLOB_MARKDOWN],
-			ignores: GLOB_SLIDEV,
-			languageOptions: { parser: parserPlain },
-			name: "antfu/formatter/markdown",
-			rules: { [`format/${formater}`]: ["error", formater === "prettier" ? mergePrettierOptions(prettierOptions, {
-				embeddedLanguageFormatting: "off",
-				parser: "markdown"
-			}) : {
-				...dprintOptions,
-				language: "markdown"
-			}] }
-		});
-		if (options.slidev) configs.push({
-			files: GLOB_SLIDEV,
-			languageOptions: { parser: parserPlain },
-			name: "antfu/formatter/slidev",
-			rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
-				embeddedLanguageFormatting: "off",
-				parser: "slidev",
-				plugins: ["prettier-plugin-slidev"]
-			})] }
-		});
-	}
-	if (options.astro) {
-		configs.push({
-			files: [GLOB_ASTRO],
-			languageOptions: { parser: parserPlain },
-			name: "antfu/formatter/astro",
-			rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
-				parser: "astro",
-				plugins: ["prettier-plugin-astro"]
-			})] }
-		});
-		configs.push({
-			files: [GLOB_ASTRO, GLOB_ASTRO_TS],
-			name: "antfu/formatter/astro/disables",
-			rules: {
-				"style/arrow-parens": "off",
-				"style/block-spacing": "off",
-				"style/comma-dangle": "off",
-				"style/indent": "off",
-				"style/no-multi-spaces": "off",
-				"style/quotes": "off",
-				"style/semi": "off"
-			}
-		});
-	}
-	if (options.graphql) configs.push({
-		files: [GLOB_GRAPHQL],
-		languageOptions: { parser: parserPlain },
-		name: "antfu/formatter/graphql",
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "graphql" })] }
-	});
+	if (options.css) configs.push(...buildCssConfigs(prettierOptions));
+	if (options.html) configs.push(buildHtmlConfig(prettierOptions));
+	if (options.xml) configs.push(buildXmlLikeConfig(prettierOptions, prettierXmlOptions, [GLOB_XML], "antfu/formatter/xml"));
+	if (options.svg) configs.push(buildXmlLikeConfig(prettierOptions, prettierXmlOptions, [GLOB_SVG], "antfu/formatter/svg"));
+	if (options.markdown) configs.push(...buildMarkdownConfigs(options, prettierOptions, dprintOptions));
+	if (options.astro) configs.push(...buildAstroConfigs(prettierOptions));
+	if (options.graphql) configs.push(buildGraphqlConfig(prettierOptions));
 	return configs;
 }
 //#endregion
@@ -1102,6 +1141,11 @@ async function markdown(options = {}) {
 			files,
 			ignores: [GLOB_MARKDOWN_IN_MARKDOWN],
 			name: "antfu/markdown/processor",
+			/**
+			* `eslint-plugin-markdown` only creates virtual files for code blocks,
+			* but not the markdown file itself. We use `eslint-merge-processors` to
+			* add a pass-through processor for the markdown file itself.
+			*/
 			processor: mergeProcessors([markdown.processors.markdown, processorPassThrough])
 		},
 		{
@@ -1115,6 +1159,7 @@ async function markdown(options = {}) {
 			rules: {
 				...markdown.configs.recommended.at(0)?.rules,
 				"markdown/fenced-code-language": "off",
+				/** https://github.com/eslint/markdown/issues/294 */
 				"markdown/no-missing-label-refs": "off",
 				...overridesMarkdown
 			}
@@ -1309,14 +1354,14 @@ async function pnpm(options) {
 				"pnpm/yaml-no-unused-catalog-item": "error"
 			}
 		});
-		if (yaml && stylistic) configs.push({
+		if (stylistic) configs.push({
 			files: ["pnpm-workspace.yaml"],
 			languageOptions: { parser: yamlParser },
 			name: "antfu/pnpm/pnpm-workspace-yaml-stylistic",
 			plugins: { pnpm: pluginPnpm },
 			rules: { "pnpm/yaml-blank-lines": "error" }
 		});
-		if (yaml && sort) configs.push({
+		if (sort) configs.push({
 			files: ["pnpm-workspace.yaml"],
 			languageOptions: { parser: yamlParser },
 			name: "antfu/pnpm/pnpm-workspace-yaml-sort",
@@ -1565,6 +1610,7 @@ async function react(options = {}) {
 			name: "antfu/react/rules",
 			rules: {
 				...pluginReact.configs.recommended.rules,
+				/** preconfigured rules from eslint-plugin-react-refresh https://github.com/ArnaudBarre/eslint-plugin-react-refresh/tree/main/src */
 				"react-refresh/only-export-components": ["error", {
 					allowConstantExport: isAllowConstantExport,
 					allowExportNames: [...isUsingNext ? [
@@ -1601,6 +1647,7 @@ async function react(options = {}) {
 			files: filesTypeAware,
 			name: "antfu/react/typescript",
 			rules: {
+				/** Disables rules that are already handled by TypeScript */
 				"react/dom-no-string-style-prop": "off",
 				"react/dom-no-unknown-property": "off"
 			}
@@ -1653,17 +1700,23 @@ async function solid(options = {}) {
 		},
 		name: "antfu/solid/rules",
 		rules: {
+			/** reactivity */
 			"solid/components-return-once": "warn",
 			"solid/event-handlers": ["error", {
+				/** if true, don't warn on ambiguously named event handlers like `onclick` or `onchange` */
 				ignoreCase: false,
+				/** if true, warn when spreading event handlers onto JSX. Enable for Solid < v1.6. */
 				warnOnSpread: false
 			}],
+			/** these rules are mostly style suggestions */
 			"solid/imports": "error",
+			/** identifier usage is important */
 			"solid/jsx-no-duplicate-props": "error",
 			"solid/jsx-no-script-url": "error",
 			"solid/jsx-no-undef": "error",
 			"solid/jsx-uses-vars": "error",
 			"solid/no-destructure": "error",
+			/** security problems */
 			"solid/no-innerhtml": ["error", { allowStatic: true }],
 			"solid/no-react-deps": "error",
 			"solid/no-react-specific-props": "error",
@@ -2115,6 +2168,7 @@ async function typescript(options = {}) {
 	}
 	return [
 		{
+			/** Install the plugins without globs, so they can be configured separately. */
 			name: "antfu/typescript/setup",
 			plugins: {
 				antfu: pluginAntfu,
@@ -2257,6 +2311,10 @@ async function vue(options = {}) {
 		...a11y ? [interopDefault(import("eslint-plugin-vuejs-accessibility"))] : []
 	]);
 	return [{
+		/**
+		* This allows Vue plugin to work with auto imports
+		* https://github.com/vuejs/eslint-plugin-vue/pull/2422
+		*/
 		languageOptions: { globals: {
 			computed: "readonly",
 			defineEmits: "readonly",
@@ -2327,6 +2385,7 @@ async function vue(options = {}) {
 			] }],
 			"vue/component-name-in-template-casing": ["error", "PascalCase"],
 			"vue/component-options-name-casing": ["error", "PascalCase"],
+			/** this is deprecated */
 			"vue/component-tags-order": "off",
 			"vue/custom-event-name-casing": ["error", "camelCase"],
 			"vue/define-macros-order": ["error", { order: [
@@ -2508,6 +2567,7 @@ async function e18e(options = {}) {
 			...moduleReplacements ? { ...configs.moduleReplacements.rules } : {},
 			...performanceImprovements ? { ...configs.performanceImprovements.rules } : {},
 			...type === "lib" ? {} : { "e18e/prefer-static-regex": "off" },
+			/** these are a bit opinionated and dangerous (introducing behavioral changes), so we'll disable them by default for now */
 			"e18e/prefer-array-at": "off",
 			"e18e/prefer-array-from-map": "off",
 			"e18e/prefer-array-to-reversed": "off",
@@ -2703,6 +2763,7 @@ function getOverrides(options, key) {
 }
 //#endregion
 //#region src/config-presets.ts
+/** @keep-sorted */
 const CONFIG_PRESET_FULL_ON = {
 	angular: true,
 	antislop: true,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@antfu/eslint-config",
   "type": "module",
-  "version": "9.5.0",
+  "version": "9.5.1",
   "description": "Anthony's ESLint config",
   "author": "Anthony Fu <anthonyfu117@hotmail.com> (https://github.com/antfu/)",
   "license": "MIT",
@@ -159,10 +159,10 @@
     "@angular-eslint/eslint-plugin-template": "^22.2.0",
     "@angular-eslint/template-parser": "^22.2.0",
     "@angular/core": "^22.1.4",
-    "@antfu/eslint-config": "9.5.0",
+    "@antfu/eslint-config": "9.5.1",
     "@antfu/ni": "^30.5.0",
     "@eslint-react/eslint-plugin": "^5.18.6",
-    "@eslint/config-inspector": "^3.3.0",
+    "@eslint/config-inspector": "^3.4.0",
     "@next/eslint-plugin-next": "^16.3.3",
     "@prettier/plugin-xml": "^3.4.2",
     "@types/eslint-plugin-jsx-a11y": "^6.10.1",
@@ -177,7 +177,7 @@
     "eslint-plugin-format": "^2.0.1",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-react-refresh": "^0.5.5",
-    "eslint-plugin-slop": "^0.1.1",
+    "eslint-plugin-slop": "^0.1.2",
     "eslint-plugin-solid": "^0.17.0",
     "eslint-plugin-sonarjs": "^4.2.0",
     "eslint-plugin-svelte": "^3.23.0",
@@ -226,7 +226,7 @@
     "build": "nr gen && tsdown --clean --dts",
     "stub": "tsdown",
     "dev": "npx @eslint/config-inspector --config eslint.config.ts",
-    "build:inspector": "pnpm build && npx @eslint/config-inspector build --config eslint.config.ts --out-dir ./.eslint-config-inspector",
+    "build:inspector": "pnpm build && npx @eslint/config-inspector build --stats --config eslint.config.ts --out-dir ./.eslint-config-inspector",
     "watch": "tsdown --watch",
     "lint": "eslint",
     "gen": "tsx scripts/typegen.ts && tsx scripts/versiongen.ts",