@stephansama/auto-readme 0.2.7 → 0.2.9

package/dist/index.cjs

@@ -1,4 +1,5 @@
-//#region rolldown:runtime
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -19,65 +20,49 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-
 //#endregion
 let mdast_util_from_markdown = require("mdast-util-from-markdown");
-mdast_util_from_markdown = __toESM(mdast_util_from_markdown);
 let node_child_process = require("node:child_process");
-node_child_process = __toESM(node_child_process);
+node_child_process = __toESM(node_child_process, 1);
 let node_fs_promises = require("node:fs/promises");
-node_fs_promises = __toESM(node_fs_promises);
-let ora = require("ora");
-ora = __toESM(ora);
-let debug = require("debug");
-debug = __toESM(debug);
+node_fs_promises = __toESM(node_fs_promises, 1);
+let picospinner = require("picospinner");
+let obug = require("obug");
 let yargs = require("yargs");
-yargs = __toESM(yargs);
+yargs = __toESM(yargs, 1);
 let yargs_helpers = require("yargs/helpers");
-yargs_helpers = __toESM(yargs_helpers);
 let zod = require("zod");
-zod = __toESM(zod);
+zod = __toESM(zod, 1);
 let mdast_comment_marker = require("mdast-comment-marker");
-mdast_comment_marker = __toESM(mdast_comment_marker);
-let __iarna_toml = require("@iarna/toml");
-__iarna_toml = __toESM(__iarna_toml);
 let cosmiconfig = require("cosmiconfig");
-cosmiconfig = __toESM(cosmiconfig);
 let deepmerge = require("deepmerge");
-deepmerge = __toESM(deepmerge);
-let __manypkg_get_packages = require("@manypkg/get-packages");
-__manypkg_get_packages = __toESM(__manypkg_get_packages);
+deepmerge = __toESM(deepmerge, 1);
+let smol_toml = require("smol-toml");
+smol_toml = __toESM(smol_toml, 1);
+let _manypkg_get_packages = require("@manypkg/get-packages");
 let node_fs = require("node:fs");
-node_fs = __toESM(node_fs);
+node_fs = __toESM(node_fs, 1);
 let node_path = require("node:path");
-node_path = __toESM(node_path);
+node_path = __toESM(node_path, 1);
 let pkg_types = require("pkg-types");
-pkg_types = __toESM(pkg_types);
 let yaml = require("yaml");
-yaml = __toESM(yaml);
+yaml = __toESM(yaml, 1);
 let zod2md = require("zod2md");
-zod2md = __toESM(zod2md);
-let fast_glob = require("fast-glob");
-fast_glob = __toESM(fast_glob);
+let tinyglobby = require("tinyglobby");
 let remark = require("remark");
-remark = __toESM(remark);
 let remark_code_import = require("remark-code-import");
-remark_code_import = __toESM(remark_code_import);
+remark_code_import = __toESM(remark_code_import, 1);
 let remark_collapse = require("remark-collapse");
-remark_collapse = __toESM(remark_collapse);
+remark_collapse = __toESM(remark_collapse, 1);
 let remark_toc = require("remark-toc");
-remark_toc = __toESM(remark_toc);
+remark_toc = __toESM(remark_toc, 1);
 let remark_usage = require("remark-usage");
-remark_usage = __toESM(remark_usage);
+remark_usage = __toESM(remark_usage, 1);
 let vfile = require("vfile");
-vfile = __toESM(vfile);
 let handlebars = require("handlebars");
-handlebars = __toESM(handlebars);
+handlebars = __toESM(handlebars, 1);
 let markdown_table = require("markdown-table");
-markdown_table = __toESM(markdown_table);
 let mdast_zone = require("mdast-zone");
