@w5s/eslint-config 3.1.0 → 3.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@w5s/eslint-config",
-  "version": "3.1.0",
+  "version": "3.2.1",
   "description": "ESLint configuration presets",
   "keywords": [
     "eslint",
@@ -49,16 +49,16 @@
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
     "@vitest/eslint-plugin": "^1.0.0",
-    "@w5s/dev": "^3.1.0",
-    "@w5s/prettier-config": "^3.0.1",
+    "@w5s/dev": "^3.1.2",
+    "@w5s/prettier-config": "^3.0.3",
     "eslint-plugin-import": "^2.25.0",
     "eslint-plugin-jsdoc": "^61.0.0",
     "eslint-plugin-jsonc": "^2.4.0",
     "eslint-plugin-n": "^17.0.0",
-    "eslint-plugin-unicorn": "^61.0.0",
+    "eslint-plugin-unicorn": "^62.0.0",
     "eslint-plugin-yml": "^1.1.0",
     "find-up": "^8.0.0",
-    "globals": "^16.0.0",
+    "globals": "^17.0.0",
     "jsonc-eslint-parser": "^2.0.0",
     "parse-gitignore": "^2.0.0",
     "yaml-eslint-parser": "^1.0.0"
@@ -82,5 +82,5 @@
     "access": "public"
   },
   "sideEffect": false,
-  "gitHead": "a8ee6449f8faf3d45ad47f497b9bb8a4c98d89e7"
+  "gitHead": "648be101c2d4f915b97ed7e318da47a6ac19eb5c"
 }

package/src/rules/esRules/es6.ts

