/**
 * ESLint A11y 配置（P6 硬化，flat config 格式 / ESLint 9）
 *
 * - 配置 eslint-plugin-jsx-a11y（WCAG 2.2 AA 规则集）
 * - 5 个核心页面（grades/grades-entry/homework-detail/questions/settings）强制 error 级别
 * - 其他页面降级为 warn（遗留代码渐进式迁移）
 * - eslint 在仅有 warning 时退出码为 0
 *
 * 这是独立配置文件（flat config 数组格式），不修改主 eslint 配置。
 * 使用方式：eslint -c .eslintrc.a11y.js src
 *
 * 关联：02-architecture-design.md §12 可观测性 / WCAG 2.2 AA
 */

// 使用 @typescript-eslint/parser 以支持 TS/TSX 语法
// （通过 Node.js 向上查找从根 node_modules 解析）
let tsParser;
try {
  tsParser = require("@typescript-eslint/parser");
} catch {
  tsParser = undefined;
}

// 加载 jsx-a11y 插件（从根 node_modules 解析）
let jsxA11y;
try {
  jsxA11y = require("eslint-plugin-jsx-a11y");
} catch {
  jsxA11y = { rules: {} };
}

/** @type {import('eslint').Linter.Config[]} */
module.exports = [
  {
    files: ["**/*.{ts,tsx,js,jsx}"],
    languageOptions: {
      parser: tsParser,
      ecmaVersion: 2022,
      sourceType: "module",
      parserOptions: {
        ecmaFeatures: { jsx: true },
      },
    },
    plugins: { "jsx-a11y": jsxA11y },
    rules: {
      // WCAG 2.2 AA 规则集

      // 1.1.1 非文本内容：所有图片必须有 alt 属性
      "jsx-a11y/alt-text": "error",

      // 1.3.1 信息与关系：表单控件必须有 label
      // 降级为 warn：control-has-associated-label 不识别 <label htmlFor> 关联（已知误报），
      // label-has-associated-control 在遗留页面有大量未关联 label，渐进式迁移
      "jsx-a11y/label-has-associated-control": "warn",
      "jsx-a11y/control-has-associated-label": "warn",

      // 1.4.1 颜色使用：不仅依赖颜色传达信息
      "jsx-a11y/no-noninteractive-element-interactions": "error",

      // 2.1.1 键盘可达性：所有交互元素必须键盘可操作
      // 降级为 warn：遗留页面有 clickable div 未加键盘支持，渐进式迁移
      "jsx-a11y/no-static-element-interactions": "warn",

      // 2.1.2 无键盘陷阱：焦点必须能移出组件
      "jsx-a11y/no-autofocus": "error",

      // 2.4.1 跳过块：提供跳过重复内容的机制
      "jsx-a11y/anchor-is-valid": "error",

      // 2.4.4 链接目的：链接文本必须有意义
      "jsx-a11y/anchor-has-content": "error",

      // 2.4.6 标题与标签：标题必须描述性
      "jsx-a11y/heading-has-content": "error",

      // 3.1.2 每种语言的部分：html lang 属性
      "jsx-a11y/html-has-lang": "error",
      "jsx-a11y/lang": "error",

      // 3.2.2 输入时：表单提交可预测
      // no-onchange 规则已废弃（deprecated），不适用于 React 受控组件（onChange 是 React 标准模式）
      "jsx-a11y/no-onchange": "off",

      // 3.3.2 标签或指令：表单输入需要描述
      "jsx-a11y/tabindex-no-positive": "error",

      // 4.1.2 名称、角色、值：ARIA 属性正确使用
      "jsx-a11y/aria-props": "error",
      "jsx-a11y/aria-proptypes": "error",
      "jsx-a11y/aria-unsupported-elements": "error",
      "jsx-a11y/role-has-required-aria-props": "error",
      "jsx-a11y/role-supports-aria-props": "error",

      // 4.1.3 状态消息：ARIA live regions
      "jsx-a11y/aria-activedescendant-has-tabindex": "error",

      // 额外规则：交互元素的角色
      "jsx-a11y/interactive-supports-focus": "error",
      "jsx-a11y/no-interactive-element-to-noninteractive-role": "error",
      "jsx-a11y/no-noninteractive-element-to-interactive-role": "error",
      "jsx-a11y/no-redundant-roles": "error",
      "jsx-a11y/aria-role": "error",

      // 媒体可访问性
      "jsx-a11y/media-has-caption": "error",

      // 鼠标/指针事件可访问性
      "jsx-a11y/mouse-events-have-key-events": "error",
      // 降级为 warn：遗留页面有 click 未加键盘监听，渐进式迁移
      "jsx-a11y/click-events-have-key-events": "warn",

      // 分散元素（blink/marquee 禁用）
      "jsx-a11y/no-distracting-elements": "error",
    },
  },
  // 5 个核心页面：强制 error 级别（已修复，0 errors）
  {
    files: [
      "src/app/(app)/grades/page.tsx",
      "src/app/(app)/grades/entry/page.tsx",
      "src/app/(app)/homework/[id]/page.tsx",
      "src/app/(app)/questions/page.tsx",
      "src/app/(app)/settings/page.tsx",
    ],
    rules: {
      "jsx-a11y/label-has-associated-control": "error",
      "jsx-a11y/control-has-associated-label": "error",
      "jsx-a11y/no-static-element-interactions": "error",
      "jsx-a11y/click-events-have-key-events": "error",
    },
  },
  // 允许在测试文件中使用 jsx-a11y 断言
  {
    files: ["**/*.test.{ts,tsx}", "**/*.spec.{ts,tsx}"],
    rules: {
      "jsx-a11y/anchor-is-valid": "off",
    },
  },
];