@open-xchange/linter-presets 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## [0.5.0] - 2024-08-15
+
+- added: [ESLint] option `testingLib` for environment `env.vitest`
+- added: [ESLint] plugins `testing-library`, `jest-dom`, and option `testingLib` for environment `env.jest`
+- added: [ESLint] option `jestDom` for environments `env.jest` and `env.vitest`
+- chore: bump dependencies
+
+## [0.4.3] - 2024-08-08
+
+- chore: bump dependencies
+
 ## [0.4.2] - 2024-08-06
 
 - added: [ESLint] rules `jsdoc/check-template-names`, `jsdoc/require-asterisk-prefix`

package/dist/eslint/env/browser.d.ts

@@ -1,5 +1,5 @@
 import type { TSESLint } from "@typescript-eslint/utils";
-import type { EnvRestrictedOptions } from "../shared/env-utils.js";
+import type { EnvRestrictedOptions } from "../shared/restricted.js";
 /**
  * Configuration options for the environment preset "env.browser".
  */

package/dist/eslint/env/browser.js

@@ -1,6 +1,7 @@
 import JAVASCRIPT_GLOBALS from "globals";
 import CONFUSING_BROWSER_GLOBALS from "confusing-browser-globals";
-import { concatConfigs, createConfig, restrictedRules, customRules } from "../shared/env-utils.js";
+import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
+import { restrictedRules } from "../shared/restricted.js";
 // constants ==================================================================
 /**
  * Global builtin symbols that are confusing or deprecated.

package/dist/eslint/env/jest.d.ts

@@ -1,9 +1,9 @@
 import type { TSESLint } from "@typescript-eslint/utils";
-import type { EnvBaseOptions } from "../shared/env-utils.js";
+import { type EnvUnitTestOptions } from "../shared/unittest.js";
 /**
  * Configuration options for the environment preset "env.jest".
  */
