@favorodera/eslint-config 0.0.5 → 0.0.7

package/dist/index.mjs

@@ -16,6 +16,10 @@ const mdGlob = "**/*.md";
 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 scripts files */
+const scriptsGlob = "**/*.{js,cjs,mjs,ts,cts,mts}";
+/** Glob pattern for matching test files */
+const testsGlob = ["**/*.{tests,specs,benchmark,bench}.{js,cjs,mjs,ts,cts,mts}", "**/__tests__/**/*.{js,cjs,mjs,ts,cts,mts}"];
 /** Glob pattern for matching JSON files */
 const jsonGlob = "**/*.json";
 /** Glob pattern for matching JSON5 files */
@@ -24,11 +28,17 @@ const json5Glob = "**/*.json5";
 const jsoncGlob = "**/*.jsonc";
 /** Glob patterns for matching TypeScript configuration files */
 const tsConfigGlob = ["**/tsconfig.json", "**/tsconfig.*.json"];
+/** Glob pattern for matching YAML files */
+const yamlGlob = "**/*.{yml,yaml}";
+/** Glob pattern for matching pnpm-workspace.yaml file */
+const pnpmWorkspaceGlob = "pnpm-workspace.yaml";
 /** Glob pattern for matching package.json files */
 const packageJsonGlob = "**/package.json";
-//#endregion
-//#region src/configs/ignores.ts
-const defaultPatterns = [
+/**
+* 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/**",
 	"**/dist/**",
 	"**/package-lock.json",
@@ -65,6 +75,9 @@ const defaultPatterns = [
 	"**/.agents",
 	"**/.*/skills"
 ];
+//#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.
@@ -195,12 +208,182 @@ async function javascript(options) {
 		name: "favorodera/javascript/rules",
 		rules: {
 			...baseRules,
-			"accessor-pairs": ["error", {
-				enforceForClassMembers: true,
-				setWithoutGet: true
-			}],
 			"array-callback-return": "error",
 			"block-scoped-var": "error",
+			"constructor-super": "error",
+			"default-case-last": "error",
+			"dot-notation": ["error", { allowKeywords: true }],
+			"eqeqeq": ["error", "smart"],
+			"new-cap": ["error", {
+				capIsNew: false,
+				newIsCap: true,
+				properties: true
+			}],
+			"no-alert": "error",
+			"no-array-constructor": "error",
+			"no-async-promise-executor": "error",
+			"no-caller": "error",
+			"no-case-declarations": "error",
+			"no-class-assign": "error",
+			"no-compare-neg-zero": "error",
+			"no-cond-assign": ["error", "always"],
+			"no-console": ["error", { allow: ["warn", "error"] }],
+			"no-const-assign": "error",
+			"no-control-regex": "error",
+			"no-debugger": "error",
+			"no-delete-var": "error",
+			"no-dupe-args": "error",
+			"no-dupe-class-members": "error",
+			"no-dupe-keys": "error",
+			"no-duplicate-case": "error",
+			"no-empty": ["error", { allowEmptyCatch: true }],
+			"no-empty-character-class": "error",
+			"no-empty-pattern": "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-implied-eval": "error",
+			"no-import-assign": "error",
+			"no-invalid-regexp": "error",
+			"no-irregular-whitespace": "error",
+			"no-iterator": "error",
+			"no-labels": ["error", {
+				allowLoop: false,
+				allowSwitch: false
+			}],
+			"no-lone-blocks": "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-obj-calls": "error",
+			"no-octal": "error",
+			"no-octal-escape": "error",
+			"no-proto": "error",
+			"no-prototype-builtins": "error",
+			"no-redeclare": ["error", { builtinGlobals: false }],
+			"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",
+				"TSEnumDeclaration[const=true]",
+				"TSExportAssignment"
+			],
+			"no-self-assign": ["error", { props: true }],
+			"no-self-compare": "error",
+			"no-sequences": "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-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-unused-expressions": ["error", {
+				allowShortCircuit: true,
+				allowTaggedTemplates: true,
+				allowTernary: true
+			}],
+			"no-unused-vars": ["error", {
+				args: "none",
+				caughtErrors: "none",
+				ignoreRestSiblings: true,
+				vars: "all"
+			}],
+			"no-use-before-define": ["error", {
+				classes: false,
+				functions: false,
+				variables: true
+			}],
+			"no-useless-backreference": "error",
+			"no-useless-call": "error",
+			"no-useless-catch": "error",
+			"no-useless-computed-key": "error",
+			"no-useless-constructor": "error",
+			"no-useless-rename": "error",
+			"no-useless-return": "error",
+			"no-var": "error",
+			"no-with": "error",
+			"object-shorthand": [
+				"error",
+				"always",
+				{
+					avoidQuotes: true,
+					ignoreConstructors: false
+				}
+			],
+			"one-var": ["error", { initialized: "never" }],
+			"prefer-arrow-callback": ["error", {
+				allowNamedFunctions: false,
+				allowUnboundThis: true
+			}],
+			"prefer-const": ["error", {
+				destructuring: "all",
+				ignoreReadBeforeAssign: true
+			}],
+			"prefer-exponentiation-operator": "error",
+			"prefer-promise-reject-errors": "error",
+			"prefer-regex-literals": ["error", { disallowRedundantWrapping: true }],
+			"prefer-rest-params": "error",
+			"prefer-spread": "error",
+			"prefer-template": "error",
+			"symbol-description": "error",
+			"unicode-bom": ["error", "never"],
+			"use-isnan": ["error", {
+				enforceForIndexOf: true,
+				enforceForSwitchCase: true
+			}],
+			"valid-typeof": ["error", { requireStringLiterals: true }],
+			"vars-on-top": "error",
+			"yoda": ["error", "never"],
 			...resolved.overrides
 		}
 	}];
