mdat 2.3.6 → 3.1.0

package/dist/bin/cli.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
+import { createLogger, getChildLogger, injectionHelper } from "lognow";
 import picocolors from "picocolors";
 import prettyMilliseconds from "pretty-ms";
 import { getMdatReports, getSoleRule, mdatCollapse, mdatDiff, mdatExpand, mdatSplit, mdatStrip, reporterMdat, rulesSchema, setLogger } from "remark-mdat";
-import { createLogger, getChildLogger, injectionHelper } from "lognow";
-import { defineTemplate, getMetadata, helpers, setLogger as setLogger$1, templates } from "metascope";
 import { read, write } from "to-vfile";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -15,6 +14,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import plur from "plur";
 import { deepmerge } from "deepmerge-ts";
+import { defineTemplate, getMetadata, helpers, setLogger as setLogger$1, templates } from "metascope";
 import { z } from "zod";
 import { globby } from "globby";
 import { isFile, isFileSync } from "path-type";
@@ -29,7 +29,21 @@ import { confirm, group, intro, note, outro, select } from "@clack/prompts";
 
 //#region package.json
 var name = "mdat";
-var version = "2.3.6";
+var version = "3.1.0";
+
+//#endregion
+//#region src/lib/deep-merge-defined.ts
+function stripUndefinedDeep(object) {
+	if (Array.isArray(object)) return object.map((v) => v !== null && typeof v === "object" ? stripUndefinedDeep(v) : v).filter((v) => v !== void 0);
+	return Object.entries(object).map(([k, v]) => [k, v !== null && typeof v === "object" ? stripUndefinedDeep(v) : v]).reduce((acc, [k, v]) => v === void 0 ? acc : {
+		...acc,
+		[k]: v
+	}, {});
+}
+function deepMergeDefined(...objects) {
+	const stripped = objects.map((v, i) => i === 0 ? v : stripUndefinedDeep(v));
+	return deepmerge(...stripped);
+}
 
 //#endregion
 //#region src/lib/log.ts
@@ -55,19 +69,6 @@ function setLogger$2(logger) {
 	setLogger$1(getChildLogger(log, "metascope"));
 }
 