-export interface EnvJestOptions extends EnvBaseOptions {
+export interface EnvJestOptions extends EnvUnitTestOptions {
 }
 /**
  * Creates configuration objects with global symbols and linter rules for unit
@@ -11,6 +11,7 @@ export interface EnvJestOptions extends EnvBaseOptions {
  *
  * Wraps the following packages:
  * - `eslint-plugin-jest`
+ * - `eslint-plugin-testing-library`
  *
  * @param envOptions
  *  Configuration options for the environment.

package/dist/eslint/env/jest.js

@@ -1,5 +1,6 @@
 import jestPlugin from "eslint-plugin-jest";
 import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
+import { createUnitTestPluginConfigs } from "../shared/unittest.js";
 // functions ==================================================================
 /**
  * Creates configuration objects with global symbols and linter rules for unit
@@ -7,6 +8,7 @@ import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js
  *
  * Wraps the following packages:
  * - `eslint-plugin-jest`
+ * - `eslint-plugin-testing-library`
  *
  * @param envOptions
  *  Configuration options for the environment.
@@ -19,9 +21,9 @@ export default function jest(envOptions) {
     // register rule implementations, globals, and recommended rules
     createConfig(envOptions, jestPlugin.configs["flat/recommended"]), 
     // add recommended stylistic rules
-    createConfig(envOptions, {
-        rules: jestPlugin.configs["flat/style"].rules,
-    }), 
+    createConfig(envOptions, jestPlugin.configs["flat/style"]), 
+    // "jest-dom" and "testing-library" plugin
+    createUnitTestPluginConfigs(envOptions), 
     // custom rules
     customRules(envOptions, {
         "jest/consistent-test-it": ["error", { fn: "it" }],

package/dist/eslint/env/node.d.ts

@@ -1,6 +1,7 @@
 import type { TSESLint } from "@typescript-eslint/utils";
 import type ts from "typescript";
-import type { LanguageOptions, EnvRestrictedOptions } from "../shared/env-utils.js";
+import type { LanguageOptions } from "../shared/env-utils.js";
+import { type EnvRestrictedOptions } from "../shared/restricted.js";
 export type EnvNodeConvertPathPattern = [pattern: string, replacement: string];
 export type EnvNodeConvertPathObject = Record<string, EnvNodeConvertPathPattern>;
 export interface EnvNodeConvertPathArray {

package/dist/eslint/env/node.js

@@ -1,5 +1,6 @@
 import nodePlugin from "eslint-plugin-n";
-import { concatConfigs, createConfig, restrictedRules, customRules } from "../shared/env-utils.js";
+import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
+import { restrictedRules } from "../shared/restricted.js";
 // functions ==================================================================
 /**
  * Creates configuration objects with global symbols and linter rules for

package/dist/eslint/env/vitest.d.ts

@@ -1,9 +1,9 @@
 import type { TSESLint } from "@typescript-eslint/utils";
-import type { EnvBaseOptions } from "../shared/env-utils.js";
+import { type EnvUnitTestOptions } from "../shared/unittest.js";
 /**
  * Configuration options for the environment preset "env.vitest".
  */
-export interface EnvVitestOptions extends EnvBaseOptions {
+export interface EnvVitestOptions extends EnvUnitTestOptions {
 }
 /**
  * Creates configuration objects with global symbols and linter rules for unit

package/dist/eslint/env/vitest.js

@@ -1,8 +1,6 @@
 import vitestPlugin from "eslint-plugin-vitest";
-import jestDomPlugin from "eslint-plugin-jest-dom";
-import testingLibraryPlugin from "eslint-plugin-testing-library";
-import { fixupPluginRules } from "@eslint/compat";
 import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
+import { createUnitTestPluginConfigs } from "../shared/unittest.js";
 // functions ==================================================================
 /**
  * Creates configuration objects with global symbols and linter rules for unit
@@ -34,17 +32,8 @@ export default function vitest(envOptions) {
         // recommended rules
         rules: vitestPlugin.configs.recommended.rules,
     }), 
-    // "jest-dom" plugin
-    createConfig(envOptions, jestDomPlugin.configs["flat/recommended"]), 
-    // "testing-library" plugin
-    createConfig(envOptions, {
-        // register rule implementations of the plugins
-        plugins: {
-            "testing-library": fixupPluginRules(testingLibraryPlugin), // https://github.com/testing-library/eslint-plugin-testing-library/issues/899
-        },
-        // recommended rules
-        rules: testingLibraryPlugin.configs.react.rules,
-    }), 
+    // "jest-dom" and "testing-library" plugin
+    createUnitTestPluginConfigs(envOptions), 
     // custom rules
     customRules(envOptions, {
         // "vitest" plugin
@@ -69,7 +58,5 @@ export default function vitest(envOptions) {
         "vitest/prefer-to-contain": "error",
         "vitest/prefer-to-have-length": "error",
         "vitest/require-top-level-describe": "error",
-        // "testing-library" plugin
-        "testing-library/no-node-access": ["error", { allowContainerFirstChild: true }],
     }));
 }

package/dist/eslint/shared/env-utils.d.ts

@@ -84,79 +84,6 @@ export interface EnvBaseOptions extends EnvFilesOptions {
      */
     rules?: TSESLint.FlatConfig.Rules;
 }
-/**
- * Configuration for a single banned global or import.
- */
-export interface EnvRestrictedName {
-    name: string;
-    message: string;
-}
-/**
- * Configuration for a single banned object property.
- */
-export interface EnvRestrictedProperty {
-    object: string;
-    property: string;
-    message: string;
-}
-/**
- * Configuration for a single banned syntax construct.
- */
-export interface EnvRestrictedSyntax {
-    selector: string;
-    message: string;
-}
-/**
- * Collection of banned globals, imports, properties, and syntax constructs.
- */
-export interface EnvRestrictedItems {
-    /** The global symbols to be banned. */
-    globals?: EnvRestrictedName[];
-    /** The module imports to be banned. */
-    imports?: EnvRestrictedName[];
-    /** The global object properties to be banned. */
-    properties?: EnvRestrictedProperty[];
-    /** The syntax constructs to be banned. */
-    syntax?: EnvRestrictedSyntax[];
-}
-/**
- * Collection of banned globals, imports, properties, and syntax constructs,
- * for a specific subset of the files included in an environment.
- */
-export interface EnvRestrictedOverride extends EnvFilesOptions, EnvRestrictedItems {
-}
-/**
- * Type shape of a dedicated environment option "restricted" with settings for
- * banned globals, imports, properties, and syntax constructs.
- */
-export interface EnvRestrictedOption extends EnvRestrictedItems {
-    /**
-     * Whether the environment supports native decorators. In this case, it
-     * will be required to replace TypeScript decorated `private` methods with
-     * native `#private` methods.
-     *
-     * Default value is `false` (TypeScript's experimental decorators cannot be
-     * used with native `#private` fields).
-     */
-    nativeDecorators?: boolean;
-    /**
-     * Overrides for specific subsets of files in the environment. All
-     * restricted items of overrides will be merged with the common restricted
-     * items defined for the entire environment.
-     */
-    overrides?: EnvRestrictedOverride[];
-}
-/**
- * Shared options for an environment preset: include and exclude files, add
- * more linter rules, and settings for restricted items.
- */
-export interface EnvRestrictedOptions extends EnvBaseOptions {
-    /**
-     * All globals, imports, properties, and syntax constructs to be banned for
-     * the files included by the environment.
-     */
-    restricted?: EnvRestrictedOption;
-}
 /**
  * Shared options for the core rule `no-unused-vars`, and the plugin rule
  * `@typescript-eslint/no-unused-vars`.
@@ -168,6 +95,20 @@ export declare const NO_UNUSED_VARS_OPTIONS: {
     caughtErrors: string;
     ignoreRestSiblings: boolean;
 };
+/**
+ * Concatenates and flattens multiple elements or arrays into a single array
+ * while skipping all falsy parameters.
+ *
+ * @template T
+ *  The type of the array elements.
+ *
+ * @param entries
+ *  The elements or arrays to be concatenated.
+ *
+ * @returns
+ *  The concatenated and flattened array.
+ */
+export declare function flatArray<T>(...entries: Array<T | T[] | false | null | undefined>): T[];
 /**
  * Concatenates multiple configuration objects or arrays into an array while
  * skipping all falsy parameters.
@@ -178,7 +119,7 @@ export declare const NO_UNUSED_VARS_OPTIONS: {
  * @returns
  *  The concatenated configuration array.
  */
-export declare const concatConfigs: (...entries: (TSESLint.FlatConfig.Config | TSESLint.FlatConfig.Config[] | undefined)[]) => TSESLint.FlatConfig.Config[];
+export declare const concatConfigs: (...entries: (false | TSESLint.FlatConfig.Config | TSESLint.FlatConfig.Config[] | null | undefined)[]) => TSESLint.FlatConfig.Config[];
 /**
  * Creates a flat configuration object with "files" and "ignores" settings from
  * an environment's "envOptions" object.
@@ -190,24 +131,13 @@ export declare const concatConfigs: (...entries: (TSESLint.FlatConfig.Config | T
  *  Properties for the flat configuration to be built. Additional "files" and
  *  "ignores" properties will be merged with the settings from "envOptions".
  *
- * @returns
- *  The resulting flat configuration object.
- */
-export declare function createConfig(envOptions: EnvFilesOptions, flatConfig: TSESLint.FlatConfig.Config): TSESLint.FlatConfig.Config;
-/**
- * Generates various "no-restricted-?" rules from the passed configuration.
- *
- * @param envOptions
- *  The environment options containing "files", "ignores", and "restricted"
- *  settings.
- *
- * @param fixed
- *  The fixed restricted items provided by the environment preset.
+ * @param rules
+ *  Hard-coded rule settings to be added to the configuration.
  *
  * @returns
- *  The flat configuration objects needed to forbid the restricted items.
+ *  The resulting flat configuration object.
  */
-export declare function restrictedRules(envOptions: EnvRestrictedOptions, fixed?: EnvRestrictedItems): TSESLint.FlatConfig.ConfigArray;
+export declare function createConfig(envOptions: EnvFilesOptions, flatConfig: TSESLint.FlatConfig.Config, rules?: TSESLint.FlatConfig.Rules): TSESLint.FlatConfig.Config;
 /**
  * Creates a flat configuration object with "files", "ignores", and "rules"
  * settings from an environment's "envOptions" object.

package/dist/eslint/shared/env-utils.js

@@ -24,34 +24,9 @@ export const NO_UNUSED_VARS_OPTIONS = {
  * @returns
  *  The concatenated and flattened array.
  */
-function flatten(...entries) {
-    return entries.flatMap(array => array ?? []);
+export function flatArray(...entries) {
+    return entries.flatMap(array => array || []);
 }
-/**
- * Creates a rules record for all restricted items.
- *
- * @param generator
- *  The generator callback function that returns the restricted items to be
- *  inserted into the linter rules.
- *
- * @returns
- *  The rules record containing entries for all existing restricted items.
- */
-function createRulesRecord(generator) {
-    const rules = {};
-    for (const key of ["globals", "imports", "properties", "syntax"]) {
-        const items = generator(key);
-        if (items?.length) {
-            rules[`no-restricted-${key}`] = ["error", ...items];
-        }
-    }
-    // same restrictions for CommonJS `require` as for `import` statements
-    if ("no-restricted-imports" in rules) {
-        rules["no-restricted-modules"] = rules["no-restricted-imports"];
-    }
-    return rules;
-}
-// ----------------------------------------------------------------------------
 /**
  * Concatenates multiple configuration objects or arrays into an array while
  * skipping all falsy parameters.
@@ -62,7 +37,7 @@ function createRulesRecord(generator) {
  * @returns
  *  The concatenated configuration array.
  */
-export const concatConfigs = (flatten);
+export const concatConfigs = (flatArray);
 /**
  * Creates a flat configuration object with "files" and "ignores" settings from
  * an environment's "envOptions" object.
@@ -74,57 +49,19 @@ export const concatConfigs = (flatten);
  *  Properties for the flat configuration to be built. Additional "files" and
  *  "ignores" properties will be merged with the settings from "envOptions".
  *
+ * @param rules
+ *  Hard-coded rule settings to be added to the configuration.
+ *
  * @returns
  *  The resulting flat configuration object.
  */
-export function createConfig(envOptions, flatConfig) {
+export function createConfig(envOptions, flatConfig, rules) {
     return {
         ...flatConfig,
-        files: flatten(envOptions.files, flatConfig.files),
-        ignores: flatten(envOptions.ignores, flatConfig.ignores),
-    };
-}
-/**
- * Generates various "no-restricted-?" rules from the passed configuration.
- *
- * @param envOptions
- *  The environment options containing "files", "ignores", and "restricted"
- *  settings.
- *
- * @param fixed
- *  The fixed restricted items provided by the environment preset.
- *
- * @returns
- *  The flat configuration objects needed to forbid the restricted items.
- */
-export function restrictedRules(envOptions, fixed) {
-    const { restricted = {} } = envOptions;
-    const RESTRICTED_GLOBALS = [
-        { name: "isFinite", message: "Use 'Number.isFinite' instead." },
-        { name: "isNaN", message: "Use 'Number.isNaN' instead." },
-    ];
-    const RESTRICTED_SYNTAX = [
-        { selector: ":matches(PropertyDefinition, MethodDefinition[kind!='constructor'])[accessibility='public']", message: "Remove 'public' keyword." },
-        { selector: ":matches(PropertyDefinition, MethodDefinition[kind!='constructor'])[accessibility='private']" + (restricted.nativeDecorators ? "" : "[decorators.length=0]"), message: "Use #private syntax instead." },
-        { selector: "MethodDefinition[kind='constructor'] TSParameterProperty[accessibility]", message: "Use explicit class properties." },
-    ];
-    // restricted items for all files in the environment
-    const items = {
-        globals: flatten(RESTRICTED_GLOBALS, fixed?.globals, restricted.globals),
-        imports: flatten(fixed?.imports, restricted.imports),
-        properties: flatten(fixed?.properties, restricted.properties),
-        syntax: flatten(RESTRICTED_SYNTAX, fixed?.syntax, restricted.syntax),
+        files: flatArray(envOptions.files, flatConfig.files),
+        ignores: flatArray(envOptions.ignores, flatConfig.ignores),
+        rules: { ...flatConfig.rules, ...rules },
     };
-    // generate the configuration objects
-    return concatConfigs(
-    // base rules for all files in the environment
-    createConfig(envOptions, {
-        rules: createRulesRecord(key => items[key]),
-    }), 
-    // generate the override entries (join with base items)
-    restricted.overrides?.map(override => createConfig(override, {
-        rules: createRulesRecord(key => flatten(items[key], override[key])),
-    })));
 }
 /**
  * Creates a flat configuration object with "files", "ignores", and "rules"

package/dist/eslint/shared/restricted.d.ts

@@ -0,0 +1,89 @@
+import type { TSESLint } from "@typescript-eslint/utils";
+import type { EnvFilesOptions, EnvBaseOptions } from "../shared/env-utils.js";
+/**
+ * Configuration for a single banned global or import.
+ */
+export interface EnvRestrictedName {
+    name: string;
+    message: string;
+}
+/**
+ * Configuration for a single banned object property.
+ */
+export interface EnvRestrictedProperty {
+    object: string;
+    property: string;
+    message: string;
+}
+/**
+ * Configuration for a single banned syntax construct.
+ */
+export interface EnvRestrictedSyntax {
+    selector: string;
+    message: string;
+}
+/**
+ * Collection of banned globals, imports, properties, and syntax constructs.
+ */
+export interface EnvRestrictedItems {
+    /** The global symbols to be banned. */
+    globals?: EnvRestrictedName[];
+    /** The module imports to be banned. */
+    imports?: EnvRestrictedName[];
+    /** The global object properties to be banned. */
+    properties?: EnvRestrictedProperty[];
+    /** The syntax constructs to be banned. */
+    syntax?: EnvRestrictedSyntax[];
+}
+/**
+ * Collection of banned globals, imports, properties, and syntax constructs,
+ * for a specific subset of the files included in an environment.
+ */
+export interface EnvRestrictedOverride extends EnvFilesOptions, EnvRestrictedItems {
+}
+/**
+ * Type shape of a dedicated environment option "restricted" with settings for
+ * banned globals, imports, properties, and syntax constructs.
+ */
+export interface EnvRestrictedOption extends EnvRestrictedItems {
+    /**
+     * Whether the environment supports native decorators. In this case, it
+     * will be required to replace TypeScript decorated `private` methods with
+     * native `#private` methods.
+     *
+     * Default value is `false` (TypeScript's experimental decorators cannot be
+     * used with native `#private` fields).
+     */
+    nativeDecorators?: boolean;
+    /**
+     * Overrides for specific subsets of files in the environment. All
+     * restricted items of overrides will be merged with the common restricted
+     * items defined for the entire environment.
+     */
+    overrides?: EnvRestrictedOverride[];
+}
+/**
+ * Shared options for an environment preset: include and exclude files, add
+ * more linter rules, and settings for restricted items.
+ */
+export interface EnvRestrictedOptions extends EnvBaseOptions {
+    /**
+     * All globals, imports, properties, and syntax constructs to be banned for
+     * the files included by the environment.
+     */
+    restricted?: EnvRestrictedOption;
+}
+/**
+ * Generates various "no-restricted-?" rules from the passed configuration.
+ *
+ * @param envOptions
+ *  The environment options containing "files", "ignores", and "restricted"
+ *  settings.
+ *
+ * @param fixed
+ *  The fixed restricted items provided by the environment preset.
+ *
+ * @returns
+ *  The flat configuration objects needed to forbid the restricted items.
+ */
+export declare function restrictedRules(envOptions: EnvRestrictedOptions, fixed?: EnvRestrictedItems): TSESLint.FlatConfig.ConfigArray;

package/dist/eslint/shared/restricted.js

@@ -0,0 +1,69 @@
+import { flatArray, concatConfigs, createConfig } from "../shared/env-utils.js";
+// functions ==================================================================
+/**
+ * Creates a rules record for all restricted items.
+ *
+ * @param generator
+ *  The generator callback function that returns the restricted items to be
+ *  inserted into the linter rules.
+ *
+ * @returns
+ *  The rules record containing entries for all existing restricted items.
+ */
+function createRulesRecord(generator) {
+    const rules = {};
+    for (const key of ["globals", "imports", "properties", "syntax"]) {
+        const items = generator(key);
+        if (items?.length) {
+            rules[`no-restricted-${key}`] = ["error", ...items];
+        }
+    }
+    // same restrictions for CommonJS `require` as for `import` statements
+    if ("no-restricted-imports" in rules) {
+        rules["no-restricted-modules"] = rules["no-restricted-imports"];
+    }
+    return rules;
+}
+// ----------------------------------------------------------------------------
+/**
+ * Generates various "no-restricted-?" rules from the passed configuration.
+ *
+ * @param envOptions
+ *  The environment options containing "files", "ignores", and "restricted"
+ *  settings.
+ *
+ * @param fixed
+ *  The fixed restricted items provided by the environment preset.
+ *
+ * @returns
+ *  The flat configuration objects needed to forbid the restricted items.
+ */
+export function restrictedRules(envOptions, fixed) {
+    const { restricted = {} } = envOptions;
+    const RESTRICTED_GLOBALS = [
+        { name: "isFinite", message: "Use 'Number.isFinite' instead." },
+        { name: "isNaN", message: "Use 'Number.isNaN' instead." },
+    ];
+    const RESTRICTED_SYNTAX = [
+        { selector: ":matches(PropertyDefinition, MethodDefinition[kind!='constructor'])[accessibility='public']", message: "Remove 'public' keyword." },
+        { selector: ":matches(PropertyDefinition, MethodDefinition[kind!='constructor'])[accessibility='private']" + (restricted.nativeDecorators ? "" : "[decorators.length=0]"), message: "Use #private syntax instead." },
+        { selector: "MethodDefinition[kind='constructor'] TSParameterProperty[accessibility]", message: "Use explicit class properties." },
+    ];
+    // restricted items for all files in the environment
+    const items = {
+        globals: flatArray(RESTRICTED_GLOBALS, fixed?.globals, restricted.globals),
+        imports: flatArray(fixed?.imports, restricted.imports),
+        properties: flatArray(fixed?.properties, restricted.properties),
+        syntax: flatArray(RESTRICTED_SYNTAX, fixed?.syntax, restricted.syntax),
+    };
+    // generate the configuration objects
+    return concatConfigs(
+    // base rules for all files in the environment
+    createConfig(envOptions, {
+        rules: createRulesRecord(key => items[key]),
+    }), 
+    // generate the override entries (join with base items)
+    restricted.overrides?.map(override => createConfig(override, {
+        rules: createRulesRecord(key => flatArray(items[key], override[key])),
+    })));
+}

package/dist/eslint/shared/unittest.d.ts

@@ -0,0 +1,29 @@
+import type { TSESLint } from "@typescript-eslint/utils";
+import { type EnvBaseOptions } from "./env-utils.js";
+/**
+ * Shared options for environment presets for unit tests.
+ */
+export interface EnvUnitTestOptions extends EnvBaseOptions {
+    /**
+     * Specifies whether to include `eslint-plugin-jest-dom`. Should only be
+     * used, if the package `jest-dom` has been installed in the project.
+     * Default value is `false`.
+     */
+    jestDom?: boolean;
+    /**
+     * Specifies the recommended rule set of `eslint-plugin-testing-library` to
+     * be included.
+     */
+    testingLib?: "angular" | "dom" | "marko" | "react" | "vue";
+}
+/**
+ * Conditionally creates flat configuration objects for the ESLint plugins
+ * `eslint-plugin-jest-dom` and `eslint-plugin-testing-library`.
+ *
+ * @param envOptions
+ *  The configuration options for the unit test environment.
+ *
+ * @returns
+ *  The resulting flat configuration objects.
+ */
+export declare function createUnitTestPluginConfigs(envOptions: EnvUnitTestOptions): TSESLint.FlatConfig.ConfigArray;

package/dist/eslint/shared/unittest.js

@@ -0,0 +1,32 @@
+import jestDomPlugin from "eslint-plugin-jest-dom";
+import testingLibraryPlugin from "eslint-plugin-testing-library";
+import { fixupPluginRules } from "@eslint/compat";
+import { concatConfigs, createConfig } from "./env-utils.js";
+// functions ==================================================================
+/**
+ * Conditionally creates flat configuration objects for the ESLint plugins
+ * `eslint-plugin-jest-dom` and `eslint-plugin-testing-library`.
+ *
+ * @param envOptions
+ *  The configuration options for the unit test environment.
+ *
+ * @returns
+ *  The resulting flat configuration objects.
+ */
+export function createUnitTestPluginConfigs(envOptions) {
+    return concatConfigs(
+    // "jest-dom" plugin
+    envOptions.jestDom && createConfig(envOptions, jestDomPlugin.configs["flat/recommended"]), 
+    // "testing-library" plugin
+    envOptions.testingLib && createConfig(envOptions, {
+        // register rule implementations of the plugins
+        plugins: {
+            "testing-library": fixupPluginRules(testingLibraryPlugin), // https://github.com/testing-library/eslint-plugin-testing-library/issues/899
+        },
+        // recommended rules
+        rules: {
+            ...testingLibraryPlugin.configs.react.rules,
+            "testing-library/no-node-access": ["error", { allowContainerFirstChild: true }],
+        },
+    }));
+}

package/doc/eslint/env/jest.md

@@ -1,6 +1,10 @@
 # Environment `env.jest`
 
-Creates configuration objects with global symbols and linter rules for unit tests using Jest. Adds the plugin [eslint-plugin-jest](https://github.com/jest-community/eslint-plugin-jest) and its recommended rules.
+Creates configuration objects with global symbols and linter rules for unit tests using Jest. Adds the following plugins and their recommended rules:
+
+- [eslint-plugin-jest](https://github.com/jest-community/eslint-plugin-jest)
+- [eslint-plugin-jest-dom](https://github.com/testing-library/eslint-plugin-jest-dom) (optional)
+- [eslint-plugin-testing-library](https://github.com/testing-library/eslint-plugin-testing-library) (optional)
 
 ## Signature
 
@@ -15,6 +19,8 @@ function jest(options: EnvJestOptions): Linter.FlatConfig[]
 | `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
 | `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
 | `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
+| `jestDom` | `boolean` | `false` | Activate plugin `eslint-plugin-jest-dom`. |
+| `testingLib` | `"angular"\|"dom"\|"marko"\|"react"\|"vue"` | _none_ | Activate plugin `eslint-plugin-testing-library` for the specified environment. |
 
 ## Example
 
@@ -26,6 +32,7 @@ export default [
   ...eslint.configure({ /* ... */ }),
   ...eslint.env.jest({
     files: ["test/**/*.{js,ts}"],
+    testingLib: "react",
     rules: { /* ... */ },
   }),
 ]

package/doc/eslint/env/vitest.md

@@ -3,8 +3,8 @@
 Creates configuration objects with global symbols and linter rules for unit tests using Vitest. Adds the following plugins and their recommended rules:
 
 - [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest)
-- [eslint-plugin-testing-library](https://github.com/testing-library/eslint-plugin-testing-library)
-- [eslint-plugin-jest-dom](https://github.com/testing-library/eslint-plugin-jest-dom)
+- [eslint-plugin-jest-dom](https://github.com/testing-library/eslint-plugin-jest-dom) (optional)
+- [eslint-plugin-testing-library](https://github.com/testing-library/eslint-plugin-testing-library) (optional)
 
 ## Signature
 
@@ -19,6 +19,8 @@ function vitest(options: EnvVitestOptions): Linter.FlatConfig[]
 | `files` | `string[]` | _required_ | Glob patterns for source files to be included. |
 | `ignores` | `string[]` | `[]` | Glob patterns for source files matching `files` to be ignored. |
 | `rules` | `Linter.RulesRecord` | `{}` | Additional linter rules to be added to the configuration. |
+| `jestDom` | `boolean` | `false` | Activate plugin `eslint-plugin-jest-dom`. |
+| `testingLib` | `"angular"\|"dom"\|"marko"\|"react"\|"vue"` | _none_ | Add plugin `eslint-plugin-testing-library` for the specified environment. |
 
 ## Example
 
@@ -30,6 +32,7 @@ export default [
   ...eslint.configure({ /* ... */ }),
   ...eslint.env.vitest({
     files: ["test/**/*.{js,ts}"],
+    testingLib: "react",
     rules: { /* ... */ },
   }),
 ]

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@open-xchange/linter-presets",
-    "version": "0.4.2",
+    "version": "0.5.0",
     "description": "Configuration presets for ESLint and StyleLint",
     "repository": {
         "url": "https://gitlab.open-xchange.com/fspd/npm-packages/linter-presets"
@@ -28,7 +28,7 @@
         "@babel/plugin-proposal-decorators": "7.24.7",
         "@eslint-community/eslint-plugin-eslint-comments": "4.3.0",
         "@eslint/compat": "1.1.1",
-        "@eslint/js": "9.8.0",
+        "@eslint/js": "9.9.0",
         "@stylistic/eslint-plugin": "2.3.0",
         "@stylistic/eslint-plugin-migrate": "2.3.0",
         "@stylistic/stylelint-config": "2.0.0",
@@ -38,20 +38,20 @@
         "eslint-plugin-codeceptjs": "1.3.0",
         "eslint-plugin-eslint-plugin": "6.2.0",
         "eslint-plugin-import": "2.29.1",
-        "eslint-plugin-jest": "28.7.0",
+        "eslint-plugin-jest": "28.8.0",
         "eslint-plugin-jest-dom": "5.4.0",
-        "eslint-plugin-jsdoc": "48.11.0",
+        "eslint-plugin-jsdoc": "50.2.2",
         "eslint-plugin-jsonc": "2.16.0",
         "eslint-plugin-jsx-a11y": "6.9.0",
         "eslint-plugin-jsx-expressions": "1.3.2",
         "eslint-plugin-license-header": "0.6.1",
         "eslint-plugin-n": "17.10.2",
-        "eslint-plugin-promise": "7.0.0",
+        "eslint-plugin-promise": "7.1.0",
         "eslint-plugin-react": "7.35.0",
         "eslint-plugin-react-hooks": "4.6.2",
         "eslint-plugin-react-hooks-static-deps": "1.0.7",
         "eslint-plugin-react-refresh": "0.4.9",
-        "eslint-plugin-testing-library": "6.2.2",
+        "eslint-plugin-testing-library": "6.3.0",
         "eslint-plugin-vitest": "0.5.4",
         "eslint-plugin-yml": "1.14.0",
         "find-up": "7.0.0",
@@ -61,14 +61,14 @@
         "stylelint-config-standard-less": "3.0.1",
         "stylelint-config-standard-scss": "13.1.0",
         "stylelint-plugin-license-header": "1.0.3",
-        "typescript-eslint": "8.0.1"
+        "typescript-eslint": "8.1.0"
     },
     "devDependencies": {
         "@types/confusing-browser-globals": "1.0.3",
         "@types/eslint__js": "8.42.3",
-        "@types/picomatch": "3.0.0",
-        "@typescript-eslint/utils": "8.0.1",
-        "eslint": "9.8.0",
+        "@types/picomatch": "3.0.1",
+        "@typescript-eslint/utils": "8.1.0",
+        "eslint": "9.9.0",
         "husky": "9.1.4",
         "jest": "29.7.0",
         "stylelint": "16.8.1",

package/test/src/config-stylistic/test.js

@@ -0,0 +1,17 @@
+
+/**
+ * @returns {string[]} A string array.
+ */
+// eslint-disable-next-line @stylistic/space-before-function-paren
+export function f () {
+    // eslint-disable-next-line @stylistic/quotes
+    const str1 = 'abc';
+    // eslint-disable-next-line @stylistic/semi
+    const str2 = str1
+    // eslint-disable-next-line @stylistic/indent
+     return [
+        str1,
+        // eslint-disable-next-line @stylistic/comma-dangle
+        str2
+    ];
+}

package/test/src/config-stylistic/test.ts

@@ -0,0 +1,28 @@
+
+/**
+ * @returns A string array.
+ */
+// eslint-disable-next-line @stylistic/space-before-function-paren
+export function f (): string[] {
+    // eslint-disable-next-line @stylistic/quotes
+    const str1 = 'abc';
+    // eslint-disable-next-line @stylistic/semi
+    const str2 = str1
+    // eslint-disable-next-line @stylistic/indent
+     return [
+        str1,
+        // eslint-disable-next-line @stylistic/comma-dangle
+        str2
+    ];
+}
+
+export interface I {
+    // eslint-disable-next-line @stylistic/member-delimiter-style
+    a: string,
+    // eslint-disable-next-line @stylistic/indent
+     b: number;
+    // eslint-disable-next-line @stylistic/quotes
+    ['*']: boolean;
+    // eslint-disable-next-line @stylistic/member-delimiter-style
+    c: boolean
+}

package/test/src/env-jest/test.js

@@ -0,0 +1,9 @@
+
+describe("test", () => {
+    it("should work", () => {
+        // eslint-disable-next-line jest/prefer-to-be
+        expect(1).toEqual(1);
+        // eslint-disable-next-line jest/prefer-to-have-length
+        expect([].length).toBe(0);
+    });
+});