eslint-config-scratch 10.0.13 → 11.0.0

package/lib/eslint.mjs

@@ -3,272 +3,360 @@ import formatjs from 'eslint-plugin-formatjs'
 import html from 'eslint-plugin-html'
 import htmlSettings from 'eslint-plugin-html/src/settings.js'
 import importPlugin from 'eslint-plugin-import'
+import jsdoc from 'eslint-plugin-jsdoc'
 import jsxA11y from 'eslint-plugin-jsx-a11y'
-import markdown from 'eslint-plugin-markdown'
 import react from 'eslint-plugin-react'
 import reactHooks from 'eslint-plugin-react-hooks'
-import globals from 'globals'
 import tseslint from 'typescript-eslint'
 import eslintComments from '@eslint-community/eslint-plugin-eslint-comments/configs'
 import eslint from '@eslint/js'
+import markdown from '@eslint/markdown'
+import legacyES6 from './legacy/es6.mjs'
+import legacyBase from './legacy/index.mjs'
+import legacyNode from './legacy/node.mjs'
+import legacyReact from './legacy/react.mjs'
+
+const legacy = {
+  base: legacyBase,
+  es6: legacyES6,
+  node: legacyNode,
+  react: legacyReact,
+}
 
-// See https://www.npmjs.com/package/eslint-plugin-html#user-content-settings
-const htmlExtensions = htmlSettings.getSettings({}).htmlExtensions
-
-// '.html' => '**/*.html'
-const htmlGlobs = htmlExtensions.map(ext => `**/*${ext}`)
+// WARNING: eslint rules from `typescript-eslint`, even the "untyped" rules, assume that your code will be run through
+// `tsc` or equivalent for type checking. Using any rule set from `typescript-eslint` will, for example, turn off the
+// `no-undef` rule. That makes sense if you'll use TypeScript to catch undefined globals, but it could be dangerous
+// for plain JavaScript.
+// More information here: https://github.com/typescript-eslint/typescript-eslint/issues/8825#issuecomment-2033315610
 
 /**
- * @typedef {import('eslint').Linter.Globals} Globals
- * @typedef {keyof globals} GlobalsKey
- * @typedef {Globals | GlobalsKey} GlobalsObjOrKey
+ * Convert an array of file extensions to an array of globs
+ * @param {string[]} extArray - an array of file extensions, like `.foo`
+ * @returns {string[]} an array of globs, like `** /*.foo` (without the space)
  */
+const extArrayToGlobArray = extArray => extArray.map(ext => `**/*${ext}`)
+
+// See https://www.npmjs.com/package/eslint-plugin-html#user-content-settings
+const htmlSettingsDefault = htmlSettings.getSettings({})
+
+const fileExtensions = (x => {
+  x.allScript = [...x.javaScript, ...x.typeScript]
+  return x
+})({
+  html: /** @type {string[]} */ (htmlSettingsDefault.htmlExtensions),
+  javaScript: ['.js', '.jsx', '.mjs', '.cjs'],
+  markdown: ['.md'],
+  typeScript: ['.ts', '.tsx', '.mts', '.cts'],
+  react: ['.jsx', '.tsx'],
+  xml: /** @type {string[]} */ (htmlSettingsDefault.xmlExtensions),
+})
+
+// This explicitly lists each entry so that we can get unused warnings
+const fileGlobs = {
+  allScript: extArrayToGlobArray(fileExtensions.allScript),
+  html: extArrayToGlobArray(fileExtensions.html),
+  javaScript: extArrayToGlobArray(fileExtensions.javaScript),
+  markdown: extArrayToGlobArray(fileExtensions.markdown),
+  react: extArrayToGlobArray(fileExtensions.react),
+  typeScript: extArrayToGlobArray(fileExtensions.typeScript),
+  xml: extArrayToGlobArray(fileExtensions.xml),
+}
 
 /**
- * Flatten the globals passed to `makeScratchConfig` into an object suitable for ESLint's `globals` option.
- * @param {GlobalsObjOrKey | GlobalsObjOrKey[]} [globalsIn] The globals to flatten.
- * @returns {Globals|undefined} Flattened globals object for ESLint.
+ * Rules for specific file types outside of the core JS/TS rule sets.
  */
