@fabdeh/eslint-config 0.9.1 → 0.11.0

package/dist/index.mjs

@@ -1,19 +1,60 @@
-import tseslint from "typescript-eslint";
-import { statSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { readFileSync, statSync } from "node:fs";
+import { dirname, join, normalize, resolve } from "node:path";
 import process from "node:process";
+import { globSync } from "glob";
 import { isPackageExists } from "local-pkg";
 import eslintComments from "@eslint-community/eslint-plugin-eslint-comments";
 import * as importX from "eslint-plugin-import-x";
 import preferArrowFunctions from "eslint-plugin-prefer-arrow-functions";
 import unusedImports from "eslint-plugin-unused-imports";
 import globals from "globals";
+import tseslint from "typescript-eslint";
 import jsdocPlugin from "eslint-plugin-jsdoc";
 import { mergeProcessors, processorPassThrough } from "eslint-merge-processors";
 import nodePlugin from "eslint-plugin-n";
 import perfectionistPlugin from "eslint-plugin-perfectionist";
+import { readFile } from "node:fs/promises";
+import { findUp, findUpSync } from "find-up-simple";
 import { configs } from "eslint-plugin-regexp";
 import unicornPlugin from "eslint-plugin-unicorn";
+import { FlatConfigComposer } from "eslint-flat-config-utils";
+//#region src/config-presets.ts
+const CONFIG_PRESET_FULL_ON = {
+	angular: true,
+	gitignore: true,
+	jsdoc: true,
+	jsonc: true,
+	markdown: true,
+	ngrx: true,
+	playwright: true,
+	pnpm: true,
+	regexp: true,
+	stylistic: { experimental: true },
+	tailwindcss: true,
+	toml: true,
+	typescript: { enableErasableSyntaxOnly: true },
+	unicorn: true,
+	vitest: true,
+	yaml: true
+};
+const CONFIG_PRESET_FULL_OFF = {
+	angular: false,
+	gitignore: false,
+	jsdoc: false,
+	jsonc: false,
+	markdown: false,
+	ngrx: false,
+	playwright: false,
+	pnpm: false,
+	regexp: false,
+	stylistic: false,
+	tailwindcss: false,
+	toml: false,
+	typescript: false,
+	unicorn: false,
+	vitest: false,
+	yaml: false
+};
 /**
 * A glob pattern that matches JavaScript and TypeScript source files (including JSX/TSX).
 */
@@ -31,22 +72,6 @@ const GLOB_TS_EXT = "?([cm])ts?(x)";
 */
 const GLOB_TS = `**/*.${GLOB_TS_EXT}`;
 /**
-* A glob pattern that matches all CSS files.
-*/
-const GLOB_CSS = "**/*.css";
-/**
-* A glob pattern that matches all PostCSS files.
-*/
-const GLOB_POSTCSS = "**/*.{p,post}css";
-/**
-* A glob pattern that matches all LESS files.
-*/
-const GLOB_LESS = "**/*.less";
-/**
-* A glob pattern that matches all SCSS files.
-*/
-const GLOB_SCSS = "**/*.scss";
-/**
 * A glob pattern that matches all JSON files.
 */
 const GLOB_JSON = "**/*.json";
@@ -79,29 +104,14 @@ const GLOB_YAML = "**/*.y?(a)ml";
 */
 const GLOB_TOML = "**/*.toml";
 /**
-* A glob pattern that matches XML files.
-*/
-const GLOB_XML = "**/*.xml";
-/**
-* A glob pattern that matches SVG files.
-*/
-const GLOB_SVG = "**/*.svg";
-/**
-* A glob pattern that matches GraphQL files.
-*/
-const GLOB_GRAPHQL = "**/*.{g,graph}ql";
-/**
 * A glob pattern that matches HTML files.
 */
 const GLOB_HTML = "**/*.htm?(l)";
 /**
 * A glob pattern that matches test files.
 */
-const GLOB_TESTS = [
-	`**/*.spec.?([cm])[jt]s`,
-	`**/*.test.?([cm])[jt]s`,
-	`**/test-setup.?([cm])[jt]s`
-];
+const GLOB_TESTS = [`**/*.spec.?([cm])[jt]s`, `**/*.test.?([cm])[jt]s`];
+const GLOB_VITEST = [...GLOB_TESTS, `**/test-setup.?([cm])[jt]s`];
 /**
 * A glob pattern that matches files to exclude from linting.
 */
@@ -111,7 +121,7 @@ const GLOB_EXCLUDE = [
 	"**/package-lock.json",
 	"**/yarn.lock",
 	"**/pnpm-lock.yaml",
-	"**/bun.lockb",
+	"**/bun.lock?(b)",
 	"**/output",
 	"**/coverage",
 	"**/temp",
@@ -137,8 +147,7 @@ const GLOB_EXCLUDE = [
 	"**/LICENSE*",
 	"**/__snapshots__",
 	"**/auto-import?(s).d.ts",
-	"**/components.d.ts",
-	"**/prettier-types.ts"
+	"**/components.d.ts"
 ];
 //#endregion
 //#region src/shared/utils.ts
@@ -172,6 +181,19 @@ function fileExists(path) {
 	}
 }
 /**
+* Checks whether the given path points to an existing directory.
+*
+* @param path - Filesystem path to validate.
+* @returns `true` when the path exists and is a directory; otherwise `false`.
+*/
+function isDirectory(path) {
+	try {
+		return statSync(path).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/**
 * Retrieves the root directory of the workspace.
 *
 * This function determines the root directory of the workspace by checking for specific files
@@ -184,7 +206,7 @@ function fileExists(path) {
 * @returns The root directory of the workspace.
 */
 function getWorkspaceRoot(dir, candidateRoot) {
-	if (process.env.NX_WORKSPACE_ROOT) return process.env.NX_WORKSPACE_ROOT;
+	if (process.env["NX_WORKSPACE_ROOT"]) return process.env["NX_WORKSPACE_ROOT"];
 	if (dirname(dir) === dir) return candidateRoot;
 	if ([
 		join(dir, "nx.json"),
@@ -228,15 +250,41 @@ function isPackageInScope(name) {
 * @returns A promise that resolves when the operation is complete.
 */
 async function ensurePackages(packages) {
-	if (process.env.CI || !process.stdout.isTTY || !IS_CWD_IN_SCOPE) return;
+	if (process.env["CI"] || !process.stdout.isTTY || !IS_CWD_IN_SCOPE) return;
 	const nonExistingPackages = packages.filter((i) => i && !isPackageInScope(i));
 	if (nonExistingPackages.length === 0) return;
 	if (await (await import("@clack/prompts")).confirm({ message: `${nonExistingPackages.length === 1 ? "Package is" : "Packages are"} required for this config: ${nonExistingPackages.join(", ")}. Do you want to install them?` })) await import("@antfu/install-pkg").then((i) => i.installPackage(nonExistingPackages, { dev: true }));
 }
 /**
+* Detects whether the current process is running in an interactive editor environment.
+*
+* The check returns `false` in CI and Git hook\/`lint-staged` contexts to avoid
+* editor-specific behavior in non-interactive executions.
+*
+* Editor detection is based on common environment variables from VS Code,
+* JetBrains IDEs, Vim\/Neovim, and Zed.
+*
+* @returns `true` when execution appears to be inside a supported editor; otherwise `false`.
+*/
+function isInEditorEnv() {
+	if (process.env["CI"]) return false;
+	if (isInGitHooksOrLintStaged()) return false;
+	return !!(process.env["VSCODE_PID"] || process.env["VSCODE_CWD"] || process.env["JETBRAINS_IDE"] || process.env["VIM"] || process.env["NVIM"] || process.env["ZED_ENVIRONMENT"] && !process.env["ZED_TERM"]);
+}
+/**
+* Detects whether the current process is running from a Git hook or `lint\-staged`.
+*
+* It checks common environment variables set by Git tooling and npm lifecycle scripts.
+*
+* @returns `true` when execution appears to be in a Git hook or `lint\-staged` context.
+*/
+function isInGitHooksOrLintStaged() {
+	return !!(process.env["GIT_PARAMS"] || process.env["VSCODE_GIT_COMMAND"] || process.env["npm_lifecycle_script"]?.startsWith("lint-staged") || process.env["npm_lifecycle_script"]?.startsWith("nano-staged"));
+}
+/**
 * Returns the object representation of the configuration or an empty object if it is a boolean.
 *
-* @param options - The {@link CreateConfigOptions} object to extract the sub-options from.
+* @param options - The {@link DefineConfigOptions} object to extract the sub-options from.
 * @param key - The property name.
 * @returns An object representing the required options.
 */
@@ -245,6 +293,67 @@ function resolveSubOptions(options, key) {
 	if (typeof option === "boolean") return {};
 	return option ?? {};
 }
+/**
+* Replace Windows with posix style paths
+*
+* @param filePath   - Path to convert
+* @returns          Converted filepath
+*/
+function convertPathToPosix(filePath) {
+	return normalize(filePath).replaceAll("\\", "/");
+}
+/**
+* Checks if a provided path is a directory and returns a glob string matching
+* all files under that directory if so, the path itself otherwise.
+*
+* Reason for this is that `glob` needs `/**` to collect all the files under a
+* directory where as our previous implementation without `glob` simply walked
+* a directory that is passed. So this is to maintain backwards compatibility.
+*
+* Also makes sure all path separators are POSIX style for `glob` compatibility.
+*
+* @param   [options]                    - An options object
+* @param [options.extensions] - An array of accepted extensions
+* @param   [options.cwd]  - The cwd to use to resolve relative pathnames
+* @returns A function that takes a pathname and returns a glob that
+*                     matches all files with the provided extensions if
+*                     pathname is a directory.
+*/
+function pathToGlobPattern(options) {
+	const cwd = options?.cwd ?? process.cwd();
+	const extensions = options?.extensions?.map((ext) => ext.replace(/^\./, "")) ?? [];
+	const suffix = extensions.length === 0 ? "/**/*" : extensions.length === 1 ? `/**/*.${extensions[0]}` : `/**/*.{${extensions.join(",")}}`;
+	return (path) => {
+		let newPath = path;
+		if (isDirectory(resolve(cwd, path))) newPath = path.replace(/[/\\]$/, "") + suffix;
+		return convertPathToPosix(newPath);
+	};
+}
+/**
+* Finds the first valid Playwright test directory declared via `testDir` in any
+* `playwright.config.ts` file under the current workspace.
+*
+* The function:
+* - Locates Playwright config files, excluding `node_modules`.
+* - Reads each config as text.
+* - Extracts `testDir` with a regex.
+* - Resolves `testDir` relative to the config file location.
+* - Returns the first resolved path that exists as a directory.
+*
+* @returns Absolute path to the first existing Playwright test directory, or `undefined` if none is found.
+*/
+function getPlaywrightDirectory() {
+	const playwrightConfigs = globSync("**/playwright.config.ts", { ignore: ["**/node_modules/**"] });
+	for (const config of playwrightConfigs) try {
+		const configContent = readFileSync(config, "utf-8");
+		const match = /testDir:\s*["'](.+)["'],?/.exec(configContent);
+		if (match) {
+			const testDir = match[1];
+			const resolvedTestDir = resolve(dirname(config), testDir);
+			if (isDirectory(resolvedTestDir)) return resolvedTestDir;
+		}
+	} catch {}
+}
 //#endregion
 //#region src/configs/angular.ts
 /**
@@ -252,15 +361,17 @@ function resolveSubOptions(options, key) {
 *
 * @param options - Configuration options for Angular ESLint.
 * @param options.enableAccessibilityRules - Whether to enable accessibility rules for HTML templates.
-* @param options.tsOverrides - Additional TypeScript rule overrides.
-* @param options.htmlOverrides - Additional HTML rule overrides.
 * @param options.prefix - The prefix to use for Angular component and directive selectors.
 * @returns A promise that resolves to an array of ESLint configurations.
 */
 async function angular(options = {}) {
 	const angularEslint = await interopDefault(import("angular-eslint"));
-	const { enableAccessibilityRules = true, tsOverrides = {}, htmlOverrides = {}, prefix = "app", ignoreClassNamePatternForInjectableProvidedIn: ignoreClassNamePattern, componentStylesMode = "string", preferOnPushOnly = true, banExperimentalApi = true, banDeveloperPreviewApi = true, inlineTemplateAndStyles = false } = options;
-	return tseslint.config({
+	const { enableAccessibilityRules = true, overrides = {}, prefix = "app", ignoreClassNamePatternForInjectableProvidedIn: ignoreClassNamePattern, componentStylesMode = "string", preferOnPushOnly = true, banExperimentalApi = true, banDeveloperPreviewApi = true, inlineTemplateAndStyles = false } = options;
+	const tsOverrides = {};
+	const htmlOverrides = {};
+	for (const [key, value] of Object.entries(overrides)) if (key.startsWith("@angular-eslint/template/")) htmlOverrides[key] = value;
+	else if (key.startsWith("@angular-eslint/")) tsOverrides[key] = value;
+	return [{
 		name: "fabdeh/angular/rules",
 		plugins: { "@angular-eslint": angularEslint.tsPlugin },
 		processor: angularEslint.processInlineTemplates,
@@ -348,7 +459,7 @@ async function angular(options = {}) {
 			...enableAccessibilityRules ? angularEslint.configs.templateAccessibility.find((c) => c.name === "angular-eslint/template-accessibility")?.rules : {},
 			...htmlOverrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/comments.ts
@@ -362,7 +473,7 @@ async function angular(options = {}) {
 * @returns The configuration array for ESLint comments rules.
 */
 function comments() {
-	return tseslint.config({
+	return [{
 		name: "fabdeh/comments/rules",
 		files: [GLOB_SRC],
 		plugins: { "@eslint-community/eslint-comments": eslintComments },
@@ -374,196 +485,7 @@ function comments() {
 			"@eslint-community/eslint-comments/no-unused-disable": "error",
 			"@eslint-community/eslint-comments/no-unused-enable": "error"
 		}
-	});
-}
-//#endregion
-//#region src/configs/stylistic.ts
-const STYLISTIC_CONFIG_DEFAULT = {
-	semi: true,
-	arrowParens: true,
-	braceStyle: "1tbs",
-	quoteProps: "as-needed"
-};
-/**
-* Generates a stylistic ESLint configuration.
-*
-* @param [options] - Optional configuration options to customize the stylistic rules.
-* @returns A promise that resolves to an array of ESLint configurations.
-* @example
-* const config = await stylistic({ semi: false });
-*/
-async function stylistic(options = {}) {
-	const stylisticOptions = {
-		...STYLISTIC_CONFIG_DEFAULT,
-		...typeof options.stylistic === "boolean" ? {} : options.stylistic
-	};
-	const stylisticPlugin = await interopDefault(import("@stylistic/eslint-plugin"));
-	const config = stylisticPlugin.configs.customize(stylisticOptions);
-	return tseslint.config({
-		name: "fabdeh/stylistic/rules",
-		files: [GLOB_SRC],
-		plugins: { "@stylistic": stylisticPlugin },
-		rules: {
-			...config.rules,
-			"@stylistic/comma-dangle": ["error", {
-				arrays: "always-multiline",
-				objects: "always-multiline"
-			}],
-			"@stylistic/no-extra-semi": "error",
-			"@stylistic/operator-linebreak": [
-				"error",
-				"after",
-				{ overrides: {
-					"?": "before",
-					":": "before"
-				} }
-			]
-		}
-	});
-}
-//#endregion
-//#region src/configs/formatters.ts
-/**
-* Merges the provided Prettier options with any overrides.
-*
-* @param options - The base Prettier options to merge.
-* @param overrides - Required overrides for the Prettier options. Must include a `parser` property.
-* @returns The merged Prettier options.
-*/
-function mergePrettierOptions(options, overrides) {
-	return {
-		...options,
-		...overrides,
-		plugins: [...overrides.plugins ?? [], ...options.plugins ?? []]
-	};
-}
-/**
-* Configures and returns an array of formatters based on the provided options.
-*
-* @param options - The options for configuring the formatters. If set to `true`, default options will be used.
-* @param stylistic - The stylistic options for the formatters.
-* @param hasAngularTemplateParser - Optional argument which indicates whether angular rules already registered the template parser or not.
-* @returns A promise that resolves to a `TypedConfigArray` containing the configured formatters.
-*/
-async function formatters(options = {}, stylistic = {}, hasAngularTemplateParser = false) {
-	if (options === true) {
-		const isPrettierPluginXmlInScope = isPackageInScope("@prettier/plugin-xml");
-		options = {
-			css: true,
-			graphql: true,
-			html: true,
-			markdown: true,
-			slidev: isPackageExists("@slidev/cli"),
-			svg: isPrettierPluginXmlInScope,
-			xml: isPrettierPluginXmlInScope
-		};
-	}
-	await ensurePackages([
-		"eslint-plugin-format",
-		options.markdown && options.slidev ? "prettier-plugin-slidev" : void 0,
-		options.xml || options.svg ? "@prettier/plugin-xml" : void 0
-	]);
-	const { indent, quotes, semi } = {
-		...STYLISTIC_CONFIG_DEFAULT,
-		...stylistic
-	};
-	const prettierOptions = {
-		endOfLine: "auto",
-		printWidth: 120,
-		semi,
-		singleQuote: quotes === "single",
-		tabWidth: typeof indent === "number" ? indent : 2,
-		trailingComma: "all",
-		useTabs: indent === "tab",
-		...options.options
-	};
-	const prettierXmlOptions = {
-		xmlQuoteAttributes: "double",
-		xmlSelfClosingSpace: true,
-		xmlSortAttributesByKey: false,
-		xmlWhitespaceSensitivity: "ignore"
-	};
-	const formatPlugin = await interopDefault(import("eslint-plugin-format"));
-	const configs = [{
-		name: "fabdeh/formatter/setup",
-		plugins: { format: formatPlugin }
 	}];
-	if (options.css) configs.push({
-		name: "fabdeh/formatter/css",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_CSS, GLOB_POSTCSS],
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "css" })] }
-	}, {
-		name: "fabdeh/formatter/scss",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_SCSS],
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "scss" })] }
-	}, {
-		name: "fabdeh/formatter/less",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_LESS],
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "less" })] }
-	});
-	if (options.html) configs.push({
-		name: "fabdeh/formatter/html",
-		...hasAngularTemplateParser ? {} : { languageOptions: { parser: formatPlugin.parserPlain } },
-		files: [GLOB_HTML],
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "html" })] }
-	});
-	if (options.xml) configs.push({
-		name: "fabdeh/formatter/xml",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_XML],
-		rules: { "format/prettier": ["error", mergePrettierOptions({
-			...prettierXmlOptions,
-			...prettierOptions
-		}, {
-			parser: "xml",
-			plugins: ["@prettier/plugin-xml"]
-		})] }
-	});
-	if (options.svg) configs.push({
-		name: "fabdeh/formatter/svg",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_SVG],
-		rules: { "format/prettier": ["error", mergePrettierOptions({
-			...prettierXmlOptions,
-			...prettierOptions
-		}, {
-			parser: "xml",
-			plugins: ["@prettier/plugin-xml"]
-		})] }
-	});
-	if (options.markdown) {
-		const GLOB_SLIDEV = options.slidev ? options.slidev === true ? ["**/.slides.md"] : options.slidev.files : [];
-		configs.push({
-			name: "fabdeh/formatter/markdown",
-			languageOptions: { parser: formatPlugin.parserPlain },
-			files: [GLOB_MARKDOWN],
-			ignores: GLOB_SLIDEV,
-			rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
-				parser: "markdown",
-				embeddedLanguageFormatting: "off"
-			})] }
-		});
-		if (options.slidev) configs.push({
-			name: "fabdeh/formatter/slidev",
-			languageOptions: { parser: formatPlugin.parserPlain },
-			files: GLOB_SLIDEV,
-			rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, {
-				embeddedLanguageFormatting: "off",
-				parser: "slidev",
-				plugins: ["prettier-plugin-slidev"]
-			})] }
-		});
-	}
-	if (options.graphql) configs.push({
-		name: "fabdeh/formatter/graphql",
-		languageOptions: { parser: formatPlugin.parserPlain },
-		files: [GLOB_GRAPHQL],
-		rules: { "format/prettier": ["error", mergePrettierOptions(prettierOptions, { parser: "graphql" })] }
-	});
-	return tseslint.config(configs);
 }
 //#endregion
 //#region src/configs/ignore.ts
