@brnshkr/config 0.0.1-beta.3 → 0.0.1-beta.4

package/dist/shared.mjs

@@ -1,36 +1,52 @@
 import { isPackageExists } from "local-pkg";
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
 //#region ../package.json
 var name = "@brnshkr/config";
-var version = "0.0.1-beta.3";
+var version = "0.0.1-beta.4";
 //#endregion
 //#region ../src/js/shared/utils/package-json.ts
-const packageOrganizationInternal = name.split("/").at(0)?.replace(/^@/v, "");
+/**
+* @internal @brnshkr/config
+*/
+const packageOrganizationInternal = name.split("/", 1).at(0)?.replace(/^@/v, "");
 if (packageOrganizationInternal === void 0 || packageOrganizationInternal.length === 0) throw new Error("Failed to read package organization from package.json file.");
 const packageOrganization = packageOrganizationInternal;
 const packageOrganizationUpper = packageOrganizationInternal.toUpperCase();
 //#endregion
 //#region ../src/js/shared/utils/log.ts
-const log = (type, message, context) => {
-	console[type](`[${name}] ${message}`);
-	if (context) console[type](context);
+/**
+* @internal @brnshkr/config
+*/
+const log = (message) => {
+	console.error(`[${name}] ${message}`);
 };
 //#endregion
 //#region ../src/js/shared/utils/object.ts
+const objectKeys = (object) => Object.keys(object);
+const objectValues = (object) => Object.values(object);
 const objectEntries = (object) => Object.entries(object);
 const objectFromEntries = (entries) => Object.fromEntries(entries);
 const objectAssign = (target, source) => Object.assign(target, source);
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || !value) return false;
+	return (Object.getPrototypeOf(value) ?? Object.prototype) === Object.prototype;
+};
 //#endregion
 //#region ../src/js/shared/utils/interop-import.ts
 const interopImport = async (thePackage) => {
 	const resolved = await thePackage;
-	return typeof resolved === "object" && resolved !== null && "default" in resolved ? resolved.default : resolved;
+	return typeof resolved === "object" && resolved && "default" in resolved ? resolved.default : resolved;
 };
 //#endregion
 //#region ../src/js/shared/utils/package-resolvers.ts
