@alexlit/lint-kit 214.4.0 → 216.0.0

package/README.md

@@ -1,32 +1,37 @@
-# Lint Kit
+[![version](https://npmx.dev/api/registry/badge/version/@alexlit/lint-kit)](https://www.npmjs.com/package/@alexlit/lint-kit)
+[![downloads](https://npmx.dev/api/registry/badge/downloads/@alexlit/lint-kit)](https://npmx.dev/package/@alexlit/lint-kit)
+[![license](https://npmx.dev/api/registry/badge/license/@alexlit/lint-kit)](LICENSE)
 
-Presets of configuration files and dependencies for linting web applications
-(designed for [Vue.js](https://vuejs.org) with
-[TypeScript](https://www.typescriptlang.org/))
+# Lint Kit
 
-## Usage
+Набор пакетов с конфигурациями для линтинга и форматирования кода Vue +
+TypeScript проектов.
 
-### Instal all linters
+## Пакеты
 
-```sh
-npm i @alexlit/config-commitlint @alexlit/config-eslint @alexlit/config-hooks @alexlit/config-htmllint @alexlit/config-markdownlint @alexlit/config-npmlint @alexlit/config-prettier @alexlit/config-stylelint --legacy-peer-deps -D
-```
+| Пакет                                                  | Назначение                         |
+| :----------------------------------------------------- | :--------------------------------- |
+| [eslint](packages/config-eslint/README.md)             | Линтинг JavaScript и TypeScript    |
+| [hooks](packages/config-hooks/README.md)               | Git-хуки (commitlint, lint-staged) |
+| [htmllint](packages/config-htmllint/README.md)         | Линтинг HTML                       |
+| [markdownlint](packages/config-markdownlint/README.md) | Линтинг Markdown                   |
+| [npmlint](packages/config-npmlint/README.md)           | Линтинг `package.json`             |
+| [prettier](packages/config-prettier/README.md)         | Форматирование кода                |
+| [stylelint](packages/config-stylelint/README.md)       | Линтинг CSS                        |
 
-### Configuration
+## Установка
 
-- [commitlint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-commitlint/README.md)
-- [eslint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-eslint/README.md)
-- [hooks](https://github.com/alex-lit/lint-kit/blob/master/packages/config-hooks/README.md)
-- [htmllint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-htmllint/README.md)
-- [markdownlint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-markdownlint/README.md)
-- [npmlint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-npmlint/README.md)
-- [prettier](https://github.com/alex-lit/lint-kit/blob/master/packages/config-prettier/README.md)
-- [stylelint](https://github.com/alex-lit/lint-kit/blob/master/packages/config-stylelint/README.md)
+Рекомендуется устанавливать необходимые пакеты по отдельности - так вы
+подключаете только те линтеры, которые необходимы и сможете управлять их
+версиями.
 
-## Dev mode
+Инструкции по настройке каждого пакета приведены в его README (см. ссылки в
+разделе [«Пакеты»](#пакеты)).
 
-### Installation
+```bash
+# установка необходимого пакета
+npm install --save-dev @alexlit/config-<PACKAGE_NAME>
 
-```sh
-npm run i
+# или все сразу одной командой
+npm install --save-dev @alexlit/lint-kit
 ```

package/eslint.config.js

@@ -1,65 +1,36 @@
-import {
-  base,
-  deMorgan,
-  importX,
-  javascript,
-  jsdoc,
-  json,
-  perfectionist,
-  prettierConfig,
-  regexp,
-  sonar,
-  stylistic,
-  tailwindcss,
-  tanstackQuery,
-  typescriptTypeChecked,
-  unicorn,
-  vitest,
-  vue,
-  vueAccessibility,
-  vueI18n,
-  zod,
-} from '@alexlit/config-eslint';
+import { defineConfig, plugins } from '@alexlit/config-eslint';
 import path from 'node:path';
 
-export default [
-  ...base, // must be first
-
-  ...javascript,
-  ...deMorgan,
-  ...importX,
-  ...jsdoc,
-  ...json,
-  ...perfectionist,
-  ...regexp,
-  ...sonar,
-  ...stylistic,
-  ...typescriptTypeChecked,
-  ...unicorn,
-  ...vue,
-  ...vueAccessibility,
-  ...vueI18n,
-
-  ...tanstackQuery,
-  ...vitest,
-  ...zod,
-
-  ...tailwindcss({
-    cssConfigPath: path.resolve(
-      import.meta.dirname,
-      'examples/css.tailwind.css',
-    ),
+export default defineConfig([
+  ...plugins.javascript(),
+  ...plugins.deMorgan(),
+  ...plugins.importX(),
+  ...plugins.jsdoc(),
+  ...plugins.json(),
+  ...plugins.perfectionist(),
+  ...plugins.regexp(),
+  ...plugins.sonar(),
+  ...plugins.stylistic(),
+  ...plugins.typescriptTypeChecked(),
+  ...plugins.unicorn(),
+  ...plugins.vue(),
+  ...plugins.vueAccessibility(),
+  ...plugins.vueI18n(),
+  ...plugins.tanstackQuery(),
+  ...plugins.vitest(),
+  ...plugins.zod(),
+  ...plugins.tailwindcss({
+    settings: {
+      tailwindcss: {
+        cssConfigPath: path.resolve(
+          import.meta.dirname,
+          'examples/css.tailwind.css',
+        ),
+      },
+    },
   }),
 
-  ...prettierConfig, // must be last
-
-  { ignores: ['**/packages/config-eslint/_legacy/**'] },
+  { files: ['**/*.js'], rules: { 'no-restricted-imports': 'off' } },
 
-  {
-    files: ['**/*.js'],
-    rules: {
-      'no-restricted-imports': 'off',
-      'unicorn/comment-content': ['warn'],
-    },
-  },
-];
+  ...plugins.prettierConfig(),
+]);

package/lint-staged.config.js

@@ -1,3 +1,3 @@
-import { createLintStagedConfig } from '@alexlit/config-hooks';
+import { defineConfig } from '@alexlit/config-hooks';
 
-export default createLintStagedConfig();
+export default defineConfig();

package/linthtml.config.js

@@ -1,3 +1,3 @@
-import { createConfig } from '@alexlit/config-htmllint';
+import { defineConfig } from '@alexlit/config-htmllint';
 
-export default createConfig();
+export default defineConfig();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/lint-kit",
-  "version": "214.4.0",
+  "version": "216.0.0",
   "private": false,
   "description": "Preset of configuration files and dependencies for linting web applications (designed for Vue.js with TypeScript)",
   "keywords": [
@@ -73,6 +73,7 @@
     "commit-msg": "npx commitlint --edit"
   },
   "devDependencies": {
-    "changelogen": "^0.6.2"
+    "changelogen": "^0.6.2",
+    "radash": "^12.1.1"
   }
 }

package/packages/config-eslint/README.md

@@ -1,135 +1,210 @@
 # ESLint Configuration
 
-> [!WARNING]  
-> For **eslint version < 9** use
-> [@alexlit/config-eslint@90](https://www.npmjs.com/package/@alexlit/config-eslint?activeTab=versions)
-> or lower.
+[![version](https://npmx.dev/api/registry/badge/version/@alexlit/config-eslint)](https://www.npmjs.com/package/@alexlit/config-eslint)
+[![downloads](https://npmx.dev/api/registry/badge/downloads/@alexlit/config-eslint)](https://npmx.dev/package/@alexlit/config-eslint)
+[![license](https://npmx.dev/api/registry/badge/license/@alexlit/config-eslint)](LICENSE)
 
-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.
+Готовая конфигурация [ESLint](https://eslint.org/) в формате flat config:
+настроенные правила для JavaScript, TypeScript, Vue.js, JSON, YAML, импортов,
+Prettier и не только - всё, что обычно приходится настраивать вручную. Вместо
+того чтобы подключать и настраивать каждый плагин по отдельности, соберите
+конфигурацию из готовых модулей.
 
-## Installation
+Плагины модульные: по умолчанию ничего не включено - вы сами перечисляете нужные
+в `defineConfig`.
 
-```sh
+## Установка
+
+```bash
 npm i @alexlit/config-eslint -D
 ```
 
-## Connection
+## Быстрый старт
+
+```js
+// eslint.config.js
+import { defineConfig, plugins } from '@alexlit/config-eslint';
+
+export default defineConfig([
+  ...plugins.javascript(),
+  ...plugins.typescript(),
+  ...plugins.unicorn(),
+  ...plugins.prettierConfig(),
+]);
+```
+
+Каждый плагин возвращает массив блоков конфигурации, поэтому его нужно
+развернуть оператором spread (`...`). Добавьте только то, что нужно проекту;
+полный список - в разделе [Плагины](#плагины).
+
+> [!NOTE]
+>
+> `plugins.prettierConfig()` должен быть последним - он отключает правила,
+> конфликтующие с Prettier.
+
+Больше плагинов - просто допишите их в массив. Пример:
+
+```js
+// eslint.config.js
+import { defineConfig, plugins } from '@alexlit/config-eslint';
+
+export default defineConfig([
+  // базовые
+  ...plugins.deMorgan(),
+  ...plugins.importX(),
+  ...plugins.javascript(),
+  ...plugins.jsdoc(),
+  ...plugins.json(),
+  ...plugins.perfectionist(),
+  ...plugins.regexp(),
+  ...plugins.sonar(),
+  ...plugins.stylistic(),
+  ...plugins.typescript(),
+  ...plugins.unicorn(),
+
+  // проектные
+  ...plugins.pinia(),
+  ...plugins.tanstackQuery(),
+  ...plugins.unocss(),
+  ...plugins.vitest(),
+  ...plugins.vue(),
+  ...plugins.vueAccessibility(),
+  ...plugins.vueI18n(),
+  ...plugins.zod(),
+
+  // дополнительные правила
+  { ignores: ['fixtures/**'], rules: { 'no-console': 'off' } },
+
+  // стилистика
+  ...plugins.prettierConfig(),
+]);
+```
 
-Always start with `base` (it must be first) and finish with `prettierConfig` (it
-must be last, it disables the formatting rules).
+## Плагины
+
+| Плагин                            | Что делает                                    | Пакет                                                                                                           |
+| --------------------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `plugins.deMorgan()`              | Упрощает логические выражения                 | [`eslint-plugin-de-morgan`](https://github.com/azat-io/eslint-plugin-de-morgan)                                 |
+| `plugins.importX()`               | Проверяет импорты и модули                    | [`eslint-plugin-import-x`](https://github.com/un-ts/eslint-plugin-import-x)                                     |
+| `plugins.javascript()`            | Базовые правила JavaScript                    | [`@eslint/js`](https://eslint.org/)                                                                             |
+| `plugins.jsdoc()`                 | Проверяет JSDoc-комментарии                   | [`eslint-plugin-jsdoc`](https://github.com/gajus/eslint-plugin-jsdoc)                                           |
+| `plugins.json()`                  | Проверяет JSON, JSONC, JSON5 и YAML           | [`@eslint/json`](https://github.com/eslint/json)                                                                |
+| `plugins.perfectionist()`         | Сортирует импорты, объекты, интерфейсы и типы | [`eslint-plugin-perfectionist`](https://perfectionist.dev)                                                      |
+| `plugins.pinia()`                 | Проверяет Pinia-хранилища                     | [`eslint-plugin-pinia`](https://github.com/lisilinhart/eslint-plugin-pinia)                                     |
+| `plugins.prettier()`              | Форматирует код самим Prettier                | [`eslint-plugin-prettier`](https://github.com/prettier/eslint-plugin-prettier)                                  |
+| `plugins.prettierConfig()`        | Отключает правила, конфликтующие с Prettier   | [`eslint-config-prettier`](https://github.com/prettier/eslint-config-prettier)                                  |
+| `plugins.regexp()`                | Проверяет регулярные выражения                | [`eslint-plugin-regexp`](https://github.com/ota-meshi/eslint-plugin-regexp)                                     |
+| `plugins.sonar()`                 | Проверяет код по правилам SonarJS             | [`eslint-plugin-sonarjs`](https://github.com/SonarSource/SonarJS/blob/master/packages/jsts/src/rules/README.md) |
+| `plugins.stylistic()`             | Проверяет форматирование и стиль кода         | [`@stylistic/eslint-plugin`](https://eslint.style/)                                                             |
+| `plugins.tailwindcss()`           | Проверяет классы Tailwind CSS                 | [`eslint-plugin-tailwindcss`](https://github.com/francoismassart/eslint-plugin-tailwindcss)                     |
+| `plugins.tanstackQuery()`         | Проверяет TanStack Query                      | [`@tanstack/eslint-plugin-query`](https://tanstack.com/query/latest/docs/eslint/eslint-plugin-query)            |
+| `plugins.typescript()`            | Проверяет TypeScript без анализа типов        | [`typescript-eslint`](https://github.com/typescript-eslint/typescript-eslint)                                   |
+| `plugins.typescriptTypeChecked()` | Проверяет TypeScript с анализом типов         | [`typescript-eslint`](https://github.com/typescript-eslint/typescript-eslint)                                   |
+| `plugins.unicorn()`               | Проверяет код по правилам unicorn             | [`eslint-plugin-unicorn`](https://github.com/sindresorhus/eslint-plugin-unicorn)                                |
+| `plugins.unocss()`                | Проверяет UnoCSS                              | [`@unocss/eslint-config`](https://unocss.dev/integrations/eslint)                                               |
+| `plugins.vitest()`                | Проверяет тесты Vitest                        | [`@vitest/eslint-plugin`](https://github.com/veritem/eslint-plugin-vitest)                                      |
+| `plugins.vue()`                   | Проверяет Vue.js-компоненты                   | [`eslint-plugin-vue`](https://eslint.vuejs.org/rules/)                                                          |
+| `plugins.vueAccessibility()`      | Проверяет доступность Vue.js-компонентов      | [`eslint-plugin-vuejs-accessibility`](https://vue-a11y.github.io/eslint-plugin-vuejs-accessibility/)            |
+| `plugins.vueI18n()`               | Проверяет Vue.js I18n                         | [`@intlify/eslint-plugin-vue-i18n`](https://vue-i18n.intlify.dev/)                                              |
+| `plugins.zod()`                   | Проверяет Zod-схемы                           | [`eslint-plugin-zod`](https://github.com/marcalexiei/eslint-zod/tree/main/plugins/eslint-plugin-zod)            |
+
+## Свой конфиг
+
+Любая фабрика принимает необязательный flat-конфиг, который добавляется после
+предустановленного. Это позволяет точечно переопределять правила, `settings`,
+`files` и другие опции, не отказываясь от пресета:
 
 ```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
-
-  // Custom rules example
-  // { files: ['**/*.js'], rules: { 'no-console': 'off' } },
-];
+import { defineConfig, plugins } from '@alexlit/config-eslint';
+
+export default defineConfig([
+  ...plugins.javascript(),
+  ...plugins.unicorn({ rules: { 'unicorn/no-null': 'off' } }),
+  ...plugins.vue([
+    { files: ['**/*.vue'], rules: { 'vue/max-lines-per-block': 'off' } },
+  ]),
+]);
 ```
 
-Drop what you do not need.
+Можно передать как один объект, так и массив блоков. Так как конфиг добавляется
+последним, он имеет более высокий приоритет, чем настройки пресета.
 
-## Type-aware rules (optional)
+## Настройки Tailwind CSS
 
-Type-aware rules (`no-floating-promises`, `no-misused-promises`,
+По умолчанию `plugins.tailwindcss()` использует путь `./styles/tailwind.css`.
+Чтобы указать другой CSS-файл с конфигурацией Tailwind CSS, передайте обычный
+flat-конфиг с настройками плагина:
+
+```js
+// eslint.config.js
+import path from 'node:path';
+
+import { defineConfig, plugins } from '@alexlit/config-eslint';
+
+export default defineConfig([
+  ...plugins.tailwindcss({
+    settings: {
+      tailwindcss: {
+        cssConfigPath: path.resolve(import.meta.dirname, 'src/main.css'),
+      },
+    },
+  }),
+]);
+```
+
+## Type-aware правила
+
+Type-aware правила (`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.
+`no-unnecessary-condition`, …) требуют информации о типах, из-за чего линтинг
+замедляется. По умолчанию они не включены.
 
-To enable them, replace `typescript` with `typescriptTypeChecked`:
+Чтобы их включить, замените `plugins.typescript()` на
+`plugins.typescriptTypeChecked()`:
 
 ```js
-import {
-  base,
-  typescriptTypeChecked,
-  prettierConfig,
-} from '@alexlit/config-eslint';
-
-export default [
-  ...base,
-  // ...other plugins
-  ...typescriptTypeChecked, // instead of ...typescript
-  ...prettierConfig,
-];
+// eslint.config.js
+import { defineConfig, plugins } from '@alexlit/config-eslint';
+
+export default defineConfig([
+  ...plugins.javascript(),
+  ...plugins.typescriptTypeChecked(), // вместо plugins.typescript()
+  ...plugins.prettierConfig(),
+]);
 ```
 
-> [!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.
+> [!NOTE]
+>
+> `plugins.typescriptTypeChecked()` требует `tsconfig.json` в корне проекта
+> (используется `projectService`, поэтому держите `tsconfig.json` и
+> `tsconfig.node.json` в одном корне, если нужно). Используйте его вместо
+> `plugins.typescript()`, а не вместе с ним.
+
+## Prettier или prettierConfig
 
-## Formatting: `prettier` vs `prettierConfig`
+Оба варианта доступны, и они **не взаимозаменяемы**.
 
-Both are included, and they are **not** interchangeable.
+| Плагин                     | Пакет                    | Что делает                                                       |
+| -------------------------- | ------------------------ | ---------------------------------------------------------------- |
+| `plugins.prettierConfig()` | `eslint-config-prettier` | Только отключает форматирующие правила, конфликтующие с Prettier |
+| `plugins.prettier()`       | `eslint-plugin-prettier` | Дополнительно запускает сам Prettier как правило ESLint          |
 
-| 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 |
+Используйте `plugins.prettierConfig()`, если Prettier запускается отдельным
+шагом (редактор, CLI `prettier`, Husky). Используйте `plugins.prettier()`, если
+хотите, чтобы ESLint сам сообщал о форматировании и исправлял его за один
+проход - это медленнее и дублирует форматтер.
 
-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.
+## Разработка
+
+Просмотр итоговой конфигурации:
+
+```bash
+npm run inspect
+```
 
-## Usefull links
+## Полезные ссылки
 
 - [Awesome ESLint](https://github.com/dustinspecker/awesome-eslint)
+- [ESLint - Documentation](https://eslint.org/docs/latest/)
+- [ESLint - Configure Flat Config](https://eslint.org/docs/latest/use/configure/configuration-files)

package/packages/config-eslint/base.js

@@ -37,6 +37,7 @@ export const IGNORES = [
   '**/.*',
   '**/.*/**',
   '**/_deprecated/**',
+  '**/_legacy/**',
   '**/build/**',
   '**/dist/**',
   '**/docs/**',
@@ -49,12 +50,16 @@ export const IGNORES = [
  * Base config.
  *
  * Provides the file scope, the shared ignore patterns and the global variables.
- * Include it first, then the plugins you actually need.
+ * It is added automatically by `defineConfig`, so you never spread it
+ * yourself.
  *
  * @example
- *   import { base, javascript, unicorn } from '@alexlit/config-eslint';
+ *   import { defineConfig, plugins } from '@alexlit/config-eslint';
  *
- *   export default [...base, ...javascript, ...unicorn];
+ *   export default defineConfig([
+ *     ...plugins.javascript(),
+ *     ...plugins.unicorn(),
+ *   ]);
  */
 export const base = defineConfig([
   { files: FILES, languageOptions: { globals: globals.browser } },

package/packages/config-eslint/index.d.ts

@@ -0,0 +1,114 @@
+import type { Linter } from 'eslint';
+
+/** Flat-конфиг ESLint. */
+export type Config = Linter.Config;
+
+/**
+ * Дополнительный flat-конфиг, который добавляется после предустановленного.
+ * Можно передать как один блок, так и массив блоков.
+ */
+export type PluginConfig = Config | Config[];
+
+/**
+ * Фабрики плагинов. Каждый вызов возвращает массив flat-конфигов, который нужно
+ * развернуть через spread-оператор: `...plugins.<name>()`.
+ *
+ * Любая фабрика принимает необязательный конфиг, который добавляется после
+ * предустановленных блоков и переопределяет их.
+ */
+export interface Plugins {
+  /** @see eslint-plugin-de-morgan */
+  deMorgan(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-import-x */
+  importX(config?: PluginConfig): Config[];
+  /** @see eslint */
+  javascript(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-jsdoc */
+  jsdoc(config?: PluginConfig): Config[];
+  /** @see ESLint/JSON */
+  json(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-perfectionist */
+  perfectionist(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-pinia */
+  pinia(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-prettier */
+  prettier(config?: PluginConfig): Config[];
+  /** @see eslint-config-prettier */
+  prettierConfig(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-regexp */
+  regexp(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-sonarjs */
+  sonar(config?: PluginConfig): Config[];
+  /** @see @stylistic/eslint-plugin */
+  stylistic(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-tailwindcss */
+  tailwindcss(config?: PluginConfig): Config[];
+  /** @see @tanstack/query */
+  tanstackQuery(config?: PluginConfig): Config[];
+  /** @see typescript-eslint */
+  typescript(config?: PluginConfig): Config[];
+  /** @see typescript-eslint */
+  typescriptTypeChecked(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-unicorn */
+  unicorn(config?: PluginConfig): Config[];
+  /** @see @unocss/eslint-config */
+  unocss(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-vitest */
+  vitest(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-vue */
+  vue(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-vuejs-accessibility */
+  vueAccessibility(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-vue-i18n */
+  vueI18n(config?: PluginConfig): Config[];
+  /** @see eslint-plugin-zod */
+  zod(config?: PluginConfig): Config[];
+}
+
+/** Ограничение синтаксиса - сообщение об ошибке и селектор AST. */
+export interface RestrictedSyntax {
+  message: string;
+  selector: string;
+}
+
+/** Пространство имён фабрик плагинов. */
+export declare const plugins: Plugins;
+
+/**
+ * Базовый конфиг: область файлов, игнорируемые пути и глобальные переменные.
+ * Добавляется автоматически первым блоком в `defineConfig`.
+ */
+export declare const base: Config[];
+
+export declare const DATA_FILES: string[];
+export declare const DTS_FILES: string[];
+export declare const FILES: string[];
+export declare const IGNORES: string[];
+export declare const JSON_FILES: string[];
+export declare const NO_RESTRICTED_SYNTAX: RestrictedSyntax[];
+export declare const TEST_FILES: string[];
+export declare const TS_FILES: string[];
+export declare const TS_RULES: Record<string, Linter.RuleEntry>;
+export declare const VUE_FILES: string[];
+export declare const YAML_FILES: string[];
+
+/**
+ * Создать конфигурацию ESLint.
+ *
+ * Базовые настройки (`base`) добавляются автоматически и всегда идут первыми.
+ * Разворачивайте вызовы плагинов через spread-оператор, а переопределения
+ * добавляйте прямо в массив.
+ *
+ * @example
+ *   import { defineConfig, plugins } from '@alexlit/config-eslint';
+ *
+ *   export default defineConfig([
+ *     ...plugins.javascript(),
+ *     ...plugins.unicorn({ rules: { 'unicorn/no-null': 'off' } }),
+ *     ...plugins.prettierConfig(), // последним
+ *     { rules: { 'no-console': 'off' } },
+ *   ]);
+ *
+ * @param configs - Массив flat-конфигов
+ */
+export declare function defineConfig(configs?: Config[]): Config[];