-//#endregion
-//#region src/lib/deep-merge-defined.ts
-function stripUndefinedDeep(object) {
-	if (Array.isArray(object)) return object.map((v) => v && typeof v === "object" ? stripUndefinedDeep(v) : v).filter((v) => v !== void 0);
-	return Object.entries(object).map(([k, v]) => [k, v && typeof v === "object" ? stripUndefinedDeep(v) : v]).reduce((acc, [k, v]) => v === void 0 ? acc : {
-		...acc,
-		[k]: v
-	}, {});
-}
-function deepMergeDefined(...objects) {
-	return deepmerge(...objects.map((v, i) => i === 0 ? v : stripUndefinedDeep(v)));
-}
-
 //#endregion
 //#region src/lib/mdat-json-loader.ts
 /**
@@ -82,7 +83,7 @@ function mdatJsonLoader(filePath, content) {
 }
 function flattenJson(jsonObject, parentKey = "", result = {}) {
 	for (const [key, value] of Object.entries(jsonObject)) {
-		const fullPath = parentKey ? `${parentKey}.${key}` : key;
+		const fullPath = parentKey === "" ? key : `${parentKey}.${key}`;
 		if (typeof value === "object" && value !== null && !Array.isArray(value)) flattenJson(value, fullPath, result);
 		else if (value === null) result[fullPath] = "null";
 		else result[fullPath] = value.toString();
@@ -111,6 +112,7 @@ async function getContextMetadata() {
 			"codemetaJson",
 			"gitConfig",
 			"githubActions",
+			"gitStats",
 			"goGoMod",
 			"goGoreleaserYaml",
 			"javaPomXml",
@@ -137,16 +139,17 @@ async function getContextMetadata() {
 	});
 	return metascopeMetadata;
 }
-const GIT_PREFIX_REGEX = /^git\+/;
-const GIT_SUFFIX_REGEX = /\.git$/;
-const TRAILING_SLASH_REGEX = /\/$/;
+const GIT_PREFIX_REGEX = /^git\+/v;
+const GIT_SUFFIX_REGEX = /\.git$/v;
+const TRAILING_SLASH_REGEX = /\/$/v;
+const PACKAGE_MANAGER_REGEX = /^(?<name>[^@]+)@(?<version>[^+]+)/v;
 const readmeMetadataTemplate = defineTemplate((context) => {
-	const { githubActions, licenseFile, metascope, nodePackageJson } = context;
+	const { githubActions, gitStats, licenseFile, metascope, nodePackageJson } = context;
 	const codemeta = templates.codemetaJson(context, {});
 	const nodePackage = helpers.firstOf(nodePackageJson)?.data;
 	const licenseFileData = helpers.firstOf(licenseFile);
 	const ciActionFilePath = helpers.ensureArray(githubActions).find((entry) => entry.data.name.toLowerCase() === "ci")?.source;
-	const repositoryUrl = codemeta.codeRepository?.replace(GIT_PREFIX_REGEX, "").replace(GIT_SUFFIX_REGEX, "").replace(TRAILING_SLASH_REGEX, "");
+	const repoUrl = codemeta.codeRepository?.replace(GIT_PREFIX_REGEX, "").replace(GIT_SUFFIX_REGEX, "").replace(TRAILING_SLASH_REGEX, "");
 	const bin = (() => {
 		if (nodePackage === void 0) return;
 		const binField = nodePackage.bin;
@@ -174,13 +177,35 @@ const readmeMetadataTemplate = defineTemplate((context) => {
 			version
 		}));
 	})();
+	const developmentDependencies = (() => {
+		if (nodePackage === void 0) return;
+		const runtimes = helpers.ensureArray(nodePackage.devEngines?.runtime).map(({ name, version }) => ({
+			name,
+			version
+		}));
+		const packageManagers = helpers.ensureArray(nodePackage.devEngines?.packageManager).map(({ name, version }) => ({
+			name,
+			version
+		}));
+		const pinnedPackageManager = nodePackage.packageManager === void 0 ? void 0 : PACKAGE_MANAGER_REGEX.exec(nodePackage.packageManager)?.groups;
+		if (pinnedPackageManager?.name !== void 0 && pinnedPackageManager.version !== void 0 && packageManagers.every((entry) => entry.name !== pinnedPackageManager.name)) packageManagers.push({
+			name: pinnedPackageManager.name,
+			version: pinnedPackageManager.version
+		});
+		if (runtimes.length === 0 && packageManagers.length === 0) return;
+		return {
+			packageManagers: packageManagers.length > 0 ? packageManagers : void 0,
+			runtimes: runtimes.length > 0 ? runtimes : void 0
+		};
+	})();
 	const firstAuthor = helpers.firstOf(helpers.ensureArray(codemeta.author));
 	return {
 		author: helpers.firstOf(helpers.mixedStringsToArray(helpers.toBasicNames(codemeta.author))),
 		authorUrl: firstAuthor?.url,
 		bin,
-		ciActionFileName: ciActionFilePath ? path.basename(ciActionFilePath) : void 0,
+		ciActionFileName: ciActionFilePath === void 0 ? void 0 : path.basename(ciActionFilePath),
 		description: codemeta.description,
+		developmentDependencies,
 		engines,
 		isPublicNpmPackage: nodePackage?.private !== true && (nodePackage?.name.startsWith("@") && nodePackage.publishConfig?.access === "public" || true),
 		issuesUrl: codemeta.issueTracker,
@@ -191,8 +216,9 @@ const readmeMetadataTemplate = defineTemplate((context) => {
 		operatingSystem: codemeta.operatingSystem,
 		peerDependencies,
 		projectDirectory: metascope?.data.options.path === void 0 ? void 0 : `file://${metascope.data.options.path}`,
-		repositoryUrl,
+		repositoryUrl: repoUrl,
 		runtimePlatform: codemeta.runtimePlatform,
+		usesGitLfs: helpers.firstOf(gitStats)?.data.hasLfs === true,
 		usesPnpm: helpers.usesPnpm(nodePackageJson)
 	};
 });
@@ -204,7 +230,8 @@ let readmeMetadata;
 */
 async function getReadmeMetadata() {
 	if (readmeMetadata !== void 0) return readmeMetadata;
-	readmeMetadata = readmeMetadataTemplate(await getContextMetadata(), {});
+	const contextMetadata = await getContextMetadata();
+	readmeMetadata = readmeMetadataTemplate(contextMetadata, {});
 	return readmeMetadata;
 }
 
