@favorodera/eslint-config 0.0.4 → 0.0.5

package/dist/index.cjs

@@ -23,11 +23,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 //#endregion
 let eslint_flat_config_utils = require("eslint-flat-config-utils");
 let defu = require("defu");
+let globals = require("globals");
+globals = __toESM(globals, 1);
 let eslint_merge_processors = require("eslint-merge-processors");
 let eslint_processor_vue_blocks = require("eslint-processor-vue-blocks");
 eslint_processor_vue_blocks = __toESM(eslint_processor_vue_blocks, 1);
-let globals = require("globals");
-globals = __toESM(globals, 1);
 //#region src/globs.ts
 /** Glob pattern for matching JavaScript files */
 const jsGlob = "**/*.{js,cjs,mjs}";
@@ -51,11 +51,9 @@ const jsoncGlob = "**/*.jsonc";
 const tsConfigGlob = ["**/tsconfig.json", "**/tsconfig.*.json"];
 /** Glob pattern for matching package.json files */
 const packageJsonGlob = "**/package.json";
-/**
-* Common glob patterns for files and directories that should be ignored by ESLint.
-* Includes node_modules, build outputs, lock files, temporary files, and tool-specific caches.
-*/
-const ignoresGlob = [
+//#endregion
+//#region src/configs/ignores.ts
+const defaultPatterns = [
 	"**/node_modules/**",
 	"**/dist/**",
 	"**/package-lock.json",
@@ -92,9 +90,28 @@ const ignoresGlob = [
 	"**/.agents",
 	"**/.*/skills"
 ];
+/**
+* Globs for ignoring files and directories from ESLint scanning.
+* @param patterns Additional ignore patterns or a function to modify the defaults.
+* @returns An array containing the ignore flat config item.
+*/
+function ignores(patterns = []) {
+	return [{
+		ignores: typeof patterns === "function" ? patterns(defaultPatterns) : [...defaultPatterns, ...patterns],
+		name: "favorodera/ignores"
+	}];
+}
 //#endregion
 //#region src/utils.ts
 /**
+* Extracts and merges the rules from multiple ESLint configuration arrays.
+* @param configArrays Rest parameter representing multiple arrays of ESLint flat config items.
+* @returns A single object containing all the merged rules from the provided configurations.
+*/
+function extractRules(...configArrays) {
+	return Object.assign({}, ...configArrays.flat().map((config) => config?.rules || {}));
+}
+/**
 * Resolves a module (or a promise of one) and returns its default export
 * if present, otherwise returns the module itself.
 *
@@ -121,108 +138,6 @@ function resolveOptions(value, defaults) {
 	if (!value) return false;
 	return (0, defu.defu)(value === true ? {} : value, defaults);
 }
-/**
-* Extracts and merges the rules from multiple ESLint configuration arrays.
-* @param configArrays Rest parameter representing multiple arrays of ESLint flat config items.
-* @returns A single object containing all the merged rules from the provided configurations.
-*/
-function extractRules(...configArrays) {
-	return Object.assign({}, ...configArrays.flat().map((config) => config?.rules || {}));
-}
-//#endregion
-//#region src/configs/vue.ts
-const sfcBlocksDefaults = { blocks: {
-	styles: true,
-	customBlocks: true,
-	template: false
-} };
-const vueDefaults = {
-	files: [vueGlob],
-	sfcBlocks: sfcBlocksDefaults
-};
-/**
-* Constructs the flat config items for Vue linting, setting up the custom template parser,
-* Vue block processors, and rules to enforce recommended component syntax.
-* @param options Vue configuration options.
-* @returns Promise resolving to Vue ESLint config items.
-*/
-async function vue(options) {
-	const resolved = (0, defu.defu)(options, vueDefaults);
-	const sfcBlocks = resolveOptions(resolved.sfcBlocks, sfcBlocksDefaults);
-	const [vuePlugin, vueParser, tsEsLint] = await Promise.all([
-		importModule(import("eslint-plugin-vue")),
-		importModule(import("vue-eslint-parser")),
-		importModule(import("typescript-eslint"))
-	]);
-	const baseRules = extractRules(vuePlugin.configs["flat/essential"], vuePlugin.configs["flat/strongly-recommended"], vuePlugin.configs["flat/recommended"]);
-	const processor = sfcBlocks === false ? vuePlugin.processors[".vue"] : (0, eslint_merge_processors.mergeProcessors)([vuePlugin.processors[".vue"], (0, eslint_processor_vue_blocks.default)(sfcBlocks)]);
-	return [{
-		name: "favorodera/vue/setup",
-		plugins: { vue: vuePlugin },
-		languageOptions: { globals: {
-			computed: "readonly",
-			defineEmits: "readonly",
-			defineExpose: "readonly",
-			defineProps: "readonly",
-			onMounted: "readonly",
-			onUnmounted: "readonly",
-			reactive: "readonly",
-			ref: "readonly",
-			shallowReactive: "readonly",
-			shallowRef: "readonly",
-			toRef: "readonly",
-			toRefs: "readonly",
-			watch: "readonly",
-			watchEffect: "readonly"
-		} }
-	}, {
-		name: "favorodera/vue/rules",
-		files: resolved.files,
-		languageOptions: {
-			parser: vueParser,
-			parserOptions: {
-				parser: tsEsLint.parser,
-				extraFileExtensions: [".vue"],
-				sourceType: "module"
-			}
-		},
-		processor,
-		rules: {
-			...baseRules,
-			"vue/block-order": ["error", { order: [
-				"script",
-				"template",
-				"style"
-			] }],
-			"vue/component-name-in-template-casing": ["error", "PascalCase"],
-			"vue/component-options-name-casing": ["error", "PascalCase"],
-			"vue/multi-word-component-names": "off",
-			"vue/block-tag-newline": ["error", {
-				multiline: "ignore",
-				singleline: "ignore"
-			}],
-			"vue/multiline-html-element-content-newline": ["error", {
-				allowEmptyLines: true,
-				ignores: ["pre", "textarea"]
-			}],
-			...resolved.overrides
-		}
-	}];
-}
-//#endregion
-//#region src/configs/ignores.ts
-const defaultPatterns = ignoresGlob;
-/**
-* Globs for ignoring files and directories from ESLint scanning.
-* @param patterns Additional ignore patterns or a function to modify the defaults.
-* @returns An array containing the ignore flat config item.
-*/
-function ignores(patterns = []) {
-	return [{
-		name: "favorodera/ignores",
-		ignores: typeof patterns === "function" ? patterns(defaultPatterns) : [...defaultPatterns, ...patterns]
-	}];
-}
 //#endregion
 //#region src/configs/imports.ts
 const importsDefaults = { files: [
@@ -247,16 +162,16 @@ async function imports(options) {
 			"unused-imports": unusedImportsPlugin
 		}
 	}, {
-		name: "favorodera/imports/rules",
 		files: resolved.files,
+		name: "favorodera/imports/rules",
 		rules: {
 			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { "import-lite": "import" }),
-			"import/consistent-type-specifier-style": ["error", "top-level"],
+			"import/consistent-type-specifier-style": ["error", "prefer-top-level"],
 			"import/first": "error",
+			"import/newline-after-import": ["error", { count: 1 }],
 			"import/no-duplicates": "error",
 			"import/no-mutable-exports": "error",
 			"import/no-named-default": "error",
-			"import/newline-after-import": ["error", { count: 1 }],
 			"unused-imports/no-unused-imports": "error",
 			"unused-imports/no-unused-vars": ["error", {
 				args: "after-used",
@@ -286,10 +201,8 @@ async function javascript(options) {
 	const resolved = (0, defu.defu)(options, javascriptDefaults);
 	const baseRules = (await importModule(import("@eslint/js"))).configs.recommended.rules;
 	return [{
-		name: "favorodera/javascript/setup",
 		languageOptions: {
 			ecmaVersion: "latest",
-			sourceType: "module",
 			globals: {
 				...globals.default.browser,
 				...globals.default.es2021,
@@ -297,12 +210,14 @@ async function javascript(options) {
 				document: "readonly",
 				navigator: "readonly",
 				window: "readonly"
-			}
+			},
+			sourceType: "module"
 		},
-		linterOptions: { reportUnusedDisableDirectives: true }
+		linterOptions: { reportUnusedDisableDirectives: true },
+		name: "favorodera/javascript/setup"
 	}, {
-		name: "favorodera/javascript/rules",
 		files: resolved.files,
+		name: "favorodera/javascript/rules",
 		rules: {
 			...baseRules,
 			"accessor-pairs": ["error", {
@@ -316,232 +231,87 @@ async function javascript(options) {
 	}];
 }
 //#endregion
-//#region src/configs/markdown.ts
-const markdownDefaults = {
-	files: [mdGlob],
-	gfm: true
-};
+//#region src/configs/jsdoc.ts
+const jsdocDefaults = { files: [
+	jsGlob,
+	tsGlob,
+	vueGlob
+] };
 /**
-* Constructs the flat config items for Markdown linting, extracting and linting
-* embedded code blocks within the document according to specified rules.
-* @param options Markdown configuration options.
-* @returns Promise resolving to Markdown ESLint config items.
+* Constructs the flat config items for JSDoc linting, ensuring comments follow
+* proper styling, parameter checks, and types alignment.
+* @param options JSDoc configuration options.
+* @returns Promise resolving to JSDoc ESLint config items.
 */
-async function markdown(options) {
-	const resolved = (0, defu.defu)(options, markdownDefaults);
-	const markdownPlugin = await importModule(import("@eslint/markdown"));
-	const baseRules = extractRules(markdownPlugin.configs.recommended);
+async function jsdoc(options) {
+	const resolved = (0, defu.defu)(options, jsdocDefaults);
+	const jsdocPlugin = await importModule(import("eslint-plugin-jsdoc"));
+	const baseRules = {
+		...jsdocPlugin.configs["flat/recommended-typescript-error"]?.rules,
+		...jsdocPlugin.configs["flat/stylistic-typescript-error"]?.rules
+	};
+	return [{
+		name: "favorodera/jsdoc/setup",
+		plugins: { jsdoc: jsdocPlugin }
+	}, {
+		files: resolved.files,
+		name: "favorodera/tailwind/rules",
+		rules: {
+			...baseRules,
+			"jsdoc/check-access": "warn",
+			"jsdoc/check-alignment": "warn",
+			"jsdoc/check-param-names": "warn",
+			"jsdoc/check-property-names": "warn",
+			"jsdoc/check-types": "warn",
+			"jsdoc/empty-tags": "warn",
+			"jsdoc/implements-on-classes": "warn",
+			"jsdoc/multiline-blocks": "warn",
+			"jsdoc/no-defaults": "warn",
+			"jsdoc/no-multi-asterisks": "warn",
+			"jsdoc/require-param-name": "warn",
+			"jsdoc/require-property": "warn",
+			"jsdoc/require-property-description": "warn",
+			"jsdoc/require-property-name": "warn",
+			"jsdoc/require-returns-check": "warn",
+			"jsdoc/require-returns-description": "warn",
+			"jsdoc/require-yields-check": "warn",
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/jsonc.ts
+const jsoncDefaults = { files: [
+	json5Glob,
+	jsoncGlob,
+	jsonGlob
+] };
+/**
+* Constructs the flat config items for JSON, JSON5, and JSONC linting, setting up
+* the custom parser, rule validations, and sorting rules for package.json/tsconfig.json.
+* @param options JSONC configuration options.
+* @returns Promise resolving to JSONC ESLint config items.
+*/
+async function jsonc(options) {
+	const resolved = (0, defu.defu)(options, jsoncDefaults);
 	return [
 		{
-			name: "favorodera/markdown/setup",
-			plugins: { md: markdownPlugin }
+			name: "favorodera/jsonc/setup",
+			plugins: { jsonc: await importModule(import("eslint-plugin-jsonc")) }
 		},
 		{
-			name: "favorodera/markdown/rules",
 			files: resolved.files,
-			language: resolved.gfm ? "md/gfm" : "md/commonmark",
-			ignores: [mdInMdGlob],
-			processor: (0, eslint_merge_processors.mergeProcessors)([markdownPlugin.processors?.markdown, eslint_merge_processors.processorPassThrough]),
-			rules: {
-				...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { markdown: "md" }),
-				"md/fenced-code-language": "off",
-				"md/no-missing-label-refs": "off",
-				...resolved.overrides
-			}
-		},
-		{
-			name: "favorodera/markdown/disables/code",
-			files: [codeInMdGlob],
-			languageOptions: { parserOptions: { ecmaFeatures: { impliedStrict: true } } },
-			rules: {
-				"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",
-				"node/prefer-global/process": "off",
-				"style/comma-dangle": "off",
-				"style/eol-last": "off",
-				"style/padding-line-between-statements": "off",
-				"ts/consistent-type-imports": "off",
-				"ts/explicit-function-return-type": "off",
-				"ts/no-namespace": "off",
-				"ts/no-redeclare": "off",
-				"ts/no-require-imports": "off",
-				"ts/no-unused-expressions": "off",
-				"ts/no-unused-vars": "off",
-				"ts/no-use-before-define": "off",
-				"unicode-bom": "off",
-				"unused-imports/no-unused-imports": "off",
-				"unused-imports/no-unused-vars": "off"
-			}
-		}
-	];
-}
-//#endregion
-//#region src/configs/stylistic.ts
-const stylisticDefaults = {
-	settings: {
-		indent: 2,
-		experimental: false,
-		quotes: "single",
-		semi: false,
-		jsx: false
-	},
-	files: [
-		jsGlob,
-		tsGlob,
-		vueGlob
-	]
-};
-/**
-* Constructs the flat config items for Stylistic linting, applying customized
-* formatting settings such as quotes, indentation, and spacing.
-* @param options Stylistic configuration options.
-* @returns Promise resolving to stylistic ESLint config items.
-*/
-async function stylistic(options) {
-	const resolved = (0, defu.defu)(options, stylisticDefaults);
-	const stylePlugin = await importModule(import("@stylistic/eslint-plugin"));
-	const baseRules = stylePlugin.configs.customize({
-		pluginName: "style",
-		...resolved.settings
-	})?.rules || {};
-	return [{
-		name: "favorodera/stylistic/setup",
-		plugins: { style: stylePlugin }
-	}, {
-		name: "favorodera/stylistic/rules",
-		files: resolved.files,
-		rules: {
-			...baseRules,
-			"style/quotes": [
-				"error",
-				"single",
-				{ avoidEscape: true }
-			],
-			"style/no-multiple-empty-lines": ["error", {
-				max: 2,
-				maxEOF: 2,
-				maxBOF: 0
-			}],
-			"style/padded-blocks": "off",
-			"style/no-trailing-spaces": ["error", { skipBlankLines: true }],
-			"style/brace-style": "off",
-			"style/generator-star-spacing": ["error", {
-				after: true,
-				before: false
-			}],
-			"style/yield-star-spacing": ["error", {
-				after: true,
-				before: false
-			}],
-			...resolved.overrides
-		}
-	}];
-}
-//#endregion
-//#region src/configs/tailwind.ts
-const tailwindDefaults = {
-	files: [
-		jsGlob,
-		tsGlob,
-		vueGlob
-	],
-	settings: { detectComponentClasses: true }
-};
-/**
-* Constructs the flat config items for Tailwind CSS linting, providing custom settings
-* to parse and lint utility classes, and enforcing consistent ordering.
-* @param options Tailwind configuration options.
-* @returns Promise resolving to Tailwind ESLint config items.
-*/
-async function tailwind(options) {
-	const resolved = (0, defu.defu)(options, tailwindDefaults);
-	const tailwindPlugin = await importModule(import("eslint-plugin-better-tailwindcss"));
-	const baseRules = {
-		...tailwindPlugin.configs["recommended-error"].rules,
-		...tailwindPlugin.configs["stylistic-error"].rules
-	};
-	return [{
-		name: "favorodera/tailwind/setup",
-		plugins: { tailwind: tailwindPlugin },
-		settings: { tailwindcss: resolved.settings }
-	}, {
-		name: "favorodera/tailwind/rules",
-		files: resolved.files,
-		rules: {
-			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { "better-tailwindcss": "tailwind" }),
-			"tailwind/no-unregistered-classes": "off",
-			"tailwind/enforce-consistent-line-wrapping": ["error", { group: "emptyLine" }],
-			...resolved.overrides
-		}
-	}];
-}
-//#endregion
-//#region src/configs/typescript.ts
-const typescriptDefaults = { files: [tsGlob] };
-/**
-* Constructs the flat config items for TypeScript linting, initializing the parser
-* and extending the recommended and strict type-aware rule sets.
-* @param options TypeScript configuration options.
-* @returns Promise resolving to TypeScript ESLint config items.
-*/
-async function typescript(options) {
-	const resolved = (0, defu.defu)(options, typescriptDefaults);
-	const tsEsLint = await importModule(import("typescript-eslint"));
-	const baseRules = extractRules(tsEsLint.configs.recommended, tsEsLint.configs.strict);
-	return [{
-		name: "favorodera/typescript/setup",
-		plugins: { ts: tsEsLint.plugin }
-	}, {
-		name: "favorodera/typescript/rules",
-		files: resolved.files,
-		languageOptions: {
-			parser: tsEsLint.parser,
-			parserOptions: { sourceType: "module" }
-		},
-		rules: {
-			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { "@typescript-eslint": "ts" }),
-			"ts/consistent-type-imports": ["error", { prefer: "type-imports" }],
-			"ts/no-empty-object-type": ["error", { allowInterfaces: "with-single-extends" }],
-			"ts/array-type": ["error", {
-				default: "generic",
-				readonly: "generic"
-			}],
-			...resolved.overrides
-		}
-	}];
-}
-//#endregion
-//#region src/configs/jsonc.ts
-const jsoncDefaults = { files: [
-	json5Glob,
-	jsoncGlob,
-	jsonGlob
-] };
-/**
-* Constructs the flat config items for JSON, JSON5, and JSONC linting, setting up
-* the custom parser, rule validations, and sorting rules for package.json/tsconfig.json.
-* @param options JSONC configuration options.
-* @returns Promise resolving to JSONC ESLint config items.
-*/
-async function jsonc(options) {
-	const resolved = (0, defu.defu)(options, jsoncDefaults);
-	return [
-		{
-			name: "favorodera/jsonc/setup",
-			plugins: { jsonc: await importModule(import("eslint-plugin-jsonc")) }
-		},
-		{
-			name: "favorodera/jsonc/rules",
-			files: resolved.files,
-			language: "jsonc/x",
+			language: "jsonc/x",
+			name: "favorodera/jsonc/rules",
 			rules: {
+				"jsonc/array-bracket-spacing": ["error", "never"],
+				"jsonc/comma-dangle": ["error", "never"],
+				"jsonc/comma-style": ["error", "last"],
+				"jsonc/indent": ["error", 2],
+				"jsonc/key-spacing": ["error", {
+					afterColon: true,
+					beforeColon: false
+				}],
 				"jsonc/no-bigint-literals": "error",
 				"jsonc/no-binary-expression": "error",
 				"jsonc/no-binary-numeric-literals": "error",
@@ -565,17 +335,6 @@ async function jsonc(options) {
 				"jsonc/no-undefined-value": "error",
 				"jsonc/no-unicode-codepoint-escapes": "error",
 				"jsonc/no-useless-escape": "error",
-				"jsonc/space-unary-ops": "error",
-				"jsonc/valid-json-number": "error",
-				"jsonc/vue-custom-block/no-parsing-error": "error",
-				"jsonc/array-bracket-spacing": ["error", "never"],
-				"jsonc/comma-dangle": ["error", "never"],
-				"jsonc/comma-style": ["error", "last"],
-				"jsonc/indent": ["error", 2],
-				"jsonc/key-spacing": ["error", {
-					afterColon: true,
-					beforeColon: false
-				}],
 				"jsonc/object-curly-newline": ["error", {
 					consistent: true,
 					multiline: true
@@ -584,12 +343,15 @@ async function jsonc(options) {
 				"jsonc/object-property-newline": ["error", { allowAllPropertiesOnSameLine: true }],
 				"jsonc/quote-props": "error",
 				"jsonc/quotes": "error",
+				"jsonc/space-unary-ops": "error",
+				"jsonc/valid-json-number": "error",
+				"jsonc/vue-custom-block/no-parsing-error": "error",
 				...resolved.overrides
 			}
 		},
 		{
-			name: "favorodera/jsonc/sort/package-json",
 			files: [packageJsonGlob],
+			name: "favorodera/jsonc/sort/package-json",
 			rules: {
 				"jsonc/sort-array-values": ["error", {
 					order: { type: "asc" },
@@ -657,11 +419,11 @@ async function jsonc(options) {
 					},
 					{
 						order: { type: "asc" },
-						pathPattern: "^workspaces\\.catalog$"
+						pathPattern: String.raw`^workspaces\.catalog$`
 					},
 					{
 						order: { type: "asc" },
-						pathPattern: "^workspaces\\.catalogs\\.[^.]+$"
+						pathPattern: String.raw`^workspaces\.catalogs\.[^.]+$`
 					},
 					{
 						order: [
@@ -691,8 +453,8 @@ async function jsonc(options) {
 			}
 		},
 		{
-			name: "favorodera/jsonc/sort/tsconfig-json",
 			files: tsConfigGlob,
+			name: "favorodera/jsonc/sort/tsconfig-json",
 			rules: { "jsonc/sort-keys": [
 				"error",
 				{
@@ -807,50 +569,434 @@ async function jsonc(options) {
 	];
 }
 //#endregion
-//#region src/configs/jsdoc.ts
-const jsdocDefaults = { files: [
+//#region src/configs/markdown.ts
+const markdownDefaults = {
+	files: [mdGlob],
+	gfm: true
+};
+/**
+* Constructs the flat config items for Markdown linting, extracting and linting
+* embedded code blocks within the document according to specified rules.
+* @param options Markdown configuration options.
+* @returns Promise resolving to Markdown ESLint config items.
+*/
+async function markdown(options) {
+	const resolved = (0, defu.defu)(options, markdownDefaults);
+	const markdownPlugin = await importModule(import("@eslint/markdown"));
+	const baseRules = extractRules(markdownPlugin.configs.recommended);
+	return [
+		{
+			name: "favorodera/markdown/setup",
+			plugins: { md: markdownPlugin }
+		},
+		{
+			files: resolved.files,
+			ignores: [mdInMdGlob],
+			language: resolved.gfm ? "md/gfm" : "md/commonmark",
+			name: "favorodera/markdown/rules",
+			processor: (0, eslint_merge_processors.mergeProcessors)([markdownPlugin.processors?.markdown, eslint_merge_processors.processorPassThrough]),
+			rules: {
+				...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { markdown: "md" }),
+				"md/fenced-code-language": "off",
+				"md/no-missing-label-refs": "off",
+				...resolved.overrides
+			}
+		},
+		{
+			files: [codeInMdGlob],
+			languageOptions: { parserOptions: { ecmaFeatures: { impliedStrict: true } } },
+			name: "favorodera/markdown/disables/code",
+			rules: {
+				"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",
+				"node/prefer-global/process": "off",
+				"style/comma-dangle": "off",
+				"style/eol-last": "off",
+				"style/padding-line-between-statements": "off",
+				"ts/consistent-type-imports": "off",
+				"ts/explicit-function-return-type": "off",
+				"ts/no-namespace": "off",
+				"ts/no-redeclare": "off",
+				"ts/no-require-imports": "off",
+				"ts/no-unused-expressions": "off",
+				"ts/no-unused-vars": "off",
+				"ts/no-use-before-define": "off",
+				"unicode-bom": "off",
+				"unused-imports/no-unused-imports": "off",
+				"unused-imports/no-unused-vars": "off"
+			}
+		}
+	];
+}
+//#endregion
+//#region src/configs/node.ts
+const nodeDefaults = { files: [
 	jsGlob,
 	tsGlob,
 	vueGlob
 ] };
 /**
-* Constructs the flat config items for JSDoc linting, ensuring comments follow
-* proper styling, parameter checks, and types alignment.
-* @param options JSDoc configuration options.
-* @returns Promise resolving to JSDoc ESLint config items.
+* Constructs the flat config items for Node.js linting, providing rules
+* to enforce best practices for Node.js environments.
+* @param options Node configuration options.
+* @returns Promise resolving to Node ESLint config items.
 */
-async function jsdoc(options) {
-	const resolved = (0, defu.defu)(options, jsdocDefaults);
-	const jsdocPlugin = await importModule(import("eslint-plugin-jsdoc"));
-	const baseRules = {
-		...jsdocPlugin.configs["flat/recommended-typescript-error"]?.rules,
-		...jsdocPlugin.configs["flat/stylistic-typescript-error"]?.rules
-	};
+async function node(options) {
+	const resolved = (0, defu.defu)(options, nodeDefaults);
+	const nodePlugin = await importModule(import("eslint-plugin-n"));
+	const baseRules = nodePlugin.configs?.["flat/recommended"]?.rules || {};
 	return [{
-		name: "favorodera/jsdoc/setup",
-		plugins: { jsdoc: jsdocPlugin }
+		name: "favorodera/node/setup",
+		plugins: { node: nodePlugin }
+	}, {
+		files: resolved.files,
+		name: "favorodera/node/rules",
+		rules: {
+			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { n: "node" }),
+			"node/handle-callback-err": ["error", "^(err|error)$"],
+			"node/no-deprecated-api": "error",
+			"node/no-exports-assign": "error",
+			"node/no-missing-import": "off",
+			"node/no-new-require": "error",
+			"node/no-path-concat": "error",
+			"node/no-unpublished-import": "off",
+			"node/prefer-global/buffer": ["error", "never"],
+			"node/prefer-global/process": ["error", "never"],
+			"node/process-exit-as-throw": "error",
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/perfectionist.ts
+const perfectionistDefaults = { files: [
+	jsGlob,
+	tsGlob,
+	vueGlob
+] };
+/**
+* Constructs the flat config items for Perfectionist linting, providing rules
+* to naturally sort objects, imports, classes, and other elements in your code.
+* @param options Perfectionist configuration options.
+* @returns Promise resolving to Perfectionist ESLint config items.
+*/
+async function perfectionist(options) {
+	const resolved = (0, defu.defu)(options, perfectionistDefaults);
+	const perfectionistPlugin = await importModule(import("eslint-plugin-perfectionist"));
+	const baseRules = perfectionistPlugin.configs["recommended-natural"]?.rules || {};
+	return [{
+		name: "favorodera/perfectionist/setup",
+		plugins: { perfectionist: perfectionistPlugin }
+	}, {
+		files: resolved.files,
+		name: "favorodera/perfectionist/rules",
+		rules: {
+			...baseRules,
+			"perfectionist/sort-exports": ["error", {
+				order: "asc",
+				type: "natural"
+			}],
+			"perfectionist/sort-imports": ["error", {
+				groups: [
+					"type-import",
+					[
+						"type-parent",
+						"type-sibling",
+						"type-index",
+						"type-internal"
+					],
+					"value-builtin",
+					"value-external",
+					"value-internal",
+					[
+						"value-parent",
+						"value-sibling",
+						"value-index"
+					],
+					"side-effect",
+					"ts-equals-import",
+					"unknown"
+				],
+				newlinesBetween: "ignore",
+				newlinesInside: "ignore",
+				order: "asc",
+				type: "natural"
+			}],
+			"perfectionist/sort-named-exports": ["error", {
+				order: "asc",
+				type: "natural"
+			}],
+			"perfectionist/sort-named-imports": ["error", {
+				order: "asc",
+				type: "natural"
+			}],
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/stylistic.ts
+const stylisticDefaults = {
+	files: [
+		jsGlob,
+		tsGlob,
+		vueGlob
+	],
+	settings: {
+		experimental: false,
+		indent: 2,
+		jsx: false,
+		quotes: "single",
+		semi: false
+	}
+};
+/**
+* Constructs the flat config items for Stylistic linting, applying customized
+* formatting settings such as quotes, indentation, and spacing.
+* @param options Stylistic configuration options.
+* @returns Promise resolving to stylistic ESLint config items.
+*/
+async function stylistic(options) {
+	const resolved = (0, defu.defu)(options, stylisticDefaults);
+	const stylePlugin = await importModule(import("@stylistic/eslint-plugin"));
+	const baseRules = stylePlugin.configs.customize({
+		pluginName: "style",
+		...resolved.settings
+	})?.rules || {};
+	return [{
+		name: "favorodera/stylistic/setup",
+		plugins: { style: stylePlugin }
+	}, {
+		files: resolved.files,
+		name: "favorodera/stylistic/rules",
+		rules: {
+			...baseRules,
+			"style/brace-style": "off",
+			"style/generator-star-spacing": ["error", {
+				after: true,
+				before: false
+			}],
+			"style/no-multiple-empty-lines": ["error", {
+				max: 2,
+				maxBOF: 0,
+				maxEOF: 2
+			}],
+			"style/no-trailing-spaces": ["error", { skipBlankLines: true }],
+			"style/padded-blocks": "off",
+			"style/quotes": [
+				"error",
+				"single",
+				{ avoidEscape: true }
+			],
+			"style/yield-star-spacing": ["error", {
+				after: true,
+				before: false
+			}],
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/tailwind.ts
+const tailwindDefaults = {
+	files: [
+		jsGlob,
+		tsGlob,
+		vueGlob
+	],
+	settings: { detectComponentClasses: true }
+};
+/**
+* Constructs the flat config items for Tailwind CSS linting, providing custom settings
+* to parse and lint utility classes, and enforcing consistent ordering.
+* @param options Tailwind configuration options.
+* @returns Promise resolving to Tailwind ESLint config items.
+*/
+async function tailwind(options) {
+	const resolved = (0, defu.defu)(options, tailwindDefaults);
+	const tailwindPlugin = await importModule(import("eslint-plugin-better-tailwindcss"));
+	const baseRules = {
+		...tailwindPlugin.configs["recommended-error"].rules,
+		...tailwindPlugin.configs["stylistic-error"].rules
+	};
+	return [{
+		name: "favorodera/tailwind/setup",
+		plugins: { tailwind: tailwindPlugin },
+		settings: { tailwindcss: resolved.settings }
 	}, {
+		files: resolved.files,
 		name: "favorodera/tailwind/rules",
+		rules: {
+			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { "better-tailwindcss": "tailwind" }),
+			"tailwind/enforce-consistent-line-wrapping": ["error", { group: "emptyLine" }],
+			"tailwind/no-unregistered-classes": "off",
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/typescript.ts
+const typescriptDefaults = { files: [tsGlob] };
+/**
+* Constructs the flat config items for TypeScript linting, initializing the parser
+* and extending the recommended and strict type-aware rule sets.
+* @param options TypeScript configuration options.
+* @returns Promise resolving to TypeScript ESLint config items.
+*/
+async function typescript(options) {
+	const resolved = (0, defu.defu)(options, typescriptDefaults);
+	const tsEsLint = await importModule(import("typescript-eslint"));
+	const baseRules = extractRules(tsEsLint.configs.recommended, tsEsLint.configs.strict);
+	return [{
+		name: "favorodera/typescript/setup",
+		plugins: { ts: tsEsLint.plugin }
+	}, {
 		files: resolved.files,
+		languageOptions: {
+			parser: tsEsLint.parser,
+			parserOptions: { sourceType: "module" }
+		},
+		name: "favorodera/typescript/rules",
 		rules: {
-			...baseRules || {},
-			"jsdoc/check-access": "warn",
-			"jsdoc/check-param-names": "warn",
-			"jsdoc/check-property-names": "warn",
-			"jsdoc/check-types": "warn",
-			"jsdoc/empty-tags": "warn",
-			"jsdoc/implements-on-classes": "warn",
-			"jsdoc/no-defaults": "warn",
-			"jsdoc/no-multi-asterisks": "warn",
-			"jsdoc/require-param-name": "warn",
-			"jsdoc/require-property": "warn",
-			"jsdoc/require-property-description": "warn",
-			"jsdoc/require-property-name": "warn",
-			"jsdoc/require-returns-check": "warn",
-			"jsdoc/require-returns-description": "warn",
-			"jsdoc/require-yields-check": "warn",
-			"jsdoc/check-alignment": "warn",
-			"jsdoc/multiline-blocks": "warn",
+			...(0, eslint_flat_config_utils.renamePluginsInRules)(baseRules, { "@typescript-eslint": "ts" }),
+			"ts/array-type": ["error", {
+				default: "generic",
+				readonly: "generic"
+			}],
+			"ts/consistent-type-imports": ["error", { prefer: "type-imports" }],
+			"ts/no-empty-object-type": ["error", { allowInterfaces: "with-single-extends" }],
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/unicorn.ts
+const unicornDefaults = { files: [
+	jsGlob,
+	tsGlob,
+	vueGlob
+] };
+/**
+* Constructs the flat config items for Unicorn linting, providing a collection of
+* awesome ESLint rules to improve code quality and enforce best practices.
+* @param options Unicorn configuration options.
+* @returns Promise resolving to Unicorn ESLint config items.
+*/
+async function unicorn(options) {
+	const resolved = (0, defu.defu)(options, unicornDefaults);
+	const unicornPlugin = await importModule(import("eslint-plugin-unicorn"));
+	const baseRules = unicornPlugin.configs["unopinionated"]?.rules || {};
+	return [{
+		name: "favorodera/unicorn/setup",
+		plugins: { unicorn: unicornPlugin }
+	}, {
+		files: resolved.files,
+		languageOptions: { globals: globals.default.builtin },
+		name: "favorodera/unicorn/rules",
+		rules: {
+			...baseRules,
+			"unicorn/consistent-empty-array-spread": "error",
+			"unicorn/error-message": "error",
+			"unicorn/escape-case": "error",
+			"unicorn/new-for-builtins": "error",
+			"unicorn/no-instanceof-builtins": "error",
+			"unicorn/no-new-array": "error",
+			"unicorn/no-new-buffer": "error",
+			"unicorn/number-literal-case": "error",
+			"unicorn/prefer-dom-node-text-content": "error",
+			"unicorn/prefer-includes": "error",
+			"unicorn/prefer-node-protocol": "error",
+			"unicorn/prefer-number-properties": "error",
+			"unicorn/prefer-string-starts-ends-with": "error",
+			"unicorn/prefer-type-error": "error",
+			"unicorn/throw-new-error": "error",
+			...resolved.overrides
+		}
+	}];
+}
+//#endregion
+//#region src/configs/vue.ts
+const sfcBlocksDefaults = { blocks: {
+	customBlocks: true,
+	styles: true,
+	template: false
+} };
+const vueDefaults = {
+	files: [vueGlob],
+	sfcBlocks: sfcBlocksDefaults
+};
+/**
+* Constructs the flat config items for Vue linting, setting up the custom template parser,
+* Vue block processors, and rules to enforce recommended component syntax.
+* @param options Vue configuration options.
+* @returns Promise resolving to Vue ESLint config items.
+*/
+async function vue(options) {
+	const resolved = (0, defu.defu)(options, vueDefaults);
+	const sfcBlocks = resolveOptions(resolved.sfcBlocks, sfcBlocksDefaults);
+	const [vuePlugin, vueParser, tsEsLint] = await Promise.all([
+		importModule(import("eslint-plugin-vue")),
+		importModule(import("vue-eslint-parser")),
+		importModule(import("typescript-eslint"))
+	]);
+	const baseRules = extractRules(vuePlugin.configs["flat/essential"], vuePlugin.configs["flat/strongly-recommended"], vuePlugin.configs["flat/recommended"]);
+	const processor = sfcBlocks === false ? vuePlugin.processors[".vue"] : (0, eslint_merge_processors.mergeProcessors)([vuePlugin.processors[".vue"], (0, eslint_processor_vue_blocks.default)(sfcBlocks)]);
+	return [{
+		languageOptions: { globals: {
+			computed: "readonly",
+			defineEmits: "readonly",
+			defineExpose: "readonly",
+			defineProps: "readonly",
+			onMounted: "readonly",
+			onUnmounted: "readonly",
+			reactive: "readonly",
+			ref: "readonly",
+			shallowReactive: "readonly",
+			shallowRef: "readonly",
+			toRef: "readonly",
+			toRefs: "readonly",
+			watch: "readonly",
+			watchEffect: "readonly"
+		} },
+		name: "favorodera/vue/setup",
+		plugins: { vue: vuePlugin }
+	}, {
+		files: resolved.files,
+		languageOptions: {
+			parser: vueParser,
+			parserOptions: {
+				extraFileExtensions: [".vue"],
+				parser: tsEsLint.parser,
+				sourceType: "module"
+			}
+		},
+		name: "favorodera/vue/rules",
+		processor,
+		rules: {
+			...baseRules,
+			"vue/block-order": ["error", { order: [
+				"script",
+				"template",
+				"style"
+			] }],
+			"vue/block-tag-newline": ["error", {
+				multiline: "ignore",
+				singleline: "ignore"
+			}],
+			"vue/component-name-in-template-casing": ["error", "PascalCase"],
+			"vue/component-options-name-casing": ["error", "PascalCase"],
+			"vue/multi-word-component-names": "off",
+			"vue/multiline-html-element-content-newline": ["error", {
+				allowEmptyLines: true,
+				ignores: ["pre", "textarea"]
+			}],
 			...resolved.overrides
 		}
 	}];
@@ -864,18 +1010,20 @@ async function jsdoc(options) {
 * @returns A flat config composer instance that can be exported directly or further modified.
 */
 function factory(options = {}) {
-	const configs = [];
-	configs.push(ignores(options.ignores));
+	const configs = [ignores(options.ignores)];
 	const configFunctions = {
-		vue,
-		typescript,
-		stylistic,
-		tailwind,
 		imports,
-		markdown,
 		javascript,
+		jsdoc,
 		jsonc,
-		jsdoc
+		markdown,
+		node,
+		perfectionist,
+		stylistic,
+		tailwind,
+		typescript,
+		unicorn,
+		vue
 	};
 	for (const [key, configFunction] of Object.entries(configFunctions)) {
 		const configOption = options[key];
@@ -884,10 +1032,11 @@ function factory(options = {}) {
 	}
 	let composer = new eslint_flat_config_utils.FlatConfigComposer();
 	composer = composer.append(...configs).renamePlugins({
-		"better-tailwindcss": "tailwind",
 		"@typescript-eslint": "ts",
+		"better-tailwindcss": "tailwind",
+		"import-lite": "import",
 		"markdown": "md",
-		"import-lite": "import"
+		"n": "node"
 	});
 	return composer;
 }