@valkyrjaio/ci-eslint 26.0.0 → 26.1.0

package/README.md

@@ -28,19 +28,40 @@ itself.
 
 ## Usage
 
-Give `getRule` the repository's own package identifier, and register the rule
-that it returns:
+A repository states only what is true of itself, and `Rules` supplies the rest:
 
 ```js
-import { CopyrightHeaderFactory } from '@valkyrjaio/ci-eslint';
-
-export default tseslint.config(eslint.configs.recommended, {
-    plugins: {
-        local: { rules: { 'copyright-header': CopyrightHeaderFactory.getRule('Valkyrja Framework') } },
-    },
-    rules: {
-        'local/copyright-header': 'error',
-    },
+import path from 'path';
+import { Rules } from '@valkyrjaio/ci-eslint';
+
+export default Rules.getConfig({
+    packageName: 'Valkyrja Framework',
+    tsconfigRootDir: path.resolve(import.meta.dirname, '../../..'),
+    project: ['./tsconfig.tests.json'],
+});
+```
+
+`getConfig` returns the whole flat configuration: the ESLint and typescript-eslint
+presets, the shared rules, the copyright header rule, and the test-file rules.
+
+A repository picks one of two ways to find its TypeScript project. Give `project`
+when one tsconfig spans both `src` and `tests`. Give `projectService` to let
+typescript-eslint find the project, which reads `tsconfig.json` only. Give exactly
+one; `getConfig` rejects neither and both.
+
+Warning: with neither option typescript-eslint reads no type information, every
+type-aware rule goes quiet, and the run still reports success. That is why the
+guard stops rather than picking a default.
+
+Add what only this repository needs through `overrides`, which append after the
+shared entries:
+
+```js
+Rules.getConfig({
+    packageName: 'Valkyrja Application',
+    tsconfigRootDir: path.resolve(import.meta.dirname, '../../..'),
+    projectService: true,
+    overrides: [{ files: ['bin/**/*.ts'], rules: { 'no-console': 'off' } }],
 });
 ```
 
@@ -53,12 +74,16 @@ every repository to its identifier. `valkyrja-ts` takes `Valkyrja Framework`,
 
 | Member                                    | Returns                                             |
 | :---------------------------------------- | :-------------------------------------------------- |
+| `Rules.getConfig(options)`                | the whole flat configuration                        |
+| `Rules.getRules()`                        | the rules that apply to every linted file           |
+| `Rules.getTestRules()`                    | the rules that apply to a test file only            |
+| `Rules.getParserOptions(options)`         | the parser options that find the project            |
 | `CopyrightHeaderFactory.getRule(name)`    | the ESLint rule that requires the header            |
 | `CopyrightHeaderFactory.getHeader(name)`  | the full block comment, and the blank line below it |
 | `CopyrightHeaderFactory.getComment(name)` | the text between the two comment delimiters         |
 
-Each member takes the package identifier, and each one rejects a value that
-names no package.
+Each `CopyrightHeaderFactory` member takes the package identifier, and each one
+rejects a value that names no package.
 
 ## Why the package name is guarded
 

package/dist/Eslint/Constant/EslintInfo.d.ts

@@ -1,5 +1,5 @@
 export declare class EslintInfo {
-    static readonly VERSION: "26.0.0";
-    static readonly VERSION_BUILD_DATE_TIME: "August 2 2026 20:32:26 MST";
+    static readonly VERSION: "26.1.0";
+    static readonly VERSION_BUILD_DATE_TIME: "August 3 2026 00:42:35 MST";
 }
 //# sourceMappingURL=EslintInfo.d.ts.map

package/dist/Eslint/Constant/EslintInfo.js

@@ -6,7 +6,7 @@
  * Released under the MIT License. See LICENSE.md for details.
  */
 export class EslintInfo {
-    static VERSION = '26.0.0';
-    static VERSION_BUILD_DATE_TIME = 'August 2 2026 20:32:26 MST';
+    static VERSION = '26.1.0';
+    static VERSION_BUILD_DATE_TIME = 'August 3 2026 00:42:35 MST';
 }
 //# sourceMappingURL=EslintInfo.js.map

package/dist/Eslint/Rules.d.ts

