@open-xchange/linter-presets 0.1.4 → 0.1.6

package/dist/eslint/env/react.js

@@ -5,6 +5,7 @@ import reactRefreshPlugin from "eslint-plugin-react-refresh";
 import jsxExpressionsPlugin from "eslint-plugin-jsx-expressions";
 import jsxA11yPlugin from "eslint-plugin-jsx-a11y";
 import { fixupPluginRules } from "@eslint/compat";
+import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
 // functions ==================================================================
 /**
  * Creates configuration objects with linter rules for ReactJS.
@@ -17,75 +18,79 @@ import { fixupPluginRules } from "@eslint/compat";
  * - `eslint-plugin-jsx-expressions`
  * - `eslint-plugin-jsx-a11y`
  *
- * @param options
+ * @param envOptions
  *  Configuration options for the environment.
  *
  * @returns
  *  An array of configuration objects to be added to the flat configuration.
  */
-export default function react(options) {
-    // configuration properties
-    const { files, ignores = [], rules, staticHooks = {} } = options;
-    return [
-        // configure plugins and rules for all source files (JSX and TSX)
-        {
-            files,
-            ignores,
-            // register rule implementations of the plugins
-            plugins: {
-                react: fixupPluginRules(reactPlugin), // https://github.com/jsx-eslint/eslint-plugin-react/issues/3699
-                "react-hooks": reactHooksPlugin,
-                "react-hooks-static-deps": fixupPluginRules(reactHooksStaticDepsPlugin), // https://github.com/stoikio/eslint-plugin-react-hooks-static-deps/issues/1
-                "react-refresh": reactRefreshPlugin,
-                "jsx-expressions": fixupPluginRules(jsxExpressionsPlugin), // https://github.com/hluisson/eslint-plugin-jsx-expressions/issues/18
-                "jsx-a11y": jsxA11yPlugin,
-            },
-            settings: {
-                react: {
-                    version: "detect",
-                },
-            },
-            // enable JSX support
-            languageOptions: {
-                parserOptions: reactPlugin.configs.recommended.parserOptions,
-            },
-            // configure plugin rules
-            rules: {
-                // recommended rules
-                ...reactPlugin.configs.recommended.rules,
-                ...reactPlugin.configs["jsx-runtime"].rules,
-                ...reactHooksPlugin.configs.recommended.rules,
-                ...jsxA11yPlugin.flatConfigs.recommended.rules,
-                // "react" plugin: change or disable a few recommended rules
-                "react/hook-use-state": "error",
-                "react/iframe-missing-sandbox": "error",
-                "react/jsx-boolean-value": "error",
-                "react/jsx-no-script-url": "error",
-                "react/jsx-no-useless-fragment": "error",
-                "react/no-danger": "error",
-                "react/no-invalid-html-attribute": "error",
-                "react/no-typos": "error",
-                "react/prop-types": ["error", { skipUndeclared: true }],
-                "react/style-prop-object": "error",
-                "react/void-dom-elements-no-children": "error",
-                // replace "react-hooks/exhaustive-deps" rule with advanced alternative
-                "react-hooks/exhaustive-deps": "off",
-                "react-hooks-static-deps/exhaustive-deps": ["error", { staticHooks }],
-                // "react-refresh" plugin
-                "react-refresh/only-export-components": ["error", { allowConstantExport: true }],
-                // custom rules
-                ...rules,
+export default function react(envOptions) {
+    return concatConfigs(
+    // configure "react" plugin for all source files (JSX and TSX)
+    createConfig(envOptions, {
+        // auto-detect installed React version
+        settings: {
+            react: {
+                version: "detect",
             },
         },
-        // additional rules for TSX only
-        {
-            files,
-            ignores: [...ignores, "**/*.{js,jsx}"],
-            // configure plugin rules
-            rules: {
-                // replace "react/jsx-no-leaked-render" rule with advanced alternative
-                "jsx-expressions/strict-logical-expressions": "error",
-            },
+        // register rule implementations and language settings
+        ...reactPlugin.configs.flat.recommended,
+        rules: {
+            // recommended rules
+            ...reactPlugin.configs.flat.recommended.rules,
+            ...reactPlugin.configs.flat["jsx-runtime"].rules,
+        },
+    }), 
+    // configure other plugins and rules for all source files (JSX and TSX)
+    createConfig(envOptions, {
+        // register rule implementations of the plugins
+        plugins: {
+            "react-hooks": reactHooksPlugin,
+            "react-refresh": reactRefreshPlugin,
+            "jsx-expressions": fixupPluginRules(jsxExpressionsPlugin), // https://github.com/hluisson/eslint-plugin-jsx-expressions/issues/18
+            "jsx-a11y": jsxA11yPlugin,
+        },
+        // recommended rules
+        rules: {
+            ...reactHooksPlugin.configs.recommended.rules,
+            ...jsxA11yPlugin.flatConfigs.recommended.rules,
+        },
+    }), 
+    // "react-hooks-static-deps" plugin
+    envOptions.staticHooks && createConfig(envOptions, {
+        plugins: {
+            "react-hooks-static-deps": fixupPluginRules(reactHooksStaticDepsPlugin), // https://github.com/stoikio/eslint-plugin-react-hooks-static-deps/issues/1
+        },
+        rules: {
+            "react-hooks/exhaustive-deps": "off",
+            "react-hooks-static-deps/exhaustive-deps": ["error", { staticHooks: envOptions.staticHooks }],
+        },
+    }), 
+    // additional rules for TSX only
+    createConfig(envOptions, {
+        ignores: ["**/*.{js,jsx}"],
+        rules: {
+            // replace "react/jsx-no-leaked-render" rule with advanced alternative
+            "jsx-expressions/strict-logical-expressions": "error",
         },
-    ];
+    }), 
+    // custom rules
+    customRules(envOptions, {
+        // "react" plugin
+        "react/hook-use-state": "error",
+        "react/iframe-missing-sandbox": "error",
+        "react/jsx-boolean-value": "error",
+        "react/jsx-no-script-url": "error",
+        "react/jsx-no-useless-fragment": "error",
+        "react/jsx-props-no-spread-multi": "error",
+        "react/no-danger": "error",
+        "react/no-invalid-html-attribute": "error",
+        "react/no-typos": "error",
+        "react/prop-types": ["error", { skipUndeclared: true }],
+        "react/style-prop-object": "error",
+        "react/void-dom-elements-no-children": "error",
+        // "react-refresh" plugin
+        "react-refresh/only-export-components": ["error", { allowConstantExport: true }],
+    }));
 }

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

@@ -12,10 +12,10 @@ export interface EnvTSConfigOptions extends EnvBaseOptions {
 /**
  * Creates configuration objects for TypeScript projects.
  *
- * @param options
+ * @param envOptions
  *  Configuration options for the environment.
  *
  * @returns
  *  An array of configuration objects to be added to the flat configuration.
  */
-export default function tsconfig(options: EnvTSConfigOptions): TSESLint.FlatConfig.ConfigArray;
+export default function tsconfig(envOptions: EnvTSConfigOptions): TSESLint.FlatConfig.ConfigArray;

package/dist/eslint/env/tsconfig.js

@@ -1,29 +1,24 @@
+import { concatConfigs, createConfig, customRules } from "../shared/env-utils.js";
 // functions ==================================================================
 /**
  * Creates configuration objects for TypeScript projects.
  *
- * @param options
+ * @param envOptions
  *  Configuration options for the environment.
  *
  * @returns
  *  An array of configuration objects to be added to the flat configuration.
  */
-export default function tsconfig(options) {
-    // configuration properties
-    const { files, ignores = [], rules } = options;
-    return [{
-            files,
-            ignores,
-            // path to project configuration file
-            languageOptions: {
-                parserOptions: {
-                    project: options.project,
-                },
+export default function tsconfig(envOptions) {
+    return concatConfigs(
+    // path to project configuration file
+    createConfig(envOptions, {
+        languageOptions: {
+            parserOptions: {
+                project: envOptions.project,
             },
-            // configure plugin rules
-            rules: {
-                // custom rules
-                ...rules,
-            },
-        }];
+        },
+    }), 
+    // custom rules
+    customRules(envOptions));
 }

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

@@ -14,10 +14,10 @@ export interface EnvVitestOptions extends EnvBaseOptions {
  * - `eslint-plugin-jest-dom`
  * - `eslint-plugin-testing-library`
  *
- * @param options
+ * @param envOptions
  *  Configuration options for the environment.
  *
  * @returns
  *  An array of configuration objects to be added to the flat configuration.
  */
-export default function vitest(options: EnvVitestOptions): TSESLint.FlatConfig.ConfigArray;
+export default function vitest(envOptions: EnvVitestOptions): TSESLint.FlatConfig.ConfigArray;

package/dist/eslint/env/vitest.js

@@ -2,6 +2,7 @@ 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";
 // functions ==================================================================
 /**
  * Creates configuration objects with global symbols and linter rules for unit
@@ -12,79 +13,63 @@ import { fixupPluginRules } from "@eslint/compat";
  * - `eslint-plugin-jest-dom`
  * - `eslint-plugin-testing-library`
  *
- * @param options
+ * @param envOptions
  *  Configuration options for the environment.
  *
  * @returns
  *  An array of configuration objects to be added to the flat configuration.
  */
-export default function vitest(options) {
-    // configuration properties
-    const { files, ignores = [], rules } = options;
-    return [
-        // "vitest" plugin
-        {
-            files,
-            ignores,
-            // register rule implementations of the plugins
-            plugins: {
-                vitest: vitestPlugin,
-            },
-            // register global symbols of Vitest
-            languageOptions: {
-                globals: vitestPlugin.environments.env.globals,
-            },
-            // configure plugin rules
-            rules: {
-                // recommended rules
-                ...vitestPlugin.configs.recommended.rules,
-                // extra rules
-                "vitest/consistent-test-it": "error",
-                "vitest/no-alias-methods": "error",
-                "vitest/no-disabled-tests": "warn",
-                "vitest/no-duplicate-hooks": "error",
-                "vitest/no-focused-tests": "error",
-                "vitest/no-standalone-expect": "error",
-                "vitest/no-test-prefixes": "error",
-                "vitest/no-test-return-statement": "error",
-                "vitest/prefer-comparison-matcher": "error",
-                "vitest/prefer-each": "error",
-                "vitest/prefer-equality-matcher": "error",
-                "vitest/prefer-expect-resolves": "error",
-                "vitest/prefer-hooks-in-order": "error",
-                "vitest/prefer-hooks-on-top": "error",
-                "vitest/prefer-mock-promise-shorthand": "error",
-                "vitest/prefer-spy-on": "error",
-                "vitest/prefer-strict-equal": "error",
-                "vitest/prefer-to-be": "error",
-                "vitest/prefer-to-contain": "error",
-                "vitest/prefer-to-have-length": "error",
-                "vitest/require-top-level-describe": "error",
-                // custom rules
-                ...rules,
-            },
+export default function vitest(envOptions) {
+    return concatConfigs(
+    // "vitest" plugin
+    createConfig(envOptions, {
+        // register rule implementations of the plugins
+        plugins: {
+            vitest: vitestPlugin,
         },
-        // "jest-dom" plugin
-        {
-            files,
-            ignores,
-            ...jestDomPlugin.configs["flat/recommended"],
+        // register global symbols of Vitest
+        languageOptions: {
+            globals: vitestPlugin.environments.env.globals,
         },
-        // "testing-library" plugin
-        {
-            files,
-            ignores,
-            // register rule implementations of the plugins
-            plugins: {
-                "testing-library": fixupPluginRules(testingLibraryPlugin), // https://github.com/testing-library/eslint-plugin-testing-library/issues/899
-            },
-            // configure plugin rules
-            rules: {
-                // recommended rules
-                ...testingLibraryPlugin.configs.react.rules,
-                // extra rules
-                "testing-library/no-node-access": ["error", { allowContainerFirstChild: true }],
-            },
+        // 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,
+    }), 
+    // custom rules
+    customRules(envOptions, {
+        // "vitest" plugin
+        "vitest/consistent-test-it": "error",
+        "vitest/no-alias-methods": "error",
+        "vitest/no-disabled-tests": "warn",
+        "vitest/no-duplicate-hooks": "error",
+        "vitest/no-focused-tests": "error",
+        "vitest/no-standalone-expect": "error",
+        "vitest/no-test-prefixes": "error",
+        "vitest/no-test-return-statement": "error",
+        "vitest/prefer-comparison-matcher": "error",
+        "vitest/prefer-each": "error",
+        "vitest/prefer-equality-matcher": "error",
+        "vitest/prefer-expect-resolves": "error",
+        "vitest/prefer-hooks-in-order": "error",
+        "vitest/prefer-hooks-on-top": "error",
+        "vitest/prefer-mock-promise-shorthand": "error",
+        "vitest/prefer-spy-on": "error",
+        "vitest/prefer-strict-equal": "error",
+        "vitest/prefer-to-be": "error",
+        "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/rules/no-invalid-modules.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { posix, dirname, extname } from "node:path";
-import { packageUpSync } from "package-up";
+import { findUpSync } from "find-up";
 import { AST_NODE_TYPES as NodeType, ESLintUtils } from "@typescript-eslint/utils";
 import { Schema, makeArray, toPosixPath, isFile, matchModuleName, getModuleName } from "../shared/rule-utils.js";
 // constants ==================================================================
@@ -47,8 +47,8 @@ export default ESLintUtils.RuleCreator.withoutDocs({
         // collect all globs for package members
         const packagesGlobs = Array.from(packagesMap.values(), settings => settings.src).flat();
         // resolve file name
-        const packagePath = packageUpSync();
-        const rootDir = packagePath && toPosixPath(dirname(packagePath));
+        const configPath = findUpSync("eslint.config.js");
+        const rootDir = configPath && toPosixPath(dirname(configPath));
         const fileName = toPosixPath(context.filename);
         if (!rootDir || !fileName.startsWith(rootDir + "/")) {
             throw new Error("invalid root directory");
@@ -86,7 +86,7 @@ export default ESLintUtils.RuleCreator.withoutDocs({
             return FILE_EXTENSIONS.some(ext => isFile(resolvedPath + "." + ext));
         };
         // returns whether the passed module name is an installed NPM package
-        const requireModule = createRequire(packagePath);
+        const requireModule = createRequire(configPath);
         const packageExists = (moduleName) => {
             try {
                 requireModule.resolve(moduleName);
@@ -110,7 +110,7 @@ export default ESLintUtils.RuleCreator.withoutDocs({
                 // extract alias key, replace with alias path
                 const [aliasKey, modulePath] = resolveAlias(moduleName);
                 // whether the import is a known external module
-                const isExternal = !aliasKey && matchModuleName(moduleName, options.external);
+                const isExternal = matchModuleName(moduleName, options.external);
                 // whether the import is an installed NPM package
                 const isPackage = !isExternal && !aliasKey && packageExists(moduleName);
                 // check existence of source file

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

@@ -126,10 +126,10 @@ export interface EnvRestrictedItems {
 export interface EnvRestrictedOverride extends EnvFilesOptions, EnvRestrictedItems {
 }
 /**
- * Configuration options for banned globals, imports, properties, and syntax
- * constructs in the environment.
+ * Type shape of a dedicated environment option "restricted" with settings for
+ * banned globals, imports, properties, and syntax constructs.
  */
-export interface EnvRestrictedOptions extends EnvRestrictedItems {
+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
@@ -146,9 +146,16 @@ export interface EnvRestrictedOptions extends EnvRestrictedItems {
      */
     overrides?: EnvRestrictedOverride[];
 }
-export interface EnvRestrictedRulesResult {
-    rules: TSESLint.FlatConfig.Rules;
-    overrides: TSESLint.FlatConfig.ConfigArray;
+/**
+ * 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
@@ -161,16 +168,61 @@ export declare const NO_UNUSED_VARS_OPTIONS: {
     caughtErrors: string;
     ignoreRestSiblings: boolean;
 };
+/**
+ * Concatenates multiple configuration objects or arrays into an array while
+ * skipping all falsy parameters.
+ *
+ * @param configs
+ *  The configuration objects to be concatenated.
+ *
+ * @returns
+ *  The concatenated configuration array.
+ */
+export declare const concatConfigs: (...entries: (TSESLint.FlatConfig.Config | TSESLint.FlatConfig.Config[] | undefined)[]) => TSESLint.FlatConfig.Config[];
+/**
+ * Creates a flat configuration object with "files" and "ignores" settings from
+ * an environment's "envOptions" object.
+ *
+ * @param envOptions
+ *  The environment options containing "files" and "ignores" settings.
+ *
+ * @param flatConfig
+ *  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 options
- *  The custom configuration passed to an environment preset.
+ * @returns
+ *  The flat configuration objects needed to forbid the restricted items.
+ */
+export declare function restrictedRules(envOptions: EnvRestrictedOptions, fixed?: EnvRestrictedItems): TSESLint.FlatConfig.ConfigArray;
+/**
+ * Creates a flat configuration object with "files", "ignores", and "rules"
+ * settings from an environment's "envOptions" object.
+ *
+ * @param envOptions
+ *  The environment options containing "files", "ignores", and "rules"
+ *  settings.
+ *
+ * @param rules
+ *  Hard-coded rule settings to be configured by the environment itself. These
+ *  rule settings will precede the rules contained in "envOptions", in order to
+ *  allow to override them.
  *
  * @returns
- *  The generated linter rules to forbid the restricted items.
+ *  The resulting flat configuration object, if the environment options contain
+ *  custom rule settings, otherwise `undefined`.
  */
-export declare function generateRestrictedRules(fixed: EnvRestrictedItems, options?: EnvRestrictedOptions): EnvRestrictedRulesResult;
+export declare function customRules(envOptions: EnvBaseOptions, rules?: TSESLint.FlatConfig.Rules): TSESLint.FlatConfig.Config | undefined;

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

@@ -12,16 +12,17 @@ export const NO_UNUSED_VARS_OPTIONS = {
 };
 // functions ==================================================================
 /**
- * Concatenates the elements of multiple arrays. Skips `undefined` parameters.
+ * Concatenates and flattens multiple elements or arrays into a single array
+ * while skipping all falsy parameters.
  *
- * @param arrays
- *  The arrays to be concatenated.
+ * @param entries
+ *  The elements or arrays to be concatenated.
  *
  * @returns
- *  The concatenated arrays.
+ *  The concatenated and flattened array.
  */
-function concatArrays(...arrays) {
-    return arrays.flatMap(array => array || []);
+function flatten(...entries) {
+    return entries.flatMap(array => array || []);
 }
 /**
  * Creates a rules record for all restricted items.
@@ -48,45 +49,99 @@ function createRulesRecord(generator) {
     return rules;
 }
 // ----------------------------------------------------------------------------
+/**
+ * Concatenates multiple configuration objects or arrays into an array while
+ * skipping all falsy parameters.
+ *
+ * @param configs
+ *  The configuration objects to be concatenated.
+ *
+ * @returns
+ *  The concatenated configuration array.
+ */
+export const concatConfigs = (flatten);
+/**
+ * Creates a flat configuration object with "files" and "ignores" settings from
+ * an environment's "envOptions" object.
+ *
+ * @param envOptions
+ *  The environment options containing "files" and "ignores" settings.
+ *
+ * @param flatConfig
+ *  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 function createConfig(envOptions, flatConfig) {
+    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.
  *
- * @param options
- *  The custom configuration passed to an environment preset.
- *
  * @returns
- *  The generated linter rules to forbid the restricted items.
+ *  The flat configuration objects needed to forbid the restricted items.
  */
-export function generateRestrictedRules(fixed, options) {
+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']" + (options?.nativeDecorators ? "" : "[decorators.length=0]"), message: "Use #private syntax instead." },
+        { 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: concatArrays(RESTRICTED_GLOBALS, fixed.globals, options?.globals),
-        imports: concatArrays(fixed.imports, options?.imports),
-        properties: concatArrays(fixed.properties, options?.properties),
-        syntax: concatArrays(RESTRICTED_SYNTAX, fixed.syntax, options?.syntax),
+        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),
     };
+    // generate the configuration objects
+    return concatConfigs(
     // base rules for all files in the environment
-    const rules = createRulesRecord(key => items[key]);
+    createConfig(envOptions, {
+        rules: createRulesRecord(key => items[key]),
+    }), 
     // generate the override entries (join with base items)
-    const overrides = [];
-    for (const override of options?.overrides ?? []) {
-        overrides.push({
-            files: override.files,
-            ignores: override.ignores ?? [],
-            rules: createRulesRecord(key => concatArrays(items[key], override[key])),
-        });
-    }
-    return { rules, overrides };
+    restricted.overrides?.map(override => createConfig(override, {
+        rules: createRulesRecord(key => flatten(items[key], override[key])),
+    })));
+}
+/**
+ * Creates a flat configuration object with "files", "ignores", and "rules"
+ * settings from an environment's "envOptions" object.
+ *
+ * @param envOptions
+ *  The environment options containing "files", "ignores", and "rules"
+ *  settings.
+ *
+ * @param rules
+ *  Hard-coded rule settings to be configured by the environment itself. These
+ *  rule settings will precede the rules contained in "envOptions", in order to
+ *  allow to override them.
+ *
+ * @returns
+ *  The resulting flat configuration object, if the environment options contain
+ *  custom rule settings, otherwise `undefined`.
+ */
+export function customRules(envOptions, rules) {
+    return (rules || envOptions.rules) && createConfig(envOptions, {
+        rules: { ...rules, ...envOptions.rules },
+    });
 }

package/doc/eslint/README.md

@@ -37,6 +37,7 @@ function configure(options?: ConfigureOptions): Linter.FlatConfig[]
 | `language` | `LanguageOptions` | | Configuration options for language and project setup. |
 | `language.ecmaVersion` | `number` | `2022` | The ECMAScript version to be used in the project (version or year). |
 | `language.sourceType` | `"module"\|"commonjs"` | `"module"` | Specifies how to treat `.js`, `.jsx`, `.ts`, and `.tsx` files. |
+| `language.nativeDecorators` | `boolean` | `false` | Whether to support native ES decorators in JavaScript code (via Babel plugin). Does not affect TypeScript code which uses an own parser aware of the decorator syntax. |
 | `stylistic` | `StylisticOptions` | | Configuration options for code style. |
 | `stylistic.indent` | `number` | `2` | Default indentation size (number of space characters). Will be applied to JavaScript, TypeScript, JSON, and YAML files, as well as JSX markup. |
 | `stylistic.semi` | `boolean` | `false` | Specifies whether to require semicolons following all statements (`true`), or to force to omit semicolons if possible according to ASI rules (`false`). |