@@ -0,0 +1,173 @@
+import type { Linter } from 'eslint';
+
+export const es6 = () => ({
+// enforces no braces where they can be omitted
+  // https://eslint.org/docs/rules/arrow-body-style
+  // TODO: enable requireReturnForObjectLiteral?
+  'arrow-body-style': ['error', 'as-needed', {
+    requireReturnForObjectLiteral: false,
+  }],
+
+  // require parens in arrow function arguments
+  // https://eslint.org/docs/rules/arrow-parens
+  'arrow-parens': ['error', 'always'],
+
+  // require space before/after arrow function's arrow
+  // https://eslint.org/docs/rules/arrow-spacing
+  'arrow-spacing': ['error', { before: true, after: true }],
+
+  // verify super() callings in constructors
+  'constructor-super': 'error',
+
+  // enforce the spacing around the * in generator functions
+  // https://eslint.org/docs/rules/generator-star-spacing
+  'generator-star-spacing': ['error', { before: false, after: true }],
+
+  // disallow modifying variables of class declarations
+  // https://eslint.org/docs/rules/no-class-assign
+  'no-class-assign': 'error',
+
+  // disallow arrow functions where they could be confused with comparisons
+  // https://eslint.org/docs/rules/no-confusing-arrow
+  'no-confusing-arrow': ['error', {
+    allowParens: true,
+  }],
+
+  // disallow modifying variables that are declared using const
+  'no-const-assign': 'error',
+
+  // disallow duplicate class members
+  // https://eslint.org/docs/rules/no-dupe-class-members
+  'no-dupe-class-members': 'error',
+
+  // disallow importing from the same path more than once
+  // https://eslint.org/docs/rules/no-duplicate-imports
+  // replaced by https://github.com/import-js/eslint-plugin-import/blob/master/docs/rules/no-duplicates.md
+  'no-duplicate-imports': 'off',
+
+  // disallow symbol constructor
+  // https://eslint.org/docs/rules/no-new-symbol
+  'no-new-symbol': 'error',
+
+  // Disallow specified names in exports
+  // https://eslint.org/docs/rules/no-restricted-exports
+  'no-restricted-exports': ['error', {
+    restrictedNamedExports: [
+      'default', // use `export default` to provide a default export
+      'then', // this will cause tons of confusion when your module is dynamically `import()`ed, and will break in most node ESM versions
+    ],
+  }],
+
+  // disallow specific imports
+  // https://eslint.org/docs/rules/no-restricted-imports
+  'no-restricted-imports': ['off', {
+    paths: [],
+    patterns: [],
+  }],
+
+  // disallow to use this/super before super() calling in constructors.
+  // https://eslint.org/docs/rules/no-this-before-super
+  'no-this-before-super': 'error',
+
+  // disallow useless computed property keys
+  // https://eslint.org/docs/rules/no-useless-computed-key
+  'no-useless-computed-key': 'error',
+
+  // disallow unnecessary constructor
+  // https://eslint.org/docs/rules/no-useless-constructor
+  'no-useless-constructor': 'error',
+
+  // disallow renaming import, export, and destructured assignments to the same name
+  // https://eslint.org/docs/rules/no-useless-rename
+  'no-useless-rename': ['error', {
+    ignoreDestructuring: false,
+    ignoreImport: false,
+    ignoreExport: false,
+  }],
+
+  // require let or const instead of var
+  'no-var': 'error',
+
+  // require method and property shorthand syntax for object literals
+  // https://eslint.org/docs/rules/object-shorthand
+  'object-shorthand': ['error', 'always', {
+    ignoreConstructors: false,
+    avoidQuotes: true,
+  }],
+
+  // suggest using arrow functions as callbacks
+  'prefer-arrow-callback': ['error', {
+    allowNamedFunctions: false,
+    allowUnboundThis: true,
+  }],
+
+  // suggest using of const declaration for variables that are never modified after declared
+  'prefer-const': ['error', {
+    destructuring: 'any',
+    ignoreReadBeforeAssign: true,
+  }],
+
+  // Prefer destructuring from arrays and objects
+  // https://eslint.org/docs/rules/prefer-destructuring
+  'prefer-destructuring': ['error', {
+    VariableDeclarator: {
+      array: false,
+      object: true,
+    },
+    AssignmentExpression: {
+      array: true,
+      object: false,
+    },
+  }, {
+    enforceForRenamedProperties: false,
+  }],
+
+  // disallow parseInt() in favor of binary, octal, and hexadecimal literals
+  // https://eslint.org/docs/rules/prefer-numeric-literals
+  'prefer-numeric-literals': 'error',
+
+  // suggest using Reflect methods where applicable
+  // https://eslint.org/docs/rules/prefer-reflect
+  'prefer-reflect': 'off',
+
+  // use rest parameters instead of arguments
+  // https://eslint.org/docs/rules/prefer-rest-params
+  'prefer-rest-params': 'error',
+
+  // suggest using the spread syntax instead of .apply()
+  // https://eslint.org/docs/rules/prefer-spread
+  'prefer-spread': 'error',
+
+  // suggest using template literals instead of string concatenation
+  // https://eslint.org/docs/rules/prefer-template
+  'prefer-template': 'error',
+
+  // disallow generator functions that do not have yield
+  // https://eslint.org/docs/rules/require-yield
+  'require-yield': 'error',
+
+  // enforce spacing between object rest-spread
+  // https://eslint.org/docs/rules/rest-spread-spacing
+  'rest-spread-spacing': ['error', 'never'],
+
+  // import sorting
+  // https://eslint.org/docs/rules/sort-imports
+  'sort-imports': ['off', {
+    ignoreCase: false,
+    ignoreDeclarationSort: false,
+    ignoreMemberSort: false,
+    memberSyntaxSortOrder: ['none', 'all', 'multiple', 'single'],
+  }],
+
+  // require a Symbol description
+  // https://eslint.org/docs/rules/symbol-description
+  'symbol-description': 'error',
+
+  // enforce usage of spacing in template strings
+  // https://eslint.org/docs/rules/template-curly-spacing
+  'template-curly-spacing': 'error',
+
+  // enforce spacing around the * in yield* expressions
+  // https://eslint.org/docs/rules/yield-star-spacing
+  'yield-star-spacing': ['error', 'after'],
+} satisfies Linter.RulesRecord);