@@ -0,0 +1,59 @@
+import type { Linter } from 'eslint';
+/**
+ * What a repository states about itself.
+ *
+ * Every other part of the configuration is the same in each repository, so this package holds it.
+ */
+export interface RulesOptions {
+    /** The package identifier the header states, such as `Valkyrja Framework`. */
+    packageName: string;
+    /** The absolute directory that a `project` path resolves from. */
+    tsconfigRootDir: string;
+    /** The TypeScript projects to read. Give this, or `projectService`, and never both. */
+    project?: string[];
+    /** Let typescript-eslint find the project. Give this, or `project`, and never both. */
+    projectService?: boolean;
+    /** Flat configuration entries this repository adds after the shared ones. */
+    overrides?: Linter.Config[];
+}
+/**
+ * Builds the ESLint configuration that every Valkyrja TypeScript repository runs.
+ *
+ * A repository that keeps its own copy of these rules drifts from the others, and no tool reports
+ * the drift. This class therefore holds the rules, and a repository states only what is true of
+ * itself: its package identifier, and how to find its TypeScript project.
+ */
+export declare class Rules {
+    /**
+     * Builds the whole configuration.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither `project` nor
+     *                                             `projectService`, or names both
+     */
+    static getConfig(options: RulesOptions): Linter.Config[];
+    /**
+     * The rules that apply to every linted file.
+     */
+    static getRules(): Linter.RulesRecord;
+    /**
+     * The rules that apply to a test file only.
+     *
+     * A test builds a stub as `{ method: vi.fn() } as unknown as SomeContract`, so
+     * `expect(stub.method)` reads the method off the contract type purely to assert on the spy. The
+     * test never invokes the method unbound. `unbound-method` sees the declared contract type only,
+     * and it cannot tell the two apart, so it reports every such assertion. The rule still applies
+     * in full to `src`.
+     */
+    static getTestRules(): Linter.RulesRecord;
+    /**
+     * The parser options that find the repository's TypeScript project.
+     *
+     * A repository picks one of the two ways. `project` names the tsconfig files to read, which a
+     * repository needs when one tsconfig spans both `src` and `tests`. `projectService` lets
+     * typescript-eslint find the project, which reads `tsconfig.json` only.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither, or both
+     */
+    static getParserOptions(options: RulesOptions): Record<string, unknown>;
+}
+//# sourceMappingURL=Rules.d.ts.map

package/dist/Eslint/Rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rules.d.ts","sourceRoot":"","sources":["../../src/Eslint/Rules.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAQrC;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,eAAe,EAAE,MAAM,CAAC;IACxB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,uFAAuF;IACvF,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,qBAAa,KAAK;IACd;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE;IAqBxD;;OAEG;IACH,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,WAAW;IAWrC;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,WAAW;IAMzC;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAuB1E"}

package/dist/Eslint/Rules.js

