eslint.config.js

import js from '@eslint/js';
import prettierConfig from 'eslint-config-prettier';
import importPlugin from 'eslint-plugin-import';
import jsxA11y from 'eslint-plugin-jsx-a11y';
import reactPlugin from 'eslint-plugin-react';
import reactHooks from 'eslint-plugin-react-hooks';
import storybook from 'eslint-plugin-storybook';
import testingLibrary from 'eslint-plugin-testing-library';
import unicorn from 'eslint-plugin-unicorn';
import globals from 'globals';
import tseslint from 'typescript-eslint';

/** Stories must not import the library barrel — see README “Storybook styles”. */
const noLibraryBarrelInStories = {
  'no-restricted-imports': [
    'error',
    {
      paths: [
        {
          name: '~/src/index',
          message:
            'Import the component from its source file (e.g. ./button). Global styles load via .storybook/preview.js → entry-styles.ts.',
        },
      ],
      patterns: [
        {
          group: ['~/src/index', '~/src/index.ts'],
          message:
            'Import the component from its source file (e.g. ./button). Global styles load via .storybook/preview.js → entry-styles.ts.',
        },
      ],
    },
  ],
};

export default tseslint.config(
  {
    ignores: [
      'dist/**',
      'dist-storybook/**',
      '.storybook/**',
      'coverage/**',
      '.eslintcache',
      'node_modules/**',
      '.yarn/**',
      '*.config.js',
    ],
  },
  // Base JS & TS Recommended
  js.configs.recommended,
  tseslint.configs.recommendedTypeChecked,
  tseslint.configs.stylisticTypeChecked,
  importPlugin.flatConfigs.recommended,

  // A11y
  jsxA11y.flatConfigs.recommended,

  // React
  reactPlugin.configs.flat.recommended,
  // Add this if using React 17+ JSX transform
  reactPlugin.configs.flat['jsx-runtime'],

  // Testing Library
  testingLibrary.configs['flat/react'],

  // Unicorn & Storybook
  unicorn.configs.recommended,
  storybook.configs['flat/recommended'],

  // Prettier always last
  prettierConfig,

  {
    languageOptions: {
      globals: {
        ...globals.browser,
        ...globals.node,
      },
      parserOptions: {
        project: './tsconfig.eslint.json',
        tsconfigRootDir: import.meta.dirname,
      },
    },
    plugins: {
      'react-hooks': reactHooks,
      'testing-library': testingLibrary,
    },
    settings: {
      react: { version: '19' },

      // Tell eslint-plugin-import how to resolve TS/JS files.
      'import/resolver': {
        typescript: {
          project: './tsconfig.json',
        },
      },
    },
    rules: {
      // Add your custom overrides here
      'no-console': 'warn',
      '@typescript-eslint/no-unused-vars': [
        'error',
        { argsIgnorePattern: '^_' },
      ],
      'unicorn/prevent-abbreviations': 'off', // Airbnb was less strict than Unicorn
      'unicorn/null-data-property': 'off',
      'unicorn/no-null': 'off',
      // Prefer concise prop JSDoc (`/** ... */`) over forced multiline blocks.
      'unicorn/single-line-block-comment-style': 'off',
      'react/prop-types': 'off', // Using TypeScript, so don't use PropTypes.
      // Resolver cannot resolve Vite/tsconfig path aliases or @cfpb/cfpb-design-system src subpaths.
      'import/no-unresolved': [
        'error',
        { ignore: ['^@cfpb/cfpb-design-system/', '^~/'] },
      ],
    },
  },
  // Overrides for Tests
  {
    files: ['**/*.test.ts?(x)'],
    rules: {
      '@typescript-eslint/no-explicit-any': 'off',
    },
  },
  // Stories: import components from source, not the library barrel (MDX: same convention; see README).
  {
    files: ['**/*.stories.ts?(x)'],
    rules: noLibraryBarrelInStories,
  },
);