@jimmy.codes/eslint-config 6.20.0 → 6.22.0

package/README.md

@@ -42,7 +42,7 @@ import { defineConfig } from "@jimmy.codes/eslint-config";
 export default defineConfig();
 ```
 
-It’ll auto-configure based on your installed dependencies.
+It'll auto-configure based on your installed dependencies.
 
 ---
 
@@ -75,6 +75,30 @@ export default defineConfig({
 });
 ```
 
+### Vitest Configuration
+
+Vitest also supports some configuration options. If options are provided then Vitest support is enabled.
+
+#### Configure Vitest Globals
+
+Control how [Vitest globals configuration](https://vitest.dev/config/globals.html) (`describe`, `it`, `expect`, etc.) are handled:
+
+```ts
+import { defineConfig } from "@jimmy.codes/eslint-config";
+
+export default defineConfig({
+  vitest: {
+    globals: "explicit", // Require explicit imports from 'vitest'
+  },
+});
+```
+
+Options:
+
+- `'explicit'`: Require explicit imports from `'vitest'`
+- `'implicit'`: Use implicit global APIs (vitest config `globals: true`)
+- `'either'`: Allow both styles (default)
+
 ### Override Specific Rules
 
 ```ts

package/dist/index.d.mts

@@ -2193,317 +2193,322 @@ interface RuleOptions {
   'jest-dom/prefer-to-have-value'?: Linter.RuleEntry<[]>;
   /**
    * Enforce `test` and `it` usage conventions
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/consistent-test-it.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/consistent-test-it.md
    */
   'jest/consistent-test-it'?: Linter.RuleEntry<JestConsistentTestIt>;
   /**
    * Enforce assertion to be made in a test body
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/expect-expect.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/expect-expect.md
    */
   'jest/expect-expect'?: Linter.RuleEntry<JestExpectExpect>;
   /**
    * Enforces a maximum number assertion calls in a test body
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/max-expects.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/max-expects.md
    */
   'jest/max-expects'?: Linter.RuleEntry<JestMaxExpects>;
   /**
    * Enforces a maximum depth to nested describe calls
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/max-nested-describe.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/max-nested-describe.md
    */
   'jest/max-nested-describe'?: Linter.RuleEntry<JestMaxNestedDescribe>;
   /**
    * Disallow alias methods
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-alias-methods.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-alias-methods.md
    */
   'jest/no-alias-methods'?: Linter.RuleEntry<[]>;
   /**
    * Disallow commented out tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-commented-out-tests.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-commented-out-tests.md
    */
   'jest/no-commented-out-tests'?: Linter.RuleEntry<[]>;
   /**
    * Disallow calling `expect` conditionally
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-conditional-expect.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-conditional-expect.md
    */
   'jest/no-conditional-expect'?: Linter.RuleEntry<[]>;
   /**
    * Disallow conditional logic in tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-conditional-in-test.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-conditional-in-test.md
    */
   'jest/no-conditional-in-test'?: Linter.RuleEntry<[]>;
   /**
    * Disallow confusing usages of jest.setTimeout
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-confusing-set-timeout.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-confusing-set-timeout.md
    */
   'jest/no-confusing-set-timeout'?: Linter.RuleEntry<[]>;
   /**
    * Disallow use of deprecated functions
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-deprecated-functions.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-deprecated-functions.md
    */
   'jest/no-deprecated-functions'?: Linter.RuleEntry<[]>;
   /**
    * Disallow disabled tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-disabled-tests.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-disabled-tests.md
    */
   'jest/no-disabled-tests'?: Linter.RuleEntry<[]>;
   /**
    * Disallow using a callback in asynchronous tests and hooks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-done-callback.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-done-callback.md
    */
   'jest/no-done-callback'?: Linter.RuleEntry<[]>;
   /**
    * Disallow duplicate setup and teardown hooks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-duplicate-hooks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-duplicate-hooks.md
    */
   'jest/no-duplicate-hooks'?: Linter.RuleEntry<[]>;
   /**
    * Disallow using `exports` in files containing tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-export.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-export.md
    */
   'jest/no-export'?: Linter.RuleEntry<[]>;
   /**
    * Disallow focused tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-focused-tests.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-focused-tests.md
    */
   'jest/no-focused-tests'?: Linter.RuleEntry<[]>;
   /**
    * Disallow setup and teardown hooks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-hooks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-hooks.md
    */
   'jest/no-hooks'?: Linter.RuleEntry<JestNoHooks>;
   /**
    * Disallow identical titles
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-identical-title.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-identical-title.md
    */
   'jest/no-identical-title'?: Linter.RuleEntry<[]>;
   /**
    * Disallow string interpolation inside snapshots
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-interpolation-in-snapshots.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-interpolation-in-snapshots.md
    */
   'jest/no-interpolation-in-snapshots'?: Linter.RuleEntry<[]>;
   /**
    * Disallow Jasmine globals
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-jasmine-globals.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-jasmine-globals.md
    */
   'jest/no-jasmine-globals'?: Linter.RuleEntry<[]>;
   /**
    * Disallow large snapshots
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-large-snapshots.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-large-snapshots.md
    */
   'jest/no-large-snapshots'?: Linter.RuleEntry<JestNoLargeSnapshots>;
   /**
    * Disallow manually importing from `__mocks__`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-mocks-import.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-mocks-import.md
    */
   'jest/no-mocks-import'?: Linter.RuleEntry<[]>;
   /**
    * Disallow specific `jest.` methods
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-restricted-jest-methods.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-restricted-jest-methods.md
    */
   'jest/no-restricted-jest-methods'?: Linter.RuleEntry<JestNoRestrictedJestMethods>;
   /**
    * Disallow specific matchers & modifiers
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-restricted-matchers.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-restricted-matchers.md
    */
   'jest/no-restricted-matchers'?: Linter.RuleEntry<JestNoRestrictedMatchers>;
   /**
    * Disallow using `expect` outside of `it` or `test` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-standalone-expect.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-standalone-expect.md
    */
   'jest/no-standalone-expect'?: Linter.RuleEntry<JestNoStandaloneExpect>;
   /**
    * Require using `.only` and `.skip` over `f` and `x`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-test-prefixes.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-test-prefixes.md
    */
   'jest/no-test-prefixes'?: Linter.RuleEntry<[]>;
   /**
    * Disallow explicitly returning from tests
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-test-return-statement.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-test-return-statement.md
    */
   'jest/no-test-return-statement'?: Linter.RuleEntry<[]>;
   /**
    * Disallow using `jest.mock()` factories without an explicit type parameter
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/no-untyped-mock-factory.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/no-untyped-mock-factory.md
    */
   'jest/no-untyped-mock-factory'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `afterAll` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-after-all-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-after-all-blocks.md
    */
   'jest/padding-around-after-all-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `afterEach` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-after-each-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-after-each-blocks.md
    */
   'jest/padding-around-after-each-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around Jest functions
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-all.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-all.md
    */
   'jest/padding-around-all'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `beforeAll` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-before-all-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-before-all-blocks.md
    */
   'jest/padding-around-before-all-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `beforeEach` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-before-each-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-before-each-blocks.md
    */
   'jest/padding-around-before-each-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `describe` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-describe-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-describe-blocks.md
    */
   'jest/padding-around-describe-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `expect` groups
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-expect-groups.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-expect-groups.md
    */
   'jest/padding-around-expect-groups'?: Linter.RuleEntry<[]>;
   /**
    * Enforce padding around `test` and `it` blocks
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/padding-around-test-blocks.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/padding-around-test-blocks.md
    */
   'jest/padding-around-test-blocks'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `toBeCalledWith()` or `toHaveBeenCalledWith()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-called-with.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-called-with.md
    */
   'jest/prefer-called-with'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using the built-in comparison matchers
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-comparison-matcher.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-comparison-matcher.md
    */
   'jest/prefer-comparison-matcher'?: Linter.RuleEntry<[]>;
   /**
    * Prefer using `.each` rather than manual loops
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-each.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-each.md
    */
   'jest/prefer-each'?: Linter.RuleEntry<[]>;
   /**
    * Prefer having the last statement in a test be an assertion
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-ending-with-an-expect.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-ending-with-an-expect.md
    */
   'jest/prefer-ending-with-an-expect'?: Linter.RuleEntry<JestPreferEndingWithAnExpect>;
   /**
    * Suggest using the built-in equality matchers
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-equality-matcher.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-equality-matcher.md
    */
   'jest/prefer-equality-matcher'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `expect.assertions()` OR `expect.hasAssertions()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-expect-assertions.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-expect-assertions.md
    */
   'jest/prefer-expect-assertions'?: Linter.RuleEntry<JestPreferExpectAssertions>;
   /**
    * Prefer `await expect(...).resolves` over `expect(await ...)` syntax
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-expect-resolves.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-expect-resolves.md
    */
   'jest/prefer-expect-resolves'?: Linter.RuleEntry<[]>;
   /**
    * Prefer having hooks in a consistent order
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-hooks-in-order.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-hooks-in-order.md
    */
   'jest/prefer-hooks-in-order'?: Linter.RuleEntry<[]>;
   /**
    * Suggest having hooks before any test cases
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-hooks-on-top.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-hooks-on-top.md
    */
   'jest/prefer-hooks-on-top'?: Linter.RuleEntry<[]>;
   /**
    * Prefer importing Jest globals
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-importing-jest-globals.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-importing-jest-globals.md
    */
   'jest/prefer-importing-jest-globals'?: Linter.RuleEntry<JestPreferImportingJestGlobals>;
   /**
    * Prefer `jest.mocked()` over `fn as jest.Mock`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-jest-mocked.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-jest-mocked.md
    */
   'jest/prefer-jest-mocked'?: Linter.RuleEntry<[]>;
   /**
    * Enforce lowercase test names
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-lowercase-title.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-lowercase-title.md
    */
   'jest/prefer-lowercase-title'?: Linter.RuleEntry<JestPreferLowercaseTitle>;
   /**
    * Prefer mock resolved/rejected shorthands for promises
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-mock-promise-shorthand.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-mock-promise-shorthand.md
    */
   'jest/prefer-mock-promise-shorthand'?: Linter.RuleEntry<[]>;
   /**
    * Prefer including a hint with external snapshots
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-snapshot-hint.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-snapshot-hint.md
    */
   'jest/prefer-snapshot-hint'?: Linter.RuleEntry<JestPreferSnapshotHint>;
   /**
    * Suggest using `jest.spyOn()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-spy-on.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-spy-on.md
    */
   'jest/prefer-spy-on'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `toStrictEqual()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-strict-equal.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-strict-equal.md
    */
   'jest/prefer-strict-equal'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `toBe()` for primitive literals
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-to-be.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-to-be.md
    */
   'jest/prefer-to-be'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `toContain()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-to-contain.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-to-contain.md
    */
   'jest/prefer-to-contain'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `toHaveLength()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-to-have-length.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-to-have-length.md
    */
   'jest/prefer-to-have-length'?: Linter.RuleEntry<[]>;
   /**
    * Suggest using `test.todo`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/prefer-todo.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/prefer-todo.md
    */
   'jest/prefer-todo'?: Linter.RuleEntry<[]>;
   /**
    * Require setup and teardown code to be within a hook
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/require-hook.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/require-hook.md
    */
   'jest/require-hook'?: Linter.RuleEntry<JestRequireHook>;
   /**
    * Require a message for `toThrow()`
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/require-to-throw-message.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/require-to-throw-message.md
    */
   'jest/require-to-throw-message'?: Linter.RuleEntry<[]>;
   /**
    * Require test cases and hooks to be inside a `describe` block
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/require-top-level-describe.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/require-top-level-describe.md
    */
   'jest/require-top-level-describe'?: Linter.RuleEntry<JestRequireTopLevelDescribe>;
   /**
    * Enforce unbound methods are called with their expected scope
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/unbound-method.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/unbound-method.md
    */
   'jest/unbound-method'?: Linter.RuleEntry<JestUnboundMethod>;
   /**
    * Enforce valid `describe()` callback
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/valid-describe-callback.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/valid-describe-callback.md
    */
   'jest/valid-describe-callback'?: Linter.RuleEntry<[]>;
   /**
    * Enforce valid `expect()` usage
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/valid-expect.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/valid-expect.md
    */
   'jest/valid-expect'?: Linter.RuleEntry<JestValidExpect>;
   /**
    * Require promises that have expectations in their chain to be valid
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/valid-expect-in-promise.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/valid-expect-in-promise.md
    */
   'jest/valid-expect-in-promise'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow mocking of non-existing module paths
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/valid-mock-module-path.md
+   */
+  'jest/valid-mock-module-path'?: Linter.RuleEntry<JestValidMockModulePath>;
   /**
    * Enforce valid titles
-   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.1.0/docs/rules/valid-title.md
+   * @see https://github.com/jest-community/eslint-plugin-jest/blob/v29.2.1/docs/rules/valid-title.md
    */
   'jest/valid-title'?: Linter.RuleEntry<JestValidTitle>;
   /**
@@ -2761,6 +2766,11 @@ interface RuleOptions {
    * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-property-type.md#repos-sticky-header
    */
   'jsdoc/require-property-type'?: Linter.RuleEntry<[]>;
+  /**
+   * Requires that Promise rejections are documented with `@rejects` tags.
+   * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-rejects.md#repos-sticky-header
+   */
+  'jsdoc/require-rejects'?: Linter.RuleEntry<JsdocRequireRejects>;
   /**
    * Requires that returns are documented with `@returns`.
    * @see https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-returns.md#repos-sticky-header
@@ -6813,6 +6823,11 @@ interface RuleOptions {
    * @see https://eslint.org/docs/latest/rules/vars-on-top
    */
   'vars-on-top'?: Linter.RuleEntry<[]>;
+  /**
+   * enforce using `.each` or `.for` consistently
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-each-for.md
+   */
+  'vitest/consistent-each-for'?: Linter.RuleEntry<VitestConsistentEachFor>;
   /**
    * require test file pattern
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-test-filename.md
@@ -7030,7 +7045,7 @@ interface RuleOptions {
    */
   'vitest/prefer-each'?: Linter.RuleEntry<[]>;
   /**
-   * enforce using the built-in quality matchers
+   * enforce using the built-in equality matchers
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-equality-matcher.md
    */
   'vitest/prefer-equality-matcher'?: Linter.RuleEntry<[]>;
@@ -7149,6 +7164,11 @@ interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-hook.md
    */
   'vitest/require-hook'?: Linter.RuleEntry<VitestRequireHook>;
+  /**
+   * require usage of import in vi.mock()
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-import-vi-mock.md
+   */
+  'vitest/require-import-vi-mock'?: Linter.RuleEntry<[]>;
   /**
    * require local Test Context for concurrent snapshot tests
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-local-test-context-for-concurrent-snapshots.md
@@ -10259,6 +10279,10 @@ type JestValidExpect = [] | [{
   minArgs?: number;
   maxArgs?: number;
 }];
+// ----- jest/valid-mock-module-path -----
+type JestValidMockModulePath = [] | [{
+  moduleFileExtensions?: string[];
+}];
 // ----- jest/valid-title -----
 type JestValidTitle = [] | [{
   ignoreSpaces?: boolean;
@@ -10297,6 +10321,7 @@ type JsdocCheckExamples = [] | [{
 }];
 // ----- jsdoc/check-indentation -----
 type JsdocCheckIndentation = [] | [{
+  allowIndentedSections?: boolean;
   excludeTags?: string[];
 }];
 // ----- jsdoc/check-line-alignment -----
@@ -10643,6 +10668,14 @@ type JsdocRequireParamType = [] | [{
   defaultDestructuredRootType?: string;
   setDefaultDestructuredRootType?: boolean;
 }];
+// ----- jsdoc/require-rejects -----
+type JsdocRequireRejects = [] | [{
+  contexts?: (string | {
+    comment?: string;
+    context?: string;
+  })[];
+  exemptedBy?: string[];
+}];
 // ----- jsdoc/require-returns -----
 type JsdocRequireReturns = [] | [{
   checkConstructors?: boolean;
@@ -14839,6 +14872,13 @@ type UseIsnan = [] | [{
 type ValidTypeof = [] | [{
   requireStringLiterals?: boolean;
 }];
+// ----- vitest/consistent-each-for -----
+type VitestConsistentEachFor = [] | [{
+  test?: ("each" | "for");
+  it?: ("each" | "for");
+  describe?: ("each" | "for");
+  suite?: ("each" | "for");
+}];
 // ----- vitest/consistent-test-filename -----
 type VitestConsistentTestFilename = [] | [{
   pattern?: string;
@@ -14964,6 +15004,20 @@ interface LinterConfigOverrides {
   plugins?: Record<string, unknown>;
 }
 type TypedConfigItem = Prettify<Override<Base, LinterConfigOverrides>>;
+interface VitestOptions {
+  /**
+   * How to handle Vitest global APIs (describe, it, expect, etc.).
+   *
+   * - 'explicit': Require explicit imports from 'vitest'
+   * - 'implicit': Use implicit global APIs (vitest config globals: true)
+   * - 'either': Allow both styles (default)
+   *
+   * @see https://vitest.dev/config/globals.html
+   *
+   * @default 'either'
+   */
+  globals?: "either" | "explicit" | "implicit";
+}
 interface Options {
   /**
    * Are astro rules enabled?
@@ -15051,7 +15105,7 @@ interface Options {
    *
    * @default false
    */
-  vitest?: boolean;
+  vitest?: boolean | VitestOptions;
 }
 //#endregion
 //#region src/factory.d.ts
@@ -15082,4 +15136,4 @@ declare const defineConfig: ({
   vitest
 }?: Options, ...moreOverrides: Linter.Config[] | TypedConfigItem[]) => Promise<any[]>;
 //#endregion
-export { Options, Rules, TypedConfigItem, defineConfig };
+export { type Options, type TypedConfigItem, type VitestOptions, defineConfig };

package/dist/index.mjs

@@ -424,6 +424,22 @@ const unicornConfig = () => {
 	}];
 };
 
+//#endregion
+//#region src/utils/create-featured.ts
+/**
+* Creates a featured flag checker function.
+*
+* @param autoDetect  - Whether to auto-detect features.
+*
+* @returns A function that determines if a feature is enabled.
+*/
+const createFeatured = (autoDetect) => {
+	return (explicit, detector) => {
+		if (typeof explicit !== "boolean") return true;
+		return explicit || autoDetect && detector();
+	};
+};
+
 //#endregion
 //#region src/utils/unwrap.ts
 /**
@@ -436,16 +452,19 @@ const unicornConfig = () => {
 *
 * @param module - A dynamically imported module.
 *
+* @param args - Optional arguments forwarded to the module's default export if it's a function.
+*
 * @returns
 * If the module has a `default` export that is a function, it returns the result of calling it.
 * Otherwise, it returns the module itself.
 *
 * @example
 * const config = await unwrap(import("./configs/react"));
+* const configWithOptions = await unwrap(import("./configs/react"), { version: "12" });
 */
-const unwrap = async (module) => {
+const unwrap = async (module, ...args) => {
 	const resolved = await module;
-	if (typeof resolved.default === "function") return resolved.default();
+	if (typeof resolved.default === "function") return resolved.default(...args);
 	return resolved;
 };
 
@@ -462,19 +481,17 @@ const unwrap = async (module) => {
 * export default defineConfig();
 */
 const defineConfig = async ({ astro = false, autoDetect = true, gitignore = false, ignores = [], jest = false, nextjs = false, overrides = [], playwright = false, react = false, storybook = false, tanstackQuery = false, testingLibrary = false, typescript = false, vitest = false } = {}, ...moreOverrides) => {
-	const getFlag = (explicit, detector) => {
-		return explicit || autoDetect && detector();
-	};
-	const isTypescriptEnabled = getFlag(typescript, hasTypescript);
-	const isReactEnabled = getFlag(react, hasReact);
-	const isAstroEnabled = getFlag(astro, hasAstro);
-	const isTanstackQueryEnabled = getFlag(tanstackQuery, hasReactQuery);
-	const isTestingLibraryEnabled = getFlag(testingLibrary, hasTestingLibrary);
-	const isPlaywrightEnabled = getFlag(playwright, hasPlaywright);
-	const isStorybookEnabled = getFlag(storybook, hasStorybook);
-	const isNextjsEnabled = getFlag(nextjs, hasNext);
-	const isJestEnabled = getFlag(jest, hasJest);
-	const isVitestEnabled = getFlag(vitest, hasVitest);
+	const featured = createFeatured(autoDetect);
+	const isTypescriptEnabled = featured(typescript, hasTypescript);
+	const isReactEnabled = featured(react, hasReact);
+	const isAstroEnabled = featured(astro, hasAstro);
+	const isTanstackQueryEnabled = featured(tanstackQuery, hasReactQuery);
+	const isTestingLibraryEnabled = featured(testingLibrary, hasTestingLibrary);
+	const isPlaywrightEnabled = featured(playwright, hasPlaywright);
+	const isStorybookEnabled = featured(storybook, hasStorybook);
+	const isNextjsEnabled = featured(nextjs, hasNext);
+	const isJestEnabled = featured(jest, hasJest);
+	const isVitestEnabled = featured(vitest, hasVitest);
 	const baseConfigs = [
 		javascriptConfig(),
 		perfectionistConfig(),
@@ -492,7 +509,7 @@ const defineConfig = async ({ astro = false, autoDetect = true, gitignore = fals
 		isTanstackQueryEnabled && unwrap(import("./tanstack-query-D1gpzKY3.mjs")),
 		isAstroEnabled && unwrap(import("./astro-D3Zl135N.mjs")),
 		isJestEnabled && unwrap(import("./jest-DZtYWPoX.mjs")),
-		isVitestEnabled && unwrap(import("./vitest-DCV0bIFB.mjs")),
+		isVitestEnabled && unwrap(import("./vitest-oIUtAksi.mjs"), vitest),
 		isTestingLibraryEnabled && unwrap(import("./testing-library-BBWV3thw.mjs")),
 		isPlaywrightEnabled && unwrap(import("./playwright-CrBcE3qD.mjs")),
 		isStorybookEnabled && unwrap(import("./storybook-CyxpG33Q.mjs")),

package/dist/{vitest-DCV0bIFB.mjs → vitest-oIUtAksi.mjs}

@@ -2,9 +2,15 @@ import { l as GLOB_TESTS, r as GLOB_E2E } from "./globs-C_yfK842.mjs";
 import { t as interopDefault } from "./interop-default-Bn64p66u.mjs";
 
 //#region src/rules/vitest.ts
-const vitestRules = async () => {
+const vitestRules = async (options) => {
 	return {
 		...(await interopDefault(import("@vitest/eslint-plugin"))).configs.recommended.rules,
+		"vitest/consistent-each-for": ["error", {
+			describe: "each",
+			it: "each",
+			suite: "each",
+			test: "each"
+		}],
 		"vitest/consistent-test-it": ["error", {
 			fn: "test",
 			withinDescribe: "it"
@@ -12,19 +18,13 @@ const vitestRules = async () => {
 		"vitest/consistent-vitest-vi": "error",
 		"vitest/hoisted-apis-on-top": "error",
 		"vitest/no-alias-methods": "error",
-		"vitest/no-commented-out-tests": "error",
 		"vitest/no-conditional-in-test": "error",
-		"vitest/no-disabled-tests": "warn",
 		"vitest/no-duplicate-hooks": "error",
-		"vitest/no-focused-tests": "error",
 		"vitest/no-hooks": "off",
-		"vitest/no-identical-title": "error",
-		"vitest/no-interpolation-in-snapshots": "error",
+		"vitest/no-importing-vitest-globals": options?.globals === "implicit" ? "error" : "off",
 		"vitest/no-large-snapshots": "off",
-		"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-all": "error",
@@ -40,6 +40,7 @@ const vitestRules = async () => {
 		"vitest/prefer-expect-type-of": "error",
 		"vitest/prefer-hooks-in-order": "error",
 		"vitest/prefer-hooks-on-top": "error",
+		"vitest/prefer-importing-vitest-globals": options?.globals === "explicit" ? "error" : "off",
 		"vitest/prefer-lowercase-title": "off",
 		"vitest/prefer-mock-promise-shorthand": "error",
 		"vitest/prefer-snapshot-hint": "error",
@@ -55,22 +56,35 @@ const vitestRules = async () => {
 		"vitest/require-hook": "error",
 		"vitest/require-to-throw-message": "error",
 		"vitest/require-top-level-describe": "off",
-		"vitest/valid-expect": "error",
-		"vitest/valid-expect-in-promise": "error",
 		"vitest/valid-title": ["error", { mustMatch: { it: "^should" } }],
 		"vitest/warn-todo": "warn"
 	};
 };
 
+//#endregion
+//#region src/utils/extract-options.ts
+/**
+* A simple utility to derive options for configurations when one option is a boolean.
+*
+* @param options - The options to derive.
+*
+* @returns The extracted options or `undefined` if the input was a boolean.
+*/
+const extractOptions = (options) => {
+	if (typeof options !== "boolean") return options;
+};
+
 //#endregion
 //#region src/configs/vitest.ts
-async function vitestConfig() {
+async function vitestConfig(options) {
+	const vitestPlugin = await interopDefault(import("@vitest/eslint-plugin"));
+	const extractedOptions = extractOptions(options);
 	return [{
 		files: GLOB_TESTS,
 		ignores: GLOB_E2E,
-		...(await interopDefault(import("@vitest/eslint-plugin"))).configs.recommended,
+		...vitestPlugin.configs.recommended,
 		name: "jimmy.codes/vitest",
-		rules: await vitestRules()
+		rules: await vitestRules(extractedOptions)
 	}];
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jimmy.codes/eslint-config",
-  "version": "6.20.0",
+  "version": "6.22.0",
   "description": "A simple, modern ESLint config that covers most use cases.",
   "keywords": [
     "eslint",
@@ -41,13 +41,13 @@
   "dependencies": {
     "@eslint-community/eslint-plugin-eslint-comments": "^4.5.0",
     "@eslint/js": "^9.39.1",
-    "@next/eslint-plugin-next": "^16.0.3",
-    "@stylistic/eslint-plugin": "^5.5.0",
+    "@next/eslint-plugin-next": "^16.0.4",
+    "@stylistic/eslint-plugin": "^5.6.1",
     "@tanstack/eslint-plugin-query": "^5.91.2",
     "@types/eslint": "9.6.1",
-    "@typescript-eslint/parser": "^8.47.0",
-    "@typescript-eslint/utils": "^8.47.0",
-    "@vitest/eslint-plugin": "^1.4.3",
+    "@typescript-eslint/parser": "^8.48.0",
+    "@typescript-eslint/utils": "^8.48.0",
+    "@vitest/eslint-plugin": "^1.5.0",
     "astro-eslint-parser": "^1.2.2",
     "eslint-config-flat-gitignore": "^2.1.0",
     "eslint-config-prettier": "^10.1.8",
@@ -55,28 +55,28 @@
     "eslint-plugin-arrow-return-style-x": "^1.2.6",
     "eslint-plugin-astro": "^1.5.0",
     "eslint-plugin-import-x": "^4.16.1",
-    "eslint-plugin-jest": "^29.1.0",
+    "eslint-plugin-jest": "^29.2.1",
     "eslint-plugin-jest-dom": "^5.5.0",
-    "eslint-plugin-jsdoc": "^61.2.1",
+    "eslint-plugin-jsdoc": "^61.4.1",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-n": "^17.23.1",
     "eslint-plugin-perfectionist": "^4.15.1",
     "eslint-plugin-playwright": "^2.3.0",
     "eslint-plugin-react-compiler": "19.1.0-rc.2",
-    "eslint-plugin-react-dom": "^2.3.5",
+    "eslint-plugin-react-dom": "^2.3.7",
     "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-hooks-extra": "^2.3.5",
-    "eslint-plugin-react-naming-convention": "^2.3.5",
+    "eslint-plugin-react-hooks-extra": "^2.3.7",
+    "eslint-plugin-react-naming-convention": "^2.3.7",
     "eslint-plugin-react-refresh": "0.4.24",
-    "eslint-plugin-react-web-api": "^2.3.5",
-    "eslint-plugin-react-x": "^2.3.5",
+    "eslint-plugin-react-web-api": "^2.3.7",
+    "eslint-plugin-react-x": "^2.3.7",
     "eslint-plugin-regexp": "^2.10.0",
     "eslint-plugin-storybook": "0.12.0",
-    "eslint-plugin-testing-library": "^7.13.4",
+    "eslint-plugin-testing-library": "^7.13.5",
     "eslint-plugin-unicorn": "^62.0.0",
     "globals": "^16.5.0",
     "local-pkg": "^1.1.2",
-    "typescript-eslint": "^8.47.0"
+    "typescript-eslint": "^8.48.0"
   },
   "peerDependencies": {
     "eslint": "^9.10.0"