@@ -219,14 +246,15 @@ var badges_default = { badges: { async content(options) {
 		npm: z.array(z.string()).optional()
 	}).optional().parse(options);
 	const metadata = await getReadmeMetadata();
-	const { ciActionFileName, license, licenseUrl, name, repositoryUrl } = metadata;
+	const { ciActionFileName, license, licenseUrl, name, repositoryUrl, usesGitLfs } = metadata;
 	const badges = [];
 	if (validOptions?.npm === void 0) {
-		if (metadata.isPublicNpmPackage) badges.push(`[![NPM Package ${name}](https://img.shields.io/npm/v/${name}.svg)](https://npmjs.com/package/${name})`);
-	} else for (const name of validOptions.npm) badges.push(`[![NPM Package ${name}](https://img.shields.io/npm/v/${name}.svg)](https://npmjs.com/package/${name})`);
+		if (metadata.isPublicNpmPackage) badges.push(`[![NPM Package ${name}](https://img.shields.io/npm/v/${name}.svg)](https://www.npmjs.com/package/${name})`);
+	} else for (const packageName of validOptions.npm) badges.push(`[![NPM Package ${packageName}](https://img.shields.io/npm/v/${packageName}.svg)](https://www.npmjs.com/package/${packageName})`);
 	if (license !== void 0 && licenseUrl !== void 0) badges.push(`[![License: ${license}](https://img.shields.io/badge/License-${license.replaceAll("-", "--")}-yellow.svg)](${licenseUrl})`);
 	if (ciActionFileName !== void 0 && repositoryUrl !== void 0) badges.push(`[![CI](${repositoryUrl}/actions/workflows/${ciActionFileName}/badge.svg)](${repositoryUrl}/actions/workflows/${ciActionFileName})`);
-	if (validOptions?.custom !== void 0) for (const [name, { image, link }] of Object.entries(validOptions.custom)) badges.push(`[![${name}](${image})](${link})`);
+	if (usesGitLfs) badges.push("![Git LFS](https://img.shields.io/badge/Git%20LFS-enabled-F64935?logo=gitlfs&logoColor=white)");
+	if (validOptions?.custom !== void 0) for (const [badgeName, { image, link }] of Object.entries(validOptions.custom)) badges.push(`[![${badgeName}](${image})](${link})`);
 	return badges.join("\n");
 } } };
 