+/**
+* @internal @brnshkr/config
+*/
 const ESLINT_PACKAGES = {
 	ESLINT_CSS: "@eslint/css",
-	ESLINT_FLAT_CONFIG_GITIGNORE: "eslint-config-flat-gitignore",
-	ESLINT_IMPORT_RESOVLER_TYPESCRIPT: "eslint-import-resolver-typescript",
+	ESLINT_IMPORT_RESOLVER_TYPESCRIPT: "eslint-import-resolver-typescript",
 	ESLINT_JSON: "@eslint/json",
 	ESLINT_MARKDOWN: "@eslint/markdown",
 	ESLINT_MERGE_PROCESSORS: "eslint-merge-processors",
@@ -50,47 +66,74 @@ const ESLINT_PACKAGES = {
 	ESLINT_PLUGIN_UNUSED_IMPORTS: "eslint-plugin-unused-imports",
 	ESLINT_PLUGIN_YML: "eslint-plugin-yml",
 	SVELTE: "svelte",
+	TAILWINDCSS: "tailwindcss",
 	TYPESCRIPT: "typescript",
 	TYPESCRIPT_ESLINT: "typescript-eslint",
 	VITEST_ESLINT_PLUGIN: "@vitest/eslint-plugin"
 };
 const ESLINT_PACKAGE_RESOLVERS = {
-	[ESLINT_PACKAGES.ESLINT_CSS]: async () => await interopImport(import("@eslint/css")),
-	[ESLINT_PACKAGES.ESLINT_FLAT_CONFIG_GITIGNORE]: async () => await interopImport(import("eslint-config-flat-gitignore")),
-	[ESLINT_PACKAGES.ESLINT_JSON]: async () => await interopImport(import("@eslint/json")),
-	[ESLINT_PACKAGES.ESLINT_IMPORT_RESOVLER_TYPESCRIPT]: async () => await interopImport(import("eslint-import-resolver-typescript")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_ANTFU]: async () => await interopImport(import("eslint-plugin-antfu")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_ESLINT_COMMENTS]: async () => await interopImport(import("@eslint-community/eslint-plugin-eslint-comments")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_IMPORT_X]: async () => await interopImport(import("eslint-plugin-import-x")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSDOC]: async () => await interopImport(import("eslint-plugin-jsdoc")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSONC]: async () => await interopImport(import("eslint-plugin-jsonc")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSDOC_PROCESSOR]: async () => await interopImport(import("eslint-plugin-jsdoc/getJsdocProcessorPlugin.js")),
-	[ESLINT_PACKAGES.ESLINT_MARKDOWN]: async () => await interopImport(import("@eslint/markdown")),
-	[ESLINT_PACKAGES.ESLINT_MERGE_PROCESSORS]: async () => await interopImport(import("eslint-merge-processors")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_N]: async () => await interopImport(import("eslint-plugin-n")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_PERFECTIONIST]: async () => await interopImport(import("eslint-plugin-perfectionist")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_REGEXP]: async () => await interopImport(import("eslint-plugin-regexp")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_STYLISTIC]: async () => await interopImport(import("@stylistic/eslint-plugin")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_SVELTE]: async () => await interopImport(import("eslint-plugin-svelte")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_TOML]: async () => await interopImport(import("eslint-plugin-toml")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_UNICORN]: async () => await interopImport(import("eslint-plugin-unicorn")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_UNUSED_IMPORTS]: async () => await interopImport(import("eslint-plugin-unused-imports")),
-	[ESLINT_PACKAGES.ESLINT_PLUGIN_YML]: async () => await interopImport(import("eslint-plugin-yml")),
+	[ESLINT_PACKAGES.ESLINT_CSS]: async () => interopImport(import("@eslint/css")),
+	[ESLINT_PACKAGES.ESLINT_JSON]: async () => interopImport(import("@eslint/json")),
+	[ESLINT_PACKAGES.ESLINT_IMPORT_RESOLVER_TYPESCRIPT]: async () => interopImport(import("eslint-import-resolver-typescript")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_ANTFU]: async () => interopImport(import("eslint-plugin-antfu")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_ESLINT_COMMENTS]: async () => interopImport(import("@eslint-community/eslint-plugin-eslint-comments")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_IMPORT_X]: async () => interopImport(import("eslint-plugin-import-x")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSDOC]: async () => interopImport(import("eslint-plugin-jsdoc")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSONC]: async () => interopImport(import("eslint-plugin-jsonc")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_JSDOC_PROCESSOR]: async () => interopImport(import("eslint-plugin-jsdoc/getJsdocProcessorPlugin.js")),
+	[ESLINT_PACKAGES.ESLINT_MARKDOWN]: async () => interopImport(import("@eslint/markdown")),
+	[ESLINT_PACKAGES.ESLINT_MERGE_PROCESSORS]: async () => interopImport(import("eslint-merge-processors")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_N]: async () => interopImport(import("eslint-plugin-n")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_PERFECTIONIST]: async () => interopImport(import("eslint-plugin-perfectionist")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_REGEXP]: async () => interopImport(import("eslint-plugin-regexp")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_STYLISTIC]: async () => interopImport(import("@stylistic/eslint-plugin")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_SVELTE]: async () => interopImport(import("eslint-plugin-svelte")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_TOML]: async () => interopImport(import("eslint-plugin-toml")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_UNICORN]: async () => interopImport(import("eslint-plugin-unicorn")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_UNUSED_IMPORTS]: async () => interopImport(import("eslint-plugin-unused-imports")),
+	[ESLINT_PACKAGES.ESLINT_PLUGIN_YML]: async () => interopImport(import("eslint-plugin-yml")),
 	[ESLINT_PACKAGES.SVELTE]: () => isPackageExists(ESLINT_PACKAGES.SVELTE),
+	[ESLINT_PACKAGES.TAILWINDCSS]: () => isPackageExists(ESLINT_PACKAGES.TAILWINDCSS),
 	[ESLINT_PACKAGES.TYPESCRIPT]: () => isPackageExists(ESLINT_PACKAGES.TYPESCRIPT),
-	[ESLINT_PACKAGES.TYPESCRIPT_ESLINT]: async () => await interopImport(import("typescript-eslint")),
-	[ESLINT_PACKAGES.VITEST_ESLINT_PLUGIN]: async () => await interopImport(import("@vitest/eslint-plugin"))
+	[ESLINT_PACKAGES.TYPESCRIPT_ESLINT]: async () => interopImport(import("typescript-eslint")),
+	[ESLINT_PACKAGES.VITEST_ESLINT_PLUGIN]: async () => interopImport(import("@vitest/eslint-plugin"))
+};
+const COMMITLINT_PACKAGES = {
+	COMMITLINT_CONFIG_CONVENTIONAL: "@commitlint/config-conventional",
+	COMMITLINT_PLUGIN_FUNCTION_RULES: "commitlint-plugin-function-rules",
+	COMMITLINT_PLUGIN_TENSE: "commitlint-plugin-tense"
+};
+const COMMITLINT_PACKAGE_RESOLVERS = {
+	[COMMITLINT_PACKAGES.COMMITLINT_CONFIG_CONVENTIONAL]: () => isPackageExists(COMMITLINT_PACKAGES.COMMITLINT_CONFIG_CONVENTIONAL),
+	[COMMITLINT_PACKAGES.COMMITLINT_PLUGIN_FUNCTION_RULES]: () => isPackageExists(COMMITLINT_PACKAGES.COMMITLINT_PLUGIN_FUNCTION_RULES),
+	[COMMITLINT_PACKAGES.COMMITLINT_PLUGIN_TENSE]: () => isPackageExists(COMMITLINT_PACKAGES.COMMITLINT_PLUGIN_TENSE)
+};
+const MARKDOWNLINT_PACKAGES = {
+	MARKDOWNLINT_GITHUB: "@github/markdownlint-github",
+	MARKDOWNLINT_RULES: "@hongminhee/markdownlint-rules",
+	MARKDOWNLINT_RULE_NO_TRAILING_SLASH_IN_LINKS: "markdownlint-rule-no-trailing-slash-in-links",
+	MARKDOWNLINT_RULE_RELATIVE_LINKS: "markdownlint-rule-relative-links",
+	MARKDOWNLINT_RULE_SEARCH_REPLACE: "markdownlint-rule-search-replace",
+	MARKDOWNLINT_RULE_TABLE_FORMAT: "markdownlint-rule-table-format"
+};
+const MARKDOWNLINT_PACKAGE_RESOLVERS = {
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_GITHUB]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_GITHUB),
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULES]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULES),
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_NO_TRAILING_SLASH_IN_LINKS]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_NO_TRAILING_SLASH_IN_LINKS),
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_RELATIVE_LINKS]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_RELATIVE_LINKS),
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_SEARCH_REPLACE]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_SEARCH_REPLACE),
+	[MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_TABLE_FORMAT]: () => isPackageExists(MARKDOWNLINT_PACKAGES.MARKDOWNLINT_RULE_TABLE_FORMAT)
 };
 const STYLELINT_PACKAGES = {
 	POSTCSS_HTML: "postcss-html",
 	STYLELINT_CONFIG_CSS_MODULES: "stylelint-config-css-modules",
 	STYLELINT_CONFIG_HTML: "stylelint-config-html",
 	STYLELINT_CONFIG_RECESS_ORDER: "stylelint-config-recess-order",
+	STYLELINT_CONFIG_STANDARD_LESS: "stylelint-config-standard-less",
 	STYLELINT_CONFIG_STANDARD_SCSS: "stylelint-config-standard-scss",
 	STYLELINT_DECLARATION_STRICT_VALUE: "stylelint-declaration-strict-value",
 	STYLELINT_ORDER: "stylelint-order",
 	STYLELINT_PLUGIN_DEFENSIVE_CSS: "stylelint-plugin-defensive-css",
-	STYLELINT_PLUGIN_LOGICAL_CSS: "stylelint-plugin-logical-css",
 	STYLELINT_PLUGIN_USE_BASELINE: "stylelint-plugin-use-baseline",
 	STYLELINT_USE_NESTING: "stylelint-use-nesting",
 	STYLISTIC_STYLELINT_CONFIG: "@stylistic/stylelint-config"
@@ -100,51 +143,98 @@ const STYLELINT_PACKAGE_RESOLVERS = {
 	[STYLELINT_PACKAGES.STYLELINT_CONFIG_CSS_MODULES]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_CONFIG_CSS_MODULES),
 	[STYLELINT_PACKAGES.STYLELINT_CONFIG_HTML]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_CONFIG_HTML),
 	[STYLELINT_PACKAGES.STYLELINT_CONFIG_RECESS_ORDER]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_CONFIG_RECESS_ORDER),
