eslint.config.mjs

// @ts-check

/** @import { Linter } from "eslint" */

import eslintJs from "@eslint/js";
import eslintPluginJsdoc from "eslint-plugin-jsdoc";
import eslintPluginSimpleImportSort from "eslint-plugin-simple-import-sort";
import globals from "globals";

/**
 * Globs for ESM files.
 * @satisfies {Array<string>}
 */
const globsEsm = ["**/**.mjs"];

/**
 * Globs for CJS files.
 * @satisfies {Array<string>}
 */
const globsCjs = ["**/**.cjs", "**/**.js"];

/**
 * Globs for all JavaScript files.
 * @satisfies {Array<string>}
 */
const globsJs = [...globsEsm, ...globsCjs];

/**
 * ESLint configuration.
 * @satisfies {Array<Linter.Config>}
 */
const eslintConfig = [
  {
    files: globsJs,
    ...eslintJs.configs.recommended,
  },
  {
    files: globsJs,
    ...eslintPluginJsdoc.configs["flat/recommended-typescript-flavor-error"],
  },
  {
    files: globsJs,
    rules: {
      "arrow-body-style": "error",
      "object-shorthand": "error",
      strict: "error",

      // Sometimes it’s better for TypeScript to infer the return type.
      "jsdoc/require-returns-type": "off",
    },
  },
  {
    files: globsEsm,
    languageOptions: {
      globals: globals.nodeBuiltin,
    },
    plugins: {
      "simple-import-sort": eslintPluginSimpleImportSort,
    },
    rules: {
      "simple-import-sort/imports": "error",
      "simple-import-sort/exports": "error",
    },
  },
  {
    files: globsCjs,
    languageOptions: {
      sourceType: "commonjs",
      globals: globals.node,
    },
  },
];

export default eslintConfig;