@@ -239,7 +267,7 @@ var banner_default = { banner: { async content(options) {
 	}).optional().parse(options);
 	const src = validOptions?.src ?? await getBannerSrc();
 	if (src === void 0) throw new Error("Banner image not found at any typical location, consider adding something at ./assets/banner.webp");
-	else if (!isUrl(src) && !await isFile(src)) throw new Error(`Banner image not found at "${src}"`);
+	if (!isUrl(src) && !await isFile(src)) throw new Error(`Banner image not found at "${src}"`);
 	let alt = validOptions?.alt;
 	if (alt === void 0) {
 		const { name: packageName } = await getReadmeMetadata();
@@ -251,7 +279,7 @@ var banner_default = { banner: { async content(options) {
 async function getBannerSrc() {
 	const { projectDirectory } = await getReadmeMetadata();
 	if (projectDirectory === void 0) throw new Error("No project directory found");
-	const paths = await globby([
+	const [firstPath] = await globby([
 		".",
 		"assets",
 		"media",
@@ -287,20 +315,19 @@ async function getBannerSrc() {
 			]
 		}
 	});
-	if (paths.length > 0) return path.relative(process.cwd(), paths[0]);
+	return firstPath === void 0 ? void 0 : path.relative(process.cwd(), firstPath);
 }
 function isUrl(text, lenient = true) {
 	if (typeof text !== "string") throw new TypeError("Expected a string");
 	text = text.trim();
 	if (text.includes(" ")) return false;
 	if (URL.canParse(text)) return true;
-	if (lenient) return isUrl(`https://${text}`, false);
-	return false;
+	return lenient && URL.canParse(`https://${text}`);
 }
 
 //#endregion
 //#region src/lib/readme/rules/code.ts
-const LEADING_DOT_REGEX = /^\./;
+const LEADING_DOT_REGEX = /^\./v;
 var code_default = { code: { async content(options) {
 	const validOptions = z.object({
 		file: z.string(),
@@ -349,7 +376,7 @@ const PLATFORM_INFO = {
 	},
 	node: {
 		display: "Node.js",
-		url: "https://nodejs.org/"
+		url: "https://nodejs.org/en"
 	},
 	python: {
 		display: "Python",
@@ -379,7 +406,7 @@ var dependencies_default = { dependencies: { async content() {
 		if (engines?.[platformKey] !== void 0) continue;
 		const info = PLATFORM_INFO[platformKey.toLowerCase()];
 		const display = info ? `[${info.display}](${info.url})` : platformKey;
-		platformItems.push(version ? `- ${display} ${version}` : `- ${display}`);
+		platformItems.push(version === void 0 || version === "" ? `- ${display}` : `- ${display} ${version}`);
 	}
 	if (operatingSystem !== void 0 && operatingSystem.length > 0) platformItems.push(`- Supported platforms: ${operatingSystem.join(", ")}`);
 	const peerItems = [];
@@ -409,6 +436,58 @@ var description_default = { description: { async content() {
 	return `**${description}**`;
 } } };
 
+//#endregion
+//#region src/lib/readme/rules/development-dependencies.ts
+const TOOL_INFO = {
+	bun: {
+		display: "Bun",
+		url: "https://bun.sh/"
+	},
+	deno: {
+		display: "Deno",
+		url: "https://deno.land/"
+	},
+	node: {
+		display: "Node.js",
+		url: "https://nodejs.org/en"
+	},
+	npm: {
+		display: "npm",
+		url: "https://www.npmjs.com/"
+	},
+	pnpm: {
+		display: "pnpm",
+		url: "https://pnpm.io/"
+	},
+	yarn: {
+		display: "Yarn",
+		url: "https://yarnpkg.com/"
+	}
+};
+var development_dependencies_default = { "development-dependencies": { async content() {
+	const { developmentDependencies } = await getReadmeMetadata();
+	if (developmentDependencies === void 0) return "";
+	const { packageManagers, runtimes } = developmentDependencies;
+	const items = [];
+	for (const { name, version } of [...runtimes ?? [], ...packageManagers ?? []]) {
+		const info = TOOL_INFO[name.toLowerCase()];
+		const display = info ? `[${info.display}](${info.url})` : name;
+		items.push(version === void 0 || version === "" ? `- ${display}` : `- ${display} ${version}`);
+	}
+	return [
+		"## Development Dependencies",
+		"",
+		...items
+	].join("\n");
+} } };
+
+//#endregion
+//#region src/lib/readme/rules/dev-dependencies.ts
+/**
+* Simple alias for `development-dependencies`
+*/
+var dev_dependencies_default = { "dev-dependencies": getSoleRule(development_dependencies_default) };
+
 //#endregion
 //#region src/lib/readme/rules/license.ts
 var license_default = { license: { async content() {
@@ -446,7 +525,7 @@ var title_default = { title: {
 	},
 	order: 2
 } };
-const SPLIT_FOR_TITLE_CASE_REGEX = /[ _-]+/;
+const SPLIT_FOR_TITLE_CASE_REGEX = /[ _\-]+/v;
 function makeTitleCase(text) {
 	return text.split(SPLIT_FOR_TITLE_CASE_REGEX).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
@@ -520,7 +599,7 @@ async function createSizeReport(filePath) {
 			original: createSizeInfo(originalSize, originalSize)
 		};
 	} catch (error) {
-		throw new Error(`Failed to analyze file: ${error instanceof Error ? error.message : "Unknown error"}`);
+		throw new Error(`Failed to analyze file: ${error instanceof Error ? error.message : "Unknown error"}`, { cause: error });
 	}
 }
 
@@ -543,7 +622,8 @@ function getSizeForCompression(report, compression) {
 }
 var size_default = { size: { async content(options) {
 	const validOptions = optionsSchema$1.parse(options);
-	return getSizeForCompression(await createSizeReport(path.join(process.cwd(), validOptions.file)), validOptions.compression);
+	const fullPath = path.join(process.cwd(), validOptions.file);
+	return getSizeForCompression(await createSizeReport(fullPath), validOptions.compression);
 } } };
 
 //#endregion
@@ -593,7 +673,8 @@ function formatMarkdownTable(reports, options) {
 var size_table_default = { "size-table": { async content(options) {
 	const validOptions = optionsSchema.parse(options);
 	return formatMarkdownTable(await Promise.all(validOptions.files.map(async (file) => {
-		return [file, await createSizeReport(path.join(process.cwd(), file))];
+		const fullPath = path.join(process.cwd(), file);
+		return [file, await createSizeReport(fullPath)];
 	})), {
 		brotli: validOptions.brotli,
 		gzip: validOptions.gzip,
@@ -606,20 +687,21 @@ var size_table_default = { "size-table": { async content(options) {
 //#region src/lib/readme/rules/table-of-contents.ts
 var table_of_contents_default = { "table-of-contents": {
 	async content(options, { tree }) {
+		const validOptions = z.object({ depth: z.union([
+			z.literal(1),
+			z.literal(2),
+			z.literal(3),
+			z.literal(4),
+			z.literal(5),
+			z.literal(6)
+		]).optional() }).optional().parse(options);
 		const result = toc(tree, {
 			heading: null,
-			maxDepth: z.object({ depth: z.union([
-				z.literal(1),
-				z.literal(2),
-				z.literal(3),
-				z.literal(4),
-				z.literal(5),
-				z.literal(6)
-			]).optional() }).optional().parse(options)?.depth ?? 3,
+			maxDepth: validOptions?.depth ?? 3,
 			tight: true
 		});
-		const heading = `## Table of contents`;
 		if (result.map === void 0) throw new Error("Could not generate table of contents");
+		const heading = `## Table of contents`;
 		const rootWrapper = {
 			children: result.map.children,
 			type: "root"
@@ -645,6 +727,8 @@ var rules_default = {
 	...contributing_default,
 	...dependencies_default,
 	...description_default,
+	...dev_dependencies_default,
+	...development_dependencies_default,
 	...footer_default,
 	...header_default,
 	...install_default,
@@ -680,13 +764,13 @@ function getAdditionalConfigExplorer() {
 async function loadConfig(options) {
 	const { additionalConfig, defaults = rules_default, searchFrom } = options ?? {};
 	let finalConfig = { mdat: `Powered by the Markdown Autophagic Template system: [mdat](https://github.com/kitschpatrol/mdat).` };
-	if (defaults) finalConfig = deepMergeDefined(finalConfig, defaults);
+	finalConfig = deepMergeDefined(finalConfig, defaults);
 	const results = await getConfigExplorer().search(searchFrom);
 	if (results) {
 		const { config, filepath } = results;
 		let possibleRules = config;
 		log.debug(`Using config from "${filepath}"`);
-		if (filepath.endsWith("package.json") && typeof config === "string") {
+		if (typeof config === "string" && filepath.endsWith("package.json")) {
 			log.debug(`Detected shared config string: "${config}"`);
 			const { default: sharedConfig } = await import(config);
 			possibleRules = sharedConfig;
@@ -699,14 +783,16 @@ async function loadConfig(options) {
 		for (const configOrPath of additionalConfigArray) {
 			let loaded;
 			if (typeof configOrPath === "string") {
-				let results;
-				if (path.basename(configOrPath).endsWith("package.json")) results = {
-					config: mdatJsonLoader(configOrPath, await fs.readFile(configOrPath, "utf8")),
-					filepath: configOrPath
-				};
-				else results = await getAdditionalConfigExplorer().load(configOrPath);
-				if (results === null || results === void 0) continue;
-				const { config: loadedConfig, filepath } = results;
+				let loadResults;
+				if (path.basename(configOrPath).endsWith("package.json")) {
+					const packageJson = await fs.readFile(configOrPath, "utf8");
+					loadResults = {
+						config: mdatJsonLoader(configOrPath, packageJson),
+						filepath: configOrPath
+					};
+				} else loadResults = await getAdditionalConfigExplorer().load(configOrPath);
+				if (loadResults === null || loadResults === void 0) continue;
+				const { config: loadedConfig, filepath } = loadResults;
 				log.debug(`Loaded additional config from "${filepath}"`);
 				loaded = loadedConfig;
 			} else loaded = configOrPath;
@@ -740,7 +826,7 @@ async function formatWithPrettier(content, filePath) {
 	} catch {
 		throw new Error("The --format flag requires `prettier` to be installed. Run: pnpm add -D prettier");
 	}
-	const configKey = filePath ? path.dirname(filePath) : process.cwd();
+	const configKey = filePath === void 0 || filePath === "" ? process.cwd() : path.dirname(filePath);
 	let config = configCache.get(configKey);
 	if (config === void 0 && !configCache.has(configKey)) {
 		config = await cachedPrettier.resolveConfig(filePath ?? process.cwd());
@@ -763,22 +849,22 @@ function zeroPad(n, nMax) {
 async function getInputOutputPaths(inputs, output, name, extension) {
 	const paths = [];
 	for (const [index, file] of inputs.entries()) {
-		const inputOutputPath = await getInputOutputPath(file, output, name, extension, name && inputs.length > 1 ? `-${zeroPad(index + 1, inputs.length)}` : "");
+		const inputOutputPath = await getInputOutputPath(file, output, name, extension, name !== void 0 && name !== "" && inputs.length > 1 ? `-${zeroPad(index + 1, inputs.length)}` : "");
 		paths.push(inputOutputPath);
 	}
 	return paths;
 }
 async function getInputOutputPath(input, output, name, extension, nameSuffix = "") {
 	const resolvedInput = expandPath(input);
-	const resolvedOutput = output ? expandPath(output) : void 0;
 	if (!isFileSync(resolvedInput)) throw new Error(`Input file not found: "${resolvedInput}"`);
-	if (resolvedOutput) {
+	const resolvedOutput = output === void 0 || output === "" ? void 0 : expandPath(output);
+	if (resolvedOutput !== void 0) {
 		if (isFileSync(resolvedOutput)) throw new Error(`Output path must be a directory, received a file path: "${resolvedOutput}"`);
 		await fs.mkdir(resolvedOutput, { recursive: true });
 	}
 	return {
 		input: resolvedInput,
-		name: `${name ? path.basename(name, path.extname(name)) : path.basename(resolvedInput, path.extname(resolvedInput))}${nameSuffix}${extension === void 0 ? name && path.extname(name) !== "" ? path.extname(name) : path.extname(input) : `.${extension}`}`,
+		name: `${name === void 0 || name === "" ? path.basename(resolvedInput, path.extname(resolvedInput)) : path.basename(name, path.extname(name))}${nameSuffix}${extension === void 0 ? name !== void 0 && path.extname(name) !== "" ? path.extname(name) : path.extname(input) : `.${extension}`}`,
 		output: resolvedOutput ?? path.dirname(resolvedInput)
 	};
 }
@@ -789,7 +875,7 @@ function ensureArray(value) {
 	if (value === void 0 || value === null) return [];
 	return Array.isArray(value) ? value : [value];
 }
-const README_SEARCH_REGEX = /^readme(?:\.\w+)?$/i;
+const README_SEARCH_REGEX = /^readme(?:\.\w+)?$/iv;
 /**
 * Finds a readme file in the current working directory (case-insensitive).
 */
@@ -866,14 +952,15 @@ function stripLintPlugins(config) {
 //#endregion
 //#region src/lib/processors.ts
 async function processFiles(files, loader, processorGetter, name, output, config) {
-	const [resolvedConfig, localRemarkConfiguration] = await Promise.all([loader({ additionalConfig: config }), loadAmbientRemarkConfig()]);
-	const inputOutputPaths = await getInputOutputPaths(ensureArray(files), output, name, "md");
-	const resolvedProcessor = processorGetter(resolvedConfig, localRemarkConfiguration);
-	return await Promise.all(inputOutputPaths.map(async ({ input, name, output }) => {
+	const [resolvedConfig, localRemarkConfig] = await Promise.all([loader({ additionalConfig: config }), loadAmbientRemarkConfig()]);
+	const resolvedFiles = ensureArray(files);
+	const inputOutputPaths = await getInputOutputPaths(resolvedFiles, output, name, "md");
+	const resolvedProcessor = processorGetter(resolvedConfig, localRemarkConfig);
+	return await Promise.all(inputOutputPaths.map(async ({ input, name: outputName, output: outputDirectory }) => {
 		const inputFile = await read(input);
 		const result = await resolvedProcessor.process(inputFile);
-		result.dirname = output;
-		result.basename = name;
+		result.dirname = outputDirectory;
+		result.basename = outputName;
 		return result;
 	}));
 }
@@ -970,13 +1057,15 @@ async function createReadmeInteractive() {
 	const readmePath = await findReadme();
 	intro(`Running ${picocolors.bold("mdat create")} interactively`);
 	const newReadmePath = await createReadme(await group({
-		overwrite: async () => readmePath === void 0 ? true : await confirm({
-			message: `Found an existing readme at "${picocolors.blue(readmePath)}". Do you want to overwrite it?`,
-			active: "Overwrite",
-			inactive: "Exit"
-		}) ? true : (() => {
-			throw new Error("`mdat create` was cancelled to avoid an overwrite - no changes were made");
-		})(),
+		async overwrite() {
+			if (readmePath === void 0) return true;
+			if (await confirm({
+				message: `Found an existing readme at "${picocolors.blue(readmePath)}". Do you want to overwrite it?`,
+				active: "Overwrite",
+				inactive: "Exit"
+			}) === false) throw new Error("`mdat create` was cancelled to avoid an overwrite - no changes were made");
+			return true;
+		},
 		template: async () => select({
 			message: "Which template would you like to use?",
 			options: getTemplateOptions()
@@ -1018,17 +1107,24 @@ async function createReadme(options) {
 	const templateString = getTemplateForConfig(resolvedOptions.template, resolvedOptions.compound);
 	const readmePath = path.join(resolvedOptions.output, "readme.md");
 	if (!resolvedOptions.overwrite) {
-		if (await fs.access(readmePath).then(() => true, () => false)) throw new Error(`Readme already exists at "${readmePath}". Use the overwrite option to replace it.`);
+		let exists = true;
+		try {
+			await fs.access(readmePath);
+		} catch {
+			exists = false;
+		}
+		if (exists) throw new Error(`Readme already exists at "${readmePath}". Use the overwrite option to replace it.`);
 	}
 	await fs.writeFile(readmePath, templateString, "utf8");
 	if (resolvedOptions.expand) {
 		const [result] = await expand(readmePath);
+		if (result === void 0) throw new Error(`Failed to expand readme at "${readmePath}"`);
 		await write(result);
 	}
 	return readmePath;
 }
 function getTemplateForConfig(templateKey, compound) {
-	if (!(templateKey in templates_default)) throw new Error(`Unknown template "${templateKey}". Available templates: ${Object.keys(templates_default).join(", ")}`);
+	if (!Object.hasOwn(templates_default, templateKey)) throw new Error(`Unknown template "${templateKey}". Available templates: ${Object.keys(templates_default).join(", ")}`);
 	return templates_default[templateKey].content[compound ? "compound" : "explicit"];
 }
 function getTemplateOptions() {
@@ -1093,7 +1189,11 @@ async function check(files, config, options) {
 	const resolvedFiles = Array.isArray(files) ? files : [files];
 	const [originals, results] = await Promise.all([Promise.all(resolvedFiles.map(async (f) => read(f))), processFiles(files, loadConfig, getExpandProcessor, void 0, void 0, config)]);
 	if (options?.format) await formatResults(results);
-	return results.map((result, i) => compareWithDiff(originals[i], result, options));
+	return results.map((result, i) => {
+		const original = originals[i];
+		if (original === void 0) throw new Error(`Missing original file for comparison at index ${i}`);
+		return compareWithDiff(original, result, options);
+	});
 }
 function compareWithDiff(original, result, options) {
 	const inSync = original.toString().replaceAll("\r\n", "\n") === result.toString();
@@ -1115,7 +1215,7 @@ function compareWithDiff(original, result, options) {
 	};
 }
 async function formatResults(results) {
-	for (const file of results) file.value = await formatWithPrettier(file.toString(), file.path || void 0);
+	for (const file of results) file.value = await formatWithPrettier(file.toString(), file.path === "" ? void 0 : file.path);
 }
 
 //#endregion
@@ -1195,55 +1295,57 @@ const yargsInstance = yargs(hideBin(process.argv));
 try {
 	await yargsInstance.scriptName("mdat").usage("$0 [command] [files..] [options]", "Work with MDAT placeholder comments in Markdown files.").option(verboseOption).middleware((argv) => {
 		setLogger$2(createLogger({
-			name,
-			verbose: argv.verbose ?? false,
 			logToConsole: {
 				showLevel: false,
 				showName: false,
 				showTime: false
-			}
+			},
+			name,
+			verbose: argv.verbose ?? false
 		}));
-	}).command(["$0 [files..] [options]", "expand [files..] [options]"], "Expand MDAT placeholder comments. If no files are provided, the closest readme.md is expanded.", (yargs) => yargs.positional(...filesPositional).option(configOption).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ config, files, format, name, output, print }) => {
+	}).command(["$0 [files..] [options]", "expand [files..] [options]"], "Expand MDAT placeholder comments. If no files are provided, the closest readme.md is expanded.", (commandYargs) => commandYargs.positional(...filesPositional).option(configOption).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ config, files, format, name: fileName, output, print }) => {
 		logConflicts({
-			name,
+			name: fileName,
 			output,
 			print
 		});
-		const results = await expand(files, name, output, collectConfig(config), { format });
+		const mergedConfig = collectConfig(config);
+		const results = await expand(files, fileName, output, mergedConfig, { format });
 		for (const file of results) if (print) process.stdout.write(file.toString());
 		else await write(file);
 		reporterMdat(results);
 		log.debug(`Expanded comments in ${prettyMilliseconds(performance.now() - startTime)}.`);
 		process.exitCode = getExitCode(results);
-	}).command("collapse [files..] [options]", "Collapse MDAT placeholder comments. If no files are provided, the closest readme.md is collapsed.", (yargs) => yargs.positional(...filesPositional).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ files, format, name, output, print }) => {
+	}).command("collapse [files..] [options]", "Collapse MDAT placeholder comments. If no files are provided, the closest readme.md is collapsed.", (commandYargs) => commandYargs.positional(...filesPositional).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ files, format, name: fileName, output, print }) => {
 		logConflicts({
-			name,
+			name: fileName,
 			output,
 			print
 		});
-		const results = await collapse(files, name, output, void 0, { format });
+		const results = await collapse(files, fileName, output, void 0, { format });
 		for (const file of results) if (print) process.stdout.write(file.toString());
 		else await write(file);
 		reporterMdat(results);
 		log.debug(`Collapsed comments in ${prettyMilliseconds(performance.now() - startTime)}.`);
 		process.exitCode = getExitCode(results);
-	}).command("strip [files..] [options]", "Strip MDAT comments while preserving expanded content. If no files are provided, the closest readme.md is stripped.", (yargs) => yargs.positional(...filesPositional).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ files, format, name, output, print }) => {
+	}).command("strip [files..] [options]", "Strip MDAT comments while preserving expanded content. If no files are provided, the closest readme.md is stripped.", (commandYargs) => commandYargs.positional(...filesPositional).option(outputOption).option(nameOption).option(printOption).option(formatOption), async ({ files, format, name: fileName, output, print }) => {
 		logConflicts({
-			name,
+			name: fileName,
 			output,
 			print
 		});
-		const results = await strip(files, name, output, void 0, { format });
+		const results = await strip(files, fileName, output, void 0, { format });
 		for (const file of results) if (print) process.stdout.write(file.toString());
 		else await write(file);
 		reporterMdat(results);
 		log.debug(`Stripped comments in ${prettyMilliseconds(performance.now() - startTime)}.`);
 		process.exitCode = getExitCode(results);
-	}).command("check [files..] [options]", "Check if MDAT placeholder comments are up to date. Exits with code 1 if any files have stale or unexpanded content.", (yargs) => yargs.positional(...filesPositional).option(configOption).option(formatOption), async ({ config, files, format }) => {
-		const results = await check(files, collectConfig(config), { format });
+	}).command("check [files..] [options]", "Check if MDAT placeholder comments are up to date. Exits with code 1 if any files have stale or unexpanded content.", (commandYargs) => commandYargs.positional(...filesPositional).option(configOption).option(formatOption), async ({ config, files, format }) => {
+		const mergedConfig = collectConfig(config);
+		const results = await check(files, mergedConfig, { format });
 		let allInSync = true;
 		for (const { inSync, result } of results) {
-			const filePath = result.path || "unknown";
+			const filePath = result.path === "" ? "unknown" : result.path;
 			if (inSync) log.debug(`${picocolors.green("Up to date")}: ${filePath}`);
 			else {
 				log.warn(`${picocolors.red("Stale content")}: ${filePath}`);
@@ -1253,12 +1355,12 @@ try {
 		}
 		log.debug(`Checked in ${prettyMilliseconds(performance.now() - startTime)}.`);
 		process.exitCode = allInSync ? 0 : 1;
-	}).command("create [options]", "Create a new Markdown file from a template.", (yargs) => yargs.option(interactiveOption).option(overwriteOption).option(outputOption).option(expandOption).option(templateOption).option(compoundOption), async ({ compound, expand, interactive, output, overwrite, template }) => {
+	}).command("create [options]", "Create a new Markdown file from a template.", (commandYargs) => commandYargs.option(interactiveOption).option(overwriteOption).option(outputOption).option(expandOption).option(templateOption).option(compoundOption), async ({ compound, expand: expandTemplate, interactive, output, overwrite, template }) => {
 		if (interactive) await createReadmeInteractive();
 		else {
 			const readmePath = await createReadme({
 				compound,
-				expand,
+				expand: expandTemplate,
 				output,
 				overwrite,
 				template
@@ -1272,11 +1374,11 @@ try {
 	process.exitCode = 1;
 }
 function logConflicts(args) {
-	if (args.print && args.output) log.warn(`Ignoring --output option because --print is set`);
-	if (args.print && args.name) log.warn(`Ignoring --name option because --print is set`);
+	if (args.print && args.output !== void 0 && args.output !== "") log.warn(`Ignoring --output option because --print is set`);
+	if (args.print && args.name !== void 0 && args.name !== "") log.warn(`Ignoring --name option because --print is set`);
 }
 function collectConfig(config) {
-	if (config === void 0) return void 0;
+	if (config === void 0) return;
 	return ensureArray(config);
 }
 function getExitCode(results) {