package/src/rules/esRules/strict.ts

@@ -0,0 +1,6 @@
+import type { Linter } from 'eslint';
+
+export const strict = () => ({
+  // babel inserts `'use strict';` for us
+  strict: ['error', 'never'],
+} satisfies Linter.RulesRecord);

package/src/rules/esRules/variables.ts

@@ -0,0 +1,58 @@
+import type { Linter } from 'eslint';
+
+export const variables = () => ({
+// enforce or disallow variable initializations at definition
+  'init-declarations': 'off',
+
+  // disallow the catch clause parameter name being the same as a variable in the outer scope
+  'no-catch-shadow': 'off',
+
+  // disallow deletion of variables
+  'no-delete-var': 'error',
+
+  // disallow labels that share a name with a variable
+  // https://eslint.org/docs/rules/no-label-var
+  'no-label-var': 'error',
+
+  // disallow specific globals
+  'no-restricted-globals': [
+    'error',
+    {
+      name: 'isFinite',
+      message:
+          'Use Number.isFinite instead https://github.com/airbnb/javascript#standard-library--isfinite',
+    },
+    {
+      name: 'isNaN',
+      message:
+          'Use Number.isNaN instead https://github.com/airbnb/javascript#standard-library--isnan',
+    },
+    // ...confusingBrowserGlobals.map((g) => ({
+    //   name: g,
+    //   message: `Use window.${g} instead. https://github.com/facebook/create-react-app/blob/HEAD/packages/confusing-browser-globals/README.md`,
+    // })),
+  ],
+
+  // disallow declaration of variables already declared in the outer scope
+  'no-shadow': 'error',
+
+  // disallow shadowing of names such as arguments
+  'no-shadow-restricted-names': 'error',
+
+  // disallow use of undeclared variables unless mentioned in a /*global */ block
+  'no-undef': 'error',
+
+  // disallow use of undefined when initializing variables
+  'no-undef-init': 'error',
+
+  // disallow use of undefined variable
+  // https://eslint.org/docs/rules/no-undefined
+  // TODO: enable?
+  'no-undefined': 'off',
+
+  // disallow declaration of variables that are not used in the code
+  'no-unused-vars': ['error', { vars: 'all', args: 'after-used', ignoreRestSiblings: true }],
+
+  // disallow use of variables before they are defined
+  'no-use-before-define': ['error', { functions: true, classes: true, variables: true }],
+} satisfies Linter.RulesRecord);

package/src/rules/esRules.ts

@@ -1,8 +1,17 @@
 import { bestPractices } from './esRules/bestPractices.js';
 import { errors } from './esRules/errors.js';
+import { es6 } from './esRules/es6.js';
 import { overrides } from './esRules/overrides.js';
+import { strict } from './esRules/strict.js';
+import { variables } from './esRules/variables.js';
+
 export const esRules = () => ({
   ...bestPractices(),
   ...errors(),
+  ...es6(),
+  ...strict(),
+  ...variables(),
+
+  // Must be last
   ...overrides(),
 });

package/src/typegen/jsdoc.d.ts

