@fabdeh/eslint-config 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -1,11 +1,12 @@
 import tseslint from "typescript-eslint";
 import { statSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { dirname, join, normalize, resolve } from "node:path";
 import process from "node:process";
+import { glob } 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 eslint from "@eslint/js";
 import preferArrowFunctions from "eslint-plugin-prefer-arrow-functions";
 import unusedImports from "eslint-plugin-unused-imports";
 import globals from "globals";
@@ -15,16 +16,10 @@ import nodePlugin from "eslint-plugin-n";
 import perfectionistPlugin from "eslint-plugin-perfectionist";
 import { configs } from "eslint-plugin-regexp";
 import unicornPlugin from "eslint-plugin-unicorn";
-
-//#region src/shared/globs.ts
-/**
-* A glob pattern that matches the extension of JavaScript and TypeScript source files.
-*/
-const GLOB_SRC_EXT = "?([cm])[jt]s?(x)";
 /**
 * A glob pattern that matches JavaScript and TypeScript source files (including JSX/TSX).
 */
-const GLOB_SRC = `**/*.${GLOB_SRC_EXT}`;
+const GLOB_SRC = `**/*.?([cm])[jt]s?(x)`;
 /**
 * A glob pattern that matches JavaScript source files (including JSX).
 */
@@ -38,22 +33,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";
@@ -86,29 +65,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.
 */
@@ -118,7 +82,7 @@ const GLOB_EXCLUDE = [
 	"**/package-lock.json",
 	"**/yarn.lock",
 	"**/pnpm-lock.yaml",
-	"**/bun.lockb",
+	"**/bun.lock?(b)",
 	"**/output",
 	"**/coverage",
 	"**/temp",
@@ -144,10 +108,8 @@ 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
 const SCOPE_URL = import.meta.dirname;
@@ -180,6 +142,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
@@ -244,7 +219,7 @@ async function ensurePackages(packages) {
 /**
 * 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.
 */
@@ -253,7 +228,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.
+*/
+async function getPlaywrightDirectory() {
+	const playwrightConfigs = await glob("**/playwright.config.ts", { ignore: ["**/node_modules/**"] });
+	for (const config of playwrightConfigs) try {
+		const configContent = await readFile(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
 /**
@@ -359,7 +394,6 @@ async function angular(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/comments.ts
 /**
@@ -386,198 +420,6 @@ function comments() {
 		}
 	});
 }
-
-//#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 - Optional overrides for the Prettier options.
-* @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
 /**
@@ -593,7 +435,6 @@ function ignores(userIgnores = [], fromFactory) {
 		ignores: [...!fromFactory || fromFactory === "workspace" ? GLOB_EXCLUDE : [], ...userIgnores]
 	});
 }
-
 //#endregion
 //#region src/configs/imports.ts
 /**
@@ -641,7 +482,6 @@ function imports(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/javascript.ts
 /**
@@ -664,7 +504,7 @@ function javascript(options = {}) {
 	return tseslint.config({
 		name: "fabdeh/javascript/setup",
 		languageOptions: {
-			ecmaVersion: 2022,
+			ecmaVersion: "latest",
 			globals: {
 				...globals.browser,
 				...globals.es2021,
@@ -675,7 +515,7 @@ function javascript(options = {}) {
 			},
 			parserOptions: {
 				ecmaFeatures: { jsx: true },
-				ecmaVersion: 2022,
+				ecmaVersion: "latest",
 				sourceType: "module"
 			},
 			sourceType: "module"
@@ -690,13 +530,15 @@ function javascript(options = {}) {
 			"unused-imports": unusedImports
 		},
 		rules: {
-			...eslint.configs.recommended.rules,
 			"accessor-pairs": "error",
 			"array-callback-return": "error",
 			"block-scoped-var": "error",
+			"constructor-super": "error",
 			"default-case-last": "error",
 			"dot-notation": "error",
 			eqeqeq: "error",
+			"for-direction": "error",
+			"getter-return": "error",
 			"id-denylist": [
 				"error",
 				"any",
@@ -711,48 +553,156 @@ function javascript(options = {}) {
 			],
 			"new-cap": "error",
 			"no-alert": "error",
+			"no-async-promise-executor": "error",
 			"no-caller": "error",
+			"no-case-declarations": "error",
+			"no-class-assign": "error",
 			"no-cond-assign": ["error", "always"],
+			"no-compare-neg-zero": "error",
 			"no-console": ["error", { allow: ["warn", "error"] }],
+			"no-const-assign": "error",
+			"no-constant-binary-expression": "error",
+			"no-constant-condition": "error",
+			"no-control-regex": "error",
+			"no-debugger": "error",
+			"no-delete-var": "error",
+			"no-dupe-args": "error",
+			"no-dupe-class-members": "error",
+			"no-dupe-else-if": "error",
+			"no-dupe-keys": "error",
+			"no-duplicate-case": "error",
 			"no-empty": ["error", { allowEmptyCatch: true }],
+			"no-empty-character-class": "error",
+			"no-empty-pattern": "error",
+			"no-empty-static-block": "error",
 			"no-eval": "error",
+			"no-ex-assign": "error",
 			"no-extend-native": "error",
 			"no-extra-bind": "error",
+			"no-extra-boolean-cast": "error",
+			"no-fallthrough": "error",
+			"no-func-assign": "error",
+			"no-global-assign": "error",
+			"no-import-assign": "error",
 			"no-implied-eval": "error",
+			"no-invalid-regexp": "error",
+			"no-irregular-whitespace": "error",
 			"no-iterator": "error",
 			"no-labels": "error",
 			"no-lone-blocks": "error",
 			"no-lonely-if": "error",
+			"no-loss-of-precision": "error",
+			"no-misleading-character-class": "error",
 			"no-multi-str": "error",
 			"no-new": "error",
 			"no-new-func": "error",
+			"no-new-native-nonconstructor": "error",
 			"no-new-wrappers": "error",
+			"no-nonoctal-decimal-escape": "error",
+			"no-obj-calls": "error",
+			"no-octal": "error",
 			"no-octal-escape": "error",
 			"no-plusplus": ["error", { allowForLoopAfterthoughts: true }],
+			"no-prototype-builtins": "error",
 			"no-proto": "error",
+			"no-redeclare": "error",
+			"no-regex-spaces": "error",
+			"no-restricted-globals": [
+				"error",
+				{
+					message: "Use `globalThis` instead.",
+					name: "global"
+				},
+				{
+					message: "Use `globalThis` instead.",
+					name: "self"
+				}
+			],
+			"no-restricted-properties": [
+				"error",
+				{
+					message: "Use `Object.getPrototypeOf` or `Object.setPrototypeOf` instead.",
+					property: "__proto__"
+				},
+				{
+					message: "Use `Object.defineProperty` instead.",
+					property: "__defineGetter__"
+				},
+				{
+					message: "Use `Object.defineProperty` instead.",
+					property: "__defineSetter__"
+				},
+				{
+					message: "Use `Object.getOwnPropertyDescriptor` instead.",
+					property: "__lookupGetter__"
+				},
+				{
+					message: "Use `Object.getOwnPropertyDescriptor` instead.",
+					property: "__lookupSetter__"
+				}
+			],
+			"no-restricted-syntax": [
+				"error",
+				{
+					selector: "TSEnumDeclaration",
+					message: "Use `as const` objects instead of enums."
+				},
+				{
+					selector: "TSExportAssignment",
+					message: "Avoid `export =`. Use ESM-style exports instead (for example, `export default` or named exports)."
+				},
+				{
+					selector: "ForInStatement",
+					message: "Avoid using `for...in` statements. Use `Object.keys()`, `Object.values()`, or `Object.entries()` instead."
+				},
+				{
+					selector: ":matches(PropertyDefinition, MethodDefinition)[accessibility=\"private\"]",
+					message: "Use `#private` members instead."
+				}
+			],
+			"no-self-assign": "error",
 			"no-self-compare": "error",
 			"no-sequences": "error",
+			"no-setter-return": "error",
+			"no-shadow-restricted-names": "error",
+			"no-sparse-arrays": "error",
 			"no-template-curly-in-string": "error",
+			"no-this-before-super": "error",
 			"no-throw-literal": "error",
+			"no-undef": "error",
 			"no-undef-init": "error",
+			"no-unassigned-vars": "error",
+			"no-unexpected-multiline": "error",
 			"no-unmodified-loop-condition": "error",
 			"no-unneeded-ternary": ["error", { defaultAssignment: false }],
+			"no-unreachable": "error",
 			"no-unreachable-loop": "error",
+			"no-unsafe-finally": "error",
+			"no-unsafe-negation": "error",
+			"no-unsafe-optional-chaining": "error",
 			"no-unused-expressions": ["error", {
 				allowShortCircuit: true,
 				allowTaggedTemplates: true,
 				allowTernary: true
 			}],
+			"no-unused-labels": "error",
+			"no-unused-private-class-members": "error",
+			"no-unused-vars": "off",
 			"no-use-before-define": ["error", {
 				classes: false,
 				functions: false
 			}],
+			"no-useless-assignment": "error",
+			"no-useless-backreference": "error",
 			"no-useless-call": "error",
+			"no-useless-catch": "error",
 			"no-useless-computed-key": "error",
 			"no-useless-constructor": "error",
+			"no-useless-escape": "error",
 			"no-useless-rename": "error",
 			"no-useless-return": "error",
 			"no-var": "error",
+			"no-with": "error",
 			"object-shorthand": [
 				"error",
 				"always",
@@ -774,10 +724,12 @@ function javascript(options = {}) {
 			"prefer-rest-params": "error",
 			"prefer-spread": "error",
 			"prefer-template": "error",
+			"preserve-caught-error": "error",
+			"require-yield": "error",
 			"symbol-description": "error",
 			"unicode-bom": ["error", "never"],
+			"use-isnan": ["error", { enforceForIndexOf: true }],
 			"unused-imports/no-unused-imports": "error",
-			"no-unused-vars": "off",
 			"unused-imports/no-unused-vars": ["error", {
 				args: "after-used",
 				argsIgnorePattern: "^_",
@@ -785,7 +737,6 @@ function javascript(options = {}) {
 				vars: "all",
 				varsIgnorePattern: "^_"
 			}],
-			"use-isnan": ["error", { enforceForIndexOf: true }],
 			"valid-typeof": ["error", { requireStringLiterals: true }],
 			"vars-on-top": "error",
 			yoda: [
@@ -803,7 +754,6 @@ function javascript(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/jsdoc.ts
 /**
@@ -889,7 +839,6 @@ function jsdoc(options = {}) {
 		rules: getJsDocRules("warn", !!stylistic, "tsOnly")
 	});
 }
-
 //#endregion
 //#region src/configs/jsonc.ts
 /**
@@ -974,7 +923,6 @@ async function jsonc(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/markdown.ts
 /**
@@ -1070,7 +1018,6 @@ async function markdown(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/rules-configs/naming-convention.ts
 /**
@@ -1144,7 +1091,6 @@ function namingConvention(strict, allowJsx = false) {
 		}
 	];
 }
-
 //#endregion
 //#region src/configs/ngrx.ts
 const DEFAULT_STORE_GLOB = [
@@ -1292,7 +1238,6 @@ async function ngrx(options = {}) {
 	});
 	return tseslint.config(configs);
 }
-
 //#endregion
 //#region src/configs/node.ts
 /**
@@ -1320,7 +1265,6 @@ function node() {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/rules-configs/perfectionist-groups.ts
 const SORT_IMPORT_GROUPS = [
@@ -1366,7 +1310,6 @@ const SORT_UNION_OR_INTERSECTION_GROUPS = [
 	"nullish",
 	"unknown"
 ];
-
 //#endregion
 //#region src/configs/perfectionist.ts
 /**
@@ -1426,7 +1369,64 @@ function perfectionist() {
 		}
 	});
 }
-
+//#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
 /**
@@ -1461,7 +1461,6 @@ async function pnpm() {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/regexp.ts
 /**
@@ -1484,7 +1483,6 @@ function regexp(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/sort.ts
 /**
@@ -1721,7 +1719,51 @@ function sortTsConfig() {
 		] }
 	});
 }
-
+//#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/tailwindcss.ts
 /**
@@ -1751,7 +1793,7 @@ async function tailwindcss(options = {}) {
 			languageOptions: { parser }
 		}));
 	} else {
-		files = { files: filesGlob ?? [GLOB_SRC, GLOB_HTML] };
+		files = { files: filesGlob ?? [GLOB_SRC, "**/*.htm?(l)"] };
 		parserConfigs = [];
 	}
 	return tseslint.config(...parserConfigs, {
@@ -1770,7 +1812,6 @@ async function tailwindcss(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/toml.ts
 /**
@@ -1821,7 +1862,6 @@ async function toml(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/rules-configs/member-ordering.ts
 const MEMBER_ORDERING_OPTIONS = { default: [
@@ -1858,7 +1898,6 @@ const MEMBER_ORDERING_OPTIONS = { default: [
 	"private-method",
 	"#private-method"
 ] };
-
 //#endregion
 //#region src/configs/typescript.ts
 /**
@@ -1987,7 +2026,6 @@ async function typescript(options = {}, isWorkspaceProject = false) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/unicorn.ts
 /**
@@ -2100,28 +2138,30 @@ function unicorn(options = {}) {
 		} }
 	});
 }
-
 //#endregion
 //#region src/configs/vitest.ts
 /**
 * 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),
@@ -2136,11 +2176,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,
@@ -2176,7 +2216,6 @@ async function vitest(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/configs/yaml.ts
 /**
@@ -2230,7 +2269,6 @@ async function yaml(options = {}) {
 		}
 	});
 }
-
 //#endregion
 //#region src/shared/constants.ts
 const NGRX_PACKAGES = [
@@ -2239,8 +2277,8 @@ 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
 /**
@@ -2278,10 +2316,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");
@@ -2304,7 +2338,6 @@ async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
 	}
 	return tseslint.config(...resolvedBaseConfig, ...await Promise.all(configs), ...await Promise.all(userConfigs));
 }
-
 //#endregion
 //#region src/factories/standard-config.ts
 /**
@@ -2320,7 +2353,7 @@ async function defineProjectConfig(baseConfig, options = {}, ...userConfigs) {
 * ```
 */
 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;
+	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 = false, regexp: enableRegexp = true, tailwindcss: enableTailwind = false, typescript: enableTypescript = isPackageExists("typescript"), unicorn: enableUnicorn = true, vitest: enableVitest = isPackageExists("vitest") } = options;
 	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 = [];
@@ -2363,9 +2396,21 @@ async function defineConfig(options = {}, ...userConfigs) {
 			useRelaxedNamingConventionForCamelAndPascalCases: typescriptOptions.useRelaxedNamingConventionForCamelAndPascalCases
 		}));
 	}
+	let e2eFolderPath;
+	if (enablePlaywright) {
+		const playwrightOptions = resolveSubOptions(options, "playwright");
+		e2eFolderPath = playwrightOptions.e2eFolderPath ?? await 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");
@@ -2400,10 +2445,8 @@ 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));
 }
-
 //#endregion
 //#region src/factories/workspace-config.ts
 /**
@@ -2475,11 +2518,9 @@ 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;
 }
-
 //#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 { 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, isPackageInScope, javascript, jsdoc, jsonc, markdown, ngrx, node, pathToGlobPattern, perfectionist, playwright, pnpm, regexp, resolveSubOptions, sortPackageJson, sortTsConfig, stylistic, tailwindcss, toml, typescript, unicorn, vitest, yaml };