eslint-config-vylda-vanilla-react 5.2.0 → 6.0.0

package/Changelog.md

@@ -4,6 +4,50 @@ All notable changes to this component will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [6.0.0] - 2026-09-20
+### Added
+- Rules
+  - react-hooks/exhaustive-effect-dependencies [Vilda Lipold]
+  - react-hooks/memo-dependencies [Vilda Lipold]
+- `defaults` export: vanilla rule sets plus import rules (with the jsx-aware granular option), unmapped to files, for partial composition [Vilda Lipold]
+- `jsxExtension` export: the `react/jsx-filename-extension` rule plus the JSX syntax option, mapped to every JavaScript file instead of `reactFiles` [Vilda Lipold]
+- npm `overrides` block pinning `eslint-plugin-react`'s `eslint` peer to the root one. The plugin still declares `^9.7`, which makes `npm ci` fail here, where `eslint` is a direct dependency. It does not reach consumers: npm honours `overrides` only in the root project, and there the plugin is transitive, so npm nests a copy of ESLint 9 for it on its own [Vilda Lipold]
+### Fixed
+- `getImportConfig()` was a bare re-export of the vanilla package's own function, so calling it with no arguments silently skipped this package's jsx-aware `importExtensionsRuleGranularOption` (contrary to the README, which documents it as using "the same default values as the package") [Vilda Lipold]
+- `importResolverAlias` was accepted by `getConfig()`/`getImportConfig()`'s option types (inherited from vanilla) but silently dropped instead of forwarded, so path aliases never actually resolved [Vilda Lipold]
+- `defaultImportResolverNodeExtensions` was a fresh hardcoded array instead of vanilla's own list extended with `.jsx`, so it silently dropped `.svg` [Vilda Lipold]
+- `react/forward-ref-uses-ref` and `react/jsx-filename-extension` crashed on load under ESLint 10 with `context.getSourceCode is not a function` and `context.getFilename is not a function`. eslint-plugin-react 7.37.5 reaches for both removed accessors without the fallback the rest of its rules use, so the plugin's rules now run behind a proxy that serves the removed `context` accessors from the properties that replaced them. The proxy only fills in what the context does not already have, so on ESLint 9 nothing changes [Vilda Lipold]
+- `react/jsx-filename-extension` could never report anything. It was mapped to `reactFiles` (`**/*.jsx`), where its `noJSXWithExtension` branch is unreachable because the extension is always an allowed one, while its `extensionOnlyForJSX` branch needs `allow: 'as-needed'`, which was not set -- so `ignoreFilesWithoutCode: true` was dead too, since the plugin only reads it inside that branch. `extensions: ['.jsx']` was the rule's own default as well, leaving the rule fully inert [Vilda Lipold]
+### Changed
+- Rewrite to Typescript [Vilda Lipold]
+- `eslint` moved from `dependencies` to `devDependencies`; the published package needs it only for types, so it no longer pulls a second copy of ESLint into consuming projects [Vilda Lipold]
+- Repository moved from `gitlab.com/Vylda/eslint-config-vylda-vanilla-react` to `gitlab.com/eslint-configs/eslint-config-vylda-vanilla-react`; `package.json`'s `bugs`, `repository` and `homepage` fields and the git remote updated to match [Vilda Lipold]
+- Rules
+  - `react/jsx-filename-extension` moved out of the `react` config into the new `jsxExtension` config, which is mapped to every JavaScript file, and switched to `allow: 'as-needed'` [Vilda Lipold]
+### Removed
+- Rules
+  - react-hooks/component-hook-factories [Vilda Lipold]
+### Updated
+- Packages
+  - eslint-config-vylda-vanilla to 6.0.0 [Vilda Lipold]
+  - eslint to 10.10.0 [Vilda Lipold]
+  - eslint-plugin-react-hooks to 7.1.1 (adds ESLint 10 support) [Vilda Lipold]
+  - eslint-plugin-react-refresh to 0.5.7 [Vilda Lipold]
+  - globals to 17.12.0 [Vilda Lipold]
+  - @eslint/config-inspector to 3.5.0 [Vilda Lipold]
+  - baseline-browser-mapping to 2.11.25 [Vilda Lipold]
+- Readme
+  - Setup and Customization chapters rewritten for import-x/jsx-a11y-x, added a dedicated "Using path aliases" chapter, fixed a wrong package name and a missing comma in the custom-extensions example [Vilda Lipold]
+  - Partial ESLint config example: fixed wrong package name and an array-of-arrays bug (`[bestPractices, es6, ...]` instead of `[...bestPractices, ...es6, ...]`) that made `mapFiles` throw "Unexpected key \"0\" found"; added the react-only pieces to the example [Vilda Lipold]
+  - "What you can import from this package": fixed the descriptions of `defaultImportExtensionsRuleGranularOption`, `defaultImportNoExtraneousDependenciesDevDependencies` and `defaultImportResolverNodeExtensions`, which were each describing the wrong constant (cyclically shifted by one); updated every source link (now `./src/...` for our own files, the vanilla gitlab repo's `src/...` for re-exported ones) and every renamed plugin's documentation link; added the missing `defaults` and `defaultImportResolverAlias` entries [Vilda Lipold]
+### BREAKING
+- `eslint` is no longer a dependency of this package, so it is not installed transitively any more. A consuming project has to have its own `eslint`; the README's setup instructions already install it explicitly. This package is built and tested against ESLint 10. [Vilda Lipold]
+- `react/jsx-filename-extension` now reports, where before it was inert. JSX in a `.js`, `.cjs` or `.mjs` file is an error, and a `.jsx` file holding no JSX is an error as well; empty `.jsx` files stay exempt through `ignoreFilesWithoutCode`. The JSX syntax is now enabled on every JavaScript file, so a `.js` file with JSX reports this rule instead of failing to parse. Code that passed on 5.2.0 can fail now: rename such files to `.jsx`, or drop the extra `.jsx` extension from files that hold no JSX. [Vilda Lipold]
+- The rule is no longer part of the `react` config. Anyone composing the config by hand has to add the new `jsxExtension` config mapped to `files`, as the README's partial config example now shows; keeping only `react` silently drops the rule. [Vilda Lipold]
+- Replaced eslint-plugin-jsx-a11y with eslint-plugin-jsx-a11y-x (ESLint 10-ready fork). Plugin key changed from `jsx-a11y` to `jsx-a11y-x`, and rule ids changed from `jsx-a11y/*` to `jsx-a11y-x/*`. If you overrode any `jsx-a11y/*` rule in your own config, rename it to `jsx-a11y-x/*`. [Vilda Lipold]
+- Upgraded eslint-config-vylda-vanilla to 6.0.0, which switched from eslint-plugin-import to eslint-plugin-import-x. Effective rule ids changed from `import/*` to `import-x/*`. If you overrode any `import/*` rule in your own config, rename it to `import-x/*`. [Vilda Lipold]
+- Renamed `refreshFiles` to `reactFiles` (export and `getConfig` option). It always covered all react/hooks/a11y/refresh/reactStylistic configs, not just react-refresh, so the old name was misleading. Rename `refreshFiles` to `reactFiles` wherever you import or pass it. [Vilda Lipold]
+
 ## [5.2.0] - 2026-01-21
 ### Changed
 - Perfectionist only from eslint-config-vylda-vanilla [Vilda Lipold]

package/README.md

@@ -11,13 +11,13 @@ npm install eslint eslint-config-vylda-vanilla-react --save-dev
 
 ### 2. Configure ESLint
 
-create `eslint.config.mjs` file in project root
+Create `eslint.config.mjs` file in project root. You can also use any other supported flat config file name, such as `eslint.config.js`, `eslint.config.cjs`, `eslint.config.ts`, `eslint.config.mts`, or `eslint.config.cts`; see the [ESLint configuration file documentation](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-file).
 
 ```javascript
 // eslint.config.mjs
 import { files, getConfig } from 'eslint-config-vylda-vanilla-react';
 
-const eslintConfig = [
+const config = [
   ...getConfig(),
   {
     files,
@@ -25,23 +25,14 @@ const eslintConfig = [
     rules: {
       // Add custom rules here
     },
-    settings: {
-      'import/resolver': {
-        alias: {
-          map: [
-            ['@', './src'],
-            ['@assets', './src/assets'],
-            ['@utils', './src/utils'],
-          ],
-        },
-      },
-    },
   },
 ];
 
-export default eslintConfig;
+export default config;
 ```
 
+If you use path aliases (e.g. `@/...`), see [Using path aliases](#using-path-aliases) below.
+
 ### 3. Run ESLint
 
 Open a terminal to the root of your project, and run the following command:
@@ -66,7 +57,38 @@ You can also add custom rules to the `rules` property.
 
 ### Customize extensions for ESLint import rules
 You can customize extensions for ESLint import rules by using getConfig function.
-You can extend these default extensions and dependecies with your own extensions. It is used for import plugin settings, `import/extensions` and `import/no-extraneous-dependencies` rules.
+You can extend these default extensions and dependecies with your own extensions. It is used for import plugin settings, `import-x/extensions` and `import-x/no-extraneous-dependencies` rules.
+
+### Using path aliases
+
+Not every project needs path aliases, so the basic setup above doesn't include them. If you use aliases (e.g. `@/...`), use `getConfig` instead of the default export and pass the `importResolverAlias` option:
+
+```javascript
+// eslint.config.mjs
+import { files, getConfig } from 'eslint-config-vylda-vanilla-react';
+
+const config = getConfig({
+  // relative paths are resolved against process.cwd()
+  importResolverAlias: {
+    '@': ['./src'],
+    '@assets': ['./src/assets'],
+    '@utils': ['./src/utils'],
+  },
+});
+
+const eslintConfig = [
+  ...config,
+  {
+    files,
+    name: 'my-rules',
+    rules: {
+      // Add custom rules here
+    },
+  },
+];
+
+export default eslintConfig;
+```
 
 ### Default values
 
@@ -74,37 +96,48 @@ You can extend these default extensions and dependecies with your own extensions
 // default file pattern for all rules (https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects)
 export const files = ['**/*.{cjs,js,jsx,mjs}'];
 
+// default file pattern for the react/hooks/a11y/refresh/reactStylistic configs
+export const reactFiles = ['**/*.jsx'];
+
+// default file pattern for barrel files
+export const barrelsFiles = ['**/index.{js,mjs}'];
+
 // default plugins used in this config
 export const plugins = {
   '@stylistic': stylisticPlugin,
-  'import': importPlugin,
+  'import-x': importPlugin,
   n: nodePlugin,
   perfectionist,
-  'jsx-a11y': jsxA11yPlugin,
+  'jsx-a11y-x': jsxA11yPlugin,
   react: reactPlugin,
   'react-hooks': reactHooks,
   'react-refresh': reactRefresh,
 };
 
-// default value for import/extension module settings (https://github.com/import-js/eslint-plugin-import?tab=readme-ov-file#importextensions)
-export const defaultImportExtensions = ['.js', '.jsx', '.mjs'];
+// default value for import-x/extensions module settings (https://github.com/un-ts/eslint-plugin-import-x?tab=readme-ov-file#import-xextensions)
+export const defaultImportExtensions = ['.js', '.mjs', '.jsx'];
+
+// default value for the built-in node resolver's extensions (https://github.com/un-ts/eslint-plugin-import-x?tab=readme-ov-file#resolvers)
+export const defaultImportResolverNodeExtensions = ['.js', '.json', '.mjs', '.svg', '.jsx'];
 
-// default value for import/resolver settings with node resolution (https://github.com/import-js/eslint-plugin-import?tab=readme-ov-file#resolvers)
-export const defaultImportResolverNodeExtensions = ['.js', '.jsx', '.json', '.mjs'];
+// default value for import-x/resolver-next path alias map (empty by default, see Using path aliases)
+export const defaultImportResolverAlias = {};
 
-// default value for import/extensions rule granular option (https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/extensions.md#rule-details)
+// default value for import-x/extensions rule granular option (https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/extensions.md#rule-details)
 export const defaultImportExtensionsRuleGranularOption = {
   js: 'never',
-  jsx: 'never',
   json: 'always',
   svg: 'always',
+  jsx: 'never',
 };
 
-// default value for import/no-extraneous-dependencies rule devDependencies option (https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/no-extraneous-dependencies.md#rule-details)
+// default value for import-x/no-extraneous-dependencies rule devDependencies option (https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-extraneous-dependencies.md#dependency-options)
 export const defaultImportNoExtraneousDependenciesDevDependencies = [
+  'espree/**', // espree parser
   'test/**', // tape, common npm pattern
   'tests/**', // also common npm pattern
   'spec/**', // mocha, rspec-like pattern
+  '@testing-library/**', // testing-library patterns
   '**/__tests__/**', // jest pattern
   '**/__mocks__/**', // jest pattern
   'test.{js,jsx}', // repos with a single test file
@@ -125,8 +158,9 @@ export const defaultImportNoExtraneousDependenciesDevDependencies = [
   '**/protractor.conf.js', // protractor config
   '**/protractor.conf.*.js', // protractor config
   '**/karma.conf.js', // karma config
+  '**/eslint.config.cjs', // eslint config
+  '**/eslint.config.js', // eslint config
   '**/eslint.config.mjs', // eslint config
-  './rules/*.mjs', // eslint config
   '**/vitest.config.mjs', // vitest config
   '**/vitestSetup.mjs', // vitest setup
   '**/tailwind.config.mjs', // tailwind config
@@ -134,6 +168,8 @@ export const defaultImportNoExtraneousDependenciesDevDependencies = [
   '**/vite.config.mjs', // vite config
   '**/vite.config.*.js', // vite config
   '**/vite.config*.mjs', // vite config
+  '**/vitest.config.mjs', // vitest config
+  '**/vitest.config.js', // vitest config
 ];
 ```
 
@@ -151,7 +187,7 @@ import {
   files as defaultFiles,
   getConfig,
   plugins as defaultPlugins,
-  } from 'eslint-config-vylda-vanilla';
+} from 'eslint-config-vylda-vanilla-react';
 import myPlugin from 'path-to-my-plugin';
 
 const importExtensions = [
@@ -181,7 +217,7 @@ const files = [
 
 const plugins = {
   ...defaultPlugins,
-  'my/plugin': myPlugin,
+  'my-plugin': myPlugin,
 };
 
 const basicConfig = getConfig({
@@ -189,7 +225,7 @@ const basicConfig = getConfig({
   importExtensions,
   importExtensionsRuleGranularOption,
   importResolverNodeExtensions,
-  importNoExtraneousDependenciesDevDependencies
+  importNoExtraneousDependenciesDevDependencies,
   plugins,
 });
 
@@ -197,9 +233,9 @@ const config = [
   ...basicConfig,
   {
     files,
-    name: 'my/plugin',
+    name: 'my-plugin rules',
     rules: {
-      "my/plugin/rule": "error",
+      'my-plugin/rule': 'error',
     },
   },
 ];
@@ -210,34 +246,46 @@ export default config;
 ## Partial ESLint config
 You can also use the package as a partial ESLint config. This is useful if you want to use only some of the rules from the package.
 
-If you can use import plugin, you must use `getImportConfig` function to get the config for the import plugin and import `plugins` object.
-This function uses the same default values as the package, except `files` and `plugins` in option object.
+If you can use the import plugin, you must use the `getImportConfig` function to get the config for the import plugin and import the `plugins` object.
+This function uses the same default values as the package, except `files` and `plugins` in the option object.
 
 ```javascript
 // eslint.config.mjs
 import {
-  barrels, barrelsFiles, bestPractices, es6,
-  getImportConfig, files, mapFiles, plugins,
-   } from 'eslint-config-vylda-vanilla';
+  a11y, barrels, barrelsFiles, bestPractices, es6, getImportConfig, hooks, jsxExtension, files, mapFiles, plugins, react, reactStylistic, refresh, reactFiles,
+} from 'eslint-config-vylda-vanilla-react';
 
 const configs = [
-  bestPractices,
-  es6,
-  // you can add custom options object to the function getConfig
-  // optional parameters: importExtensions, importExtensionsRuleGranularOption, importResolverNodeExtensions,importNoExtraneousDependenciesDevDependencies
-  getImportConfig();
+  ...bestPractices,
+  ...es6,
+  // you can add a custom options object to the getImportConfig function
+  // optional parameters: importExtensions, importExtensionsRuleGranularOption, importResolverAlias, importResolverNodeExtensions, importNoExtraneousDependenciesDevDependencies
+  ...getImportConfig(),
+];
+
+// the react-only pieces are mapped to their own files, same as the default export does
+const reactConfigs = [
+  ...a11y,
+  ...hooks,
+  ...react,
+  ...reactStylistic,
+  ...refresh,
 ];
 
 const configWithFiles = mapFiles(configs, files);
+const reactConfigWithFiles = mapFiles(reactConfigs, reactFiles);
+const jsxExtensionWithFiles = mapFiles(jsxExtension, files);
 const barrelsWithFiles = mapFiles(barrels, barrelsFiles);
 
 const config = [
   {
     plugins,
-  }
+  },
   ...configWithFiles,
+  ...reactConfigWithFiles,
+  ...jsxExtensionWithFiles,
   ...barrelsWithFiles,
-]
+];
 
 export default config;
 ```
@@ -248,39 +296,67 @@ All rules are without `files` property, so you can use them as a partial ESLint
 You can use `files` property to specify the files for the rule.
 You can also use `mapFiles` function to map files for all rules.
 
-- `default export` - default ESLint config ([source](./eslint.config.mjs#L38))
-- `a11y` - ESLint config with rules for accessibility in React components ([source](./rules/a11y.mjs), [documentation](https://github.com/jsx-eslint/eslint-plugin-jsx-a11y#readme))
-- `barrels` - ESLint config with rules for barrel files ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/barrels.mjs), [documentation](https://github.com/import-js/eslint-plugin-import/blob/master/docs/rules/prefer-default-export.md))
-- `barrelsFiles` - default file pattern for barrel files ([default values](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/eslint.config.mjs#L12), [documentation](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects))
-- `bestPractices` - ESLint config with rules for best practices ([source](./rules/best-practices.mjs), [documentation (js)](https://eslint.org/docs/latest/rules), [documentation (stylistic)](https://eslint.style/packages/js#rules))
-- `constants` - Constants for some ESLint rules ([source](./rules/constants.mjs))
-- `customs` - ESLint config with my custom rules ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/customs.mjs))
-- `defaultImportExtensions` - default value for import/extension module settings ([default values](./rules/imports.mjs#L7), [documentation](https://github.com/import-js/eslint-plugin-import?tab=readme-ov-file#importextensions))
-- `defaultImportExtensionsRuleGranularOption` - default value for import/resolver settings with node resolution ([default values](./rules/imports.mjs#L8), [documentation](https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/extensions.md#rule-details))
-- `defaultImportNoExtraneousDependenciesDevDependencies` - default value for import/extensions rule granular option ([default values](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/imports.mjs?ref_type=heads#L8), [documentation](https://github.com/import-js/eslint-plugin-import/blob/main/docs/rules/no-extraneous-dependencies.md#rule-details))
-- `defaultImportResolverNodeExtensions` - default value for import/no-extraneous-dependencies rule devDependencies option ([default values](./rules/imports.mjs#L13), [documentation](https://github.com/import-js/eslint-plugin-import?tab=readme-ov-file#resolvers))
-- `errors` - ESLint config with rules for errors ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/errors.mjs), [documentation](https://eslint.org/docs/latest/rules))
-- `es6` - ESLint config with rules for ES6 ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/es6.mjs), [documentation (js)](https://eslint.org/docs/latest/rules), [documentation (stylistic)](https://eslint.style/packages/js#rules))
-- `files` - default file pattern for all rules ([default values](./eslint.config.mjs#L11), [documentation](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects))
-- `getConfig` - function to get ESLint config with custom options ([source](./index.js#L59))
-- `getImportConfig` - function to get ESLint config for import plugin ([source](./rules/imports.mjs#L25))
-- `hooks` - ESLint config with rules for hooks ([source](./rules/hooks.mjs), [documentation](https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks#readme))
-- `ignores` - ESLint config with global ignored folder patterns ([default values](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/ignores.mjs#L4), [documentation](https://eslint.org/docs/latest/use/configure/ignore#ignoring-files))
-- `mapFiles` - helper function to map files for all configs ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/mapFiles.mjs))
-- `node` - ESLint config with rules for Node.js ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/node.mjs), [documentation](https://github.com/eslint-community/eslint-plugin-n/?tab=readme-ov-file#-rules))
-- `perfectionist` - ESLint config with rules for perfectionist ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/perfectionist.mjs), [documentation](https://perfectionist.dev/rules))
-- `plugins` - default plugins used in this config ([source](./eslint.config.mjs#L22))
-- `plus` - ESLint config with rules for extended rules ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/plus.mjs), [documentation](https://eslint.style/packages/plus))
-- `react` - ESLint config with rules for React ([source](./rules/react.mjs), [documentation](https://github.com/jsx-eslint/eslint-plugin-react#readme))
-- `reactConfigs` - ESlint config with rules for React only ([source](./index.js#L51))
-- `reactPlugins` - ESLint plugins used for React only ([source](./eslint.config.mjs#L15))
-- `reactStylistic` - ESLint config with stylistic rules for React ([source](./rules/stylistic.mjs), [documentation](https://eslint.style/packages/jsx))
-- `refresh` - ESLint config with rules for React refresh ([source](./rules/refresh.mjs), [documentation](https://github.com/ArnaudBarre/eslint-plugin-react-refresh#readme))
-- `refreshFiles` - default file patterns for React refresh config ([source](./eslint.config.mjs#L11))
-- `strict` - ESLint config with rules for strict mode ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/strict.mjs), [documentation](https://eslint.org/docs/latest/rules))
-- `stylistic` - ESLint config with React stylistic rules ([source](./rules/stylistic.mjs), [documentation](https://eslint.style/packages/jsx))
-- `vanillaConfigs` - Eslint configuration for vanilla javascript only (without import rules) ([source](./index.js#L32))
-- `variables` - ESLint config with rules for variables ([source](https://gitlab.com/Vylda/eslint-config-vylda-vanilla/-/blob/main/rules/variables.mjs), [documentation](https://eslint.org/docs/latest/rules))
+- `default export` - default ESLint config
+- `a11y` - ESLint config with rules for accessibility in React components ([source](./src/rules/a11y.ts), [documentation](https://github.com/es-tooling/eslint-plugin-jsx-a11y-x#readme))
+- `barrels` - ESLint config with rules for barrel files ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/barrels.ts), [documentation](https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/prefer-default-export.md))
+- `barrelsFiles` - default file pattern for barrel files ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/index.ts), [documentation](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects))
+- `bestPractices` - ESLint config with rules for best practices, extended with React lifecycle methods for `class-methods-use-this` ([source](./src/rules/best-practices.ts), [documentation (js)](https://eslint.org/docs/latest/rules), [documentation (stylistic)](https://eslint.style/packages/js#rules))
+- `constants` - Constants for some ESLint rules ([source](./src/rules/constants.ts))
+- `customs` - ESLint config with my custom rules ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/customs.ts))
+- `defaultImportExtensions` - default value for import-x/extensions module settings ([source](./src/rules/imports.ts), [documentation](https://github.com/un-ts/eslint-plugin-import-x?tab=readme-ov-file#import-xextensions))
+- `defaultImportExtensionsRuleGranularOption` - default value for import-x/extensions rule granular option ([source](./src/rules/imports.ts), [documentation](https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/extensions.md#rule-details))
+- `defaultImportNoExtraneousDependenciesDevDependencies` - default value for import-x/no-extraneous-dependencies rule devDependencies option ([source](./src/rules/imports.ts), [documentation](https://github.com/un-ts/eslint-plugin-import-x/blob/master/docs/rules/no-extraneous-dependencies.md#dependency-options))
+- `defaultImportResolverAlias` - default value for the `importResolverAlias` option (empty object, no aliases), see [Using path aliases](#using-path-aliases) ([source](./src/rules/imports.ts))
+- `defaultImportResolverNodeExtensions` - default value for the built-in node resolver's extensions ([source](./src/rules/imports.ts), [documentation](https://github.com/un-ts/eslint-plugin-import-x?tab=readme-ov-file#resolvers))
+- `defaults` - vanilla rule sets plus import rules (with the jsx-aware granular option), unmapped to files, for partial composition ([source](./src/index.ts))
+- `errors` - ESLint config with rules for errors ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/errors.ts), [documentation](https://eslint.org/docs/latest/rules))
+- `es6` - ESLint config with rules for ES6 ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/es6.ts), [documentation (js)](https://eslint.org/docs/latest/rules), [documentation (stylistic)](https://eslint.style/packages/js#rules))
+- `files` - default file pattern for all rules ([source](./src/index.ts), [documentation](https://eslint.org/docs/latest/use/configure/configuration-files#configuration-objects))
+- `getConfig` - function to get ESLint config with custom options ([source](./src/index.ts))
+- `getImportConfig` - function to get ESLint config for the import plugin, using this package's own jsx-aware defaults ([source](./src/index.ts))
+- `hooks` - ESLint config with rules for hooks ([source](./src/rules/hooks.ts), [documentation](https://react.dev/reference/eslint-plugin-react-hooks))
+- `ignores` - ESLint config with global ignored folder patterns ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/ignores.ts), [documentation](https://eslint.org/docs/latest/use/configure/ignore#ignoring-files))
+- `jsxExtension` - ESLint config restricting which file extensions may hold JSX, and enabling the JSX syntax; mapped to every JavaScript file rather than to `reactFiles` ([source](./src/rules/jsx-extension.ts), [documentation](https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-filename-extension.md))
+- `mapFiles` - helper function to map files for all configs ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/mapFiles.ts))
+- `node` - ESLint config with rules for Node.js ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/node.ts), [documentation](https://github.com/eslint-community/eslint-plugin-n/?tab=readme-ov-file#-rules))
+- `perfectionist` - ESLint config with rules for perfectionist ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/perfectionist.ts), [documentation](https://perfectionist.dev/rules))
+- `plugins` - default plugins used in this config ([source](./src/index.ts))
+- `plus` - ESLint config with rules for extended rules ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/plus.ts), [documentation](https://eslint.style/packages/plus))
+- `react` - ESLint config with rules for React ([source](./src/rules/react.ts), [documentation](https://github.com/jsx-eslint/eslint-plugin-react#readme))
+- `reactConfigs` - ESLint config with rules for React only ([source](./src/index.ts))
+- `reactFiles` - default file pattern for the react/hooks/a11y/refresh/reactStylistic configs ([source](./src/index.ts))
+- `reactPlugins` - ESLint plugins used for React only ([source](./src/index.ts))
+- `reactStylistic` - ESLint config with stylistic rules for React ([source](./src/rules/stylistic.ts), [documentation](https://eslint.style/packages/jsx))
+- `refresh` - ESLint config with rules for React refresh ([source](./src/rules/refresh.ts), [documentation](https://github.com/ArnaudBarre/eslint-plugin-react-refresh#readme))
+- `strict` - ESLint config with rules for strict mode ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/strict.ts), [documentation](https://eslint.org/docs/latest/rules))
+- `stylistic` - ESLint config with vanilla stylistic rules ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/stylistic.ts), [documentation](https://eslint.style/packages/js#rules))
+- `TConfig` - TypeScript type for an ESLint flat config array (`Array<Linter.Config>`) ([source](./src/index.ts))
+- `TGetConfigOptions` - TypeScript type for the options object accepted by `getConfig` ([source](./src/index.ts))
+- `TGetImportConfigOptions` - TypeScript type for the options object accepted by `getImportConfig` ([source](./src/index.ts))
+- `TPlugin` - TypeScript type alias for a single ESLint plugin (`ESLint.Plugin`) ([source](./src/index.ts))
+- `TPlugins` - TypeScript type alias for a map of plugins (`Record<string, TPlugin>`) ([source](./src/index.ts))
+- `vanillaConfigs` - ESLint configuration for vanilla javascript only (without import rules) ([source](./src/index.ts))
+- `variables` - ESLint config with rules for variables ([source](https://gitlab.com/eslint-configs/eslint-config-vylda-vanilla/-/blob/main/src/rules/variables.ts), [documentation](https://eslint.org/docs/latest/rules))
+
+## ESLint 10 compatibility
+
+`eslint-plugin-react` has had no release since 7.37.5 (2025-04-03) and still declares a peer range of `^9.7`. Two of its rules reach for accessors that ESLint 10 removed, without the fallback the rest of its rules use, and crash on load:
+
+| rule | call | removed in favour of |
+| --- | --- | --- |
+| `react/forward-ref-uses-ref` | `context.getSourceCode()` | `context.sourceCode` |
+| `react/jsx-filename-extension` | `context.getFilename()` | `context.filename` |
+
+This package works around both, so there is nothing to do on your side:
+
+- the plugin's rules run behind a proxy ([source](./src/utils/legacyContext.ts)) that serves the removed `context` accessors from the properties that replaced them. It only fills in what the context does not already have, so on ESLint 9 nothing changes.
+- an `overrides` block in `package.json` pins the plugin's `eslint` peer to the root one. That block applies to this repository only: npm honours `overrides` from the root project, and in your project the plugin is a transitive dependency, where npm resolves the peer on its own.
+
+### TODO: re-check on the next eslint-plugin-react release
+
+- Drop `withLegacyContextRules` from [src/index.ts](./src/index.ts) and run `npm test`. The test `react rules that call the context API removed in ESLint 10 still run` fails for as long as the proxy is needed. Once it passes without it, delete [src/utils/legacyContext.ts](./src/utils/legacyContext.ts), its test and the call.
+- Once the plugin's peer range covers ESLint 10, drop the `overrides` block from `package.json` and verify with `npm ci`, not `npm install` -- the latter only warns.
+- `react/jsx-curly-spacing`, `react/jsx-equals-spacing`, `react/jsx-one-expression-per-line`, `react/jsx-space-before-closing` and `react/jsx-tag-spacing` crash on `sourceCode.isSpaceBetweenTokens`, which the proxy cannot reach because it is a `SourceCode` method rather than a `context` accessor. All five are `off` (`@stylistic` covers them), so nothing depends on this today.
 
 ## Additional Documentation
 

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+import { barrels, barrelsFiles, customs, errors, es6, ignores, mapFiles, node, perfectionist, plus, strict, stylistic, type TGetImportConfigOptions as TVanillaGetImportConfigOptions, variables } from 'eslint-config-vylda-vanilla';
+import bestPractices from './rules/best-practices.js';
+import * as constants from './rules/constants.js';
+import { defaultImportExtensions, defaultImportExtensionsRuleGranularOption, defaultImportNoExtraneousDependenciesDevDependencies, defaultImportResolverAlias, defaultImportResolverNodeExtensions } from './rules/imports.js';
+import { a11y, hooks, jsxExtension, react, reactStylistic, refresh } from './rules/index.js';
+import type { ESLint, Linter } from 'eslint';
+export type TConfig = Array<Linter.Config>;
+export type TGetConfigOptions = TGetImportConfigOptions & {
+    barrelsFiles?: Array<string>;
+    files?: Array<string>;
+    plugins?: TPlugins;
+    reactFiles?: Array<string>;
+};
+export type TGetImportConfigOptions = TVanillaGetImportConfigOptions;
+export type TPlugin = ESLint.Plugin;
+export type TPlugins = Record<string, TPlugin>;
+export declare const files: Array<string>;
+export declare const reactFiles: Array<string>;
+export declare const reactPlugins: TPlugins;
+export declare const plugins: TPlugins;
+export declare const getImportConfig: (options?: TGetImportConfigOptions) => TConfig;
+declare const reactConfigs: TConfig;
+export declare const getConfig: (options?: TGetConfigOptions) => TConfig;
+export declare const vanillaConfigs: TConfig;
+export declare const defaults: TConfig;
+declare const config: TConfig;
+export { a11y, barrels, barrelsFiles, bestPractices, constants, customs, defaultImportExtensions, defaultImportExtensionsRuleGranularOption, defaultImportNoExtraneousDependenciesDevDependencies, defaultImportResolverAlias, defaultImportResolverNodeExtensions, errors, es6, hooks, ignores, jsxExtension, mapFiles, node, perfectionist, plus, react, reactConfigs, reactStylistic, refresh, strict, stylistic, variables, };
+export default config;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EACpE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EACtC,KAAK,uBAAuB,IAAI,8BAA8B,EACQ,SAAS,EAChF,MAAM,6BAA6B,CAAC;AAMrC,OAAO,aAAa,MAAM,wBAAwB,CAAC;AACnD,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EACL,uBAAuB,EACvB,yCAAyC,EACzC,oDAAoD,EACpD,0BAA0B,EAC1B,mCAAmC,EACpC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAC1D,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC3C,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG;IACxD,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG,8BAA8B,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;AAEpC,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE/C,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,MAAM,CAA6B,CAAC;AAC9D,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,MAAM,CAAgB,CAAC;AAatD,eAAO,MAAM,YAAY,EAAE,QAK1B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,QAGrB,CAAC;AASF,eAAO,MAAM,eAAe,GAAI,UAAS,uBAA4B,KAAG,OAgBvE,CAAC;AAcF,QAAA,MAAM,YAAY,EAAE,OAMnB,CAAC;AAyCF,eAAO,MAAM,SAAS,GAAI,UAAS,iBAAkC,KAAG,OA8BvE,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,OAAkC,CAAC;AAUhE,eAAO,MAAM,QAAQ,EAAE,OAAoD,CAAC;AAE5E,QAAA,MAAM,MAAM,EAAE,OAAqB,CAAC;AAEpC,OAAO,EACL,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,SAAS,EACT,OAAO,EACP,uBAAuB,EACvB,yCAAyC,EACzC,oDAAoD,EACpD,0BAA0B,EAC1B,mCAAmC,EACnC,MAAM,EACN,GAAG,EACH,KAAK,EACL,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,aAAa,EACb,IAAI,EACJ,KAAK,EACL,YAAY,EACZ,cAAc,EACd,OAAO,EACP,MAAM,EACN,SAAS,EACT,SAAS,GACV,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,119 @@
+import { barrels, barrelsFiles, customs, errors, es6, ignores, mapFiles, node, perfectionist, plus, strict, stylistic, getImportConfig as vanillaGetImportConfig, plugins as vanillaPlugins, variables, } from 'eslint-config-vylda-vanilla';
+import jsxA11y from 'eslint-plugin-jsx-a11y-x';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import reactRefresh from 'eslint-plugin-react-refresh';
+// eslint-disable-next-line import-x/no-rename-default
+import bestPractices from './rules/best-practices.js';
+import * as constants from './rules/constants.js';
+import { defaultImportExtensions, defaultImportExtensionsRuleGranularOption, defaultImportNoExtraneousDependenciesDevDependencies, defaultImportResolverAlias, defaultImportResolverNodeExtensions, } from './rules/imports.js';
+import { a11y, hooks, jsxExtension, react, reactStylistic, refresh, } from './rules/index.js';
+import { withLegacyContextRules } from './utils/legacyContext.js';
+export const files = ['**/*.{cjs,js,jsx,mjs}'];
+export const reactFiles = ['**/*.jsx'];
+const jsxA11yPlugin = jsxA11y.configs.strict.plugins['jsx-a11y-x'];
+// `configs` is dropped instead of typed: react-hooks in particular ships a `configs.flat` shape
+// that eslint's own `Plugin.configs` type does not accept, and nothing here reads `configs`.
+const { configs: droppedReactPluginConfigs, ...reactPluginWithoutConfigs } = reactPlugin;
+const { configs: droppedReactHooksConfigs, ...reactHooksWithoutConfigs } = reactHooks;
+// eslint-plugin-react 7.37.5 still calls `context` accessors that ESLint 10 removed, so its rules
+// run behind a compatibility proxy. The other three plugins already declare ESLint 10 support.
+const reactPluginWithLegacyContext = withLegacyContextRules(reactPluginWithoutConfigs);
+export const reactPlugins = {
+    'jsx-a11y-x': jsxA11yPlugin,
+    react: reactPluginWithLegacyContext,
+    'react-hooks': reactHooksWithoutConfigs,
+    'react-refresh': reactRefresh,
+};
+export const plugins = {
+    ...vanillaPlugins,
+    ...reactPlugins,
+};
+const dineddd = defaultImportNoExtraneousDependenciesDevDependencies;
+const diergo = defaultImportExtensionsRuleGranularOption;
+const diralias = defaultImportResolverAlias;
+// Wraps vanilla's `getImportConfig` so it defaults to this package's own import settings
+// (including the jsx-aware `importExtensionsRuleGranularOption`) instead of vanilla's plain
+// ones -- matching what the README documents ("uses the same default values as the package").
+export const getImportConfig = (options = {}) => {
+    const { importExtensions: ie = defaultImportExtensions, importExtensionsRuleGranularOption: iergo = diergo, importNoExtraneousDependenciesDevDependencies: ineddd = dineddd, importResolverAlias: ira = diralias, importResolverNodeExtensions: irne = defaultImportResolverNodeExtensions, } = options;
+    return vanillaGetImportConfig({
+        importExtensions: ie,
+        importExtensionsRuleGranularOption: iergo,
+        importNoExtraneousDependenciesDevDependencies: ineddd,
+        importResolverAlias: ira,
+        importResolverNodeExtensions: irne,
+    });
+};
+const defaultOptions = {
+    barrelsFiles,
+    files,
+    importExtensions: defaultImportExtensions,
+    importExtensionsRuleGranularOption: diergo,
+    importNoExtraneousDependenciesDevDependencies: dineddd,
+    importResolverAlias: diralias,
+    importResolverNodeExtensions: defaultImportResolverNodeExtensions,
+    plugins,
+    reactFiles,
+};
+const reactConfigs = [
+    ...a11y,
+    ...hooks,
+    ...react,
+    ...reactStylistic,
+    ...refresh,
+];
+const createVanillaConfigs = (importConfigs) => [
+    ...importConfigs,
+    ...es6,
+    ...strict,
+    ...stylistic,
+    ...bestPractices,
+    ...errors,
+    ...node,
+    ...variables,
+    ...customs,
+    ...perfectionist,
+    ...plus,
+];
+const createReactConfig = (customFiles, customBarrelsFiles, customReactFiles, customPlugins, vanillaBaseConfigs) => {
+    const configsWithFiles = mapFiles(vanillaBaseConfigs, customFiles);
+    const reactConfigWithFiles = mapFiles(reactConfigs, customReactFiles);
+    const jsxExtensionWithFiles = mapFiles(jsxExtension, customFiles);
+    const barrelsConfigWithFiles = mapFiles(barrels, customBarrelsFiles);
+    return [
+        {
+            name: 'vanilla-react/base',
+            plugins: customPlugins,
+        },
+        ...configsWithFiles,
+        ...reactConfigWithFiles,
+        ...jsxExtensionWithFiles,
+        ...barrelsConfigWithFiles,
+        ...ignores,
+    ];
+};
+export const getConfig = (options = defaultOptions) => {
+    const { barrelsFiles: customBarrelsFiles = barrelsFiles, files: customFiles = files, importExtensions: ie = defaultImportExtensions, importExtensionsRuleGranularOption: iergo = diergo, importNoExtraneousDependenciesDevDependencies: ineddd = dineddd, importResolverAlias: ira = diralias, importResolverNodeExtensions: irne = defaultImportResolverNodeExtensions, plugins: customPlugins = plugins, reactFiles: customReactFiles = reactFiles, } = options;
+    const importConfigs = getImportConfig({
+        importExtensions: ie,
+        importExtensionsRuleGranularOption: iergo,
+        importNoExtraneousDependenciesDevDependencies: ineddd,
+        importResolverAlias: ira,
+        importResolverNodeExtensions: irne,
+    });
+    const vanillaConfigsForOptions = createVanillaConfigs(importConfigs);
+    return createReactConfig(customFiles, customBarrelsFiles, customReactFiles, customPlugins, vanillaConfigsForOptions);
+};
+export const vanillaConfigs = createVanillaConfigs([]);
+const defaultImportConfigs = getImportConfig({
+    importExtensions: defaultImportExtensions,
+    importExtensionsRuleGranularOption: diergo,
+    importNoExtraneousDependenciesDevDependencies: dineddd,
+    importResolverAlias: diralias,
+    importResolverNodeExtensions: defaultImportResolverNodeExtensions,
+});
+export const defaults = createVanillaConfigs(defaultImportConfigs);
+const config = getConfig();
+export { a11y, barrels, barrelsFiles, bestPractices, constants, customs, defaultImportExtensions, defaultImportExtensionsRuleGranularOption, defaultImportNoExtraneousDependenciesDevDependencies, defaultImportResolverAlias, defaultImportResolverNodeExtensions, errors, es6, hooks, ignores, jsxExtension, mapFiles, node, perfectionist, plus, react, reactConfigs, reactStylistic, refresh, strict, stylistic, variables, };
+export default config;

package/dist/rules/a11y.d.ts

@@ -0,0 +1,4 @@
+import type { Linter } from 'eslint';
+declare const config: Array<Linter.Config>;
+export default config;
+//# sourceMappingURL=a11y.d.ts.map

package/dist/rules/a11y.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a11y.d.ts","sourceRoot":"","sources":["../../src/rules/a11y.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAmGrC,QAAA,MAAM,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAqOhC,CAAC;AAEF,eAAe,MAAM,CAAC"}