@isentinel/eslint-config 6.2.0 → 6.4.0

package/dist/lint-cli.mjs

@@ -42,7 +42,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 //#endregion
 //#region package.json
-var version = "6.2.0";
+var version = "6.4.0";
 //#endregion
 //#region src/lint-cli/lib/cli/types.ts
 /**
@@ -1512,6 +1512,65 @@ function quotePosix(token) {
 	return `'${token.replaceAll("'", "'\\''")}'`;
 }
 //#endregion
+//#region src/hybrid-status.ts
+/**
+* Set by `isentinel-lint` in its ESLint children. Only those evaluations load
+* the config the lint run uses, so only they may write the status: tests,
+* scripts and generators that build other configs in the project root would
+* otherwise overwrite it.
+*/
+const HYBRID_STATUS_ENV = "ISENTINEL_WRITE_HYBRID_STATUS";
+/**
+* Absolute path to the hybrid-status file for a project root.
+*
+* @param cwd - The project root.
+* @returns The absolute status-file path.
+*/
+function hybridStatusPath(cwd) {
+	return statePath(cwd, "hybrid-status");
+}
+/**
+* Read the persisted hybrid status, or `undefined` when the file is missing,
+* unreadable or malformed (the CLI then treats the status as unknown).
+*
+* @param cwd - The project root.
+* @returns The parsed status, or `undefined`.
+*/
+function readHybridStatus(cwd) {
+	const stored = readState(hybridStatusPath(cwd));
+	return typeof stored?.oxlint === "boolean" ? stored : void 0;
+}
+/**
+* Passively record whether the resolved ESLint config runs in hybrid mode.
+* Called from the factory on every config evaluation in a lint child, so an
+* unchanged status is touched rather than rewritten: the file must not churn
+* as both lint passes re-evaluate the config, yet its mtime must stay ahead of
+* the config's or the CLI re-runs its ~3s probe every lint. Every failure is
+* swallowed — config evaluation must never throw for this, and the CLI treats
+* a missing or stale file as "unknown" and re-probes.
+*
+* Skipped entirely when `node_modules` is absent (nothing installed, so no
+* cache home and no CLI to read it).
+*
+* @param cwd - The project root.
+* @param oxlint - Whether the config enabled hybrid mode.
+*/
+function writeHybridStatus(cwd, oxlint) {
+	let installed;
+	try {
+		installed = fs.existsSync(path.resolve(cwd, "node_modules"));
+	} catch {
+		return;
+	}
+	if (!installed) return;
+	const filePath = hybridStatusPath(cwd);
+	if (readHybridStatus(cwd)?.oxlint === oxlint) {
+		touchState(filePath);
+		return;
+	}
+	writeState(filePath, { oxlint });
+}
+//#endregion
 //#region src/lint-cli/lib/plan/command.ts
 /**
 * Compose the oxlint child command.
@@ -1578,7 +1637,10 @@ function composeEslintCommand(options, context) {
 	if (options.agents) args.push("--format", context.agentsFormatterPath);
 	if (context.fix) args.push("--fix");
 	args.push(...options.eslintArgs, ...pathArguments(context.paths));
-	const environment = { ESLINT_TYPE_AWARE: context.typeAwareEnv };
+	const environment = {
+		ESLINT_TYPE_AWARE: context.typeAwareEnv,
+		[HYBRID_STATUS_ENV]: "1"
+	};
 	if (context.quietWarnings === true) environment[QUIET_WARNINGS_ENV] = "1";
 	if (context.heap?.nodeOptions !== void 0) environment["NODE_OPTIONS"] = context.heap.nodeOptions;
 	return {
@@ -4965,58 +5027,6 @@ function queryIgnoredFiles(cwd, targets) {
 	}
 }
 //#endregion
-//#region src/hybrid-status.ts
-/**
-* Absolute path to the hybrid-status file for a project root.
-*
-* @param cwd - The project root.
-* @returns The absolute status-file path.
-*/
-function hybridStatusPath(cwd) {
-	return statePath(cwd, "hybrid-status");
-}
-/**
-* Read the persisted hybrid status, or `undefined` when the file is missing,
-* unreadable or malformed (the CLI then treats the status as unknown).
-*
-* @param cwd - The project root.
-* @returns The parsed status, or `undefined`.
-*/
-function readHybridStatus(cwd) {
-	const stored = readState(hybridStatusPath(cwd));
-	return typeof stored?.oxlint === "boolean" ? stored : void 0;
-}
-/**
-* Passively record whether the resolved ESLint config runs in hybrid mode.
-* Called from the factory on every config evaluation, so an unchanged status is
-* touched rather than rewritten: the file must not churn as editors and both
-* lint passes re-evaluate the config, yet its mtime must stay ahead of the
-* config's or the CLI re-runs its ~3s probe every lint. Every failure is
-* swallowed — config evaluation must never throw for this, and the CLI treats a
-* missing or stale file as "unknown" and re-probes.
-*
-* Skipped entirely when `node_modules` is absent (nothing installed, so no
-* cache home and no CLI to read it).
-*
-* @param cwd - The project root.
-* @param oxlint - Whether the config enabled hybrid mode.
-*/
-function writeHybridStatus(cwd, oxlint) {
-	let installed;
-	try {
-		installed = fs.existsSync(path.resolve(cwd, "node_modules"));
-	} catch {
-		return;
-	}
-	if (!installed) return;
-	const filePath = hybridStatusPath(cwd);
-	if (readHybridStatus(cwd)?.oxlint === oxlint) {
-		touchState(filePath);
-		return;
-	}
-	writeState(filePath, { oxlint });
-}
-//#endregion
 //#region src/lint-cli/lib/hybrid/probe.ts
 /**
 * Read the hybrid marker from `eslint --print-config` stdout. Config evaluation

package/dist/oxfmt.mjs

@@ -315,15 +315,15 @@ function parseJsonLike(contents) {
 		return;
 	}
 }
-function isRecord(value) {
+function isRecord$1(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function readPackageJsonPrettierKey(filePath) {
 	const contents = readFileOrUndefined(filePath);
 	if (contents === void 0) return;
 	const parsed = parseJsonLike(contents);
-	const prettierKey = isRecord(parsed) ? parsed["prettier"] : void 0;
-	return isRecord(prettierKey) ? prettierKey : void 0;
+	const prettierKey = isRecord$1(parsed) ? parsed["prettier"] : void 0;
+	return isRecord$1(prettierKey) ? prettierKey : void 0;
 }
 /**
 * Load a JS Prettier config. Node's `require` handles ESM entry points
@@ -336,8 +336,8 @@ function readPackageJsonPrettierKey(filePath) {
 function requireConfigModule(filePath) {
 	try {
 		const loaded = createRequire(filePath)(filePath);
-		const value = isRecord(loaded) && "default" in loaded ? loaded["default"] : loaded;
-		return isRecord(value) ? value : void 0;
+		const value = isRecord$1(loaded) && "default" in loaded ? loaded["default"] : loaded;
+		return isRecord$1(value) ? value : void 0;
 	} catch {
 		return;
 	}
@@ -355,7 +355,7 @@ function readConfigFile(filePath) {
 	const contents = readFileOrUndefined(filePath);
 	if (contents === void 0) return;
 	const parsed = parseJsonLike(contents) ?? parseYamlLike(contents);
-	return isRecord(parsed) ? parsed : void 0;
+	return isRecord$1(parsed) ? parsed : void 0;
 }
 function ancestorDirectories(cwd) {
 	const directories = [];
@@ -481,6 +481,17 @@ function resolveEditorConfigOptions(cwd) {
 	return editorConfigToPrettier(properties);
 }
 /**
+* Read a numeric `.editorconfig` value. An absent or empty value sets nothing.
+*
+* @param value - The raw property value.
+* @returns The finite number, or `undefined`.
+*/
+function editorConfigNumber(value) {
+	if (value === void 0 || value === "") return;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+/**
 * Map one `.editorconfig` section to oxfmt options, as the rule's config
 * loader does.
 *
@@ -495,17 +506,34 @@ function editorConfigToOxfmt(properties) {
 	if (indentStyle === "tab" || indentStyle === "space") options["useTabs"] = indentStyle === "tab";
 	const quoteType = properties["quote_type"];
 	if (quoteType === "single" || quoteType === "double") options["singleQuote"] = quoteType === "single";
-	const indentSize = Number(properties["indent_size"]);
-	const tabWidth = Number(properties["tab_width"]);
-	if (options["useTabs"] === false && properties["indent_size"] && Number.isFinite(indentSize)) options["tabWidth"] = indentSize;
-	else if (properties["tab_width"] && Number.isFinite(tabWidth)) options["tabWidth"] = tabWidth;
-	const printWidth = Number(properties["max_line_length"]);
-	if (properties["max_line_length"] && Number.isFinite(printWidth)) options["printWidth"] = printWidth;
+	const indentSize = editorConfigNumber(properties["indent_size"]);
+	const tabWidth = editorConfigNumber(properties["tab_width"]);
+	if (indentSize !== void 0 && options["useTabs"] === false) options["tabWidth"] = indentSize;
+	else if (tabWidth !== void 0) options["tabWidth"] = tabWidth;
+	const printWidth = editorConfigNumber(properties["max_line_length"]);
+	if (printWidth !== void 0) options["printWidth"] = printWidth;
 	const finalNewline = properties["insert_final_newline"];
 	if (finalNewline === "true" || finalNewline === "false") options["insertFinalNewline"] = finalNewline === "true";
 	return options;
 }
 //#endregion
+//#region src/guards.ts
+/**
+* Internal runtime type guards. Prefer these over `as` assertions so values
+* crossing untyped boundaries (`JSON.parse`, dynamic `import`, plugin objects)
+* are validated at runtime rather than asserted away.
+*/
+/**
+* Whether a value is a non-null, non-array object usable as a string-keyed
+* record. Narrows `unknown` without an assertion.
+*
+* @param value - The value to test.
+* @returns Whether the value is a plain object.
+*/
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//#endregion
 //#region src/rules/oxfmt.ts
 const UNSUPPORTED_PRETTIER_KEYS = /* @__PURE__ */ new Set([
 	"experimentalOperatorPosition",
@@ -572,12 +600,12 @@ function migratePrettierOptions(prettierOptions) {
 function migratePrettierOverrides(overrides) {
 	if (!Array.isArray(overrides)) return [];
 	return overrides.flatMap((override) => {
-		if (typeof override !== "object" || override === null) return [];
+		if (!isRecord(override)) return [];
 		const { excludeFiles, files, options } = override;
 		return [{
 			...excludeFiles === void 0 ? {} : { excludeFiles: stringsOf(excludeFiles) },
 			files: stringsOf(files),
-			options: typeof options === "object" && options !== null ? migratePrettierOptions(options) : {}
+			options: isRecord(options) ? migratePrettierOptions(options) : {}
 		}];
 	});
 }
@@ -592,17 +620,11 @@ function migratePrettierOverrides(overrides) {
 * @returns The overrides with anchored globs.
 */
 function anchorOverrideGlobs(overrides) {
-	function anchor(glob) {
-		const negated = glob.startsWith("!");
-		const body = negated ? glob.slice(1) : glob;
-		const anchored = body.includes("/") ? body : `./${body}`;
-		return negated ? `!${anchored}` : anchored;
-	}
 	return overrides.map((override) => {
 		return {
 			...override,
-			...override.excludeFiles ? { excludeFiles: override.excludeFiles.map(anchor) } : {},
-			files: override.files.map(anchor)
+			...override.excludeFiles ? { excludeFiles: override.excludeFiles.map(anchorGlob) } : {},
+			files: override.files.map(anchorGlob)
 		};
 	});
 }
@@ -627,11 +649,16 @@ function buildOxfmtOptions({ oxfmtConfigOptions = {}, oxfmtOptions, prettierOpti
 * ESLint config and the standalone oxfmt config so both format Markdown the
 * same way.
 *
+* Oxfmt would format code blocks with these options too, at the prose width.
+* It leaves them alone instead, and ESLint formats each block with the options
+* of its own language (see `isentinel/oxfmt/markdown-code/*`).
+*
 * @param jsdocPrintWidth - Width for Markdown prose; 80 when unset.
 * @returns Options applied on top of the base for Markdown files.
 */
 function markdownOxfmtOptions(jsdocPrintWidth) {
 	return {
+		embeddedLanguageFormatting: "off",
 		printWidth: Number(jsdocPrintWidth) || 80,
 		proseWrap: "always",
 		tabWidth: 2
@@ -651,6 +678,18 @@ const YAML_OXFMT_OPTIONS = {
 	tabWidth: 2,
 	useTabs: false
 };
+/**
+* Anchor one slash-less glob to the config directory, keeping its negation.
+*
+* @param glob - An override glob.
+* @returns The anchored glob.
+*/
+function anchorGlob(glob) {
+	const negated = glob.startsWith("!");
+	const body = negated ? glob.slice(1) : glob;
+	const anchored = body.includes("/") ? body : `./${body}`;
+	return negated ? `!${anchored}` : anchored;
+}
 //#endregion
 //#region src/oxfmt/index.ts
 /**