@@ -0,0 +1,103 @@
+/*
+ * This file is part of the Valkyrja ESLint package.
+ *
+ * Copyright (c) 2016-present Melech Mizrachi
+ *
+ * Released under the MIT License. See LICENSE.md for details.
+ */
+import eslint from '@eslint/js';
+// `defineConfig` comes from ESLint core. `tseslint.config` did the same job and is deprecated.
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+import { CopyrightHeaderFactory } from "./Factory/CopyrightHeaderFactory.js";
+import { EslintInvalidParserOptionsException } from "./Throwable/Exception/EslintInvalidParserOptionsException.js";
+/**
+ * Builds the ESLint configuration that every Valkyrja TypeScript repository runs.
+ *
+ * A repository that keeps its own copy of these rules drifts from the others, and no tool reports
+ * the drift. This class therefore holds the rules, and a repository states only what is true of
+ * itself: its package identifier, and how to find its TypeScript project.
+ */
+export class Rules {
+    /**
+     * Builds the whole configuration.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither `project` nor
+     *                                             `projectService`, or names both
+     */
+    static getConfig(options) {
+        return defineConfig([
+            eslint.configs.recommended,
+            tseslint.configs.strictTypeChecked,
+            {
+                languageOptions: {
+                    parserOptions: Rules.getParserOptions(options),
+                },
+                plugins: {
+                    local: { rules: { 'copyright-header': CopyrightHeaderFactory.getRule(options.packageName) } },
+                },
+                rules: Rules.getRules(),
+            },
+            {
+                files: ['tests/**/*.ts'],
+                rules: Rules.getTestRules(),
+            },
+            ...(options.overrides ?? []),
+        ]);
+    }
+    /**
+     * The rules that apply to every linted file.
+     */
+    static getRules() {
+        return {
+            'local/copyright-header': 'error',
+            '@typescript-eslint/no-namespace': 'off',
+            '@typescript-eslint/no-extraneous-class': 'off',
+            '@typescript-eslint/no-unnecessary-type-parameters': 'off',
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+            '@typescript-eslint/no-invalid-void-type': ['error', { allowAsThisParameter: true }],
+        };
+    }
+    /**
+     * The rules that apply to a test file only.
+     *
+     * A test builds a stub as `{ method: vi.fn() } as unknown as SomeContract`, so
+     * `expect(stub.method)` reads the method off the contract type purely to assert on the spy. The
+     * test never invokes the method unbound. `unbound-method` sees the declared contract type only,
+     * and it cannot tell the two apart, so it reports every such assertion. The rule still applies
+     * in full to `src`.
+     */
+    static getTestRules() {
+        return {
+            '@typescript-eslint/unbound-method': 'off',
+        };
+    }
+    /**
+     * The parser options that find the repository's TypeScript project.
+     *
+     * A repository picks one of the two ways. `project` names the tsconfig files to read, which a
+     * repository needs when one tsconfig spans both `src` and `tests`. `projectService` lets
+     * typescript-eslint find the project, which reads `tsconfig.json` only.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither, or both
+     */
+    static getParserOptions(options) {
+        const hasProject = options.project !== undefined;
+        const hasProjectService = options.projectService !== undefined;
+        // Warning: neither option set means typescript-eslint parses no type information, and every
+        // type-aware rule goes quiet while the run still reports success. Both set is ambiguous.
+        // Stop on each, rather than pick one and lint less than the repository expects.
+        if (hasProject === hasProjectService) {
+            // The message names the options rather than a method. Both `getConfig` and
+            // `getParserOptions` are public and reach this guard, so a method name in the text is
+            // wrong for one of the two callers.
+            throw new EslintInvalidParserOptionsException('The options take either `project` or `projectService`, and they name ' +
+                (hasProject ? 'both.' : 'neither.'));
+        }
+        if (options.project !== undefined) {
+            return { project: options.project, tsconfigRootDir: options.tsconfigRootDir };
+        }
+        return { projectService: options.projectService, tsconfigRootDir: options.tsconfigRootDir };
+    }
+}
+//# sourceMappingURL=Rules.js.map

package/dist/Eslint/Rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Rules.js","sourceRoot":"","sources":["../../src/Eslint/Rules.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,MAAM,MAAM,YAAY,CAAC;AAEhC,+FAA+F;AAC/F,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,QAAQ,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,EAAE,mCAAmC,EAAE,MAAM,8DAA8D,CAAC;AAoBnH;;;;;;GAMG;AACH,MAAM,OAAO,KAAK;IACd;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,OAAqB;QAClC,OAAO,YAAY,CAAC;YAChB,MAAM,CAAC,OAAO,CAAC,WAAW;YAC1B,QAAQ,CAAC,OAAO,CAAC,iBAAiB;YAClC;gBACI,eAAe,EAAE;oBACb,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC;iBACjD;gBACD,OAAO,EAAE;oBACL,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,kBAAkB,EAAE,sBAAsB,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE;iBAChG;gBACD,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;aAC1B;YACD;gBACI,KAAK,EAAE,CAAC,eAAe,CAAC;gBACxB,KAAK,EAAE,KAAK,CAAC,YAAY,EAAE;aAC9B;YACD,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;SAC/B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ;QACX,OAAO;YACH,wBAAwB,EAAE,OAAO;YACjC,iCAAiC,EAAE,KAAK;YACxC,wCAAwC,EAAE,KAAK;YAC/C,mDAAmD,EAAE,KAAK;YAC1D,mCAAmC,EAAE,CAAC,OAAO,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;YACpG,yCAAyC,EAAE,CAAC,OAAO,EAAE,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC;SACvF,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY;QACf,OAAO;YACH,mCAAmC,EAAE,KAAK;SAC7C,CAAC;IACN,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAqB;QACzC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC;QACjD,MAAM,iBAAiB,GAAG,OAAO,CAAC,cAAc,KAAK,SAAS,CAAC;QAE/D,4FAA4F;QAC5F,yFAAyF;QACzF,gFAAgF;QAChF,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;YACnC,2EAA2E;YAC3E,sFAAsF;YACtF,oCAAoC;YACpC,MAAM,IAAI,mCAAmC,CACzC,uEAAuE;gBACnE,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAC1C,CAAC;QACN,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;QAClF,CAAC;QAED,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IAChG,CAAC;CACJ"}

