Type Error: `env` property in plugin configs is not assignable to `Config<RulesRecord>` in TypeScript

[antoinezanardi]

Description:

When using @vitest/eslint-plugin in a flat ESLint config with TypeScript, I encounter the following type error:

TS2322: Type '{ meta: { name: string; version: string; }; rules: { ... } }' is not assignable to type 'Plugin'.
  Types of property 'configs' are incompatible.
    Type '{ ...; env: { ... } }' is not assignable to type 'Record<string, Config<RulesRecord> | LegacyConfig<RulesRecord, RulesRecord> | Config<RulesRecord>[]>'.
      Property 'env' is incompatible with index signature.
        Type '{ name: string; languageOptions: { globals: { ... } } }' is not assignable to type 'Config<RulesRecord> | LegacyConfig<RulesRecord, RulesRecord> | Config<RulesRecord>[]'.
          Type '{ name: string; languageOptions: { globals: { ... } } }' is not assignable to type 'Config<RulesRecord>'.
            The types of 'languageOptions.globals' are incompatible between these types.
              Type '{ suite: string; ... }' is not assignable to type 'Globals'.
                Property 'suite' is incompatible with index signature.
                  Type 'string' is not assignable to type 'GlobalConf'.

Excerpt from my config:

import Vitest from "@vitest/eslint-plugin";
import type { Linter } from "eslint";

const ESLINT_TESTS_CONFIG = {
  name: "tests",
  files: ["tests/**/*.spec.ts"],
  plugins: { vitest: Vitest },
  // ...
} satisfies Linter.Config;

Environment:

• @vitest/eslint-plugin version: 1.3.4
• TypeScript version: 5.8.3
• ESLint version: 9.30.1

Steps to reproduce:

1. Import and use the plugin in a flat ESLint config with TypeScript.
2. Assign the plugin to the plugins property.
3. Type-check the config.

Expected behavior:
No type errors should occur when using the plugin in a flat config with TypeScript.

Actual behavior:
TypeScript reports a type incompatibility for the env property in the plugin's configs.

Additional context:
It appears the env config in the plugin uses a globals object with string values, but the expected type is GlobalConf. This causes a type mismatch in strict TypeScript projects.

---

Thank you for your work on this plugin! 💚

[veritem]

hey can i have a look at your eslint config?

[antoinezanardi]

Of course, here is the main eslint config :

import type { Linter } from "eslint";

import { ESLINT_CUCUMBER_CONFIG } from "./config/eslint/flat-configs/eslint.cucumber-config";
import { ESLINT_IGNORES } from "./config/eslint/eslint.constants";
import { ESLINT_GLOBAL_CONFIG } from "./config/eslint/flat-configs/eslint.global-config";
import { ESLINT_IMPORT_CONFIG } from "./config/eslint/flat-configs/eslint.import-config";
import { ESLINT_TYPESCRIPT_CONFIG } from "./config/eslint/flat-configs/eslint.typescript-config";
import { ESLINT_DECLARATIONS_CONFIG } from "./config/eslint/flat-configs/eslint.declarations-config";
import { ESLINT_TYPESCRIPT_DECLARATION_CONFIG } from "./config/eslint/flat-configs/eslint.typescript-declaration-config";
import { ESLINT_VUE_CONFIG } from "./config/eslint/flat-configs/eslint.vue-config";
import { ESLINT_COMPOSABLES_CONFIG } from "./config/eslint/flat-configs/eslint.composables-config";
import { ESLINT_PAGES_CONFIG } from "./config/eslint/flat-configs/eslint.pages-config";
import { ESLINT_STYLISTIC_CONFIG } from "./config/eslint/flat-configs/eslint.stylistic-config";
import { ESLINT_CONFIG_FILES_CONFIG } from "./config/eslint/flat-configs/eslint.config-files-config";
import { ESLINT_CLASSES_CONFIG } from "./config/eslint/flat-configs/eslint.classes-config";
import { ESLINT_MODULES_CONFIG } from "./config/eslint/flat-configs/eslint.modules-config";
import { ESLINT_PLUGINS_CONFIG } from "./config/eslint/flat-configs/eslint.plugins-config";
import { ESLINT_NUXT_CONFIG_FILE_CONFIG } from "./config/eslint/flat-configs/eslint.nuxt-config-file-config";
import { ESLINT_SERVER_FILES_CONFIG } from "./config/eslint/flat-configs/eslint.server-files.config";
import { ESLINT_TESTS_CONFIG } from "./config/eslint/flat-configs/eslint.tests-config";

export default [
  {
    name: "global-ignores",
    ignores: ESLINT_IGNORES,
  },
  ESLINT_GLOBAL_CONFIG,
  ESLINT_IMPORT_CONFIG,
  ESLINT_TYPESCRIPT_CONFIG,
  ESLINT_DECLARATIONS_CONFIG,
  ESLINT_TYPESCRIPT_DECLARATION_CONFIG,
  ESLINT_VUE_CONFIG,
  ESLINT_COMPOSABLES_CONFIG,
  ESLINT_PAGES_CONFIG,
  ESLINT_STYLISTIC_CONFIG,
  ESLINT_CONFIG_FILES_CONFIG,
  ESLINT_CLASSES_CONFIG,
  ESLINT_MODULES_CONFIG,
  ESLINT_PLUGINS_CONFIG,
  ESLINT_NUXT_CONFIG_FILE_CONFIG,
  ESLINT_SERVER_FILES_CONFIG,
  ESLINT_TESTS_CONFIG,
  ESLINT_CUCUMBER_CONFIG,
] satisfies Linter.Config[];

