@webadeva/eslint-config 0.1.2 → 0.1.3

package/README.md

@@ -31,12 +31,12 @@ import config from "@webadeva/eslint-config";
 export default config;
 ```
 
-| Preset    | Import                              | Includes                     |
-| --------- | ----------------------------------- | ---------------------------- |
-| Base      | `@webadeva/eslint-config`           | TypeScript, Prettier, import |
-| React     | `@webadeva/eslint-config/react`     | Base + React                 |
-| Next.js   | `@webadeva/eslint-config/next`      | React + Next.js              |
-| Storybook | `@webadeva/eslint-config/storybook` | Next.js + Storybook          |
+| Preset    | Import                              | Includes                |
+| --------- | ----------------------------------- | ----------------------- |
+| Base      | `@webadeva/eslint-config`           | TypeScript, Prettier    |
+| React     | `@webadeva/eslint-config/react`     | Base + React + JSX a11y |
+| Next.js   | `@webadeva/eslint-config/next`      | React + Next.js         |
+| Storybook | `@webadeva/eslint-config/storybook` | Next.js + Storybook     |
 
 `@webadeva/eslint-config/base` is an alias of the base preset. Only the base preset can be loaded with `require()`. The others are ESM-only because `@eslint-react` is.
 
@@ -66,16 +66,51 @@ Type-aware rules run on every file that typed linting can cover:
 - **Up to 8 root-level files outside any tsconfig**, such as config files and scripts, are typed with a [built-in fallback tsconfig](tsconfig.default.json). Root-level `.jsx`/`.tsx` files are included only if `@types/react` is installed.
 - **Other files outside any tsconfig** get every rule except the type-aware ones. TS files in this situation are reported by `webadeva/typescript-file-in-project`, so they don't go unchecked unnoticed.
 
+## Accessibility
+
+The React preset (and so the Next.js and Storybook presets) turns on the `recommended` config of [`eslint-plugin-jsx-a11y-x`](https://github.com/es-tooling/eslint-plugin-jsx-a11y-x), a maintained fork of `eslint-plugin-jsx-a11y`. Its rules are prefixed `jsx-a11y-x/`. To use the stricter rule set, or to adjust single rules, add a config after the preset:
+
+```js
+import jsxA11y from "eslint-plugin-jsx-a11y-x";
+import config from "@webadeva/eslint-config/react";
+
+export default [
+  ...config,
+  jsxA11y.configs.strict,
+  { rules: { "jsx-a11y-x/no-autofocus": "off" } },
+];
+```
+
+Install `eslint-plugin-jsx-a11y-x` in your project if you import it yourself like this.
+
+Lint rules only see static JSX. To check the rendered DOM, run [`@axe-core/react`](https://github.com/dequelabs/axe-core-npm/tree/develop/packages/react) in development. It is a runtime tool, not an ESLint plugin, so this package doesn't install it. Add it to your app and call it from your entry point:
+
+```bash
+pnpm add -D @axe-core/react
+```
+
+```js
+import React from "react";
+import ReactDOM from "react-dom";
+
+if (process.env.NODE_ENV !== "production") {
+  const { default: axe } = await import("@axe-core/react");
+  await axe(React, ReactDOM, 1000);
+}
+```
+
+Violations are logged to the browser console. `@axe-core/react` does not support React 18 or later, and it needs Node.js `>=22.12`.
+
 ## Defaults worth knowing
 
 - These paths are ignored: `dist`, `*.config.*`, `**/__tests__/**`, `**/__mocks__/**`.
-- Prettier runs as a lint rule and uses your Prettier config.
+- Prettier runs as a lint rule and uses your Prettier config. Imports are not linted by a dedicated plugin. Add [`prettier-plugin-organize-imports`](https://github.com/simonhaenisch/prettier-plugin-organize-imports) to your Prettier config, and `eslint --fix` sorts imports and removes unused ones.
 - The React preset detects your React version, including in monorepos.
 - Some rules are opinionated: `no-console` warns, and arrow functions are preferred over `function`.
 
 ## What's included
 
-[`@eslint/js`](https://eslint.org/docs/latest/rules/), [typescript-eslint](https://typescript-eslint.io/) (recommended + stylistic, type-checked), [Prettier](https://github.com/prettier/eslint-plugin-prettier), [import](https://github.com/import-js/eslint-plugin-import), [eslint-comments](https://github.com/eslint-community/eslint-plugin-eslint-comments), [prefer-arrow-functions](https://github.com/JamieMason/eslint-plugin-prefer-arrow-functions), [@eslint-react](https://eslint-react.xyz/), [react-hooks](https://react.dev/reference/eslint-plugin-react-hooks), [react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh), [Next.js](https://nextjs.org/docs/app/api-reference/config/eslint), [Storybook](https://github.com/storybookjs/eslint-plugin-storybook), and [this package's own rules](docs/rules.md).
+[`@eslint/js`](https://eslint.org/docs/latest/rules/), [typescript-eslint](https://typescript-eslint.io/) (recommended + stylistic, type-checked), [Prettier](https://github.com/prettier/eslint-plugin-prettier), [eslint-comments](https://github.com/eslint-community/eslint-plugin-eslint-comments), [prefer-arrow-functions](https://github.com/JamieMason/eslint-plugin-prefer-arrow-functions), [@eslint-react](https://eslint-react.xyz/), [react-hooks](https://react.dev/reference/eslint-plugin-react-hooks), [react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh), [jsx-a11y-x](https://github.com/es-tooling/eslint-plugin-jsx-a11y-x), [Next.js](https://nextjs.org/docs/app/api-reference/config/eslint), [Storybook](https://github.com/storybookjs/eslint-plugin-storybook), and [this package's own rules](docs/rules.md).
 
 ## Contributing
 

package/dist/index.cjs

@@ -24,8 +24,6 @@ let _eslint_community_eslint_plugin_eslint_comments = require("@eslint-community
 _eslint_community_eslint_plugin_eslint_comments = __toESM(_eslint_community_eslint_plugin_eslint_comments, 1);
 let _eslint_js = require("@eslint/js");
 _eslint_js = __toESM(_eslint_js, 1);
-let eslint_plugin_import = require("eslint-plugin-import");
-eslint_plugin_import = __toESM(eslint_plugin_import, 1);
 let eslint_plugin_prefer_arrow_functions = require("eslint-plugin-prefer-arrow-functions");
 eslint_plugin_prefer_arrow_functions = __toESM(eslint_plugin_prefer_arrow_functions, 1);
 let eslint_plugin_prettier = require("eslint-plugin-prettier");
@@ -301,8 +299,7 @@ const baseConfigs = [
 			prettier: eslint_plugin_prettier.default,
 			"prefer-arrow-functions": eslint_plugin_prefer_arrow_functions.default,
 			"@typescript-eslint": tseslint$1.plugin,
-			"eslint-comments": _eslint_community_eslint_plugin_eslint_comments.default,
-			import: eslint_plugin_import.default
+			"eslint-comments": _eslint_community_eslint_plugin_eslint_comments.default
 		},
 		rules: {
 			..._eslint_js.default.configs.recommended.rules,

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BaVe3nYe.mjs";
+import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BQwdjN7J.mjs";
 //#region src/index.ts
 const config = [...baseConfigs, ...untypedFilesConfigs()];
 //#endregion

package/dist/next.mjs

@@ -1,5 +1,5 @@
-import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BaVe3nYe.mjs";
-import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-Dq8MXjy6.mjs";
+import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BQwdjN7J.mjs";
+import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-DWgZpojs.mjs";
 import { t as nextConfigs } from "./next-CWjuCwpN.mjs";
 //#region src/next.ts
 const config = [

package/dist/{react-Dq8MXjy6.mjs → react-DWgZpojs.mjs}

@@ -1,7 +1,8 @@
-import { r as ensureTypeScript } from "./untyped-BaVe3nYe.mjs";
+import { r as ensureTypeScript } from "./untyped-BQwdjN7J.mjs";
 import { createRequire } from "node:module";
 import { readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+import pluginJsxA11y from "eslint-plugin-jsx-a11y-x";
 import pluginReactHooks from "eslint-plugin-react-hooks";
 import pluginReactRefresh from "eslint-plugin-react-refresh";
 //#region src/utils/detect-react-version.ts
@@ -42,6 +43,7 @@ const reactConfigs = [
 	eslintReact.configs["recommended-typescript"],
 	pluginReactHooks.configs.flat["recommended-latest"],
 	pluginReactRefresh.configs.recommended,
+	pluginJsxA11y.configs.recommended,
 	{
 		settings: { react: { version: detectReactVersion() } },
 		rules: {

package/dist/react.mjs

@@ -1,5 +1,5 @@
-import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BaVe3nYe.mjs";
-import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-Dq8MXjy6.mjs";
+import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BQwdjN7J.mjs";
+import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-DWgZpojs.mjs";
 //#region src/react.ts
 const config = [
 	...baseConfigs,

package/dist/storybook.mjs

@@ -1,5 +1,5 @@
-import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BaVe3nYe.mjs";
-import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-Dq8MXjy6.mjs";
+import { n as baseConfigs, t as untypedFilesConfigs } from "./untyped-BQwdjN7J.mjs";
+import { n as reactDisableTypeChecked, t as reactConfigs } from "./react-DWgZpojs.mjs";
 import { t as nextConfigs } from "./next-CWjuCwpN.mjs";
 import storybook from "eslint-plugin-storybook";
 //#region src/configs/storybook.ts

package/dist/{untyped-BaVe3nYe.mjs → untyped-BQwdjN7J.mjs}

@@ -1,7 +1,6 @@
 import { createRequire } from "node:module";
 import eslintComments from "@eslint-community/eslint-plugin-eslint-comments";
 import pluginJs from "@eslint/js";
-import importPlugin from "eslint-plugin-import";
 import preferArrowFunctions from "eslint-plugin-prefer-arrow-functions";
 import prettier from "eslint-plugin-prettier";
 import globals from "globals";
@@ -273,8 +272,7 @@ const baseConfigs = [
 			prettier,
 			"prefer-arrow-functions": preferArrowFunctions,
 			"@typescript-eslint": tseslint$1.plugin,
-			"eslint-comments": eslintComments,
-			import: importPlugin
+			"eslint-comments": eslintComments
 		},
 		rules: {
 			...pluginJs.configs.recommended.rules,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webadeva/eslint-config",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Shared ESLint flat configs for TypeScript projects: type-aware rules, Prettier, and presets for React, Next.js, and Storybook.",
   "keywords": [
     "eslint",
@@ -12,6 +12,7 @@
     "typescript-eslint",
     "prettier",
     "react",
+    "a11y",
     "nextjs",
     "storybook",
     "lint"
@@ -101,8 +102,7 @@
     "@typescript-eslint/eslint-plugin": "^8.71.2",
     "@typescript-eslint/parser": "^8.71.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-jsx-a11y-x": "^0.2.0",
     "eslint-plugin-prefer-arrow-functions": "^3.10.2",
     "eslint-plugin-prettier": "^5.5.7",
     "eslint-plugin-react-hooks": "^7.1.1",