@unshared/eslint-config 0.0.19 → 0.1.0

package/dist/index.cjs

@@ -1,180 +1,87 @@
 "use strict";
-var pluginAntfu = require("eslint-plugin-antfu"), eslintCommentsPlugin = require("eslint-plugin-eslint-comments"), pluginJsdoc = require("eslint-plugin-jsdoc"), jsonc = require("eslint-plugin-jsonc"), nodePlugin = require("eslint-plugin-n"), pluginSonarjs = require("eslint-plugin-sonarjs"), javascript = require("@eslint/js"), stylistic = require("@stylistic/eslint-plugin"), toArray = require("@unshared/collection/toArray"), perfectionist = require("eslint-plugin-perfectionist"), node_process = require("node:process"), tslint = require("typescript-eslint"), unicornPlugin = require("eslint-plugin-unicorn"), vitestPlugin = require("eslint-plugin-vitest"), eslintMergeProcessors = require("eslint-merge-processors"), vuePlugin = require("eslint-plugin-vue"), vueProcessorBlocks = require("eslint-processor-vue-blocks"), vueParser = require("vue-eslint-parser");
-function antfu(options) {
+var pluginAntfu = require("eslint-plugin-antfu"), eslintCommentsPlugin = require("eslint-plugin-eslint-comments"), pluginJsdoc = require("eslint-plugin-jsdoc"), pluginJsonc = require("eslint-plugin-jsonc"), nodePlugin = require("eslint-plugin-n"), pluginSonarjs = require("eslint-plugin-sonarjs"), javascript = require("@eslint/js"), stylistic = require("@stylistic/eslint-plugin"), toArray = require("@unshared/collection/toArray"), perfectionist = require("eslint-plugin-perfectionist"), tslint = require("typescript-eslint"), unicornPlugin = require("eslint-plugin-unicorn"), vitestPlugin = require("@vitest/eslint-plugin"), eslintMergeProcessors = require("eslint-merge-processors"), vuePlugin = require("eslint-plugin-vue"), vueProcessorBlocks = require("eslint-processor-vue-blocks"), vueParser = require("vue-eslint-parser"), pluginYml = require("eslint-plugin-yml");
+function antfu() {
   return [
     {
       plugins: {
         antfu: pluginAntfu
       },
       rules: {
+        // --- Enforce consistent line breaks for chaining member access.
+        "antfu/consistent-chaining": "error",
+        // --- Enforce consistent line breaks inside braces of object/array/named imports/exports and function parameters.
         "antfu/consistent-list-newline": "error",
-        /**
-         * Auto-fix import duplication. The TypeScript compiler already detects and removes
-         * duplicate imports, but this rule can be used to fix the issue automatically in the editor.
-         *
-         * @see https://github.com/antfu/eslint-plugin-antfu/blob/main/src/rules/import-dedupe.md
-         */
+        // --- Deduplicate imports.
         "antfu/import-dedupe": "error",
-        /**
-         * Enforce top-level function to be declared using function instead of arrow function. This
-         * rule helps when you want to add additional overload signatures to a function without
-         * having to transform the arrow function into a function declaration manually.
-         *
-         * On top of that, it mitigates the risk of accidentally using the `this` instance from
-         * an outer scope.
-         *
-         * @see https://github.com/antfu/eslint-plugin-antfu/blob/main/src/rules/top-level-function.md
-         */
-        "antfu/top-level-function": "error",
-        /**
-         * Enforce consistent line breaks inside braces of object/array/named imports/exports and
-         * function parameters. Reduces the cognitive load of reasoning about code style.
-         *
-         * @see https://github.com/antfu/eslint-plugin-antfu/blob/main/src/rules/consistent-list-newline.md
-         */
-        "object-curly-newline": "off",
-        /** User-defined rules */
-        ...options.rules
+        // --- Avoid importing from 'dist' directories.
+        "antfu/no-import-dist": "error",
+        // --- Enforce `export default` insteand of `export = {}`.
+        "antfu/no-ts-export-equal": "error",
+        // --- Enforce `function()` instead of `() => {}` for top-level functions.
+        "antfu/top-level-function": "error"
       }
     }
   ];
 }
-function eslintComments(options) {
+function eslintComments() {
   return [
     {
       plugins: {
         "eslint-comments": eslintCommentsPlugin
       },
       rules: {
-        /**
-         * Allow multiple rules directive in a single comment. This
-         * reduces the number of comments in the code.
-         *
-         * @see https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/disable-enable-pair
-         */
+        // --- Allow disable without having to enable again.
         "eslint-comments/disable-enable-pair": "off",
-        /**
-         * `eslint-enable` directive-comments can enable rules which are disabled by different
-         * eslint-disable directive-comments. It can enable a rule unintentionally. This rule
-         * will report such cases.
-         *
-         * @see https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/no-aggregating-enable
-         */
+        // --- Disallow eslint-disable comments without rule names. This ensures that we cannot
         "eslint-comments/no-aggregating-enable": "error",
-        /**
-         * Disallow duplicate eslint-disable comments. This rule will report when there are
-         * multiple eslint-disable comments for the same rule, either in the same line or enabled
-         * by different eslint-disable comments.
-         *
-         * @see https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/no-duplicate-disable
-         */
-        "eslint-comments/no-duplicate-disable": "error",
-        /**
-         * Disallow eslint-disable comments without rule names. This ensures that we cannot
-         * disable all rules in a file using eslint-disable comment.
-         *
-         * @see https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/no-unlimited-disable
-         */
+        // --- Disable must specify rule names.
         "eslint-comments/no-unlimited-disable": "error",
-        /**
-         * Errors when an eslint-disable comment has no effect. This is useful
-         * to prevent unnecessary comments in the code.
-         *
-         * @see https://mysticatea.github.io/eslint-plugin-eslint-comments/rules/no-unused-disable
-         */
+        // --- Prevent superfluous eslint comments.
+        "eslint-comments/no-duplicate-disable": "error",
         "eslint-comments/no-unused-disable": "error",
-        /** User-defined rules */
-        ...options.rules
+        "eslint-comments/no-unused-enable": "error"
       }
     }
   ];
 }
-function jsdoc(options) {
+function jsdoc() {
   return [
-    pluginJsdoc.configs["flat/recommended-typescript-flavor-error"],
+    pluginJsdoc.configs["flat/recommended-typescript-error"],
     {
       files: [
         "**/*.{ts,mts,cts,tsx,d.ts}",
         "**/*.{js,mjs,cjs,jsx}",
         "**/*.vue"
       ],
+      plugins: {
+        jsdoc: pluginJsdoc
+      },
       rules: {
-        /**
-         * Enforce a consistent padding of the block description.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/HEAD/docs/rules/check-alignment.md#readme
-         */
-        "jsdoc/check-alignment": "error",
-        /**
-         * Normalize the indentation in the JSdoc comment to improve readability.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/check-indentation.md#readme
-         */
-        "jsdoc/check-indentation": "error",
-        /**
-         * Enforce a strict set of tags for the JSDoc comment. This rule also includes
-         * some custom tags that are used in our projects.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/.README/rules/check-tag-names.md
-         */
+        // --- Redudant with TypeScript.
         "jsdoc/require-jsdoc": "off",
         "jsdoc/require-param-type": "off",
-        "jsdoc/check-tag-names": ["error", {
-          definedTags: [
-            "category"
-          ]
-        }],
-        /**
-         * Checks for multi-line-style comments which fail to meet the criteria of a jsdoc block,
-         * namely that it should begin with two and only two asterisks.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/no-bad-blocks.md
-         */
+        "jsdoc/require-returns-type": "off",
+        // --- Reports malformed JSDoc comments.
         "jsdoc/no-bad-blocks": "error",
-        /**
-         * It is common practice to prefix a hyphen to parameters in JSDoc. But this
-         * is sometimes forgotten and has no real purpose. This rule aims to enforce
-         * that no hyphen is used.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-hyphen-before-param-description
-         */
+        "jsdoc/check-alignment": "error",
+        "jsdoc/check-indentation": "error",
+        // --- Reports invalid block tag names.
+        "jsdoc/check-tag-names": ["error", { definedTags: ["category"] }],
+        // --- Do not use hyphens before param descriptions.
         "jsdoc/require-hyphen-before-param-description": ["error", "never"],
-        /**
-         * Since we are using TypeScript, we don't need to enforce types in JSDoc.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-param-type.md
-         */
-        "jsdoc/require-returns-type": "off",
-        /**
-         * Enforce a new-line between the JSDoc summary and tags. Aims to improve
-         * readability by separating the summary and tags.
-         *
-         * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/tag-lines.md
-         */
-        "jsdoc/tag-lines": ["error", "any", { startLines: 1 }],
-        /** User-defined rules */
-        ...options.rules
+        // --- Newline after description.
+        "jsdoc/tag-lines": ["error", "any", { startLines: 1 }]
       }
     }
   ];
 }
-function configJson(options) {
+function json() {
   return [
-    ...jsonc.configs["flat/recommended-with-json"],
+    ...pluginJsonc.configs["flat/recommended-with-json"],
     {
-      files: [
-        "**/*.json",
-        "**/*.json5"
-      ],
       rules: {
-        /**
-         * Automatically apply jsonc rules similar to your configured ESLint core rules to JSON.
-         *
-         * @see https://ota-meshi.github.io/eslint-plugin-jsonc/rules/auto.html
-         */
-        "jsonc/auto": "error",
-        /** User-defined rules */
-        ...options.rules
+        // --- Automatically apply jsonc rules similar to your configured ESLint core rules to JSON.
+        "jsonc/auto": "error"
       }
     }
   ];
@@ -381,106 +288,89 @@ function jsonTsconfig() {
     }
   ];
 }
-function node(options) {
+function node() {
   return [
+    nodePlugin.configs["flat/recommended"],
     {
-      plugins: {
-        n: nodePlugin
+      settings: {
+        node: {
+          version: ">=20.0.0"
+        }
       },
       rules: {
-        ...nodePlugin.configs.recommended.rules,
-        /**
-         * Disallow the use of extraneous imports. This rule helps prevent the
-         * use of third-party modules that are not listed in the project's
-         * dependencies.
-         *
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/no-extraneous-import.md
-         */
-        "n/no-extraneous-import": "error",
-        /**
-         * Disable the no-missing-import as module resolution is already checked
-         * by other tools and IDEs extensively. This rule is redundant.
-         *
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/no-missing-import.md
-         */
+        // --- Redundant with TypeScript module resolution.
         "n/no-missing-import": "off",
         "n/no-missing-require": "off",
         "n/no-unpublished-import": "off",
-        /**
-         * Enfore the use of the asyncrounous version of the `fs` and `dns` APIs.
-         *
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/no-sync.md
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/prefer-promises/fs.md
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/prefer-promises/dns.md
-         */
-        "n/no-sync": "off",
-        "n/prefer-promises/fs": "error",
-        "n/prefer-promises/dns": "error",
-        /**
-         * Allow the use of features up to Node.js version 20. This will allow
-         * the use of newer ECMAScript features and Node.js APIs.
-         *
-         * @see https://github.com/eslint-community/eslint-plugin-n/tree/master/docs/rules
-         */
+        // --- Enforce async functions over synchronous functions.
+        "n/no-sync": ["error", { allowAtRootLevel: !0 }],
+        // --- Enforce the use of ECMAScript features.
         "n/no-unsupported-features/es-syntax": "error",
         "n/no-unsupported-features/es-builtins": "error",
-        "n/no-unsupported-features/node-builtins": "error",
-        /**
-         * Prepend the `node:` prefix to all Node.js core modules. This helps
-         * identify the module as a Node.js core module and not a third-party
-         * module.
-         *
-         * @see https://github.com/eslint-community/eslint-plugin-n/blob/HEAD/docs/rules/prefer-node-protocol.md
-         */
+        // --- Ignore experimental warnings.
+        "n/no-unsupported-features/node-builtins": "off",
+        // --- Prefer the use of global objects over built-in modules.
+        "n/prefer-global/buffer": "error",
+        "n/prefer-global/console": "error",
+        "n/prefer-global/process": "error",
+        "n/prefer-global/text-decoder": "error",
+        "n/prefer-global/text-encoder": "error",
+        "n/prefer-global/url": "error",
+        "n/prefer-global/url-search-params": "error",
+        // --- Prefer the use of the `node:` protocol for built-in modules.
         "n/prefer-node-protocol": "error",
-        /** User-defined rules */
-        ...options.rules
-      },
-      settings: {
-        node: {
-          version: ">=22.1.0"
-        }
+        // --- Prefer the use of promises over callbacks.
+        "n/prefer-promises/fs": "error",
+        "n/prefer-promises/dns": "error"
+      }
+    },
+    {
+      files: [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      rules: {
+        // --- Disable the no-sync rule for tests.
+        "n/no-sync": "off"
       }
     }
   ];
 }
-function sonarjs(options) {
+function sonarjs() {
   return [
     pluginSonarjs.configs.recommended,
     {
       rules: {
-        /**
-         * Cognitive Complexity is a measure of how hard the control flow of a function
-         * is to understand. Functions with high Cognitive Complexity will be difficult
-         * to maintain.
-         *
-         * @see https://github.com/SonarSource/eslint-plugin-sonarjs/blob/master/docs/rules/cognitive-complexity.md
-         */
+        // --- Increase the default threshold to 30.
         "sonarjs/cognitive-complexity": ["error", 30],
-        /**
-         * Duplicated string literals make the process of refactoring error-prone,
-         * since you must be sure to update all occurrences. On the other hand,
-         * constants can be referenced from many places, but only need to be
-         * updated in a single place.
-         *
-         * @see https://github.com/SonarSource/eslint-plugin-sonarjs/blob/master/docs/rules/no-duplicate-string.md
-         */
-        "sonarjs/no-duplicate-string": ["error", {
-          threshold: 10
-        }],
-        /**
-         * Those rules are crashing ESLint at startup, so they are disabled for now.
-         */
-        "sonarjs/no-empty-collection": "off",
-        "sonarjs/no-extra-arguments": "off",
-        "sonarjs/no-gratuitous-expressions": "off",
-        "sonarjs/no-one-iteration-loop": "off",
-        "sonarjs/no-redundant-jump": "off",
-        "sonarjs/no-unused-collection": "off",
+        // --- Increase the default threshold to 10.
+        "sonarjs/no-duplicate-string": ["error", { threshold: 10 }],
+        // --- Disable unnecessary rules.
+        "sonarjs/use-type-alias": "off",
         "sonarjs/no-use-of-empty-return-value": "off",
-        "sonarjs/prefer-immediate-return": "off",
-        /** User-defined rules */
-        ...options.rules
+        "sonarjs/no-nested-functions": "off",
+        // --- Disable rules that are already covered by TypeScript.
+        "sonarjs/no-extra-arguments": "off",
+        "sonarjs/function-return-type": "off",
+        "sonarjs/no-misused-promises": "off",
+        "sonarjs/no-invariant-returns": "off",
+        "sonarjs/no-unused-expressions": "off",
+        "sonarjs/different-types-comparison": "off",
+        // --- Allow control characters in regex.
+        "sonarjs/sonar-no-control-regex": "off"
+      }
+    },
+    {
+      files: [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      rules: {
+        // --- Disable unnecessary rules for test files.
+        "sonarjs/cognitive-complexity": "off",
+        "sonarjs/no-duplicate-string": "off",
+        "sonarjs/no-useless-constructor": "off",
+        "sonarjs/public-static-readonly": "off"
       }
     }
   ];
@@ -492,6 +382,7 @@ function getConfigRules(config) {
 function typescript(options) {
   return [
     javascript.configs.recommended,
+    // stylistic.configs['recommended-flat'],
     {
       languageOptions: {
         // @ts-expect-error: ignore
@@ -500,7 +391,7 @@ function typescript(options) {
           ecmaVersion: "latest",
           sourceType: "module",
           project: toArray.toArray(options.tsConfigPath ?? "./tsconfig.json"),
-          tsconfigRootDir: node_process.cwd()
+          tsconfigRootDir: process.cwd()
         }
       },
       plugins: {
@@ -510,7 +401,8 @@ function typescript(options) {
       },
       files: [
         "**/*.{ts,tsx,cts,mts}",
-        "**/*.{js,jsx,cjs,mjs}"
+        "**/*.{js,jsx,cjs,mjs}",
+        "**/*.vue"
       ],
       rules: {
         /**
@@ -519,25 +411,11 @@ function typescript(options) {
          */
         ...getConfigRules(tslint.configs.recommendedTypeChecked),
         ...getConfigRules(tslint.configs.stylisticTypeChecked),
-        /**
-         * Age-old debate over how to style braces. This rule aims to reduce the
-         * cognitive load of reasoning about code by enforcing a consistent style.
-         *
-         * @see https://eslint.style/rules/default/brace-style
-         */
+        // --- Enforce stroustrup brace style.
         "brace-style": "off",
         "@typescript-eslint/brace-style": "off",
-        "@stylistic/brace-style": ["error", "stroustrup", {
-          allowSingleLine: !0
-        }],
-        /**
-         * Enforce an indent of 2 spaces. Aims to reduce visual noise and maintain
-         * readability of code when viewed on GitHub or GitLab.
-         *
-         * @see https://eslint.style/rules/default/no-tabs
-         * @see https://eslint.style/rules/default/indent
-         * @see https://eslint.style/rules/default/indent-binary-ops
-         */
+        "@stylistic/brace-style": ["error", "stroustrup", { allowSingleLine: !0 }],
+        // --- Enforce 2 spaces for indentation and disallow tabs.
         "no-tabs": "off",
         indent: "off",
         "indent-binary-ops": "off",
@@ -547,67 +425,24 @@ function typescript(options) {
         "@stylistic/no-tabs": "error",
         "@stylistic/indent": ["error", 2],
         "@stylistic/indent-binary-ops": ["error", 2],
-        /**
-         * Enforce no semi-colons. This rule aims to maintain consistency around the
-         * use or omission of trailing semicolons. Helps reduce the visual noise in
-         * the codebase. Also helps to prevent errors when refactoring and adding
-         * new lines.
-         *
-         * @see https://eslint.style/rules/default/semi
-         */
+        // --- No semicolons.
         semi: "off",
         "@typescript-eslint/semi": "off",
         "@stylistic/semi": ["error", "never"],
-        /**
-         * Enforce a consistent linebreak style and ensure no leading line breaks
-         * and a single trailing line break. This rule aims to maintain consistency
-         * around the use of line breaks in the codebase and reduce the amount of
-         * diff churn when making changes.
-         *
-         * @see https://eslint.style/rules/default/linebreak-style
-         */
+        // --- Consistent line breaks.
         "eol-last": "off",
         "no-multiple-empty-lines": "off",
         "@stylistic/eol-last": ["error", "always"],
-        "@stylistic/no-multiple-empty-lines": ["error", {
-          max: 1,
-          maxBOF: 0,
-          maxEOF: 0
-        }],
-        /**
-         * Enforce a trailing comma after the last element or property in a multiline
-         * list of properties or elements. This rule improves the clarity of diffs
-         * when an item is added or removed from an object or array.
-         *
-         * @see https://eslint.style/rules/default/comma-dangle
-         * @see https://eslint.style/rules/default/comma-spacing
-         */
+        "@stylistic/no-multiple-empty-lines": ["error", { max: 1, maxBOF: 0, maxEOF: 0 }],
+        // --- Enforce dangling commas in multiline object literals.
         "comma-dangle": "off",
         "@typescript-eslint/comma-dangle": "off",
         "@stylistic/comma-dangle": ["error", "always-multiline"],
-        /**
-         * This rule requires empty lines before and/or after comments. It is disabled
-         * however when in an object literal, array, or type literal.
-         *
-         * @see https://eslint.style/rules/default/lines-around-comment
-         */
-        /**
-         * Normalize type declaration and definition. This reduces the cognitive load
-         * of reasoning about code by enforcing a consistent style.
-         *
-         * @see https://typescript-eslint.io/rules/consistent-indexed-object-style
-         */
+        // --- Enforce type interfaces over type aliases.
         "@typescript-eslint/consistent-indexed-object-style": ["error", "record"],
         "@typescript-eslint/consistent-type-definitions": ["error", "interface"],
         "@typescript-eslint/array-type": ["error", { default: "array-simple", readonly: "array-simple" }],
-        /**
-         * Enforce sequential declarations in the same block. This rule aims to
-         * enforce a top to bottom ordering of variable and type declarations.
-         * This reduces the likelihood of a developer skipping over a declaration
-         * when modifying code.
-         *
-         * @see https://typescript-eslint.io/rules/no-use-before-define
-         */
+        // --- Enforce declaration and usage from top to bottom.
         "no-use-before-define": "off",
         "@typescript-eslint/no-use-before-define": ["error", {
           enums: !0,
@@ -617,17 +452,7 @@ function typescript(options) {
           functions: !1,
           ignoreTypeReferences: !0
         }],
-        /**
-         * Enforce a consistent spacing around various places where spaces are optional.
-         * This rule aims to maintain consistency around the use of spaces in the codebase
-         * and reduce the amount of diff churn when making changes.
-         *
-         * @see https://eslint.style/rules/default/key-spacing
-         * @see https://eslint.style/rules/default/comma-spacing
-         * @see https://eslint.style/rules/default/block-spacing
-         * @see https://eslint.style/rules/default/arrow-spacing
-         * @see https://eslint.style/rules/default/object-curly-spacing
-         */
+        // --- Consistent spacing and line breaks between tokens.
         "key-spacing": "off",
         "comma-spacing": "off",
         "block-spacing": "off",
@@ -697,15 +522,7 @@ function typescript(options) {
             returnType: { before: !1, after: !0 }
           }
         }],
-        /**
-         * Enforce the use of `@ts-expect-error` over `@ts-ignore` to silence TypeScript
-         * errors. This rule aims to ensure that TypeScript errors are never silenced
-         * without explanation or justification. When an error is fixed, the
-         * `@ts-expect-error` forces the developer to remove the comment.
-         *
-         * @see https://typescript-eslint.io/rules/prefer-ts-expect-error
-         * @see https://typescript-eslint.io/rules/ban-ts-comment
-         */
+        // --- Enforce `@ts-expect-error` over `@ts-ignore`.
         "@typescript-eslint/prefer-ts-expect-error": "error",
         "@typescript-eslint/ban-ts-comment": ["error", {
           "ts-check": !1,
@@ -870,93 +687,32 @@ function typescript(options) {
     }
   ];
 }
-const UNICORN_RECOMMENDED_RULES = unicornPlugin.configs.recommended.rules;
-function unicorn(options) {
+function unicorn() {
   return [
+    unicornPlugin.configs["flat/recommended"],
     {
-      plugins: {
-        unicorn: unicornPlugin
-      },
       rules: {
-        ...UNICORN_RECOMMENDED_RULES,
-        /**
-         * Improve regexes by making them shorter, consistent, and safer. This rule
-         * aims to improve readability and consistency of regexes while also
-         * mitigating regex denial of service attacks by disallowing potentially
-         * catastrophic backtracking.
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/better-regex.md
-         */
+        // --- Allow any kind of import style.
+        "unicorn/import-style": "off",
+        // --- Improve regexes by making them shorter, consistent, and safer.
         "unicorn/better-regex": "error",
-        /**
-         * Enforce the catch clause parameter name to be named `error`. This rule
-         * aims to enforce a consistent parameter name in catch clauses. The name
-         * `error` is the most commonly used name for the parameter that is passed
-         * to the catch clause.
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/catch-error-name.md
-         */
-        "unicorn/catch-error-name": ["error", {
-          name: "error"
-        }],
-        /**
-         * Enforce the use of camelCase or PascalCase when naming folders, files and
-         * variables. This rule aims to enforce a consistent naming convention for
-         * filenames, directory names, and variable names.
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/filename-case.md
-         */
+        // --- Use destructured variables over properties.
+        "unicorn/consistent-destructuring": "error",
+        // --- Enforce consistent function scoping except for arrow functions.
+        "unicorn/consistent-function-scoping": ["error", { checkArrowFunctions: !1 }],
+        // --- Disable switch-case fallthrough.
+        "unicorn/prefer-switch": "off",
+        // --- Enforce camelCase & PascalCase in filenames. Exepct non TS/JS files.
         "unicorn/filename-case": ["error", {
-          cases: {
-            camelCase: !0,
-            pascalCase: !0
-          },
-          ignore: [
-            "^[A-Z]+(.md)?$"
-          ]
+          multipleFileExtensions: !1,
+          cases: { camelCase: !0, pascalCase: !0 },
+          ignore: [/\.json$/, /\.md$/, /\.yml$/, /\.yaml$/]
         }],
-        /**
-         * Disable the recommended import style rules. We want to be able to use both
-         * named and default imports in our codebase.
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/import-style.md
-         */
-        "unicorn/import-style": "off",
-        /**
-         * Disallow unsafe regular expressions. Regular expressions can be unsafe
-         * when they are too complex and can cause catastrophic backtracking. This
-         * rule disallows regular expressions that can lead to catastrophic
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/no-unsafe-regex.md
-         */
-        "unicorn/no-unsafe-regex": "error",
-        /**
-         * Enforces a convention of grouping digits using numeric separators.
-         * Long numbers can become really hard to read, so cutting it into groups
-         * of digits, separated with a _, is important to keep your code clear.
-         *
-         * @see https://github.com/sindresorhus/eslint-plugin-unicorn/blob/main/docs/rules/numeric-separators-style.md
-         */
+        // --- Improve readability by using numeric separators.
         "unicorn/numeric-separators-style": ["error", {
           onlyIfContainsSeparator: !0
         }],
-        "unicorn/number-literal-case": "error",
-        "unicorn/consistent-function-scoping": "off",
-        "unicorn/error-message": "error",
-        "unicorn/escape-case": "error",
-        "unicorn/no-array-callback-reference": "off",
-        "unicorn/no-array-for-each": "off",
-        "unicorn/no-array-instanceof": "error",
-        "unicorn/no-new-buffer": "error",
-        "unicorn/no-static-only-class": "off",
-        "unicorn/prefer-code-point": "off",
-        "unicorn/prefer-exponentiation-operator": "error",
-        "unicorn/prefer-includes": "error",
-        "unicorn/prefer-module": "off",
-        "unicorn/prefer-starts-ends-with": "error",
-        "unicorn/prefer-switch": "off",
-        "unicorn/prefer-text-content": "error",
-        "unicorn/prefer-type-error": "error",
+        // --- Enforce long variable names when they are meaningful.
         "unicorn/prevent-abbreviations": ["error", {
           allowList: {
             args: !0,
@@ -974,110 +730,50 @@ function unicorn(options) {
             y: !0,
             z: !0
           }
-        }],
-        "unicorn/throw-new-error": "error"
-      },
-      /** User-defined rules */
-      ...options.rules
+        }]
+      }
+    },
+    {
+      files: [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      rules: {
+        // --- Disable unnecessary rules for test files.
+        "unicorn/no-null": "off",
+        "unicorn/no-useless-undefined": "off",
+        "unicorn/no-static-only-class": "off"
+      }
     }
   ];
 }
-function vitest(options) {
+function vitest() {
   return [
+    vitestPlugin.configs.recommended,
     {
-      plugins: {
-        vitest: vitestPlugin
-      },
-      files: [
-        "**/*.{ts,mts,cts,tsx,d.ts}",
-        "**/*.{js,mjs,cjs,jsx}"
-      ],
-      settings: {
-        vitest: {
-          typecheck: !0
-        }
-      },
-      languageOptions: {
-        globals: {
-          ...vitestPlugin.environments.env.globals,
-          expectTypeOf: !0
-        }
-      },
       rules: {
-        /**
-         * Inject all configuration from eslint-plugin-vitest.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/tree/main?tab=readme-ov-file#rules
-         */
-        ...vitestPlugin.configs.all.rules,
-        /**
-         * This rule aims to enforce having at least one expectation
-         * in test body to ensure that the test is actually testing something.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/expect-expect.md
-         */
+        // --- Add the `expectTypeOf` function to the list of assert functions.
         "vitest/expect-expect": ["error", {
-          assertFunctionNames: [
-            "expect",
-            "expectTypeOf"
-          ]
+          assertFunctionNames: ["expect", "expectTypeOf"]
         }],
-        /**
-         * Disable the conditional test rule as it is prevent's us to use in-source
-         * testing when using the `if (import.meta.vitest)` condition. Also disable
-         * the rule that prevents the use of if-else statements in tests as we want
-         * to use it to test type predicates.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-in-test.md
-         */
-        "vitest/no-conditional-in-test": "off",
-        "vitest/no-conditional-tests": "off",
-        /**
-         * Since we use in-source testing, we need to disable the rule as it may prevent
-         * us from using top level evaluation that are not part of the test suite.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/no-hooks.md
-         */
-        "vitest/require-hook": "off",
-        "vitest/no-hooks": "off",
-        /**
-         * Disable the rule that enforces the use of `expect.assertions` in tests.
-         * As much as this rule enforces a best-practice, it is not always necessary.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/prefer-expect-assertions.md
-         */
-        "vitest/prefer-expect-assertions": "off",
-        /**
-         * Some functions may have a single test case, and it is not necessary
-         * to wrap them in a describe block.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/require-top-level-describe.md
-         */
-        "vitest/require-top-level-describe": "off",
-        /**
-         * Enforce rule titles starts with 'should'. This is a convention
-         * to force the developer to write the test in a way that it reads
-         * like a sentence.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/valid-title.md
-         */
+        // --- Enforce a single top-level describe block.
+        "vitest/require-top-level-describe": ["error", { maxNumberOfTopLevelDescribes: 1 }],
+        // --- Enforce 'should' as the prefix for test titles.
         "vitest/valid-title": ["error", {
           ignoreTypeOfDescribeName: !0,
-          mustMatch: {
-            test: ["^should"]
-          }
+          mustMatch: { test: ["^should"] }
         }],
-        /**
-         * Disable the prefer-truthy/false rule as we want to allow the use of strict equality checks
-         * with boolean values.
-         *
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-be-truthy.md
-         * @see https://github.com/veritem/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-be-falsy.md
-         */
+        // --- Prefer strict equality checks.
         "vitest/prefer-to-be-truthy": "off",
         "vitest/prefer-to-be-falsy": "off",
-        /** User-defined rules */
-        ...options.rules
+        /// --- Loosen the rules for test files.
+        "vitest/no-hooks": "off",
+        "vitest/require-hook": "off",
+        "vitest/no-conditional-in-test": "off",
+        "vitest/no-conditional-tests": "off",
+        "vitest/prefer-expect-assertions": "off",
+        "vitest/padding-around-all": "off",
+        "vitest/padding-around-expect-groups": "off"
       }
     }
   ];
@@ -1085,7 +781,7 @@ function vitest(options) {
 function vue(options) {
   const TYPESCRIPT_CONFIG = typescript(options).at(1);
   return [
-    ...vuePlugin.configs?.["flat/base"],
+    ...vuePlugin.configs["flat/recommended"],
     {
       plugins: {
         vue: vuePlugin,
@@ -1116,109 +812,48 @@ function vue(options) {
         }
       },
       processor: eslintMergeProcessors.mergeProcessors([
-        // @ts-expect-error: ignore
-        vuePlugin.processors[".vue"],
+        vuePlugin.processors.vue,
         vueProcessorBlocks()
       ]),
       files: [
-        "**/*.vue"
+        "**/*.vue",
+        "**/*.ts"
       ],
       rules: {
-        ...TYPESCRIPT_CONFIG.rules,
-        // @ts-expect-error: ignore
-        ...vuePlugin.configs["flat/recommended"].rules,
-        // @ts-expect-error: ignore
-        ...vuePlugin.configs["flat/strongly-recommended"].rules,
-        // @ts-expect-error: ignore
-        ...vuePlugin.configs["flat/essential"].rules,
-        /**
-         * Disable some TypeScript rules that may conflict with the Vue SFC parser.
-         */
-        "@typescript-eslint/no-unsafe-call": "off",
-        "@typescript-eslint/no-unsafe-return": "off",
-        "@typescript-eslint/no-misused-promises": "off",
-        "@typescript-eslint/no-unsafe-assignment": "off",
-        "@typescript-eslint/no-unsafe-member-access": "off",
-        /**
-         * Enforces consistent usage of type imports. This rule will enforce the use
-         * of `type` imports to make it easier for the Vue SFC compiler to analyze
-         * the code and infer the dependency graph correctly.
-         *
-         * @see https://typescript-eslint.io/rules/consistent-type-imports
-         * @see https://vuejs.github.io/vetur/guide/FAQ.html#why-does-vetur-show-cannot-find-module-xxx
-         */
-        // '@typescript-eslint/consistent-type-imports': ['error', {
-        //   disallowTypeAnnotations: false,
-        //   fixStyle: 'inline-type-imports',
-        //   prefer: 'type-imports',
-        // }],
-        /**
-         * Enforce the order of the top-level properties in the component. This rule
-         * helps to maintain consistency and readability by enforcing a predictable
-         * order of the top-level properties in the component.
-         *
-         * @see https://eslint.vuejs.org/rules/ordered-component-elements.html
-         */
-        "vue/block-order": ["error", {
-          order: [
-            "docs",
-            "script",
-            "template",
-            "style"
-          ]
-        }],
-        /**
-         * Enforce use of the Composition API and TypeScript. This rule forbids the
-         * use of the Options API and JavaScript in Vue components for better
-         * consistency and maintainability.
-         *
-         * @see https://eslint.vuejs.org/rules/vue/prefer-define-options.html
-         * @see https://eslint.vuejs.org/rules/vue/component-api-style.html
-         */
+        "vue/return-in-computed-property": "off",
+        // --- Allow multiple component definitions in a single file.
+        "vue/one-component-per-file": "off",
+        // --- Enforce Component API style.
         "vue/prefer-define-options": "error",
-        "vue/component-api-style": ["error", ["script-setup"]],
-        /**
-         * Enforce the component name casing to be PascalCase. This rules helps identify
-         * and distinguish between components and HTML elements. It also helps to avoid
-         * conflicts with existing and future HTML elements.
-         *
-         * @see https://eslint.vuejs.org/rules/component-name-in-template-casing.html
-         */
+        "vue/component-api-style": ["error", ["script-setup", "composition"]],
+        // --- Enforce PascalCase components and allow reserved and single-word names.
+        "vue/multi-word-component-names": "off",
+        "vue/no-reserved-component-names": "off",
         "vue/component-name-in-template-casing": ["error", "PascalCase", {
           ignores: [String.raw`/\./`],
           registeredComponentsOnly: !1
         }],
-        /**
-         * Enforce consistent spacing between HTML comments and their content.
-         *
-         * @see https://eslint.vuejs.org/rules/html-comment-content-spacing.html
-         * @see https://eslint.vuejs.org/rules/html-comment-content-newline.html
-         */
+        // --- Consistent spacing around HTML comments.
+        "vue/html-comment-indent": ["error", 2],
+        "vue/multiline-html-element-content-newline": ["error", {
+          allowEmptyLines: !0,
+          ignores: [],
+          ignoreWhenEmpty: !0
+        }],
         "vue/html-comment-content-spacing": ["error", "always"],
         "vue/html-comment-content-newline": ["error", {
           multiline: "always",
           singleline: "never"
         }],
-        /**
-         * Enforce consistent spacing between HTML / Component tags. This makes it
-         * easier to read and understand the structure of the component.
-         *
-         * @see https://eslint.vuejs.org/rules/block-spacing.html
-         * @see https://eslint.vuejs.org/rules/padding-line-between-blocks.html
-         * @see https://eslint.vuejs.org/rules/padding-line-between-tags.html
-         */
+        // --- Consistent block order in Vue components.
+        "vue/block-order": ["error", { order: ["script", "template", "style", "i18n"] }],
+        // --- Consistent spacing in and around the block.
         "vue/block-spacing": ["error", "always"],
         "vue/padding-line-between-blocks": ["error", "always"],
         "vue/padding-line-between-tags": ["error", [
           { blankLine: "consistent", next: "*", prev: "*" },
           { blankLine: "always", next: "*", prev: "comment" }
         ]],
-        "vue/html-comment-indent": ["error", 2],
-        "vue/multiline-html-element-content-newline": ["error", {
-          allowEmptyLines: !0,
-          ignores: [],
-          ignoreWhenEmpty: !0
-        }],
         /**
          * Enforce consistent spacing and newlines in the template. This rule helps
          * to maintain consistency and readability by enforcing a predictable
@@ -1247,8 +882,6 @@ function vue(options) {
          *
          * @see https://eslint.vuejs.org/rules/multi-word-component-names.html
          */
-        "vue/multi-word-component-names": "off",
-        "vue/no-reserved-component-names": "off",
         /**
          * Reports the destructuring or member expression of props passed to setup
          * causing the value to lose reactivity. This rule helps to avoid common
@@ -1320,7 +953,6 @@ function vue(options) {
         "vue/block-lang": ["error", {
           script: { lang: "ts" }
         }],
-        "vue/return-in-computed-property": "off",
         "vue/no-sparse-arrays": "error",
         "vue/no-unused-emit-declarations": "error",
         "vue/no-use-v-else-with-v-for": "error",
@@ -1391,34 +1023,89 @@ function vue(options) {
         "vue/space-in-parens": ["error", "never"],
         "vue/space-infix-ops": "error",
         "vue/space-unary-ops": ["error", { nonwords: !1, words: !0 }],
-        "vue/template-curly-spacing": "error",
-        /** User-defined rules */
-        ...options.rules
+        "vue/template-curly-spacing": "error"
+      }
+    },
+    // --- Disable some TypeScript rules that may conflict with the Vue SFC parser.
+    {
+      files: [
+        "**/*.vue"
+      ],
+      rules: {
+        "@typescript-eslint/no-unsafe-call": "off",
+        "@typescript-eslint/no-unsafe-return": "off",
+        "@typescript-eslint/no-unsafe-argument": "off",
+        "@typescript-eslint/no-unsafe-assignment": "off",
+        "@typescript-eslint/no-unsafe-member-access": "off",
+        "@typescript-eslint/no-misused-promises": "off"
+      }
+    },
+    // --- Disable in test files.
+    {
+      files: [
+        "**/*.test.ts",
+        "**/*.spec.ts"
+      ],
+      rules: {
+        "vue/one-component-per-file": "off"
+      }
+    }
+  ];
+}
+function yml() {
+  return [
+    ...pluginYml.configs["flat/standard"],
+    ...pluginYml.configs["flat/recommended"],
+    {
+      rules: {
+        // --- Force single quotes.
+        "yml/quotes": ["error", {
+          avoidEscape: !0,
+          prefer: "single"
+        }],
+        // --- Remove trailing zeros in numbers.
+        "yml/no-trailing-zeros": "error",
+        // --- Prevent empty keys.
+        "yml/require-string-key": "error",
+        // --- Prevent empty values or weird newlines in mappings.
+        "yml/block-mapping-colon-indicator-newline": "error",
+        // --- No more than one empty line.
+        "yml/no-multiple-empty-lines": ["error", {
+          max: 1,
+          maxBOF: 0,
+          maxEOF: 0
+        }],
+        // --- Sort environemnt variables alphabetically.
+        "yml/sort-sequence-values": ["error", {
+          pathPattern: "^env$",
+          order: { type: "asc" }
+        }]
       }
     }
   ];
 }
 function all(options = {}) {
   return [
-    ...antfu(options),
-    ...eslintComments(options),
-    ...jsdoc(options),
-    ...configJson(options),
+    ...antfu(),
+    ...eslintComments(),
+    ...jsdoc(),
+    ...json(),
     ...jsonPackage(),
     ...jsonTsconfig(),
-    ...node(options),
-    ...sonarjs(options),
+    ...node(),
+    ...sonarjs(),
     ...typescript(options),
-    ...unicorn(options),
-    ...vitest(options),
+    ...unicorn(),
+    ...vitest(),
     ...vue(options),
+    ...yml(),
     {
       ignores: [
         "**/dist",
         "**/bin",
         "**/node_modules",
         "**/.nuxt",
-        "**/output",
+        "**/.output",
         "**/coverage",
         "**/public",
         "**/__wip__",