HY2XS_flamy/apps/frontend/eslint.config.mjs

import { createRequire } from "node:module";

import js from "@eslint/js";
import globals from "globals";
import tseslint from "typescript-eslint";
import pluginVue from "eslint-plugin-vue";
import prettier from "eslint-config-prettier";
import vueParser from "vue-eslint-parser";

/**
 * Конфигурация ESLint во flat-формате.
 *
 * Заменяет `.eslintrc.cjs`. Причина не в моде на формат: eslint 8 объявлен
 * EOL, перестал получать исправления и оставался последним источником десятка
 * предупреждений `pnpm audit` в проекте (minimatch, brace-expansion, js-yaml,
 * flatted — всё в его собственном графе). Eslintrc-формат в eslint 9 работает
 * только через переменную окружения, а в 10 удалён вовсе, поэтому обновление
 * версии без перехода на flat-config было бы отсрочкой на один релиз.
 *
 * Набор правил сохранён ровно тем же, что был в `.eslintrc.cjs`: перевод
 * формата не место для изменения политики линтинга.
 */

// Глобальные имена авто-импорта генерирует unplugin-auto-import в
// eslintrc-формате (`{ globals: { ref: true, ... } }`). Flat-config такой файл
// через `extends` не подключает, поэтому список читается напрямую — источник
// истины остаётся один, и он по-прежнему пересоздаётся сборкой.
const require = createRequire(import.meta.url);
const autoImportGlobals = require("./.eslintrc-auto-import.json").globals;

export default tseslint.config(
  {
    // Перенесено из .eslintignore: eslint 9 этот файл больше не читает, и
    // список исключений обязан жить в самой конфигурации.
    //
    // src/assets — SVG и изображения; src/types/*.d.ts — объявления, которые
    // генерируют unplugin-auto-import и unplugin-vue-components, править их
    // вручную нельзя, а замечания линтера по ним только шумят.
    ignores: [
      "dist/**",
      "node_modules/**",
      "public/**",
      "src/assets/**",
      "src/types/*.d.ts",
    ],
  },

  js.configs.recommended,
  ...tseslint.configs.recommended,
  ...pluginVue.configs["flat/essential"],

  {
    languageOptions: {
      ecmaVersion: "latest",
      sourceType: "module",
      globals: {
        ...globals.browser,
        ...globals.node,
        ...autoImportGlobals,
        // Объявлены в src/types/global.d.ts и используются как глобальные
        // типы. Списку положено совпадать с содержимым того файла: `no-undef`
        // не знает о declare global, и отсутствующее здесь имя падает ошибкой
        // линтера при совершенно корректном коде.
        //
        // DialogType и OptionType отсюда убраны: в src/types/global.d.ts их
        // нет и в панели они не встречаются — это остаток чужого шаблона,
        // разрешавший необъявленные имена.
        IdDto: "readonly",
        BaseDto: "readonly",
        PageVo: "readonly",
      },
    },
    rules: {
      // Имя компонента из одного слова — устоявшееся соглашение этого проекта.
      "vue/multi-word-component-names": "off",
      "vue/no-v-model-argument": "off",
      "@typescript-eslint/no-empty-function": "off",
      "@typescript-eslint/no-explicit-any": "off",
      "@typescript-eslint/no-non-null-assertion": "off",
    },
  },

  {
    // .vue разбирает vue-eslint-parser, а <script lang="ts"> внутри него —
    // парсер TypeScript. Без второй половины содержимое блока не разбирается.
    files: ["**/*.vue"],
    languageOptions: {
      parser: vueParser,
      parserOptions: {
        parser: tseslint.parser,
        ecmaVersion: "latest",
        sourceType: "module",
      },
    },
  },

  // Последним: отключает правила форматирования, которыми владеет prettier.
  //
  // Ни один из включённых наборов таких правил сейчас не содержит, так что это
  // страховка, а не исправление: форматированием занимается отдельный скрипт
  // lint:prettier, и правило-дубликат в линтере привело бы к двум источникам
  // истины о стиле.
  prettier
);