// 导入ESLint核心JavaScript规则配置
import js from '@eslint/js';

// 导入TypeScript ESLint插件，提供TypeScript相关的检查规则
import typescript from '@typescript-eslint/eslint-plugin';

// 导入TypeScript ESLint解析器，用于解析TypeScript代码
import typescriptParser from '@typescript-eslint/parser';

// 导入Vue ESLint插件，提供Vue特定的检查规则
import vueEslintPlugin from 'eslint-plugin-vue';

// 导出ESLint配置数组（使用flat配置格式，ESLint v9+推荐）
export default [
  // 应用JavaScript默认推荐规则
  js.configs.recommended,
  
  // 应用Vue推荐规则（flat格式），使用扩展运算符展开数组
  ...vueEslintPlugin.configs['flat/recommended'],
  
  // 文件忽略配置块
  {
    // ignores属性指定需要ESLint忽略检查的文件路径模式
    ignores: [
      '**/*.test.ts',        // 忽略所有测试文件
      '**/*.spec.ts',        // 忽略所有规格文件
      'test/**',             // 忽略test目录下所有文件
      'dist/**',             // 忽略构建输出目录
      'node_modules/**',     // 忽略第三方依赖
      'coverage/**',         // 忽略测试覆盖率报告目录
      '*.config.js',         // 忽略配置文件
      '*.config.ts',         // 忽略TypeScript配置文件
    ],
  },
  // Vue文件特定规则配置块
  {
    // files属性指定此配置块适用的文件模式
    files: ['**/*.vue'],
    
    // languageOptions配置解析器和语言选项
    languageOptions: {
      // 使用Vue ESLint插件提供的解析器来解析.vue文件
      parser: vueEslintPlugin.parser,
      
      // parserOptions配置解析器选项
      parserOptions: {
        // 使用最新的ECMAScript版本
        ecmaVersion: 'latest',
        
        // 源代码类型为module（ES模块）
        sourceType: 'module',
        
        // 为Vue文件中的<script>块指定TypeScript解析器
        parser: typescriptParser,
        
        // 禁用projectService以避免与TypeScript编译器重复检查
        projectService: false, // 用tsc检查过了
        
        // 添加.vue作为额外的文件扩展名
        extraFileExtensions: ['.vue'],
      },
    },
    
    // plugins指定在此配置块中启用的插件
    plugins: {
      '@typescript-eslint': typescript,  // 启用TypeScript ESLint插件
      vue: vueEslintPlugin,              // 启用Vue ESLint插件
    },
    
    // rules配置具体的ESLint规则及其严重级别
    rules: {
      // Vue特定规则
      'vue/multi-word-component-names': 'off',  // 关闭组件名称必须为多个单词的规则
      'vue/no-v-model-argument': 'error',       // 禁止在v-model中使用参数，违反时报错
      'vue/script-setup-uses-vars': 'error',    // 确保script-setup中声明的变量被使用，违反时报错
      
      // TypeScript规则
      '@typescript-eslint/no-unused-vars': ['error', {  // 未使用的变量报错
        argsIgnorePattern: '^_',          // 忽略以下划线开头的参数
        varsIgnorePattern: '^[A-Z_]+$'    // 忽略全大写或带下划线的常量
      }],
      
      // 通用规则
      'no-unused-vars': 'off',            // 关闭JavaScript原生未使用变量规则（使用TypeScript版本替代）
      'no-console': 'warn',               // 禁止使用console，违反时警告
      'no-debugger': 'error',             // 禁止使用debugger，违反时报错
      'no-var': 'error',                  // 禁止使用var声明，违反时报错
      'prefer-const': 'error',            // 优先使用const声明，违反时报错
      
      // 代码风格
      'indent': ['error', 2, { SwitchCase: 1 }],  // 强制2空格缩进，switch case额外缩进1级
      'quotes': ['error', 'single', { avoidEscape: true }], // 强制使用单引号，允许转义的例外情况
      'semi': ['error', 'always'],        // 语句末尾必须有分号
      'comma-dangle': ['error', 'never'], // 禁止行末逗号
      'eol-last': ['warn', 'always'],     // 文件末尾必须有空行
      'no-trailing-spaces': 'warn',       // 禁止行尾空格
    },
  },
  // TypeScript文件特定规则配置块（排除测试文件）
  {
    // files属性指定此配置块适用的文件模式
    files: ['**/*.ts', '**/*.tsx'],
    
    // ignores在此配置块中进一步排除特定文件
    ignores: ['**/*.test.ts', '**/*.spec.ts', 'test/**/*.ts'],
    
    // languageOptions配置解析器和语言选项
    languageOptions: {
      // 使用TypeScript解析器
      parser: typescriptParser,
      
      // parserOptions配置解析器选项
      parserOptions: {
        // 使用最新的ECMAScript版本
        ecmaVersion: 'latest',
        
        // 源代码类型为module（ES模块）
        sourceType: 'module',
        
        // 禁用projectService以提高性能
        projectService: false, // vue-tsc来检查类型安全
      },
    },
    
    // plugins指定在此配置块中启用的插件
    plugins: {
      '@typescript-eslint': typescript,  // 启用TypeScript ESLint插件
    },
    
    // rules配置具体的ESLint规则及其严重级别
    rules: {
      'no-unused-vars': 'off',            // 关闭JavaScript原生未使用变量规则（使用TypeScript版本替代）
      '@typescript-eslint/no-unused-vars': ['error', {  // 未使用的变量报错
        argsIgnorePattern: '^_',          // 忽略以下划线开头的参数（函数参数）
        varsIgnorePattern: '^[A-Z_]+$'    // 忽略全大写或带下划线的常量
      }],
      '@typescript-eslint/no-explicit-any': 'warn',  // 禁止使用any类型，违反时警告
      '@typescript-eslint/no-non-null-assertion': 'warn', // 禁止使用非空断言（!），违反时警告
      
      // 通用规则
      'no-console': 'warn',               // 禁止使用console，违反时警告
      'no-debugger': 'error',             // 禁止使用debugger，违反时报错
      'no-var': 'error',                  // 禁止使用var声明，违反时报错
      'prefer-const': 'error',            // 优先使用const声明，违反时报错
      
      // 代码风格
      'indent': ['error', 2, { SwitchCase: 1 }],  // 强制2空格缩进，switch case额外缩进1级
      'quotes': ['error', 'single', { avoidEscape: true }], // 强制使用单引号，允许转义的例外情况
      'semi': ['error', 'always'],        // 语句末尾必须有分号
      'comma-dangle': ['error', 'never'], // 禁止行末逗号
      'eol-last': ['warn', 'always'],     // 文件末尾必须有空行
      'no-trailing-spaces': 'warn',       // 禁止行尾空格
    },
  },
]; // ESLint配置数组结束