eslint.config.js

import eslint from '@eslint/js'
import tseslint from 'typescript-eslint'
import importPlugin from 'eslint-plugin-import'
import prettier from 'eslint-config-prettier'

export default tseslint.config(
  // Global ignores
  {
    ignores: [
      '**/dist/',
      'node_modules/',
      'tmp/',
      'coverage/',
      // Claude Code creates sibling worktrees here, each a full checkout
      // with its own packages/, node_modules/, and tsconfigs. Without
      // this ignore, eslint's projectService discovers every tsconfig in
      // every worktree and OOMs on `eslint .`.
      '.claude/worktrees/',
      'vitest.config.ts',
      'eslint.config.js',
      '**/next-env.d.ts',
      '**/.next/',
      // cucumber-js config requires `export default` — ignore rather than override the rule
      'e2e/cucumber.mjs',
      // Standalone Node scripts not tracked by any tsconfig
      'scripts/**',
    ],
  },

  // Base JS rules
  eslint.configs.recommended,

  // TypeScript strict rules (type-checked)
  ...tseslint.configs.strictTypeChecked,

  // TypeScript-specific overrides
  {
    plugins: { import: importPlugin },
    settings: {
      'import/resolver': { typescript: true },
    },
    languageOptions: {
      parserOptions: {
        projectService: true,
        tsconfigRootDir: import.meta.dirname,
      },
    },
    rules: {
      // Enforce `import type` for type-only imports (AGENTS.md convention)
      '@typescript-eslint/consistent-type-imports': [
        'error',
        { prefer: 'type-imports', fixStyle: 'separate-type-imports' },
      ],

      // Merge imports from the same module (understands import type vs import value)
      'import/no-duplicates': ['error', { 'prefer-inline': false }],

      // Allow unused vars prefixed with _ (common pattern for intentional omission)
      '@typescript-eslint/no-unused-vars': [
        'error',
        { argsIgnorePattern: '^_', varsIgnorePattern: '^_' },
      ],

      // These are too noisy for template-literal HTML and better-auth interop
      '@typescript-eslint/restrict-template-expressions': 'off',
      '@typescript-eslint/no-unsafe-assignment': 'off',
      '@typescript-eslint/no-unsafe-member-access': 'off',
      '@typescript-eslint/no-unsafe-call': 'off',
      '@typescript-eslint/no-unsafe-argument': 'off',
      '@typescript-eslint/no-unsafe-return': 'off',

      // Allow non-null assertions — used sparingly with DOM getElementById etc.
      '@typescript-eslint/no-non-null-assertion': 'off',

      // Relax for Express handler patterns (void-returning async callbacks)
      '@typescript-eslint/no-misused-promises': [
        'error',
        { checksVoidReturn: { arguments: false } },
      ],

      // No default exports (AGENTS.md convention)
      'no-restricted-syntax': [
        'error',
        {
          selector: 'ExportDefaultDeclaration',
          message: 'Use named exports instead of default exports.',
        },
      ],
    },
  },

  // Next.js requires default exports for pages, layouts, and route handlers
  {
    files: ['packages/demo/**/*.{ts,tsx}'],
    rules: {
      'no-restricted-syntax': 'off',
    },
  },

  // e2e TypeScript files use a standalone tsconfig not referenced by the root —
  // disable projectService and point ESLint directly at e2e/tsconfig.e2e.json
  {
    files: ['e2e/**/*.ts'],
    languageOptions: {
      parserOptions: {
        projectService: false,
        project: 'e2e/tsconfig.e2e.json',
        tsconfigRootDir: import.meta.dirname,
      },
    },
  },

  // This JavaScript helper is executed directly by the E2E workflow and is
  // intentionally outside the TypeScript E2E project.
  {
    files: ['e2e/atmosphere/validate-access.mjs'],
    languageOptions: {
      globals: { console: 'readonly', process: 'readonly' },
      parserOptions: {
        projectService: {
          allowDefaultProject: ['e2e/atmosphere/validate-access.mjs'],
        },
        tsconfigRootDir: import.meta.dirname,
      },
    },
  },

  // Disable formatting rules that conflict with Prettier
  prettier,
)