+	[STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_LESS]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_LESS),
 	[STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_SCSS]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_CONFIG_STANDARD_SCSS),
 	[STYLELINT_PACKAGES.STYLELINT_DECLARATION_STRICT_VALUE]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_DECLARATION_STRICT_VALUE),
 	[STYLELINT_PACKAGES.STYLELINT_ORDER]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_ORDER),
 	[STYLELINT_PACKAGES.STYLELINT_PLUGIN_DEFENSIVE_CSS]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_PLUGIN_DEFENSIVE_CSS),
-	[STYLELINT_PACKAGES.STYLELINT_PLUGIN_LOGICAL_CSS]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_PLUGIN_LOGICAL_CSS),
 	[STYLELINT_PACKAGES.STYLELINT_PLUGIN_USE_BASELINE]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_PLUGIN_USE_BASELINE),
 	[STYLELINT_PACKAGES.STYLELINT_USE_NESTING]: () => isPackageExists(STYLELINT_PACKAGES.STYLELINT_USE_NESTING),
 	[STYLELINT_PACKAGES.STYLISTIC_STYLELINT_CONFIG]: () => isPackageExists(STYLELINT_PACKAGES.STYLISTIC_STYLELINT_CONFIG)
 };
+const VITEST_PACKAGES = {
+	HAPPY_DOM: "happy-dom",
+	JSDOM: "jsdom",
+	VITEST_UI: "@vitest/ui"
+};
+const VITEST_PACKAGE_RESOLVERS = {
+	[VITEST_PACKAGES.HAPPY_DOM]: () => isPackageExists(VITEST_PACKAGES.HAPPY_DOM),
+	[VITEST_PACKAGES.JSDOM]: () => isPackageExists(VITEST_PACKAGES.JSDOM),
+	[VITEST_PACKAGES.VITEST_UI]: () => isPackageExists(VITEST_PACKAGES.VITEST_UI)
+};
 //#endregion
 //#region ../src/js/shared/utils/string.ts
