@favorodera/eslint-config 0.0.2 → 0.0.4

package/dist/index.mjs

@@ -4,17 +4,31 @@ import { mergeProcessors, processorPassThrough } from "eslint-merge-processors";
 import vueBlocksProcessor from "eslint-processor-vue-blocks";
 import globals from "globals";
 //#region src/globs.ts
-/** Glob pattern for JavaScript linting */
+/** Glob pattern for matching JavaScript files */
 const jsGlob = "**/*.{js,cjs,mjs}";
-/** Glob pattern for TypeScript linting */
+/** Glob pattern for matching TypeScript files */
 const tsGlob = "**/*.{ts,cts,mts}";
-/** Glob pattern for Vue linting */
+/** Glob pattern for matching Vue single-file components */
 const vueGlob = "**/*.vue";
-/** Glob pattern for Markdown linting */
+/** Glob pattern for matching Markdown files */
 const mdGlob = "**/*.md";
+/** Glob pattern for matching virtual files extracted from Markdown */
+const mdInMdGlob = "**/*.md/*.md";
+/** Glob pattern for matching code blocks embedded in Markdown files */
+const codeInMdGlob = "**/*.md/**/*.{js,cjs,mjs,ts,cts,mts,vue}";
+/** Glob pattern for matching JSON files */
+const jsonGlob = "**/*.json";
+/** Glob pattern for matching JSON5 files */
+const json5Glob = "**/*.json5";
+/** Glob pattern for matching JSON with Comments files */
+const jsoncGlob = "**/*.jsonc";
+/** Glob patterns for matching TypeScript configuration files */
+const tsConfigGlob = ["**/tsconfig.json", "**/tsconfig.*.json"];
+/** Glob pattern for matching package.json files */
+const packageJsonGlob = "**/package.json";
 /**
-* Default glob patterns for files and directories to ignore
-* Includes common build outputs, dependencies, caches, and temporary files
+* 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 = [
 	"**/node_modules/**",
@@ -61,9 +75,9 @@ const ignoresGlob = [
 *
 * Handles both ESM modules (which wrap exports under `.default`) and
 * CJS / plain-object modules uniformly.
-*
-* @param module - A module or a promise that resolves to one
-* @returns The `.default` export if it exists, otherwise the module itself
+* @template TModule The type of the module being imported.
+* @param module A module or a promise that resolves to one.
+* @returns The `.default` export if it exists, otherwise the module itself.
 */
 async function importModule(module) {
 	const resolved = await module;
@@ -73,15 +87,23 @@ async function importModule(module) {
 /**
 * Normalize boolean or options value into merged options or null.
 * Returns null when the input is false or undefined.
-*
-* @param value - boolean, options object, or undefined
-* @param defaults - defaults to merge with
-* @returns merged options or false
+* @template TOptions The type of the options object.
+* @param value The configuration value, which can be a boolean, an options object, or undefined.
+* @param defaults The default options to merge with if `value` is true or an object.
+* @returns The merged options object, or false if the feature is disabled.
 */
 function resolveOptions(value, defaults) {
 	if (!value) return false;
 	return 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: {
@@ -93,6 +115,12 @@ 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 = defu(options, vueDefaults);
 	const sfcBlocks = resolveOptions(resolved.sfcBlocks, sfcBlocksDefaults);
@@ -101,32 +129,31 @@ async function vue(options) {
 		importModule(import("vue-eslint-parser")),
 		importModule(import("typescript-eslint"))
 	]);
-	const inheritedRules = Object.assign({}, ...[
-		...vuePlugin.configs["flat/essential"],
-		...vuePlugin.configs["flat/strongly-recommended"],
-		...vuePlugin.configs["flat/recommended"]
-	].map((config) => config?.rules || {}));
+	const baseRules = extractRules(vuePlugin.configs["flat/essential"], vuePlugin.configs["flat/strongly-recommended"], vuePlugin.configs["flat/recommended"]);
+	const processor = sfcBlocks === false ? vuePlugin.processors[".vue"] : mergeProcessors([vuePlugin.processors[".vue"], vueBlocksProcessor(sfcBlocks)]);
 	return [{
-		name: "favorodera/vue",
+		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: {
-			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"
-			},
 			parser: vueParser,
 			parserOptions: {
 				parser: tsEsLint.parser,
@@ -134,9 +161,9 @@ async function vue(options) {
 				sourceType: "module"
 			}
 		},
-		processor: sfcBlocks === false ? vuePlugin.processors[".vue"] : mergeProcessors([vuePlugin.processors[".vue"], vueBlocksProcessor(sfcBlocks)]),
+		processor,
 		rules: {
-			...inheritedRules,
+			...baseRules,
 			"vue/block-order": ["error", { order: [
 				"script",
 				"template",
@@ -162,7 +189,7 @@ async function vue(options) {
 const defaultPatterns = ignoresGlob;
 /**
 * Globs for ignoring files and directories from ESLint scanning.
-* @param patterns - Additional ignore patterns or a function to modify the defaults.
+* @param patterns Additional ignore patterns or a function to modify the defaults.
 * @returns An array containing the ignore flat config item.
 */
 function ignores(patterns = []) {
@@ -178,19 +205,27 @@ const importsDefaults = { files: [
 	tsGlob,
 	vueGlob
 ] };
+/**
+* Constructs the flat config items for imports linting, providing plugin setup and
+* specific rules to enforce consistent import ordering and unused variable checks.
+* @param options Configuration options for imports linting.
+* @returns Promise resolving to imports ESLint config items.
+*/
 async function imports(options) {
 	const resolved = defu(options, importsDefaults);
 	const [importPlugin, unusedImportsPlugin] = await Promise.all([importModule(import("eslint-plugin-import-lite")), importModule(import("eslint-plugin-unused-imports"))]);
-	const inheritedRules = importPlugin.configs.recommended?.rules || {};
+	const baseRules = importPlugin.configs.recommended?.rules || {};
 	return [{
-		name: "favorodera/imports",
-		files: resolved.files,
+		name: "favorodera/imports/setup",
 		plugins: {
 			"import": importPlugin,
 			"unused-imports": unusedImportsPlugin
-		},
+		}
+	}, {
+		name: "favorodera/imports/rules",
+		files: resolved.files,
 		rules: {
-			...renamePluginsInRules(inheritedRules, { "import-lite": "import" }),
+			...renamePluginsInRules(baseRules, { "import-lite": "import" }),
 			"import/consistent-type-specifier-style": ["error", "top-level"],
 			"import/first": "error",
 			"import/no-duplicates": "error",
@@ -217,16 +252,16 @@ const javascriptDefaults = { files: [
 	vueGlob
 ] };
 /**
-* Javascript linting via `eslint`
-* @param options - Javascript configuration options
-* @returns Promise resolving to javascript ESLint config items
+* Constructs the flat config items for core JavaScript linting, setting up the required
+* language options, globals, and recommended baseline rules.
+* @param options Javascript configuration options.
+* @returns Promise resolving to javascript ESLint config items.
 */
 async function javascript(options) {
 	const resolved = defu(options, javascriptDefaults);
-	const inheritedRules = (await importModule(import("@eslint/js"))).configs.recommended.rules;
+	const baseRules = (await importModule(import("@eslint/js"))).configs.recommended.rules;
 	return [{
-		name: "favorodera/javascript",
-		files: resolved.files,
+		name: "favorodera/javascript/setup",
 		languageOptions: {
 			ecmaVersion: "latest",
 			sourceType: "module",
@@ -239,9 +274,12 @@ async function javascript(options) {
 				window: "readonly"
 			}
 		},
-		linterOptions: { reportUnusedDisableDirectives: true },
+		linterOptions: { reportUnusedDisableDirectives: true }
+	}, {
+		name: "favorodera/javascript/rules",
+		files: resolved.files,
 		rules: {
-			...inheritedRules,
+			...baseRules,
 			"accessor-pairs": ["error", {
 				enforceForClassMembers: true,
 				setWithoutGet: true
@@ -258,23 +296,66 @@ 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 = defu(options, markdownDefaults);
 	const markdownPlugin = await importModule(import("@eslint/markdown"));
-	const inheritedRules = Object.assign({}, ...[...markdownPlugin.configs.recommended].map((config) => config?.rules || {}));
-	return [{
-		name: "favorodera/markdown",
-		files: resolved.files,
-		plugins: { md: markdownPlugin },
-		processor: mergeProcessors([markdownPlugin.processors?.markdown, processorPassThrough]),
-		language: resolved.gfm ? "md/gfm" : "md/commonmark",
-		rules: {
-			...renamePluginsInRules(inheritedRules, { markdown: "md" }),
-			"md/fenced-code-language": "off",
-			"md/no-missing-label-refs": "off",
-			...resolved.overrides
+	const baseRules = extractRules(markdownPlugin.configs.recommended);
+	return [
+		{
+			name: "favorodera/markdown/setup",
+			plugins: { md: markdownPlugin }
+		},
+		{
+			name: "favorodera/markdown/rules",
+			files: resolved.files,
+			language: resolved.gfm ? "md/gfm" : "md/commonmark",
+			ignores: [mdInMdGlob],
+			processor: mergeProcessors([markdownPlugin.processors?.markdown, processorPassThrough]),
+			rules: {
+				...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
@@ -292,19 +373,27 @@ const stylisticDefaults = {
 		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 = defu(options, stylisticDefaults);
-	const config = (await importModule(import("@stylistic/eslint-plugin"))).configs.customize({
+	const stylePlugin = await importModule(import("@stylistic/eslint-plugin"));
+	const baseRules = stylePlugin.configs.customize({
 		pluginName: "style",
 		...resolved.settings
-	});
-	const inheritedRules = config?.rules || {};
+	})?.rules || {};
 	return [{
-		...config,
-		name: "favorodera/stylistic",
+		name: "favorodera/stylistic/setup",
+		plugins: { style: stylePlugin }
+	}, {
+		name: "favorodera/stylistic/rules",
 		files: resolved.files,
 		rules: {
-			...inheritedRules,
+			...baseRules,
 			"style/quotes": [
 				"error",
 				"single",
@@ -341,24 +430,27 @@ const tailwindDefaults = {
 	settings: { detectComponentClasses: true }
 };
 /**
-* Tailwind linting via `eslint-plugin-better-tailwindcss`.
-* @param options - Tailwind configuration options
-* @returns Promise resolving to Tailwind ESLint config items
+* 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 = defu(options, tailwindDefaults);
 	const tailwindPlugin = await importModule(import("eslint-plugin-better-tailwindcss"));
-	const inheritedRules = {
+	const baseRules = {
 		...tailwindPlugin.configs["recommended-error"].rules,
 		...tailwindPlugin.configs["stylistic-error"].rules
 	};
 	return [{
-		name: "favorodera/tailwind",
-		files: resolved.files,
+		name: "favorodera/tailwind/setup",
 		plugins: { tailwind: tailwindPlugin },
-		settings: { tailwindcss: resolved.settings },
+		settings: { tailwindcss: resolved.settings }
+	}, {
+		name: "favorodera/tailwind/rules",
+		files: resolved.files,
 		rules: {
-			...renamePluginsInRules(inheritedRules, { "better-tailwindcss": "tailwind" }),
+			...renamePluginsInRules(baseRules, { "better-tailwindcss": "tailwind" }),
 			"tailwind/no-unregistered-classes": "off",
 			"tailwind/enforce-consistent-line-wrapping": ["error", { group: "emptyLine" }],
 			...resolved.overrides
@@ -369,27 +461,371 @@ async function tailwind(options) {
 //#region src/configs/typescript.ts
 const typescriptDefaults = { files: [tsGlob] };
 /**
-* Typescript linting via `typescript-eslint`.
-* @param options - TypeScript configuration options
-* @returns Array of TypeScript ESLint config items
+* 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 = defu(options, typescriptDefaults);
 	const tsEsLint = await importModule(import("typescript-eslint"));
-	const inheritedRules = Object.assign({}, ...[...tsEsLint.configs.recommended, ...tsEsLint.configs.strict].map((config) => config?.rules || {}));
+	const baseRules = extractRules(tsEsLint.configs.recommended, tsEsLint.configs.strict);
 	return [{
-		name: "favorodera/typescript",
-		plugins: { ts: tsEsLint.plugin },
+		name: "favorodera/typescript/setup",
+		plugins: { ts: tsEsLint.plugin }
+	}, {
+		name: "favorodera/typescript/rules",
+		files: resolved.files,
 		languageOptions: {
 			parser: tsEsLint.parser,
 			parserOptions: { sourceType: "module" }
 		},
-		files: resolved.files,
 		rules: {
-			...renamePluginsInRules(inheritedRules, { "@typescript-eslint": "ts" }),
+			...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: "array" }],
+			"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 = 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",
+			rules: {
+				"jsonc/no-bigint-literals": "error",
+				"jsonc/no-binary-expression": "error",
+				"jsonc/no-binary-numeric-literals": "error",
+				"jsonc/no-dupe-keys": "error",
+				"jsonc/no-escape-sequence-in-identifier": "error",
+				"jsonc/no-floating-decimal": "error",
+				"jsonc/no-hexadecimal-numeric-literals": "error",
+				"jsonc/no-infinity": "error",
+				"jsonc/no-multi-str": "error",
+				"jsonc/no-nan": "error",
+				"jsonc/no-number-props": "error",
+				"jsonc/no-numeric-separators": "error",
+				"jsonc/no-octal": "error",
+				"jsonc/no-octal-escape": "error",
+				"jsonc/no-octal-numeric-literals": "error",
+				"jsonc/no-parenthesized": "error",
+				"jsonc/no-plus-sign": "error",
+				"jsonc/no-regexp-literals": "error",
+				"jsonc/no-sparse-arrays": "error",
+				"jsonc/no-template-literals": "error",
+				"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
+				}],
+				"jsonc/object-curly-spacing": ["error", "always"],
+				"jsonc/object-property-newline": ["error", { allowAllPropertiesOnSameLine: true }],
+				"jsonc/quote-props": "error",
+				"jsonc/quotes": "error",
+				...resolved.overrides
+			}
+		},
+		{
+			name: "favorodera/jsonc/sort/package-json",
+			files: [packageJsonGlob],
+			rules: {
+				"jsonc/sort-array-values": ["error", {
+					order: { type: "asc" },
+					pathPattern: "^files$"
+				}],
+				"jsonc/sort-keys": [
+					"error",
+					{
+						order: [
+							"publisher",
+							"name",
+							"displayName",
+							"type",
+							"version",
+							"private",
+							"packageManager",
+							"description",
+							"author",
+							"contributors",
+							"license",
+							"funding",
+							"homepage",
+							"repository",
+							"bugs",
+							"keywords",
+							"categories",
+							"sideEffects",
+							"imports",
+							"exports",
+							"main",
+							"module",
+							"unpkg",
+							"jsdelivr",
+							"types",
+							"typesVersions",
+							"bin",
+							"icon",
+							"files",
+							"engines",
+							"activationEvents",
+							"contributes",
+							"scripts",
+							"peerDependencies",
+							"peerDependenciesMeta",
+							"dependencies",
+							"optionalDependencies",
+							"devDependencies",
+							"pnpm",
+							"overrides",
+							"resolutions",
+							"husky",
+							"simple-git-hooks",
+							"lint-staged",
+							"eslintConfig"
+						],
+						pathPattern: "^$"
+					},
+					{
+						order: { type: "asc" },
+						pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies(Meta)?$"
+					},
+					{
+						order: { type: "asc" },
+						pathPattern: "^(?:resolutions|overrides|pnpm.overrides)$"
+					},
+					{
+						order: { type: "asc" },
+						pathPattern: "^workspaces\\.catalog$"
+					},
+					{
+						order: { type: "asc" },
+						pathPattern: "^workspaces\\.catalogs\\.[^.]+$"
+					},
+					{
+						order: [
+							"types",
+							"import",
+							"require",
+							"default"
+						],
+						pathPattern: "^exports.*$"
+					},
+					{
+						order: [
+							"pre-commit",
+							"prepare-commit-msg",
+							"commit-msg",
+							"post-commit",
+							"pre-rebase",
+							"post-rewrite",
+							"post-checkout",
+							"post-merge",
+							"pre-push",
+							"pre-auto-gc"
+						],
+						pathPattern: "^(?:gitHooks|husky|simple-git-hooks)$"
+					}
+				]
+			}
+		},
+		{
+			name: "favorodera/jsonc/sort/tsconfig-json",
+			files: tsConfigGlob,
+			rules: { "jsonc/sort-keys": [
+				"error",
+				{
+					order: [
+						"extends",
+						"compilerOptions",
+						"references",
+						"files",
+						"include",
+						"exclude"
+					],
+					pathPattern: "^$"
+				},
+				{
+					order: [
+						"incremental",
+						"composite",
+						"tsBuildInfoFile",
+						"disableSourceOfProjectReferenceRedirect",
+						"disableSolutionSearching",
+						"disableReferencedProjectLoad",
+						"target",
+						"jsx",
+						"jsxFactory",
+						"jsxFragmentFactory",
+						"jsxImportSource",
+						"lib",
+						"moduleDetection",
+						"noLib",
+						"reactNamespace",
+						"useDefineForClassFields",
+						"emitDecoratorMetadata",
+						"experimentalDecorators",
+						"libReplacement",
+						"baseUrl",
+						"rootDir",
+						"rootDirs",
+						"customConditions",
+						"module",
+						"moduleResolution",
+						"moduleSuffixes",
+						"noResolve",
+						"paths",
+						"resolveJsonModule",
+						"resolvePackageJsonExports",
+						"resolvePackageJsonImports",
+						"typeRoots",
+						"types",
+						"allowArbitraryExtensions",
+						"allowImportingTsExtensions",
+						"allowUmdGlobalAccess",
+						"allowJs",
+						"checkJs",
+						"maxNodeModuleJsDepth",
+						"strict",
+						"strictBindCallApply",
+						"strictFunctionTypes",
+						"strictNullChecks",
+						"strictPropertyInitialization",
+						"allowUnreachableCode",
+						"allowUnusedLabels",
+						"alwaysStrict",
+						"exactOptionalPropertyTypes",
+						"noFallthroughCasesInSwitch",
+						"noImplicitAny",
+						"noImplicitOverride",
+						"noImplicitReturns",
+						"noImplicitThis",
+						"noPropertyAccessFromIndexSignature",
+						"noUncheckedIndexedAccess",
+						"noUnusedLocals",
+						"noUnusedParameters",
+						"useUnknownInCatchVariables",
+						"declaration",
+						"declarationDir",
+						"declarationMap",
+						"downlevelIteration",
+						"emitBOM",
+						"emitDeclarationOnly",
+						"importHelpers",
+						"importsNotUsedAsValues",
+						"inlineSourceMap",
+						"inlineSources",
+						"mapRoot",
+						"newLine",
+						"noEmit",
+						"noEmitHelpers",
+						"noEmitOnError",
+						"outDir",
+						"outFile",
+						"preserveConstEnums",
+						"preserveValueImports",
+						"removeComments",
+						"sourceMap",
+						"sourceRoot",
+						"stripInternal",
+						"allowSyntheticDefaultImports",
+						"esModuleInterop",
+						"forceConsistentCasingInFileNames",
+						"isolatedDeclarations",
+						"isolatedModules",
+						"preserveSymlinks",
+						"verbatimModuleSyntax",
+						"erasableSyntaxOnly",
+						"skipDefaultLibCheck",
+						"skipLibCheck"
+					],
+					pathPattern: "^compilerOptions$"
+				}
+			] }
+		}
+	];
+}
+//#endregion
+//#region src/configs/jsdoc.ts
+const jsdocDefaults = { 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.
+*/
+async function jsdoc(options) {
+	const resolved = 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 }
+	}, {
+		name: "favorodera/tailwind/rules",
+		files: resolved.files,
+		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",
 			...resolved.overrides
 		}
 	}];
@@ -397,9 +833,10 @@ async function typescript(options) {
 //#endregion
 //#region src/factory.ts
 /**
-* Factory to create a flat ESLint config
-* @param options - Configuration options for the ESLint config
-* @returns Flat ESLint config composer
+* Factory to create a flat ESLint config.
+* It builds an ESLint config by sequentially adding sub-configs based on the provided options.
+* @param options Configuration options for enabling/disabling or configuring specific rule sets.
+* @returns A flat config composer instance that can be exported directly or further modified.
 */
 function factory(options = {}) {
 	const configs = [];
@@ -411,7 +848,9 @@ function factory(options = {}) {
 		tailwind,
 		imports,
 		markdown,
-		javascript
+		javascript,
+		jsonc,
+		jsdoc
 	};
 	for (const [key, configFunction] of Object.entries(configFunctions)) {
 		const configOption = options[key];