eslint-config-nick2bad4u 1.0.0 → 1.0.2

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Nick2bad4u
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Nick2bad4u
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,192 +1,189 @@
-# eslint-config-nick2bad4u
-
-Shared flat ESLint config for Nick2bad4u ESLint plugin projects.
-
-## Install
-
-```sh
-npm install --save-dev eslint-config-nick2bad4u eslint typescript
-```
-
-The config package ships the ESLint plugins/parsers/configs it enables. `eslint` and `typescript` stay as peer dependencies so each consuming repo controls those versions.
-
-## Basic usage
-
-Create `eslint.config.mjs` in a consuming project:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-
-export default [...nick2bad4u.configs.all];
-```
-
-That shape is intentional: the package behaves like an ESLint plugin preset, so you can compose it with local config entries instead of letting it take over the entire file:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-
-export default [
-    ...nick2bad4u.configs.all,
-    {
-        name: "Local overrides",
-        rules: {
-            "no-console": "off",
-        },
-    },
-];
-```
-
-Available presets:
-
-- `nick2bad4u.configs.all` - full shared config, including packaged Typefest and Etc-Misc source rules.
-- `nick2bad4u.configs.recommended` - alias for `all`.
-- `nick2bad4u.configs.base` - shared config without the explicit source-rule plugin sections.
-- `nick2bad4u.configs.withoutChunkyLint` - disable `chunkylint` namespace rules.
-- `nick2bad4u.configs.withoutCopilot` - full shared config without Copilot rules.
-- `nick2bad4u.configs.withoutDocusaurus2` - disable `docusaurus-2` namespace rules.
-- `nick2bad4u.configs.withoutTypefest` - full shared config without the Typefest source-rule section.
-- `nick2bad4u.configs.withoutEtcMisc` - full shared config without the Etc-Misc source-rule section.
-- `nick2bad4u.configs.withoutFileProgress2` - disable `file-progress-2` namespace rules.
-- `nick2bad4u.configs.withoutGithubActions2` - disable `github-actions-2` namespace rules.
-- `nick2bad4u.configs.withoutImmutable2` - disable `immutable-2` namespace rules.
-- `nick2bad4u.configs.withoutRepo` - disable `repo` namespace rules.
-- `nick2bad4u.configs.withoutSdl2` - disable `sdl-2` namespace rules.
-- `nick2bad4u.configs.withoutStylelint2` - disable `stylelint-2` namespace rules.
-- `nick2bad4u.configs.withoutTsconfig` - disable `tsconfig` namespace rules.
-- `nick2bad4u.configs.withoutTsdocRequire2` - disable `tsdoc-require-2` namespace rules.
-- `nick2bad4u.configs.withoutTypedoc` - disable `typedoc` namespace rules.
-- `nick2bad4u.configs.withoutUptimeWatcher` - disable `uptime-watcher` namespace rules.
-- `nick2bad4u.configs.withoutVite` - disable `vite` namespace rules.
-- `nick2bad4u.configs.withoutWriteGoodComments2` - disable `write-good-comments-2` namespace rules.
-
-## Configure project roots / TypeScript projects
-
-By default, TypeScript-aware rules resolve projects from `process.cwd()` and try these files:
-
-- `./tsconfig.eslint.json`
-- `./tsconfig.json`
-- `./tsconfig.build.json`
-- `./tsconfig.js.json`
-
-Override that when a repo has different config names:
-
-```js
-import { createConfig } from "eslint-config-nick2bad4u";
-
-export default createConfig({
-    rootDirectory: import.meta.dirname,
-    tsconfigPaths: ["./tsconfig.eslint.json", "./tsconfig.json"],
-});
-```
-
-You can also set `ESLINT_CONFIG_ROOT` if you need to drive the root from the environment.
-
-## Dogfood a local ESLint plugin
-
-The shared config imports `eslint-plugin-typefest` from npm by default. In the `eslint-plugin-typefest` repo, use the preset without packaged Typefest and then add the local plugin section:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-import localTypefest from "./plugin.mjs";
-
-export default [
-    ...nick2bad4u.configs.withoutTypefest,
-    {
-        files: ["src/**/*.{ts,tsx,mts,cts}"],
-        name: "Local Typefest rules",
-        plugins: {
-            typefest: localTypefest,
-        },
-        rules: {
-            ...localTypefest.configs.experimental.rules,
-        },
-    },
-];
-```
-
-If your local plugin is built to `dist/plugin.js`, use that instead:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-import localTypefest from "./dist/plugin.js";
-
-export default [
-    ...nick2bad4u.configs.withoutTypefest,
-    {
-        files: ["src/**/*.{ts,tsx,mts,cts}"],
-        name: "Local Typefest rules",
-        plugins: {
-            typefest: localTypefest,
-        },
-        rules: {
-            ...localTypefest.configs.experimental.rules,
-        },
-    },
-];
-```
-
-## Disable a plugin from the shared config
-
-Use a preset that omits the source-rule section you do not want:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-
-export default [...nick2bad4u.configs.withoutTypefest];
-```
-
-For advanced cases, `createConfig(options)` is still exported. Use it when you need custom `rootDirectory`, custom `tsconfigPaths`, or dynamic plugin disables/replacements.
-
-The same pattern works for dogfooding any local plugin with a matching `without*` preset. For example, in `eslint-plugin-copilot`:
-
-```js
-import nick2bad4u from "eslint-config-nick2bad4u";
-import localCopilot from "./plugin.mjs";
-
-export default [
-    ...nick2bad4u.configs.withoutCopilot,
-    {
-        files: ["src/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}"],
-        name: "Local Copilot rules",
-        plugins: {
-            copilot: localCopilot,
-        },
-        rules: {
-            ...localCopilot.configs.all.rules,
-        },
-    },
-];
-```
-
-## Optional JSON schema validation
-
-JSON/YAML schema validation is off by default because schema fetching can make lint runs flaky/offline-hostile. To opt in, install `eslint-plugin-json-schema-validator` in the consuming repo and set:
-
-```sh
-ENABLE_JSON_SCHEMA_VALIDATION=1 eslint .
-```
-
-## Progress output
-
-`eslint-plugin-file-progress-2` is enabled. Control it with `ESLINT_PROGRESS`:
-
-- unset / `on`: show progress and file names
-- `nofile`: show progress without file names
-- `off`, `0`, or `false`: disable progress
-
-## Development checks
-
-Use the aggregate scripts before publishing or opening a pull request:
-
-```sh
-npm run lint:all
-npm run release:verify
-```
-
-The release verification pipeline runs typechecking, Vitest tests, ESLint,
-Prettier, package sorting/linting, `publint`, ATTW in ESM-only mode, YAML lint,
-`actionlint`, and Secretlint. Release notes are generated with `git-cliff` via
-the `changelog:*` scripts.
-
-For maintainers, see [MAINTAINER_GUIDE.md](./MAINTAINER_GUIDE.md).
-Historical wording diffs are captured in [DIFF_NOTES.md](./DIFF_NOTES.md).
+# eslint-config-nick2bad4u
+
+Shared flat ESLint config for Nick2bad4u ESLint plugin projects.
+
+## Install
+
+```sh
+npm install --save-dev eslint-config-nick2bad4u eslint typescript
+```
+
+The config package ships the ESLint plugins/parsers/configs it enables. `eslint` and `typescript` stay as peer dependencies so each consuming repo controls those versions.
+
+## Basic usage
+
+Create `eslint.config.mjs` in a consuming project:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+
+export default [...nick2bad4u.configs.all];
+```
+
+That shape is intentional: the package behaves like an ESLint plugin preset, so you can compose it with local config entries instead of letting it take over the entire file:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+
+export default [
+    ...nick2bad4u.configs.all,
+    {
+        name: "Local overrides",
+        rules: {
+            "no-console": "off",
+        },
+    },
+];
+```
+
+Available presets:
+
+- `nick2bad4u.configs.all` - full shared config, including packaged Typefest and Etc-Misc source rules.
+- `nick2bad4u.configs.recommended` - alias for `all`.
+- `nick2bad4u.configs.base` - shared config without the explicit source-rule plugin sections.
+- `nick2bad4u.configs.withoutChunkyLint` - disable `chunkylint` namespace rules.
+- `nick2bad4u.configs.withoutCopilot` - full shared config without Copilot rules.
+- `nick2bad4u.configs.withoutDocusaurus2` - disable `docusaurus-2` namespace rules.
+- `nick2bad4u.configs.withoutTypefest` - full shared config without the Typefest source-rule section.
+- `nick2bad4u.configs.withoutEtcMisc` - full shared config without the Etc-Misc source-rule section.
+- `nick2bad4u.configs.withoutFileProgress2` - disable `file-progress-2` namespace rules.
+- `nick2bad4u.configs.withoutGithubActions2` - disable `github-actions-2` namespace rules.
+- `nick2bad4u.configs.withoutImmutable2` - disable `immutable-2` namespace rules.
+- `nick2bad4u.configs.withoutRepo` - disable `repo` namespace rules.
+- `nick2bad4u.configs.withoutSdl2` - disable `sdl-2` namespace rules.
+- `nick2bad4u.configs.withoutStylelint2` - disable `stylelint-2` namespace rules.
+- `nick2bad4u.configs.withoutTsconfig` - disable `tsconfig` namespace rules.
+- `nick2bad4u.configs.withoutTsdocRequire2` - disable `tsdoc-require-2` namespace rules.
+- `nick2bad4u.configs.withoutTypedoc` - disable `typedoc` namespace rules.
+- `nick2bad4u.configs.withoutUptimeWatcher` - disable `uptime-watcher` namespace rules.
+- `nick2bad4u.configs.withoutVite` - disable `vite` namespace rules.
+- `nick2bad4u.configs.withoutWriteGoodComments2` - disable `write-good-comments-2` namespace rules.
+
+## Configure project roots / TypeScript projects
+
+By default, TypeScript-aware rules resolve projects from `process.cwd()` and use:
+
+- `./tsconfig.eslint.json`
+
+Override that when a repo has different config names:
+
+```js
+import { createConfig } from "eslint-config-nick2bad4u";
+
+export default createConfig({
+    rootDirectory: import.meta.dirname,
+    tsconfigPaths: ["./tsconfig.eslint.json", "./tsconfig.json"],
+});
+```
+
+You can also set `ESLINT_CONFIG_ROOT` if you need to drive the root from the environment.
+
+## Dogfood a local ESLint plugin
+
+The shared config imports `eslint-plugin-typefest` from npm by default. In the `eslint-plugin-typefest` repo, use the preset without packaged Typefest and then add the local plugin section:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+import localTypefest from "./plugin.mjs";
+
+export default [
+    ...nick2bad4u.configs.withoutTypefest,
+    {
+        files: ["src/**/*.{ts,tsx,mts,cts}"],
+        name: "Local Typefest rules",
+        plugins: {
+            typefest: localTypefest,
+        },
+        rules: {
+            ...localTypefest.configs.experimental.rules,
+        },
+    },
+];
+```
+
+If your local plugin is built to `dist/plugin.js`, use that instead:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+import localTypefest from "./dist/plugin.js";
+
+export default [
+    ...nick2bad4u.configs.withoutTypefest,
+    {
+        files: ["src/**/*.{ts,tsx,mts,cts}"],
+        name: "Local Typefest rules",
+        plugins: {
+            typefest: localTypefest,
+        },
+        rules: {
+            ...localTypefest.configs.experimental.rules,
+        },
+    },
+];
+```
+
+## Disable a plugin from the shared config
+
+Use a preset that omits the source-rule section you do not want:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+
+export default [...nick2bad4u.configs.withoutTypefest];
+```
+
+For advanced cases, `createConfig(options)` is still exported. Use it when you need custom `rootDirectory`, custom `tsconfigPaths`, or dynamic plugin disables/replacements.
+
+The same pattern works for dogfooding any local plugin with a matching `without*` preset. For example, in `eslint-plugin-copilot`:
+
+```js
+import nick2bad4u from "eslint-config-nick2bad4u";
+import localCopilot from "./plugin.mjs";
+
+export default [
+    ...nick2bad4u.configs.withoutCopilot,
+    {
+        files: ["src/**/*.{js,mjs,cjs,ts,mts,cts,tsx,jsx}"],
+        name: "Local Copilot rules",
+        plugins: {
+            copilot: localCopilot,
+        },
+        rules: {
+            ...localCopilot.configs.all.rules,
+        },
+    },
+];
+```
+
+## Optional JSON schema validation
+
+JSON/YAML schema validation is off by default because schema fetching can make lint runs flaky/offline-hostile. To opt in, install `eslint-plugin-json-schema-validator` in the consuming repo and set:
+
+```sh
+ENABLE_JSON_SCHEMA_VALIDATION=1 eslint .
+```
+
+## Progress output
+
+`eslint-plugin-file-progress-2` is enabled. Control it with `ESLINT_PROGRESS`:
+
+- unset / `on`: show progress and file names
+- `nofile`: show progress without file names
+- `off`, `0`, or `false`: disable progress
+
+## Development checks
+
+Use the aggregate scripts before publishing or opening a pull request:
+
+```sh
+npm run lint:all
+npm run release:verify
+```
+
+The release verification pipeline runs typechecking, Vitest tests, ESLint,
+Prettier, package sorting/linting, `publint`, ATTW in ESM-only mode, YAML lint,
+`actionlint`, and Secretlint. Release notes are generated with `git-cliff` via
+the `changelog:*` scripts.
+
+For maintainers, see [MAINTAINER_GUIDE.md](./MAINTAINER_GUIDE.md).
+Historical wording diffs are captured in [DIFF_NOTES.md](./DIFF_NOTES.md).