package/dist/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.d.ts

@@ -0,0 +1,8 @@
+import { EslintInvalidArgumentException } from './Abstract/EslintInvalidArgumentException.ts';
+/**
+ * The caller named neither, or both, of the two ways to find the TypeScript project.
+ */
+export declare class EslintInvalidParserOptionsException extends EslintInvalidArgumentException {
+    constructor(message: string);
+}
+//# sourceMappingURL=EslintInvalidParserOptionsException.d.ts.map

package/dist/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EslintInvalidParserOptionsException.d.ts","sourceRoot":"","sources":["../../../../src/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAE9F;;GAEG;AACH,qBAAa,mCAAoC,SAAQ,8BAA8B;gBACvE,OAAO,EAAE,MAAM;CAK9B"}

package/dist/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.js

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja ESLint package.
+ *
+ * Copyright (c) 2016-present Melech Mizrachi
+ *
+ * Released under the MIT License. See LICENSE.md for details.
+ */
+import { EslintInvalidArgumentException } from "./Abstract/EslintInvalidArgumentException.js";
+/**
+ * The caller named neither, or both, of the two ways to find the TypeScript project.
+ */
+export class EslintInvalidParserOptionsException extends EslintInvalidArgumentException {
+    constructor(message) {
+        super(message);
+        this.name = 'EslintInvalidParserOptionsException';
+    }
+}
+//# sourceMappingURL=EslintInvalidParserOptionsException.js.map

package/dist/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EslintInvalidParserOptionsException.js","sourceRoot":"","sources":["../../../../src/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,8BAA8B,EAAE,MAAM,8CAA8C,CAAC;AAE9F;;GAEG;AACH,MAAM,OAAO,mCAAoC,SAAQ,8BAA8B;IACnF,YAAY,OAAe;QACvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,IAAI,GAAG,qCAAqC,CAAC;IACtD,CAAC;CACJ"}

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 export { EslintInfo } from './Eslint/Constant/EslintInfo.ts';
 export { CopyrightHeaderFactory } from './Eslint/Factory/CopyrightHeaderFactory.ts';
+export { Rules } from './Eslint/Rules.ts';
+export type { RulesOptions } from './Eslint/Rules.ts';
 export { EslintInvalidArgumentException } from './Eslint/Throwable/Exception/Abstract/EslintInvalidArgumentException.ts';
 export { EslintInvalidPackageNameException } from './Eslint/Throwable/Exception/EslintInvalidPackageNameException.ts';
+export { EslintInvalidParserOptionsException } from './Eslint/Throwable/Exception/EslintInvalidParserOptionsException.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,yEAAyE,CAAC;AACzH,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,8BAA8B,EAAE,MAAM,yEAAyE,CAAC;AACzH,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AACtH,OAAO,EAAE,mCAAmC,EAAE,MAAM,qEAAqE,CAAC"}

package/dist/index.js

@@ -7,6 +7,8 @@
  */
 export { EslintInfo } from "./Eslint/Constant/EslintInfo.js";
 export { CopyrightHeaderFactory } from "./Eslint/Factory/CopyrightHeaderFactory.js";
+export { Rules } from "./Eslint/Rules.js";
 export { EslintInvalidArgumentException } from "./Eslint/Throwable/Exception/Abstract/EslintInvalidArgumentException.js";
 export { EslintInvalidPackageNameException } from "./Eslint/Throwable/Exception/EslintInvalidPackageNameException.js";
+export { EslintInvalidParserOptionsException } from "./Eslint/Throwable/Exception/EslintInvalidParserOptionsException.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,yEAAyE,CAAC;AACzH,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AACpF,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,yEAAyE,CAAC;AACzH,OAAO,EAAE,iCAAiC,EAAE,MAAM,mEAAmE,CAAC;AACtH,OAAO,EAAE,mCAAmC,EAAE,MAAM,qEAAqE,CAAC"}

package/package.json

