eslint.config.js

/**
 * eslint.config.js
 * 
 * Purpose:
 * Provides the ESLint configuration for the FitFlow application, ensuring consistent code quality
 * and enforcing best practices across the codebase. This module defines the linting rules that
 * help maintain code standards, prevent common errors, and enforce patterns that improve
 * maintainability and readability.
 * 
 * Key Features:
 * - TypeScript-aware linting with typescript-eslint integration
 * - React-specific rules for hooks and component refresh
 * - Modular configuration with separate rule sets for different file types
 * - Ignores build artifacts in the 'dist' directory
 * - Uses modern ESLint flat configuration format
 * 
 * Technical Details:
 * - Leverages typescript-eslint for TypeScript-aware code analysis
 * - Configures browser globals for proper environment detection
 * - Sets ECMAScript 2020 as the target JavaScript version
 * - Implements React-specific plugins for hooks and refresh patterns
 * - Extends recommended configurations for core JavaScript and TypeScript
 * 
 * Integration:
 * - Used by the IDE/editor for real-time linting feedback
 * - Referenced by the 'npm run lint' script for CI/CD validation
 * - Works alongside TypeScript for comprehensive code quality checks
 * - Supports modern ESM module syntax for proper import/export analysis
 * 
 * Recent Changes:
 * - 2025-03-01: Added comprehensive documentation following project standards
 * - 2025-02-15: Initial configuration with TypeScript and React support
 */
import js from '@eslint/js';
import globals from 'globals';
import reactHooks from 'eslint-plugin-react-hooks';
import reactRefresh from 'eslint-plugin-react-refresh';
import tseslint from 'typescript-eslint';

export default tseslint.config(
  { ignores: ['dist'] },
  {
    extends: [js.configs.recommended, ...tseslint.configs.recommended],
    files: ['**/*.{ts,tsx}'],
    languageOptions: {
      ecmaVersion: 2020,
      globals: globals.browser,
    },
    plugins: {
      'react-hooks': reactHooks,
      'react-refresh': reactRefresh,
    },
    rules: {
      ...reactHooks.configs.recommended.rules,
      'react-refresh/only-export-components': [
        'warn',
        { allowConstantExport: true },
      ],
    },
  }
);