@@ -230,7 +413,7 @@ async function jsdoc(options) {
 		plugins: { jsdoc: jsdocPlugin }
 	}, {
 		files: resolved.files,
-		name: "favorodera/tailwind/rules",
+		name: "favorodera/jsdoc/rules",
 		rules: {
 			...baseRules,
 			"jsdoc/check-access": "warn",
@@ -580,7 +763,7 @@ async function markdown(options) {
 		{
 			files: [codeInMdGlob],
 			languageOptions: { parserOptions: { ecmaFeatures: { impliedStrict: true } } },
-			name: "favorodera/markdown/disables/code",
+			name: "favorodera/markdown/code-in-md/disables",
 			rules: {
 				"no-alert": "off",
 				"no-console": "off",
@@ -717,6 +900,47 @@ async function perfectionist(options) {
 	}];
 }
 //#endregion
+//#region src/configs/pnpm.ts
+/**
+* Constructs the flat config items for pnpm linting.
+* @returns Promise resolving to pnpm ESLint config items.
+*/
+async function pnpm() {
+	const [pnpmPlugin, yamlParser] = await Promise.all([importModule(import("eslint-plugin-pnpm")), importModule(import("yaml-eslint-parser"))]);
+	return [
+		{
+			name: "favorodera/pnpm/setup",
+			plugins: { pnpm: pnpmPlugin }
+		},
+		{
+			files: [packageJsonGlob],
+			language: "jsonc/x",
+			name: "favorodera/pnpm/package-json",
+			rules: {
+				"pnpm/json-enforce-catalog": ["error", {
+					autofix: true,
+					ignores: ["@types/vscode"]
+				}],
+				"pnpm/json-prefer-workspace-settings": ["error", { autofix: true }],
+				"pnpm/json-valid-catalog": ["error", { autofix: true }]
+			}
+		},
+		{
+			files: [pnpmWorkspaceGlob],
+			languageOptions: { parser: yamlParser },
+			name: "favorodera/pnpm/pnpm-workspace-yaml",
+			rules: {
+				"pnpm/yaml-enforce-settings": ["error", { settings: {
+					shellEmulator: true,
+					trustPolicy: "no-downgrade"
+				} }],
+				"pnpm/yaml-no-duplicate-catalog-item": ["error", { checkDuplicates: "exact-version" }],
+				"pnpm/yaml-no-unused-catalog-item": "error"
+			}
+		}
+	];
+}
+//#endregion
 //#region src/configs/stylistic.ts
 const stylisticDefaults = {
 	files: [
@@ -811,12 +1035,55 @@ async function tailwind(options) {
 		rules: {
 			...renamePluginsInRules(baseRules, { "better-tailwindcss": "tailwind" }),
 			"tailwind/enforce-consistent-line-wrapping": ["error", { group: "emptyLine" }],
-			"tailwind/no-unregistered-classes": "off",
 			...resolved.overrides
 		}
 	}];
 }
 //#endregion
+//#region src/configs/test.ts
+const testDefaults = { files: testsGlob };
+/**
+* Constructs the flat config items for test linting, extending
+* the recommended Vitest rule sets.
+* @param options Test configuration options.
+* @returns Promise resolving to test ESLint config items.
+*/
+async function test(options) {
+	const resolved = defu(options, testDefaults);
+	const testPlugin = await importModule(import("@vitest/eslint-plugin"));
+	const baseRules = extractRules(testPlugin.configs.recommended);
+	return [
+		{
+			name: "favorodera/test/setup",
+			plugins: { test: testPlugin }
+		},
+		{
+			files: resolved.files,
+			name: "favorodera/test/rules",
+			rules: {
+				...renamePluginsInRules(baseRules, { vitest: "test" }),
+				"test/consistent-test-it": ["error", {
+					fn: "it",
+					withinDescribe: "it"
+				}],
+				"test/no-identical-title": "error",
+				"test/no-import-node-test": "error",
+				"test/prefer-hooks-in-order": "error",
+				"test/prefer-lowercase-title": "error",
+				...resolved.overrides
+			}
+		},
+		{
+			files: resolved.files,
+			name: "favorodera/test/disables",
+			rules: {
+				"no-unused-expressions": "off",
+				"node/prefer-global/process": "off"
+			}
+		}
+	];
+}
+//#endregion
 //#region src/configs/typescript.ts
 const typescriptDefaults = { files: [tsGlob] };
 /**
@@ -867,7 +1134,7 @@ const unicornDefaults = { files: [
 async function unicorn(options) {
 	const resolved = defu(options, unicornDefaults);
 	const unicornPlugin = await importModule(import("eslint-plugin-unicorn"));
-	const baseRules = unicornPlugin.configs["unopinionated"]?.rules || {};
+	const baseRules = unicornPlugin.configs.recommended?.rules || {};
 	return [{
 		name: "favorodera/unicorn/setup",
 		plugins: { unicorn: unicornPlugin }
@@ -877,21 +1144,7 @@ async function unicorn(options) {
 		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",
+			"unicorn/filename-case": "off",
 			...resolved.overrides
 		}
 	}];
@@ -921,7 +1174,7 @@ async function vue(options) {
 		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 baseRules = extractRules(vuePlugin.configs["flat/recommended-error"]);
 	const processor = sfcBlocks === false ? vuePlugin.processors[".vue"] : mergeProcessors([vuePlugin.processors[".vue"], vueBlocksProcessor(sfcBlocks)]);
 	return [{
 		languageOptions: { globals: {
@@ -956,27 +1209,190 @@ async function vue(options) {
 		processor,
 		rules: {
 			...baseRules,
+			"vue/block-lang": ["error", { script: { lang: "ts" } }],
 			"vue/block-order": ["error", { order: [
 				"script",
 				"template",
 				"style"
 			] }],
 			"vue/block-tag-newline": ["error", {
-				multiline: "ignore",
-				singleline: "ignore"
+				multiline: "always",
+				singleline: "always"
 			}],
-			"vue/component-name-in-template-casing": ["error", "PascalCase"],
-			"vue/component-options-name-casing": ["error", "PascalCase"],
+			"vue/comment-directive": ["error", { reportUnusedDisableDirectives: true }],
+			"vue/define-macros-order": ["error", {
+				defineExposeLast: true,
+				order: [
+					"defineOptions",
+					"definePage",
+					"defineSlots",
+					"defineEmits",
+					"defineProps",
+					"defineModel"
+				]
+			}],
+			"vue/define-props-declaration": ["error", "type-based"],
+			"vue/define-props-destructuring": ["error", { destructure: "never" }],
 			"vue/multi-word-component-names": "off",
-			"vue/multiline-html-element-content-newline": ["error", {
-				allowEmptyLines: true,
-				ignores: ["pre", "textarea"]
+			"vue/next-tick-style": ["error", "promise"],
+			"vue/no-import-compiler-macros": "error",
+			"vue/no-negated-v-if-condition": "error",
+			"vue/no-reserved-component-names": ["error", {
+				disallowVue3BuiltInComponents: true,
+				disallowVueBuiltInComponents: true,
+				htmlElementCaseSensitive: false
 			}],
+			"vue/no-root-v-if": "error",
+			"vue/no-template-target-blank": "error",
+			"vue/no-unused-emit-declarations": "error",
+			"vue/no-unused-properties": "error",
+			"vue/no-unused-refs": "error",
+			"vue/no-use-v-else-with-v-for": "error",
+			"vue/no-useless-mustaches": "error",
+			"vue/no-useless-v-bind": "error",
+			"vue/padding-line-between-blocks": "error",
+			"vue/padding-line-between-tags": ["error", [
+				{
+					blankLine: "always",
+					next: "*:multi-line",
+					prev: "*:single-line"
+				},
+				{
+					blankLine: "always",
+					next: "*:single-line",
+					prev: "*:multi-line"
+				},
+				{
+					blankLine: "always",
+					next: "*:multi-line",
+					prev: "*:multi-line"
+				},
+				{
+					blankLine: "never",
+					next: "*:single-line",
+					prev: "*:single-line"
+				}
+			]],
+			"vue/prefer-prop-type-boolean-first": "error",
+			"vue/prefer-separate-static-class": "error",
+			"vue/prefer-single-event-payload": "error",
+			"vue/prefer-use-template-ref": "error",
+			"vue/require-explicit-slots": "error",
+			"vue/require-macro-variable-name": "error",
+			"vue/slot-name-casing": ["error", "kebab-case"],
+			"vue/v-for-delimiter-style": ["error", "in"],
 			...resolved.overrides
 		}
 	}];
 }
 //#endregion
+//#region src/configs/yaml.ts
+const yamlDefaults = { files: [yamlGlob] };
+/**
+* Constructs the flat config items for YAML linting, setting up
+* the custom parser and rule validations.
+* @param options YAML configuration options.
+* @returns Promise resolving to YAML ESLint config items.
+*/
+async function yaml(options) {
+	const resolved = defu(options, yamlDefaults);
+	const [yamlPlugin, yamlParser] = await Promise.all([importModule(import("eslint-plugin-yml")), importModule(import("yaml-eslint-parser"))]);
+	const baseRules = extractRules(yamlPlugin.configs.standard);
+	return [
+		{
+			name: "favorodera/yaml/setup",
+			plugins: { yaml: yamlPlugin }
+		},
+		{
+			files: resolved.files,
+			languageOptions: { parser: yamlParser },
+			name: "favorodera/yaml/rules",
+			rules: {
+				...renamePluginsInRules(baseRules, { yml: "yaml" }),
+				"yaml/quotes": ["error", {
+					avoidEscape: true,
+					prefer: "single"
+				}],
+				"yaml/require-string-key": "error",
+				...resolved.overrides
+			}
+		},
+		{
+			files: [pnpmWorkspaceGlob],
+			languageOptions: { parser: yamlParser },
+			name: "favorodera/yaml/sort/pnpm-workspace-yaml",
+			rules: { "yaml/sort-keys": [
+				"error",
+				{
+					order: [
+						"cacheDir",
+						"catalogMode",
+						"cleanupUnusedCatalogs",
+						"dedupeDirectDeps",
+						"deployAllFiles",
+						"enablePrePostScripts",
+						"engineStrict",
+						"extendNodePath",
+						"hoist",
+						"hoistPattern",
+						"hoistWorkspacePackages",
+						"ignoreCompatibilityDb",
+						"ignoreDepScripts",
+						"ignoreScripts",
+						"ignoreWorkspaceRootCheck",
+						"managePackageManagerVersions",
+						"minimumReleaseAge",
+						"minimumReleaseAgeExclude",
+						"modulesDir",
+						"nodeLinker",
+						"nodeVersion",
+						"optimisticRepeatInstall",
+						"packageManagerStrict",
+						"packageManagerStrictVersion",
+						"preferSymlinkedExecutables",
+						"preferWorkspacePackages",
+						"publicHoistPattern",
+						"registrySupportsTimeField",
+						"requiredScripts",
+						"resolutionMode",
+						"savePrefix",
+						"scriptShell",
+						"shamefullyHoist",
+						"shellEmulator",
+						"stateDir",
+						"supportedArchitectures",
+						"symlink",
+						"tag",
+						"trustPolicy",
+						"trustPolicyExclude",
+						"updateNotifier",
+						"packages",
+						"overrides",
+						"patchedDependencies",
+						"catalog",
+						"catalogs",
+						"allowedDeprecatedVersions",
+						"allowNonAppliedPatches",
+						"configDependencies",
+						"ignoredBuiltDependencies",
+						"ignoredOptionalDependencies",
+						"neverBuiltDependencies",
+						"onlyBuiltDependencies",
+						"onlyBuiltDependenciesFile",
+						"packageExtensions",
+						"peerDependencyRules"
+					],
+					pathPattern: "^$"
+				},
+				{
+					order: { type: "asc" },
+					pathPattern: ".*"
+				}
+			] }
+		}
+	];
+}
+//#endregion
 //#region src/factory.ts
 /**
 * Factory to create a flat ESLint config.
@@ -994,11 +1410,14 @@ function factory(options = {}) {
 		markdown,
 		node,
 		perfectionist,
+		pnpm,
 		stylistic,
 		tailwind,
+		test,
 		typescript,
 		unicorn,
-		vue
+		vue,
+		yaml
 	};
 	for (const [key, configFunction] of Object.entries(configFunctions)) {
 		const configOption = options[key];
@@ -1011,9 +1430,11 @@ function factory(options = {}) {
 		"better-tailwindcss": "tailwind",
 		"import-lite": "import",
 		"markdown": "md",
-		"n": "node"
+		"n": "node",
+		"vitest": "test",
+		"yml": "yaml"
 	});
 	return composer;
 }
 //#endregion
-export { factory, importModule };
+export { codeInMdGlob, extractRules, factory, ignoresGlob, importModule, jsGlob, json5Glob, jsonGlob, jsoncGlob, mdGlob, mdInMdGlob, packageJsonGlob, pnpmWorkspaceGlob, scriptsGlob, testsGlob, tsConfigGlob, tsGlob, vueGlob, yamlGlob };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@favorodera/eslint-config",
   "type": "module",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "private": false,
   "description": "Opinionated, type-safe flat ESLint configuration factory for Vue, TypeScript, Tailwind, and more.",
   "author": "Favour Emeka <favorodera@gmail.com>",
@@ -51,6 +51,7 @@
     "@eslint/js": "^10.0.1",
     "@eslint/markdown": "^8.0.2",
     "@stylistic/eslint-plugin": "^5.10.0",
+    "@vitest/eslint-plugin": "^1.6.19",
     "defu": "^6.1.7",
     "eslint-flat-config-utils": "^3.2.0",
     "eslint-merge-processors": "^2.0.0",
@@ -60,17 +61,21 @@
     "eslint-plugin-jsonc": "^3.2.0",
     "eslint-plugin-n": "^18.1.0",
     "eslint-plugin-perfectionist": "^5.9.0",
+    "eslint-plugin-pnpm": "^1.6.1",
     "eslint-plugin-unicorn": "^65.0.1",
     "eslint-plugin-unused-imports": "^4.4.1",
     "eslint-plugin-vue": "^10.9.2",
+    "eslint-plugin-yml": "^3.4.0",
     "eslint-processor-vue-blocks": "^2.0.0",
     "globals": "^17.6.0",
     "typescript-eslint": "^8.60.1",
-    "vue-eslint-parser": "^10.4.1"
+    "vue-eslint-parser": "^10.4.1",
+    "yaml-eslint-parser": "^2.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",
     "@typescript/native-preview": "7.0.0-dev.20260509.2",
+    "@vitest/ui": "4.1.8",
     "concurrently": "^10.0.3",
     "eslint": "^10.4.1",
     "eslint-typegen": "^2.3.1",
@@ -87,6 +92,7 @@
     "build": "tsdown",
     "dev": "pnpm prebuild && concurrently \"tsdown --watch\" \"pnpm dev:inspector\"",
     "test": "vitest run",
+    "test:watch": "vitest --watch --ui",
     "typecheck": "tsc --noEmit",
     "lint": "eslint . --fix",
     "ready": "pnpm install && pnpm build && pnpm lint && pnpm typecheck && pnpm test"