And here the config for the eslint vitest plugin :

import Vitest from "@vitest/eslint-plugin";
import type { Linter } from "eslint";

const ESLINT_TESTS_CONFIG = {
  name: "tests",
  files: ["tests/**/*.spec.ts"],
  plugins: { vitest: Vitest },
  rules: {
    "max-lines-per-function": "off",
    "no-magic-numbers": "off",
    "@typescript-eslint/no-unsafe-type-assertion": "off",
    "import/no-namespace": "off",
    "import/no-internal-modules": "off",
    "import/max-dependencies": [
      "error",
      {
        max: 40,
        ignoreTypeImports: true,
      },
    ],
    "@typescript-eslint/init-declarations": "off",
    "@typescript-eslint/no-magic-numbers": "off",
    "@typescript-eslint/prefer-destructuring": "off",
    "vitest/consistent-test-filename": [
      "error",
      { pattern: "^(.+\\.spec)\\.ts$" },
    ],
    "vitest/consistent-test-it": [
      "error",
      { fn: "it" },
    ],
    "vitest/consistent-vitest-vi": "error",
    "vitest/expect-expect": "error",
    "vitest/max-expects": [
      "error",
      { max: 10 },
    ],
    "vitest/max-nested-describe": "error",
    "vitest/no-alias-methods": "error",
    "vitest/no-commented-out-tests": "error",
    "vitest/no-conditional-expect": "error",
    "vitest/no-conditional-in-test": "error",
    "vitest/no-conditional-tests": "error",
    "vitest/no-disabled-tests": "error",
    "vitest/no-duplicate-hooks": "error",
    "vitest/no-focused-tests": "error",
    "vitest/no-hooks": "off",
    "vitest/no-identical-title": "error",
    "vitest/no-import-node-test": "error",
    "vitest/no-importing-vitest-globals": "error",
    "vitest/no-interpolation-in-snapshots": "error",
    "vitest/no-large-snapshots": "error",
    "vitest/no-mocks-import": "error",
    "vitest/no-restricted-matchers": "off",
    "vitest/no-restricted-vi-methods": "off",
    "vitest/no-standalone-expect": "error",
    "vitest/no-test-prefixes": "error",
    "vitest/no-test-return-statement": "error",
    "vitest/padding-around-after-all-blocks": "error",
    "vitest/padding-around-after-each-blocks": "error",
    "vitest/padding-around-all": "error",
    "vitest/padding-around-before-all-blocks": "error",
    "vitest/padding-around-before-each-blocks": "error",
    "vitest/padding-around-describe-blocks": "error",
    "vitest/padding-around-expect-groups": "error",
    "vitest/padding-around-test-blocks": "error",
    "vitest/prefer-called-with": "error",
    "vitest/prefer-comparison-matcher": "error",
    "vitest/prefer-describe-function-title": "error",
    "vitest/prefer-each": "error",
    "vitest/prefer-equality-matcher": "error",
    "vitest/prefer-expect-assertions": "off",
    "vitest/prefer-expect-resolves": "error",
    "vitest/prefer-hooks-in-order": "error",
    "vitest/prefer-hooks-on-top": "error",
    "vitest/prefer-importing-vitest-globals": "off",
    "vitest/prefer-lowercase-title": "off",
    "vitest/prefer-mock-promise-shorthand": "error",
    "vitest/prefer-snapshot-hint": "error",
    "vitest/prefer-spy-on": "error",
    "vitest/prefer-strict-boolean-matchers": "off",
    "vitest/prefer-strict-equal": "error",
    "vitest/prefer-to-be": "error",
    "vitest/prefer-to-be-falsy": "error",
    "vitest/prefer-to-be-object": "error",
    "vitest/prefer-to-be-truthy": "error",
    "vitest/prefer-to-contain": "error",
    "vitest/prefer-to-have-length": "error",
    "vitest/prefer-todo": "error",
    "vitest/prefer-vi-mocked": "error",
    "vitest/require-hook": [
      "error",
      {
        allowedFunctionCalls: ["mockNuxtImport"],
      },
    ],
    "vitest/require-local-test-context-for-concurrent-snapshots": "error",
    "vitest/require-mock-type-parameters": "error",
    "vitest/require-to-throw-message": "error",
    "vitest/require-top-level-describe": "error",
    "vitest/valid-describe-callback": "error",
    "vitest/valid-expect-in-promise": "error",
    "vitest/valid-expect": "error",
    "vitest/valid-title": [
      "error",
      {
        ignoreTypeOfDescribeName: true,
        mustMatch: { it: new RegExp(/^should .+ when .+\S\.$|^\$test$/u, "u").source },
      },
    ],
  },
} satisfies Linter.Config;

export { ESLINT_TESTS_CONFIG };

[kouts]

We're encountering the same issue, and it appears to have started with version 1.3.3 of @vitest/eslint-plugin.

To help illustrate the problem, I’ve prepared a minimal reproduction repo:
🔗 Reproduction Repo

To reproduce the error:

pnpm install
pnpm run build

[zemd]

I am observing the same issue in my config which looks like: https://github.com/zemd/eslint-flat-config/blob/main/packages/rock-stack/src/vitest.ts

ps as a temporary workaround I see that using plugin.meta as a plugin value fixes the issue

plugins: {
    vitest: plugin.meta,
},

[bsiguret]

The error even occurs with the config inside the readme Enabling with type-testing. Any news on a possible fix? I see #736, but I'm not sure if it fixes. Thank you 🙏