+/**
+* @internal @brnshkr/config
+*/
 const joinAsQuotedList = (strings, type = "conjunction") => strings.length > 1 ? `"${strings.slice(0, -1).join("\", \"")}" ${type === "conjunction" ? "and" : "or"} "${strings.slice(-1).join("")}"` : {
 	0: "",
 	1: `"${strings[0] ?? ""}"`
 }[strings.length] ?? "";
 //#endregion
 //#region ../src/js/shared/utils/module.ts
+/**
+* @internal @brnshkr/config
+*/
 const PACKAGE_RESOLVERS = {
+	...COMMITLINT_PACKAGE_RESOLVERS,
 	...ESLINT_PACKAGE_RESOLVERS,
-	...STYLELINT_PACKAGE_RESOLVERS
+	...MARKDOWNLINT_PACKAGE_RESOLVERS,
+	...STYLELINT_PACKAGE_RESOLVERS,
+	...VITEST_PACKAGE_RESOLVERS
 };
 const warnMissingPackages = (moduleInfo, packages, type) => {
-	log("error", `Failed resolving required dependencies for module "${moduleInfo.name}". Please install ${joinAsQuotedList([...packages], type === "requiredAny" ? "disjunction" : "conjunction")} or disable the ${moduleInfo.name} module in the config.`);
-	log("log", `Run \`bun a -D -E ${packages.join(" ")}\` to install.`);
+	log(`Failed resolving required dependencies for module "${moduleInfo.name}". Please install ${joinAsQuotedList([...packages], type === "requiredAny" ? "disjunction" : "conjunction")} or disable the ${moduleInfo.name} module in the config.`);
+	log(`Run \`bun a -D -E ${packages.join(" ")}\` to install.`);
 };
 const packageCache = {};