-const flattenGlobals = globalsIn => {
-  if (!globalsIn) return
-
-  /**
-   *
-   * @param {Globals} globalsAcc Globals accumulator.
-   * @param {GlobalsObjOrKey} objOrKey A globals object or key to add to the accumulator.
-   * @returns {Globals} The accumulator after adding the current globals object or key.
-   */
-  const globalsReducer = (globalsAcc, objOrKey) => {
-    if (typeof objOrKey === 'string') {
-      const globalsForKey = globals[objOrKey]
-      if (!globalsForKey) {
-        throw new Error(`Invalid globals name. Not a key from the globals package: ${objOrKey}`)
-      }
-      Object.assign(globalsAcc, globalsForKey)
-    } else {
-      Object.assign(globalsAcc, objOrKey)
-    }
-
-    return globalsAcc
-  }
-
-  if (Array.isArray(globalsIn)) {
-    return globalsIn.reduce(globalsReducer, {})
-  }
-
-  return globalsReducer({}, globalsIn)
-}
+const miscFileRules = tseslint.config([
+  // eslint-plugin-html
+  {
+    name: 'scratch/miscFileRules[eslint-plugin-html]',
+    files: [...fileGlobs.html, ...fileGlobs.xml],
+    plugins: { html },
+    settings: {
+      'html/html-extensions': fileExtensions.html,
+      'xml/xml-extensions': fileExtensions.xml,
+    },
+  },
+  // eslint-plugin-markdown
+  {
+    name: 'scratch/miscFileRules[eslint-plugin-markdown]',
+    files: fileGlobs.markdown,
+    extends: [markdown.configs.recommended],
+    language: 'markdown/gfm', // Github Flavored Markdown
+  },
+  markdown.configs.processor, // Process script blocks inside Markdown files
+])
 
 /**
- * Create an ESLint configuration for Scratch style.
- * Supports JavaScript, TypeScript, and React (JSX/TSX) files.
- * Setting `tsconfigRootDir` enables type-aware rules, some of which apply even in JavaScript files.
- * @param {object} options Configuration options
- * @param {string} [options.tsconfigRootDir] Enable type checking by setting the root TypeScript config directory.
- * @param {GlobalsObjOrKey | GlobalsObjOrKey[]} [options.globals] Globals to provide to ESLint.
- * This can be expressed as:
- * - a single string, such as `'browser'`, corresponding to a key in the `globals` package.
- * - a single object as described in the "Specifying Globals" section of the ESLint documentation:
- *   https://eslint.org/docs/latest/use/configure/language-options#using-configuration-files
- * - an array of zero or more elements, each of which can be either of the above
- * @example
- * // eslint.config.mjs
- * export default makeScratchConfig({tsconfigRootDir: import.meta.dirname, globals: 'node'})
- * @example
- * // eslint.config.mjs
- * export default [
- *   ...makeScratchConfig({tsconfigRootDir: import.meta.dirname, globals: 'browser'}),
- *   {
- *     // customization
- *   }
- * ]
- * @returns {import('typescript-eslint').ConfigArray} An ESLint configuration array.
+ * Rules recommended for all script files, whether or not type information is available or checked.
  */
-const makeEslintConfig = ({ tsconfigRootDir, globals: globalsIn } = {}) => {
-  const flattenedGlobals = flattenGlobals(globalsIn)
-
-  return tseslint.config(
-    // Start with recommended rules from ESLint and TypeScript ESLint.
-    {
-      extends: [
-        eslint.configs.recommended,
-        tsconfigRootDir ? tseslint.configs.recommendedTypeChecked : tseslint.configs.recommended,
-        tsconfigRootDir ? tseslint.configs.stylisticTypeChecked : tseslint.configs.stylistic,
-      ],
-      languageOptions: {
-        parserOptions: {
-          ...(tsconfigRootDir
-            ? {
-                projectService: true,
-                tsconfigRootDir,
-              }
-            : {}),
-        },
-        ...(globalsIn ? { globals: flattenedGlobals } : {}),
-      },
+const allScriptRules = tseslint.config([
+  // eslint-plugin-formatjs
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-formatjs]',
+    plugins: {
+      formatjs,
     },
-    // eslint-plugin-formatjs
-    {
-      plugins: {
-        formatjs,
-      },
-      rules: {
-        'formatjs/no-offset': ['error'],
-      },
+    rules: {
+      'formatjs/no-offset': ['error'],
     },
-    // eslint-plugin-html
-    {
-      files: htmlGlobs,
-      plugins: { html },
-      settings: {
-        'html/html-extensions': htmlExtensions,
-      },
+  },
+  // eslint-plugin-import
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-import]',
+    plugins: importPlugin.flatConfigs.recommended.plugins,
+    rules: {
+      'import/no-duplicates': 'error', // Forbid duplicate imports
     },
-    // eslint-plugin-import
-    {
-      plugins: importPlugin.flatConfigs.recommended.plugins,
-      rules: {
-        'import/no-duplicates': 'error', // Forbid duplicate imports
-      },
+  },
+  // eslint-plugin-jsx-a11y
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-jsx-a11y]',
+    files: fileGlobs.react,
+    extends: [jsxA11y.flatConfigs.recommended],
+  },
+  // eslint-plugin-react
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-react]',
+    files: fileGlobs.react,
+    plugins: {
+      react,
     },
-    // eslint-plugin-jsx-a11y
-    jsxA11y.flatConfigs.recommended,
-    // eslint-plugin-markdown
-    markdown.configs.recommended,
-    // eslint-plugin-react
-    {
-      plugins: {
-        react,
-      },
-      rules: {
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/no-danger.md
-        'react/no-danger': ['error'],
+    rules: {
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/no-danger.md
+      'react/no-danger': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/self-closing-comp.md
-        'react/self-closing-comp': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/self-closing-comp.md
+      'react/self-closing-comp': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-boolean-value.md
-        'react/jsx-boolean-value': ['error', 'never'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-boolean-value.md
+      'react/jsx-boolean-value': ['error', 'never'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-closing-bracket-location.md
-        'react/jsx-closing-bracket-location': ['error', 'line-aligned'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-closing-bracket-location.md
+      'react/jsx-closing-bracket-location': ['error', 'line-aligned'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-curly-spacing.md
-        'react/jsx-curly-spacing': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-curly-spacing.md
+      'react/jsx-curly-spacing': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-equals-spacing.md
-        'react/jsx-equals-spacing': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-equals-spacing.md
+      'react/jsx-equals-spacing': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-filename-extension.md
-        'react/jsx-filename-extension': ['error', { extensions: ['.jsx', '.tsx'] }],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-filename-extension.md
+      'react/jsx-filename-extension': ['error', { extensions: ['.jsx', '.tsx'] }],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-first-prop-new-line.md
-        'react/jsx-first-prop-new-line': ['error', 'multiline'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-first-prop-new-line.md
+      'react/jsx-first-prop-new-line': ['error', 'multiline'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-handler-names.md
-        'react/jsx-handler-names': ['error', { checkLocalVariables: true, eventHandlerPrefix: false }],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-handler-names.md
+      'react/jsx-handler-names': ['error', { checkLocalVariables: true, eventHandlerPrefix: false }],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-indent.md
-        'react/jsx-indent': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-indent.md
+      'react/jsx-indent': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-no-bind.md
-        'react/jsx-no-bind': ['error', { ignoreRefs: true, allowArrowFunctions: true }],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-no-bind.md
+      'react/jsx-no-bind': ['error', { ignoreRefs: true, allowArrowFunctions: true }],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-pascal-case.md
-        'react/jsx-pascal-case': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-pascal-case.md
+      'react/jsx-pascal-case': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-tag-spacing.md
-        'react/jsx-tag-spacing': ['error'],
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-tag-spacing.md
+      'react/jsx-tag-spacing': ['error'],
 
-        // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-wrap-multilines.md
-        'react/jsx-wrap-multilines': ['error'],
-      },
-      settings: {
-        react: {
-          version: 'detect',
-        },
-      },
+      // https://github.com/jsx-eslint/eslint-plugin-react/blob/master/docs/rules/jsx-wrap-multilines.md
+      'react/jsx-wrap-multilines': ['error'],
     },
-    // eslint-plugin-react-hooks
-    {
-      extends: [reactHooks.configs['recommended-latest']],
-      rules: {
-        // https://github.com/facebook/react/blob/main/packages/eslint-plugin-react-hooks/README.md#advanced-configuration
-        'react-hooks/exhaustive-deps': ['error', { additionalHooks: '^useAsync$' }],
+    settings: {
+      react: {
+        version: 'detect',
       },
     },
-    // typescript-eslint
-    {
-      rules: {
-        // https://typescript-eslint.io/rules/no-non-null-asserted-nullish-coalescing/
-        '@typescript-eslint/no-non-null-asserted-nullish-coalescing': ['error'],
-
-        // https://typescript-eslint.io/rules/no-useless-constructor/
-        '@typescript-eslint/no-useless-constructor': ['error'],
-
-        // https://typescript-eslint.io/rules/no-non-null-assertion
-        '@typescript-eslint/no-non-null-assertion': ['error'],
-
-        // Rules that require type information
-        ...(tsconfigRootDir
-          ? {
-              // https://typescript-eslint.io/rules/no-unnecessary-condition/
-              '@typescript-eslint/no-unnecessary-condition': ['error'],
-
-              // https://typescript-eslint.io/rules/require-await/
-              '@typescript-eslint/require-await': ['error'],
-            }
-          : {}),
-      },
+  },
+  // eslint-plugin-react-hooks
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-react-hooks]',
+    files: fileGlobs.react,
+    extends: [reactHooks.configs['recommended-latest']],
+    rules: {
+      // https://github.com/facebook/react/blob/main/packages/eslint-plugin-react-hooks/README.md#advanced-configuration
+      'react-hooks/exhaustive-deps': ['error', { additionalHooks: '^useAsync$' }],
     },
-    // @eslint-community/eslint-plugin-eslint-comments
-    {
-      extends: [
-        // @ts-expect-error This plugin's recommended rules don't quite match the type `tseslint.config` expects.
-        eslintComments.recommended,
-      ],
-      rules: {
-        // require a description for eslint control comments other than `eslint-enable`
-        '@eslint-community/eslint-comments/require-description': ['error', { ignore: ['eslint-enable'] }],
-      },
+  },
+  // @eslint-community/eslint-plugin-eslint-comments
+  {
+    name: 'scratch/allScriptRules[eslint-plugin-eslint-comments]',
+    extends: [
+      // @ts-expect-error This plugin's recommended rules don't quite match the type `tseslint.config` expects.
+      eslintComments.recommended,
+    ],
+    rules: {
+      // require a description for eslint control comments other than `eslint-enable`
+      '@eslint-community/eslint-comments/require-description': ['error', { ignore: ['eslint-enable'] }],
     },
-    // @eslint/js
-    {
-      rules: {
-        // https://eslint.org/docs/latest/rules/arrow-body-style
-        'arrow-body-style': ['error', 'as-needed'],
+  },
+  // @eslint/js
+  {
+    name: 'scratch/allScriptRules[@eslint/js]',
+    rules: {
+      // https://eslint.org/docs/latest/rules/arrow-body-style
+      'arrow-body-style': ['error', 'as-needed'],
+
+      // https://eslint.org/docs/latest/rules/no-duplicate-imports
+      'no-duplicate-imports': ['error'],
+
+      // https://eslint.org/docs/latest/rules/no-template-curly-in-string
+      'no-template-curly-in-string': ['error'],
 
-        // https://eslint.org/docs/latest/rules/no-duplicate-imports
-        'no-duplicate-imports': ['error'],
+      // https://eslint.org/docs/latest/rules/no-useless-computed-key
+      'no-useless-computed-key': ['error'],
 
-        // https://eslint.org/docs/latest/rules/no-template-curly-in-string
-        'no-template-curly-in-string': ['error'],
+      // https://eslint.org/docs/latest/rules/no-useless-rename
+      'no-useless-rename': ['error'],
 
-        // https://eslint.org/docs/latest/rules/no-useless-computed-key
-        'no-useless-computed-key': ['error'],
+      // https://eslint.org/docs/latest/rules/prefer-arrow-callback
+      'prefer-arrow-callback': ['error'],
 
-        // https://eslint.org/docs/latest/rules/no-useless-rename
-        'no-useless-rename': ['error'],
+      // https://eslint.org/docs/latest/rules/prefer-const#destructuring
+      'prefer-const': ['error'],
 
-        // https://eslint.org/docs/latest/rules/prefer-arrow-callback
-        'prefer-arrow-callback': ['error'],
+      // https://eslint.org/docs/latest/rules/prefer-spread
+      'prefer-spread': ['error'],
 
-        // https://eslint.org/docs/latest/rules/prefer-const#destructuring
-        'prefer-const': ['error'],
+      // https://eslint.org/docs/latest/rules/require-atomic-updates
+      'require-atomic-updates': ['error'],
 
-        // https://eslint.org/docs/latest/rules/prefer-spread
-        'prefer-spread': ['error'],
+      // https://eslint.org/docs/latest/rules/symbol-description
+      'symbol-description': ['error'],
+    },
+  },
+])
+
+/**
+ * Additional rules recommended when type information is not available or checked.
+ */
+const typeFreeRules = tseslint.config([
+  {
+    name: 'scratch/typeFreeRules[base]',
+    extends: [eslint.configs.recommended],
+  },
+  ...allScriptRules,
+  {
+    name: 'scratch/typeFreeRules[eslint-plugin-jsdoc]',
+    extends: [jsdoc.configs['flat/recommended-error']],
+    rules: {
+      // If JSDoc comments are present, they must be informative (non-trivial).
+      // For example, the description "The foo." on a variable called "foo" is not informative.
+      // https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/informative-docs.md
+      'jsdoc/informative-docs': ['error'],
+
+      // Don't require JSDoc comments. Library authors should consider turning this on for external interfaces.
+      // https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-jsdoc.md
+      'jsdoc/require-jsdoc': ['off'],
+    },
+  },
+])
+
+/**
+ * Rules recommended when type information is available and checked. This configuration turns off some rules with the
+ * assumption that other software, such as TypeScript, will flag those problems. For example, the `no-undef` rule is
+ * disabled in this configuration. These rules include `allScriptRules`.
+ * These rules require additional configuration.
+ * @see https://typescript-eslint.io/getting-started/typed-linting/
+ */
+const typeCheckedRules = tseslint.config([
+  {
+    name: 'scratch/typeCheckedRules[base]',
+    extends: [
+      eslint.configs.recommended,
+      tseslint.configs.recommendedTypeChecked,
+      tseslint.configs.stylisticTypeChecked,
+    ],
+    rules: {
+      // https://typescript-eslint.io/rules/no-unnecessary-condition/
+      '@typescript-eslint/no-unnecessary-condition': ['error'],
+
+      // https://typescript-eslint.io/rules/require-await/
+      '@typescript-eslint/require-await': ['error'],
+    },
+  },
+  ...allScriptRules,
+  {
+    name: 'scratch/typeCheckedRules[eslint-plugin-jsdoc][1]',
+    extends: [jsdoc.configs['flat/recommended-error']],
+  },
+  {
+    name: 'scratch/typeCheckedRules[eslint-plugin-jsdoc][2]',
+    extends: [jsdoc.configs['flat/recommended-typescript-error']],
+  },
+  {
+    name: 'scratch/typeCheckedRules[eslint-plugin-jsdoc][3]',
+    rules: {
+      // If JSDoc comments are present, they must be informative (non-trivial).
+      // For example, the description "The foo." on a variable called "foo" is not informative.
+      // https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/informative-docs.md
+      'jsdoc/informative-docs': ['error'],
+
+      // Don't require JSDoc comments. Library authors should consider turning this on for external interfaces.
+      // https://github.com/gajus/eslint-plugin-jsdoc/blob/main/docs/rules/require-jsdoc.md
+      'jsdoc/require-jsdoc': ['off'],
+    },
+  },
+  // typescript-eslint
+  {
+    name: 'scratch/typeCheckedRules[typescript-eslint]',
+    rules: {
+      // https://typescript-eslint.io/rules/no-non-null-asserted-nullish-coalescing/
+      '@typescript-eslint/no-non-null-asserted-nullish-coalescing': ['error'],
+
+      // https://typescript-eslint.io/rules/no-useless-constructor/
+      '@typescript-eslint/no-useless-constructor': ['error'],
+
+      // https://typescript-eslint.io/rules/no-non-null-assertion
+      '@typescript-eslint/no-non-null-assertion': ['error'],
+    },
+  },
+])
 
-        // https://eslint.org/docs/latest/rules/require-atomic-updates
-        'require-atomic-updates': ['error'],
+/**
+ * Scratch's recommended configuration when type information is not available.
+ */
+const recommendedTypeFree = tseslint.config(typeFreeRules, eslintConfigPrettier)
+
+/**
+ * Scratch's recommended configuration when type information is available.
+ * These rules require additional configuration.
+ * WARNING: These rules do not specify the `files` property.
+ * @see https://typescript-eslint.io/getting-started/typed-linting/
+ */
+const recommendedTypeChecked = tseslint.config(typeCheckedRules, eslintConfigPrettier)
 
-        // https://eslint.org/docs/latest/rules/symbol-description
-        'symbol-description': ['error'],
+/**
+ * Scratch's recommended configuration for general use.
+ * Type-checked rules are enabled for files with known TypeScript extensions.
+ * If your project includes such files, you must include additional configuration.
+ * @see https://typescript-eslint.io/getting-started/typed-linting/
+ */
+const recommended = tseslint.config(
+  {
+    name: 'scratch/recommended',
+  },
+  {
+    files: fileGlobs.allScript,
+    extends: [typeFreeRules],
+  },
+  {
+    files: fileGlobs.typeScript,
+    extends: [typeCheckedRules],
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
       },
     },
-    // Keep `eslintConfigPrettier` last to turn off rules that conflict with Prettier
-    eslintConfigPrettier,
-  )
-}
+  },
+  miscFileRules,
+  eslintConfigPrettier,
+)
+
+// Helper to get type hints while conveniently merging and extending configurations
+export { config } from 'typescript-eslint'
 
-export { makeEslintConfig }
+// Our exported configurations
+export { recommended, recommendedTypeChecked, recommendedTypeFree, miscFileRules, legacy }

package/lib/index.mjs

@@ -1,4 +1,4 @@
-import { makeEslintConfig } from './eslint.mjs'
-import { makePrettierConfig } from './prettier.mjs'
+import * as eslintConfigScratch from './eslint.mjs'
+import * as prettierConfigScratch from './prettier.mjs'
 
-export { makeEslintConfig, makePrettierConfig }
+export { eslintConfigScratch, prettierConfigScratch }

package/lib/legacy/{web.mjs → es6.mjs}

@@ -1,3 +1,4 @@
+/** @type {import('eslint').Linter.Config[]} */
 export default [
   {
     languageOptions: {

package/lib/legacy/index.mjs

@@ -14,6 +14,7 @@ const compat = new FlatCompat({
   allConfig: js.configs.all,
 })
 
+/** @type {import('eslint').Linter.Config[]} */
 export default [
   ...compat.extends('eslint:recommended'),
   jsdoc.configs['flat/recommended'],

package/lib/legacy/node.mjs

@@ -1,5 +1,6 @@
 import globals from 'globals'
 
+/** @type {import('eslint').Linter.Config[]} */
 export default [
   {
     languageOptions: {

package/lib/legacy/react.mjs

@@ -12,6 +12,7 @@ const compat = new FlatCompat({
   allConfig: js.configs.all,
 })
 
+/** @type {import('eslint').Linter.Config[]} */
 export default [
   ...compat.extends('plugin:react/recommended'),
   {

package/lib/prettier.mjs

@@ -4,7 +4,7 @@ import sortImports from '@trivago/prettier-plugin-sort-imports'
  * @see https://prettier.io/docs/configuration
  * @type {import("prettier").Config}
  */
-const prettierConfig = {
+const recommended = {
   // #region Prettier
   arrowParens: 'avoid',
   bracketSameLine: false,
@@ -22,10 +22,4 @@ const prettierConfig = {
   // #endregion @trivago/prettier-plugin-sort-imports
 }
 
-/**
- * Make a Prettier configuration for Scratch style.
- * @returns {import("prettier").Config}
- */
-const makePrettierConfig = () => prettierConfig
-
-export { makePrettierConfig }
+export { recommended }