.eslintrc.js

module.exports = {
  extends: 'standard',
  ignorePatterns: [
    '**/dist/**',
    '**/vendor/**',

    // Enable dotfile linting
    '!.*',
    'node_modules',
    'node_modules/.*',

    // Prevent CHANGELOG history changes
    'CHANGELOG.md'
  ],
  overrides: [
    {
      extends: [
        'eslint:recommended',
        'plugin:import/recommended',
        'plugin:jsdoc/recommended-typescript-flavor',
        'plugin:n/recommended',
        'plugin:promise/recommended'
      ],
      files: [
        '**/*.{cjs,js,mjs}',

        // Check markdown `*.md` contains valid code blocks
        // https://github.com/eslint/eslint-plugin-markdown#advanced-configuration
        '**/*.md/*.{cjs,js,mjs}'
      ],
      parserOptions: {
        ecmaVersion: 'latest'
      },
      plugins: [
        'import',
        'jsdoc',
        'n',
        'promise'
      ],
      rules: {
        // Check import or require statements are A-Z ordered
        'import/order': [
          'error',
          {
            alphabetize: { order: 'asc' },
            'newlines-between': 'always'
          }
        ],

        // JSDoc blocks are optional
        'jsdoc/require-jsdoc': 'off',
        'jsdoc/require-param-description': 'off',
        'jsdoc/require-param': 'off',

        // Check for valid formatting
        'jsdoc/check-line-alignment': [
          'warn',
          'never', {
            wrapIndent: '  '
          }
        ],

        // Require hyphens before param description
        // Aligns with TSDoc style: https://tsdoc.org/pages/tags/param/
        'jsdoc/require-hyphen-before-param-description': 'warn',

        // Maintain new line after description
        'jsdoc/tag-lines': [
          'warn',
          'never', {
            startLines: 1
          }
        ],

        // Ignore `govuk-frontend` exports as they require auto-generated files
        'import/no-unresolved': ['error', { ignore: ['govuk-frontend'] }],
        'n/no-missing-import': ['error', { allowModules: ['govuk-frontend'] }],
        'n/no-missing-require': ['error', { allowModules: ['govuk-frontend'] }],

        // Automatically use template strings
        'no-useless-concat': 'error',
        'prefer-template': 'error'
      },
      settings: {
        jsdoc: {
          // Allows us to use type declarations that exist in our dependencies
          mode: 'typescript'
        }
      }
    },
    {
      // Extensions required for ESM import
      files: ['**/*.mjs'],
      rules: {
        'import/extensions': [
          'error',
          'always',
          {
            ignorePackages: true,
            pattern: {
              cjs: 'always',
              js: 'always',
              mjs: 'always'
            }
          }
        ]
      }
    },
    {
      files: ['**/*.test.{cjs,js,mjs}'],
      env: {
        jest: true
      }
    },
    {
      // Add plugin for markdown `*.md` code blocks
      extends: ['plugin:markdown/recommended'],
      files: ['**/*.md'],
      plugins: ['markdown'],
      processor: 'markdown/markdown'
    },
    {
      files: ['**/coding-standards/js.md/*.{cjs,js,mjs}'],
      env: {
        browser: true
      },
      rules: {
        // Ignore unused example code
        'no-undef': 'off',
        'no-unused-vars': 'off',

        // Ignore paths to example modules
        'import/no-unresolved': 'off',
        'n/no-missing-import': 'off'
      }
    }
  ],
  parserOptions: {
    project: './tsconfig.json'
  },
  root: true
}