-mdast_zone = __toESM(mdast_zone);
-
 //#region src/schema.ts
 const actionsSchema = zod.enum([
 	"ACTION",
@@ -120,8 +105,8 @@ const tableHeadingsSchema = zod.record(actionsSchema, headingsSchema.array().opt
 	ZOD: []
 }).meta({ description: "Table heading action configuration" });
 const templatesSchema = zod.object({
-	downloadImage: zod.string().default("https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F"),
-	emojis: zod.record(headingsSchema, zod.string()).default({
+	downloadImage: zod.string().trim().default("https://img.shields.io/npm/dw/{{name}}?labelColor=211F1F"),
+	emojis: zod.record(headingsSchema, zod.string().trim()).default({
 		default: "⚙️",
 		description: "📝",
 		devDependency: "💻",
@@ -131,14 +116,14 @@ const templatesSchema = zod.object({
 		required: "",
 		version: ""
 	}).meta({ description: "Table heading emojis used when enabled" }),
-	registryUrl: zod.string().default("https://www.npmjs.com/package/{{name}}"),
-	versionImage: zod.string().default("https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F")
+	registryUrl: zod.string().trim().default("https://www.npmjs.com/package/{{name}}"),
+	versionImage: zod.string().trim().default("https://img.shields.io/npm/v/{{uri_name}}?logo=npm&logoColor=red&color=211F1F&labelColor=211F1F")
 });
 const defaultTemplates = templatesSchema.parse({});
 const defaultTableHeadings = tableHeadingsSchema.parse(void 0);
-const _configSchema = zod.object({
-	affectedRegexes: zod.array(zod.string()),
-	collapseHeadings: zod.array(zod.string()),
+const configSchema = zod.object({
+	affectedRegexes: zod.array(zod.string().trim()),
+	collapseHeadings: zod.array(zod.string().trim()),
 	defaultLanguage: languageSchema.meta({
 		alias: "l",
 		description: "Default language to infer projects from"
@@ -163,27 +148,25 @@ const _configSchema = zod.object({
 		alias: "p",
 		description: "Only show public packages in workspaces"
 	}),
-	removeScope: zod.string().default("").meta({ description: "Remove common workspace scope" }),
+	removeScope: zod.string().trim().default("").meta({ description: "Remove common workspace scope" }),
 	templates: templatesSchema.optional().default(defaultTemplates).describe("Handlebars templates used to fuel list and table generation"),
-	tocHeading: zod.string().default("Table of contents").meta({ description: "Markdown heading used to generate table of contents" }),
-	usageFile: zod.string().default("").meta({ description: "Workspace level usage file" }),
-	usageHeading: zod.string().default("Usage").meta({ description: "Markdown heading used to generate usage example" }),
+	tocHeading: zod.string().trim().default("Table of contents").meta({ description: "Markdown heading used to generate table of contents" }),
+	usageFile: zod.string().trim().default("").meta({ description: "Workspace level usage file" }),
+	usageHeading: zod.string().trim().default("Usage").meta({ description: "Markdown heading used to generate usage example" }),
 	verbose: zod.boolean().default(false).meta({
 		alias: "v",
 		description: "whether or not to display verbose logging"
 	})
-});
-const configSchema = _configSchema.optional();
-
+}).optional();
 //#endregion
-//#region src/args.ts
+//#region src/arguments.ts
 const complexOptions = [
 	"affectedRegexes",
 	"collapseHeadings",
 	"headings",
 	"templates"
 ];
-const args = {
+const arguments_ = {
 	...zodToYargs(),
 	changes: {
 		alias: "g",
@@ -203,10 +186,10 @@ const args = {
 		type: "string"
 	}
 };
-async function parseArgs() {
-	const yargsInstance = (0, yargs.default)((0, yargs_helpers.hideBin)(process.argv)).options(args).help("h").alias("h", "help").epilogue(`--> @stephansama open-source ${(/* @__PURE__ */ new Date()).getFullYear()}`);
+async function parseArguments() {
+	const yargsInstance = (0, yargs.default)((0, yargs_helpers.hideBin)(process.argv)).options(arguments_).help("h").alias("h", "help").epilogue(`--> @stephansama open-source ${(/* @__PURE__ */ new Date()).getFullYear()}`);
 	const parsed = await yargsInstance.wrap(yargsInstance.terminalWidth()).parse();
-	if (parsed.verbose) debug.default.enable("autoreadme*");
+	if (parsed.verbose) (0, obug.enable)("autoreadme*");
 	return parsed;
 }
 function zodToYargs() {
@@ -229,25 +212,12 @@ function zodToYargs() {
 	});
 	return Object.fromEntries(entries);
 }
-
 //#endregion
 //#region src/log.ts
-const error = (0, debug.default)("autoreadme:error");
-const info = (0, debug.default)("autoreadme:info");
-const warn = (0, debug.default)("autoreadme:warn");
-function ERROR(...rest) {
-	const [first, ...remaining] = rest;
-	error(`${first} %O`, ...remaining);
-}
-function INFO(...rest) {
-	const [first, ...remaining] = rest;
-	info(`${first} %O`, ...remaining);
-}
-function WARN(...rest) {
-	const [first, ...remaining] = rest;
-	warn(`${first} %O`, ...remaining);
-}
-
+const debug = (0, obug.createDebug)("autoreadme", { useColors: true });
+const ERROR = debug.extend("error");
+const INFO = debug.extend("info");
+const WARN = debug.extend("warn");
 //#endregion
 //#region src/comment.ts
 const SEPARATOR = "-";
@@ -264,7 +234,7 @@ function parseComment(comment) {
 	});
 	const languageInput = third ? first : void 0;
 	const actionInput = third ? second : first;
-	const formatInput = third ? third : second;
+	const formatInput = third || second;
 	const language = languageSchema.parse(languageInput);
 	const parsed = {
 		action: actionsSchema.parse(actionInput),
@@ -278,8 +248,9 @@ function parseComment(comment) {
 }
 const startComment = "<!--";
 const endComment = "-->";
+const commentRegex = /start|end/;
 function trimComment(comment) {
-	return comment.replace(startComment, "").replace(/start|end/, "").replace(endComment, "").trim();
+	return comment.replace(startComment, "").replace(commentRegex, "").replace(endComment, "").trim();
 }
 function getComment(comment) {
 	if (!isComment(comment.value)) return false;
@@ -289,32 +260,31 @@ function getComment(comment) {
 function isComment(comment) {
 	return comment.startsWith(startComment) && comment.endsWith(endComment);
 }
-
 //#endregion
 //#region src/config.ts
 const moduleName = "autoreadme";
 const searchPlaces = getSearchPlaces();
 const loaders = { [".toml"]: loadToml };
-async function loadConfig(args$1) {
-	const opts$1 = {
+async function loadConfig(arguments_) {
+	const options = {
 		loaders,
 		searchPlaces
 	};
-	if (args$1.config) opts$1.searchPlaces = [args$1.config];
-	const search = await (0, cosmiconfig.cosmiconfig)(moduleName, opts$1).search();
-	if (!search) {
-		WARN(`no config file found`, args$1.config ? " at location: " + args$1.config : "");
-		INFO("using default configuration");
-	} else {
+	if (arguments_.config) options.searchPlaces = [arguments_.config];
+	const search = await (0, cosmiconfig.cosmiconfig)(moduleName, options).search();
+	if (search) {
 		INFO("found configuration file at: ", search.filepath);
 		INFO("loaded cosmiconfig", search.config);
+	} else {
+		WARN(`no config file found`, arguments_.config ? " at location: " + arguments_.config : "");
+		INFO("using default configuration");
 	}
-	args$1 = removeFalsy(args$1);
-	INFO("merging config with args", args$1);
-	return configSchema.parse((0, deepmerge.default)(search?.config || {}, args$1, { arrayMerge: (_, sourceArray) => sourceArray }));
+	arguments_ = removeFalsy(arguments_);
+	INFO("merging config with args", arguments_);
+	return configSchema.parse((0, deepmerge.default)(search?.config || {}, arguments_, { arrayMerge: (_, sourceArray) => sourceArray }));
 }
 function loadToml(_filepath, content) {
-	return __iarna_toml.default.parse(content);
+	return smol_toml.parse(content);
 }
 function getSearchPlaces() {
 	return [
@@ -328,14 +298,13 @@ function getSearchPlaces() {
 		`.config/.${moduleName}rc.yml`
 	];
 }
-function removeFalsy(obj) {
-	return Object.fromEntries(Object.entries(obj).map(([k, v]) => !v ? false : [k, v]).filter((e) => Boolean(e)));
+function removeFalsy(object) {
+	return Object.fromEntries(Object.entries(object).map(([k, v]) => v ? [k, v] : false).filter(Boolean));
 }
-
 //#endregion
-//#region src/utils.ts
+//#region src/utilities.ts
 const sh = String.raw;
-const opts = { encoding: "utf8" };
+const options = { encoding: "utf8" };
 const ignore = ["**/node_modules/**"];
 const matches = [
 	/.*README\.md$/gi,
@@ -348,56 +317,56 @@ async function fileExists(file) {
 	return await node_fs_promises.access(file).then(() => true).catch(() => false);
 }
 function findAffectedMarkdowns(root, config) {
-	const affected = node_child_process.execSync(sh`git diff --cached --name-only --diff-filter=MACT`, opts).trim().split("\n").filter(Boolean);
-	if (!affected.length) ERROR("no staged files found");
+	const affected = node_child_process.execSync(sh`git diff --cached --name-only --diff-filter=MACT`, options).trim().split("\n").filter((item) => !!item);
+	if (affected.length === 0) ERROR("no staged files found");
 	if (config.affectedRegexes?.length) INFO("adding the following expressions: ", config.affectedRegexes);
 	const allMatches = [...matches, ...config.affectedRegexes?.map((r) => new RegExp(r)) || []];
 	INFO("Checking affected files against regexes", affected, allMatches);
 	const eligible = affected.filter((a) => allMatches.some((m) => a.match(m)));
 	INFO("Found the following eligible affected files", eligible);
-	const md = eligible.map((e) => findNearestReadme(root, node_path.resolve(e)));
-	const rootMd = node_path.join(root, "README.md");
-	const dedupe = [...new Set(md), rootMd].filter((s) => Boolean(s));
+	const md = eligible.map((current) => {
+		return findNearestReadme(root, node_path.default.resolve(current));
+	});
+	const rootMd = node_path.default.join(root, "README.md");
+	const dedupe = [...new Set(md), rootMd].filter((item) => !!item);
 	INFO("Found the following readmes", dedupe);
 	return dedupe;
 }
 function getGitRoot() {
-	const root = node_child_process.execSync(sh`git rev-parse --show-toplevel`, opts).trim();
+	const root = node_child_process.execSync(sh`git rev-parse --show-toplevel`, options).trim();
 	if (!root) throw new Error("must be ran within a git directory.");
 	INFO("found git root at location: ", root);
 	return root;
 }
 async function getMarkdownPaths(cwd, config) {
-	return (await (0, fast_glob.default)(`**/${config?.onlyReadmes ? "README" : "*"}.md`, {
+	return (await (0, tinyglobby.glob)(`**/${config?.onlyReadmes ? "README" : "*"}.md`, {
 		cwd,
 		ignore
-	})).map((readme) => node_path.resolve(cwd, readme));
+	})).map((readme) => node_path.default.resolve(cwd, readme));
 }
 async function getPrettierPaths(paths) {
 	return await Promise.all(paths.map(async (file) => {
 		if (!(await node_fs_promises.lstat(file)).isSymbolicLink()) return file;
 		const symlink = await node_fs_promises.readlink(file);
-		return node_path.join(node_path.dirname(file), symlink);
+		return node_path.default.join(node_path.default.dirname(file), symlink);
 	}));
 }
 function findNearestReadme(gitRoot, inputFile, maxRotations = 15) {
-	let dir = node_path.dirname(inputFile);
+	let dirname = node_path.default.dirname(inputFile);
 	let rotations = 0;
 	while (true) {
-		const option = node_path.join(dir, "README.md");
+		const option = node_path.default.join(dirname, "README.md");
 		if (node_fs.existsSync(option)) return option;
-		const parent = node_path.dirname(dir);
-		if (parent === dir || dir === gitRoot || ++rotations > maxRotations) break;
-		dir = parent;
+		const parent = node_path.default.dirname(dirname);
+		if (parent === dirname || dirname === gitRoot || ++rotations > maxRotations) break;
+		dirname = parent;
 	}
-	return null;
 }
-
 //#endregion
 //#region src/data.ts
 function createFindParameter(parameterList) {
 	return function(parameterName) {
-		return parameterList?.find((p) => p.startsWith(parameterName))?.replace(parameterName + "=", "")?.replace(/"/gi, "")?.replace(/_/gi, " ");
+		return parameterList?.find((p) => p.startsWith(parameterName))?.replace(parameterName + "=", "")?.replaceAll("\"", "")?.replaceAll("_", " ");
 	};
 }
 async function loadActionData(actions, file, root) {
@@ -406,7 +375,7 @@ async function loadActionData(actions, file, root) {
 		const find = createFindParameter(action.parameters);
 		switch (action.action) {
 			case "ACTION": {
-				const actionYaml = await loadActionYaml(node_path.dirname(file));
+				const actionYaml = await loadActionYaml(node_path.default.dirname(file));
 				return {
 					action: action.action,
 					actionYaml,
@@ -415,7 +384,7 @@ async function loadActionData(actions, file, root) {
 			}
 			case "PKG": {
 				const inputPath = find("path");
-				const pkgJson = await (0, pkg_types.readPackageJSON)(inputPath ? node_path.resolve(node_path.dirname(file), inputPath) : node_path.dirname(file));
+				const pkgJson = await (0, pkg_types.readPackageJSON)(inputPath ? node_path.default.resolve(node_path.default.dirname(file), inputPath) : node_path.default.dirname(file));
 				return {
 					action: action.action,
 					parameters: action.parameters,
@@ -427,8 +396,8 @@ async function loadActionData(actions, file, root) {
 				parameters: action.parameters
 			};
 			case "WORKSPACE": {
-				const workspaces = await (0, __manypkg_get_packages.getPackages)(process.cwd());
-				const pnpmPath = node_path.resolve(root, "pnpm-workspace.yaml");
+				const workspaces = await (0, _manypkg_get_packages.getPackages)(process.cwd());
+				const pnpmPath = node_path.default.resolve(root, "pnpm-workspace.yaml");
 				const isPnpm = node_fs.existsSync(pnpmPath);
 				return {
 					action: action.action,
@@ -442,11 +411,11 @@ async function loadActionData(actions, file, root) {
 				if (action.format === "LIST") throw new Error("cannot display zod in list format");
 				const inputPath = find("path");
 				if (!inputPath) {
-					const error$1 = `no path found for zod table at markdown file ${file}`;
-					throw new Error(error$1);
+					const error = `no path found for zod table at markdown file ${file}`;
+					throw new Error(error);
 				}
 				const body = await (0, zod2md.zod2md)({
-					entry: node_path.resolve(node_path.dirname(file), inputPath),
+					entry: node_path.default.resolve(node_path.default.dirname(file), inputPath),
 					title: find("title") || "Zod Schema"
 				});
 				return {
@@ -459,18 +428,17 @@ async function loadActionData(actions, file, root) {
 		}
 	}));
 }
-async function loadActionYaml(baseDir) {
-	const actionYmlPath = node_path.resolve(baseDir, "action.yml");
-	const actionYamlPath = node_path.resolve(baseDir, "action.yaml");
+async function loadActionYaml(baseDirectory) {
+	const actionYmlPath = node_path.default.resolve(baseDirectory, "action.yml");
+	const actionYamlPath = node_path.default.resolve(baseDirectory, "action.yaml");
 	const actualPath = await fileExists(actionYamlPath) && actionYamlPath || await fileExists(actionYmlPath) && actionYmlPath;
 	if (!actualPath) {
-		const error$1 = `no yaml file found at locations: ${[actionYmlPath, actionYamlPath]}`;
-		throw new Error(error$1);
+		const error = `no yaml file found at locations: ${[actionYmlPath, actionYamlPath].join(",")}`;
+		throw new Error(error);
 	}
 	const actionFile = await node_fs_promises.readFile(actualPath, { encoding: "utf8" });
 	return yaml.parse(actionFile);
 }
-
 //#endregion
 //#region src/plugin.ts
 function createHeading(headings, disableEmojis = false, emojis = defaultTemplates.emojis) {
@@ -482,11 +450,11 @@ function wrapRequired(required, input) {
 }
 const autoReadmeRemarkPlugin = (config, data) => (tree) => {
 	(0, mdast_zone.zone)(tree, /.*ZOD.*/gi, function(start, _, end) {
-		const zod$1 = data.find((d) => d?.action === "ZOD");
-		if (!zod$1?.body) throw new Error("unable to load zod body");
+		const zod = data.find((d) => d?.action === "ZOD");
+		if (!zod?.body) throw new Error("unable to load zod body");
 		return [
 			start,
-			(0, mdast_util_from_markdown.fromMarkdown)(zod$1.body),
+			(0, mdast_util_from_markdown.fromMarkdown)(zod.body),
 			end
 		];
 	});
@@ -498,8 +466,8 @@ const autoReadmeRemarkPlugin = (config, data) => (tree) => {
 		const heading = `### ${config.disableEmojis ? "" : "🧰"} actions`;
 		if (options.format === "LIST") return [
 			start,
-			(0, mdast_util_from_markdown.fromMarkdown)(`${heading}\n` + Object.entries(inputs).sort((a) => a[1].required ? -1 : 1).map(([key, value$1]) => {
-				return `- ${wrapRequired(value$1.required, key)}: (default: ${value$1.default})\n\n${value$1.description}`;
+			(0, mdast_util_from_markdown.fromMarkdown)(`${heading}\n` + Object.entries(inputs).toSorted((a) => a[1].required ? -1 : 1).map(([key, value]) => {
+				return `- ${wrapRequired(value.required, key)}: (default: ${value.default})\n\n${value.description}`;
 			}).join("\n")),
 			end
 		];
@@ -509,7 +477,7 @@ const autoReadmeRemarkPlugin = (config, data) => (tree) => {
 			(0, mdast_util_from_markdown.fromMarkdown)([
 				heading,
 				"",
-				(0, markdown_table.markdownTable)([createHeading(headings, config.disableEmojis, config.templates?.emojis), ...Object.entries(inputs).map(([k, v]) => headings.map((heading$1) => v[heading$1] || k).map(String))])
+				(0, markdown_table.markdownTable)([createHeading(headings, config.disableEmojis, config.templates?.emojis), ...Object.entries(inputs).map(([k, v]) => headings.map((heading) => v[heading] || k).map(String))])
 			].join("\n")),
 			end
 		];
@@ -522,9 +490,9 @@ const autoReadmeRemarkPlugin = (config, data) => (tree) => {
 		const packages = workspace?.workspaces?.packages || [];
 		const headings = config.headings?.WORKSPACE?.length && config.headings?.WORKSPACE || defaultTableHeadings.WORKSPACE;
 		if (comment && comment.format === "LIST") {}
-		const table = (0, markdown_table.markdownTable)([createHeading(headings, config.disableEmojis, config.templates?.emojis), ...packages.filter((pkg) => config.onlyShowPublicPackages ? !pkg.packageJson.private : true).map((pkg) => {
+		const table = (0, markdown_table.markdownTable)([createHeading(headings, config.disableEmojis, config.templates?.emojis) || [], ...packages.filter((pkg) => config.onlyShowPublicPackages ? !pkg.packageJson.private : true).map((pkg) => {
 			const { name } = pkg.packageJson;
-			return headings.map((heading) => {
+			return headings?.map((heading) => {
 				if (heading === "name") return `[${config.removeScope ? name.replace(config.removeScope, "") : name}](${node_path.default.relative(process.cwd(), node_path.default.resolve(pkg.dir, "README.md"))})`;
 				if (heading === "version") return `![npm version image](${templates.versionImage({ uri_name: encodeURIComponent(name) })})`;
 				if (heading === "downloads") return `![npm downloads](${templates.downloadImage({ name })})`;
@@ -553,13 +521,13 @@ const autoReadmeRemarkPlugin = (config, data) => (tree) => {
 			(0, mdast_util_from_markdown.fromMarkdown)(""),
 			end
 		];
-		function mapDependencies(isDev) {
+		function mapDependencies(isDevelopment) {
 			return function([name, version]) {
 				const url = templates.registryUrl({ name });
 				return headings.map((key) => {
 					if (key === "devDependency") {
-						if (config.disableEmojis) return `\`${isDev}\``;
-						return `${isDev ? "⌨️" : "👥"}`;
+						if (config.disableEmojis) return `\`${isDevelopment}\``;
+						return `${isDevelopment ? "⌨️" : "👥"}`;
 					}
 					if (key === "name") return `[${name}](${url})`;
 					if (key === "version") {
@@ -597,7 +565,6 @@ function loadTemplates(templates) {
 		return [key, handlebars.default.compile(value)];
 	}));
 }
-
 //#endregion
 //#region src/pipeline.ts
 async function parse(file, filepath, root, config, data) {
@@ -605,10 +572,10 @@ async function parse(file, filepath, root, config, data) {
 	const usage = data.find((d) => d.action === "USAGE");
 	if (usage?.action === "USAGE" || config.enableUsage) {
 		const examplePath = createFindParameter(usage?.parameters || [])("path");
-		const dirname = node_path.dirname(filepath);
-		const resolvePath = examplePath && node_path.resolve(dirname, examplePath);
-		const relativeProjectPath = config.usageFile && node_path.relative(root, node_path.resolve(dirname, config.usageFile));
-		const example = examplePath && resolvePath && node_path.relative(root, resolvePath) || relativeProjectPath || void 0;
+		const dirname = node_path.default.dirname(filepath);
+		const resolvePath = examplePath && node_path.default.resolve(dirname, examplePath);
+		const relativeProjectPath = config.usageFile && node_path.default.relative(root, node_path.default.resolve(dirname, config.usageFile));
+		const example = examplePath && resolvePath && node_path.default.relative(root, resolvePath) || relativeProjectPath || void 0;
 		if (example && await fileExists(example)) {
 			INFO("generating usage section");
 			pipeline.use(remark_usage.default, {
@@ -626,58 +593,57 @@ async function parse(file, filepath, root, config, data) {
 		pipeline.use(remark_collapse.default, { test: {
 			ignoreFinalDefinitions: true,
 			test: (value, _) => {
-				return headings.some((i) => value.trim() === i?.trim());
+				return headings.some((item) => value.trim() === item?.trim());
 			}
 		} });
 	}
 	const vfile$1 = new vfile.VFile({
-		path: node_path.resolve(filepath),
+		path: node_path.default.resolve(filepath),
 		value: file
 	});
 	return (await pipeline.process(vfile$1)).toString();
 }
-
 //#endregion
 //#region src/index.ts
 async function run() {
-	const args$1 = await parseArgs();
-	const config = await loadConfig(args$1) || {};
+	const arguments_ = await parseArguments();
+	const config = await loadConfig(arguments_) || {};
 	INFO("Loaded the following configuration:", config);
 	const root = getGitRoot();
-	const isAffected = args$1.changes && "affected";
-	INFO(`Loading ${!isAffected ? "all " : "affected "}files`);
+	const isAffected = arguments_.changes && "affected";
+	INFO(`Loading ${isAffected ? "affected " : "all "}files`);
 	const paths = isAffected ? findAffectedMarkdowns(root, config) : await getMarkdownPaths(root, config);
 	INFO("Loaded the following files:", paths.join("\n"));
-	const type = args$1.onlyReadmes ? "readmes" : "all markdown files";
-	if (!paths.length) return ERROR(`no ${isAffected} readmes found to update`);
-	const spinner = !args$1.verbose && (0, ora.default)(`Updating ${type}`).start();
-	await Promise.all(paths.map(async (path$1) => {
-		const file = await node_fs_promises.readFile(path$1, { encoding: "utf8" });
-		const actions = (() => {
-			return loadAstComments((0, mdast_util_from_markdown.fromMarkdown)(file));
-		})();
-		if (!actions.length) {
-			WARN(`no action comments found in`, path$1);
+	if (paths.length === 0) return ERROR(`no ${isAffected} readmes found to update`);
+	const spinner = !arguments_.verbose && makeSpinner();
+	if (spinner) spinner.start();
+	await Promise.all(paths.filter((path) => !!path).map(async (path) => {
+		const file = await node_fs_promises.readFile(path, { encoding: "utf8" });
+		const actions = loadAstComments((0, mdast_util_from_markdown.fromMarkdown)(file));
+		if (actions.length === 0) {
+			WARN(`no action comments found in`, path);
 			if (!config.enableUsage || !config.enableToc) return ERROR("no action or plugins found");
-			else INFO("plugins enabled. continuing parsing", path$1);
+			else INFO("plugins enabled. continuing parsing", path);
 		}
-		const data = await loadActionData(actions, path$1, root);
+		const data = await loadActionData(actions, path, root);
 		INFO("Loaded comment action data", data);
-		const content = await parse(file, path$1, root, config, data);
-		await node_fs_promises.writeFile(path$1, content);
+		const content = await parse(file, path, root, config, data);
+		await node_fs_promises.writeFile(path, content);
 	}));
-	const opts$1 = { stdio: "inherit" };
+	const options = { stdio: "inherit" };
 	if (config.enablePrettier) {
 		INFO("formatting with prettier");
 		const prettierPaths = await getPrettierPaths(paths);
-		node_child_process.execFileSync("prettier", ["--write", ...prettierPaths], opts$1);
+		node_child_process.execFileSync("prettier", ["--write", ...prettierPaths], options);
 	}
 	if (isAffected) {
 		INFO("adding affected files to git stage");
-		node_child_process.execFileSync("git", ["add", ...paths], opts$1);
+		node_child_process.execFileSync("git", ["add", ...paths], options);
 	}
 	if (spinner) spinner.stop();
 }
-
+function makeSpinner() {
+	return new picospinner.Spinner("Updating readme...", { colors: { spinner: "red" } });
+}
 //#endregion
-exports.run = run;
+exports.run = run;