@isentinel/eslint-config 6.0.0-beta.33 → 6.0.0-beta.34

package/dist/cli.mjs

@@ -9,7 +9,7 @@ import path from "node:path";
 import { existsSync, readFileSync } from "fs";
 import { execSync } from "node:child_process";
 //#region package.json
-var version = "6.0.0-beta.33";
+var version = "6.0.0-beta.34";
 var package_default = {
 	name: "@isentinel/eslint-config",
 	version,
@@ -156,6 +156,7 @@ var package_default = {
 		"eslint-plugin-react-jsx": "catalog:peer",
 		"eslint-plugin-react-naming-convention": "catalog:peer",
 		"eslint-plugin-react-x": "catalog:peer",
+		"eslint-plugin-testing-library": "catalog:peer",
 		"eslint-typegen": "catalog:dev",
 		"jiti": "catalog:dev",
 		"oxlint": "catalog:peer",
@@ -179,6 +180,7 @@ var package_default = {
 		"eslint-plugin-react-jsx": "^5.10.0",
 		"eslint-plugin-react-naming-convention": "^5.10.0",
 		"eslint-plugin-react-x": "^5.10.0",
+		"eslint-plugin-testing-library": "^7.16.2",
 		"oxlint": ">=1.73.0",
 		"oxlint-tsgolint": ">=0.24.0"
 	},
@@ -191,6 +193,7 @@ var package_default = {
 		"eslint-plugin-react-jsx": { "optional": true },
 		"eslint-plugin-react-naming-convention": { "optional": true },
 		"eslint-plugin-react-x": { "optional": true },
+		"eslint-plugin-testing-library": { "optional": true },
 		"oxlint": { "optional": true },
 		"oxlint-tsgolint": { "optional": true }
 	},

package/dist/index.d.mts

@@ -13346,6 +13346,151 @@ interface RuleOptions {
    * @deprecated
    */
   'template-tag-spacing'?: Linter.RuleEntry<TemplateTagSpacing>;
+  /**
+   * Enforce promises from async event methods are handled
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-events.md
+   */
+  'testing-library/await-async-events'?: Linter.RuleEntry<TestingLibraryAwaitAsyncEvents>;
+  /**
+   * Enforce promises from async queries to be handled
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-queries.md
+   */
+  'testing-library/await-async-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Enforce promises from async utils to be awaited properly
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-utils.md
+   */
+  'testing-library/await-async-utils'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensures consistent usage of `data-testid`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/consistent-data-testid.md
+   */
+  'testing-library/consistent-data-testid'?: Linter.RuleEntry<TestingLibraryConsistentDataTestid>;
+  /**
+   * Disallow unnecessary `await` for sync events
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-await-sync-events.md
+   */
+  'testing-library/no-await-sync-events'?: Linter.RuleEntry<TestingLibraryNoAwaitSyncEvents>;
+  /**
+   * Disallow unnecessary `await` for sync queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-await-sync-queries.md
+   */
+  'testing-library/no-await-sync-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `container` methods
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-container.md
+   */
+  'testing-library/no-container'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of debugging utilities like `debug`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-debugging-utils.md
+   */
+  'testing-library/no-debugging-utils'?: Linter.RuleEntry<TestingLibraryNoDebuggingUtils>;
+  /**
+   * Disallow importing from DOM Testing Library
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-dom-import.md
+   */
+  'testing-library/no-dom-import'?: Linter.RuleEntry<TestingLibraryNoDomImport>;
+  /**
+   * Disallow the use of the global RegExp flag (/g) in queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-global-regexp-flag-in-query.md
+   */
+  'testing-library/no-global-regexp-flag-in-query'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `cleanup`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-manual-cleanup.md
+   */
+  'testing-library/no-manual-cleanup'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow direct Node access
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-node-access.md
+   */
+  'testing-library/no-node-access'?: Linter.RuleEntry<TestingLibraryNoNodeAccess>;
+  /**
+   * Disallow the use of promises passed to a `fireEvent` method
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-promise-in-fire-event.md
+   */
+  'testing-library/no-promise-in-fire-event'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `render` in testing frameworks setup functions
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-render-in-lifecycle.md
+   */
+  'testing-library/no-render-in-lifecycle'?: Linter.RuleEntry<TestingLibraryNoRenderInLifecycle>;
+  /**
+   * Ensure no `data-testid` queries are used
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-test-id-queries.md
+   */
+  'testing-library/no-test-id-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow wrapping Testing Library utils or empty callbacks in `act`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-unnecessary-act.md
+   */
+  'testing-library/no-unnecessary-act'?: Linter.RuleEntry<TestingLibraryNoUnnecessaryAct>;
+  /**
+   * Disallow the use of multiple `expect` calls inside `waitFor`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-multiple-assertions.md
+   */
+  'testing-library/no-wait-for-multiple-assertions'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of side effects in `waitFor`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-side-effects.md
+   */
+  'testing-library/no-wait-for-side-effects'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensures no snapshot is generated inside of a `waitFor` call
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-snapshot.md
+   */
+  'testing-library/no-wait-for-snapshot'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using explicit assertions rather than standalone queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-explicit-assert.md
+   */
+  'testing-library/prefer-explicit-assert'?: Linter.RuleEntry<TestingLibraryPreferExplicitAssert>;
+  /**
+   * Suggest using `find(All)By*` query instead of `waitFor` + `get(All)By*` to wait for elements
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-find-by.md
+   */
+  'testing-library/prefer-find-by'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using implicit assertions for getBy* & findBy* queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-implicit-assert.md
+   */
+  'testing-library/prefer-implicit-assert'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensure appropriate `get*`/`query*` queries are used with their respective matchers
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-presence-queries.md
+   */
+  'testing-library/prefer-presence-queries'?: Linter.RuleEntry<TestingLibraryPreferPresenceQueries>;
+  /**
+   * Suggest using `queryBy*` queries when waiting for disappearance
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-query-by-disappearance.md
+   */
+  'testing-library/prefer-query-by-disappearance'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensure the configured `get*`/`query*` query is used with the corresponding matchers
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-query-matchers.md
+   */
+  'testing-library/prefer-query-matchers'?: Linter.RuleEntry<TestingLibraryPreferQueryMatchers>;
+  /**
+   * Suggest using `screen` while querying
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-screen-queries.md
+   */
+  'testing-library/prefer-screen-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using `userEvent` over `fireEvent` for simulating user interactions
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-user-event.md
+   */
+  'testing-library/prefer-user-event'?: Linter.RuleEntry<TestingLibraryPreferUserEvent>;
+  /**
+   * Suggest using userEvent with setup() instead of direct methods
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-user-event-setup.md
+   */
+  'testing-library/prefer-user-event-setup'?: Linter.RuleEntry<[]>;
+  /**
+   * Enforce a valid naming for return value from `render`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/render-result-naming-convention.md
+   */
+  'testing-library/render-result-naming-convention'?: Linter.RuleEntry<[]>;
   /**
    * enforce linebreaks after opening and before closing array brackets
    * @see https://ota-meshi.github.io/eslint-plugin-toml/rules/array-bracket-newline.html
@@ -24744,6 +24889,66 @@ type SwitchColonSpacing = [] | [{
 type TemplateCurlySpacing = [] | [("always" | "never")];
 // ----- template-tag-spacing -----
 type TemplateTagSpacing = [] | [("always" | "never")];
+// ----- testing-library/await-async-events -----
+type TestingLibraryAwaitAsyncEvents = [] | [{
+  eventModule?: (("fireEvent" | "userEvent") | ("fireEvent" | "userEvent")[]);
+}];
+// ----- testing-library/consistent-data-testid -----
+type TestingLibraryConsistentDataTestid = [] | [{
+  testIdPattern: string;
+  testIdAttribute?: (string | string[]);
+  customMessage?: string;
+}];
+// ----- testing-library/no-await-sync-events -----
+type TestingLibraryNoAwaitSyncEvents = [] | [{
+  eventModules?: [("fire-event" | "user-event"), ...(("fire-event" | "user-event"))[]];
+}];
+// ----- testing-library/no-debugging-utils -----
+type TestingLibraryNoDebuggingUtils = [] | [{
+  utilsToCheckFor?: {
+    prettyFormat?: boolean;
+    logDOM?: boolean;
+    logRoles?: boolean;
+    prettyDOM?: boolean;
+    logTestingPlaygroundURL?: boolean;
+    debug?: boolean;
+  };
+}];
+// ----- testing-library/no-dom-import -----
+type TestingLibraryNoDomImport = [] | [string];
+// ----- testing-library/no-node-access -----
+type TestingLibraryNoNodeAccess = [] | [{
+  allowContainerFirstChild?: boolean;
+}];
+// ----- testing-library/no-render-in-lifecycle -----
+type TestingLibraryNoRenderInLifecycle = [] | [{
+  allowTestingFrameworkSetupHook?: ("beforeEach" | "beforeAll");
+}];
+// ----- testing-library/no-unnecessary-act -----
+type TestingLibraryNoUnnecessaryAct = [] | [{
+  isStrict?: boolean;
+}];
+// ----- testing-library/prefer-explicit-assert -----
+type TestingLibraryPreferExplicitAssert = [] | [{
+  assertion?: ("toBeOnTheScreen" | "toBeInTheDocument" | "toBeTruthy" | "toBeDefined");
+  includeFindQueries?: boolean;
+}];
+// ----- testing-library/prefer-presence-queries -----
+type TestingLibraryPreferPresenceQueries = [] | [{
+  presence?: boolean;
+  absence?: boolean;
+}];
+// ----- testing-library/prefer-query-matchers -----
+type TestingLibraryPreferQueryMatchers = [] | [{
+  validEntries?: {
+    query?: ("get" | "query");
+    matcher?: string;
+  }[];
+}];
+// ----- testing-library/prefer-user-event -----
+type TestingLibraryPreferUserEvent = [] | [{
+  allowedMethods?: unknown[];
+}];
 // ----- toml/array-bracket-newline -----
 type TomlArrayBracketNewline = [] | [(("always" | "never" | "consistent") | {
   multiline?: boolean;
@@ -26665,7 +26870,7 @@ type Yoda = [] | [("always" | "never")] | [("always" | "never"), {
   onlyEquality?: boolean;
 }];
 // Names of all the configs
-type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/jest/type-tests' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/test/vitest/type-tests' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
+type ConfigNames = 'isentinel/eslint/comments' | 'isentinel/eslint/comments/src' | 'isentinel/e18e/rules' | 'isentinel/eslint-plugin/setup' | 'isentinel/eslint-plugin/rules' | 'isentinel/flawless/setup' | 'isentinel/flawless/rules' | 'isentinel/flawless/markdown-code' | 'isentinel/flawless/rules-type-aware' | 'isentinel/gitignore' | 'isentinel/ignores' | 'isentinel/imports/rules' | 'isentinel/imports/game' | 'isentinel/javascript/setup' | 'isentinel/javascript/rules' | 'isentinel/jsdoc/setup' | 'isentinel/jsdoc' | 'isentinel/jsonc/setup' | 'isentinel/jsonc/rules' | 'isentinel/jsonc/tsconfig' | 'isentinel/markdown/setup' | 'isentinel/markdown/processor' | 'isentinel/markdown/parser' | 'isentinel/markdown/disables' | 'isentinel/naming/setup' | 'isentinel/naming/ts/rules-type-aware' | 'isentinel/naming/tsx/rules-type-aware' | 'isentinel/node/rules' | 'isentinel/oxfmt/setup' | 'isentinel/oxfmt/javascript' | 'isentinel/oxfmt/typescript' | 'isentinel/oxfmt/css' | 'isentinel/oxfmt/scss' | 'isentinel/oxfmt/less' | 'isentinel/oxfmt/html' | 'isentinel/oxfmt/markdown' | 'isentinel/oxfmt/graphql' | 'isentinel/oxfmt/json' | 'isentinel/oxfmt/yaml' | 'isentinel/package-json/setup' | 'isentinel/package-json' | 'isentinel/package-json/root' | 'isentinel/perfectionist/setup' | 'isentinel/perfectionist' | 'isentinel/perfectionist/jsx' | 'isentinel/pnpm/setup' | 'isentinel/pnpm/package-json' | 'isentinel/pnpm/pnpm-workspace-yaml' | 'isentinel/promise' | 'isentinel/react/setup' | 'isentinel/react/setup/naming' | 'isentinel/react/setup/testing-library' | 'isentinel/react/rules' | 'isentinel/react/type-aware-rules' | 'isentinel/roblox/setup' | 'isentinel/roblox/parser' | 'isentinel/roblox/type-aware-parser' | 'isentinel/roblox' | 'isentinel/roblox/rules-type-aware' | 'isentinel/roblox/format-lua/setup' | 'isentinel/roblox/format-lua' | 'isentinel/small-rules/setup' | 'isentinel/small-rules' | 'isentinel/sonarjs' | 'isentinel/spelling/setup' | 'isentinel/spelling' | 'isentinel/stylistic/setup' | 'isentinel/stylistic' | 'isentinel/test/jest/setup' | 'isentinel/test/jest/rules' | 'isentinel/test/jest/type-tests' | 'isentinel/test/vitest/setup' | 'isentinel/test/vitest/rules' | 'isentinel/test/vitest/type-tests' | 'isentinel/toml/setup' | 'isentinel/toml/rules' | 'isentinel/typescript/setup' | 'isentinel/typescript/parser' | 'isentinel/typescript/type-aware-parser' | 'isentinel/typescript/rules' | 'isentinel/typescript/rules-type-aware' | 'isentinel/typescript/erasable-syntax-only' | 'isentinel/unicorn/setup' | 'isentinel/unicorn/rules' | 'isentinel/unicorn/root' | 'isentinel/yaml/setup' | 'isentinel/yaml/rules';
 //#endregion
 //#region src/utils.d.ts
 type ExtractRuleOptions<T> = T extends Linter.RuleEntry<infer U> ? U : never;
@@ -26722,12 +26927,23 @@ interface JsdocOptions {
   full?: boolean;
 }
 type Rules = Record<string, Linter.RuleEntry<any> | undefined> & RuleOptions;
+type ConfigSettings = NonNullable<Linter.Config["settings"]> & {
+  "testing-library"?: {
+    /**
+     * Package name for DOM Testing Library.
+     *
+     * When React testing support is enabled, importing this package is
+     * forbidden in favor of `@packages/react-testing-library-lua`.
+     */
+    domPackage?: string;
+  };
+};
 /**
  * An updated version of ESLint's `Linter.Config`, which provides autocompletion
  * for `rules` and relaxes type limitations for `plugins` and `rules`, because
  * many plugins still lack proper type definitions.
  */
-type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plugins"> & {
+type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plugins" | "settings"> & {
   /**
    * The base directory that `files` and `ignores` patterns in this config
    * object are resolved against. Defaults to the location ESLint derives the
@@ -26750,6 +26966,8 @@ type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plug
    * files.
    */
   rules?: Rules;
+  /** Shared settings consumed by configured plugins and presets. */
+  settings?: ConfigSettings;
 };
 interface OptionsComponentExtensions {
   /** Additional extensions for components. */
@@ -27087,6 +27305,14 @@ type ReactConfig = OptionsOverridesTypeAware & ReactSettings & {
    * @default true
    */
   reactCompiler?: boolean;
+  /**
+   * Whether to enable Testing Library rules for testing-library-lua.
+   *
+   * Requires installing `eslint-plugin-testing-library`.
+   *
+   * @default false
+   */
+  testing?: boolean;
 } & {
   filenameCase?: "kebabCase" | "pascalCase";
 };
@@ -27326,6 +27552,10 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    *
    * - `eslint-plugin-react-naming-convention`.
    *
+   * If `testing` is enabled, also requires:
+   *
+   * - `eslint-plugin-testing-library`.
+   *
    * @default false
    */
   react?: boolean | ReactConfig;
@@ -27749,7 +27979,9 @@ declare function pnpm(options: OptionsPnpm & Required<OptionsIsInEditor>): Promi
 declare function promise(): Array<TypedFlatConfigItem>;
 //#endregion
 //#region src/eslint/configs/react.d.ts
-declare function react(options?: OptionsComponentExtensions & OptionsFiles & OptionsStylistic & OptionsTypeScriptParserOptions & OptionsTypeScriptWithTypes & ReactConfig): Promise<Array<TypedFlatConfigItem>>;
+declare function react(options?: OptionsComponentExtensions & OptionsFiles & OptionsStylistic & OptionsTypeScriptParserOptions & OptionsTypeScriptWithTypes & ReactConfig & {
+  settings?: ConfigSettings;
+}): Promise<Array<TypedFlatConfigItem>>;
 //#endregion
 //#region src/eslint/configs/roblox.d.ts
 declare function roblox$1(options?: OptionsComponentExtensions & OptionsFilesTypeAware & OptionsOverridesTypeAware & OptionsStylistic & OptionsTypeScriptParserOptions & OptionsTypeScriptWithTypes, formatLua?: boolean): Promise<Array<TypedFlatConfigItem>>;
@@ -27849,4 +28081,4 @@ declare function unicorn({ complementIgnores, nameReplacements, roblox, root: cu
 //#region src/eslint/configs/yaml.d.ts
 declare function yaml({ files, overrides, stylistic }?: OptionsFiles & OptionsOverrides & OptionsStylistic): Promise<Array<TypedFlatConfigItem>>;
 //#endregion
-export { type Awaitable, type ConfigNames, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, GitignoreOptions, type JsdocOptions, MARKDOWN_PROCESSOR_NAME, type NamedFlatConfigItem, type NamedOptionsConfig, type NamingConfig, type NamingSelector, type OptionsComponentExtensions, type OptionsConfig, type OptionsE18e, type OptionsFiles, type OptionsFilesTypeAware, type OptionsFormatters, type OptionsHasRoblox, type OptionsHasTypeScript, type OptionsIsInEditor, type OptionsJest, type OptionsOverrides, type OptionsOverridesTypeAware, type OptionsPnpm, type OptionsProjectType, type OptionsStylistic, type OptionsTestFramework, type OptionsTypeScriptErasableOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type OptionsTypescript, type OptionsUnicorn, type OptionsVitest, type OxfmtOptions, type PerfectionistConfig, type PrettierOptions, type ReactConfig, type ReactSettings, type Rules, type SpellCheckConfig, type StylisticConfig, StylisticConfigDefaults, type TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };
+export { type Awaitable, type ConfigNames, type ConfigSettings, type FlatConfigComposer, GLOB_ALL_JSON, GLOB_ALL_SRC, GLOB_BIN, GLOB_BUILD_CONFIGS, GLOB_CSS, GLOB_DTS, GLOB_EXCLUDE, GLOB_GRAPHQL, GLOB_HTML, GLOB_JS, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_LESS, GLOB_LINTABLE_EXTENSIONS, GLOB_LUA, GLOB_MARKDOWN, GLOB_MARKDOWN_BLOCKS, GLOB_MARKDOWN_CODE, GLOB_MARKDOWN_IN_MARKDOWN, GLOB_MISE, GLOB_PACKAGE_JSON, GLOB_PACKAGE_JSON_ROOT, GLOB_POSTCSS, GLOB_ROOT, GLOB_ROOT_SRC, GLOB_SCSS, GLOB_SRC, GLOB_SRC_EXT, GLOB_SRC_EXTENSIONS, GLOB_STYLE, GLOB_TESTS, GLOB_TOML, GLOB_TS, GLOB_TSCONFIG, GLOB_TSX, GLOB_TYPE_TESTS, GLOB_XML, GLOB_YAML, GitignoreOptions, type JsdocOptions, MARKDOWN_PROCESSOR_NAME, type NamedFlatConfigItem, type NamedOptionsConfig, type NamingConfig, type NamingSelector, type OptionsComponentExtensions, type OptionsConfig, type OptionsE18e, type OptionsFiles, type OptionsFilesTypeAware, type OptionsFormatters, type OptionsHasRoblox, type OptionsHasTypeScript, type OptionsIsInEditor, type OptionsJest, type OptionsOverrides, type OptionsOverridesTypeAware, type OptionsPnpm, type OptionsProjectType, type OptionsStylistic, type OptionsTestFramework, type OptionsTypeScriptErasableOnly, type OptionsTypeScriptParserOptions, type OptionsTypeScriptWithTypes, type OptionsTypescript, type OptionsUnicorn, type OptionsVitest, type OxfmtOptions, type PerfectionistConfig, type PrettierOptions, type ReactConfig, type ReactSettings, type Rules, type SpellCheckConfig, type StylisticConfig, StylisticConfigDefaults, type TypedFlatConfigItem, comments, isentinel as default, isentinel, defaultPluginRenaming, disables, e18e, eslintPlugin, flawless, gitignore, ignores$1 as ignores, imports, isAgentAutofixDisabled, isInAgentSession, isInEditorEnvironment, isInGitHooksOrLintStaged, javascript, jsdoc, jsonc, loadSmallRulesPlugin, markdown, naming, node, oxfmt, packageJson, perfectionist, pnpm, promise, react, roblox$1 as roblox, smallRules, sonarjs, sortCspell, sortGithubAction, sortMiseToml, sortPnpmWorkspace, sortRojoProject, sortTsconfig, spelling, stylistic$1 as stylistic, test, toml, typescript, unicorn, yaml };

package/dist/index.mjs

@@ -3578,6 +3578,20 @@ function promise() {
 //#endregion
 //#region src/rules/react.ts
 /**
+* Build the direct DOM Testing Library import restriction shared by both
+* engines.
+*
+* @param domPackage - Package name for DOM Testing Library.
+* @returns The configured restriction, or `undefined` when no package is set.
+*/
+function restrictedDomImportRule(domPackage) {
+	if (domPackage === void 0) return;
+	return ["error", { paths: [{
+		name: domPackage,
+		message: "Import from @packages/react-testing-library-lua instead; it re-exports the DOM utilities, and eslint-plugin-testing-library only detects one module per file."
+	}] }];
+}
+/**
 * React rules shared between the ESLint and oxlint factories.
 *
 * The type-aware react rules stay in the ESLint config (oxlint jsPlugins have
@@ -3586,7 +3600,8 @@ function promise() {
 * @param options - Shared rule options.
 * @returns The rule map.
 */
-function reactRules({ filenameCase = "kebabCase", reactCompiler = true, stylistic = true } = {}) {
+function reactRules({ domPackage, filenameCase = "kebabCase", reactCompiler = true, stylistic = true, testing = false } = {}) {
+	const restrictedDomImport = testing ? restrictedDomImportRule(domPackage) : void 0;
 	return {
 		"flawless/no-unnecessary-use-callback": "error",
 		"flawless/no-unnecessary-use-memo": "error",
@@ -3684,6 +3699,30 @@ function reactRules({ filenameCase = "kebabCase", reactCompiler = true, stylisti
 			enforceAssignment: false,
 			enforceSetterName: false
 		}],
+		...testing ? {
+			"testing-library/await-async-queries": "error",
+			"testing-library/await-async-utils": "error",
+			"testing-library/no-await-sync-events": ["error", { eventModules: ["fire-event"] }],
+			"testing-library/no-await-sync-queries": "error",
+			"testing-library/no-container": "error",
+			"testing-library/no-debugging-utils": "error",
+			"testing-library/no-global-regexp-flag-in-query": "error",
+			"testing-library/no-manual-cleanup": "error",
+			"testing-library/no-node-access": "error",
+			"testing-library/no-promise-in-fire-event": "error",
+			"testing-library/no-render-in-lifecycle": "error",
+			"testing-library/no-unnecessary-act": "error",
+			"testing-library/no-wait-for-multiple-assertions": "error",
+			"testing-library/no-wait-for-side-effects": "error",
+			"testing-library/no-wait-for-snapshot": "error",
+			"testing-library/prefer-explicit-assert": "error",
+			"testing-library/prefer-find-by": "error",
+			"testing-library/prefer-presence-queries": "error",
+			"testing-library/prefer-query-by-disappearance": "error",
+			"testing-library/prefer-screen-queries": "error",
+			"testing-library/render-result-naming-convention": "error",
+			...restrictedDomImport !== void 0 ? { "no-restricted-imports": restrictedDomImport } : {}
+		} : {},
 		...stylistic !== false ? {
 			"flawless/jsx-shorthand-boolean": "warn",
 			"flawless/jsx-shorthand-fragment": "warn",
@@ -3783,9 +3822,11 @@ function smallRules(options = {}) {
 //#region src/eslint/configs/react.ts
 init_globs();
 async function react(options = {}) {
-	const { filenameCase = "kebabCase", files = [GLOB_JSX, GLOB_TSX], filesTypeAware = [GLOB_TSX], ignoresTypeAware = [`${GLOB_MARKDOWN}/**`], importSource, overrides = {}, overridesTypeAware, reactCompiler = true, stylistic = true, typeAware = true } = options;
+	const { filenameCase = "kebabCase", files = [GLOB_JSX, GLOB_TSX], filesTypeAware = [GLOB_TSX], ignoresTypeAware = [`${GLOB_MARKDOWN}/**`], importSource, overrides = {}, overridesTypeAware, reactCompiler = true, stylistic = true, testing = false, typeAware = true } = options;
+	const domPackage = options.settings?.["testing-library"]?.domPackage;
 	await ensurePackages(["eslint-plugin-react-x", "eslint-plugin-react-jsx"]);
 	if (stylistic !== false) await ensurePackages(["eslint-plugin-react-naming-convention"]);
+	if (testing) await ensurePackages(["eslint-plugin-testing-library"]);
 	const pluginSmallRules = loadSmallRulesPlugin();
 	const pluginStylistic = lazyPlugin("@stylistic/eslint-plugin");
 	const [pluginReactCore, pluginReactJsx, pluginFlawless, pluginTs, pluginUnicorn, pluginUnusedImports] = await Promise.all([
@@ -3826,6 +3867,10 @@ async function react(options = {}) {
 			name: "isentinel/react/setup/naming",
 			plugins: { "react-naming-convention": await interopDefault(import("eslint-plugin-react-naming-convention")) }
 		}] : [],
+		...testing ? [{
+			name: "isentinel/react/setup/testing-library",
+			plugins: { "testing-library": await interopDefault(import("eslint-plugin-testing-library")) }
+		}] : [],
 		{
 			name: "isentinel/react/rules",
 			files,
@@ -3835,13 +3880,18 @@ async function react(options = {}) {
 			},
 			rules: {
 				...reactRules({
+					domPackage,
 					filenameCase,
 					reactCompiler,
-					stylistic
+					stylistic,
+					testing
 				}),
 				...overrides
 			},
-			settings: { "react-x": reactSettings }
+			settings: {
+				"react-x": reactSettings,
+				...testing ? { "testing-library/utils-module": "testing-library-lua" } : {}
+			}
 		},
 		...isTypeAware ? [{
 			name: "isentinel/react/type-aware-rules",
@@ -15065,6 +15115,7 @@ const typeAwarePrefixes = /* @__PURE__ */ new Set([
 	"small-rules",
 	"sonar",
 	"style",
+	"testing-library",
 	"toml",
 	"ts",
 	"unicorn",
@@ -15314,6 +15365,7 @@ var init_adapters = __esmMin((() => {
 		"small-rules": "@pobammer-ts/small-rules",
 		"sonar": "eslint-plugin-sonarjs",
 		"style": "@stylistic/eslint-plugin",
+		"testing-library": "eslint-plugin-testing-library",
 		"ts": "@typescript-eslint/eslint-plugin",
 		"unicorn-js": "eslint-plugin-unicorn",
 		"unused-imports": "eslint-plugin-unused-imports",
@@ -15380,6 +15432,7 @@ var init_adapters = __esmMin((() => {
 		"small-rules": NATIVE_FIRST,
 		"sonar": NATIVE_FIRST,
 		"style": NATIVE_FIRST,
+		"testing-library": "js-plugin",
 		"toml": ESLINT_ONLY,
 		"ts": NATIVE_FIRST,
 		"unicorn": NATIVE_FIRST,
@@ -16797,6 +16850,35 @@ var init_oxlint_capabilities = __esmMin((() => {
 		"symbol-description",
 		"template-curly-spacing",
 		"template-tag-spacing",
+		"testing-library/await-async-events",
+		"testing-library/await-async-queries",
+		"testing-library/await-async-utils",
+		"testing-library/consistent-data-testid",
+		"testing-library/no-await-sync-events",
+		"testing-library/no-await-sync-queries",
+		"testing-library/no-container",
+		"testing-library/no-debugging-utils",
+		"testing-library/no-dom-import",
+		"testing-library/no-global-regexp-flag-in-query",
+		"testing-library/no-manual-cleanup",
+		"testing-library/no-node-access",
+		"testing-library/no-promise-in-fire-event",
+		"testing-library/no-render-in-lifecycle",
+		"testing-library/no-test-id-queries",
+		"testing-library/no-unnecessary-act",
+		"testing-library/no-wait-for-multiple-assertions",
+		"testing-library/no-wait-for-side-effects",
+		"testing-library/no-wait-for-snapshot",
+		"testing-library/prefer-explicit-assert",
+		"testing-library/prefer-find-by",
+		"testing-library/prefer-implicit-assert",
+		"testing-library/prefer-presence-queries",
+		"testing-library/prefer-query-by-disappearance",
+		"testing-library/prefer-query-matchers",
+		"testing-library/prefer-screen-queries",
+		"testing-library/prefer-user-event",
+		"testing-library/prefer-user-event-setup",
+		"testing-library/render-result-naming-convention",
 		"ts/adjacent-overload-signatures",
 		"ts/array-type",
 		"ts/await-thenable",
@@ -19711,7 +19793,8 @@ async function isentinel(options, ...userConfigs) {
 	}
 	if (enableReact !== false) configs.push(react({
 		...resolveSubOptions(options, "react"),
-		...getOverrides(options, "react")
+		...getOverrides(options, "react"),
+		settings: options.settings
 	}));
 	if (enableJsonc !== false && !typeAwareOnly) {
 		configs.push(jsonc({

package/dist/lint-cli.mjs

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 //#region package.json
-var version = "6.0.0-beta.33";
+var version = "6.0.0-beta.34";
 //#endregion
 //#region src/lint-cli/lib/cli/types.ts
 /**

package/dist/oxlint.d.mts

@@ -10750,6 +10750,151 @@ interface RuleOptions {
    * @deprecated
    */
   'template-tag-spacing'?: Linter.RuleEntry<TemplateTagSpacing>;
+  /**
+   * Enforce promises from async event methods are handled
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-events.md
+   */
+  'testing-library/await-async-events'?: Linter.RuleEntry<TestingLibraryAwaitAsyncEvents>;
+  /**
+   * Enforce promises from async queries to be handled
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-queries.md
+   */
+  'testing-library/await-async-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Enforce promises from async utils to be awaited properly
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/await-async-utils.md
+   */
+  'testing-library/await-async-utils'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensures consistent usage of `data-testid`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/consistent-data-testid.md
+   */
+  'testing-library/consistent-data-testid'?: Linter.RuleEntry<TestingLibraryConsistentDataTestid>;
+  /**
+   * Disallow unnecessary `await` for sync events
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-await-sync-events.md
+   */
+  'testing-library/no-await-sync-events'?: Linter.RuleEntry<TestingLibraryNoAwaitSyncEvents>;
+  /**
+   * Disallow unnecessary `await` for sync queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-await-sync-queries.md
+   */
+  'testing-library/no-await-sync-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `container` methods
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-container.md
+   */
+  'testing-library/no-container'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of debugging utilities like `debug`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-debugging-utils.md
+   */
+  'testing-library/no-debugging-utils'?: Linter.RuleEntry<TestingLibraryNoDebuggingUtils>;
+  /**
+   * Disallow importing from DOM Testing Library
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-dom-import.md
+   */
+  'testing-library/no-dom-import'?: Linter.RuleEntry<TestingLibraryNoDomImport>;
+  /**
+   * Disallow the use of the global RegExp flag (/g) in queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-global-regexp-flag-in-query.md
+   */
+  'testing-library/no-global-regexp-flag-in-query'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `cleanup`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-manual-cleanup.md
+   */
+  'testing-library/no-manual-cleanup'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow direct Node access
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-node-access.md
+   */
+  'testing-library/no-node-access'?: Linter.RuleEntry<TestingLibraryNoNodeAccess>;
+  /**
+   * Disallow the use of promises passed to a `fireEvent` method
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-promise-in-fire-event.md
+   */
+  'testing-library/no-promise-in-fire-event'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of `render` in testing frameworks setup functions
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-render-in-lifecycle.md
+   */
+  'testing-library/no-render-in-lifecycle'?: Linter.RuleEntry<TestingLibraryNoRenderInLifecycle>;
+  /**
+   * Ensure no `data-testid` queries are used
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-test-id-queries.md
+   */
+  'testing-library/no-test-id-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow wrapping Testing Library utils or empty callbacks in `act`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-unnecessary-act.md
+   */
+  'testing-library/no-unnecessary-act'?: Linter.RuleEntry<TestingLibraryNoUnnecessaryAct>;
+  /**
+   * Disallow the use of multiple `expect` calls inside `waitFor`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-multiple-assertions.md
+   */
+  'testing-library/no-wait-for-multiple-assertions'?: Linter.RuleEntry<[]>;
+  /**
+   * Disallow the use of side effects in `waitFor`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-side-effects.md
+   */
+  'testing-library/no-wait-for-side-effects'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensures no snapshot is generated inside of a `waitFor` call
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/no-wait-for-snapshot.md
+   */
+  'testing-library/no-wait-for-snapshot'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using explicit assertions rather than standalone queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-explicit-assert.md
+   */
+  'testing-library/prefer-explicit-assert'?: Linter.RuleEntry<TestingLibraryPreferExplicitAssert>;
+  /**
+   * Suggest using `find(All)By*` query instead of `waitFor` + `get(All)By*` to wait for elements
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-find-by.md
+   */
+  'testing-library/prefer-find-by'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using implicit assertions for getBy* & findBy* queries
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-implicit-assert.md
+   */
+  'testing-library/prefer-implicit-assert'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensure appropriate `get*`/`query*` queries are used with their respective matchers
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-presence-queries.md
+   */
+  'testing-library/prefer-presence-queries'?: Linter.RuleEntry<TestingLibraryPreferPresenceQueries>;
+  /**
+   * Suggest using `queryBy*` queries when waiting for disappearance
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-query-by-disappearance.md
+   */
+  'testing-library/prefer-query-by-disappearance'?: Linter.RuleEntry<[]>;
+  /**
+   * Ensure the configured `get*`/`query*` query is used with the corresponding matchers
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-query-matchers.md
+   */
+  'testing-library/prefer-query-matchers'?: Linter.RuleEntry<TestingLibraryPreferQueryMatchers>;
+  /**
+   * Suggest using `screen` while querying
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-screen-queries.md
+   */
+  'testing-library/prefer-screen-queries'?: Linter.RuleEntry<[]>;
+  /**
+   * Suggest using `userEvent` over `fireEvent` for simulating user interactions
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-user-event.md
+   */
+  'testing-library/prefer-user-event'?: Linter.RuleEntry<TestingLibraryPreferUserEvent>;
+  /**
+   * Suggest using userEvent with setup() instead of direct methods
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/prefer-user-event-setup.md
+   */
+  'testing-library/prefer-user-event-setup'?: Linter.RuleEntry<[]>;
+  /**
+   * Enforce a valid naming for return value from `render`
+   * @see https://github.com/testing-library/eslint-plugin-testing-library/tree/main/docs/rules/render-result-naming-convention.md
+   */
+  'testing-library/render-result-naming-convention'?: Linter.RuleEntry<[]>;
   /**
    * enforce linebreaks after opening and before closing array brackets
    * @see https://ota-meshi.github.io/eslint-plugin-toml/rules/array-bracket-newline.html
@@ -22148,6 +22293,66 @@ type SwitchColonSpacing = [] | [{
 type TemplateCurlySpacing = [] | [("always" | "never")];
 // ----- template-tag-spacing -----
 type TemplateTagSpacing = [] | [("always" | "never")];
+// ----- testing-library/await-async-events -----
+type TestingLibraryAwaitAsyncEvents = [] | [{
+  eventModule?: (("fireEvent" | "userEvent") | ("fireEvent" | "userEvent")[]);
+}];
+// ----- testing-library/consistent-data-testid -----
+type TestingLibraryConsistentDataTestid = [] | [{
+  testIdPattern: string;
+  testIdAttribute?: (string | string[]);
+  customMessage?: string;
+}];
+// ----- testing-library/no-await-sync-events -----
+type TestingLibraryNoAwaitSyncEvents = [] | [{
+  eventModules?: [("fire-event" | "user-event"), ...(("fire-event" | "user-event"))[]];
+}];
+// ----- testing-library/no-debugging-utils -----
+type TestingLibraryNoDebuggingUtils = [] | [{
+  utilsToCheckFor?: {
+    prettyFormat?: boolean;
+    logDOM?: boolean;
+    logRoles?: boolean;
+    prettyDOM?: boolean;
+    logTestingPlaygroundURL?: boolean;
+    debug?: boolean;
+  };
+}];
+// ----- testing-library/no-dom-import -----
+type TestingLibraryNoDomImport = [] | [string];
+// ----- testing-library/no-node-access -----
+type TestingLibraryNoNodeAccess = [] | [{
+  allowContainerFirstChild?: boolean;
+}];
+// ----- testing-library/no-render-in-lifecycle -----
+type TestingLibraryNoRenderInLifecycle = [] | [{
+  allowTestingFrameworkSetupHook?: ("beforeEach" | "beforeAll");
+}];
+// ----- testing-library/no-unnecessary-act -----
+type TestingLibraryNoUnnecessaryAct = [] | [{
+  isStrict?: boolean;
+}];
+// ----- testing-library/prefer-explicit-assert -----
+type TestingLibraryPreferExplicitAssert = [] | [{
+  assertion?: ("toBeOnTheScreen" | "toBeInTheDocument" | "toBeTruthy" | "toBeDefined");
+  includeFindQueries?: boolean;
+}];
+// ----- testing-library/prefer-presence-queries -----
+type TestingLibraryPreferPresenceQueries = [] | [{
+  presence?: boolean;
+  absence?: boolean;
+}];
+// ----- testing-library/prefer-query-matchers -----
+type TestingLibraryPreferQueryMatchers = [] | [{
+  validEntries?: {
+    query?: ("get" | "query");
+    matcher?: string;
+  }[];
+}];
+// ----- testing-library/prefer-user-event -----
+type TestingLibraryPreferUserEvent = [] | [{
+  allowedMethods?: unknown[];
+}];
 // ----- toml/array-bracket-newline -----
 type TomlArrayBracketNewline = [] | [(("always" | "never" | "consistent") | {
   multiline?: boolean;
@@ -24094,12 +24299,23 @@ interface JsdocOptions {
   full?: boolean;
 }
 type Rules = Record<string, Linter.RuleEntry<any> | undefined> & RuleOptions;
+type ConfigSettings = NonNullable<Linter.Config["settings"]> & {
+  "testing-library"?: {
+    /**
+     * Package name for DOM Testing Library.
+     *
+     * When React testing support is enabled, importing this package is
+     * forbidden in favor of `@packages/react-testing-library-lua`.
+     */
+    domPackage?: string;
+  };
+};
 /**
  * An updated version of ESLint's `Linter.Config`, which provides autocompletion
  * for `rules` and relaxes type limitations for `plugins` and `rules`, because
  * many plugins still lack proper type definitions.
  */
-type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plugins"> & {
+type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plugins" | "settings"> & {
   /**
    * The base directory that `files` and `ignores` patterns in this config
    * object are resolved against. Defaults to the location ESLint derives the
@@ -24122,6 +24338,8 @@ type TypedFlatConfigItem = Omit<Linter.Config<Linter.RulesRecord & Rules>, "plug
    * files.
    */
   rules?: Rules;
+  /** Shared settings consumed by configured plugins and presets. */
+  settings?: ConfigSettings;
 };
 interface OptionsComponentExtensions {
   /** Additional extensions for components. */
@@ -24442,6 +24660,14 @@ type ReactConfig = OptionsOverridesTypeAware & ReactSettings & {
    * @default true
    */
   reactCompiler?: boolean;
+  /**
+   * Whether to enable Testing Library rules for testing-library-lua.
+   *
+   * Requires installing `eslint-plugin-testing-library`.
+   *
+   * @default false
+   */
+  testing?: boolean;
 } & {
   filenameCase?: "kebabCase" | "pascalCase";
 };
@@ -24681,6 +24907,10 @@ interface OptionsConfig extends OptionsComponentExtensions, OptionsProjectType {
    *
    * - `eslint-plugin-react-naming-convention`.
    *
+   * If `testing` is enabled, also requires:
+   *
+   * - `eslint-plugin-testing-library`.
+   *
    * @default false
    */
   react?: boolean | ReactConfig;
@@ -32714,7 +32944,7 @@ type OxlintCommentsRequireDescription = [] | [{
   ignore?: ("oxlint-disable" | "oxlint-disable-line" | "oxlint-disable-next-line" | "oxlint-enable")[];
 }];
 /** JsPlugin prefixes whose rules keep their ESLint-side names in oxlint configs. */
-type OxlintKeptJsPluginPrefix = '@cspell' | 'antfu' | 'better-max-params' | 'comment-length' | 'de-morgan' | 'e18e' | 'erasable-syntax-only' | 'eslint-plugin' | 'flawless' | 'jest-extended' | 'oxfmt' | 'perfectionist' | 'react-jsx' | 'react-naming-convention' | 'roblox' | 'sentinel' | 'small-rules' | 'sonar' | 'style' | 'ts' | 'unused-imports';
+type OxlintKeptJsPluginPrefix = '@cspell' | 'antfu' | 'better-max-params' | 'comment-length' | 'de-morgan' | 'e18e' | 'erasable-syntax-only' | 'eslint-plugin' | 'flawless' | 'jest-extended' | 'oxfmt' | 'perfectionist' | 'react-jsx' | 'react-naming-convention' | 'roblox' | 'sentinel' | 'small-rules' | 'sonar' | 'style' | 'testing-library' | 'ts' | 'unused-imports';
 /** JsPlugin rules whose oxlint names match the ESLint-side names. */
 type OxlintKeptJsPluginRuleOptions = { [K in keyof RuleOptions as K extends `${OxlintKeptJsPluginPrefix}/${string}` ? K : never]: RuleOptions[K]; };
 /** All rules known to the oxlint factory, keyed by canonical oxlint rule name. */

package/dist/oxlint.mjs

@@ -1223,6 +1223,35 @@ const jsPluginRuleNames = /* @__PURE__ */ new Set([
 	"symbol-description",
 	"template-curly-spacing",
 	"template-tag-spacing",
+	"testing-library/await-async-events",
+	"testing-library/await-async-queries",
+	"testing-library/await-async-utils",
+	"testing-library/consistent-data-testid",
+	"testing-library/no-await-sync-events",
+	"testing-library/no-await-sync-queries",
+	"testing-library/no-container",
+	"testing-library/no-debugging-utils",
+	"testing-library/no-dom-import",
+	"testing-library/no-global-regexp-flag-in-query",
+	"testing-library/no-manual-cleanup",
+	"testing-library/no-node-access",
+	"testing-library/no-promise-in-fire-event",
+	"testing-library/no-render-in-lifecycle",
+	"testing-library/no-test-id-queries",
+	"testing-library/no-unnecessary-act",
+	"testing-library/no-wait-for-multiple-assertions",
+	"testing-library/no-wait-for-side-effects",
+	"testing-library/no-wait-for-snapshot",
+	"testing-library/prefer-explicit-assert",
+	"testing-library/prefer-find-by",
+	"testing-library/prefer-implicit-assert",
+	"testing-library/prefer-presence-queries",
+	"testing-library/prefer-query-by-disappearance",
+	"testing-library/prefer-query-matchers",
+	"testing-library/prefer-screen-queries",
+	"testing-library/prefer-user-event",
+	"testing-library/prefer-user-event-setup",
+	"testing-library/render-result-naming-convention",
 	"ts/adjacent-overload-signatures",
 	"ts/array-type",
 	"ts/await-thenable",
@@ -3427,6 +3456,27 @@ const enabledPresetRuleNames = /* @__PURE__ */ new Set([
 	"style/wrap-iife",
 	"style/yield-star-spacing",
 	"symbol-description",
+	"testing-library/await-async-queries",
+	"testing-library/await-async-utils",
+	"testing-library/no-await-sync-events",
+	"testing-library/no-await-sync-queries",
+	"testing-library/no-container",
+	"testing-library/no-debugging-utils",
+	"testing-library/no-global-regexp-flag-in-query",
+	"testing-library/no-manual-cleanup",
+	"testing-library/no-node-access",
+	"testing-library/no-promise-in-fire-event",
+	"testing-library/no-render-in-lifecycle",
+	"testing-library/no-unnecessary-act",
+	"testing-library/no-wait-for-multiple-assertions",
+	"testing-library/no-wait-for-side-effects",
+	"testing-library/no-wait-for-snapshot",
+	"testing-library/prefer-explicit-assert",
+	"testing-library/prefer-find-by",
+	"testing-library/prefer-presence-queries",
+	"testing-library/prefer-query-by-disappearance",
+	"testing-library/prefer-screen-queries",
+	"testing-library/render-result-naming-convention",
 	"toml/array-bracket-newline",
 	"toml/array-bracket-spacing",
 	"toml/array-element-newline",
@@ -4698,6 +4748,7 @@ const oxlintJsPlugins = {
 	"small-rules": "@pobammer-ts/small-rules",
 	"sonar": "eslint-plugin-sonarjs",
 	"style": "@stylistic/eslint-plugin",
+	"testing-library": "eslint-plugin-testing-library",
 	"ts": "@typescript-eslint/eslint-plugin",
 	"unicorn-js": "eslint-plugin-unicorn",
 	"unused-imports": "eslint-plugin-unused-imports",
@@ -4787,6 +4838,7 @@ const oxlintFamilyPolicies = {
 	"small-rules": NATIVE_FIRST,
 	"sonar": NATIVE_FIRST,
 	"style": NATIVE_FIRST,
+	"testing-library": "js-plugin",
 	"toml": ESLINT_ONLY,
 	"ts": NATIVE_FIRST,
 	"unicorn": NATIVE_FIRST,
@@ -7777,6 +7829,20 @@ function oxlintPromise() {
 //#endregion
 //#region src/rules/react.ts
 /**
+* Build the direct DOM Testing Library import restriction shared by both
+* engines.
+*
+* @param domPackage - Package name for DOM Testing Library.
+* @returns The configured restriction, or `undefined` when no package is set.
+*/
+function restrictedDomImportRule(domPackage) {
+	if (domPackage === void 0) return;
+	return ["error", { paths: [{
+		name: domPackage,
+		message: "Import from @packages/react-testing-library-lua instead; it re-exports the DOM utilities, and eslint-plugin-testing-library only detects one module per file."
+	}] }];
+}
+/**
 * React rules shared between the ESLint and oxlint factories.
 *
 * The type-aware react rules stay in the ESLint config (oxlint jsPlugins have
@@ -7785,7 +7851,8 @@ function oxlintPromise() {
 * @param options - Shared rule options.
 * @returns The rule map.
 */
-function reactRules({ filenameCase = "kebabCase", reactCompiler = true, stylistic = true } = {}) {
+function reactRules({ domPackage, filenameCase = "kebabCase", reactCompiler = true, stylistic = true, testing = false } = {}) {
+	const restrictedDomImport = testing ? restrictedDomImportRule(domPackage) : void 0;
 	return {
 		"flawless/no-unnecessary-use-callback": "error",
 		"flawless/no-unnecessary-use-memo": "error",
@@ -7883,6 +7950,30 @@ function reactRules({ filenameCase = "kebabCase", reactCompiler = true, stylisti
 			enforceAssignment: false,
 			enforceSetterName: false
 		}],
+		...testing ? {
+			"testing-library/await-async-queries": "error",
+			"testing-library/await-async-utils": "error",
+			"testing-library/no-await-sync-events": ["error", { eventModules: ["fire-event"] }],
+			"testing-library/no-await-sync-queries": "error",
+			"testing-library/no-container": "error",
+			"testing-library/no-debugging-utils": "error",
+			"testing-library/no-global-regexp-flag-in-query": "error",
+			"testing-library/no-manual-cleanup": "error",
+			"testing-library/no-node-access": "error",
+			"testing-library/no-promise-in-fire-event": "error",
+			"testing-library/no-render-in-lifecycle": "error",
+			"testing-library/no-unnecessary-act": "error",
+			"testing-library/no-wait-for-multiple-assertions": "error",
+			"testing-library/no-wait-for-side-effects": "error",
+			"testing-library/no-wait-for-snapshot": "error",
+			"testing-library/prefer-explicit-assert": "error",
+			"testing-library/prefer-find-by": "error",
+			"testing-library/prefer-presence-queries": "error",
+			"testing-library/prefer-query-by-disappearance": "error",
+			"testing-library/prefer-screen-queries": "error",
+			"testing-library/render-result-naming-convention": "error",
+			...restrictedDomImport !== void 0 ? { "no-restricted-imports": restrictedDomImport } : {}
+		} : {},
 		...stylistic !== false ? {
 			"flawless/jsx-shorthand-boolean": "warn",
 			"flawless/jsx-shorthand-fragment": "warn",
@@ -7929,7 +8020,7 @@ function reactRules({ filenameCase = "kebabCase", reactCompiler = true, stylisti
 * @returns The react config fragments.
 */
 function oxlintReact(options = {}) {
-	const { filenameCase = "kebabCase", importSource, overrides = {}, reactCompiler = true, roblox = true, stylistic = true } = options;
+	const { domPackage = options.settings?.["testing-library"]?.domPackage, filenameCase = "kebabCase", importSource, overrides = {}, reactCompiler = true, roblox = true, stylistic = true, testing = false } = options;
 	const files = options.files?.flat() ?? ["**/*.{,c,m}jsx", "**/*.{,c,m}tsx"];
 	const performanceRule = roblox ? ["error", { nativeAllowList: "all" }] : "error";
 	return [...createOxlintConfigs({
@@ -7937,14 +8028,20 @@ function oxlintReact(options = {}) {
 		files,
 		overrides,
 		rules: reactRules({
+			domPackage,
 			filenameCase,
 			reactCompiler,
-			stylistic
+			stylistic,
+			testing
 		}),
-		settings: { "react-x": {
-			importSource: importSource ?? "@rbxts",
-			version: "17.0.2"
-		} }
+		settings: {
+			"react-x": {
+				importSource: importSource ?? "@rbxts",
+				version: "17.0.2"
+			},
+			...testing ? { "testing-library/utils-module": "testing-library-lua" } : {},
+			...options.settings?.["testing-library"] ? { "testing-library": options.settings["testing-library"] } : {}
+		}
 	}), {
 		name: "isentinel/react/perf",
 		files,
@@ -9200,6 +9297,7 @@ function isentinel(factoryOptions, ...userConfigs) {
 		const reactOptions = typeof enableReact === "object" ? enableReact : {};
 		configs.push(oxlintReact({
 			roblox: enableRoblox,
+			settings: options.settings,
 			stylistic: stylisticOptions,
 			...reactOptions
 		}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isentinel/eslint-config",
-  "version": "6.0.0-beta.33",
+  "version": "6.0.0-beta.34",
   "description": "iSentinel's ESLint config",
   "keywords": [
     "eslint-config",
@@ -130,6 +130,7 @@
     "eslint-plugin-react-jsx": "5.17.3",
     "eslint-plugin-react-naming-convention": "5.17.3",
     "eslint-plugin-react-x": "5.17.3",
+    "eslint-plugin-testing-library": "7.16.2",
     "eslint-typegen": "2.3.1",
     "jiti": "2.7.0",
     "oxlint": "1.74.0",
@@ -142,7 +143,7 @@
     "typescript": "6.0.3",
     "unplugin-unused": "0.5.7",
     "vitest": "4.1.10",
-    "@isentinel/eslint-config": "6.0.0-beta.33"
+    "@isentinel/eslint-config": "6.0.0-beta.34"
   },
   "peerDependencies": {
     "@vitest/eslint-plugin": "^1.6.4",
@@ -154,6 +155,7 @@
     "eslint-plugin-react-jsx": "^5.10.0",
     "eslint-plugin-react-naming-convention": "^5.10.0",
     "eslint-plugin-react-x": "^5.10.0",
+    "eslint-plugin-testing-library": "^7.16.2",
     "oxlint": ">=1.73.0",
     "oxlint-tsgolint": ">=0.24.0"
   },
@@ -182,6 +184,9 @@
     "eslint-plugin-react-x": {
       "optional": true
     },
+    "eslint-plugin-testing-library": {
+      "optional": true
+    },
     "oxlint": {
       "optional": true
     },