@alexlit/config-eslint 157.0.0 → 158.0.1

package/README.md

@@ -5,6 +5,10 @@
 > [@alexlit/config-eslint@90](https://www.npmjs.com/package/@alexlit/config-eslint?activeTab=versions)
 > or lower.
 
+There are no presets: `base` only provides the shared file scope, ignore
+patterns and globals. Every plugin is enabled explicitly, so you pay only for
+what you use.
+
 ## Installation
 
 ```sh
@@ -13,33 +17,118 @@ npm i @alexlit/config-eslint -D
 
 ## Connection
 
-- With preset
+Always start with `base` (it must be first) and finish with `prettierConfig` (it
+must be last, it disables the formatting rules).
+
+```js
+// eslint.config.js
+import {
+  // foundation
+  base,
+
+  // plugins
+  deMorgan,
+  importX,
+  javascript,
+  jsdoc,
+  json,
+  perfectionist,
+  prettierConfig,
+  regexp,
+  sonar,
+  stylistic,
+  typescript,
+  unicorn,
+
+  // framework plugins
+  pinia,
+  tailwindcss,
+  tanstackQuery,
+  unocss,
+  vitest,
+  vue,
+  vueAccessibility,
+  vueI18n,
+  zod,
+} from '@alexlit/config-eslint';
+
+export default [
+  ...base, // must be first
+
+  ...deMorgan,
+  ...importX,
+  ...javascript,
+  ...jsdoc,
+  ...json,
+  ...perfectionist,
+  ...regexp,
+  ...sonar,
+  ...stylistic,
+  ...typescript,
+  ...unicorn,
+
+  ...pinia,
+  ...tanstackQuery,
+  ...unocss,
+  ...vitest,
+  ...vue,
+  ...vueAccessibility,
+  ...vueI18n,
+  ...zod,
+
+  // `tailwindcss` is the only plugin exported as a factory, because it needs a path to your CSS entrypoint
+  ...tailwindcss({ cssConfigPath: './src/assets/css/main.css' }),
+
+  ...prettierConfig, // must be last
 
-  ```js
-  // eslint.config.js
-  import { defaultPreset } from '@alexlit/config-eslint';
+  // Custom rules example
+  // { files: ['**/*.js'], rules: { 'no-console': 'off' } },
+];
+```
+
+Drop what you do not need.
+
+## Type-aware rules (optional)
+
+Type-aware rules (`no-floating-promises`, `no-misused-promises`,
+`await-thenable`, `no-unsafe-*`, `switch-exhaustiveness-check`,
+`no-unnecessary-condition`, …) require type information, which makes linting
+slower. They are not enabled by default.
+
+To enable them, replace `typescript` with `typescriptTypeChecked`:
+
+```js
+import {
+  base,
+  typescriptTypeChecked,
+  prettierConfig,
+} from '@alexlit/config-eslint';
+
+export default [
+  ...base,
+  // ...other plugins
+  ...typescriptTypeChecked, // instead of ...typescript
+  ...prettierConfig,
+];
+```
 
-  export default [...defaultPreset];
-  ```
+> [!NOTE] `typescriptTypeChecked` needs a `tsconfig.json` in your project root
+> (`projectService` is used, so keep both `tsconfig.json` and
+> `tsconfig.node.json` etc. in a single root if needed). Use it instead of
+> `typescript`, not alongside.
 
-- Custom rules
-  ([available plugins](https://github.com/alex-lit/lint-kit/blob/master/packages/config-eslint/index.js))
+## Formatting: `prettier` vs `prettierConfig`
 
-  ```js
-  // eslint.config.js
-  import { typescript, unicorn, vitest } from '@alexlit/config-eslint';
+Both are included, and they are **not** interchangeable.
 
-  // config example:
-  export default [
-    ...typescript,
-    ...unicorn,
-    ...vitest,
+| Export           | From                     | Effect                                           |
+| ---------------- | ------------------------ | ------------------------------------------------ |
+| `prettierConfig` | `eslint-config-prettier` | only turns off formatting rules that conflict    |
+| `prettier`       | `eslint-plugin-prettier` | additionally runs Prettier itself as a lint rule |
 
-    ...[
-      // <custom rules>
-    ],
-  ];
-  ```
+Use `prettierConfig` when Prettier runs as a separate step (editor, `prettier`
+CLI, Husky). Use `prettier` if you want ESLint to report and fix formatting in
+one pass — it is slower and duplicates the formatter.
 
 ## Usefull links
 

package/base.js

@@ -0,0 +1,68 @@
+import { defineConfig } from 'eslint/config';
+import globals from 'globals';
+
+/** All source files covered by the shareable config */
+export const FILES = ['**/*.{js,mjs,cjs,jsx,ts,tsx,mts,cts,vue}'];
+
+/** TypeScript source files */
+export const TS_FILES = ['**/*.{ts,tsx,mts,cts}'];
+
+/** Vue.js single-file components */
+export const VUE_FILES = ['**/*.vue'];
+
+/** JSON files */
+export const JSON_FILES = ['**/*.{json,jsonc,json5}'];
+
+/** YAML files */
+export const YAML_FILES = ['**/*.{yaml,yml}'];
+
+/**
+ * Files that hold data rather than code.
+ *
+ * Plugins that ship configs without a `files` key would otherwise apply their
+ * rules to these files, so such blocks have to exclude them explicitly.
+ */
+export const DATA_FILES = [...JSON_FILES, ...YAML_FILES];
+
+/** Test files */
+export const TEST_FILES = [
+  '**/*.{test,spec}.{js,cjs,mjs,jsx,ts,tsx,mts,cts,vue}',
+];
+
+/** Type declaration files */
+export const DTS_FILES = ['**/*.d.{ts,mts,cts}'];
+
+/** Never linted */
+export const IGNORES = [
+  '**/.*',
+  '**/.*/**',
+  '**/_deprecated/**',
+  '**/build/**',
+  '**/dist/**',
+  '**/docs/**',
+  '**/mockServiceWorker.js',
+  '**/storybook-*/**',
+  '**/sw.js',
+];
+
+/**
+ * Base config.
+ *
+ * Provides the file scope, the shared ignore patterns and the global variables.
+ * Include it first, then the plugins you actually need.
+ *
+ * @example
+ *   import { base, javascript, unicorn } from '@alexlit/config-eslint';
+ *
+ *   export default [...base, ...javascript, ...unicorn];
+ */
+export const base = defineConfig([
+  { files: FILES, languageOptions: { globals: globals.browser } },
+
+  // Node.js globals for commonjs/esm files
+  { files: ['**/*.{cjs,mjs}'], languageOptions: { globals: globals.node } },
+
+  { linterOptions: { reportUnusedDisableDirectives: 'error' } },
+
+  { ignores: IGNORES },
+]);

package/index.js

@@ -1,4 +1,18 @@
+export {
+  base,
+  DATA_FILES,
+  DTS_FILES,
+  FILES,
+  IGNORES,
+  JSON_FILES,
+  TEST_FILES,
+  TS_FILES,
+  VUE_FILES,
+  YAML_FILES,
+} from './base.js';
+
 export { deMorgan } from './plugins/de-morgan.js';
+export { importX } from './plugins/import-x.js';
 export { javascript } from './plugins/javascript.js';
 export { jsdoc } from './plugins/jsdoc.js';
 export { json } from './plugins/json.js';
@@ -10,6 +24,7 @@ export { sonar } from './plugins/sonar.js';
 export { stylistic } from './plugins/stylistic.js';
 export { tailwindcss } from './plugins/tailwindcss.js';
 export { tanstackQuery } from './plugins/tanstack-query.js';
+export { typescriptTypeChecked } from './plugins/typescript-type-checked.js';
 export { typescript } from './plugins/typescript.js';
 export { unicorn } from './plugins/unicorn.js';
 export { unocss } from './plugins/unocss.js';
@@ -18,5 +33,5 @@ export { vueAccessibility } from './plugins/vue-accessibility.js';
 export { vueI18n } from './plugins/vue-i18n.js';
 export { vue } from './plugins/vue.js';
 export { zod } from './plugins/zod.js';
-
-export { defaultPreset } from './presets/default.js';
+export { NO_RESTRICTED_SYNTAX } from './rules/restricted-syntax.js';
+export { TS_RULES } from './rules/typescript.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/config-eslint",
-  "version": "157.0.0",
+  "version": "158.0.1",
   "private": false,
   "description": "Sharable ESLint configuration",
   "keywords": [
@@ -26,8 +26,9 @@
   "main": "./index.js",
   "files": [
     "index.js",
+    "base.js",
     "plugins/",
-    "presets/",
+    "rules/",
     "README.md"
   ],
   "scripts": {
@@ -49,6 +50,7 @@
     "eslint": "^10.11.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-de-morgan": "^2.2.0",
+    "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-jsdoc": "^65.0.0",
     "eslint-plugin-perfectionist": "^5.12.1",
     "eslint-plugin-pinia": "^0.4.2",

package/plugins/de-morgan.js

@@ -1,5 +1,9 @@
 import plugin from 'eslint-plugin-de-morgan';
 import { defineConfig } from 'eslint/config';
 
+import { FILES } from '../base.js';
+
 /** @see [eslint-plugin-de-morgan](https://github.com/azat-io/eslint-plugin-de-morgan) */
-export const deMorgan = defineConfig([plugin.configs.recommended]);
+export const deMorgan = defineConfig([
+  { files: FILES, ...plugin.configs.recommended },
+]);

package/plugins/import-x.js

@@ -0,0 +1,77 @@
+import plugin from 'eslint-plugin-import-x';
+import { createNodeResolver } from 'eslint-plugin-import-x/node-resolver';
+import { defineConfig } from 'eslint/config';
+
+import { DATA_FILES, FILES, TEST_FILES, VUE_FILES } from '../base.js';
+
+const EXTENSIONS = [
+  '.ts',
+  '.tsx',
+  '.mts',
+  '.cts',
+  '.js',
+  '.jsx',
+  '.mjs',
+  '.cjs',
+  '.vue',
+  '.json',
+];
+
+/** @see [eslint-plugin-import-x](https://github.com/un-ts/eslint-plugin-import-x) */
+export const importX = defineConfig([
+  // `recommended` comes without a `files` key, so it would also land on data
+  // files, which are not modules and have nothing to import from.
+  { ...plugin.flatConfigs.recommended, files: FILES, ignores: DATA_FILES },
+
+  {
+    files: FILES,
+    languageOptions: { parserOptions: { ecmaFeatures: { jsx: true } } },
+    plugins: { 'import-x': plugin },
+    rules: {
+      'import-x/consistent-type-specifier-style': ['error', 'prefer-top-level'],
+      'import-x/first': 'error',
+      'import-x/newline-after-import': 'warn',
+      'import-x/no-absolute-path': 'error',
+      'import-x/no-cycle': 'error',
+      'import-x/no-extraneous-dependencies': 'error',
+      // Both come from `recommended`, but they are wrong for ESLint plugins:
+      // the default export is the plugin object, so `plugin.configs` is a
+      // property of it, not a named export of the package. Some packages even
+      // export `plugin` as a named export, which makes `no-named-as-default`
+      // fire on the conventional `import plugin from '…'` line.
+      'import-x/no-named-as-default': 'off',
+      'import-x/no-named-as-default-member': 'off',
+      'import-x/no-nodejs-modules': 'off',
+      'import-x/no-self-import': 'error',
+      'import-x/no-useless-path-segments': ['error', { noUselessIndex: true }],
+      'import-x/unambiguous': 'error',
+    },
+    settings: {
+      'import-x/extensions': EXTENSIONS,
+      'import-x/parsers': { '.vue': ['vue-eslint-parser'] },
+      // Reads `paths` from the closest `tsconfig.json`, so `~/…`, `@/…` and
+      // other aliases are resolved the same way the bundler resolves them.
+      'import-x/resolver-next': [
+        createNodeResolver({ extensions: EXTENSIONS, tsconfig: 'auto' }),
+      ],
+    },
+  },
+  {
+    files: TEST_FILES,
+    rules: {
+      'import-x/no-extraneous-dependencies': [
+        'error',
+        { devDependencies: true },
+      ],
+    },
+  },
+
+  {
+    files: VUE_FILES,
+    rules: {
+      // A component without a `<script>` block is a valid component, not an
+      // ambiguous module that needs explicit imports.
+      'import-x/unambiguous': 'off',
+    },
+  },
+]);

package/plugins/javascript.js

@@ -1,7 +1,9 @@
 import plugin from '@eslint/js';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES, TEST_FILES } from '../base.js';
+import { NO_RESTRICTED_SYNTAX } from '../rules/restricted-syntax.js';
+import { STYLE_RULES } from '../rules/style.js';
 
 /** @see [eslint](https://eslint.org) */
 export const javascript = defineConfig([
@@ -10,11 +12,14 @@ export const javascript = defineConfig([
     files: FILES,
     rules: {
       'arrow-body-style': ['error', 'as-needed'],
-      'curly': 'error',
+      ...STYLE_RULES,
+      'default-case-last': 'error',
       'dot-notation': ['error'],
-      'func-style': ['error', 'expression'],
       'grouped-accessor-pairs': ['error', 'getBeforeSet'],
+      'no-alert': 'error',
+      'no-console': 'error',
       'no-duplicate-imports': ['error', { includeExports: false }],
+      'no-else-return': 'error',
       'no-implicit-coercion': 'error',
       'no-param-reassign': ['error', { props: false }],
       'no-restricted-exports': [
@@ -24,6 +29,14 @@ export const javascript = defineConfig([
           restrictedNamedExportsPattern: '^_',
         },
       ],
+      'no-restricted-globals': [
+        'error',
+        // `event`, `top` and `parent` are global browser properties.
+        // Reach for `window.event` / `window.top` / `window.parent` instead.
+        { message: 'Use `window.event` instead.', name: 'event' },
+        { message: 'Use `window.parent` instead.', name: 'parent' },
+        { message: 'Use `window.top` instead.', name: 'top' },
+      ],
       'no-restricted-imports': [
         'error',
         {
@@ -58,40 +71,21 @@ export const javascript = defineConfig([
           ],
         },
       ],
-      'no-restricted-syntax': [
-        'error',
-        {
-          message:
-            "Не используйте префикс 'handle' для обработчиков событий. Переименуйте метод, заменив 'handle' на 'on' (например, 'onClick' вместо 'handleClick').",
-          selector: 'Identifier[name=/^handle[A-Z]/]',
-        },
-        {
-          message:
-            "Используйте методы массивов (.forEach, .map и т.д.) вместо цикла 'for'.",
-          selector: 'ForStatement',
-        },
-        {
-          message:
-            "Используйте методы объектов (.keys, .values и т.д.) вместо цикла 'for...in'.",
-          selector: 'ForInStatement',
-        },
-        {
-          message:
-            "Используйте методы массивов(.forEach, .map и т.д.) вместо цикла 'for...of'.",
-          selector: 'ForOfStatement',
-        },
-      ],
+      'no-restricted-syntax': ['error', ...NO_RESTRICTED_SYNTAX],
+      'no-useless-rename': 'error',
       'prefer-arrow-callback': [
         'error',
         { allowNamedFunctions: false, allowUnboundThis: false },
       ],
       'prefer-const': 'warn',
       'prefer-template': 'warn',
-      'quotes': [
-        'error',
-        'single',
-        { allowTemplateLiterals: false, avoidEscape: true },
-      ],
+      'require-await': 'error',
     },
   },
+
+  {
+    // Tests are allowed to log and to alert
+    files: TEST_FILES,
+    rules: { 'no-alert': 'off', 'no-console': 'off' },
+  },
 ]);

package/plugins/jsdoc.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-jsdoc';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-jsdoc](https://github.com/gajus/eslint-plugin-jsdoc) */
 export const jsdoc = defineConfig([
@@ -11,20 +11,7 @@ export const jsdoc = defineConfig([
     rules: {
       'jsdoc/lines-before-block': 'off',
       'jsdoc/no-undefined-types': 'off',
-      'jsdoc/require-jsdoc': [
-        'warn',
-        {
-          enableFixer: false,
-          require: {
-            ArrowFunctionExpression: false,
-            ClassDeclaration: false,
-            ClassExpression: false,
-            FunctionDeclaration: false,
-            FunctionExpression: false,
-            MethodDefinition: false,
-          },
-        },
-      ],
+      'jsdoc/require-jsdoc': 'off',
       'jsdoc/require-param-description': 'off',
       'jsdoc/require-param-type': 'off',
       'jsdoc/require-returns': 'off',

package/plugins/json.js

@@ -1,5 +1,8 @@
 import plugin from '@eslint/json';
 import { defineConfig } from 'eslint/config';
+import * as yamlParser from 'yaml-eslint-parser';
+
+import { YAML_FILES } from '../base.js';
 
 /** @see [ESLint/JSON](https://github.com/eslint/json) */
 export const json = defineConfig([
@@ -15,6 +18,7 @@ export const json = defineConfig([
     extends: ['json/recommended'],
     files: ['**/*.jsonc'],
     language: 'json/jsonc',
+    languageOptions: { allowTrailingCommas: true },
     plugins: { json: plugin },
   },
 
@@ -24,4 +28,6 @@ export const json = defineConfig([
     language: 'json/json5',
     plugins: { json: plugin },
   },
+
+  { files: YAML_FILES, languageOptions: { parser: yamlParser } },
 ]);

package/plugins/perfectionist.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-perfectionist';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-perfectionist](https://perfectionist.dev) */
 export const perfectionist = defineConfig([
@@ -13,7 +13,7 @@ export const perfectionist = defineConfig([
         'warn',
         {
           customGroups: [
-            // hash
+            // hash (nuxt)
             { elementNamePattern: ['^#'], groupName: 'hash' },
 
             // @@/
@@ -81,8 +81,11 @@ export const perfectionist = defineConfig([
 
             'type-internal',
             'value-internal',
-            ['type-parent', 'type-sibling', 'type-index'],
-            ['value-parent', 'value-sibling', 'value-index'],
+            // `parent` and `index` groups are omitted on purpose:
+            // `no-restricted-imports` in `javascript.js` forbids `..`, `.`
+            // and `**/index` imports, so nothing can ever land in them.
+            'type-sibling',
+            'value-sibling',
             'ts-equals-import',
             'unknown',
           ],

package/plugins/pinia.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-pinia';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-pinia](https://github.com/lisilinhart/eslint-plugin-pinia) */
 export const pinia = defineConfig([

package/plugins/prettier.js

@@ -2,7 +2,8 @@ import config from 'eslint-config-prettier';
 import plugin from 'eslint-plugin-prettier/recommended';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES, VUE_FILES } from '../base.js';
+import { STYLE_RULES } from '../rules/style.js';
 
 const fixes = {
   // fix  for prettier
@@ -18,36 +19,12 @@ const fixes = {
 
 /** @see [eslint-plugin-prettier](https://github.com/prettier/eslint-plugin-prettier) */
 export const prettier = defineConfig([
-  {
-    files: FILES,
-    ...plugin,
-    rules: {
-      ...plugin.rules,
-      curly: 'error',
-      quotes: [
-        'error',
-        'single',
-        { allowTemplateLiterals: false, avoidEscape: true },
-      ],
-    },
-  },
-  { files: ['**/*.vue'], rules: { ...fixes } },
+  { files: FILES, ...plugin, rules: { ...plugin.rules, ...STYLE_RULES } },
+  { files: VUE_FILES, rules: { ...fixes } },
 ]);
 
 /** @see [eslint-config-prettier](https://github.com/prettier/eslint-config-prettier) */
 export const prettierConfig = defineConfig([
-  {
-    files: FILES,
-    ...config,
-    rules: {
-      ...config.rules,
-      curly: 'error',
-      quotes: [
-        'error',
-        'single',
-        { allowTemplateLiterals: false, avoidEscape: true },
-      ],
-    },
-  },
-  { files: ['**/*.vue'], rules: { ...fixes } },
+  { files: FILES, ...config, rules: { ...config.rules, ...STYLE_RULES } },
+  { files: VUE_FILES, rules: { ...fixes } },
 ]);

package/plugins/regexp.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-regexp';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-regexp](https://github.com/ota-meshi/eslint-plugin-regexp) */
 export const regexp = defineConfig([

package/plugins/sonar.js

@@ -1,14 +1,18 @@
 import plugin from 'eslint-plugin-sonarjs';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-sonarjs](https://github.com/SonarSource/SonarJS/blob/master/packages/jsts/src/rules/README.md) */
 export const sonar = defineConfig([
-  { files: FILES, ...plugin.configs.recommended },
   {
     files: FILES,
-    plugins: { sonar: plugin },
-    rules: { 'sonarjs/no-commented-code': 'warn', 'sonarjs/todo-tag': 'off' },
+    ...plugin.configs.recommended,
+    rules: {
+      ...plugin.configs.recommended.rules,
+      'sonarjs/no-commented-code': 'warn',
+      'sonarjs/todo-tag': 'off',
+      'sonarjs/unused-import': 'off', // @typescript-eslint/no-unused-vars
+    },
   },
 ]);

package/plugins/stylistic.js

@@ -1,18 +1,13 @@
 import plugin from '@stylistic/eslint-plugin';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { DATA_FILES, FILES } from '../base.js';
 
 /** @see [@stylistic/eslint-plugin](https://eslint.style/) */
 export const stylistic = defineConfig([
   {
     ...plugin.configs.recommended,
-    ignores: [
-      ...(plugin.configs.recommended.ignores ?? []),
-      '**/*.json',
-      '**/*.jsonc',
-      '**/*.json5',
-    ],
+    ignores: [...(plugin.configs.recommended.ignores ?? []), ...DATA_FILES],
   },
   {
     files: FILES,

package/plugins/tailwindcss.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-tailwindcss';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /**
  * @example

package/plugins/tanstack-query.js

@@ -1,8 +1,14 @@
 import plugin from '@tanstack/eslint-plugin-query';
 import { defineConfig } from 'eslint/config';
 
+import { DATA_FILES } from '../base.js';
+
 /** @see [@tanstack/query](https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query) */
 export const tanstackQuery = defineConfig([
-  ...plugin.configs['flat/recommended'],
+  // The shipped config has no `files` key, so it would also cover data files.
+  ...plugin.configs['flat/recommended'].map((config) => ({
+    ...config,
+    ignores: [...(config.ignores ?? []), ...DATA_FILES],
+  })),
   { rules: { '@tanstack/query/infinite-query-property-order': 'off' } },
 ]);

package/plugins/typescript-type-checked.js

@@ -0,0 +1,50 @@
+import { defineConfig } from 'eslint/config';
+import plugin from 'typescript-eslint';
+
+import { DATA_FILES, FILES, TEST_FILES, TS_FILES } from '../base.js';
+import { TS_RULES } from '../rules/typescript.js';
+
+/**
+ * Type-aware TypeScript config.
+ *
+ * Opt-in: requires a `tsconfig.json` in the project and needs type information,
+ * which makes linting slower. Use it instead of `typescript`, not alongside
+ * it.
+ *
+ * @see [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint)
+ */
+export const typescriptTypeChecked = defineConfig([
+  // The parser is needed for every JS/TS/Vue file, not only for TypeScript ones,
+  // otherwise `.js` files fall back to the default parser and modern syntax
+  // (`import.meta`, top-level await) breaks.
+  { ...plugin.configs.base, files: FILES },
+
+  // Non type-aware rules — the same scope as the regular `typescript` plugin,
+  // so `.js`/`.vue` files keep the TypeScript versions of the rules.
+  // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
+  // so they would also land on data files that are not JavaScript at all.
+  ...[...plugin.configs.strict, ...plugin.configs.stylistic].map((config) => ({
+    ...config,
+    ignores: [...(config.ignores ?? []), ...DATA_FILES],
+  })),
+
+  // Type-aware rules only make sense where the type information is available.
+  ...plugin.configs.strictTypeChecked.map((config) => ({
+    ...config,
+    files: TS_FILES,
+  })),
+  ...plugin.configs.stylisticTypeChecked.map((config) => ({
+    ...config,
+    files: TS_FILES,
+  })),
+
+  {
+    files: TS_FILES,
+    languageOptions: { parserOptions: { projectService: true } },
+    rules: TS_RULES,
+  },
+  {
+    files: TEST_FILES,
+    rules: { '@typescript-eslint/no-empty-function': 'off' },
+  },
+]);

package/plugins/typescript.js

@@ -1,48 +1,21 @@
-/* eslint-disable unicorn/no-null */
 import { defineConfig } from 'eslint/config';
 import plugin from 'typescript-eslint';
 
-import { FILES } from '../presets/base.js';
+import { DATA_FILES, FILES, TEST_FILES } from '../base.js';
+import { TS_RULES } from '../rules/typescript.js';
 
 /** @see [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint) */
 export const typescript = defineConfig([
-  ...plugin.configs.strict,
-  ...plugin.configs.stylistic,
+  // `plugin.configs.strict`/`stylistic` contain blocks without a `files` key,
+  // so they would also land on data files that are not JavaScript at all.
+  ...[...plugin.configs.strict, ...plugin.configs.stylistic].map((config) => ({
+    ...config,
+    ignores: [...(config.ignores ?? []), ...DATA_FILES],
+  })),
 
+  { files: FILES, rules: TS_RULES },
   {
-    files: FILES,
-    rules: {
-      '@typescript-eslint/naming-convention': [
-        'error',
-        {
-          format: ['strictCamelCase'],
-          leadingUnderscore: 'allow',
-          selector: 'function',
-        },
-        {
-          format: ['strictCamelCase'],
-          leadingUnderscore: 'require',
-          modifiers: ['private'],
-          selector: 'memberLike',
-        },
-        {
-          format: ['strictCamelCase'],
-          leadingUnderscore: 'allow',
-          selector: 'parameter',
-        },
-        { format: ['StrictPascalCase'], selector: 'typeLike' },
-        {
-          format: ['strictCamelCase', 'PascalCase', 'UPPER_CASE'],
-          leadingUnderscore: 'allow',
-          selector: 'variable',
-        },
-        { format: null, modifiers: ['destructured'], selector: 'variable' },
-      ],
-      '@typescript-eslint/no-explicit-any': 'warn',
-    },
-  },
-  {
-    files: ['**/*.{fixtures,test,spec}.{js,ts}'],
+    files: TEST_FILES,
     rules: { '@typescript-eslint/no-empty-function': 'off' },
   },
 ]);

package/plugins/unicorn.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-unicorn';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { DTS_FILES, FILES, VUE_FILES } from '../base.js';
 
 /** @see [eslint-plugin-unicorn](https://github.com/sindresorhus/eslint-plugin-unicorn) */
 export const unicorn = defineConfig([
@@ -18,6 +18,10 @@ export const unicorn = defineConfig([
         'error',
         { default: 'arrow-function' },
       ],
+      // Explicit: the default happens to be kebab case, but the intent is
+      // worth pinning down. Applies to `.vue` components too, which is why
+      // `vue/match-component-file-name` is kept in sync with it in `vue.js`.
+      'unicorn/filename-case': ['error', { case: 'kebabCase' }],
       'unicorn/iteration-fallback-style': ['error', 'guard'],
       'unicorn/name-replacements': 'off',
       'unicorn/no-array-reduce': ['error', { allowSimpleOperations: true }],
@@ -42,8 +46,15 @@ export const unicorn = defineConfig([
       'unicorn/single-line-block-comment-style': 'off',
     },
   },
-  { files: ['.*'], rules: { 'unicorn/no-null': 'off' } },
-  { files: ['*.d.ts'], rules: { 'unicorn/prefer-export-from': 'off' } },
+  { files: ['**/.*'], rules: { 'unicorn/no-null': 'off' } },
+  { files: DTS_FILES, rules: { 'unicorn/prefer-export-from': 'off' } },
+  {
+    // `null` is part of the type contract in Vue.js SFC:
+    // `ref<Type | null>(null)` is the idiomatic way to declare an initially
+    // empty reactive value. Everywhere else `null` remains an error.
+    files: VUE_FILES,
+    rules: { 'unicorn/no-null': 'off' },
+  },
   {
     files: ['**/*.{api,endpoints,fixtures,schemas,service,spec,test}.{js,ts}'],
     rules: {
@@ -56,6 +67,6 @@ export const unicorn = defineConfig([
   },
   {
     files: ['**/temp/**/*.vue'],
-    rules: { 'unicorn/prevent-abbreviations': 'off' },
+    rules: { 'unicorn/name-replacements': 'off' },
   },
 ]);

package/plugins/unocss.js

@@ -1,7 +1,7 @@
 import plugin from '@unocss/eslint-config/flat';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [@unocss/eslint-config](https://unocss.dev/integrations/eslint) */
 export const unocss = defineConfig([

package/plugins/vitest.js

@@ -1,10 +1,12 @@
 import plugin from '@vitest/eslint-plugin';
 import { defineConfig } from 'eslint/config';
 
+import { TEST_FILES } from '../base.js';
+
 /** @see [eslint-plugin-vitest](https://github.com/veritem/eslint-plugin-vitest) */
 export const vitest = defineConfig([
   {
-    files: ['*.{test,spec}.{js,cjs,mjs,ts}'],
+    files: TEST_FILES,
     plugins: { vitest: plugin },
     rules: {
       ...plugin.configs.recommended.rules,

package/plugins/vue-i18n.js

@@ -1,16 +1,13 @@
 import plugin from '@intlify/eslint-plugin-vue-i18n';
 import { defineConfig } from 'eslint/config';
 
+import { DATA_FILES } from '../base.js';
+
 /** @see [eslint-plugin-vue-i18n](https://eslint-plugin-vue-i18n.intlify.dev/) */
 export const vueI18n = defineConfig([
   ...plugin.configs['flat/recommended'].map((config) => ({
     ...config,
-    ignores: [
-      ...(config.ignores ?? []),
-      '**/*.json',
-      '**/*.jsonc',
-      '**/*.json5',
-    ],
+    ignores: [...(config.ignores ?? []), ...DATA_FILES],
   })),
 
   {

package/plugins/vue.js

@@ -2,20 +2,18 @@ import plugin from 'eslint-plugin-vue';
 import { defineConfig } from 'eslint/config';
 import typescript from 'typescript-eslint';
 
+import { DATA_FILES, TEST_FILES, VUE_FILES } from '../base.js';
+import { NO_RESTRICTED_SYNTAX } from '../rules/restricted-syntax.js';
+
 /** @see [eslint-plugin-vue](https://eslint.vuejs.org/rules/) */
 export const vue = defineConfig([
   ...plugin.configs['flat/recommended'].map((config) => ({
     ...config,
-    ignores: [
-      ...(config.ignores ?? []),
-      '**/*.json',
-      '**/*.jsonc',
-      '**/*.json5',
-    ],
+    ignores: [...(config.ignores ?? []), ...DATA_FILES],
   })),
 
   {
-    files: ['**/*.vue'],
+    files: VUE_FILES,
     languageOptions: { parserOptions: { parser: typescript.parser } },
     rules: {
       '@typescript-eslint/no-empty-object-type': [
@@ -24,6 +22,8 @@ export const vue = defineConfig([
       ],
       'no-restricted-syntax': [
         'error',
+        // Merge the shared list, do not replace it
+        ...NO_RESTRICTED_SYNTAX,
         {
           message:
             'Запрещено использовать имя "Props". Используйте именованный формат, например: <ИмяКомпонента>Props.',
@@ -109,7 +109,14 @@ export const vue = defineConfig([
           svg: 'always',
         },
       ],
-      'vue/match-component-file-name': ['error'],
+      // Keep in sync with `unicorn/filename-case` in `unicorn.js`:
+      // components live in kebab-case files, so the component name is
+      // derived from a kebab-case file name instead of being required to be
+      // PascalCase in the file name itself.
+      'vue/match-component-file-name': [
+        'error',
+        { extensions: ['vue'], shouldMatchCase: false },
+      ],
       'vue/match-component-import-name': ['error'],
       'vue/max-attributes-per-line': ['error', { singleline: 3 }],
       'vue/max-lines-per-block': [
@@ -244,8 +251,5 @@ export const vue = defineConfig([
     rules: { 'vue/multi-word-component-names': 'off' },
   },
 
-  {
-    files: ['**/*.{test,spec}.{js,ts}'],
-    rules: { 'vue/one-component-per-file': 'off' },
-  },
+  { files: TEST_FILES, rules: { 'vue/one-component-per-file': 'off' } },
 ]);

package/plugins/zod.js

@@ -1,7 +1,7 @@
 import plugin from 'eslint-plugin-zod';
 import { defineConfig } from 'eslint/config';
 
-import { FILES } from '../presets/base.js';
+import { FILES } from '../base.js';
 
 /** @see [eslint-plugin-zod](https://github.com/marcalexiei/eslint-zod/tree/main/plugins/eslint-plugin-zod) */
 export const zod = defineConfig([

package/rules/restricted-syntax.js

@@ -0,0 +1,28 @@
+/**
+ * Shared restricted syntax rules.
+ *
+ * Keep it in a standalone module so that plugins which extend the list (e.g.
+ * `vue.js`) merge it instead of silently replacing it.
+ */
+export const NO_RESTRICTED_SYNTAX = [
+  {
+    message:
+      "Не используйте префикс 'handle' для обработчиков событий. Переименуйте метод, заменив 'handle' на 'on' (например, 'onClick' вместо 'handleClick').",
+    selector: 'Identifier[name=/^handle[A-Z]/]',
+  },
+  {
+    message:
+      "Используйте методы массивов (.forEach, .map и т.д.) вместо цикла 'for'.",
+    selector: 'ForStatement',
+  },
+  {
+    message:
+      "Используйте методы объектов (.keys, .values и т.д.) вместо цикла 'for...in'.",
+    selector: 'ForInStatement',
+  },
+  {
+    message:
+      "Используйте методы массивов(.forEach, .map и т.д.) вместо цикла 'for...of'.",
+    selector: 'ForOfStatement',
+  },
+];

package/rules/style.js

@@ -0,0 +1,15 @@
+/**
+ * Formatting rules that survive `eslint-config-prettier`.
+ *
+ * `eslint-config-prettier` turns off every core formatting rule, so these two
+ * are declared in a single place and re-applied by `prettier.js` to both
+ * `prettier` and `prettierConfig`. Keep them in sync with `prettier.js`.
+ */
+export const STYLE_RULES = {
+  curly: 'error',
+  quotes: [
+    'error',
+    'single',
+    { allowTemplateLiterals: false, avoidEscape: true },
+  ],
+};

package/rules/typescript.js

@@ -0,0 +1,62 @@
+/* eslint-disable unicorn/no-null */
+
+/**
+ * Shared TypeScript rules.
+ *
+ * `format: null` disables the format check for destructured variables — their
+ * names may be arbitrary.
+ */
+export const TS_RULES = {
+  '@typescript-eslint/consistent-type-imports': [
+    'error',
+    { fixStyle: 'separate-type-imports', prefer: 'type-imports' },
+  ],
+  '@typescript-eslint/naming-convention': [
+    'error',
+    {
+      format: ['strictCamelCase'],
+      leadingUnderscore: 'allow',
+      selector: 'function',
+    },
+    {
+      format: ['strictCamelCase'],
+      leadingUnderscore: 'require',
+      modifiers: ['private'],
+      selector: 'memberLike',
+    },
+    {
+      format: ['strictCamelCase'],
+      leadingUnderscore: 'allow',
+      selector: 'parameter',
+    },
+    { format: ['StrictPascalCase'], selector: 'typeLike' },
+    {
+      format: ['strictCamelCase', 'PascalCase', 'UPPER_CASE'],
+      leadingUnderscore: 'allow',
+      selector: 'variable',
+    },
+    { format: null, modifiers: ['destructured'], selector: 'variable' },
+    {
+      format: ['strictCamelCase', 'PascalCase', 'UPPER_CASE'],
+      selector: 'enumMember',
+    },
+    {
+      format: ['strictCamelCase', 'UPPER_CASE'],
+      leadingUnderscore: 'allow',
+      selector: 'classProperty',
+    },
+    {
+      format: ['strictCamelCase', 'PascalCase', 'UPPER_CASE', 'snake_case'],
+      leadingUnderscore: 'allow',
+      selector: 'typeProperty',
+    },
+    {
+      format: ['strictCamelCase', 'PascalCase', 'UPPER_CASE'],
+      leadingUnderscore: 'allow',
+      selector: 'import',
+    },
+  ],
+  '@typescript-eslint/no-explicit-any': 'warn',
+  '@typescript-eslint/no-import-type-side-effects': 'error',
+};
+/* eslint-enable unicorn/no-null */

package/presets/base.js

@@ -1,22 +0,0 @@
-import { defineConfig } from 'eslint/config';
-import globals from 'globals';
-
-export const FILES = ['**/*.{js,mjs,cjs,jsx,ts,tsx,vue}'];
-
-/** Base config */
-export const base = defineConfig([
-  { files: FILES, languageOptions: { globals: globals.browser } },
-  {
-    ignores: [
-      '**/.*/',
-      '**/_deprecated/',
-      '**/mockServiceWorker.js',
-      '.*/',
-      'build',
-      'dist',
-      'docs',
-      'storybook-*',
-      'sw.js',
-    ],
-  },
-]);

package/presets/default.js

@@ -1,37 +0,0 @@
-import { defineConfig } from 'eslint/config';
-
-import { deMorgan } from '../plugins/de-morgan.js';
-import { javascript } from '../plugins/javascript.js';
-import { jsdoc } from '../plugins/jsdoc.js';
-import { json } from '../plugins/json.js';
-import { perfectionist } from '../plugins/perfectionist.js';
-import { prettierConfig } from '../plugins/prettier.js';
-import { regexp } from '../plugins/regexp.js';
-import { sonar } from '../plugins/sonar.js';
-import { stylistic } from '../plugins/stylistic.js';
-import { typescript } from '../plugins/typescript.js';
-import { unicorn } from '../plugins/unicorn.js';
-import { vueAccessibility } from '../plugins/vue-accessibility.js';
-import { vueI18n } from '../plugins/vue-i18n.js';
-import { vue } from '../plugins/vue.js';
-import { base } from './base.js';
-
-export const defaultPreset = defineConfig([
-  ...base, // must be first
-
-  ...javascript,
-  ...deMorgan,
-  ...jsdoc,
-  ...json,
-  ...perfectionist,
-  ...regexp,
-  ...sonar,
-  ...stylistic,
-  ...typescript,
-  ...unicorn,
-  ...vue,
-  ...vueAccessibility,
-  ...vueI18n,
-
-  ...prettierConfig, // must be last
-]);