react-fathom/eslint.config.js at main · ryanhefner/react-fathom · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
import pluginImport from 'eslint-plugin-import'
import prettier from 'eslint-plugin-prettier/recommended'
import pluginReact from 'eslint-plugin-react'
import reactHooks from 'eslint-plugin-react-hooks'
import globals from 'globals'
import tseslint from 'typescript-eslint'

import pluginJs from '@eslint/js'

export default [
  // Ignore patterns
  {
    ignores: ['dist/**'],
  },

  // Base JavaScript recommended config
  pluginJs.configs.recommended,

  // Global settings
  {
    languageOptions: {
      globals: {
        ...globals.browser,
        ...globals.node,
        ...globals.es2021,
      },
      parserOptions: {
        ecmaVersion: 'latest',
        sourceType: 'module',
        ecmaFeatures: {
          jsx: true,
        },
      },
    },
    settings: {
      react: {
        version: 'detect',
      },
      'import/resolver': {
        node: true,
      },
    },
  },

  // TypeScript ESLint recommended configs
  ...tseslint.configs.recommended,

  // React plugin configuration
  {
    files: ['**/*.{js,jsx,ts,tsx}'],
    plugins: {
      react: pluginReact,
      'react-hooks': reactHooks,
      import: pluginImport,
    },
    rules: {
      ...(pluginReact.configs?.recommended?.rules || {}),
      ...(reactHooks.configs?.recommended?.rules || {}),
      'react/react-in-jsx-scope': 'off',
      'react/prop-types': 'off',
      // Import ordering rules: react -> namespaced external (@package) -> non-namespaced external -> internal -> local
      'import/order': [
        'error',
        {
          groups: [
            'builtin', // Node.js built-in modules
            'external', // External libraries (non-namespaced)
            'internal', // Internal absolute imports
            ['parent', 'sibling', 'index'], // Relative imports (local)
          ],
          pathGroups: [
            // React imports first
            {
              pattern: 'react',
              group: 'external',
              position: 'before',
            },
            {
              pattern: 'react-dom',
              group: 'external',
              position: 'before',
            },
            {
              pattern: 'react/**',
              group: 'external',
              position: 'before',
            },
            // Namespaced external imports (@package/name) - after React, before non-namespaced externals
            // Create a separate group for namespaced imports to ensure they come before non-namespaced
            {
              pattern: '@*/**',
              group: 'external',
              position: 'after',
            },
          ],
          pathGroupsExcludedImportTypes: ['react'],
          'newlines-between': 'always',
          // Alphabetize imports within each group
          // Note: For external group, pathGroups ordering takes precedence:
          // React -> namespaced (@package) -> non-namespaced
          alphabetize: {
            order: 'asc',
            caseInsensitive: true,
          },
        },
      ],
      'import/newline-after-import': 'error',
      'import/no-duplicates': 'error',
    },
  },

  // Prettier integration (must be last)
  prettier,

  // Custom rules
  {
    rules: {
      semi: ['error', 'never'],
      'no-prototype-builtins': 'off',
      '@typescript-eslint/no-explicit-any': 'warn',
      '@typescript-eslint/explicit-module-boundary-types': 'off',
      '@typescript-eslint/no-unused-vars': [
        'error',
        {
          argsIgnorePattern: '^_',
          varsIgnorePattern: '^_',
        },
      ],
    },
  },
]