@@ -1,8 +1,15 @@
 {
     "name": "@valkyrjaio/ci-eslint",
-    "version": "26.0.0",
+    "version": "26.1.0",
     "description": "Shared ESLint configuration for Valkyrja TypeScript repositories",
     "homepage": "https://www.valkyrja.io",
+    "bugs": {
+        "url": "https://github.com/valkyrjaio/ci-eslint-ts/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/valkyrjaio/ci-eslint-ts.git"
+    },
     "keywords": [
         "ci",
         "eslint",
@@ -34,7 +41,8 @@
         "typescript-outdated-check": "cd .github/ci/typescript && npm install && npm outdated",
         "typescript-outdated-check-major-release": "cd .github/ci/typescript && npm install && npm outdated",
         "typescript-npm-update": "cd .github/ci/typescript && npm update",
-        "eslint": "cd .github/ci/eslint && npm run check",
+        "eslint": "cd .github/ci/eslint && npm run fix",
+        "eslint-check": "cd .github/ci/eslint && npm run check",
         "eslint-outdated-check": "cd .github/ci/eslint && npm install && npm outdated",
         "eslint-outdated-check-major-release": "cd .github/ci/eslint && npm install && npm outdated",
         "eslint-npm-update": "cd .github/ci/eslint && npm update",
@@ -56,5 +64,9 @@
     },
     "peerDependencies": {
         "eslint": ">=9"
+    },
+    "dependencies": {
+        "@eslint/js": "^10.0.1",
+        "typescript-eslint": "^8.65.0"
     }
 }

package/src/Eslint/Constant/EslintInfo.ts

@@ -7,6 +7,6 @@
  */
 
 export class EslintInfo {
-    static readonly VERSION = '26.0.0' as const;
-    static readonly VERSION_BUILD_DATE_TIME = 'August 2 2026 20:32:26 MST' as const;
+    static readonly VERSION = '26.1.0' as const;
+    static readonly VERSION_BUILD_DATE_TIME = 'August 3 2026 00:42:35 MST' as const;
 }

package/src/Eslint/Rules.ts