@@ -572,13 +494,13 @@ async function formatters(options = {}, stylistic = {}, hasAngularTemplateParser
 *
 * @param userIgnores - An array of user-defined glob patterns to ignore. Defaults to an empty array.
 * @param fromFactory - An optional suffix to add to the config name.
-* @returns A TypedConfigArray object containing the combined "ignore" patterns.
+* @returns A TypedConfig[] object containing the combined "ignore" patterns.
 */
 function ignores(userIgnores = [], fromFactory) {
-	return tseslint.config({
+	return [{
 		name: `fabdeh/ignores${fromFactory ? `/${fromFactory}` : ""}`,
 		ignores: [...!fromFactory || fromFactory === "workspace" ? GLOB_EXCLUDE : [], ...userIgnores]
-	});
+	}];
 }
 //#endregion
 //#region src/configs/imports.ts
@@ -587,11 +509,11 @@ function ignores(userIgnores = [], fromFactory) {
 *
 * @param options - An object containing stylistic options.
 * @param options.stylistic - A boolean indicating whether to include stylistic rules. Defaults to true.
-* @returns A TypedConfigArray object with the specified import rules.
+* @returns A TypedConfig[] object with the specified import rules.
 */
 function imports(options = {}) {
 	const { stylistic = true } = options;
-	return tseslint.config({
+	return [{
 		name: "fabdeh/imports/rules",
 		files: [GLOB_SRC],
 		plugins: { "import-x": importX },
@@ -625,7 +547,7 @@ function imports(options = {}) {
 			"import-x/named": "off",
 			"import-x/no-deprecated": "off"
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/javascript.ts
@@ -645,8 +567,8 @@ function imports(options = {}) {
 * ```
 */
 function javascript(options = {}) {
-	const { overrides = {} } = options;
-	return tseslint.config({
+	const { isInEditor = false, overrides = {} } = options;
+	return [{
 		name: "fabdeh/javascript/setup",
 		languageOptions: {
 			ecmaVersion: "latest",
@@ -861,7 +783,10 @@ function javascript(options = {}) {
 				singleReturnOnly: true,
 				allowNamedFunctions: true
 			}],
-			"prefer-const": "error",
+			"prefer-const": [isInEditor ? "warn" : "error", {
+				destructuring: "all",
+				ignoreReadBeforeAssign: true
+			}],
 			"prefer-exponentiation-operator": "error",
 			"prefer-object-spread": "error",
 			"prefer-promise-reject-errors": "error",
@@ -874,7 +799,7 @@ function javascript(options = {}) {
 			"symbol-description": "error",
 			"unicode-bom": ["error", "never"],
 			"use-isnan": ["error", { enforceForIndexOf: true }],
-			"unused-imports/no-unused-imports": "error",
+			"unused-imports/no-unused-imports": isInEditor ? "warn" : "error",
 			"unused-imports/no-unused-vars": ["error", {
 				args: "after-used",
 				argsIgnorePattern: "^_",
@@ -897,7 +822,7 @@ function javascript(options = {}) {
 			"@typescript-eslint/no-this-alias": "error",
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/jsdoc.ts
@@ -973,7 +898,7 @@ function getJsDocRules(level, stylistic, mode) {
 */
 function jsdoc(options = {}) {
 	const { stylistic = true } = options;
-	return tseslint.config({
+	return [{
 		name: "fabdeh/jsdoc/rules",
 		files: [GLOB_SRC],
 		plugins: { jsdoc: jsdocPlugin },
@@ -982,7 +907,7 @@ function jsdoc(options = {}) {
 		name: "fabdeh/jsdoc/ts-only/rules",
 		files: [GLOB_TS],
 		rules: getJsDocRules("warn", !!stylistic, "tsOnly")
-	});
+	}];
 }
 //#endregion
 //#region src/configs/jsonc.ts
@@ -993,7 +918,7 @@ function jsdoc(options = {}) {
 * @param options.files - An array of glob patterns to specify the JSONC files to lint. Defaults to `[GLOB_JSON, GLOB_JSON5, GLOB_JSONC]`.
 * @param options.overrides - Additional rules or configurations to override the default settings.
 * @param options.stylistic - A boolean or object to enable or configure stylistic rules. Defaults to `true`.
-* @returns A promise that resolves to a `TypedConfigArray` containing the ESLint configuration.
+* @returns A promise that resolves to a `TypedConfig[]` containing the ESLint configuration.
 * @example
 * ```typescript
 * const config = await jsonc({
@@ -1012,7 +937,7 @@ async function jsonc(options = {}) {
 	], overrides = {}, stylistic = true } = options;
 	const { indent = 2 } = typeof stylistic === "object" ? stylistic : {};
 	const [jsoncPlugin, jsoncParser] = await Promise.all([interopDefault(import("eslint-plugin-jsonc")), interopDefault(import("jsonc-eslint-parser"))]);
-	return tseslint.config({
+	return [{
 		name: "fabdeh/jsonc/setup",
 		plugins: { jsonc: jsoncPlugin }
 	}, {
@@ -1066,7 +991,7 @@ async function jsonc(options = {}) {
 			} : {},
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/markdown.ts
@@ -1079,7 +1004,7 @@ async function jsonc(options = {}) {
 * @param options - An object containing file and override options.
 * @param options.files - An array of glob patterns to specify the Markdown files to lint.
 * @param options.overrides - An object containing rule overrides.
-* @returns A promise that resolves to a TypedConfigArray containing the ESLint configurations.
+* @returns A promise that resolves to a TypedConfig[] containing the ESLint configurations.
 * @example
 * ```typescript
 * const config = await markdown({
@@ -1093,75 +1018,81 @@ async function jsonc(options = {}) {
 async function markdown(options = {}) {
 	const { files = [GLOB_MARKDOWN], overrides = {} } = options;
 	const markdownPlugin = await interopDefault(import("@eslint/markdown"));
-	return tseslint.config({
-		name: "fabdeh/markdown/setup",
-		plugins: { markdown: markdownPlugin }
-	}, {
-		name: "fabdeh/markdown/processor",
-		files,
-		ignores: [GLOB_MARKDOWN_IN_MARKDOWN],
-		processor: mergeProcessors([markdownPlugin.processors.markdown, processorPassThrough])
-	}, {
-		name: "fabdeh/markdown/parser",
-		files,
-		languageOptions: { parser: {
-			meta: { name: "parser-plain" },
-			parseForESLint: (code) => ({
-				ast: {
-					body: [],
-					comments: [],
-					loc: {
-						end: code.length,
-						start: 0
+	return [
+		{
+			name: "fabdeh/markdown/setup",
+			plugins: { markdown: markdownPlugin }
+		},
+		{
+			name: "fabdeh/markdown/processor",
+			files,
+			ignores: [GLOB_MARKDOWN_IN_MARKDOWN],
+			processor: mergeProcessors([markdownPlugin.processors.markdown, processorPassThrough])
+		},
+		{
+			name: "fabdeh/markdown/parser",
+			files,
+			languageOptions: { parser: {
+				meta: { name: "parser-plain" },
+				parseForESLint: (code) => ({
+					ast: {
+						body: [],
+						comments: [],
+						loc: {
+							end: code.length,
+							start: 0
+						},
+						range: [0, code.length],
+						tokens: [],
+						type: "Program"
 					},
-					range: [0, code.length],
-					tokens: [],
-					type: "Program"
-				},
-				scopeManager: null,
-				services: { isPlain: true },
-				visitorKeys: { Program: [] }
-			})
-		} }
-	}, {
-		name: "fabdeh/markdown/disables",
-		languageOptions: { parserOptions: { ecmaFeatures: { impliedStrict: true } } },
-		files: [GLOB_MARKDOWN_CODE],
-		rules: {
-			...tseslint.configs.disableTypeChecked.rules,
-			"import-x/newline-after-import": "off",
-			"no-alert": "off",
-			"no-console": "off",
-			"no-labels": "off",
-			"no-lone-blocks": "off",
-			"no-restricted-syntax": "off",
-			"no-undef": "off",
-			"no-unused-expressions": "off",
-			"no-unused-labels": "off",
-			"no-unused-vars": "off",
-			"@stylistic/comma-dangle": "off",
-			"@stylistic/eol-last": "off",
-			"@typescript-eslint/consistent-type-imports": "off",
-			"@typescript-eslint/explicit-function-return-type": "off",
-			"@typescript-eslint/no-namespace": "off",
-			"@typescript-eslint/no-redeclare": "off",
-			"@typescript-eslint/no-require-imports": "off",
-			"@typescript-eslint/no-unused-expressions": "off",
-			"@typescript-eslint/no-unused-vars": "off",
-			"@typescript-eslint/no-use-before-define": "off",
-			"unicode-bom": "off",
-			"unused-imports/no-unused-imports": "off",
-			"unused-imports/no-unused-vars": "off",
-			...overrides
-		}
-	}, {
-		name: "fabdeh/markdown/rules",
-		files,
-		rules: {
-			...markdownPlugin.configs.recommended.at(0)?.rules,
-			"markdown/no-duplicate-headings": "error"
+					scopeManager: null,
+					services: { isPlain: true },
+					visitorKeys: { Program: [] }
+				})
+			} }
+		},
+		{
+			name: "fabdeh/markdown/disables",
+			languageOptions: { parserOptions: { ecmaFeatures: { impliedStrict: true } } },
+			files: [GLOB_MARKDOWN_CODE],
+			rules: {
+				...tseslint.configs.disableTypeChecked.rules,
+				"import-x/newline-after-import": "off",
+				"no-alert": "off",
+				"no-console": "off",
+				"no-labels": "off",
+				"no-lone-blocks": "off",
+				"no-restricted-syntax": "off",
+				"no-undef": "off",
+				"no-unused-expressions": "off",
+				"no-unused-labels": "off",
+				"no-unused-vars": "off",
+				"@stylistic/comma-dangle": "off",
+				"@stylistic/eol-last": "off",
+				"@typescript-eslint/consistent-type-imports": "off",
+				"@typescript-eslint/explicit-function-return-type": "off",
+				"@typescript-eslint/no-namespace": "off",
+				"@typescript-eslint/no-redeclare": "off",
+				"@typescript-eslint/no-require-imports": "off",
+				"@typescript-eslint/no-unused-expressions": "off",
+				"@typescript-eslint/no-unused-vars": "off",
+				"@typescript-eslint/no-use-before-define": "off",
+				"unicode-bom": "off",
+				"unused-imports/no-unused-imports": "off",
+				"unused-imports/no-unused-vars": "off",
+				...overrides
+			}
+		},
+		{
+			name: "fabdeh/markdown/rules",
+			files,
+			rules: {
+				...markdownPlugin.configs.recommended.at(0)?.rules,
+				"markdown/no-duplicate-headings": "error"
+			}
 		}
-	});
+	];
 }
 //#endregion
 //#region src/configs/rules-configs/naming-convention.ts
@@ -1272,15 +1203,16 @@ async function ngrx(options = {}) {
 	const { store = isPackageExists("@ngrx/store"), effects = isPackageExists("@ngrx/effects"), signals = isPackageExists("@ngrx/signals"), useRelaxedNamingConventionForCamelAndPascalCases = false } = options;
 	const configs = [];
 	let addOperatorsRules = false;
+	const registerPluginFiles = [];
 	const ngrxOperatorsFiles = [];
 	if (store) {
 		const { files = DEFAULT_STORE_GLOB, enforceOperatorsRules = isPackageExists("@ngrx/operators"), overrides = {} } = typeof store === "object" ? store : {};
 		addOperatorsRules ||= enforceOperatorsRules;
 		ngrxOperatorsFiles.push(files);
+		registerPluginFiles.push(files);
 		configs.push({
 			name: "fabdeh/ngrx-store/rules",
 			files,
-			plugins: { "@ngrx": ngrxPlugin },
 			rules: {
 				...ngrxPlugin.configs.store.find((c) => c.name === "ngrx/store")?.rules,
 				"@typescript-eslint/naming-convention": [
@@ -1314,10 +1246,10 @@ async function ngrx(options = {}) {
 		const { files = DEFAULT_EFFECTS_GLOB, enforceOperatorsRules = isPackageExists("@ngrx/operators"), overrides = {} } = typeof effects === "object" ? effects : {};
 		addOperatorsRules ||= enforceOperatorsRules;
 		ngrxOperatorsFiles.push(files);
+		registerPluginFiles.push(files);
 		configs.push({
 			name: "fabdeh/ngrx-effects/rules",
 			files,
-			plugins: { "@ngrx": ngrxPlugin },
 			rules: {
 				...ngrxPlugin.configs.effects.find((c) => c.name === "ngrx/effects")?.rules,
 				"@typescript-eslint/naming-convention": [
@@ -1344,10 +1276,10 @@ async function ngrx(options = {}) {
 		const { files = DEFAULT_SIGNALS_GLOB, enforceOperatorsRules = isPackageExists("@ngrx/operators"), overrides = {} } = typeof signals === "object" ? signals : {};
 		addOperatorsRules ||= enforceOperatorsRules;
 		ngrxOperatorsFiles.push(files);
+		registerPluginFiles.push(files);
 		configs.push({
 			name: "fabdeh/ngrx-signals/rules",
 			files,
-			plugins: { "@ngrx": ngrxPlugin },
 			rules: {
 				...ngrxPlugin.configs.signals.find((c) => c.name === "ngrx/signals")?.rules,
 				"@typescript-eslint/naming-convention": [
@@ -1378,10 +1310,14 @@ async function ngrx(options = {}) {
 	if (addOperatorsRules) configs.push({
 		name: "fabdeh/ngrx-operators/rules",
 		files: [...ngrxOperatorsFiles],
-		plugins: { "@ngrx": ngrxPlugin },
 		rules: { ...ngrxPlugin.configs.operators.find((c) => c.name === "ngrx/operators")?.rules }
 	});
-	return tseslint.config(configs);
+	if (registerPluginFiles.length > 0) configs.unshift({
+		name: "fabdeh/ngrx/setup",
+		files: [...registerPluginFiles],
+		plugins: { "@ngrx": ngrxPlugin.configs.store.find((c) => c.name === "ngrx/base")?.plugins?.["@ngrx"] ?? {} }
+	});
+	return configs;
 }
 //#endregion
 //#region src/configs/node.ts
@@ -1391,7 +1327,7 @@ async function ngrx(options = {}) {
 * @returns An array defining Node.js rules, plugins, and their configurations.
 */
 function node() {
-	return tseslint.config({
+	return [{
 		name: "fabdeh/node/rules",
 		files: [GLOB_SRC],
 		plugins: { n: nodePlugin },
@@ -1408,7 +1344,7 @@ function node() {
 			"n/prefer-promises/fs": "error",
 			"n/process-exit-as-throw": "error"
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/rules-configs/perfectionist-groups.ts
@@ -1470,7 +1406,7 @@ const SORT_UNION_OR_INTERSECTION_GROUPS = [
 */
 function perfectionist() {
 	const rootDir = getWorkspaceRoot(process.cwd(), process.cwd());
-	return tseslint.config({
+	return [{
 		name: "fabdeh/perfectionist/rules",
 		files: [GLOB_SRC],
 		plugins: { perfectionist: perfectionistPlugin },
@@ -1512,41 +1448,204 @@ function perfectionist() {
 				type: "natural"
 			}]
 		}
-	});
+	}];
+}
+//#endregion
+//#region src/configs/playwright.ts
+/**
+* Configures and returns an ESLint flat config for Playwright test files.
+*
+* @param [options] - Options used to customize the Playwright config.
+* @param [options.e2eFolderPath] - The path to the e2e folder to prepend to each `options.files` glob pattern (defaults to `e2e`).
+* @param [options.files] - File globs to target (defaults to `GLOB_TESTS`).
+* @param [options.overrides] - Custom ESLint rule overrides merged last.
+* @returns A promise that resolves to a single-entry ESLint config array.
+* @example
+* const config = await playwright({
+*   e2eFolderPath: 'tests/e2e',
+*   files: ['**\/*.test.ts'], // will become 'tests\/e2e\/**\/*.test.ts' because of the e2eFolderPath option
+*   overrides: {
+*     'playwright/no-page-pause': 'off',
+*   },
+* });
+*/
+async function playwright(options = {}) {
+	const { e2eFolderPath = "e2e", files = GLOB_TESTS.map((glob) => convertPathToPosix(join(e2eFolderPath, glob))), overrides = {} } = options;
+	if (!isDirectory(e2eFolderPath)) return [];
+	const playwrightPlugin = await interopDefault(import("eslint-plugin-playwright"));
+	return [{
+		name: "fabdeh/playwright/rules",
+		plugins: { playwright: playwrightPlugin },
+		files,
+		rules: {
+			...playwrightPlugin.configs.recommended.rules,
+			"max-lines": "off",
+			"@typescript-eslint/consistent-type-assertions": "off",
+			"@typescript-eslint/no-empty-function": "off",
+			"@typescript-eslint/no-unsafe-assignment": "off",
+			"@typescript-eslint/no-unsafe-call": "off",
+			"@typescript-eslint/no-unsafe-member-access": "off",
+			"@typescript-eslint/unbound-method": "off",
+			"unicorn/no-null": "off",
+			"playwright/no-get-by-title": "error",
+			"playwright/no-nth-methods": "error",
+			"playwright/prefer-comparison-matcher": "error",
+			"playwright/prefer-equality-matcher": "error",
+			"playwright/prefer-lowercase-title": ["error", { allowedPrefixes: [
+				"GET",
+				"POST",
+				"PUT",
+				"DELETE",
+				"PATCH",
+				"HEAD",
+				"OPTIONS"
+			] }],
+			"playwright/prefer-native-locators": "error",
+			"playwright/prefer-to-be": "error",
+			"playwright/prefer-to-contain": "error",
+			...getJsDocRules("off", true, "both"),
+			...overrides
+		}
+	}];
 }
 //#endregion
 //#region src/configs/pnpm.ts
 /**
+* Detects whether the current PNPM workspace uses catalog definitions.
+*
+* Searches for a `pnpm-workspace.yaml` file and checks whether it contains
+* either the `catalog:` or `catalogs:` keys, which are used to define shared
+* dependency version catalogs in PNPM workspaces.
+*
+* @returns `true` when catalog configuration is present; otherwise `false`.
+*/
+async function detectCatalogUsage() {
+	const workspaceFile = await findUp("pnpm-workspace.yaml");
+	if (!workspaceFile) return false;
+	const yaml = await readFile(workspaceFile, "utf-8");
+	return yaml.includes("catalog:") || yaml.includes("catalogs:");
+}
+/**
 * Generates an array containing configuration settings for PNPM workspace-specific rules and plugins.
 *
+* @param options - The options
 * @returns An array defining PNPM workspace rules, plugins, and their configurations.
 */
-async function pnpm() {
-	const [pluginPnpm, yamlParser, jsoncParser] = await Promise.all([
+async function pnpm(options = {}) {
+	const [pluginPnpm, pluginYaml, yamlParser] = await Promise.all([
 		interopDefault(import("eslint-plugin-pnpm")),
-		interopDefault(import("yaml-eslint-parser")),
-		interopDefault(import("jsonc-eslint-parser"))
+		interopDefault(import("eslint-plugin-yml")),
+		interopDefault(import("yaml-eslint-parser"))
 	]);
-	return tseslint.config({
+	const { catalogs = await detectCatalogUsage(), isInEditor = false, json = true, sort = true, yaml = true } = options;
+	const configs = [];
+	if (json) configs.push({
 		name: "fabdeh/pnpm/package-json",
 		files: ["package.json", "**/package.json"],
-		languageOptions: { parser: jsoncParser },
+		language: "jsonc/x",
 		plugins: { pnpm: pluginPnpm },
 		rules: {
-			"pnpm/json-enforce-catalog": "error",
-			"pnpm/json-prefer-workspace-settings": "error",
-			"pnpm/json-valid-catalog": "error"
+			...catalogs ? { "pnpm/json-enforce-catalog": ["error", {
+				autofix: !isInEditor,
+				ignores: ["@types/vscode"]
+			}] } : {},
+			"pnpm/json-prefer-workspace-settings": ["error", { autofix: !isInEditor }],
+			"pnpm/json-valid-catalog": ["error", { autofix: !isInEditor }]
 		}
-	}, {
+	});
+	if (yaml) configs.push({
 		name: "fabdeh/pnpm/pnpm-workspace-yaml",
 		files: ["pnpm-workspace.yaml"],
 		languageOptions: { parser: yamlParser },
 		plugins: { pnpm: pluginPnpm },
 		rules: {
+			"pnpm/yaml-enforce-settings": ["error", { settings: {
+				shellEmulator: true,
+				trustPolicy: "no-downgrade"
+			} }],
 			"pnpm/yaml-no-duplicate-catalog-item": "error",
 			"pnpm/yaml-no-unused-catalog-item": "error"
 		}
 	});
+	if (sort) configs.push({
+		files: ["pnpm-workspace.yaml"],
+		languageOptions: { parser: yamlParser },
+		name: "antfu/pnpm/pnpm-workspace-yaml-sort",
+		plugins: { yaml: pluginYaml },
+		rules: { "yaml/sort-keys": [
+			"error",
+			{
+				order: [
+					...[
+						"cacheDir",
+						"catalogMode",
+						"cleanupUnusedCatalogs",
+						"dedupeDirectDeps",
+						"deployAllFiles",
+						"enablePrePostScripts",
+						"engineStrict",
+						"extendNodePath",
+						"hoist",
+						"hoistPattern",
+						"hoistWorkspacePackages",
+						"ignoreCompatibilityDb",
+						"ignoreDepScripts",
+						"ignoreScripts",
+						"ignoreWorkspaceRootCheck",
+						"managePackageManagerVersions",
+						"minimumReleaseAge",
+						"minimumReleaseAgeExclude",
+						"modulesDir",
+						"nodeLinker",
+						"nodeVersion",
+						"optimisticRepeatInstall",
+						"packageManagerStrict",
+						"packageManagerStrictVersion",
+						"preferSymlinkedExecutables",
+						"preferWorkspacePackages",
+						"publicHoistPattern",
+						"registrySupportsTimeField",
+						"requiredScripts",
+						"resolutionMode",
+						"savePrefix",
+						"scriptShell",
+						"shamefullyHoist",
+						"shellEmulator",
+						"stateDir",
+						"supportedArchitectures",
+						"symlink",
+						"tag",
+						"trustPolicy",
+						"trustPolicyExclude",
+						"updateNotifier"
+					],
+					"packages",
+					"overrides",
+					"patchedDependencies",
+					"catalog",
+					"catalogs",
+					...[
+						"allowedDeprecatedVersions",
+						"allowNonAppliedPatches",
+						"configDependencies",
+						"ignoredBuiltDependencies",
+						"ignoredOptionalDependencies",
+						"neverBuiltDependencies",
+						"onlyBuiltDependencies",
+						"onlyBuiltDependenciesFile",
+						"packageExtensions",
+						"peerDependencyRules"
+					]
+				],
+				pathPattern: "^$"
+			},
+			{
+				order: { type: "asc" },
+				pathPattern: ".*"
+			}
+		] }
+	});
+	return configs;
 }
 //#endregion
 //#region src/configs/regexp.ts
@@ -1560,7 +1659,7 @@ function regexp(options = {}) {
 	const { level, overrides } = options;
 	const config = configs["flat/recommended"];
 	const rules = Object.fromEntries(Object.entries(config.rules).map(([ruleName, ruleLevel]) => [ruleName, level === "warn" ? level : ruleLevel]));
-	return tseslint.config({
+	return [{
 		name: "fabdeh/regexp/rules",
 		files: [GLOB_SRC],
 		plugins: { ...config.plugins },
@@ -1568,7 +1667,7 @@ function regexp(options = {}) {
 			...rules,
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/sort.ts
@@ -1586,7 +1685,7 @@ function regexp(options = {}) {
 * @returns The ESLint configuration array with sorting rules.
 */
 function sortPackageJson() {
-	return tseslint.config({
+	return [{
 		name: "fabdeh/sort/package-json",
 		files: ["**/package.json"],
 		rules: {
@@ -1681,7 +1780,7 @@ function sortPackageJson() {
 				}
 			]
 		}
-	});
+	}];
 }
 /**
 * Generates a TypeScript ESLint configuration array that enforces sorting rules for `tsconfig.json` files.
@@ -1693,7 +1792,7 @@ function sortPackageJson() {
 * @returns The TypeScript ESLint configuration array with sorting rules.
 */
 function sortTsConfig() {
-	return tseslint.config({
+	return [{
 		name: "fabdeh/sort/tsconfig-json",
 		files: ["**/tsconfig.json", "**/tsconfig.*.json"],
 		rules: { "jsonc/sort-keys": [
@@ -1804,7 +1903,52 @@ function sortTsConfig() {
 				pathPattern: "^compilerOptions$"
 			}
 		] }
-	});
+	}];
+}
+//#endregion
+//#region src/configs/stylistic.ts
+const STYLISTIC_CONFIG_DEFAULT = {
+	semi: true,
+	arrowParens: true,
+	braceStyle: "1tbs",
+	quoteProps: "as-needed"
+};
+/**
+* Generates a stylistic ESLint configuration.
+*
+* @param [options] - Optional configuration options to customize the stylistic rules.
+* @returns A promise that resolves to an array of ESLint configurations.
+* @example
+* const config = await stylistic({ semi: false });
+*/
+async function stylistic(options = {}) {
+	const stylisticOptions = {
+		...STYLISTIC_CONFIG_DEFAULT,
+		...typeof options.stylistic === "boolean" ? {} : options.stylistic
+	};
+	const stylisticPlugin = await interopDefault(import("@stylistic/eslint-plugin"));
+	const config = stylisticPlugin.configs.customize(stylisticOptions);
+	return [{
+		name: "fabdeh/stylistic/rules",
+		files: [GLOB_SRC],
+		plugins: { "@stylistic": stylisticPlugin },
+		rules: {
+			...config.rules,
+			"@stylistic/comma-dangle": ["error", {
+				arrays: "always-multiline",
+				objects: "always-multiline"
+			}],
+			"@stylistic/no-extra-semi": "error",
+			"@stylistic/operator-linebreak": [
+				"error",
+				"after",
+				{ overrides: {
+					"?": "before",
+					":": "before"
+				} }
+			]
+		}
+	}];
 }
 //#endregion
 //#region src/configs/tailwindcss.ts
@@ -1838,8 +1982,8 @@ async function tailwindcss(options = {}) {
 		files = { files: filesGlob ?? [GLOB_SRC, "**/*.htm?(l)"] };
 		parserConfigs = [];
 	}
-	return tseslint.config(...parserConfigs, {
-		name: "@fabdeh/tailwindcss/rules",
+	return [...parserConfigs, {
+		name: "fabdeh/tailwindcss/rules",
 		...files,
 		plugins: { "better-tailwindcss": betterTailwindcssPlugin },
 		settings: { "better-tailwindcss": settings },
@@ -1852,7 +1996,7 @@ async function tailwindcss(options = {}) {
 				"better-tailwindcss/no-restricted-classes": "error"
 			} : {}
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/toml.ts
@@ -1869,10 +2013,9 @@ async function tailwindcss(options = {}) {
 async function toml(options = {}) {
 	const { files = [GLOB_TOML], overrides = {}, stylistic = true } = options;
 	const { indent = 2 } = typeof stylistic === "object" ? stylistic : {};
-	const tomlPlugin = await interopDefault(import("eslint-plugin-toml"));
-	return tseslint.config({
+	return [{
 		name: "fabdeh/toml/setup",
-		plugins: { toml: tomlPlugin }
+		plugins: { toml: await interopDefault(import("eslint-plugin-toml")) }
 	}, {
 		name: "fabdeh/toml/rules",
 		files,
@@ -1902,7 +2045,7 @@ async function toml(options = {}) {
 			} : {},
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/rules-configs/member-ordering.ts
@@ -1950,7 +2093,7 @@ const MEMBER_ORDERING_OPTIONS = { default: [
 * @param options.parserOptions - Options for the TypeScript parser.
 * @param options.overrides - Additional rule overrides.
 * @param isWorkspaceProject - A boolean indicating whether the project is a workspace project. Defaults to false.
-* @returns A TypedConfigArray containing the TypeScript ESLint configuration.
+* @returns A TypedConfig[] containing the TypeScript ESLint configuration.
 */
 async function typescript(options = {}, isWorkspaceProject = false) {
 	const { enableErasableSyntaxOnly = false, overrides = {}, parserOptions = {}, stylistic = true, type = "app", useRelaxedNamingConventionForCamelAndPascalCases = false } = options;
@@ -1964,7 +2107,7 @@ async function typescript(options = {}, isWorkspaceProject = false) {
 	}
 	const tsconfigRootDir = getWorkspaceRoot(process.cwd(), process.cwd());
 	const defaultProject = getTsConfigFileName(tsconfigRootDir);
-	return tseslint.config({
+	return [{
 		name: `fabdeh/${type}/typescript/setup`,
 		files: [GLOB_TS],
 		ignores: [`${GLOB_MARKDOWN}/**`],
@@ -2066,7 +2209,7 @@ async function typescript(options = {}, isWorkspaceProject = false) {
 			...erasableSyntaxOnlyRules,
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/unicorn.ts
@@ -2077,7 +2220,7 @@ async function typescript(options = {}, isWorkspaceProject = false) {
 * @returns The configuration array for the Unicorn plugin.
 */
 function unicorn(options = {}) {
-	return tseslint.config({
+	return [{
 		name: "fabdeh/unicorn/rules",
 		files: [GLOB_SRC],
 		plugins: { unicorn: unicornPlugin },
@@ -2178,7 +2321,7 @@ function unicorn(options = {}) {
 			"unicorn/require-post-message-target-origin": "error",
 			"unicorn/throw-new-error": "error"
 		} }
-	});
+	}];
 }
 //#endregion
 //#region src/configs/vitest.ts
@@ -2186,27 +2329,30 @@ function unicorn(options = {}) {
 * Configures and returns an ESLint configuration array for Vitest.
 *
 * @param [options] - The options to customize the configuration.
+* @param [options.files] - File globs to target (defaults to `GLOB_VITEST`).
 * @param [options.overrides] - Custom rule overrides.
 * @param [options.useJestDom] - Whether to use the `@testing-library/jest-dom` plugin.
 * @param [options.useTestingLibrary] - Whether to use the `@testing-library/angular` plugin.
+* @param [options.e2eFolderPath] - The path to the e2e folder to ignore (this is only used internally by the `defineConfig` function, not by the user).
 * @returns A promise that resolves to the ESLint configuration array.
 * @example
 * const config = await vitest({
+*   files: ['**\/*.spec.ts'],
 *   overrides: {
-*     'no-console': 'warn',
+*     'vitest/prefer-lowercase-title': 'warn',
 *   },
 *   useJestDom: true,
 *   useTestingLibrary: false,
 * });
 */
 async function vitest(options = {}) {
-	const { overrides = {}, useJestDom = isPackageExists("@testing-library/jest-dom"), useTestingLibrary = isPackageExists("@testing-library/angular") } = options;
+	const { files = GLOB_VITEST, overrides = {}, useJestDom = isPackageExists("@testing-library/jest-dom"), useTestingLibrary = isPackageExists("@testing-library/angular"), enableVitestGlobals = true, e2eFolderPath } = options;
 	const [vitestPlugin, jestDomPlugin, testingLibraryPlugin] = await Promise.all([
 		interopDefault(import("@vitest/eslint-plugin")),
 		useJestDom ? interopDefault(import("eslint-plugin-jest-dom")) : Promise.resolve(void 0),
 		useTestingLibrary ? interopDefault(import("eslint-plugin-testing-library")) : Promise.resolve(void 0)
 	]);
-	return tseslint.config({
+	return [{
 		name: "fabdeh/vitest/rules",
 		plugins: {
 			vitest: vitestPlugin,
@@ -2215,11 +2361,11 @@ async function vitest(options = {}) {
 		},
 		languageOptions: { globals: {
 			...globals.node,
-			...globals.vitest,
-			...vitestPlugin.environments.env.globals
+			...enableVitestGlobals ? vitestPlugin.environments.env.globals : {}
 		} },
 		settings: { vitest: { typecheck: true } },
-		files: [...GLOB_TESTS],
+		files,
+		...e2eFolderPath ? { ignores: [pathToGlobPattern()(e2eFolderPath)] } : {},
 		rules: {
 			...vitestPlugin.configs.recommended.rules,
 			...jestDomPlugin?.configs["flat/recommended"].rules,
@@ -2253,7 +2399,7 @@ async function vitest(options = {}) {
 			...getJsDocRules("off", true, "both"),
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/configs/yaml.ts
@@ -2266,15 +2412,14 @@ async function vitest(options = {}) {
 * @param options.stylistic - A boolean or object to specify stylistic rules. Defaults to `true`.
 * @param options.stylistic.indent - The number of spaces for indentation or 'tab'. Defaults to `2`.
 * @param options.stylistic.quotes - The type of quotes to use ('single', 'double', or 'backtick'). Defaults to `'single'`.
-* @returns A promise that resolves to a `TypedConfigArray` containing the ESLint configuration.
+* @returns A promise that resolves to a `TypedConfig[]` containing the ESLint configuration.
 */
 async function yaml(options = {}) {
 	const { files = [GLOB_YAML], overrides = {}, stylistic = true } = options;
 	const { indent = 2, quotes = "single" } = typeof stylistic === "object" ? stylistic : {};
-	const yamlPlugin = await interopDefault(import("eslint-plugin-yml"));
-	return tseslint.config({
+	return [{
 		name: "fabdeh/yaml/setup",
-		plugins: { yaml: yamlPlugin }
+		plugins: { yaml: await interopDefault(import("eslint-plugin-yml")) }
 	}, {
 		name: "fabdeh/yaml/rules",
 		language: "yaml/yaml",
@@ -2306,7 +2451,7 @@ async function yaml(options = {}) {
 			} : {},
 			...overrides
 		}
-	});
+	}];
 }
 //#endregion
 //#region src/shared/constants.ts
@@ -2316,6 +2461,7 @@ const NGRX_PACKAGES = [
 	"@ngrx/signals",
 	"@ngrx/operators"
 ];
+const PLAYWRIGHT_PACKAGES = ["@playwright/test", "playwright"];
 const OPTIONS_SYMBOL = Symbol("options");
 //#endregion
 //#region src/factories/project-config.ts
@@ -2327,18 +2473,24 @@ const OPTIONS_SYMBOL = Symbol("options");
 * @param baseConfig - The base configuration to extend from.
 * @param options - Configuration options.
 * @param userConfigs - Additional user configurations that can be awaited.
-* @returns A promise that resolves to a `TypedConfigArray`.
+* @returns The merged ESLint configurations.
 * @example
 * ```typescript
+* import { defineProjectConfig } from '@fabdeh/eslint-config';
+*
 * import baseConfig from '../../eslint.base.js';
 *
-* const config = await defineProjectConfig(baseConfig, { vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
+* export default defineProjectConfig(baseConfig, { vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
 * ```
 */
-async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
-	const resolvedBaseConfig = await baseConfig;
-	const workspaceOptions = resolvedBaseConfig[OPTIONS_SYMBOL];
+function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
+	const workspaceOptions = baseConfig[OPTIONS_SYMBOL];
 	const { angular: enableAngular = isPackageExists("@angular/core"), jsdoc: enableJsdoc = options.type === "lib", ngrx: enableNgrx = NGRX_PACKAGES.some((p) => isPackageExists(p)), tailwindcss: enableTailwind = false, typescript: typescriptOptions, vitest: enableVitest = isPackageExists("vitest") } = options;
+	let isInEditor = workspaceOptions.isInEditor;
+	if (isInEditor === void 0) {
+		isInEditor = isInEditorEnv();
+		if (isInEditor) console.log("[@fabdeh/eslint-config] Detected running in editor, some rules are disabled.");
+	}
 	if (enableNgrx && !enableAngular) throw new Error("NgRx rules can only be enabled if Angular rules are also enabled.");
 	const configs = [];
 	const stylisticOptions = workspaceOptions.stylistic === false ? false : typeof workspaceOptions.stylistic === "object" ? workspaceOptions.stylistic : {};
@@ -2354,10 +2506,6 @@ async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
 	if (enableAngular) {
 		const angularOptions = resolveSubOptions(options, "angular");
 		configs.push(angular(angularOptions));
-		if (workspaceOptions.formatters) {
-			const htmlFormatters = resolvedBaseConfig.find((c) => c.name === "fabdeh/formatter/html");
-			if (htmlFormatters) delete htmlFormatters.languageOptions;
-		}
 	}
 	if (enableNgrx) {
 		const ngrxOptions = resolveSubOptions(options, "ngrx");
@@ -2378,7 +2526,10 @@ async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
 			stylistic: stylisticOptions
 		}));
 	}
-	return tseslint.config(...resolvedBaseConfig, ...await Promise.all(configs), ...await Promise.all(userConfigs));
+	let composer = new FlatConfigComposer();
+	composer = composer.append(baseConfig, ...configs, ...userConfigs);
+	if (isInEditor) composer = composer.disableRulesFix(["prefer-const", "unused-imports/no-unused-imports"], { builtinRules: () => import("eslint/use-at-your-own-risk").then((m) => m.builtinRules) });
+	return composer;
 }
 //#endregion
 //#region src/factories/standard-config.ts
@@ -2388,26 +2539,36 @@ async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
 *
 * @param options - Configuration options.
 * @param userConfigs - Additional user configurations that can be awaited.
-* @returns A promise that resolves to a `ConfigArrayWithOptions`.
+* @returns The merged ESLint configurations.
 * @example
 * ```typescript
-* const config = await defineConfig({ vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
+* import { defineConfig } from '@fabdeh/eslint-config';
+*
+* export default defineConfig({ vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
 * ```
 */
-async function defineConfig(options = {}, ...userConfigs) {
-	const { angular: enableAngular = isPackageExists("@angular/core"), gitignore: enableGitignore = true, jsdoc: enableJsdoc = options.type === "lib", ngrx: enableNgrx = NGRX_PACKAGES.some((p) => isPackageExists(p)), pnpm: enableCatalogs = false, regexp: enableRegexp = true, tailwindcss: enableTailwind = false, typescript: enableTypescript = isPackageExists("typescript"), unicorn: enableUnicorn = true, vitest: enableVitest = isPackageExists("vitest") } = options;
+function defineConfig(options = {}, ...userConfigs) {
+	const { angular: enableAngular = isPackageExists("@angular/core"), gitignore: enableGitignore = true, jsdoc: enableJsdoc = options.type === "lib", ngrx: enableNgrx = NGRX_PACKAGES.some((p) => isPackageExists(p)), playwright: enablePlaywright = PLAYWRIGHT_PACKAGES.some((p) => isPackageExists(p)), pnpm: enableCatalogs = !!findUpSync("pnpm-workspace.yaml"), regexp: enableRegexp = true, tailwindcss: enableTailwind = false, typescript: enableTypescript = isPackageExists("typescript"), unicorn: enableUnicorn = true, vitest: enableVitest = isPackageExists("vitest") } = options;
+	let isInEditor = options.isInEditor;
+	if (isInEditor === void 0) {
+		isInEditor = isInEditorEnv();
+		if (isInEditor) console.log("[@fabdeh/eslint-config] Detected running in editor, some rules are disabled.");
+	}
 	if (enableNgrx && !enableAngular) throw new Error("NgRx rules can only be enabled if Angular rules are also enabled.");
 	const stylisticOptions = options.stylistic === false ? false : typeof options.stylistic === "object" ? options.stylistic : {};
 	const configs = [];
-	if (enableGitignore) if (typeof enableGitignore === "object") configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => tseslint.config(r({
+	if (enableGitignore) if (typeof enableGitignore === "object") configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => [r({
 		name: "fabdeh/gitignore",
 		...enableGitignore
-	}))));
-	else configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => tseslint.config(r({
+	})]));
+	else configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => [r({
 		name: "fabdeh/gitignore",
 		strict: true
-	}))));
-	configs.push(ignores(options.ignores), javascript({ overrides: options.javascript?.overrides }), comments(), node(), imports({ stylistic: stylisticOptions }), perfectionist());
+	})]));
+	configs.push(ignores(options.ignores), javascript({
+		isInEditor,
+		overrides: options.javascript?.overrides
+	}), comments(), node(), imports({ stylistic: stylisticOptions }), perfectionist());
 	if (enableJsdoc) configs.push(jsdoc({ stylistic: stylisticOptions }));
 	if (enableUnicorn) {
 		const unicornOptions = resolveSubOptions(options, "unicorn");
@@ -2438,9 +2599,21 @@ async function defineConfig(options = {}, ...userConfigs) {
 			useRelaxedNamingConventionForCamelAndPascalCases: typescriptOptions.useRelaxedNamingConventionForCamelAndPascalCases
 		}));
 	}
+	let e2eFolderPath;
+	if (enablePlaywright) {
+		const playwrightOptions = resolveSubOptions(options, "playwright");
+		e2eFolderPath = playwrightOptions.e2eFolderPath ?? getPlaywrightDirectory() ?? "e2e";
+		configs.push(playwright({
+			...playwrightOptions,
+			e2eFolderPath
+		}));
+	}
 	if (enableVitest) {
 		const vitestOptions = resolveSubOptions(options, "vitest");
-		configs.push(vitest(vitestOptions));
+		configs.push(vitest({
+			...vitestOptions,
+			e2eFolderPath
+		}));
 	}
 	if (enableTailwind) {
 		const tailwindcssOptions = resolveSubOptions(options, "tailwindcss");
@@ -2456,7 +2629,15 @@ async function defineConfig(options = {}, ...userConfigs) {
 			stylistic: stylisticOptions
 		}), sortPackageJson(), sortTsConfig());
 	}
-	if (enableCatalogs) configs.push(pnpm());
+	if (enableCatalogs) {
+		const pnpmOptions = resolveSubOptions(options, "pnpm");
+		configs.push(pnpm({
+			isInEditor,
+			json: options.jsonc !== false,
+			yaml: options.yaml !== false,
+			...pnpmOptions
+		}));
+	}
 	if (options.yaml ?? true) {
 		const yamlOptions = resolveSubOptions(options, "yaml");
 		configs.push(yaml({
@@ -2475,8 +2656,10 @@ async function defineConfig(options = {}, ...userConfigs) {
 		const markdownOptions = resolveSubOptions(options, "markdown");
 		configs.push(markdown(markdownOptions));
 	}
-	if (options.formatters) configs.push(formatters(options.formatters, typeof stylisticOptions === "boolean" ? {} : stylisticOptions, Boolean(enableAngular)));
-	return tseslint.config(...await Promise.all(configs), ...await Promise.all(userConfigs));
+	let composer = new FlatConfigComposer();
+	composer = composer.append(...configs, ...userConfigs);
+	if (isInEditor) composer = composer.disableRulesFix(["prefer-const", "unused-imports/no-unused-imports"], { builtinRules: () => import("eslint/use-at-your-own-risk").then((m) => m.builtinRules) });
+	return composer;
 }
 //#endregion
 //#region src/factories/workspace-config.ts
@@ -2487,25 +2670,35 @@ async function defineConfig(options = {}, ...userConfigs) {
 *
 * @param options - Configuration options.
 * @param userConfigs - Additional user configurations that can be awaited.
-* @returns A promise that resolves to a `ConfigArrayWithOptions`.
+* @returns The merged ESLint configurations.
 * @example
 * ```typescript
-* const config = await defineWorkspaceConfig({ vitest: true, typescript: { parserOptions: { project: './tsconfig.json' } } });
+* import { defineWorkspaceConfig } from '@fabdeh/eslint-config';
+*
+* export default defineWorkspaceConfig({ typescript: { parserOptions: { project: './tsconfig.json' } } });
 * ```
 */
-async function defineWorkspaceConfig(options = {}, ...userConfigs) {
-	const { gitignore: enableGitignore = true, pnpm: enableCatalogs = false, regexp: enableRegexp = true, typescript: enableTypescript = isPackageExists("typescript"), unicorn: enableUnicorn = true } = options;
+function defineWorkspaceConfig(options = {}, ...userConfigs) {
+	const { gitignore: enableGitignore = true, pnpm: enableCatalogs = !!findUpSync("pnpm-workspace.yaml"), regexp: enableRegexp = true, typescript: enableTypescript = isPackageExists("typescript"), unicorn: enableUnicorn = true } = options;
+	let isInEditor = options.isInEditor;
+	if (isInEditor === void 0) {
+		isInEditor = isInEditorEnv();
+		if (isInEditor) console.log("[@fabdeh/eslint-config] Detected running in editor, some rules are disabled.");
+	}
 	const stylisticOptions = options.stylistic === false ? false : typeof options.stylistic === "object" ? options.stylistic : {};
 	const configs = [];
-	if (enableGitignore) if (typeof enableGitignore === "object") configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => tseslint.config(r({
+	if (enableGitignore) if (typeof enableGitignore === "object") configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => [r({
 		name: "fabdeh/gitignore",
 		...enableGitignore
-	}))));
-	else configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => tseslint.config(r({
+	})]));
+	else configs.push(interopDefault(import("eslint-config-flat-gitignore")).then((r) => [r({
 		name: "fabdeh/gitignore",
 		strict: true
-	}))));
-	configs.push(ignores(options.ignores, "workspace"), javascript({ overrides: options.javascript?.overrides }), comments(), node(), imports({ stylistic: stylisticOptions }), perfectionist());
+	})]));
+	configs.push(ignores(options.ignores, "workspace"), javascript({
+		isInEditor,
+		overrides: options.javascript?.overrides
+	}), comments(), node(), imports({ stylistic: stylisticOptions }), perfectionist());
 	if (enableUnicorn) {
 		const unicornOptions = resolveSubOptions(options, "unicorn");
 		configs.push(unicorn(unicornOptions));
@@ -2530,7 +2723,15 @@ async function defineWorkspaceConfig(options = {}, ...userConfigs) {
 			stylistic: stylisticOptions
 		}), sortPackageJson(), sortTsConfig());
 	}
-	if (enableCatalogs) configs.push(pnpm());
+	if (enableCatalogs) {
+		const pnpmOptions = resolveSubOptions(options, "pnpm");
+		configs.push(pnpm({
+			isInEditor,
+			json: options.jsonc !== false,
+			yaml: options.yaml !== false,
+			...pnpmOptions
+		}));
+	}
 	if (options.yaml ?? true) {
 		const yamlOptions = resolveSubOptions(options, "yaml");
 		configs.push(yaml({
@@ -2549,10 +2750,12 @@ async function defineWorkspaceConfig(options = {}, ...userConfigs) {
 		const markdownOptions = resolveSubOptions(options, "markdown");
 		configs.push(markdown(markdownOptions));
 	}
-	if (options.formatters) configs.push(formatters(options.formatters, typeof stylisticOptions === "boolean" ? {} : stylisticOptions, false));
-	const eslintConfigWithOptions = tseslint.config(...await Promise.all(configs), ...await Promise.all(userConfigs));
-	eslintConfigWithOptions[OPTIONS_SYMBOL] = options;
-	return eslintConfigWithOptions;
+	let composer = new FlatConfigComposer();
+	composer = composer.append(...configs, ...userConfigs);
+	if (isInEditor) composer = composer.disableRulesFix(["prefer-const", "unused-imports/no-unused-imports"], { builtinRules: () => import("eslint/use-at-your-own-risk").then((m) => m.builtinRules) });
+	const composerWithOptions = composer;
+	composerWithOptions[OPTIONS_SYMBOL] = options;
+	return composerWithOptions;
 }
 //#endregion
-export { GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, STYLISTIC_CONFIG_DEFAULT, angular, comments, defineConfig, defineProjectConfig, defineWorkspaceConfig, ensurePackages, formatters, getTsConfigFileName, getWorkspaceRoot, ignores, imports, interopDefault, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, node, perfectionist, pnpm, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };
+export { CONFIG_PRESET_FULL_OFF, CONFIG_PRESET_FULL_ON, GLOB_HTML, GLOB_JS, GLOB_SRC, GLOB_TESTS, GLOB_TS, STYLISTIC_CONFIG_DEFAULT, angular, comments, convertPathToPosix, defineConfig, defineProjectConfig, defineWorkspaceConfig, ensurePackages, getPlaywrightDirectory, getTsConfigFileName, getWorkspaceRoot, ignores, imports, interopDefault, isDirectory, isInEditorEnv, isInGitHooksOrLintStaged, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, node, pathToGlobPattern, perfectionist, playwright, pnpm, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };