exadev-eslint-config 2.18.1 → 2.19.0

package/README.md

@@ -16,7 +16,7 @@ Consumers need `eslint >=10.0.0` and `typescript-eslint >=8.0.0` as required pee
 pnpm add -D @exadev/eslint-config typescript-eslint eslint
 ```
 
-The default export is the full, type-checked ruleset: typescript-eslint's `strictTypeChecked` + `stylisticTypeChecked` presets (`strictTypeChecked` subsumes `recommendedTypeChecked`, so it already includes `no-deprecated`, `no-misused-spread`, `no-mixed-enums`, `no-unnecessary-condition`, `use-unknown-in-catch-callback-variable`, `return-await`, `related-getter-setter-pairs`, `no-unnecessary-type-parameters`, and more — those are no longer re-listed below), `exadev/barrel-policy` at `mode: 'banned'` (see [Barrel policy](#barrel-policy)), `exadev/no-object-assign`, `exadev/no-mutable-union-array-param`, `exadev/no-array-isarray-mutation`, `exadev/no-enum-number-widening`, `exadev/no-enum-reverse-lookup-widening`, `exadev/no-map-instanceof-mutation`, `exadev/no-set-instanceof-mutation`, `exadev/prefer-readonly-array-param`, `exadev/prefer-readonly-object-param`, `exadev/prefer-numeric-sort-compare`, `exadev/no-pointless-reassignment`, `exadev/test-file-kind`, `linterOptions.noInlineConfig`, `@typescript-eslint/consistent-type-assertions` banning all type assertions, `@typescript-eslint/consistent-type-imports`, `@typescript-eslint/consistent-type-exports`, `@typescript-eslint/consistent-return` (a function that implicitly returns `undefined` on one path and a real value on another — a common real bug, not a deliberate design), `@typescript-eslint/no-non-null-assertion` banning the `!` operator (the same manual-override escape hatch as a type assertion, under a different spelling), `@typescript-eslint/no-redeclare`, `@typescript-eslint/no-shadow`, `@typescript-eslint/no-use-before-define` set to `{ functions: false }` (a genuine temporal-dead-zone crash risk for `let`/`const`/`class`/enum bindings, but exempting function declarations, which are fully hoisted and therefore runtime-safe to call before their point of textual declaration — this codebase's own rule files consistently define their helper functions after the logic that calls them), `@typescript-eslint/ban-ts-comment` banning `@ts-expect-error` outright, `@typescript-eslint/method-signature-style` set to `'property'` (method-shorthand signatures are checked bivariantly under `strictFunctionTypes`, which is unsound), `@typescript-eslint/prefer-readonly`, `@typescript-eslint/promise-function-async`, `@typescript-eslint/require-array-sort-compare`, `@typescript-eslint/strict-void-return` (not yet in any typescript-eslint preset — disallows passing a value-returning function where a void-returning one is expected, e.g. `arr.forEach(x => otherArray.push(x))`, which typechecks today under TS's own void-return contravariance leniency), `@typescript-eslint/switch-exhaustiveness-check`, `@typescript-eslint/strict-boolean-expressions` at the rule's own bare defaults (an unambiguous non-nullable truthy check stays allowed; an ambiguous nullable check does not), `@typescript-eslint/no-magic-numbers` tuned to exempt array indexes, enum members, readonly class properties, default parameter values, numeric literal types (e.g. `type Indent = 2 | 4`), and the handful of universally-idiomatic bare numbers (`-1`, `0`, `1`, `2`), `max-lines` set to `{ max: 800, skipBlankLines: true, skipComments: true }` (counting only real code, so a file isn't pushed over the limit by whitespace or its own WHY-explanation comments), and `no-warning-comments` banning any comment containing `Stryker disable` (Stryker's own mutation-testing suppression directive, invisible to ESLint's `noInlineConfig` above since it isn't an eslint-disable comment at all) — the type-assertion and ts-comment rules are relaxed in test files, and `no-magic-numbers`/`max-lines`/`no-warning-comments` are not (see below). Spread it directly into `tseslint.config(...)`:
+The default export is the full, type-checked ruleset: typescript-eslint's `strictTypeChecked` + `stylisticTypeChecked` presets (`strictTypeChecked` subsumes `recommendedTypeChecked`, so it already includes `no-deprecated`, `no-misused-spread`, `no-mixed-enums`, `no-unnecessary-condition`, `use-unknown-in-catch-callback-variable`, `return-await`, `related-getter-setter-pairs`, `no-unnecessary-type-parameters`, and more — those are no longer re-listed below), `exadev/barrel-policy` at its auto-detecting default (see [Barrel policy](#barrel-policy)), `exadev/no-object-assign`, `exadev/no-mutable-union-array-param`, `exadev/no-array-isarray-mutation`, `exadev/no-enum-number-widening`, `exadev/no-enum-reverse-lookup-widening`, `exadev/no-map-instanceof-mutation`, `exadev/no-set-instanceof-mutation`, `exadev/prefer-readonly-array-param`, `exadev/prefer-readonly-object-param`, `exadev/prefer-numeric-sort-compare`, `exadev/no-pointless-reassignment`, `exadev/test-file-kind`, `linterOptions.noInlineConfig`, `@typescript-eslint/consistent-type-assertions` banning all type assertions, `@typescript-eslint/consistent-type-imports`, `@typescript-eslint/consistent-type-exports`, `@typescript-eslint/consistent-return` (a function that implicitly returns `undefined` on one path and a real value on another — a common real bug, not a deliberate design), `@typescript-eslint/no-non-null-assertion` banning the `!` operator (the same manual-override escape hatch as a type assertion, under a different spelling), `@typescript-eslint/no-redeclare`, `@typescript-eslint/no-shadow`, `@typescript-eslint/no-use-before-define` set to `{ functions: false }` (a genuine temporal-dead-zone crash risk for `let`/`const`/`class`/enum bindings, but exempting function declarations, which are fully hoisted and therefore runtime-safe to call before their point of textual declaration — this codebase's own rule files consistently define their helper functions after the logic that calls them), `@typescript-eslint/ban-ts-comment` banning `@ts-expect-error` outright, `@typescript-eslint/method-signature-style` set to `'property'` (method-shorthand signatures are checked bivariantly under `strictFunctionTypes`, which is unsound), `@typescript-eslint/prefer-readonly`, `@typescript-eslint/promise-function-async`, `@typescript-eslint/require-array-sort-compare`, `@typescript-eslint/strict-void-return` (not yet in any typescript-eslint preset — disallows passing a value-returning function where a void-returning one is expected, e.g. `arr.forEach(x => otherArray.push(x))`, which typechecks today under TS's own void-return contravariance leniency), `@typescript-eslint/switch-exhaustiveness-check`, `@typescript-eslint/strict-boolean-expressions` at the rule's own bare defaults (an unambiguous non-nullable truthy check stays allowed; an ambiguous nullable check does not), `@typescript-eslint/no-magic-numbers` tuned to exempt array indexes, enum members, readonly class properties, default parameter values, numeric literal types (e.g. `type Indent = 2 | 4`), and the handful of universally-idiomatic bare numbers (`-1`, `0`, `1`, `2`), `max-lines` set to `{ max: 800, skipBlankLines: true, skipComments: true }` (counting only real code, so a file isn't pushed over the limit by whitespace or its own WHY-explanation comments), and `no-warning-comments` banning any comment containing `Stryker disable` (Stryker's own mutation-testing suppression directive, invisible to ESLint's `noInlineConfig` above since it isn't an eslint-disable comment at all) — the type-assertion and ts-comment rules are relaxed in test files, and `no-magic-numbers`/`max-lines`/`no-warning-comments` are not (see below). Spread it directly into `tseslint.config(...)`:
 
 ```ts
 // eslint.config.ts
@@ -34,11 +34,11 @@ export default tseslint.config(
 );
 ```
 
-**A published package whose `src/index.ts` is its package entry point overrides `banned` to `single` in one line** (flat-config later blocks override earlier rule settings), since deleting its barrel would break every downstream importer:
+**The default export's `barrel-policy` mode is `'auto'`, so a published package's `src/index.ts` is permitted as a barrel with no config change on your part** — it walks up from the linted file to the nearest ancestor `package.json` and checks for a real `exports` or `main`; find one and the file's package resolves to `single`, find neither and it resolves to `banned`, identical to this package's old hardcoded default. Override only when you want a fixed policy regardless of what your own `package.json` looks like — e.g. `siblings` mode, which `auto` never resolves to on its own (flat-config later blocks override earlier rule settings):
 
 ```ts
   ...exadev,
-  { rules: { 'exadev/barrel-policy': ['error', { mode: 'single' }] } }, // this package keeps its barrel
+  { rules: { 'exadev/barrel-policy': ['error', { mode: 'siblings' }] } }, // any index file may be a barrel, not just src/index.ts
 ```
 
 `strictTypeChecked` subsumes both typescript-eslint's plain `recommended` and `recommendedTypeChecked` outright (every rule in each is also present in `strictTypeChecked`), and its base config registers the `@typescript-eslint` plugin and sets `languageOptions.parser` itself. That is why **you must remove your own `...tseslint.configs.recommended`/`recommendedTypeChecked`/`strictTypeChecked`/`stylisticTypeChecked` spreads** — flat config rejects two different plugin object instances registered under the same namespace. You still supply `languageOptions.parserOptions.project`/`projectService` pointing at your own tsconfig(s).
@@ -225,14 +225,17 @@ Bundled into `exadevConfig()`'s default output the same way React/Next.js auto-d
 
 ## Barrel policy
 
-`exadev/barrel-policy` is the convenience layer: one rule id, one `{ mode }` option selecting a complete index-file policy. Use EITHER this umbrella OR the individual rules (not both — they double-report).
+`exadev/barrel-policy` is the convenience layer: one rule id, one `{ mode }` option selecting a complete index-file policy. Use EITHER this umbrella OR the individual rules (not both — they double-report). Omitting `mode` entirely, or passing an options object with no `mode` key, means `'auto'`.
 
 | `mode` | Which files may be barrels | What a barrel may contain | Where re-exports may come from |
 | --- | --- | --- | --- |
-| `'banned'` (default/recommended) | none | — | — |
-| `'single'` | exactly `src/index.ts` | only re-exports | anywhere |
+| `'auto'` (what an omitted `mode` means) | detected per file — walks up to the nearest ancestor `package.json`; a real `exports`/`main` there resolves to `single`, otherwise `banned` | only re-exports when detected as `single` | anywhere, when detected as `single` |
+| `'banned'` (`plugin.configs.recommended`'s explicit choice) | none | — | — |
+| `'single'` (`plugin.configs.barrel`'s explicit choice) | exactly `src/index.ts` | only re-exports | anywhere |
 | `'siblings'` | any `index.ts` | only re-exports | a direct sibling only (`./module`) |
 
+`'auto'` only ever resolves to `banned` or `single` — there is no single-signal auto-equivalent for `siblings` (which package.json field would suggest "any index file, not just the entry point"?), so a project wanting that policy still states it explicitly. `private: true` in `package.json` is not consulted by the detection: a pnpm workspace package is routinely both `private` and a genuine import target for sibling packages via `exports`, so `private` says nothing about whether a barrel is warranted.
+
 In every mode, re-exports are banned outside a permitted barrel, and a permitted barrel may contain only re-export statements. The umbrella composes the identical predicates the standalone rules use (shared in `src/rules/barrel-helpers.ts`). It is non-fixable — the autofix lives on `no-non-barrel-reexport`.
 
 ## Build, test, and lint

package/dist/index.cjs

@@ -260,13 +260,13 @@ function tryRequire(specifier, requireFn = nodeRequire) {
 		return;
 	}
 }
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null;
 }
 function normalizeLegacyParserOptions(record) {
 	if (!("parserOptions" in record)) return record;
 	const { parserOptions, languageOptions, ...rest } = record;
-	const existingLanguageOptions = isRecord$1(languageOptions) ? languageOptions : {};
+	const existingLanguageOptions = isRecord$2(languageOptions) ? languageOptions : {};
 	return {
 		...rest,
 		languageOptions: {
@@ -278,10 +278,10 @@ function normalizeLegacyParserOptions(record) {
 function readFlatConfig(module, path) {
 	let current = module;
 	for (const key of path) {
-		if (!isRecord$1(current)) return void 0;
+		if (!isRecord$2(current)) return void 0;
 		current = current[key];
 	}
-	if (!isRecord$1(current)) return void 0;
+	if (!isRecord$2(current)) return void 0;
 	return normalizeLegacyParserOptions(current);
 }
 //#endregion
@@ -295,7 +295,7 @@ function buildNextjsConfig(options = {}) {
 }
 //#endregion
 //#region package.json
-var version = "2.18.1";
+var version = "2.19.0";
 //#endregion
 //#region src/react.ts
 const JSX_FILE_PATTERNS = ["**/*.jsx", "**/*.tsx"];
@@ -362,6 +362,9 @@ function isDirectSibling(specifier) {
 function isBarrelMode(value) {
 	return value === "banned" || value === "single" || value === "siblings";
 }
+function isRawBarrelMode(value) {
+	return value === "auto" || isBarrelMode(value);
+}
 function isPermittedBarrel(filename, mode) {
 	if (mode === "banned") return false;
 	if (mode === "single") return isMainBarrel(filename);
@@ -468,79 +471,139 @@ const barrelDirectSiblingsOnly = {
 	}
 };
 //#endregion
+//#region src/rules/barrel-auto-detect.ts
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+function hasRealExports(value) {
+	if (typeof value === "string") return value.length > 0;
+	if (Array.isArray(value)) return value.length > 0;
+	return isRecord$1(value) && Object.keys(value).length > 0;
+}
+function decideAutoBarrelMode(packageJson) {
+	const hasExports = hasRealExports(packageJson["exports"]);
+	const main = packageJson["main"];
+	const hasMain = typeof main === "string" && main.length > 0;
+	return hasExports || hasMain ? "single" : "banned";
+}
+const packageJsonByStartDir = /* @__PURE__ */ new Map();
+function findNearestPackageJson(startDir) {
+	const cached = packageJsonByStartDir.get(startDir);
+	if (packageJsonByStartDir.has(startDir)) return cached;
+	let dir = startDir;
+	for (;;) {
+		const candidate = (0, node_path.join)(dir, "package.json");
+		if ((0, node_fs.existsSync)(candidate)) {
+			const parsed = JSON.parse((0, node_fs.readFileSync)(candidate, "utf8"));
+			const result = isRecord$1(parsed) ? parsed : void 0;
+			packageJsonByStartDir.set(startDir, result);
+			return result;
+		}
+		const parent = (0, node_path.dirname)(dir);
+		if (parent === dir) {
+			packageJsonByStartDir.set(startDir, void 0);
+			return;
+		}
+		dir = parent;
+	}
+}
+function resolveAutoMode(filename, readPackageJsonFn = findNearestPackageJson) {
+	const packageJson = readPackageJsonFn((0, node_path.dirname)(filename));
+	return packageJson === void 0 ? "banned" : decideAutoBarrelMode(packageJson);
+}
+//#endregion
 //#region src/rules/barrel-policy.ts
 function readMode(options) {
-	if (typeof options !== "object" || options === null || !("mode" in options) || !isBarrelMode(options.mode)) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' }.");
+	if (options === void 0) return "auto";
+	if (typeof options !== "object" || options === null) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' | 'auto' }.");
+	if (!("mode" in options)) return "auto";
+	if (!isRawBarrelMode(options.mode)) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' | 'auto' }.");
 	return options.mode;
 }
-const barrelPolicy = {
-	meta: {
-		type: "problem",
-		schema: [{
-			type: "object",
-			properties: { mode: {
-				type: "string",
-				enum: [
-					"banned",
-					"single",
-					"siblings"
-				]
-			} },
-			required: ["mode"],
-			additionalProperties: false
-		}],
-		messages: {
-			indexFileBanned: "Index (barrel) files are banned in this project — import directly from the module that owns the export instead. Rename this file to something descriptive.",
-			nonMainIndexFile: "Only src/index.ts may be a barrel in this project — this index file is not it. Move its contents into the module that owns them or give the file a descriptive name.",
-			sideEffectInBarrel: "A barrel may contain only re-export statements ('export * from ...' / 'export { x } from ...' / 'export type { x } from ...') — nothing else, so it can never have a side effect at import time by construction. Found: {{ description }}.",
-			reexportOutsideBarrel: "Re-exports belong only in a barrel (index) file — import this value directly in the file that uses it instead of re-exporting it through this one.",
-			notADirectSibling: "A barrel may re-export only from a direct sibling file or folder ('./module' or './module.ts') — found '{{ source }}'. Move the source closer, or import it directly at the call site rather than re-exporting it through this barrel."
-		}
-	},
-	create(context) {
-		const mode = readMode(context.options[0]);
-		const filename = context.filename;
-		const detector = createSplitReexportDetector();
-		return {
-			Program(node) {
-				if (mode === "banned") {
-					if (isIndexFile(filename)) context.report({
-						node,
-						messageId: "indexFileBanned"
-					});
-					return;
-				}
-				if (mode === "single") {
-					if (isIndexFile(filename) && !isMainBarrel(filename)) {
-						context.report({
+function createBarrelPolicyRule(readPackageJsonFn = findNearestPackageJson) {
+	return {
+		meta: {
+			type: "problem",
+			schema: [{
+				type: "object",
+				properties: { mode: {
+					type: "string",
+					enum: [
+						"banned",
+						"single",
+						"siblings",
+						"auto"
+					]
+				} },
+				additionalProperties: false
+			}],
+			messages: {
+				indexFileBanned: "Index (barrel) files are banned in this project — import directly from the module that owns the export instead. Rename this file to something descriptive.",
+				nonMainIndexFile: "Only src/index.ts may be a barrel in this project — this index file is not it. Move its contents into the module that owns them or give the file a descriptive name.",
+				sideEffectInBarrel: "A barrel may contain only re-export statements ('export * from ...' / 'export { x } from ...' / 'export type { x } from ...') — nothing else, so it can never have a side effect at import time by construction. Found: {{ description }}.",
+				reexportOutsideBarrel: "Re-exports belong only in a barrel (index) file — import this value directly in the file that uses it instead of re-exporting it through this one.",
+				notADirectSibling: "A barrel may re-export only from a direct sibling file or folder ('./module' or './module.ts') — found '{{ source }}'. Move the source closer, or import it directly at the call site rather than re-exporting it through this barrel."
+			}
+		},
+		create(context) {
+			const filename = context.filename;
+			const rawMode = readMode(context.options[0]);
+			const mode = rawMode === "auto" ? resolveAutoMode(filename, readPackageJsonFn) : rawMode;
+			const detector = createSplitReexportDetector();
+			return {
+				Program(node) {
+					if (mode === "banned") {
+						if (isIndexFile(filename)) context.report({
 							node,
-							messageId: "nonMainIndexFile"
+							messageId: "indexFileBanned"
 						});
 						return;
 					}
-					if (isMainBarrel(filename)) {
+					if (mode === "single") {
+						if (isIndexFile(filename) && !isMainBarrel(filename)) {
+							context.report({
+								node,
+								messageId: "nonMainIndexFile"
+							});
+							return;
+						}
+						if (isMainBarrel(filename)) {
+							for (const statement of node.body) if (!isPureReexport(statement)) context.report({
+								node: statement,
+								messageId: "sideEffectInBarrel",
+								data: { description: statement.type }
+							});
+						}
+						return;
+					}
+					if (isIndexFile(filename)) {
 						for (const statement of node.body) if (!isPureReexport(statement)) context.report({
 							node: statement,
 							messageId: "sideEffectInBarrel",
 							data: { description: statement.type }
 						});
 					}
-					return;
-				}
-				if (isIndexFile(filename)) {
-					for (const statement of node.body) if (!isPureReexport(statement)) context.report({
-						node: statement,
-						messageId: "sideEffectInBarrel",
-						data: { description: statement.type }
-					});
-				}
-			},
-			ImportDeclaration: (node) => {
-				detector.visitImport(node);
-			},
-			ExportNamedDeclaration(node) {
-				detector.visitExportNamed(node);
-				if (hasSource(node) && !isInsideAmbientModuleDeclaration(node)) {
+				},
+				ImportDeclaration: (node) => {
+					detector.visitImport(node);
+				},
+				ExportNamedDeclaration(node) {
+					detector.visitExportNamed(node);
+					if (hasSource(node) && !isInsideAmbientModuleDeclaration(node)) {
+						const source = moduleSpecifierValue(node.source);
+						if (!isPermittedBarrel(filename, mode)) context.report({
+							node,
+							messageId: "reexportOutsideBarrel"
+						});
+						else if (mode === "siblings" && !isDirectSibling(source)) context.report({
+							node,
+							messageId: "notADirectSibling",
+							data: { source }
+						});
+					}
+				},
+				ExportAllDeclaration(node) {
+					if (isInsideAmbientModuleDeclaration(node)) return;
 					const source = moduleSpecifierValue(node.source);
 					if (!isPermittedBarrel(filename, mode)) context.report({
 						node,
@@ -551,42 +614,30 @@ const barrelPolicy = {
 						messageId: "notADirectSibling",
 						data: { source }
 					});
+				},
+				ExportDefaultDeclaration: (node) => {
+					detector.visitExportDefault(node);
+				},
+				"Program:exit"() {
+					for (const violation of detector.violations()) if (isPermittedBarrel(filename, mode)) {
+						if (mode === "siblings") {
+							const importSource = moduleSpecifierValue(violation.trackedImport.declaration.source);
+							if (!isDirectSibling(importSource)) context.report({
+								node: violation.kind === "named" ? violation.specifier : violation.declaration,
+								messageId: "notADirectSibling",
+								data: { source: importSource }
+							});
+						}
+					} else context.report({
+						node: violation.kind === "named" ? violation.specifier : violation.declaration,
+						messageId: "reexportOutsideBarrel"
+					});
 				}
-			},
-			ExportAllDeclaration(node) {
-				if (isInsideAmbientModuleDeclaration(node)) return;
-				const source = moduleSpecifierValue(node.source);
-				if (!isPermittedBarrel(filename, mode)) context.report({
-					node,
-					messageId: "reexportOutsideBarrel"
-				});
-				else if (mode === "siblings" && !isDirectSibling(source)) context.report({
-					node,
-					messageId: "notADirectSibling",
-					data: { source }
-				});
-			},
-			ExportDefaultDeclaration: (node) => {
-				detector.visitExportDefault(node);
-			},
-			"Program:exit"() {
-				for (const violation of detector.violations()) if (isPermittedBarrel(filename, mode)) {
-					if (mode === "siblings") {
-						const importSource = moduleSpecifierValue(violation.trackedImport.declaration.source);
-						if (!isDirectSibling(importSource)) context.report({
-							node: violation.kind === "named" ? violation.specifier : violation.declaration,
-							messageId: "notADirectSibling",
-							data: { source: importSource }
-						});
-					}
-				} else context.report({
-					node: violation.kind === "named" ? violation.specifier : violation.declaration,
-					messageId: "reexportOutsideBarrel"
-				});
-			}
-		};
-	}
-};
+			};
+		}
+	};
+}
+var barrel_policy_default = createBarrelPolicyRule();
 //#endregion
 //#region src/rules/scope-guards.ts
 function asIdentifierName(name) {
@@ -1837,7 +1888,7 @@ const plugin = {
 	},
 	rules: {
 		"barrel-direct-siblings-only": barrelDirectSiblingsOnly,
-		"barrel-policy": barrelPolicy,
+		"barrel-policy": barrel_policy_default,
 		"no-array-isarray-mutation": noArrayIsArrayMutation,
 		"no-control-flow": noControlFlow,
 		"no-enum-number-widening": noEnumNumberWidening,
@@ -2017,7 +2068,7 @@ const recommendedTypeChecked = [
 		plugins: { exadev: plugin },
 		linterOptions: { noInlineConfig: true },
 		rules: {
-			"exadev/barrel-policy": ["error", { mode: "banned" }],
+			"exadev/barrel-policy": "error",
 			"exadev/no-array-isarray-mutation": "error",
 			"exadev/no-enum-number-widening": "error",
 			"exadev/no-enum-reverse-lookup-widening": "error",

package/dist/index.js

@@ -1,5 +1,5 @@
 import fs, { existsSync, readFileSync } from "node:fs";
-import path, { join, posix } from "node:path";
+import path, { dirname, join, posix } from "node:path";
 import jsdoc from "eslint-plugin-jsdoc";
 import tsdoc from "eslint-plugin-tsdoc";
 import jsonCanonical from "eslint-plugin-json-canonical";
@@ -226,13 +226,13 @@ function tryRequire(specifier, requireFn = nodeRequire) {
 		return;
 	}
 }
-function isRecord$1(value) {
+function isRecord$2(value) {
 	return typeof value === "object" && value !== null;
 }
 function normalizeLegacyParserOptions(record) {
 	if (!("parserOptions" in record)) return record;
 	const { parserOptions, languageOptions, ...rest } = record;
-	const existingLanguageOptions = isRecord$1(languageOptions) ? languageOptions : {};
+	const existingLanguageOptions = isRecord$2(languageOptions) ? languageOptions : {};
 	return {
 		...rest,
 		languageOptions: {
@@ -244,10 +244,10 @@ function normalizeLegacyParserOptions(record) {
 function readFlatConfig(module, path) {
 	let current = module;
 	for (const key of path) {
-		if (!isRecord$1(current)) return void 0;
+		if (!isRecord$2(current)) return void 0;
 		current = current[key];
 	}
-	if (!isRecord$1(current)) return void 0;
+	if (!isRecord$2(current)) return void 0;
 	return normalizeLegacyParserOptions(current);
 }
 //#endregion
@@ -261,7 +261,7 @@ function buildNextjsConfig(options = {}) {
 }
 //#endregion
 //#region package.json
-var version = "2.18.1";
+var version = "2.19.0";
 //#endregion
 //#region src/react.ts
 const JSX_FILE_PATTERNS = ["**/*.jsx", "**/*.tsx"];
@@ -328,6 +328,9 @@ function isDirectSibling(specifier) {
 function isBarrelMode(value) {
 	return value === "banned" || value === "single" || value === "siblings";
 }
+function isRawBarrelMode(value) {
+	return value === "auto" || isBarrelMode(value);
+}
 function isPermittedBarrel(filename, mode) {
 	if (mode === "banned") return false;
 	if (mode === "single") return isMainBarrel(filename);
@@ -434,79 +437,139 @@ const barrelDirectSiblingsOnly = {
 	}
 };
 //#endregion
+//#region src/rules/barrel-auto-detect.ts
+function isRecord$1(value) {
+	return typeof value === "object" && value !== null;
+}
+function hasRealExports(value) {
+	if (typeof value === "string") return value.length > 0;
+	if (Array.isArray(value)) return value.length > 0;
+	return isRecord$1(value) && Object.keys(value).length > 0;
+}
+function decideAutoBarrelMode(packageJson) {
+	const hasExports = hasRealExports(packageJson["exports"]);
+	const main = packageJson["main"];
+	const hasMain = typeof main === "string" && main.length > 0;
+	return hasExports || hasMain ? "single" : "banned";
+}
+const packageJsonByStartDir = /* @__PURE__ */ new Map();
+function findNearestPackageJson(startDir) {
+	const cached = packageJsonByStartDir.get(startDir);
+	if (packageJsonByStartDir.has(startDir)) return cached;
+	let dir = startDir;
+	for (;;) {
+		const candidate = join(dir, "package.json");
+		if (existsSync(candidate)) {
+			const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+			const result = isRecord$1(parsed) ? parsed : void 0;
+			packageJsonByStartDir.set(startDir, result);
+			return result;
+		}
+		const parent = dirname(dir);
+		if (parent === dir) {
+			packageJsonByStartDir.set(startDir, void 0);
+			return;
+		}
+		dir = parent;
+	}
+}
+function resolveAutoMode(filename, readPackageJsonFn = findNearestPackageJson) {
+	const packageJson = readPackageJsonFn(dirname(filename));
+	return packageJson === void 0 ? "banned" : decideAutoBarrelMode(packageJson);
+}
+//#endregion
 //#region src/rules/barrel-policy.ts
 function readMode(options) {
-	if (typeof options !== "object" || options === null || !("mode" in options) || !isBarrelMode(options.mode)) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' }.");
+	if (options === void 0) return "auto";
+	if (typeof options !== "object" || options === null) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' | 'auto' }.");
+	if (!("mode" in options)) return "auto";
+	if (!isRawBarrelMode(options.mode)) throw new Error("exadev/barrel-policy requires options: { mode: 'banned' | 'single' | 'siblings' | 'auto' }.");
 	return options.mode;
 }
-const barrelPolicy = {
-	meta: {
-		type: "problem",
-		schema: [{
-			type: "object",
-			properties: { mode: {
-				type: "string",
-				enum: [
-					"banned",
-					"single",
-					"siblings"
-				]
-			} },
-			required: ["mode"],
-			additionalProperties: false
-		}],
-		messages: {
-			indexFileBanned: "Index (barrel) files are banned in this project — import directly from the module that owns the export instead. Rename this file to something descriptive.",
-			nonMainIndexFile: "Only src/index.ts may be a barrel in this project — this index file is not it. Move its contents into the module that owns them or give the file a descriptive name.",
-			sideEffectInBarrel: "A barrel may contain only re-export statements ('export * from ...' / 'export { x } from ...' / 'export type { x } from ...') — nothing else, so it can never have a side effect at import time by construction. Found: {{ description }}.",
-			reexportOutsideBarrel: "Re-exports belong only in a barrel (index) file — import this value directly in the file that uses it instead of re-exporting it through this one.",
-			notADirectSibling: "A barrel may re-export only from a direct sibling file or folder ('./module' or './module.ts') — found '{{ source }}'. Move the source closer, or import it directly at the call site rather than re-exporting it through this barrel."
-		}
-	},
-	create(context) {
-		const mode = readMode(context.options[0]);
-		const filename = context.filename;
-		const detector = createSplitReexportDetector();
-		return {
-			Program(node) {
-				if (mode === "banned") {
-					if (isIndexFile(filename)) context.report({
-						node,
-						messageId: "indexFileBanned"
-					});
-					return;
-				}
-				if (mode === "single") {
-					if (isIndexFile(filename) && !isMainBarrel(filename)) {
-						context.report({
+function createBarrelPolicyRule(readPackageJsonFn = findNearestPackageJson) {
+	return {
+		meta: {
+			type: "problem",
+			schema: [{
+				type: "object",
+				properties: { mode: {
+					type: "string",
+					enum: [
+						"banned",
+						"single",
+						"siblings",
+						"auto"
+					]
+				} },
+				additionalProperties: false
+			}],
+			messages: {
+				indexFileBanned: "Index (barrel) files are banned in this project — import directly from the module that owns the export instead. Rename this file to something descriptive.",
+				nonMainIndexFile: "Only src/index.ts may be a barrel in this project — this index file is not it. Move its contents into the module that owns them or give the file a descriptive name.",
+				sideEffectInBarrel: "A barrel may contain only re-export statements ('export * from ...' / 'export { x } from ...' / 'export type { x } from ...') — nothing else, so it can never have a side effect at import time by construction. Found: {{ description }}.",
+				reexportOutsideBarrel: "Re-exports belong only in a barrel (index) file — import this value directly in the file that uses it instead of re-exporting it through this one.",
+				notADirectSibling: "A barrel may re-export only from a direct sibling file or folder ('./module' or './module.ts') — found '{{ source }}'. Move the source closer, or import it directly at the call site rather than re-exporting it through this barrel."
+			}
+		},
+		create(context) {
+			const filename = context.filename;
+			const rawMode = readMode(context.options[0]);
+			const mode = rawMode === "auto" ? resolveAutoMode(filename, readPackageJsonFn) : rawMode;
+			const detector = createSplitReexportDetector();
+			return {
+				Program(node) {
+					if (mode === "banned") {
+						if (isIndexFile(filename)) context.report({
 							node,
-							messageId: "nonMainIndexFile"
+							messageId: "indexFileBanned"
 						});
 						return;
 					}
-					if (isMainBarrel(filename)) {
+					if (mode === "single") {
+						if (isIndexFile(filename) && !isMainBarrel(filename)) {
+							context.report({
+								node,
+								messageId: "nonMainIndexFile"
+							});
+							return;
+						}
+						if (isMainBarrel(filename)) {
+							for (const statement of node.body) if (!isPureReexport(statement)) context.report({
+								node: statement,
+								messageId: "sideEffectInBarrel",
+								data: { description: statement.type }
+							});
+						}
+						return;
+					}
+					if (isIndexFile(filename)) {
 						for (const statement of node.body) if (!isPureReexport(statement)) context.report({
 							node: statement,
 							messageId: "sideEffectInBarrel",
 							data: { description: statement.type }
 						});
 					}
-					return;
-				}
-				if (isIndexFile(filename)) {
-					for (const statement of node.body) if (!isPureReexport(statement)) context.report({
-						node: statement,
-						messageId: "sideEffectInBarrel",
-						data: { description: statement.type }
-					});
-				}
-			},
-			ImportDeclaration: (node) => {
-				detector.visitImport(node);
-			},
-			ExportNamedDeclaration(node) {
-				detector.visitExportNamed(node);
-				if (hasSource(node) && !isInsideAmbientModuleDeclaration(node)) {
+				},
+				ImportDeclaration: (node) => {
+					detector.visitImport(node);
+				},
+				ExportNamedDeclaration(node) {
+					detector.visitExportNamed(node);
+					if (hasSource(node) && !isInsideAmbientModuleDeclaration(node)) {
+						const source = moduleSpecifierValue(node.source);
+						if (!isPermittedBarrel(filename, mode)) context.report({
+							node,
+							messageId: "reexportOutsideBarrel"
+						});
+						else if (mode === "siblings" && !isDirectSibling(source)) context.report({
+							node,
+							messageId: "notADirectSibling",
+							data: { source }
+						});
+					}
+				},
+				ExportAllDeclaration(node) {
+					if (isInsideAmbientModuleDeclaration(node)) return;
 					const source = moduleSpecifierValue(node.source);
 					if (!isPermittedBarrel(filename, mode)) context.report({
 						node,
@@ -517,42 +580,30 @@ const barrelPolicy = {
 						messageId: "notADirectSibling",
 						data: { source }
 					});
+				},
+				ExportDefaultDeclaration: (node) => {
+					detector.visitExportDefault(node);
+				},
+				"Program:exit"() {
+					for (const violation of detector.violations()) if (isPermittedBarrel(filename, mode)) {
+						if (mode === "siblings") {
+							const importSource = moduleSpecifierValue(violation.trackedImport.declaration.source);
+							if (!isDirectSibling(importSource)) context.report({
+								node: violation.kind === "named" ? violation.specifier : violation.declaration,
+								messageId: "notADirectSibling",
+								data: { source: importSource }
+							});
+						}
+					} else context.report({
+						node: violation.kind === "named" ? violation.specifier : violation.declaration,
+						messageId: "reexportOutsideBarrel"
+					});
 				}
-			},
-			ExportAllDeclaration(node) {
-				if (isInsideAmbientModuleDeclaration(node)) return;
-				const source = moduleSpecifierValue(node.source);
-				if (!isPermittedBarrel(filename, mode)) context.report({
-					node,
-					messageId: "reexportOutsideBarrel"
-				});
-				else if (mode === "siblings" && !isDirectSibling(source)) context.report({
-					node,
-					messageId: "notADirectSibling",
-					data: { source }
-				});
-			},
-			ExportDefaultDeclaration: (node) => {
-				detector.visitExportDefault(node);
-			},
-			"Program:exit"() {
-				for (const violation of detector.violations()) if (isPermittedBarrel(filename, mode)) {
-					if (mode === "siblings") {
-						const importSource = moduleSpecifierValue(violation.trackedImport.declaration.source);
-						if (!isDirectSibling(importSource)) context.report({
-							node: violation.kind === "named" ? violation.specifier : violation.declaration,
-							messageId: "notADirectSibling",
-							data: { source: importSource }
-						});
-					}
-				} else context.report({
-					node: violation.kind === "named" ? violation.specifier : violation.declaration,
-					messageId: "reexportOutsideBarrel"
-				});
-			}
-		};
-	}
-};
+			};
+		}
+	};
+}
+var barrel_policy_default = createBarrelPolicyRule();
 //#endregion
 //#region src/rules/scope-guards.ts
 function asIdentifierName(name) {
@@ -1803,7 +1854,7 @@ const plugin = {
 	},
 	rules: {
 		"barrel-direct-siblings-only": barrelDirectSiblingsOnly,
-		"barrel-policy": barrelPolicy,
+		"barrel-policy": barrel_policy_default,
 		"no-array-isarray-mutation": noArrayIsArrayMutation,
 		"no-control-flow": noControlFlow,
 		"no-enum-number-widening": noEnumNumberWidening,
@@ -1983,7 +2034,7 @@ const recommendedTypeChecked = [
 		plugins: { exadev: plugin },
 		linterOptions: { noInlineConfig: true },
 		rules: {
-			"exadev/barrel-policy": ["error", { mode: "banned" }],
+			"exadev/barrel-policy": "error",
 			"exadev/no-array-isarray-mutation": "error",
 			"exadev/no-enum-number-widening": "error",
 			"exadev/no-enum-reverse-lookup-widening": "error",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "exadev-eslint-config",
   "description": "Shared custom ESLint rules and plugin for ExaDev projects",
-  "version": "2.18.1",
+  "version": "2.19.0",
   "dependencies": {
     "@eslint/js": "^10.0.1",
     "@typescript-eslint/utils": "8.67.0",