@plugjs/eslint-plugin 0.3.43 → 0.5.0

package/NOTICE.md

@@ -1,4 +1,4 @@
-# Copyright 2022 Juit GmbH
+# Copyright 2022-2025 Juit GmbH
 
 Licensed under the Apache License, Version 2.0 (the "License");
 you may not use this file except in compliance with the License.

package/README.md

@@ -1,52 +1,110 @@
 PlugJS ESLint (v9) Shared Configuration
 =======================================
 
-This package exports simple configurations for linting our projects. It's the
-easiest way to actually share some configs and plugins.
+Provides shared ESLint v9 flat-config presets for PlugJS projects. It’s the
+easiest way to share consistent rules and plugins across repos.
 
-Just add in your `eslint.config.mjs` something similar to:
+* [Quick Setup](#quick-setup)
+* [Configurations](#configurations)
+* [CLI Utility](#cli-utility)
+* [Legal Stuff](#legal-stuff)
+
+
+Quick Setup
+-----------
+
+Just create a new `eslint.config.mjs` file following this template, your mileage
+might vary, and according to your specific needs you might need to add/remove
+stuff to fit your project:
 
 ```javascript
 import configurations from '@plugjs/eslint-plugin'
 
 export default [
   ...configurations,
-  // any other configuration you might want to add for your project...
+
+  // ===== DEFINE THE LOCATION OF OUR TSCONFIG.JSON FILES ======================
+  {
+    languageOptions: {
+      parserOptions: {
+        createDefaultProgram: false,
+        project: [
+          './tsconfig.json',
+          './test/tsconfig.json',
+        ],
+      },
+    },
+  },
+
+  // ===== ENSURE THAT OUR MAIN FILES DEPEND ONLY ON PROPER DEPENDENCIES =======
+  {
+    files: [ 'src/**' ],
+    rules: {
+      // Turn _ON_ dependencies checks only for sources
+      'import-x/no-extraneous-dependencies': [ 'error', {
+        'devDependencies': false,
+        'optionalDependencies': false,
+        'peerDependencies': true,
+        'bundledDependencies': false,
+      } ],
+    },
+  },
+
+  // ===== PROJECT LOCAL RULES =================================================
+  // Add any extra rule not tied to a specific "files" pattern here, e.g.:
+  // {
+  //   rules: {
+  //     'camelcase': 'off',
+  //   },
+  // },
+
+  // ===== IGNORED FILES =======================================================
+  // REMEMBER! Ignores *must* be in its own configuration, they can not coexist
+  // with "rules", "languageOptions", "files", ... or anything else (ESLint v9
+  // flat config). Otherwise ESLint will blatantly ignore the ignored files!
+  {
+    ignores: [
+      'coverage/',
+      'dist/',
+      'node_modules/',
+    ],
+  },
 ]
 ```
 
-This includes a number of configurations:
 
-* `eslint-recommended`: recommended JavaScript config from ESLint.
+Configurations
+--------------
+
+This includes a number of individual configurations:
+
+* `plugjs/basic/base`: basic configuration of ESLint rules.
+* `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+* `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+* `plugjs/basic/importx`: defines the style of our imports.
 
-* `plugjs-base`: basic configuration of ESLint rules.
-* `plugjs-stylistic`: style shared between JavaScript and TypeScript.
-* `plugjs-unicorn`: extra niceties from the ESLint Unicorn plugin.
-* `plugjs-importx`: defines the style of our imports.
+* `plugjs/javascript/shared`: shared configuration for JavaScript files.
+* `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
 
-* `plugjs-javascript`: basic extra rules for JavaScript sources.
-* `plugjs-javascript-cjs`: marks `*.cjs` files as `commonjs`.
-* `plugjs-javascript-mjs`: marks `*.mjs` files as `module`.
+* `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+* `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+* `plugjs/typescript/options`: configuration for "@typescript-eslint".
+* `plugjs/typescript/overrides`: our rules overriding recommended.
 
-* `typescript-eslint/recommended`: imports all the configurations from
-  TypeScript ESlint recommended, but restrict them to operate only on
-  `.ts`, `.cts`, and `.mts` files. This *should* include:
-  * `typescript-eslint/base`: basic parser configuration.
-  * `typescript-eslint/eslint-recommended`: disable ESLint rules conflicting
-    with TypeScript.
-  * `typescript-eslint/recommended`: recommended config for TypeScript
-* `plugjs-typescript`: our rules overriding `typescript-eslint/recommended`.
+A set of grouped configurations are also available:
 
-Notes on building
------------------
+* `plugjs/basic`: basic rules shared between JavaScript and TypeScript.
+  * includes all `plugjs/basic/...` individual configurations
+* `plugjs/javascript`: rules specific to JavaScript code bases.
+  * includes all `plugjs/javascript/...` individual configurations
+* `plugjs/typescript`: rules specific to TypeScript code bases.
+  * includes all `plugjs/typescript/...` individual configurations _and_...
+  * ...other rules from `typescript-eslint/recommended`: all other recommended
+    Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
 
-During this transitional period (ESLint from v8 to v9, and TypeScript ESLint
-from v7 to v8) a number of plugins, even if they are working, are specifying
-wrong/old dependencies in their packages.
+The default configuration exported by the plugin includes all the configurations
+listed above _and_ the base `eslint/js/recommended` configuration from ESLint.
 
-For those plugins, we bundle them up and ship them with this plugin, and
-hopefully we'll be able to un-bundle them as the various packages move in their
-transitions.
 
 Legal Stuff
 -----------

package/dist/basic.d.ts

@@ -0,0 +1,22 @@
+import type { ESLintConfig } from '.';
+/** Basic configuration of ESLint rules. */
+export declare const base: ESLintConfig<'plugjs/basic/base'>;
+/** Style shared between JavaScript and TypeScript. */
+export declare const stylistic: ESLintConfig<'plugjs/basic/stylistic'>;
+/** Extra niceties from the ESLint Unicorn plugin. */
+export declare const unicorn: ESLintConfig<'plugjs/basic/unicorn'>;
+/** Defines the style of our imports. */
+export declare const importx: ESLintConfig<'plugjs/basic/importx'>;
+/**
+ * Base module: declares all the common rules shared between JavaScript and
+ * TypeScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/basic/base`: basic configuration of ESLint rules.
+ * * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ * * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ * * `plugjs/basic/importx`: defines the style of our imports.
+ */
+declare const _default: readonly [ESLintConfig<"plugjs/basic/base">, ESLintConfig<"plugjs/basic/stylistic">, ESLintConfig<"plugjs/basic/unicorn">, ESLintConfig<"plugjs/basic/importx">];
+export default _default;

package/dist/basic.js

@@ -0,0 +1,170 @@
+import stylisticPlugin from '@stylistic/eslint-plugin';
+import importxPlugin from 'eslint-plugin-import-x';
+import unicornPlugin from 'eslint-plugin-unicorn';
+import globals from 'globals';
+/* ========================================================================== */
+/** Basic configuration of ESLint rules. */
+export const base = {
+    name: 'plugjs/basic/base',
+    languageOptions: {
+        globals: globals.es2024,
+    },
+    rules: {
+        'camelcase': ['error', {
+                properties: 'never',
+            }],
+        'curly': ['error', 'multi-line'],
+        'new-cap': 'error',
+        'no-caller': 'error',
+        'no-cond-assign': 'off', // overrides eslint recommended
+        'no-console': 'warn',
+        'no-debugger': 'warn',
+        'no-extend-native': 'error',
+        'no-extra-bind': 'error',
+        'no-multi-str': 'error',
+        'no-new-native-nonconstructor': 'error',
+        'no-new-wrappers': 'error',
+        'no-object-constructor': 'error',
+        'no-template-curly-in-string': 'error',
+        'no-throw-literal': 'error',
+        'no-useless-concat': 'error',
+        'no-var': 'error',
+        'no-warning-comments': 'warn',
+        'one-var': ['error', 'never'],
+        'prefer-const': ['error', {
+                destructuring: 'all',
+            }],
+        'prefer-promise-reject-errors': 'error',
+        'prefer-rest-params': 'error',
+        'prefer-spread': 'error',
+    },
+};
+/* ========================================================================== */
+/** Style shared between JavaScript and TypeScript. */
+export const stylistic = {
+    name: 'plugjs/basic/stylistic',
+    plugins: {
+        '@stylistic': stylisticPlugin,
+    },
+    rules: {
+        '@stylistic/array-bracket-newline': 'off',
+        '@stylistic/array-bracket-spacing': ['error', 'always'],
+        '@stylistic/arrow-parens': ['error', 'always'],
+        '@stylistic/block-spacing': ['error', 'always'],
+        '@stylistic/brace-style': 'error',
+        '@stylistic/comma-dangle': ['error', 'always-multiline'],
+        '@stylistic/comma-spacing': 'error',
+        '@stylistic/comma-style': 'error',
+        '@stylistic/computed-property-spacing': 'error',
+        '@stylistic/eol-last': ['error', 'always'],
+        '@stylistic/function-call-spacing': 'error',
+        '@stylistic/generator-star-spacing': ['error', 'after'],
+        '@stylistic/indent': ['error', 2, {
+                CallExpression: {
+                    'arguments': 2,
+                },
+                FunctionDeclaration: {
+                    'body': 1,
+                    'parameters': 2,
+                },
+                FunctionExpression: {
+                    'body': 1,
+                    'parameters': 2,
+                },
+                MemberExpression: 2,
+                ObjectExpression: 1,
+                SwitchCase: 1,
+                flatTernaryExpressions: true,
+                offsetTernaryExpressions: false,
+            }],
+        '@stylistic/key-spacing': 'error',
+        '@stylistic/keyword-spacing': 'error',
+        '@stylistic/linebreak-style': 'error',
+        '@stylistic/no-mixed-spaces-and-tabs': 'error',
+        '@stylistic/no-multi-spaces': 'error',
+        '@stylistic/no-multiple-empty-lines': ['error', { 'max': 2, 'maxBOF': 0, 'maxEOF': 1 }],
+        '@stylistic/no-tabs': 'error',
+        '@stylistic/no-trailing-spaces': 'error',
+        '@stylistic/object-curly-spacing': ['error', 'always'],
+        '@stylistic/operator-linebreak': ['error', 'after', {
+                'overrides': {
+                    '?': 'ignore',
+                    ':': 'ignore',
+                    '|': 'before',
+                    '&': 'before',
+                },
+            }],
+        '@stylistic/padded-blocks': ['error', 'never'],
+        '@stylistic/quote-props': ['error', 'consistent'],
+        '@stylistic/quotes': ['error', 'single', { 'allowTemplateLiterals': 'never' }],
+        '@stylistic/semi': ['error', 'never'],
+        '@stylistic/semi-spacing': 'error',
+        '@stylistic/space-before-blocks': 'error',
+        '@stylistic/space-before-function-paren': ['error', {
+                asyncArrow: 'always',
+                anonymous: 'never',
+                named: 'never',
+            }],
+        '@stylistic/spaced-comment': ['error', 'always', { 'markers': ['/ <reference'] }],
+        '@stylistic/switch-colon-spacing': 'error',
+        '@stylistic/rest-spread-spacing': 'error',
+        '@stylistic/yield-star-spacing': ['error', 'after'],
+    },
+};
+/* ========================================================================== */
+/** Extra niceties from the ESLint Unicorn plugin. */
+export const unicorn = {
+    name: 'plugjs/basic/unicorn',
+    plugins: {
+        'unicorn': unicornPlugin,
+    },
+    rules: {
+        'unicorn/empty-brace-spaces': 'error',
+        'unicorn/no-instanceof-builtins': 'error',
+        'unicorn/prefer-node-protocol': 'error',
+    },
+};
+/* ========================================================================== */
+/** Defines the style of our imports. */
+export const importx = {
+    name: 'plugjs/basic/importx',
+    plugins: {
+        'import-x': importxPlugin,
+    },
+    settings: {
+        'import-x/extensions': ['.ts', '.cts', '.mts', '.js', '.cjs', '.mjs'],
+        'import-x/external-module-folders': ['node_modules', 'node_modules/@types'],
+        'import-x/parsers': {
+            '@typescript-eslint/parser': ['.ts', '.cts', '.mts'],
+            'espree': ['.js', '.mjs', '.cjs'],
+        },
+        'import-x/resolver': {
+            'eslint-import-resolver-typescript': true,
+            'eslint-import-resolver-node': true,
+        },
+    },
+    rules: {
+        'import-x/consistent-type-specifier-style': ['error', 'prefer-top-level'],
+        'import-x/no-cycle': ['error'],
+        'import-x/no-duplicates': ['error'],
+        'import-x/no-extraneous-dependencies': ['off'],
+        'import-x/order': ['error', {
+                'groups': ['builtin', 'external', 'internal', ['parent', 'sibling'], 'index', 'object', 'type'],
+                'newlines-between': 'always',
+                'warnOnUnassignedImports': true,
+            }],
+    },
+};
+/* ========================================================================== */
+/**
+ * Base module: declares all the common rules shared between JavaScript and
+ * TypeScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/basic/base`: basic configuration of ESLint rules.
+ * * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ * * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ * * `plugjs/basic/importx`: defines the style of our imports.
+ */
+export default [base, stylistic, unicorn, importx];

package/dist/check.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/check.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+import { ESLint } from 'eslint';
+/** @type Record<string, string[]> */
+const deprecated = {};
+// Pretty colors
+const ylw = '\u001b[38;5;220m'; // yellow
+const grn = '\u001b[38;5;76m'; // greenish
+const rst = '\u001b[0m'; // reset
+// Running in GitHub Actions?
+const gh = process.env.GITHUB_ACTIONS === 'true';
+// Files to probe to surface deprecations across JS/TS variants
+const FILES = ['x.js', 'x.mjs', 'x.cjs', 'x.ts', 'x.cts', 'x.mts'];
+// Create a new ESLint
+const eslint = new ESLint();
+// Fake lint some sources (JS, TS, ...) to get the deprecated rules
+for (const f of FILES) {
+    const results = await eslint.lintText('var foo="bar";', { filePath: f });
+    for (const result of results) {
+        for (const rule of result.usedDeprecatedRules) {
+            deprecated[rule.ruleId] = rule.replacedBy;
+        }
+    }
+}
+// Print the deprecated rules in order
+const deprecations = Object.entries(deprecated);
+if (deprecations.length !== 0) {
+    deprecations
+        .sort(([a], [b]) => a.localeCompare(b))
+        .forEach(([rule, replacement]) => {
+        if (replacement.length) {
+            console.log(`Rule "${ylw}${rule}${rst}" deprecated and replaced by "${grn}${replacement.join(`${rst}", "${grn}`)}${rst}"`);
+            if (gh)
+                console.log(`::warning::Rule "${rule}" deprecated and replaced by "${replacement.join(', ')}"`);
+        }
+        else {
+            console.log(`Rule "${ylw}${rule}${rst}" deprecated without replacement`);
+            if (gh)
+                console.log(`::warning::Rule "${rule}" deprecated without replacement`);
+        }
+    });
+}
+else {
+    console.log(`${grn}Success:${rst} no deprecated rules found!`);
+}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import type { TSESLint } from '@typescript-eslint/utils';
+/** A _named_ ESLint configuration. */
+export type ESLintConfig<N extends string = string> = {
+    readonly name: N;
+} & TSESLint.FlatConfig.Config;
+/** All ESLint configurations. */
+export declare const configs: {
+    readonly basic: readonly [ESLintConfig<"plugjs/basic/base">, ESLintConfig<"plugjs/basic/stylistic">, ESLintConfig<"plugjs/basic/unicorn">, ESLintConfig<"plugjs/basic/importx">];
+    readonly 'basic/base': ESLintConfig<"plugjs/basic/base">;
+    readonly 'basic/stylistic': ESLintConfig<"plugjs/basic/stylistic">;
+    readonly 'basic/unicorn': ESLintConfig<"plugjs/basic/unicorn">;
+    readonly 'basic/importx': ESLintConfig<"plugjs/basic/importx">;
+    readonly javascript: readonly [ESLintConfig<"plugjs/javascript/shared">, ESLintConfig<"plugjs/javascript/commonjs">, ESLintConfig<"plugjs/javascript/modules">];
+    readonly 'javascript/shared': ESLintConfig<"plugjs/javascript/shared">;
+    readonly 'javascript/commonjs': ESLintConfig<"plugjs/javascript/commonjs">;
+    readonly 'javascript/modules': ESLintConfig<"plugjs/javascript/modules">;
+    readonly typescript: readonly [ESLintConfig<"plugjs/typescript/plugin">, ESLintConfig<"plugjs/typescript/options">, ...ESLintConfig[], ESLintConfig<"plugjs/typescript/overrides">];
+    readonly 'typescript/plugin': ESLintConfig<"plugjs/typescript/plugin">;
+    readonly 'typescript/options': ESLintConfig<"plugjs/typescript/options">;
+    readonly 'typescript/overrides': ESLintConfig<"plugjs/typescript/overrides">;
+};
+/**
+ * The default ESLint configuration for PlugJS.
+ *
+ * This includes all the configurations from:
+ *
+ * * `eslint/js/recommended`: the base ESLint recommended rules for JavaScript.
+ * * `plugjs/basic`: basic rules shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/base`: basic configuration of ESLint rules.
+ *   * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ *   * `plugjs/basic/importx`: defines the style of our imports.
+ * * `plugjs/javascript`: rules specific to JavaScript code bases.
+ *   * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ *   * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ *   * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ * * `plugjs/typescript`: rules specific to TypeScript code bases.
+ *   * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ *   * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ *   * other rules from `typescript-eslint/recommended`: all other recommended
+ *     Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ *   * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+declare const _default: readonly [ESLintConfig<"eslint/js/recommended">, ESLintConfig<"plugjs/basic/base">, ESLintConfig<"plugjs/basic/stylistic">, ESLintConfig<"plugjs/basic/unicorn">, ESLintConfig<"plugjs/basic/importx">, ESLintConfig<"plugjs/javascript/shared">, ESLintConfig<"plugjs/javascript/commonjs">, ESLintConfig<"plugjs/javascript/modules">, ESLintConfig<"plugjs/typescript/plugin">, ESLintConfig<"plugjs/typescript/options">, ...ESLintConfig[], ESLintConfig<"plugjs/typescript/overrides">];
+export default _default;

package/dist/index.js

@@ -0,0 +1,59 @@
+import js from '@eslint/js';
+import basicConfigs, * as basic from './basic.js';
+import javascriptConfigs, * as javascript from './javascript.js';
+import typescriptConfigs, * as typescript from './typescript.js';
+/* ========================================================================== *
+ * INTERNAL                                                                   *
+ * ========================================================================== */
+/* Give the "eslint/js/recommended" a name so that it shows up in the GUI */
+const initial = {
+    name: 'eslint/js/recommended',
+    ...js.configs.recommended,
+};
+/* ========================================================================== *
+* EXPORTS                                                                    *
+ * ========================================================================== */
+/** All ESLint configurations. */
+export const configs = {
+    'basic': basicConfigs,
+    'basic/base': basic.base,
+    'basic/stylistic': basic.stylistic,
+    'basic/unicorn': basic.unicorn,
+    'basic/importx': basic.importx,
+    'javascript': javascriptConfigs,
+    'javascript/shared': javascript.shared,
+    'javascript/commonjs': javascript.commonjs,
+    'javascript/modules': javascript.modules,
+    'typescript': typescriptConfigs,
+    'typescript/plugin': typescript.plugin,
+    'typescript/options': typescript.options,
+    'typescript/overrides': typescript.overrides,
+};
+/**
+ * The default ESLint configuration for PlugJS.
+ *
+ * This includes all the configurations from:
+ *
+ * * `eslint/js/recommended`: the base ESLint recommended rules for JavaScript.
+ * * `plugjs/basic`: basic rules shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/base`: basic configuration of ESLint rules.
+ *   * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ *   * `plugjs/basic/importx`: defines the style of our imports.
+ * * `plugjs/javascript`: rules specific to JavaScript code bases.
+ *   * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ *   * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ *   * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ * * `plugjs/typescript`: rules specific to TypeScript code bases.
+ *   * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ *   * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ *   * other rules from `typescript-eslint/recommended`: all other recommended
+ *     Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ *   * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+export default [
+    initial,
+    ...basicConfigs,
+    ...javascriptConfigs,
+    ...typescriptConfigs,
+];

package/dist/javascript.d.ts

@@ -0,0 +1,18 @@
+import type { ESLintConfig } from '.';
+/** Shared configuration for JavaScript files (CommonJS or ES modules). */
+export declare const shared: ESLintConfig<'plugjs/javascript/shared'>;
+/** Marks `*.cjs` files as `commonjs`. */
+export declare const commonjs: ESLintConfig<'plugjs/javascript/commonjs'>;
+/** Marks `*.mjs` files as `module`. */
+export declare const modules: ESLintConfig<'plugjs/javascript/modules'>;
+/**
+ * JavaScript module: declares all the common rules for JavaScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ * * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ * * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ */
+declare const _default: readonly [ESLintConfig<"plugjs/javascript/shared">, ESLintConfig<"plugjs/javascript/commonjs">, ESLintConfig<"plugjs/javascript/modules">];
+export default _default;

package/dist/javascript.js

@@ -0,0 +1,80 @@
+/** Basic extra rules for JavaScript sources. */
+import fs from 'node:fs';
+import path from 'node:path';
+import process from 'node:process';
+import globals from 'globals';
+/* ========================================================================== *
+ * INTERNALS                                                                  *
+ * ========================================================================== */
+function findModuleType(directory) {
+    const file = path.join(directory, 'package.json');
+    try {
+        const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
+        return data.type || 'commonjs';
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw new Error(`Error reading "${file}"`, { cause: error });
+        }
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return 'commonjs';
+        return findModuleType(parent);
+    }
+}
+const moduleType = findModuleType(process.cwd());
+/* ========================================================================== *
+ * CONFIGS                                                                    *
+ * ========================================================================== */
+/** Shared configuration for JavaScript files (CommonJS or ES modules). */
+export const shared = {
+    name: 'plugjs/javascript/shared',
+    files: ['**/*.js', '**/*.cjs', '**/*.mjs'],
+    rules: {
+        'guard-for-in': 'error',
+        'no-array-constructor': 'error',
+        'no-invalid-this': 'error',
+        'no-unused-expressions': 'error',
+        'no-unused-vars': ['error', {
+                args: 'after-used',
+                argsIgnorePattern: '^_',
+            }],
+    },
+};
+/* ========================================================================== */
+/** Marks `*.cjs` files as `commonjs`. */
+export const commonjs = {
+    name: 'plugjs/javascript/commonjs',
+    files: moduleType === 'commonjs' ? ['**/*.cjs', '**/*.js'] : ['**/*.cjs'],
+    languageOptions: {
+        sourceType: 'commonjs',
+        globals: globals.node,
+    },
+    rules: {
+        'strict': ['error', 'global'],
+    },
+};
+/* ========================================================================== */
+/** Marks `*.mjs` files as `module`. */
+export const modules = {
+    name: 'plugjs/javascript/modules',
+    files: moduleType === 'module' ? ['**/*.mjs', '**/*.js'] : ['**/*.mjs'],
+    languageOptions: {
+        sourceType: 'module',
+        globals: globals.nodeBuiltin,
+    },
+    rules: {
+        'strict': ['error', 'never'],
+    },
+};
+/* ========================================================================== */
+/**
+ * JavaScript module: declares all the common rules for JavaScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ * * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ * * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ */
+export default [shared, commonjs, modules];

package/dist/typescript.d.ts

@@ -0,0 +1,20 @@
+import type { ESLintConfig } from './index';
+/** Define the "@typescript-eslint" plugin. */
+export declare const plugin: ESLintConfig<'plugjs/typescript/plugin'>;
+/** Configuration for "@typescript-eslint" scoped to TypeScript sources. */
+export declare const options: ESLintConfig<'plugjs/typescript/options'>;
+/** Our own rules overriding `typescript-eslint/recommended`. */
+export declare const overrides: ESLintConfig<'plugjs/typescript/overrides'>;
+/**
+ * TypeScript module: declares all the common rules for TypeScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ * * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ * * other rules from `typescript-eslint/recommended`: all other recommended
+ *   Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ * * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+declare const _default: readonly [ESLintConfig<"plugjs/typescript/plugin">, ESLintConfig<"plugjs/typescript/options">, ...ESLintConfig[], ESLintConfig<"plugjs/typescript/overrides">];
+export default _default;

package/dist/typescript.js

@@ -0,0 +1,71 @@
+import tseslint from 'typescript-eslint';
+/* ========================================================================== *
+ * INTERNALS                                                                  *
+ * ========================================================================== */
+/**
+ * Split the "base" config from "typescript-eslint" into its plugin definition
+ * and the rest of the config (namely, the language options). We'll want to
+ * apply the plugin **globally** so that all configs can use it, but the
+ * language options only to TypeScript files.
+ */
+const { plugins, ...opts } = tseslint.configs.base;
+/** Map the "typescript-eslint" recommended configs */
+const configs = tseslint.configs.recommended.map((config) => {
+    // Allow the "@typescript-eslint" plugin to be visible everywhere...
+    if (config.name === tseslint.configs.base.name)
+        return null;
+    config.files = ['**/*.ts', '**/*.cts', '**/*.mts'];
+    return config;
+}).filter((config) => !!config);
+/* ========================================================================== *
+ * CONFIGS                                                                    *
+ * ========================================================================== */
+/** Define the "@typescript-eslint" plugin. */
+export const plugin = {
+    name: 'plugjs/typescript/plugin',
+    plugins,
+};
+/* ========================================================================== */
+/** Configuration for "@typescript-eslint" scoped to TypeScript sources. */
+export const options = {
+    ...opts,
+    files: ['**/*.ts', '**/*.cts', '**/*.mts'],
+    name: 'plugjs/typescript/options',
+};
+/* ========================================================================== */
+/** Our own rules overriding `typescript-eslint/recommended`. */
+export const overrides = {
+    name: 'plugjs/typescript/overrides',
+    files: ['**/*.ts', '**/*.cts', '**/*.mts'],
+    rules: {
+        'no-unused-vars': 'off', // overrides ESLint Recommended for TypeScript
+        'no-dupe-class-members': 'off', // overrides ESLint Recommended for TypeScript
+        '@typescript-eslint/consistent-type-imports': 'error',
+        '@typescript-eslint/explicit-function-return-type': ['error', {
+                allowExpressions: true,
+                allowDirectConstAssertionInArrowFunctions: true,
+                allowConciseArrowFunctionExpressionsStartingWithVoid: true,
+            }],
+        '@typescript-eslint/no-dupe-class-members': 'error',
+        '@typescript-eslint/no-empty-object-type': 'off',
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-floating-promises': 'error',
+        '@typescript-eslint/no-invalid-this': 'error',
+        '@typescript-eslint/no-unused-vars': ['error', {
+                args: 'after-used',
+                argsIgnorePattern: '^_',
+            }],
+    },
+};
+/**
+ * TypeScript module: declares all the common rules for TypeScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ * * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ * * other rules from `typescript-eslint/recommended`: all other recommended
+ *   Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ * * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+export default [plugin, options, ...configs, overrides];

package/package.json

@@ -1,16 +1,29 @@
 {
   "name": "@plugjs/eslint-plugin",
-  "version": "0.3.43",
+  "version": "0.5.0",
   "description": "Shared ESLint configurations and extras",
-  "main": "./index.mjs",
   "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
   "author": "Team Juit <developers@juit.com>",
   "license": "Apache-2.0",
+  "bin": {
+    "eslint-check-deprecated-rules": "./dist/check.js"
+  },
   "scripts": {
-    "build": "node check.mjs && eslint"
+    "build": "./build.sh"
   },
   "dependencies": {
-    "@eslint/js": "^9.34.0",
+    "@eslint/js": "^9.35.0",
     "@stylistic/eslint-plugin": "^5.3.1",
     "eslint-import-resolver-node": "^0.3.9",
     "eslint-import-resolver-typescript": "^4.4.4",
@@ -20,15 +33,18 @@
     "typescript-eslint": "^8.42.0"
   },
   "devDependencies": {
-    "eslint": "^9.34.0"
+    "@types/node": "^24.3.1",
+    "eslint": "^9.35.0",
+    "type-fest": "^4.41.0",
+    "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "eslint": "^9.34.0"
+    "eslint": "^9.35.0"
   },
   "files": [
     "*.md",
-    "configs/",
-    "index.mjs"
+    "dist/",
+    "src/"
   ],
   "repository": {
     "type": "git",

package/{configs/basic.mjs → src/basic.ts}

@@ -3,11 +3,13 @@ import importxPlugin from 'eslint-plugin-import-x'
 import unicornPlugin from 'eslint-plugin-unicorn'
 import globals from 'globals'
 
+import type { ESLintConfig } from '.'
+
 /* ========================================================================== */
 
 /** Basic configuration of ESLint rules. */
-export const base = {
-  name: 'plugjs-base',
+export const base: ESLintConfig<'plugjs/basic/base'> = {
+  name: 'plugjs/basic/base',
 
   languageOptions: {
     globals: globals.es2024,
@@ -48,8 +50,8 @@ export const base = {
 /* ========================================================================== */
 
 /** Style shared between JavaScript and TypeScript. */
-export const stylistic = {
-  name: 'plugjs-stylistic',
+export const stylistic: ESLintConfig<'plugjs/basic/stylistic'> = {
+  name: 'plugjs/basic/stylistic',
 
   plugins: {
     '@stylistic': stylisticPlugin,
@@ -124,8 +126,8 @@ export const stylistic = {
 /* ========================================================================== */
 
 /** Extra niceties from the ESLint Unicorn plugin. */
-export const unicorn = {
-  name: 'plugjs-unicorn',
+export const unicorn: ESLintConfig<'plugjs/basic/unicorn'> = {
+  name: 'plugjs/basic/unicorn',
 
   plugins: {
     'unicorn': unicornPlugin,
@@ -141,8 +143,8 @@ export const unicorn = {
 /* ========================================================================== */
 
 /** Defines the style of our imports. */
-export const importx = {
-  name: 'plugjs-importx',
+export const importx: ESLintConfig<'plugjs/basic/importx'> = {
+  name: 'plugjs/basic/importx',
 
   plugins: {
     'import-x': importxPlugin,
@@ -182,9 +184,9 @@ export const importx = {
  *
  * This module includes these configurations:
  *
- * * `plugjs-base`: basic configuration of ESLint rules.
- * * `plugjs-stylistic`: style shared between JavaScript and TypeScript.
- * * `plugjs-unicorn`: extra niceties from the ESLint Unicorn plugin.
- * * `plugjs-importx`: defines the style of our imports.
+ * * `plugjs/basic/base`: basic configuration of ESLint rules.
+ * * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ * * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ * * `plugjs/basic/importx`: defines the style of our imports.
  */
-export default [ base, stylistic, unicorn, importx ]
+export default [ base, stylistic, unicorn, importx ] as const

package/src/check.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+/* eslint-disable no-console */
+import { ESLint } from 'eslint'
+
+/** @type Record<string, string[]> */
+const deprecated: Record<string, string[]> = {}
+
+// Pretty colors
+const ylw = '\u001b[38;5;220m' // yellow
+const grn = '\u001b[38;5;76m' // greenish
+const rst = '\u001b[0m' // reset
+// Running in GitHub Actions?
+const gh = process.env.GITHUB_ACTIONS === 'true'
+
+// Files to probe to surface deprecations across JS/TS variants
+const FILES = [ 'x.js', 'x.mjs', 'x.cjs', 'x.ts', 'x.cts', 'x.mts' ]
+
+// Create a new ESLint
+const eslint = new ESLint()
+
+// Fake lint some sources (JS, TS, ...) to get the deprecated rules
+for (const f of FILES) {
+  const results = await eslint.lintText('var foo="bar";', { filePath: f })
+  for (const result of results) {
+    for (const rule of result.usedDeprecatedRules) {
+      deprecated[rule.ruleId] = rule.replacedBy
+    }
+  }
+}
+
+// Print the deprecated rules in order
+const deprecations = Object.entries(deprecated)
+if (deprecations.length !== 0) {
+  deprecations
+      .sort(([ a ], [ b ]) => a.localeCompare(b))
+      .forEach(([ rule, replacement ]) => {
+        if (replacement.length) {
+          console.log(`Rule "${ylw}${rule}${rst}" deprecated and replaced by "${grn}${replacement.join(`${rst}", "${grn}`)}${rst}"`)
+          if (gh) console.log(`::warning::Rule "${rule}" deprecated and replaced by "${replacement.join(', ')}"`)
+        } else {
+          console.log(`Rule "${ylw}${rule}${rst}" deprecated without replacement`)
+          if (gh) console.log(`::warning::Rule "${rule}" deprecated without replacement`)
+        }
+      })
+} else {
+  console.log(`${grn}Success:${rst} no deprecated rules found!`)
+}

package/src/index.ts

@@ -0,0 +1,78 @@
+import js from '@eslint/js'
+
+import basicConfigs, * as basic from './basic.js'
+import javascriptConfigs, * as javascript from './javascript.js'
+import typescriptConfigs, * as typescript from './typescript.js'
+
+import type { TSESLint } from '@typescript-eslint/utils'
+
+/* ========================================================================== *
+ * TYPES                                                                      *
+ * ========================================================================== */
+
+/** A _named_ ESLint configuration. */
+export type ESLintConfig<N extends string = string> = {
+  readonly name: N
+} & TSESLint.FlatConfig.Config
+
+/* ========================================================================== *
+ * INTERNAL                                                                   *
+ * ========================================================================== */
+
+/* Give the "eslint/js/recommended" a name so that it shows up in the GUI */
+const initial: ESLintConfig<'eslint/js/recommended'> = { // give a name to this config before we go completely nuts!
+  name: 'eslint/js/recommended',
+  ...js.configs.recommended,
+}
+
+/* ========================================================================== *
+* EXPORTS                                                                    *
+ * ========================================================================== */
+
+/** All ESLint configurations. */
+export const configs = {
+  'basic': basicConfigs,
+  'basic/base': basic.base,
+  'basic/stylistic': basic.stylistic,
+  'basic/unicorn': basic.unicorn,
+  'basic/importx': basic.importx,
+
+  'javascript': javascriptConfigs,
+  'javascript/shared': javascript.shared,
+  'javascript/commonjs': javascript.commonjs,
+  'javascript/modules': javascript.modules,
+
+  'typescript': typescriptConfigs,
+  'typescript/plugin': typescript.plugin,
+  'typescript/options': typescript.options,
+  'typescript/overrides': typescript.overrides,
+} as const
+
+/**
+ * The default ESLint configuration for PlugJS.
+ *
+ * This includes all the configurations from:
+ *
+ * * `eslint/js/recommended`: the base ESLint recommended rules for JavaScript.
+ * * `plugjs/basic`: basic rules shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/base`: basic configuration of ESLint rules.
+ *   * `plugjs/basic/stylistic`: style shared between JavaScript and TypeScript.
+ *   * `plugjs/basic/unicorn`: extra niceties from the ESLint Unicorn plugin.
+ *   * `plugjs/basic/importx`: defines the style of our imports.
+ * * `plugjs/javascript`: rules specific to JavaScript code bases.
+ *   * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ *   * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ *   * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ * * `plugjs/typescript`: rules specific to TypeScript code bases.
+ *   * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ *   * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ *   * other rules from `typescript-eslint/recommended`: all other recommended
+ *     Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ *   * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+export default [
+  initial,
+  ...basicConfigs,
+  ...javascriptConfigs,
+  ...typescriptConfigs,
+] as const

package/src/javascript.ts

@@ -0,0 +1,101 @@
+/** Basic extra rules for JavaScript sources. */
+import fs from 'node:fs'
+import path from 'node:path'
+import process from 'node:process'
+
+import globals from 'globals'
+
+import type { ESLintConfig } from '.'
+
+/* ========================================================================== *
+ * INTERNALS                                                                  *
+ * ========================================================================== */
+
+function findModuleType(directory: string): 'commonjs' | 'module' {
+  const file = path.join(directory, 'package.json')
+  try {
+    const data = JSON.parse(fs.readFileSync(file, 'utf-8'))
+    return data.type || 'commonjs'
+  } catch (error: any) {
+    if (error.code !== 'ENOENT') {
+      throw new Error(`Error reading "${file}"`, { cause: error })
+    }
+
+    const parent = path.dirname(directory)
+    if (parent === directory) return 'commonjs'
+    return findModuleType(parent)
+  }
+}
+
+const moduleType = findModuleType(process.cwd())
+
+/* ========================================================================== *
+ * CONFIGS                                                                    *
+ * ========================================================================== */
+
+/** Shared configuration for JavaScript files (CommonJS or ES modules). */
+export const shared: ESLintConfig<'plugjs/javascript/shared'> = {
+  name: 'plugjs/javascript/shared',
+
+  files: [ '**/*.js', '**/*.cjs', '**/*.mjs' ],
+
+  rules: {
+    'guard-for-in': 'error',
+    'no-array-constructor': 'error',
+    'no-invalid-this': 'error',
+    'no-unused-expressions': 'error',
+    'no-unused-vars': [ 'error', {
+      args: 'after-used',
+      argsIgnorePattern: '^_',
+    } ],
+  },
+}
+
+/* ========================================================================== */
+
+/** Marks `*.cjs` files as `commonjs`. */
+export const commonjs: ESLintConfig<'plugjs/javascript/commonjs'> = {
+  name: 'plugjs/javascript/commonjs',
+
+  files: moduleType === 'commonjs' ? [ '**/*.cjs', '**/*.js' ] : [ '**/*.cjs' ],
+
+  languageOptions: {
+    sourceType: 'commonjs',
+    globals: globals.node,
+  },
+
+  rules: {
+    'strict': [ 'error', 'global' ],
+  },
+}
+
+/* ========================================================================== */
+
+/** Marks `*.mjs` files as `module`. */
+export const modules: ESLintConfig<'plugjs/javascript/modules'> = {
+  name: 'plugjs/javascript/modules',
+
+  files: moduleType === 'module' ? [ '**/*.mjs', '**/*.js' ] : [ '**/*.mjs' ],
+
+  languageOptions: {
+    sourceType: 'module',
+    globals: globals.nodeBuiltin,
+  },
+
+  rules: {
+    'strict': [ 'error', 'never' ],
+  },
+}
+
+/* ========================================================================== */
+
+/**
+ * JavaScript module: declares all the common rules for JavaScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/javascript/shared`: shared configuration for JavaScript files.
+ * * `plugjs/javascript/commonjs`: marks `*.cjs` files as `commonjs`.
+ * * `plugjs/javascript/modules`: marks `*.mjs` files as `module`.
+ */
+export default [ shared, commonjs, modules ] as const

package/src/typescript.ts

@@ -0,0 +1,86 @@
+import tseslint from 'typescript-eslint'
+
+import type { TSESLint } from '@typescript-eslint/utils'
+import type { ESLintConfig } from './index'
+
+/* ========================================================================== *
+ * INTERNALS                                                                  *
+ * ========================================================================== */
+
+/**
+ * Split the "base" config from "typescript-eslint" into its plugin definition
+ * and the rest of the config (namely, the language options). We'll want to
+ * apply the plugin **globally** so that all configs can use it, but the
+ * language options only to TypeScript files.
+ */
+const { plugins, ...opts } = tseslint.configs.base as TSESLint.FlatConfig.Config
+
+/** Map the "typescript-eslint" recommended configs */
+const configs = tseslint.configs.recommended.map((config: TSESLint.FlatConfig.Config) => {
+  // Allow the "@typescript-eslint" plugin to be visible everywhere...
+  if (config.name === tseslint.configs.base.name) return null
+  config.files = [ '**/*.ts', '**/*.cts', '**/*.mts' ]
+  return config
+}).filter((config): config is ESLintConfig => !! config)
+
+/* ========================================================================== *
+ * CONFIGS                                                                    *
+ * ========================================================================== */
+
+/** Define the "@typescript-eslint" plugin. */
+export const plugin: ESLintConfig<'plugjs/typescript/plugin'> = {
+  name: 'plugjs/typescript/plugin',
+  plugins,
+}
+
+/* ========================================================================== */
+
+/** Configuration for "@typescript-eslint" scoped to TypeScript sources. */
+export const options: ESLintConfig<'plugjs/typescript/options'> = {
+  ...opts,
+  files: [ '**/*.ts', '**/*.cts', '**/*.mts' ],
+  name: 'plugjs/typescript/options',
+}
+
+/* ========================================================================== */
+
+/** Our own rules overriding `typescript-eslint/recommended`. */
+export const overrides: ESLintConfig<'plugjs/typescript/overrides'> = {
+  name: 'plugjs/typescript/overrides',
+
+  files: [ '**/*.ts', '**/*.cts', '**/*.mts' ],
+
+  rules: {
+    'no-unused-vars': 'off', // overrides ESLint Recommended for TypeScript
+    'no-dupe-class-members': 'off', // overrides ESLint Recommended for TypeScript
+
+    '@typescript-eslint/consistent-type-imports': 'error',
+    '@typescript-eslint/explicit-function-return-type': [ 'error', {
+      allowExpressions: true,
+      allowDirectConstAssertionInArrowFunctions: true,
+      allowConciseArrowFunctionExpressionsStartingWithVoid: true,
+    } ],
+    '@typescript-eslint/no-dupe-class-members': 'error',
+    '@typescript-eslint/no-empty-object-type': 'off',
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/no-floating-promises': 'error',
+    '@typescript-eslint/no-invalid-this': 'error',
+    '@typescript-eslint/no-unused-vars': [ 'error', {
+      args: 'after-used',
+      argsIgnorePattern: '^_',
+    } ],
+  },
+}
+
+/**
+ * TypeScript module: declares all the common rules for TypeScript code bases.
+ *
+ * This module includes these configurations:
+ *
+ * * `plugjs/typescript/plugin`: defines the "@typescript-eslint" plugin.
+ * * `plugjs/typescript/options`: configuration for "@typescript-eslint".
+ * * other rules from `typescript-eslint/recommended`: all other recommended
+ *   Typescript rules, restricted to `.ts`, `.cts`, and `.mts` files.
+ * * `plugjs/typescript/overrides`: our rules overriding recommended.
+ */
+export default [ plugin, options, ...configs, overrides ] as const

package/configs/javascript.mjs

@@ -1,77 +0,0 @@
-/** Basic extra rules for JavaScript sources. */
-import process from 'node:process'
-import path from 'node:path'
-import fs from 'node:fs'
-
-import globals from 'globals'
-
-function findModuleType(directory) {
-  const file = path.join(directory, 'package.json')
-  try {
-    const data = JSON.parse(fs.readFileSync(file, 'utf-8'))
-    return data.type || 'commonjs'
-  } catch (error) {
-    if (error.code !== 'ENOENT') {
-      throw new Error(`Error reading "${file}"`, { cause: error })
-    }
-
-    const parent = path.dirname(directory)
-    if (parent === directory) return 'commonjs'
-    return findModuleType(parent)
-  }
-}
-
-const moduleType = findModuleType(process.cwd())
-
-export const javascript = {
-  name: 'plugjs-javascript',
-
-  files: [ '*.js', '*.cjs', '*.mjs' ],
-
-  rules: {
-    'guard-for-in': 'error',
-    'no-array-constructor': 'error',
-    'no-invalid-this': 'error',
-    'no-unused-expressions': 'error',
-    'no-unused-vars': [ 'error', {
-      args: 'after-used',
-      argsIgnorePattern: '^_',
-    } ],
-    'strict': [ 'error', 'global' ],
-  },
-}
-
-/** Marks `*.cjs` files as `commonjs`. */
-export const javascriptCommonJs = {
-  name: 'plugjs-javascript-cjs',
-
-  files: moduleType === 'commonjs' ? [ '**/*.cjs', '**/*.js' ] : [ '**/*.cjs' ],
-
-  languageOptions: {
-    sourceType: 'commonjs',
-    globals: globals.node,
-  },
-}
-
-/** Marks `*.mjs` files as `module`. */
-export const javascriptModule = {
-  name: 'plugjs-javascript-esm',
-
-  files: moduleType === 'module' ? [ '**/*.mjs', '**/*.js' ] : [ '**/*.mjs' ],
-
-  languageOptions: {
-    sourceType: 'module',
-    globals: globals.nodeBuiltin,
-  },
-}
-
-/**
- * JavaScript module: declares all the common rules for JavaScript code bases.
- *
- * This module includes these configurations:
- *
- * * `plugjs-javascript`: basic extra rules for JavaScript sources.
- * * `plugjs-javascript-cjs`: marks `*.cjs` files as `commonjs`.
- * * `plugjs-javascript-mjs`: marks `*.mjs` files as `module`.
- */
-export default [ javascript, javascriptCommonJs, javascriptModule ]

package/configs/typescript.mjs

@@ -1,51 +0,0 @@
-import tseslint from 'typescript-eslint'
-
-/** Our own rules overriding `typescript-eslint/recommended`. */
-export const typescript = {
-  name: 'plugjs-typescript',
-
-  files: [ '**/*.ts', '**/*.cts', '**/*.mts' ],
-
-  rules: {
-    'no-unused-vars': 'off', // overrides ESLint Recommended for TypeScript
-    'no-dupe-class-members': 'off', // overrides ESLint Recommended for TypeScript
-
-    '@typescript-eslint/consistent-type-imports': 'error',
-    '@typescript-eslint/explicit-function-return-type': [ 'error', {
-      allowExpressions: true,
-      allowDirectConstAssertionInArrowFunctions: true,
-      allowConciseArrowFunctionExpressionsStartingWithVoid: true,
-    } ],
-    '@typescript-eslint/no-dupe-class-members': 'error',
-    '@typescript-eslint/no-empty-object-type': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/no-floating-promises': 'error',
-    '@typescript-eslint/no-invalid-this': 'error',
-    '@typescript-eslint/no-unused-vars': [ 'error', {
-      args: 'after-used',
-      argsIgnorePattern: '^_',
-    } ],
-  },
-}
-
-/**
- * TypeScript module: declares all the common rules for TypeScript code bases.
- *
- * This module includes these configurations:
- *
- * * `typescript-eslint/recommended`: imports all the configurations from
- *   TypeScript ESlint recommended, but restrict them to operate only on
- *   `.ts`, `.cts`, and `.mts` files. This *should* include:
- *   * `typescript-eslint/base`: basic parser configuration.
- *   * `typescript-eslint/eslint-recommended`: disable ESLint rules conflicting
- *     with TypeScript.
- *   * `typescript-eslint/recommended`: recommended config for TypeScript
- * * `plugjs-typescript`: our rules overriding `typescript-eslint/recommended`.
- */
-export default [
-  ...tseslint.configs.recommended.map((config) => {
-    config.files = [ '**/*.ts', '**/*.cts', '**/*.mts' ]
-    return config
-  }),
-  typescript,
-]

package/index.mjs

@@ -1,44 +0,0 @@
-import js from '@eslint/js'
-
-import basic from './configs/basic.mjs'
-import javascript from './configs/javascript.mjs'
-import typescript from './configs/typescript.mjs'
-
-export * from './configs/basic.mjs'
-export * from './configs/javascript.mjs'
-export * from './configs/typescript.mjs'
-
-/**
- * Base `ESLint` configuration for PlugJS.
- *
- * This includes a number of configurations:
- *
- * * `eslint-recommended`: recommended JavaScript config from ESLint.
- *
- * * `plugjs-base`: basic configuration of ESLint rules.
- * * `plugjs-stylistic`: style shared between JavaScript and TypeScript.
- * * `plugjs-unicorn`: extra niceties from the ESLint Unicorn plugin.
- * * `plugjs-importx`: defines the style of our imports.
- *
- * * `plugjs-javascript`: basic extra rules for JavaScript sources.
- * * `plugjs-javascript-cjs`: marks `*.cjs` files as `commonjs`.
- * * `plugjs-javascript-mjs`: marks `*.mjs` files as `module`.
- *
- * * `typescript-eslint/recommended`: imports all the configurations from
- *   TypeScript ESlint recommended, but restrict them to operate only on
- *   `.ts`, `.cts`, and `.mts` files. This *should* include:
- *   * `typescript-eslint/base`: basic parser configuration.
- *   * `typescript-eslint/eslint-recommended`: disable ESLint rules conflicting
- *     with TypeScript.
- *   * `typescript-eslint/recommended`: recommended config for TypeScript
- * * `plugjs-typescript`: our rules overriding `typescript-eslint/recommended`.
- */
-export default [
-  { // give a name to this config before we go completely nuts!
-    name: 'eslint/js/recommended',
-    ...js.configs.recommended,
-  },
-  ...basic,
-  ...javascript,
-  ...typescript,
-]