package/eslint.config.mjs

@@ -11,7 +11,7 @@
 import pluginDocusaurus from "@docusaurus/eslint-plugin";
 import comments from "@eslint-community/eslint-plugin-eslint-comments/configs";
 import eslintReactPlugin from "@eslint-react/eslint-plugin";
-import { defineConfig, globalIgnores } from "@eslint/config-helpers";
+import { globalIgnores } from "@eslint/config-helpers";
 import css from "@eslint/css";
 import js from "@eslint/js";
 import json from "@eslint/json";
@@ -124,12 +124,7 @@ const jsonSchemaValidatorRules =
 
 const processEnvironment = globalThis.process.env;
 
-const DEFAULT_TSCONFIG_PATHS = Object.freeze([
-    "./tsconfig.eslint.json",
-    "./tsconfig.json",
-    "./tsconfig.build.json",
-    "./tsconfig.js.json",
-]);
+const DEFAULT_TSCONFIG_PATHS = Object.freeze(["./tsconfig.eslint.json"]);
 
 /**
  * @typedef {import("eslint").Linter.Config} EslintConfig
@@ -223,6 +218,16 @@ const removeDisabledPluginRules = (configs, disabledPluginNames) => {
     });
 };
 
+/**
+ * @param {readonly (EslintConfig | readonly EslintConfig[])[]} configs
+ *
+ * @returns {EslintConfig[]}
+ */
+const flattenConfigs = (configs) =>
+    configs.flatMap((config) =>
+        Array.isArray(config) ? flattenConfigs(config) : [config]
+    );
+
 /**
  * Controls eslint-plugin-file-progress behavior.
  *
@@ -3401,8 +3406,9 @@ export const createConfig = (options = {}) => {
         // #endregion
     ];
 
-    return defineConfig(
-        removeDisabledPluginRules(configs, disabledPluginNames)
+    return removeDisabledPluginRules(
+        flattenConfigs(configs),
+        disabledPluginNames
     );
 };
 

package/index.d.ts

@@ -6,9 +6,8 @@ export interface Nick2Bad4UEslintConfigOptions {
      * Replace or disable plugins by ESLint namespace.
      *
      * Pass a plugin object to dogfood an explicitly configurable source-rule
-     * plugin section, such as `typefest` or `etc-misc`. Pass `false` or `null`
-     * to remove that plugin's registered rules from the shared config by
-     * namespace.
+     * Defaults to `["./tsconfig.eslint.json"]`. to remove that plugin's
+     * registered rules from the shared config by namespace.
      */
     readonly plugins?: Readonly<Record<string, unknown>>;
 

package/package.json

@@ -1,7 +1,7 @@
 {
     "$schema": "https://www.schemastore.org/package.json",
     "name": "eslint-config-nick2bad4u",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "private": false,
     "description": "Shared flat ESLint config for Nick2bad4u ESLint plugin projects.",
     "keywords": [