+const loadPackageAsynchronously = async (thePackage) => {
+	try {
+		return await PACKAGE_RESOLVERS[thePackage]();
+	} catch {
+		return false;
+	}
+};
+const loadPackageSynchronously = (thePackage) => {
+	try {
+		return PACKAGE_RESOLVERS[thePackage]();
+	} catch {
+		return false;
+	}
+};
+const collectPackagesAsynchronously = async (moduleInfo, type, packages) => {
+	const collectedPackages = [];
+	for (const thePackage of packages) {
+		const resolvedPackage = packageCache[thePackage] ?? await loadPackageAsynchronously(thePackage);
+		packageCache[thePackage] ??= resolvedPackage;
+		if (type === "requiredAll" && resolvedPackage === false) {
+			warnMissingPackages(moduleInfo, packages, type);
+			break;
+		}
+		collectedPackages.push(resolvedPackage === false ? void 0 : resolvedPackage);
+	}
+	return collectedPackages;
+};
+const collectPackagesSynchronously = (moduleInfo, type, packages) => {
+	const collectedPackages = [];
+	for (const thePackage of packages) {
+		const resolvedPackage = packageCache[thePackage] ?? loadPackageSynchronously(thePackage);
+		packageCache[thePackage] ??= resolvedPackage;
+		if (type === "requiredAll" && resolvedPackage === false) {
+			warnMissingPackages(moduleInfo, packages, type);
+			break;
+		}
+		collectedPackages.push(resolvedPackage === false ? void 0 : resolvedPackage);
+	}
+	return collectedPackages;
+};
 const resolvePackagesSharedAsynchronously = async (moduleInfo, type) => {
 	if (moduleInfo.packages === void 0) return {};
 	const resolvedPackages = {};
 	const packages = type === void 0 ? moduleInfo.packages : { [type]: moduleInfo.packages[type] };
 	for (const [currentType, currentPackages] of objectEntries(packages)) {
 		if (!currentPackages || currentPackages.length === 0) continue;
-		resolvedPackages[currentType] ??= [];
-		for (const currentPackage of currentPackages) try {
-			const resolvedPackage = packageCache[currentPackage] ?? await PACKAGE_RESOLVERS[currentPackage]();
-			packageCache[currentPackage] ??= resolvedPackage;
-			if (resolvedPackage === false) throw new Error("Skip to catch block.");
-			resolvedPackages[currentType].push(resolvedPackage);
-		} catch {
-			if (currentType === "requiredAll") {
-				warnMissingPackages(moduleInfo, currentPackages, currentType);
-				break;
-			}
-			resolvedPackages[currentType].push(void 0);
-		}
+		resolvedPackages[currentType] = await collectPackagesAsynchronously(moduleInfo, currentType, currentPackages);
 		if (currentType === "requiredAny" && resolvedPackages[currentType].filter((thePackage) => thePackage !== void 0).length === 0) warnMissingPackages(moduleInfo, currentPackages, currentType);
 	}
 	return type === void 0 ? resolvedPackages : resolvedPackages[type] ?? [];
@@ -155,19 +245,7 @@ const resolvePackagesSharedSynchronously = (moduleInfo, type) => {
 	const packages = type === void 0 ? moduleInfo.packages : { [type]: moduleInfo.packages[type] };
 	for (const [currentType, currentPackages] of objectEntries(packages)) {
 		if (!currentPackages || currentPackages.length === 0) continue;
-		resolvedPackages[currentType] ??= [];
-		for (const currentPackage of currentPackages) try {
-			const resolvedPackage = packageCache[currentPackage] ?? PACKAGE_RESOLVERS[currentPackage]();
-			packageCache[currentPackage] ??= resolvedPackage;
-			if (resolvedPackage === false) throw new Error("Skip to catch block.");
-			resolvedPackages[currentType].push(resolvedPackage);
-		} catch {
-			if (currentType === "requiredAll") {
-				warnMissingPackages(moduleInfo, currentPackages, currentType);
-				break;
-			}
-			resolvedPackages[currentType].push(void 0);
-		}
+		resolvedPackages[currentType] = collectPackagesSynchronously(moduleInfo, currentType, currentPackages);
 		if (currentType === "requiredAny" && resolvedPackages[currentType].filter((thePackage) => thePackage !== void 0).length === 0) warnMissingPackages(moduleInfo, currentPackages, currentType);
 	}
 	return type === void 0 ? resolvedPackages : resolvedPackages[type] ?? [];
@@ -180,13 +258,31 @@ const isModuleEnabledByDefault = (moduleInfo) => {
 	let isEnabled = false;
 	for (const [currentType, currentPackages] of objectEntries(packages)) {
 		if (currentType === "optional") continue;
-		if (currentPackages && currentPackages.length > 0) isEnabled = currentType === "requiredAll" ? doAllPackagesExist(currentPackages) : doesAnyPackageExist(currentPackages);
+		if (currentPackages && currentPackages.length > 0) isEnabled = (currentType === "requiredAll" ? doAllPackagesExist : doesAnyPackageExist)(currentPackages);
 		if (isEnabled) break;
 	}
 	return isEnabled;
 };
+const createModuleState = () => {
+	const enabledStates = {};
+	return {
+		isModuleEnabled: (moduleInfo) => enabledStates[moduleInfo.name] ?? isModuleEnabledByDefault(moduleInfo),
+		setModuleEnabled: (moduleInfo, isEnabled) => {
+			enabledStates[moduleInfo.name] = isEnabled;
+		}
+	};
+};
 //#endregion
 //#region ../src/js/shared/utils/globs.ts
+/**
+* @internal @brnshkr/config
+*/
+const GLOB_TEST_FILES = [
+	"**/__tests__/**/*.?(c|m)[jt]s?(x)",
+	"**/*.spec.?(c|m)[jt]s?(x)",
+	"**/*.test.?(c|m)[jt]s?(x)"
+];
+const GLOB_BENCHMARK_FILES = ["**/*.bench.?(c|m)[jt]s?(x)", "**/*.benchmark.?(c|m)[jt]s?(x)"];
 const GLOB_IGNORES = [
 	"**/.cache/**",
 	"**/.changeset/**",
@@ -195,6 +291,7 @@ const GLOB_IGNORES = [
 	"**/.hg/store/**",
 	"**/.history/**",
 	"**/.idea/**",
+	"**/.local/**",
 	"**/.next/**",
 	"**/.nuxt/**",
 	"**/.output/**",
@@ -204,7 +301,9 @@ const GLOB_IGNORES = [
 	"**/.vercel/**",
 	"**/.vite-inspect/**",
 	"**/.vitepress/cache/**",
+	"**/.vitest/**",
 	"**/.yarn/**",
+	"**/__generated__/**",
 	"**/__snapshots__/**",
 	"**/*.code-search",
 	"**/*.example",
@@ -219,13 +318,256 @@ const GLOB_IGNORES = [
 	"**/package-lock.json",
 	"**/pnpm-lock.yaml",
 	"**/temp/**",
+	"**/tests/**/[Ff]ixture?(s)/**",
 	"**/tmp/**",
 	"**/vendor/**",
 	"**/vite.config.*.timestamp-*",
 	"**/yarn.lock"
 ];
 //#endregion
+//#region ../src/js/shared/utils/filesystem.ts
+/**
+* @internal @brnshkr/config
+*/
+const toPosix = (value) => value.replaceAll("\\", "/");
+const doesFileExist = (filePath) => {
+	try {
+		fs.accessSync(filePath, fs.constants.R_OK);
+		return true;
+	} catch {
+		return false;
+	}
+};
+const getMtime = (filePath) => {
+	try {
+		return fs.statSync(filePath).mtimeMs;
+	} catch {
+		return;
+	}
+};
+const readTextFile = (filePath) => {
+	try {
+		return fs.readFileSync(filePath, "utf-8");
+	} catch {
+		return;
+	}
+};
+const readJsonFile = (filePath) => {
+	const content = readTextFile(filePath);
+	if (content === void 0) return;
+	try {
+		return JSON.parse(content);
+	} catch {
+		return;
+	}
+};
+const readJsonObjectFile = (filePath) => {
+	const parsedContent = readJsonFile(filePath);
+	return isPlainObject(parsedContent) ? parsedContent : void 0;
+};
+const findNearestPackageJson = (startDirectory) => {
+	let current = path.resolve(startDirectory);
+	let parent = path.dirname(current);
+	while (current !== parent) {
+		const candidate = path.join(current, "package.json");
+		if (doesFileExist(candidate)) return candidate;
+		current = parent;
+		parent = path.dirname(current);
+	}
+};
+//#endregion
 //#region ../src/js/shared/utils/constants.ts
 const QUOTES = "single";
 //#endregion
-export { resolvePackagesSharedSynchronously as a, objectAssign as c, packageOrganization as d, packageOrganizationUpper as f, resolvePackagesSharedAsynchronously as i, objectEntries as l, GLOB_IGNORES as n, ESLINT_PACKAGES as o, version as p, isModuleEnabledByDefault as r, STYLELINT_PACKAGES as s, QUOTES as t, objectFromEntries as u };
+//#region ../src/js/spelling/utils/files.ts
+/**
+* @internal @brnshkr/config/spelling
+*/
+const COMMAND_TIMEOUT_MILLISECONDS = 6e4;
+const listTrackedFiles = (rootDirectory) => {
+	return execFileSync("git", ["ls-files", "-z"], {
+		cwd: rootDirectory,
+		encoding: "utf-8",
+		maxBuffer: Infinity,
+		timeout: COMMAND_TIMEOUT_MILLISECONDS
+	}).split("\0").filter((filePath) => filePath !== "");
+};
+const isScannedPath = (filePath, scannedExtensions, scannedNames, ignoreExpressions) => {
+	if (ignoreExpressions.some((ignoreExpression) => ignoreExpression.test(filePath))) return false;
+	return scannedNames.has(path.basename(filePath)) || scannedExtensions.has(path.extname(filePath));
+};
+const collectFilePaths = (rootDirectory, settings) => {
+	const scannedExtensions = new Set(settings.fileExtensions);
+	const scannedNames = new Set(settings.fileNames);
+	const ignoreExpressions = settings.ignorePatterns.map((ignorePattern) => new RegExp(ignorePattern, "u"));
+	return listTrackedFiles(rootDirectory).filter((filePath) => isScannedPath(filePath, scannedExtensions, scannedNames, ignoreExpressions)).filter((filePath) => doesFileExist(path.join(rootDirectory, filePath)));
+};
+//#endregion
+//#region ../src/js/spelling/utils/patterns.ts
+/**
+* @internal @brnshkr/config/spelling
+*/
+const buildPatterns = (settings) => {
+	const stemSuffixGroup = `(?:${settings.stemSuffixes.join("|")})`;
+	return [...objectEntries(settings.britishSpellings).map(([britishSpelling, americanSpelling]) => ({
+		pattern: new RegExp(String.raw`\b${britishSpelling}\w*`, "giv"),
+		toAmericanSpelling: (word) => americanSpelling + word.slice(britishSpelling.length)
+	})), ...settings.britishStems.map((britishStem) => ({
+		pattern: new RegExp(String.raw`\b${britishStem}${stemSuffixGroup}\b`, "giv"),
+		toAmericanSpelling: (word) => `${britishStem.slice(0, -1)}z${word.slice(britishStem.length)}`
+	}))];
+};
+//#endregion
+//#region ../src/js/spelling/utils/settings.ts
+/**
+* @internal @brnshkr/config/spelling
+*/
+const EVERY_PATH$1 = "*";
+const DEFAULTS_FILE = "defaults.json";
+const LINE_SUFFIX_PATTERN = /^(?<text>.*):(?<lineNumbers>\d+(?:,\d+)*)$/v;
+const findShippedDirectory = () => {
+	const packageJsonPath = findNearestPackageJson(import.meta.dirname);
+	if (packageJsonPath === void 0) throw new Error("Unable to locate the shipped defaults of \"@brnshkr/config\".");
+	return path.join(path.dirname(packageJsonPath), "conf", "spelling");
+};
+const readSettingsFile = (filePath) => {
+	const settings = readJsonObjectFile(filePath);
+	if (settings === void 0) throw new Error(`Unable to read "${filePath}".`);
+	return settings;
+};
+const readStringList = (settings, settingName) => {
+	const declaredSetting = settings[settingName];
+	return Array.isArray(declaredSetting) ? declaredSetting.filter((entry) => typeof entry === "string") : [];
+};
+const readStringMap = (settings, settingName) => {
+	const declaredSetting = settings[settingName];
+	const stringMap = {};
+	if (!isPlainObject(declaredSetting)) return stringMap;
+	for (const [settingKey, entry] of objectEntries(declaredSetting)) if (typeof entry === "string") stringMap[settingKey] = entry;
+	return stringMap;
+};
+const readStringListMap = (settings, settingName) => {
+	const declaredSetting = settings[settingName];
+	const stringListMap = {};
+	if (!isPlainObject(declaredSetting)) return stringListMap;
+	for (const settingKey of objectKeys(declaredSetting)) stringListMap[settingKey] = readStringList(declaredSetting, settingKey);
+	return stringListMap;
+};
+const toSettings = (settings) => ({
+	fileExtensions: readStringList(settings, "fileExtensions"),
+	fileNames: readStringList(settings, "fileNames"),
+	ignorePatterns: readStringList(settings, "ignorePatterns"),
+	britishSpellings: readStringMap(settings, "britishSpellings"),
+	britishStems: readStringList(settings, "britishStems"),
+	stemSuffixes: readStringList(settings, "stemSuffixes"),
+	allowlist: readStringListMap(settings, "allowlist")
+});
+const mergeLists = (shippedEntries, declaredEntries) => [.../* @__PURE__ */ new Set([...shippedEntries, ...declaredEntries])];
+const mergeSettings = (shippedSettings, declaredSettings) => ({
+	fileExtensions: mergeLists(shippedSettings.fileExtensions, declaredSettings.fileExtensions),
+	fileNames: mergeLists(shippedSettings.fileNames, declaredSettings.fileNames),
+	ignorePatterns: mergeLists(shippedSettings.ignorePatterns, declaredSettings.ignorePatterns),
+	britishSpellings: {
+		...shippedSettings.britishSpellings,
+		...declaredSettings.britishSpellings
+	},
+	britishStems: mergeLists(shippedSettings.britishStems, declaredSettings.britishStems),
+	stemSuffixes: mergeLists(shippedSettings.stemSuffixes, declaredSettings.stemSuffixes),
+	allowlist: {
+		...shippedSettings.allowlist,
+		...declaredSettings.allowlist
+	}
+});
+const readSettings = (rootDirectory, configPath) => {
+	const shippedPath = path.join(findShippedDirectory(), DEFAULTS_FILE);
+	const shippedSettings = toSettings(readSettingsFile(shippedPath));
+	const settingsPath = path.resolve(rootDirectory, configPath);
+	return doesFileExist(settingsPath) ? mergeSettings(shippedSettings, toSettings(readSettingsFile(settingsPath))) : shippedSettings;
+};
+const parseAllowedLiterals = (declaredLiterals) => declaredLiterals.map((declaredLiteral) => {
+	const matchedGroups = LINE_SUFFIX_PATTERN.exec(declaredLiteral)?.groups;
+	return {
+		text: matchedGroups?.["text"] ?? declaredLiteral,
+		lineNumbers: matchedGroups === void 0 ? void 0 : (matchedGroups["lineNumbers"] ?? "").split(",").map(Number)
+	};
+});
+const isCoveredBy = (coveringCandidate, allowedLiteral) => {
+	if (coveringCandidate.text.toLowerCase() !== allowedLiteral.text.toLowerCase()) return false;
+	if (coveringCandidate.lineNumbers === void 0) return true;
+	return allowedLiteral.lineNumbers?.every((lineNumber) => coveringCandidate.lineNumbers?.includes(lineNumber) === true) ?? false;
+};
+const formatAllowedLiteral = ({ text, lineNumbers }) => lineNumbers === void 0 ? text : `${text}:${lineNumbers.join(",")}`;
+const rejectCoveredLiterals = (allowlist) => {
+	const literalsAllowedEverywhere = allowlist[EVERY_PATH$1] ?? [];
+	for (const [allowedPath, allowedLiterals] of objectEntries(allowlist)) for (const [index, allowedLiteral] of allowedLiterals.entries()) {
+		const coveringLiteral = [...allowedPath === EVERY_PATH$1 ? [] : literalsAllowedEverywhere, ...allowedLiterals.slice(0, index)].find((coveringCandidate) => isCoveredBy(coveringCandidate, allowedLiteral));
+		if (coveringLiteral !== void 0) throw new Error(`Allowed word "${formatAllowedLiteral(allowedLiteral)}" under "${allowedPath}" is already covered by "${formatAllowedLiteral(coveringLiteral)}".`);
+	}
+};
+const readAllowlist = (settings) => {
+	const allowlist = {};
+	const allowlistEntries = objectEntries(settings.allowlist ?? {});
+	for (const [allowedPath, declaredLiterals] of allowlistEntries) allowlist[allowedPath] = parseAllowedLiterals(declaredLiterals);
+	rejectCoveredLiterals(allowlist);
+	return allowlist;
+};
+//#endregion
+//#region ../src/js/spelling/index.ts
+const EVERY_PATH = "*";
+const DEFAULT_CONFIG_PATH = "conf/spelling.json";
+const REGEX_METACHARACTERS = /[$\(\)*+.?\[\\\]^\{\|\}]/gv;
+const escapeRegexLiteral = (value) => value.replaceAll(REGEX_METACHARACTERS, String.raw`\$&`);
+const maskAllowedLiterals = (line, allowedLiterals, lineNumber) => {
+	let maskedLine = line;
+	for (const { text, lineNumbers } of allowedLiterals) if (lineNumbers === void 0 || lineNumbers.includes(lineNumber)) maskedLine = maskedLine.replaceAll(new RegExp(escapeRegexLiteral(text), "giu"), (matchedText) => ".".repeat(matchedText.length));
+	return maskedLine;
+};
+const compareCaseInsensitively = (firstValue, secondValue) => {
+	const firstLowercased = firstValue.toLowerCase();
+	const secondLowercased = secondValue.toLowerCase();
+	if (firstLowercased !== secondLowercased) return firstLowercased < secondLowercased ? -1 : 1;
+	return firstValue < secondValue ? -1 : Number(firstValue > secondValue);
+};
+const compareFindings = (firstFinding, secondFinding) => {
+	const pathOrder = compareCaseInsensitively(firstFinding.path, secondFinding.path);
+	if (pathOrder !== 0) return pathOrder;
+	return firstFinding.line === secondFinding.line ? compareCaseInsensitively(firstFinding.word, secondFinding.word) : firstFinding.line - secondFinding.line;
+};
+const findInFile = (fileContents, filePath, patterns, allowlist) => {
+	const allowedLiterals = [...allowlist[EVERY_PATH] ?? [], ...allowlist[filePath] ?? []];
+	const findings = [];
+	for (const [index, line] of fileContents.split("\n").entries()) {
+		const lineNumber = index + 1;
+		const maskedLine = maskAllowedLiterals(line, allowedLiterals, lineNumber);
+		for (const { pattern, toAmericanSpelling } of patterns) for (const [word] of maskedLine.matchAll(pattern)) findings.push({
+			path: filePath,
+			line: lineNumber,
+			word,
+			suggestion: toAmericanSpelling(word)
+		});
+	}
+	return findings;
+};
+/**
+* Report every British spelling in a repository's tracked prose, docblocks and identifiers.
+*
+* @api
+*
+* @param options where to scan, which settings to read, and which files to look at
+*
+* @returns every finding, sorted by path, line and word
+*
+* @example
+* ```js
+* scan({ rootDirectory: process.cwd() });
+* ```
+*/
+const scan = (options) => {
+	const { rootDirectory = process.cwd(), configPath = DEFAULT_CONFIG_PATH, paths } = options ?? {};
+	const settings = readSettings(rootDirectory, configPath);
+	const allowlist = readAllowlist(settings);
+	const patterns = buildPatterns(settings);
+	return (paths ?? collectFilePaths(rootDirectory, settings)).map((filePath) => findInFile(readTextFile(path.join(rootDirectory, filePath)) ?? "", filePath, patterns, allowlist)).flat().toSorted(compareFindings);
+};
+//#endregion
+export { name as A, objectAssign as C, objectValues as D, objectKeys as E, packageOrganization as O, isPlainObject as S, objectFromEntries as T, COMMITLINT_PACKAGES as _, getMtime as a, STYLELINT_PACKAGES as b, toPosix as c, GLOB_TEST_FILES as d, createModuleState as f, resolvePackagesSharedSynchronously as g, resolvePackagesSharedAsynchronously as h, findNearestPackageJson as i, version as j, packageOrganizationUpper as k, GLOB_BENCHMARK_FILES as l, isModuleEnabledByDefault as m, QUOTES as n, readJsonObjectFile as o, doAllPackagesExist as p, doesFileExist as r, readTextFile as s, scan as t, GLOB_IGNORES as u, ESLINT_PACKAGES as v, objectEntries as w, VITEST_PACKAGES as x, MARKDOWNLINT_PACKAGES as y };

package/dist/spelling/index.d.mts

@@ -0,0 +1,30 @@
+//#region ../src/js/spelling/types/options.d.ts
+interface SpellingOptions {
+  rootDirectory?: string;
+  configPath?: string;
+  paths?: string[];
+}
+interface SpellingFinding {
+  path: string;
+  line: number;
+  word: string;
+  suggestion: string;
+}
+//#endregion
+//#region ../src/js/spelling/index.d.ts
+/**
+ * Report every British spelling in a repository's tracked prose, docblocks and identifiers.
+ *
+ * @api
+ *
+ * @param options where to scan, which settings to read, and which files to look at
+ *
+ * @returns every finding, sorted by path, line and word
+ *
+ * @example
+ * ```js
+ * scan({ rootDirectory: process.cwd() });
+ * ```
+ */
+export declare const scan: (options?: Partial<SpellingOptions>) => SpellingFinding[];
+//#endregion

package/dist/spelling/index.mjs

@@ -0,0 +1,2 @@
+import { t as scan } from "../shared.mjs";
+export { scan };

package/dist/spelling/spelling.test.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/spelling/spelling.test.mjs

@@ -0,0 +1,12 @@
+import { t as scan } from "../shared.mjs";
+import { expect, test } from "vitest";
+//#region ../src/js/spelling/spelling.test.ts
+/**
+* @internal @brnshkr/config/spelling
+*/
+test("every tracked file is written in american english", () => {
+	const findings = scan().map(({ path, line, word, suggestion }) => `${path}:${String(line)} — "${word}", use "${suggestion}"`);
+	expect(findings).toStrictEqual([]);
+});
+//#endregion
+export {};