DEV-MERGE-LEGACY-PC-FRONTEND-2026/eslint.config.js

// ESLint 9 flat config：vue3 + TS strict 配套（README §3.5：any 全面禁用）
import js from '@eslint/js';
import tseslint from 'typescript-eslint';
import pluginVue from 'eslint-plugin-vue';
import prettier from 'eslint-config-prettier';

/**
 * 框架运行时模块名（业务代码禁"值 import"，见 README §3.3-1）。
 *
 * 精确边界：
 *   - `import type { Ref } from 'vue'` 属**类型导入**（编译期擦除、零运行时足迹）——
 *     不在限内，TS strict 下类型必须有来源，type import 是唯一合规写法；
 *   - `import { ref } from 'vue'` 属**值导入**——会把框架运行时打包进 dist，必须拦。
 *
 * 实现用 `no-restricted-syntax`（而非 no-restricted-imports，后者不区分 type/value）：
 *   `importKind` 属性仅 @typescript-eslint/parser 产生：
 *     import type {...} → 'type'（放行）  |  import {...} → 'value'（拦截）
 */
const FRAMEWORK_MODULE_SELECTOR =
  ":is([source.value='vue'],[source.value='vue-router'],[source.value='pinia'],[source.value='axios'],[source.value='element-plus'])";

export default [
  js.configs.recommended,
  ...tseslint.configs.recommended,
  ...pluginVue.configs['flat/essential'],
  prettier,
  {
    // shims/ 由 scripts/gen-shims.cjs 生成（含逐行 eslint-disable 注释，引用了未安装的 import 插件），不 lint
    // scripts/ 是 Node CJS 工具脚本（require / __dirname），不属于浏览器 TS 产物，不 lint
    ignores: ['dist/**', 'vendor/**', 'node_modules/**', 'shims/**', 'scripts/**', '**/*.cjs'],
  },
  {
    // .vue：SFC 内 <script lang="ts"> 交给 @typescript-eslint/parser，
    // 否则 TS 语法（类型注解 / interface / 泛型）在 SFC 内触发 Parsing error。
    // vue-eslint-parser 解析 SFC 结构，本 block 只补"内部 script 用哪个 parser"。
    files: ['**/*.vue'],
    languageOptions: {
      parserOptions: {
        parser: tseslint.parser,
        sourceType: 'module',
      },
    },
  },
  {
    // TS 项目里 no-undef 必须由 TS 编译器负责（global.d.ts 声明的 ref/reactive/window 等
    // 对 JS 规则的 no-undef 不可见，会误报）；关掉它，TS 编译器 + 上面的"值 import 拦截"已足够。
    files: ['**/*.ts', '**/*.vue', '**/*.tsx'],
    rules: {
      'no-undef': 'off',
    },
  },
  {
    rules: {
      '@typescript-eslint/no-explicit-any': 'error',
      'vue/multi-word-component-names': 'off',
      '@typescript-eslint/no-unused-vars': [
        'error',
        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
      ],
      // 拦截"值 import 框架"（值导入会把框架运行时打包进 dist，违反 README §3.3-1）。
      // 放行 import type（编译期擦除）。importKind='value' 只匹配值导入。
      'no-restricted-syntax': [
        'error',
        {
          selector: `ImportDeclaration[importKind='value']${FRAMEWORK_MODULE_SELECTOR}`,
          message:
            '框架运行时经 UMD 全局使用（README §3.3-1），业务代码禁止值 import 框架模块；仅允许 `import type`（编译期擦除，零运行时足迹）。',
        },
      ],
    },
  },
];