代码规范：ESLint与Prettier

// eslint.config.js (Flat Config - ESLint 9+)
import js from '@eslint/js';
import tseslint from 'typescript-eslint';
import reactPlugin from 'eslint-plugin-react';
import reactHooks from 'eslint-plugin-react-hooks';
import prettier from 'eslint-config-prettier';

export default tseslint.config(
  // 全局忽略
  { ignores: ['dist/', 'node_modules/', '*.min.js'] },

  // 基础推荐规则
  js.configs.recommended,

  // TypeScript规则
  ...tseslint.configs.recommended,

  // React规则
  {
    files: ['**/*.{ts,tsx}'],
    plugins: {
      react: reactPlugin,
      'react-hooks': reactHooks,
    },
    rules: {
      ...reactPlugin.configs.recommended.rules,
      ...reactPlugin.configs['jsx-runtime'].rules,
      ...reactHooks.configs.recommended.rules,
      'react/prop-types': 'off',
      'react/react-in-jsx-scope': 'off',
    },
    settings: {
      react: { version: 'detect' },
    },
  },

  // 自定义规则覆盖
  {
    files: ['src/**/*.{ts,tsx}'],
    rules: {
      'no-console': ['warn', { allow: ['warn', 'error'] }],
      'no-unused-vars': 'off',
      '@typescript-eslint/no-unused-vars': ['error', {
        argsIgnorePattern: '^_',
        varsIgnorePattern: '^_',
      }],
      '@typescript-eslint/explicit-function-return-type': ['error', {
        allowExpressions: true,
        allowTypedFunctionExpressions: true,
      }],
      '@typescript-eslint/consistent-type-imports': ['error', {
        prefer: 'type-imports',
      }],
      '@typescript-eslint/no-non-null-assertion': 'error',
      'react-hooks/exhaustive-deps': 'error',
    },
  },

  // 测试文件宽松规则
  {
    files: ['**/*.test.{ts,tsx}', '**/*.spec.{ts,tsx}'],
    rules: {
      '@typescript-eslint/no-explicit-any': 'off',
      '@typescript-eslint/explicit-function-return-type': 'off',
    },
  },

  // Prettier兼容（必须放最后）
  prettier,
);

// .prettierrc
{
  "semi": true,
  "singleQuote": true,
  "trailingComma": "all",
  "printWidth": 100,
  "tabWidth": 2,
  "bracketSpacing": true,
  "arrowParens": "always",
  "endOfLine": "lf",
  "overrides": [
    {
      "files": "*.json",
      "options": { "printWidth": 200 }
    },
    {
      "files": "*.md",
      "options": { "proseWrap": "always" }
    }
  ]
}

// .prettierignore
// dist/
// node_modules/
// *.min.js
// package-lock.json

// package.json - lint-staged配置
// {
//   "lint-staged": {
//     "*.{ts,tsx}": [
//       "eslint --fix",
//       "prettier --write"
//     ],
//     "*.{json,md,yml}": [
//       "prettier --write"
//     ],
//     "*.css": [
//       "stylelint --fix",
//       "prettier --write"
//     ]
//   }
// }

// 设置husky
// pnpm dlx husky init
// echo "pnpm exec lint-staged" > .husky/pre-commit

// 自定义ESLint规则示例
// rules/no-inline-styles.js
export default {
  meta: {
    type: 'suggestion',
    docs: { description: '禁止内联样式' },
    messages: {
      noInlineStyles: '请使用CSS类代替内联样式，便于维护和复用',
    },
  },
  create(context) {
    return {
      JSXAttribute(node) {
        if (node.name.name === 'style') {
          context.report({ node, messageId: 'noInlineStyles' });
        }
      },
    };
  },
};