@@ -264,6 +264,11 @@ export 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
@@ -412,6 +417,8 @@ type JsdocCheckExamples = []|[{
 // ----- jsdoc/check-indentation -----
 type JsdocCheckIndentation = []|[{
   
+  allowIndentedSections?: boolean
+  
   excludeTags?: string[]
 }]
 // ----- jsdoc/check-line-alignment -----
@@ -797,6 +804,8 @@ type JsdocRequireHyphenBeforeParamDescription = []|[("always" | "never")]|[("alw
 // ----- jsdoc/require-jsdoc -----
 type JsdocRequireJsdoc = []|[{
   
+  checkAllFunctionExpressions?: boolean
+  
   checkConstructors?: boolean
   
   checkGetters?: (boolean | "no-setter")
@@ -917,6 +926,16 @@ type JsdocRequireParamType = []|[{
   
   setDefaultDestructuredRootType?: boolean
 }]
+// ----- jsdoc/require-rejects -----
+type JsdocRequireRejects = []|[{
+  
+  contexts?: (string | {
+    comment?: string
+    context?: string
+  })[]
+  
+  exemptedBy?: string[]
+}]
 // ----- jsdoc/require-returns -----
 type JsdocRequireReturns = []|[{
   
@@ -1041,6 +1060,10 @@ type JsdocSortTags = []|[{
   
   reportTagGroupSpacing?: boolean
   
+  tagExceptions?: {
+    [k: string]: number
+  }
+  
   tagSequence?: {
     
     tags?: string[]

package/src/typegen/style.d.ts

@@ -214,6 +214,7 @@ export interface RuleOptions {
   /**
    * Enforce props alphabetical sorting
    * @see https://eslint.style/rules/jsx-sort-props
+   * @deprecated
    */
   'style/jsx-sort-props'?: Linter.RuleEntry<StyleJsxSortProps>
   /**
@@ -1718,7 +1719,7 @@ type StyleTypeAnnotationSpacing = []|[{
   after?: boolean
   overrides?: {
     colon?: _StyleTypeAnnotationSpacing_SpacingConfig
-    arrow?: _StyleTypeAnnotationSpacing_SpacingConfig
+    arrow?: ("ignore" | _StyleTypeAnnotationSpacing_SpacingConfig)
     variable?: _StyleTypeAnnotationSpacing_SpacingConfig
     parameter?: _StyleTypeAnnotationSpacing_SpacingConfig
     property?: _StyleTypeAnnotationSpacing_SpacingConfig

package/src/typegen/test.d.ts

@@ -10,7 +10,12 @@ declare module 'eslint' {
 
 export interface RuleOptions {
   /**
-   * require .spec test file pattern
+   * enforce using `.each` or `.for` consistently
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-each-for.md
+   */
+  'test/consistent-each-for'?: Linter.RuleEntry<TestConsistentEachFor>
+  /**
+   * require test file pattern
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-test-filename.md
    */
   'test/consistent-test-filename'?: Linter.RuleEntry<TestConsistentTestFilename>
@@ -19,11 +24,21 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-test-it.md
    */
   'test/consistent-test-it'?: Linter.RuleEntry<TestConsistentTestIt>
+  /**
+   * enforce using vitest or vi but not both
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/consistent-vitest-vi.md
+   */
+  'test/consistent-vitest-vi'?: Linter.RuleEntry<TestConsistentVitestVi>
   /**
    * enforce having expectation in test body
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/expect-expect.md
    */
   'test/expect-expect'?: Linter.RuleEntry<TestExpectExpect>
+  /**
+   * enforce hoisted APIs to be on top of the file
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/hoisted-apis-on-top.md
+   */
+  'test/hoisted-apis-on-top'?: Linter.RuleEntry<[]>
   /**
    * enforce a maximum number of expect per test
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/max-expects.md
@@ -48,7 +63,7 @@ export interface RuleOptions {
    * disallow conditional expects
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-expect.md
    */
-  'test/no-conditional-expect'?: Linter.RuleEntry<[]>
+  'test/no-conditional-expect'?: Linter.RuleEntry<TestNoConditionalExpect>
   /**
    * disallow conditional tests
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-conditional-in-test.md
@@ -95,6 +110,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-import-node-test.md
    */
   'test/no-import-node-test'?: Linter.RuleEntry<[]>
+  /**
+   * disallow importing Vitest globals
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-importing-vitest-globals.md
+   */
+  'test/no-importing-vitest-globals'?: Linter.RuleEntry<[]>
   /**
    * disallow string interpolation in snapshots
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-interpolation-in-snapshots.md
@@ -126,7 +146,7 @@ export interface RuleOptions {
    */
   'test/no-standalone-expect'?: Linter.RuleEntry<TestNoStandaloneExpect>
   /**
-   * disallow using `test` as a prefix
+   * disallow using the `f` and `x` prefixes in favour of `.only` and `.skip`
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-test-prefixes.md
    */
   'test/no-test-prefixes'?: Linter.RuleEntry<[]>
@@ -135,6 +155,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-test-return-statement.md
    */
   'test/no-test-return-statement'?: Linter.RuleEntry<[]>
+  /**
+   * Disallow unnecessary async function wrapper for expected promises
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/no-unneeded-async-expect-function.md
+   */
+  'test/no-unneeded-async-expect-function'?: Linter.RuleEntry<[]>
   /**
    * Enforce padding around `afterAll` blocks
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/padding-around-after-all-blocks.md
@@ -175,6 +200,21 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/padding-around-test-blocks.md
    */
   'test/padding-around-test-blocks'?: Linter.RuleEntry<[]>
+  /**
+   * Prefer `toHaveBeenCalledExactlyOnceWith` over `toHaveBeenCalledOnce` and `toHaveBeenCalledWith`
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-called-exactly-once-with.md
+   */
+  'test/prefer-called-exactly-once-with'?: Linter.RuleEntry<[]>
+  /**
+   * enforce using `toBeCalledOnce()` or `toHaveBeenCalledOnce()`
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-called-once.md
+   */
+  'test/prefer-called-once'?: Linter.RuleEntry<[]>
+  /**
+   * enforce using `toBeCalledTimes(1)` or `toHaveBeenCalledTimes(1)`
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-called-times.md
+   */
+  'test/prefer-called-times'?: Linter.RuleEntry<[]>
   /**
    * enforce using `toBeCalledWith()` or `toHaveBeenCalledWith()`
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-called-with.md
@@ -185,13 +225,18 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-comparison-matcher.md
    */
   'test/prefer-comparison-matcher'?: Linter.RuleEntry<[]>
+  /**
+   * enforce using a function as a describe title over an equivalent string
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-describe-function-title.md
+   */
+  'test/prefer-describe-function-title'?: Linter.RuleEntry<[]>
   /**
    * enforce using `each` rather than manual loops
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-each.md
    */
   'test/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
    */
   'test/prefer-equality-matcher'?: Linter.RuleEntry<[]>
@@ -205,6 +250,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-expect-resolves.md
    */
   'test/prefer-expect-resolves'?: Linter.RuleEntry<[]>
+  /**
+   * enforce using `expectTypeOf` instead of `expect(typeof ...)`
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-expect-type-of.md
+   */
+  'test/prefer-expect-type-of'?: Linter.RuleEntry<[]>
   /**
    * enforce having hooks in consistent order
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-hooks-in-order.md
@@ -215,6 +265,16 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-hooks-on-top.md
    */
   'test/prefer-hooks-on-top'?: Linter.RuleEntry<[]>
+  /**
+   * prefer dynamic import in mock
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-import-in-mock.md
+   */
+  'test/prefer-import-in-mock'?: Linter.RuleEntry<TestPreferImportInMock>
+  /**
+   * enforce importing Vitest globals
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-importing-vitest-globals.md
+   */
+  'test/prefer-importing-vitest-globals'?: Linter.RuleEntry<[]>
   /**
    * enforce lowercase titles
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-lowercase-title.md
@@ -225,6 +285,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-mock-promise-shorthand.md
    */
   'test/prefer-mock-promise-shorthand'?: Linter.RuleEntry<[]>
+  /**
+   * Prefer mock return shorthands
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-mock-return-shorthand.md
+   */
+  'test/prefer-mock-return-shorthand'?: Linter.RuleEntry<[]>
   /**
    * enforce including a hint with external snapshots
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-snapshot-hint.md
@@ -270,6 +335,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-contain.md
    */
   'test/prefer-to-contain'?: Linter.RuleEntry<[]>
+  /**
+   * Suggest using `toHaveBeenCalledTimes()`
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-have-been-called-times.md
+   */
+  'test/prefer-to-have-been-called-times'?: Linter.RuleEntry<[]>
   /**
    * enforce using toHaveLength()
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-to-have-length.md
@@ -285,6 +355,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/prefer-vi-mocked.md
    */
   'test/prefer-vi-mocked'?: Linter.RuleEntry<[]>
+  /**
+   * ensure that every `expect.poll` call is awaited
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-awaited-expect-poll.md
+   */
+  'test/require-awaited-expect-poll'?: Linter.RuleEntry<[]>
   /**
    * require setup and teardown to be within a hook
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-hook.md
@@ -300,6 +375,11 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-mock-type-parameters.md
    */
   'test/require-mock-type-parameters'?: Linter.RuleEntry<TestRequireMockTypeParameters>
+  /**
+   * require tests to declare a timeout
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-test-timeout.md
+   */
+  'test/require-test-timeout'?: Linter.RuleEntry<[]>
   /**
    * require toThrow() to be called with an error message
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/require-to-throw-message.md
@@ -330,9 +410,21 @@ export interface RuleOptions {
    * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/valid-title.md
    */
   'test/valid-title'?: Linter.RuleEntry<TestValidTitle>
+  /**
+   * disallow `.todo` usage
+   * @see https://github.com/vitest-dev/eslint-plugin-vitest/blob/main/docs/rules/warn-todo.md
+   */
+  'test/warn-todo'?: Linter.RuleEntry<[]>
 }
 
 /* ======= Declarations ======= */
+// ----- test/consistent-each-for -----
+type TestConsistentEachFor = []|[{
+  test?: ("each" | "for")
+  it?: ("each" | "for")
+  describe?: ("each" | "for")
+  suite?: ("each" | "for")
+}]
 // ----- test/consistent-test-filename -----
 type TestConsistentTestFilename = []|[{
   pattern?: string
@@ -343,6 +435,10 @@ type TestConsistentTestIt = []|[{
   fn?: ("test" | "it")
   withinDescribe?: ("test" | "it")
 }]
+// ----- test/consistent-vitest-vi -----
+type TestConsistentVitestVi = []|[{
+  fn?: ("vi" | "vitest")
+}]
 // ----- test/expect-expect -----
 type TestExpectExpect = []|[{
   assertFunctionNames?: string[]
@@ -356,13 +452,19 @@ type TestMaxExpects = []|[{
 type TestMaxNestedDescribe = []|[{
   max?: number
 }]
+// ----- test/no-conditional-expect -----
+type TestNoConditionalExpect = []|[{
+  
+  expectAssertions?: boolean
+}]
 // ----- test/no-focused-tests -----
 type TestNoFocusedTests = []|[{
   fixable?: boolean
 }]
 // ----- test/no-hooks -----
 type TestNoHooks = []|[{
-  allow?: unknown[]
+  
+  allow?: ("beforeAll" | "beforeEach" | "afterAll" | "afterEach")[]
 }]
 // ----- test/no-large-snapshots -----
 type TestNoLargeSnapshots = []|[{
@@ -390,6 +492,10 @@ type TestPreferExpectAssertions = []|[{
   onlyFunctionsWithExpectInLoop?: boolean
   onlyFunctionsWithExpectInCallback?: boolean
 }]
+// ----- test/prefer-import-in-mock -----
+type TestPreferImportInMock = []|[{
+  fixable?: boolean
+}]
 // ----- test/prefer-lowercase-title -----
 type TestPreferLowercaseTitle = []|[{
   ignore?: ("describe" | "test" | "it")[]