@@ -0,0 +1,132 @@
+/*
+ * This file is part of the Valkyrja ESLint package.
+ *
+ * Copyright (c) 2016-present Melech Mizrachi
+ *
+ * Released under the MIT License. See LICENSE.md for details.
+ */
+
+import eslint from '@eslint/js';
+import type { Linter } from 'eslint';
+// `defineConfig` comes from ESLint core. `tseslint.config` did the same job and is deprecated.
+import { defineConfig } from 'eslint/config';
+import tseslint from 'typescript-eslint';
+
+import { CopyrightHeaderFactory } from './Factory/CopyrightHeaderFactory.ts';
+import { EslintInvalidParserOptionsException } from './Throwable/Exception/EslintInvalidParserOptionsException.ts';
+
+/**
+ * What a repository states about itself.
+ *
+ * Every other part of the configuration is the same in each repository, so this package holds it.
+ */
+export interface RulesOptions {
+    /** The package identifier the header states, such as `Valkyrja Framework`. */
+    packageName: string;
+    /** The absolute directory that a `project` path resolves from. */
+    tsconfigRootDir: string;
+    /** The TypeScript projects to read. Give this, or `projectService`, and never both. */
+    project?: string[];
+    /** Let typescript-eslint find the project. Give this, or `project`, and never both. */
+    projectService?: boolean;
+    /** Flat configuration entries this repository adds after the shared ones. */
+    overrides?: Linter.Config[];
+}
+
+/**
+ * Builds the ESLint configuration that every Valkyrja TypeScript repository runs.
+ *
+ * A repository that keeps its own copy of these rules drifts from the others, and no tool reports
+ * the drift. This class therefore holds the rules, and a repository states only what is true of
+ * itself: its package identifier, and how to find its TypeScript project.
+ */
+export class Rules {
+    /**
+     * Builds the whole configuration.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither `project` nor
+     *                                             `projectService`, or names both
+     */
+    static getConfig(options: RulesOptions): Linter.Config[] {
+        return defineConfig([
+            eslint.configs.recommended,
+            tseslint.configs.strictTypeChecked,
+            {
+                languageOptions: {
+                    parserOptions: Rules.getParserOptions(options),
+                },
+                plugins: {
+                    local: { rules: { 'copyright-header': CopyrightHeaderFactory.getRule(options.packageName) } },
+                },
+                rules: Rules.getRules(),
+            },
+            {
+                files: ['tests/**/*.ts'],
+                rules: Rules.getTestRules(),
+            },
+            ...(options.overrides ?? []),
+        ]);
+    }
+
+    /**
+     * The rules that apply to every linted file.
+     */
+    static getRules(): Linter.RulesRecord {
+        return {
+            'local/copyright-header': 'error',
+            '@typescript-eslint/no-namespace': 'off',
+            '@typescript-eslint/no-extraneous-class': 'off',
+            '@typescript-eslint/no-unnecessary-type-parameters': 'off',
+            '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+            '@typescript-eslint/no-invalid-void-type': ['error', { allowAsThisParameter: true }],
+        };
+    }
+
+    /**
+     * The rules that apply to a test file only.
+     *
+     * A test builds a stub as `{ method: vi.fn() } as unknown as SomeContract`, so
+     * `expect(stub.method)` reads the method off the contract type purely to assert on the spy. The
+     * test never invokes the method unbound. `unbound-method` sees the declared contract type only,
+     * and it cannot tell the two apart, so it reports every such assertion. The rule still applies
+     * in full to `src`.
+     */
+    static getTestRules(): Linter.RulesRecord {
+        return {
+            '@typescript-eslint/unbound-method': 'off',
+        };
+    }
+
+    /**
+     * The parser options that find the repository's TypeScript project.
+     *
+     * A repository picks one of the two ways. `project` names the tsconfig files to read, which a
+     * repository needs when one tsconfig spans both `src` and `tests`. `projectService` lets
+     * typescript-eslint find the project, which reads `tsconfig.json` only.
+     *
+     * @throws EslintInvalidParserOptionsException When the caller names neither, or both
+     */
+    static getParserOptions(options: RulesOptions): Record<string, unknown> {
+        const hasProject = options.project !== undefined;
+        const hasProjectService = options.projectService !== undefined;
+
+        // Warning: neither option set means typescript-eslint parses no type information, and every
+        // type-aware rule goes quiet while the run still reports success. Both set is ambiguous.
+        // Stop on each, rather than pick one and lint less than the repository expects.
+        if (hasProject === hasProjectService) {
+            // The message names the options rather than a method. Both `getConfig` and
+            // `getParserOptions` are public and reach this guard, so a method name in the text is
+            // wrong for one of the two callers.
+            throw new EslintInvalidParserOptionsException(
+                'The options take either `project` or `projectService`, and they name ' +
+                    (hasProject ? 'both.' : 'neither.'),
+            );
+        }
+
+        if (options.project !== undefined) {
+            return { project: options.project, tsconfigRootDir: options.tsconfigRootDir };
+        }
+
+        return { projectService: options.projectService, tsconfigRootDir: options.tsconfigRootDir };
+    }
+}

package/src/Eslint/Throwable/Exception/EslintInvalidParserOptionsException.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja ESLint package.
+ *
+ * Copyright (c) 2016-present Melech Mizrachi
+ *
+ * Released under the MIT License. See LICENSE.md for details.
+ */
+
+import { EslintInvalidArgumentException } from './Abstract/EslintInvalidArgumentException.ts';
+
+/**
+ * The caller named neither, or both, of the two ways to find the TypeScript project.
+ */
+export class EslintInvalidParserOptionsException extends EslintInvalidArgumentException {
+    constructor(message: string) {
+        super(message);
+
+        this.name = 'EslintInvalidParserOptionsException';
+    }
+}

package/src/index.ts

@@ -8,5 +8,8 @@
 
 export { EslintInfo } from './Eslint/Constant/EslintInfo.ts';
 export { CopyrightHeaderFactory } from './Eslint/Factory/CopyrightHeaderFactory.ts';
+export { Rules } from './Eslint/Rules.ts';
+export type { RulesOptions } from './Eslint/Rules.ts';
 export { EslintInvalidArgumentException } from './Eslint/Throwable/Exception/Abstract/EslintInvalidArgumentException.ts';
 export { EslintInvalidPackageNameException } from './Eslint/Throwable/Exception/EslintInvalidPackageNameException.ts';
+export { EslintInvalidParserOptionsException } from './Eslint/Throwable/Exception/EslintInvalidParserOptionsException.ts';