@tobi-or-not/docpress 0.12.3 → 0.13.1

package/dist/cli.js

@@ -1,19 +1,19 @@
 import { Command as e, createCommand as t, createOption as n } from "commander";
 import { appendFileSync as r, cpSync as i, existsSync as a, mkdirSync as o, readFileSync as s, readdirSync as c, renameSync as l, rmSync as u, statSync as d, writeFileSync as f } from "node:fs";
-import { basename as p, dirname as m, join as h, parse as g, relative as ee, resolve as _ } from "node:path";
-import v from "yaml";
-import y from "picocolors";
-import { z as b } from "zod";
-import { Octokit as x } from "@octokit/rest";
-import { simpleGit as S } from "simple-git";
-import { build as te } from "vitepress";
-import { withMermaid as ne } from "vitepress-plugin-mermaid";
-import { readFile as re } from "node:fs/promises";
-var ie = {
+import { basename as p, dirname as m, join as h, parse as g, relative as _, resolve as v } from "node:path";
+import y from "yaml";
+import b from "picocolors";
+import { z as x } from "zod";
+import { Octokit as S } from "@octokit/rest";
+import { simpleGit as C } from "simple-git";
+import { build as w } from "vitepress";
+import { withMermaid as ee } from "vitepress-plugin-mermaid";
+import { readFile as te } from "node:fs/promises";
+var ne = {
 	name: "@tobi-or-not/docpress",
 	type: "module",
-	version: "0.12.3",
-	packageManager: "bun@1.4.0",
+	version: "0.13.1",
+	packageManager: "bun@1.4.2",
 	homepage: "https://this-is-tobi.com/docpress/introduction",
 	repository: {
 		type: "git",
@@ -41,6 +41,7 @@ var ie = {
 		"stop:docker": "docker rm --force docpress",
 		test: "vitest run",
 		"test:cov": "vitest run --coverage",
+		typecheck: "tsc -p tsconfig.spec.json",
 		"vp:build": "vitepress build ./docpress",
 		"vp:build:docker": "docker build --tag tobi-or-not/docs --target prod .",
 		"vp:dev": "vitepress dev ./docpress --port 8080",
@@ -50,29 +51,29 @@ var ie = {
 	dependencies: {
 		"@octokit/rest": "^22.0.1",
 		commander: "^15.0.0",
-		mermaid: "^11.17.2",
+		mermaid: "^12.0.0",
 		picocolors: "^1.1.1",
-		"simple-git": "^3.36.0",
+		"simple-git": "^4.0.2",
 		vitepress: "^1.6.4",
 		"vitepress-plugin-mermaid": "^2.0.17",
-		yaml: "^2.9.0",
-		zod: "^4.5.4"
+		yaml: "^2.9.1",
+		zod: "^4.6.5"
 	},
 	devDependencies: {
 		"@antfu/eslint-config": "^9.5.1",
-		"@commitlint/cli": "^21.2.2",
-		"@commitlint/config-conventional": "^21.2.2",
+		"@commitlint/cli": "^21.2.3",
+		"@commitlint/config-conventional": "^21.2.3",
 		"@octokit/types": "^18.0.0",
-		"@types/node": "^26.4.1",
-		"@vitejs/plugin-vue": "^6.0.8",
-		"@vitest/coverage-v8": "^4.1.11",
-		eslint: "^10.9.1",
+		"@types/node": "^26.6.3",
+		"@vitejs/plugin-vue": "^6.0.9",
+		"@vitest/coverage-v8": "^5.0.2",
+		eslint: "^10.11.0",
 		husky: "^9.1.7",
 		"nano-staged": "^1.0.2",
 		typescript: "^6.0.3",
-		vite: "^8.2.2",
-		vitest: "^4.1.11",
-		vue: "^3.5.42"
+		vite: "^8.3.1",
+		vitest: "^5.0.2",
+		vue: "^3.5.43"
 	},
 	publishConfig: {
 		registry: "https://registry.npmjs.org/",
@@ -80,25 +81,26 @@ var ie = {
 		tag: "latest"
 	},
 	overrides: {
-		"brace-expansion": "^5.0.8",
-		dompurify: "^3.4.14",
-		"fast-uri": "^3.1.6",
-		"js-yaml": "^4.3.1",
-		nanoid: "^3.3.16",
-		postcss: "^8.5.26"
+		"brace-expansion": "^5.0.12",
+		dompurify: "^3.4.16",
+		"fast-uri": "^3.1.8",
+		"js-yaml": "^4.3.2",
+		"lodash-es": "^4.18.1",
+		nanoid: "^3.3.19",
+		postcss: "^8.5.28"
 	}
-}, C = _(process.cwd(), "docpress"), ae = _(process.cwd(), "docpress/docs"), w = _(process.cwd(), "docpress/docs/index.md"), oe = _(process.cwd(), "docpress/docs/forks.md"), T = _(process.cwd(), "docpress/.vitepress/config.ts"), se = _(process.cwd(), "docpress/.vitepress/theme"), ce = _(process.cwd(), "docpress/.vitepress/theme/extras"), E = process.env.NODE_ENV === "development" ? _(import.meta.dirname, "../../public/templates/theme") : _(import.meta.dirname, "./templates/theme"), le = {
-	red: y.red,
-	yellow: y.yellow,
-	white: y.white,
-	green: y.green,
-	blue: y.blue
+}, T = v(process.cwd(), "docpress"), re = v(process.cwd(), "docpress/docs"), E = v(process.cwd(), "docpress/docs/index.md"), ie = v(process.cwd(), "docpress/docs/forks.md"), D = v(process.cwd(), "docpress/.vitepress/config.ts"), ae = v(process.cwd(), "docpress/.vitepress/theme"), oe = v(process.cwd(), "docpress/.vitepress/theme/extras"), O = process.env.NODE_ENV === "development" ? v(import.meta.dirname, "../../public/templates/theme") : v(import.meta.dirname, "./templates/theme"), se = {
+	red: b.red,
+	yellow: b.yellow,
+	white: b.white,
+	green: b.green,
+	blue: b.blue
 };
-function ue() {
+function ce() {
 	let e = Number(process.env.LOG_LEVEL);
 	return Number.isNaN(e) ? 30 : e;
 }
-var D = {
+var k = {
 	error: {
 		color: "red",
 		level: 10
@@ -123,61 +125,65 @@ var D = {
 		color: "blue",
 		level: 50
 	}
-}, O = [
+}, A = [
 	"error",
 	"warn",
 	"info",
 	"trace",
 	"debug"
 ];
-function de(e) {
-	return D[e].level;
+function le(e) {
+	return k[e].level;
 }
-function k(e, t = "info", n) {
-	let r = n ? le[n](e) : le[D[t].color](e), i = t === "success" ? "info" : t;
-	ue() >= D[t].level && console[i](r);
+function j(e, t = "info", n) {
+	let r = n ? se[n](e) : se[k[t].color](e), i = t === "success" ? "info" : t;
+	ce() >= k[t].level && console[i](r);
 }
 //#endregion
 //#region src/utils/regex.ts
-var fe = /\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, pe = /\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.\/)?([^/][^)]+)\)/g, me = /\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, he = /^\d{2}-/, A = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/, ge = /\[([^\]]+)\]\((?!https?:|\/|#|mailto:)([^)#]*\/)?([^)#/]+\.md)(#[^)]*)?\)/g;
+var ue = /\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, de = /\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.\/)?([^/][^)]+)\)/g, fe = /\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, pe = /^\d{2}-/, me = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/, he = /\[([^\]]+)\]\((?!https?:|\/|#|mailto:)([^)#]*\/)?([^)#/]+\.md)(#[^)]*)?\)/g;
 //#endregion
 //#region src/utils/functions.ts
-async function j(e) {
+async function M(e) {
 	try {
 		return (await fetch(e, {
 			method: "HEAD",
 			redirect: "manual"
 		})).status;
 	} catch (t) {
-		return k(`   Network error while checking '${e}': ${N(t)}`, "debug"), 500;
+		return j(`   Network error while checking '${e}': ${P(t)}`, "debug"), 500;
 	}
 }
-function M(e) {
+function N(e) {
 	return (e.split(/[/\\]/).pop() ?? "").replace(/[^\w.-]/g, "_").replace(/^\.+/, "") || "_";
 }
-function _e(e) {
-	return !V(e) || !("token" in e) ? e : {
+function ge(e) {
+	return !H(e) || !("token" in e) ? e : {
 		...e,
 		token: e.token ? "***" : e.token
 	};
 }
-function N(e) {
+function P(e) {
 	return e instanceof Error ? e.message : String(e);
 }
-function P(e) {
+function F(e) {
 	if (e < 1e3) return `${Math.round(e)}ms`;
 	let t = e / 1e3;
 	if (t < 60) return `${t.toFixed(1)}s`;
 	let n = Math.floor(t / 60), r = Math.round(t % 60);
 	return `${n}m ${String(r).padStart(2, "0")}s`;
 }
-function F(e, t) {
+function _e(e, t) {
+	let n = new Map(t.map((e) => [e.toLowerCase(), e]));
+	return e.split(" ").map((e) => n.get(e.toLowerCase()) ?? e).join(" ");
+}
+function I(e, t) {
 	let n = "";
-	return t?.removeDot && (n = e.startsWith(".") ? e.slice(1) : e, n = n.replaceAll(".", "-")), t?.removeIdx && (n = (n || e).replace(he, "")), t?.removeExt && (n = (n || e).split(".")[0]), t?.replaceDash && (n = (n || e).replaceAll("-", " ")), t?.mode === "capitalize" ? n = (n || e).slice(0, 1).toUpperCase() + (n || e).slice(1).toLowerCase() : t?.mode === "lowercase" ? n = (n || e).toLowerCase() : t?.mode === "uppercase" && (n = (n || e).toUpperCase()), n || e;
+	return t?.removeDot && (n = e.startsWith(".") ? e.slice(1) : e, n = n.replaceAll(".", "-")), t?.removeIdx && (n = (n || e).replace(pe, "")), t?.removeExt && (n = (n || e).split(".")[0]), t?.replaceDash && (n = (n || e).replaceAll("-", " ")), t?.mode === "capitalize" ? n = (n || e).slice(0, 1).toUpperCase() + (n || e).slice(1).toLowerCase() : t?.mode === "lowercase" ? n = (n || e).toLowerCase() : t?.mode === "uppercase" && (n = (n || e).toUpperCase()), t?.acronyms?.length && (n = _e(n || e, t.acronyms)), n || e;
 }
-function I(e, { clean: t } = { clean: !1 }) {
+function L(e, { clean: t } = { clean: !1 }) {
 	try {
-		if (t && a(e)) for (let t of c(e)) u(_(e, t), {
+		if (t && a(e)) for (let t of c(e)) u(v(e, t), {
 			recursive: !0,
 			force: !0
 		});
@@ -200,39 +206,39 @@ function ye(e) {
 		return !1;
 	}
 }
-function L(e) {
-	return (Array.isArray(e) ? e : [e]).flatMap((e) => ye(e) ? [e] : ve(e) ? c(e).filter((e) => e !== ".git").sort().flatMap((t) => L(h(e, t))) : []);
-}
 function R(e) {
-	return L(e).filter((e) => p(e).endsWith(".md"));
+	return (Array.isArray(e) ? e : [e]).flatMap((e) => ye(e) ? [e] : ve(e) ? c(e).filter((e) => e !== ".git").sort().flatMap((t) => R(h(e, t))) : []);
 }
 function z(e) {
+	return R(e).filter((e) => p(e).endsWith(".md"));
+}
+function B(e) {
 	return e.reduce((e, t, n, r) => n ? n === r.length - 1 ? `${e} or "${t}"` : `${e}, "${t}"` : `"${t}"`, "");
 }
 function be(e) {
-	return JSON.parse(s(`${C}/user-${M(e)}.json`).toString());
+	return JSON.parse(s(`${T}/user-${N(e)}.json`).toString());
 }
 function xe(e) {
-	return JSON.parse(s(`${C}/repos-${M(e)}.json`).toString());
+	return JSON.parse(s(`${T}/repos-${N(e)}.json`).toString());
 }
 var Se = /* @__PURE__ */ new Set([
 	"__proto__",
 	"constructor",
 	"prototype"
 ]);
-function B(...e) {
+function V(...e) {
 	return e.reduce((e, t) => (t === null || Object.keys(t).forEach((n) => {
 		if (Se.has(n)) return;
 		let r = e ? e[n] : null, i = t[n];
-		e[n] = V(r) && V(i) ? B(r, i) : V(i) ? B({}, i) : i;
+		e[n] = H(r) && H(i) ? V(r, i) : H(i) ? V({}, i) : i;
 	}), e), {});
 }
-function V(e) {
+function H(e) {
 	return e && typeof e == "object" && !Array.isArray(e);
 }
 function Ce(e) {
 	if (!e) return {};
-	let t = _(process.cwd(), e), n;
+	let t = v(process.cwd(), e), n;
 	try {
 		n = s(t, "utf8");
 	} catch {
@@ -244,26 +250,26 @@ function Ce(e) {
 		throw Error(`Invalid JSON in config file '${e}'.`);
 	}
 }
-function H(e) {
+function U(e) {
 	return e.split(",");
 }
 function we(e, t) {
-	let n = s(e, "utf8").replace(fe, (e, n, r) => `[${n}](${t}/${r})`);
+	let n = s(e, "utf8").replace(ue, (e, n, r) => `[${n}](${t}/${r})`);
 	f(e, n, "utf8");
 }
 function Te(e, t) {
-	let n = s(e, "utf8"), r = n.match(A);
+	let n = s(e, "utf8"), r = n.match(me);
 	if (r) {
-		let i = v.parse(r[1]) ?? {};
-		i.lastUpdated = t, f(e, n.replace(A, `---\n${v.stringify(i)}---\n`), "utf8");
+		let i = y.parse(r[1]) ?? {};
+		i.lastUpdated = t, f(e, n.replace(me, `---\n${y.stringify(i)}---\n`), "utf8");
 	} else f(e, `---\nlastUpdated: ${t}\n---\n\n${n}`, "utf8");
 }
 function Ee(e) {
-	return e ? e.split("/").map((e) => e === "" || e === "." || e === ".." ? e : F(e, { removeIdx: !0 })).join("/") : "";
+	return e ? e.split("/").map((e) => e === "" || e === "." || e === ".." ? e : I(e, { removeIdx: !0 })).join("/") : "";
 }
 function De(e) {
-	let t = s(e, "utf8").replace(ge, (e, t, n, r, i) => {
-		let a = F(r, {
+	let t = s(e, "utf8").replace(he, (e, t, n, r, i) => {
+		let a = I(r, {
 			mode: "lowercase",
 			removeIdx: !0
 		});
@@ -272,49 +278,51 @@ function De(e) {
 	f(e, t, "utf8");
 }
 function Oe(e, t) {
-	let n = s(e, "utf8").replace(pe, (e, n, r, i) => `[${n}](${t}/${i})`).replace(me, (e, t, n, r) => `[${t}](${r})`);
+	let n = s(e, "utf8").replace(de, (e, n, r, i) => `[${n}](${t}/${i})`).replace(fe, (e, t, n, r) => `[${t}](${r})`);
 	f(e, n, "utf8");
 }
 //#endregion
 //#region src/schemas/global.ts
-var U = ["github", "gitlab"], W = ["single", "multi"], ke = [
+var W = ["github", "gitlab"], G = ["single", "multi"], ke = [
 	"true",
 	"false",
 	"null"
-], G = /^\w[\w./-]*$/, Ae = "Branch name must start with a letter, digit or underscore and only contain letters, digits, \".\", \"-\", \"_\" or \"/\".", K = b.object({
-	usernames: b.string().array().describe("List of comma separated Git provider usernames used to collect data."),
-	logLevel: b.enum(O).optional().describe(`Verbosity of the CLI output. Values should be ${z(O)}. Defaults to "info", or to the LOG_LEVEL environment variable when set.`),
-	branch: b.string().regex(G, Ae).optional().describe("Branch used to collect Git provider data. Defaults to each repository's own default branch when not set."),
-	gitProvider: b.enum(U).default("github").describe(`Git provider used to retrieve data. Values should be ${z(U)}.`),
-	reposFilter: b.string().array().describe("List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories."),
-	extraHeaderPages: b.string().array().describe("List of comma separated additional files or directories to process Vitepress header pages."),
-	extraPublicContent: b.string().array().describe("List of comma separated additional files or directories to process Vitepress public folder."),
-	extraTheme: b.string().array().describe("List of comma separated additional files or directories to use as Vitepress theme."),
-	forks: b.boolean().default(!1).describe("Whether or not to create the dedicated fork page that aggregate external contributions."),
-	lastUpdated: b.boolean().default(!1).describe("Whether or not to inject each page's last Git commit date as Vitepress \"lastUpdated\" frontmatter."),
-	sidebarMode: b.enum(W).default("single").describe(`Shape of the generated sidebar. Values should be ${z(W)}. "single" lists every repository in one sidebar, "multi" gives each repository its own sidebar.`),
-	sidebarCollapsed: b.union([b.boolean(), b.null()]).default(!0).describe("Collapse behaviour of generated sidebar groups. \"true\" collapses them by default, \"false\" expands them, \"null\" makes them non-collapsible."),
-	vitepressConfig: b.any().optional().describe("Path to the vitepress configuration file."),
-	websiteTitle: b.string().describe("Website title."),
-	websiteTagline: b.string().describe("Website tagline.")
+], Ae = /^\w[\w./-]*$/, je = "Branch name must start with a letter, digit or underscore and only contain letters, digits, \".\", \"-\", \"_\" or \"/\".", K = x.object({
+	usernames: x.string().array().describe("List of comma separated Git provider usernames used to collect data."),
+	logLevel: x.enum(A).optional().describe(`Verbosity of the CLI output. Values should be ${B(A)}. Defaults to "info", or to the LOG_LEVEL environment variable when set.`),
+	branch: x.string().regex(Ae, je).optional().describe("Branch used to collect Git provider data. Defaults to each repository's own default branch when not set."),
+	gitProvider: x.enum(W).default("github").describe(`Git provider used to retrieve data. Values should be ${B(W)}.`),
+	reposFilter: x.string().array().describe("List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories."),
+	extraHeaderPages: x.string().array().describe("List of comma separated additional files or directories to process Vitepress header pages."),
+	extraPublicContent: x.string().array().describe("List of comma separated additional files or directories to process Vitepress public folder."),
+	extraTheme: x.string().array().describe("List of comma separated additional files or directories to use as Vitepress theme."),
+	forks: x.boolean().default(!1).describe("Whether or not to create the dedicated fork page that aggregate external contributions."),
+	lastUpdated: x.boolean().default(!1).describe("Whether or not to inject each page's last Git commit date as Vitepress \"lastUpdated\" frontmatter."),
+	sidebarMode: x.enum(G).default("single").describe(`Shape of the generated sidebar. Values should be ${B(G)}. "single" lists every repository in one sidebar, "multi" gives each repository its own sidebar.`),
+	sidebarCollapsed: x.union([x.boolean(), x.null()]).default(!0).describe("Collapse behaviour of generated sidebar groups. \"true\" collapses them by default, \"false\" expands them, \"null\" makes them non-collapsible."),
+	acronyms: x.string().regex(/^[^\s-]+$/, "Each acronym must be a single word, with no space or dash, as it is matched against one word of a label.").array().describe("List of comma separated words kept exactly as written in generated sidebar labels and home page titles, such as \"CLI\" or \"API\", matched whole and ignoring case."),
+	vitepressConfig: x.any().optional().describe("Path to the vitepress configuration file."),
+	websiteTitle: x.string().describe("Website title."),
+	websiteTagline: x.string().describe("Website tagline.")
 }), q = K.partial().extend({
-	branch: b.string().regex(G, Ae).optional().describe(K.shape.branch.description || ""),
-	gitProvider: b.enum(U).optional().describe(K.shape.gitProvider.description || ""),
-	logLevel: b.enum(O).optional().describe(K.shape.logLevel.description || ""),
-	forks: b.boolean().optional().describe(K.shape.forks.description || ""),
-	lastUpdated: b.boolean().optional().describe(K.shape.lastUpdated.description || ""),
-	config: b.string().optional().describe("Path to the docpress configuration file."),
-	token: b.string().optional().describe("Git provider token used to collect data."),
-	usernames: b.string().transform(H).optional().describe(K.shape.usernames.description || ""),
-	reposFilter: b.string().transform(H).optional().describe(K.shape.reposFilter.description || ""),
-	extraHeaderPages: b.string().transform(H).optional().describe(K.shape.extraHeaderPages.description || ""),
-	extraPublicContent: b.string().transform(H).optional().describe(K.shape.extraPublicContent.description || ""),
-	extraTheme: b.string().transform(H).optional().describe(K.shape.extraTheme.description || ""),
-	vitepressConfig: b.string().optional().describe(K.shape.vitepressConfig.description || ""),
-	sidebarMode: b.enum(W).optional().describe(K.shape.sidebarMode.description || ""),
-	sidebarCollapsed: b.enum(ke).transform((e) => e === "null" ? null : e === "true").optional().describe(`${K.shape.sidebarCollapsed.description} Values should be ${z(ke)}.`)
+	branch: x.string().regex(Ae, je).optional().describe(K.shape.branch.description || ""),
+	gitProvider: x.enum(W).optional().describe(K.shape.gitProvider.description || ""),
+	logLevel: x.enum(A).optional().describe(K.shape.logLevel.description || ""),
+	forks: x.boolean().optional().describe(K.shape.forks.description || ""),
+	lastUpdated: x.boolean().optional().describe(K.shape.lastUpdated.description || ""),
+	config: x.string().optional().describe("Path to the docpress configuration file."),
+	token: x.string().optional().describe("Git provider token used to collect data."),
+	usernames: x.string().transform(U).optional().describe(K.shape.usernames.description || ""),
+	reposFilter: x.string().transform(U).optional().describe(K.shape.reposFilter.description || ""),
+	extraHeaderPages: x.string().transform(U).optional().describe(K.shape.extraHeaderPages.description || ""),
+	extraPublicContent: x.string().transform(U).optional().describe(K.shape.extraPublicContent.description || ""),
+	extraTheme: x.string().transform(U).optional().describe(K.shape.extraTheme.description || ""),
+	vitepressConfig: x.string().optional().describe(K.shape.vitepressConfig.description || ""),
+	sidebarMode: x.enum(G).optional().describe(K.shape.sidebarMode.description || ""),
+	sidebarCollapsed: x.enum(ke).transform((e) => e === "null" ? null : e === "true").optional().describe(`${K.shape.sidebarCollapsed.description} Values should be ${B(ke)}.`),
+	acronyms: x.string().transform(U).pipe(K.shape.acronyms).optional().describe(K.shape.acronyms.description || "")
 });
-function je(e) {
+function Me(e) {
 	if (!e) return {};
 	let t = { ...e };
 	for (let e of [
@@ -322,30 +330,31 @@ function je(e) {
 		"reposFilter",
 		"extraHeaderPages",
 		"extraPublicContent",
-		"extraTheme"
+		"extraTheme",
+		"acronyms"
 	]) typeof t[e] == "string" && (t[e] = [t[e]]);
 	return t;
 }
-function Me(e) {
+function Ne(e) {
 	let t = K.partial().safeParse(e);
-	if (!t.success) throw Error(b.prettifyError(t.error));
+	if (!t.success) throw t.error;
 	return t.data;
 }
-function Ne(e) {
+function Pe(e) {
 	if (!e.usernames?.length) throw Error("The usernames field is required");
 	return e;
 }
-function Pe(e, t) {
+function Fe(e, t) {
 	if (e) return e;
 	let n = t === "gitlab" ? process.env.GITLAB_TOKEN : process.env.GITHUB_TOKEN;
 	return process.env.DOCPRESS_TOKEN || n || void 0;
 }
-function Fe(e) {
-	e && (process.env.LOG_LEVEL = String(de(e)));
+function Ie(e) {
+	e && (process.env.LOG_LEVEL = String(le(e)));
 }
-var Ie = q.partial().transform((e, t) => {
+var Le = q.partial().transform((e, t) => {
 	try {
-		let { config: t, vitepressConfig: n, token: r, ...i } = e, a = Me(je(Ce(t))), o = {
+		let { config: t, vitepressConfig: n, token: r, ...i } = e, a = Ne(Me(Ce(t))), o = {
 			gitProvider: "github",
 			forks: !1,
 			lastUpdated: !1,
@@ -358,23 +367,31 @@ var Ie = q.partial().transform((e, t) => {
 				...Ce(n) || {}
 			} } : {}
 		};
-		return Fe(o.logLevel), Ne({
+		return Ie(o.logLevel), Pe({
 			...o,
-			token: Pe(r, o.gitProvider)
+			token: Fe(r, o.gitProvider)
 		});
 	} catch (e) {
+		if (e instanceof x.ZodError) {
+			for (let n of e.issues) t.addIssue({
+				code: "custom",
+				message: n.message,
+				path: n.path
+			});
+			return x.NEVER;
+		}
 		return t.addIssue({
 			code: "custom",
 			message: e instanceof Error ? e.message : JSON.stringify(e, null, 2)
-		}), b.NEVER;
+		}), x.NEVER;
 	}
 });
 //#endregion
 //#region src/utils/commands.ts
 function J(e, t) {
-	k("Initializing Docpress...", "info", "blue"), k("\n\n-> Checking for required environment settings and configurations.", "info"), k(`   Debug info - cmd: ${e}`, "debug");
-	let n = Ie.safeParse(t);
-	return n.success || (k(`   An error occurred while checking configuration.\n     ${b.prettifyError(n.error)}`, "error"), process.exit(1)), k(`   Debug info - resolved options: ${JSON.stringify(_e(n.data))}`, "debug"), k("   Setup complete! Ready to process your documentation.", "info"), n.data;
+	j("Initializing Docpress...", "info", "blue"), j("\n\n-> Checking for required environment settings and configurations.", "info"), j(`   Debug info - cmd: ${e}`, "debug");
+	let n = Le.safeParse(t);
+	return n.success || (j(`   An error occurred while checking configuration.\n     ${x.prettifyError(n.error)}`, "error"), process.exit(1)), j(`   Debug info - resolved options: ${JSON.stringify(ge(n.data))}`, "debug"), j("   Setup complete! Ready to process your documentation.", "info"), n.data;
 }
 function Y(e, t) {
 	return Object.fromEntries(Object.entries(t).filter(([t]) => e.getOptionValueSource(t) !== "default"));
@@ -385,27 +402,27 @@ function X(e, t) {
 }
 //#endregion
 //#region src/lib/git.ts
-var Le = {
+var Re = {
 	debug: () => {},
 	info: () => {},
 	warn: (e) => {
-		e.includes("404") || k(e, "warn");
+		e.includes("404") || j(e, "warn");
 	},
 	error: (e) => {
-		e.includes("404") || k(e, "error");
+		e.includes("404") || j(e, "error");
 	}
 };
-async function Re({ username: e, token: t, branch: n }) {
-	k(`   Get infos for username '${e}'.`, "info");
-	let r = new x({
+async function ze({ username: e, token: t, branch: n }) {
+	j(`   Get infos for username '${e}'.`, "info");
+	let r = new S({
 		auth: t,
-		log: Le
+		log: Re
 	});
-	k("   Get user infos.", "debug");
+	j("   Get user infos.", "debug");
 	let { data: i } = await r.rest.users.getByUsername({ username: e }).catch((t) => {
 		throw t.status === 404 ? /* @__PURE__ */ Error(`No GitHub user found for '${e}'.`) : t;
 	});
-	return k("   Get repositories infos.", "debug"), {
+	return j("   Get repositories infos.", "debug"), {
 		user: i,
 		repos: await r.paginate(r.rest.repos.listForUser, {
 			username: e,
@@ -415,11 +432,11 @@ async function Re({ username: e, token: t, branch: n }) {
 		branch: n
 	};
 }
-async function ze({ repository: e, token: t }) {
-	k(`   Get contributors infos for repository '${e.name}'.`, "info");
-	let n = new x({
+async function Be({ repository: e, token: t }) {
+	j(`   Get contributors infos for repository '${e.name}'.`, "info");
+	let n = new S({
 		auth: t,
-		log: Le
+		log: Re
 	}), r;
 	try {
 		r = (await n.rest.repos.get({
@@ -427,7 +444,7 @@ async function ze({ repository: e, token: t }) {
 			repo: e.name
 		})).data;
 	} catch (t) {
-		return k(`   Failed to get repository infos for '${e.name}'. Error : ${N(t)}`, "warn"), {
+		return j(`   Failed to get repository infos for '${e.name}'. Error : ${P(t)}`, "warn"), {
 			source: void 0,
 			contributors: []
 		};
@@ -444,7 +461,7 @@ async function ze({ repository: e, token: t }) {
 			per_page: 100
 		})) i.push(...e);
 	} catch (t) {
-		return k(`   Failed to get contributors infos for repository '${e.name}'. Error : ${N(t)}`, "warn"), {
+		return j(`   Failed to get contributors infos for repository '${e.name}'. Error : ${P(t)}`, "warn"), {
 			source: r.source,
 			contributors: []
 		};
@@ -454,7 +471,7 @@ async function ze({ repository: e, token: t }) {
 		contributors: i
 	};
 }
-function Be(e) {
+function Ve(e) {
 	let t = /* @__PURE__ */ new Map(), n = null;
 	for (let r of e.split("\n")) {
 		let e = r.trim();
@@ -468,12 +485,12 @@ function Be(e) {
 	}
 	return t;
 }
-async function Ve(e, t, n) {
-	let r = R([t]);
+async function He(e, t, n) {
+	let r = z([t]);
 	if (!r.length) return;
 	let i;
 	try {
-		i = Be(await e.raw([
+		i = Ve(await e.raw([
 			"-c",
 			"core.quotePath=false",
 			"log",
@@ -481,19 +498,19 @@ async function Ve(e, t, n) {
 			"--name-only"
 		]));
 	} catch (e) {
-		k(`   Unable to read commit history for repository '${n}'. Error : ${N(e)}`, "warn");
+		j(`   Unable to read commit history for repository '${n}'. Error : ${P(e)}`, "warn");
 		return;
 	}
 	for (let e of r) {
-		let n = i.get(ee(t, e));
+		let n = i.get(_(t, e));
 		n && Te(e, n);
 	}
 }
-async function He(e, t, n, a, o, s) {
-	if (t.startsWith("-") || a.startsWith("-")) return k(`   Refusing to clone '${e}': unsafe repository URL or branch name.`, "error"), !1;
-	I(n, { clean: !0 });
+async function Ue(e, t, n, a, o, s) {
+	if (t.startsWith("-") || a.startsWith("-")) return j(`   Refusing to clone '${e}': unsafe repository URL or branch name.`, "error"), !1;
+	L(n, { clean: !0 });
 	try {
-		let c = S({
+		let c = C({
 			baseDir: n,
 			config: [
 				"maintenance.auto=false",
@@ -502,24 +519,24 @@ async function He(e, t, n, a, o, s) {
 			]
 		});
 		await c.init().addConfig("core.sparseCheckout", "true", !0, "local").addRemote("origin", t);
-		for (let t of o) k(`   Add '${t}' to '${e}' sparse-checkout file.`, "debug"), r(_(n, ".git/info/sparse-checkout"), `${t}\n`, "utf8");
-		return k(`   Clone repository '${e}'.`, "info"), await c.pull("origin", a), s && await Ve(c, n, e), o.some((e) => e.includes("docs")) && (i(_(n, "docs"), n, { recursive: !0 }), u(_(n, "docs"), { recursive: !0 })), u(_(n, ".git"), { recursive: !0 }), !0;
+		for (let t of o) j(`   Add '${t}' to '${e}' sparse-checkout file.`, "debug"), r(v(n, ".git/info/sparse-checkout"), `${t}\n`, "utf8");
+		return j(`   Clone repository '${e}'.`, "info"), await c.pull("origin", a), s && await He(c, n, e), o.some((e) => e.includes("docs")) && (i(v(n, "docs"), n, { recursive: !0 }), u(v(n, "docs"), { recursive: !0 })), u(v(n, ".git"), { recursive: !0 }), !0;
 	} catch (t) {
-		return k(`   Error when cloning repository '${e}': ${N(t)}.`, "error"), !1;
+		return j(`   Error when cloning repository '${e}': ${P(t)}.`, "error"), !1;
 	}
 }
 //#endregion
 //#region src/lib/gitlab.ts
-var Ue = "https://gitlab.com/api/v4";
+var We = "https://gitlab.com/api/v4";
 async function Z(e, t) {
-	let n = await fetch(`${Ue}${e}`, { headers: t ? { "PRIVATE-TOKEN": t } : {} });
+	let n = await fetch(`${We}${e}`, { headers: t ? { "PRIVATE-TOKEN": t } : {} });
 	if (!n.ok) throw Error(`GitLab API request failed for '${e}' (status: ${n.status}).`);
 	return {
 		data: await n.json(),
 		headers: n.headers
 	};
 }
-async function We(e, t) {
+async function Ge(e, t) {
 	let n = e.includes("?") ? "&" : "?", r = [], i = "1";
 	for (; i;) {
 		let a = await Z(`${e}${n}per_page=100&page=${i}`, t);
@@ -527,7 +544,7 @@ async function We(e, t) {
 	}
 	return r;
 }
-function Ge(e) {
+function Ke(e) {
 	return {
 		login: e.username ?? e.path,
 		name: e.name,
@@ -536,7 +553,7 @@ function Ge(e) {
 		html_url: e.web_url
 	};
 }
-function Ke(e, t) {
+function qe(e, t) {
 	return {
 		name: e.path,
 		owner: { login: t },
@@ -550,32 +567,32 @@ function Ke(e, t) {
 		stargazers_count: e.star_count
 	};
 }
-async function qe({ username: e, token: t, branch: n }) {
-	k(`   Get infos for username '${e}'.`, "info");
+async function Je({ username: e, token: t, branch: n }) {
+	j(`   Get infos for username '${e}'.`, "info");
 	let { data: r } = await Z(`/users?username=${encodeURIComponent(e)}`, t);
 	if (r.length) {
 		let i = r[0];
-		t && (i = await Z(`/users/${r[0].id}`, t).then((e) => e.data).catch(() => r[0])), k("   Get repositories infos.", "debug");
-		let a = await We(`/users/${r[0].id}/projects`, t);
+		t && (i = await Z(`/users/${r[0].id}`, t).then((e) => e.data).catch(() => r[0])), j("   Get repositories infos.", "debug");
+		let a = await Ge(`/users/${r[0].id}/projects`, t);
 		return {
-			user: Ge(i),
-			repos: a.map((t) => Ke(t, i.username ?? e)),
+			user: Ke(i),
+			repos: a.map((t) => qe(t, i.username ?? e)),
 			branch: n
 		};
 	}
-	k(`   No GitLab user '${e}' found, trying groups.`, "debug");
+	j(`   No GitLab user '${e}' found, trying groups.`, "debug");
 	let i = await Z(`/groups/${encodeURIComponent(e)}?with_projects=false`, t).then((e) => e.data).catch(() => {
 		throw Error(`No GitLab user or group found for '${e}'.`);
-	}), a = await We(`/groups/${encodeURIComponent(e)}/projects`, t);
+	}), a = await Ge(`/groups/${encodeURIComponent(e)}/projects`, t);
 	return {
-		user: Ge(i),
-		repos: a.map((t) => Ke(t, i.path ?? e)),
+		user: Ke(i),
+		repos: a.map((t) => qe(t, i.path ?? e)),
 		branch: n
 	};
 }
 //#endregion
 //#region src/lib/fetch.ts
-function Je(e, t, n) {
+function Ye(e, t, n) {
 	if (n === "gitlab") {
 		let n = e.html_url ?? `https://gitlab.com/${e.owner.login}/${e.name}`;
 		return {
@@ -591,11 +608,11 @@ function Je(e, t, n) {
 		raw_url: `https://raw.githubusercontent.com/${e.owner.login}/${e.name}/${t}`
 	};
 }
-async function Ye(e) {
+async function Xe(e) {
 	let [t, n, r] = await Promise.all([
-		j(`${e.blob_url}/README.md`),
-		j(`${e.tree_url}/docs`),
-		j(`${e.blob_url}/docs/01-readme.md`)
+		M(`${e.blob_url}/README.md`),
+		M(`${e.tree_url}/docs`),
+		M(`${e.blob_url}/docs/01-readme.md`)
 	]);
 	return {
 		rootReadmeStatus: t,
@@ -603,19 +620,19 @@ async function Ye(e) {
 		docsReadmeStatus: r
 	};
 }
-async function Xe({ username: e, branch: t, reposFilter: n, gitProvider: r, token: i, lastUpdated: a, multiUser: o }) {
-	let { user: s, repos: c, branch: l } = await (r === "gitlab" ? qe : Re)({
+async function Ze({ username: e, branch: t, reposFilter: n, gitProvider: r, token: i, lastUpdated: a, multiUser: o }) {
+	let { user: s, repos: c, branch: l } = await (r === "gitlab" ? Je : ze)({
 		username: e,
 		token: i,
 		branch: t
-	}), { repos: u } = await $e(s, c, l, n, r, o ? `${M(e)}/` : "");
-	await et(u, n, a);
+	}), { repos: u } = await et(s, c, l, n, r, o ? `${N(e)}/` : "");
+	await tt(u, n, a);
 }
-async function Ze(e, t, n, r, i = "") {
+async function Qe(e, t, n, r, i = "") {
 	let a = [];
 	return await Promise.all(e.map(async (e) => {
-		let o = t ?? e.default_branch ?? "main", s = _(ae, `${i}${F(M(e.name), { removeDot: !0 })}`), c = tt(e, n), l = Je(e, o, r), u = [];
-		!e.fork && !e.private && !c && (u = await Qe(e, o, r, l)), a.push({
+		let o = t ?? e.default_branch ?? "main", s = v(re, `${i}${I(N(e.name), { removeDot: !0 })}`), c = nt(e, n), l = Ye(e, o, r), u = [];
+		!e.fork && !e.private && !c && (u = await $e(e, o, r, l)), a.push({
 			...e,
 			docpress: {
 				filtered: c,
@@ -629,38 +646,38 @@ async function Ze(e, t, n, r, i = "") {
 		});
 	})), a;
 }
-async function Qe(e, t, n, r) {
-	let i = await Ye(r ?? Je(e, t, n)), a = [];
+async function $e(e, t, n, r) {
+	let i = await Xe(r ?? Ye(e, t, n)), a = [];
 	return Object.values(i).every((e) => e !== 200) || !e.size ? [] : (i.docsFolderStatus === 200 && a.push("docs/*"), (i.docsFolderStatus !== 200 || i.docsReadmeStatus !== 200) && a.push("README.md", "!*/**/README.md"), a);
 }
-async function $e(e, t, n, r, i, a = "") {
-	f(`${C}/user-${M(e.login)}.json`, JSON.stringify(e, null, 2));
-	let o = await Ze(t, n, r, i, a);
-	return f(`${C}/repos-${M(e.login)}.json`, JSON.stringify(o, null, 2)), {
+async function et(e, t, n, r, i, a = "") {
+	f(`${T}/user-${N(e.login)}.json`, JSON.stringify(e, null, 2));
+	let o = await Qe(t, n, r, i, a);
+	return f(`${T}/repos-${N(e.login)}.json`, JSON.stringify(o, null, 2)), {
 		user: e,
 		repos: o
 	};
 }
-async function et(e, t, n) {
+async function tt(e, t, n) {
 	if (!e) {
-		k("   No repositories to process.", "warn");
+		j("   No repositories to process.", "warn");
 		return;
 	}
-	let r = await Promise.all(e.filter((e) => !tt(e, t)).map(async (e) => {
-		let t = await He(e.name, e.clone_url, e.docpress.projectPath, e.docpress.branch, e.docpress.includes, n);
+	let r = await Promise.all(e.filter((e) => !nt(e, t)).map(async (e) => {
+		let t = await Ue(e.name, e.clone_url, e.docpress.projectPath, e.docpress.branch, e.docpress.includes, n);
 		return {
 			name: e.name,
 			success: t
 		};
 	}));
 	if (!r.length) {
-		k("   No repository matched the current filters.", "warn");
+		j("   No repository matched the current filters.", "warn");
 		return;
 	}
 	let i = r.filter(({ success: e }) => !e).map(({ name: e }) => e), a = r.length - i.length;
-	i.length ? k(`   Cloned ${a}/${r.length} repository(ies), ${i.length} failed: ${i.join(", ")}.`, "warn") : k(`   Cloned ${a}/${r.length} repository(ies).`, "success");
+	i.length ? j(`   Cloned ${a}/${r.length} repository(ies), ${i.length} failed: ${i.join(", ")}.`, "warn") : j(`   Cloned ${a}/${r.length} repository(ies).`, "success");
 }
-function tt(e, t) {
+function nt(e, t) {
 	if ("docpress" in e && !e.docpress.includes.length) return !0;
 	let n = t?.filter((e) => !e.startsWith("!")) ?? [], r = t?.every((e) => e.startsWith("!")), i = t?.filter((e) => e.startsWith("!")).some((t) => e.name === t.substring(1)), a = !t || n.includes(e.name) || e.fork && !i || r && !i, o = i || !a;
 	return !(e.clone_url && !e.private && !o);
@@ -672,24 +689,24 @@ var Q = [
 	n("--log-level <string>", q.shape.logLevel.description),
 	n("-T, --token <string>", q.shape.token.description),
 	n("-U, --usernames <string>", q.shape.usernames.description)
-], nt = "fetch", rt = [
+], rt = "fetch", it = [
 	n("-b, --branch <string>", K.shape.branch.description),
 	n("-g, --git-provider <string>", K.shape.gitProvider.description).default(K.shape.gitProvider.def.defaultValue),
 	n("-l, --last-updated", K.shape.lastUpdated.description),
 	n("-r, --repos-filter <string>", K.shape.reposFilter.description)
-], it = X(t(nt), [...rt, ...Q]).description("Fetch docs with the given username(s) and git provider.").action(async (e, t) => {
-	await at(J(nt, Y(t, e)));
+], at = X(t(rt), [...it, ...Q]).description("Fetch docs with the given username(s) and git provider.").action(async (e, t) => {
+	await ot(J(rt, Y(t, e)));
 });
-async function at(e) {
+async function ot(e) {
 	let { usernames: t, reposFilter: n, token: r, branch: i, gitProvider: a, lastUpdated: o } = e;
-	k("\n-> Start fetching documentation files. This may take a moment, especially for larger repositories.", "info");
+	j("\n-> Start fetching documentation files. This may take a moment, especially for larger repositories.", "info");
 	let s = Date.now();
-	I(C, { clean: !0 });
+	L(T, { clean: !0 });
 	let c = [];
 	for (let e of t) {
 		let s = t.length > 1 ? n?.filter((t) => t.replace(/^!/, "").startsWith(`${e}/`)).map((t) => t.replace(`${e}/`, "")) : n;
 		try {
-			await Xe({
+			await Ze({
 				username: e,
 				branch: i,
 				reposFilter: s,
@@ -699,15 +716,15 @@ async function at(e) {
 				multiUser: t.length > 1
 			});
 		} catch (t) {
-			c.push(e), k(`   Failed to fetch documentation for '${e}': ${N(t)}`, "error");
+			c.push(e), j(`   Failed to fetch documentation for '${e}': ${P(t)}`, "error");
 		}
 	}
 	if (c.length === t.length) throw Error(`Failed to fetch documentation for all requested username(s): ${c.join(", ")}.`);
-	k(`   Fetched documentation for ${t.length - c.length}/${t.length} username(s) in ${P(Date.now() - s)}.`, c.length ? "warn" : "success");
+	j(`   Fetched documentation for ${t.length - c.length}/${t.length} username(s) in ${F(Date.now() - s)}.`, c.length ? "warn" : "success");
 }
 //#endregion
 //#region src/commands/build.ts
-async function ot(e) {
+async function st(e) {
 	let t = console.warn;
 	console.warn = function(...e) {
 		e.length > 0 && typeof e[0] == "string" && (e[0].includes("[Vue warn]: Invalid watch source:") || e[0].includes("{ open: false }")) || t.apply(console, e);
@@ -718,32 +735,32 @@ async function ot(e) {
 		console.warn = t;
 	}
 }
-var st = X(t("build"), Q).description("Build vitepress website.").action(async (e) => {
-	await ct();
+var ct = X(t("build"), Q).description("Build vitepress website.").action(async (e) => {
+	await lt();
 });
-async function ct() {
-	k("\n-> Start building Vitepress website.\n\n", "info");
+async function lt() {
+	j("\n-> Start building Vitepress website.\n\n", "info");
 	let e = Date.now();
 	try {
-		await ot(async () => {
-			await te(C, { onAfterConfigResolve(e) {
-				ne(e);
+		await st(async () => {
+			await w(T, { onAfterConfigResolve(e) {
+				ee(e);
 			} });
 		});
 	} catch (e) {
-		throw Error(`Docpress build failed: ${N(e)}`);
+		throw Error(`Docpress build failed: ${P(e)}`);
 	}
-	k(`\n\nDocpress build succeeded in ${P(Date.now() - e)}.`, "success");
+	j(`\n\nDocpress build succeeded in ${F(Date.now() - e)}.`, "success");
 }
 //#endregion
 //#region src/utils/templates.ts
-function lt(e, t) {
+function ut(e, t) {
 	let n = s(e, { encoding: "utf8" });
-	I(m(t)), f(t, n);
+	L(m(t)), f(t, n);
 }
 //#endregion
 //#region src/lib/vitepress.ts
-var ut = {
+var dt = {
 	base: "/",
 	lang: "en-US",
 	vite: { publicDir: "../public" },
@@ -776,24 +793,24 @@ var ut = {
 		}
 	}
 };
-function dt(e, t, n) {
-	return n ? B(ut, n, { themeConfig: {
+function ft(e, t, n) {
+	return n ? V(dt, n, { themeConfig: {
 		sidebar: e,
 		nav: t
-	} }) : B(ut, { themeConfig: {
+	} }) : V(dt, { themeConfig: {
 		sidebar: e,
 		nav: t
 	} });
 }
 //#endregion
 //#region src/lib/prepare.ts
-function ft(e) {
+function pt(e) {
 	return e === null ? {} : { collapsed: e };
 }
-async function pt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, vitepressConfig: r, forks: i, gitProvider: o, lastUpdated: s, sidebarMode: c, sidebarCollapsed: l, token: u, username: d, websiteTitle: f, websiteTagline: p }) {
-	let m = i && o !== "gitlab";
-	i && !m && k("   The forks page is not supported with the 'gitlab' provider, skipping.", "warn");
-	let h = be(d), g = xe(d).reduce(({ internals: e, forks: t }, n) => {
+async function mt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, vitepressConfig: r, forks: i, gitProvider: o, lastUpdated: s, sidebarMode: c, sidebarCollapsed: l, acronyms: u, token: d, username: f, websiteTitle: p, websiteTagline: m }) {
+	let h = i && o !== "gitlab";
+	i && !h && j("   The forks page is not supported with the 'gitlab' provider, skipping.", "warn");
+	let g = be(f), _ = xe(f).reduce(({ internals: e, forks: t }, n) => {
 		let { clone_url: r, private: i, fork: a, docpress: o } = n;
 		if (r && !i && !o.filtered) {
 			if (!a && o.includes.length) return {
@@ -812,43 +829,44 @@ async function pt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, v
 	}, {
 		internals: [],
 		forks: []
-	}), ee = {
-		title: f,
-		tagline: p
-	}, { index: v, sidebar: y } = Tt(g.internals, h, ee, {
+	}), y = {
+		title: p,
+		tagline: m
+	}, { index: b, sidebar: x } = Et(_.internals, g, y, {
 		mode: c,
-		collapsed: l
-	}), b, x;
-	if (a(w) && a(T)) {
-		let e = await At(T), t = await jt(w);
-		b = Ct(e.themeConfig?.sidebar, y), x = {
-			...v,
-			features: [...t.features, ...v.features].sort((e, t) => e.title.localeCompare(t.title))
+		collapsed: l,
+		acronyms: u
+	}), S, C;
+	if (a(E) && a(D)) {
+		let e = await jt(D), t = await Mt(E);
+		S = Tt(e.themeConfig?.sidebar, x), C = {
+			...b,
+			features: [...t.features, ...b.features].sort((e, t) => e.title.localeCompare(t.title))
 		};
-	} else b = y, x = v;
-	let S = [];
+	} else S = x, C = b;
+	let w = [];
 	if (e) {
-		let t = Et(e);
-		m ? S.push(...t.filter((e) => e.link !== "/forks")) : S.push(...t);
+		let t = Dt(e);
+		h ? w.push(...t.filter((e) => e.link !== "/forks")) : w.push(...t);
 	}
-	t && (k("   Add extras Vitepress public folder content.", "info"), Dt(t, _(C, "public"))), n && (k("   Add extras Vitepress theme files.", "info"), Dt(n, _(ce))), m && d.length && (k("   Add fork page to display external contributions.", "info"), await kt(g.forks, d, u), S.push({
+	t && (j("   Add extras Vitepress public folder content.", "info"), Ot(t, v(T, "public"))), n && (j("   Add extras Vitepress theme files.", "info"), Ot(n, v(oe))), h && f.length && (j("   Add fork page to display external contributions.", "info"), await At(_.forks, f, d), w.push({
 		text: "Forks",
 		link: "/forks"
 	}));
-	let te = s ? {
+	let ee = s ? {
 		lastUpdated: !0,
 		...r
 	} : r;
-	Nt(dt(b, S, te), x);
+	Pt(ft(S, w, ee), C);
 }
-function mt(e, t) {
-	let n = `${F(p(t), {
+function ht(e, t) {
+	let n = `${I(p(t), {
 		mode: "lowercase",
 		removeIdx: !0
 	}) === "readme.md" ? "\n## Sources" : "# Sources"}\n\nTake a look at the [project sources](${e}).\n`;
 	r(t, n, "utf8");
 }
-function ht(e, t, n) {
+function gt(e, t, n) {
 	let { name: r, login: i, bio: a } = t, { title: o, tagline: s } = n;
 	return {
 		layout: "home",
@@ -862,138 +880,142 @@ function ht(e, t, n) {
 		features: e
 	};
 }
-function gt(e, t, n, r = "") {
-	let i = {
-		title: F(e, {
+function _t(e, t, n, r = "", i = []) {
+	let a = {
+		title: I(e, {
 			mode: "capitalize",
-			replaceDash: !0
+			replaceDash: !0,
+			acronyms: i
 		}),
 		details: t,
-		link: `/${r}${F(e, { removeDot: !0 })}/introduction`
+		link: `/${r}${I(e, { removeDot: !0 })}/introduction`
 	};
-	return n ? [...n, i] : [i];
+	return n ? [...n, a] : [a];
 }
-function _t(e, t, n = !0) {
+function vt(e, t, n = !0, r = []) {
 	return {
-		text: F(e, {
+		text: I(e, {
 			mode: "capitalize",
-			replaceDash: !0
+			replaceDash: !0,
+			acronyms: r
 		}),
-		...ft(n),
+		...pt(n),
 		items: t
 	};
 }
-function vt(e, t, n = !0) {
-	return Object.entries(t).flatMap(([t, r]) => {
-		if (t === "$") return Array.isArray(r) ? r.map((t) => {
-			let n = _(e.docpress.projectPath, t), r = F(p(n), {
+function yt(e, t, n = !0, r = []) {
+	return Object.entries(t).flatMap(([t, i]) => {
+		if (t === "$") return Array.isArray(i) ? i.map((t) => {
+			let n = v(e.docpress.projectPath, t), i = I(p(n), {
 				mode: "lowercase",
 				removeIdx: !0
 			});
-			return r === "readme.md" && (r = "introduction.md"), r !== p(n) && l(n, _(m(n), r)), {
-				text: g(r).name === "introduction" ? "Introduction" : F(r, {
+			return i === "readme.md" && (i = "introduction.md"), i !== p(n) && l(n, v(m(n), i)), {
+				text: g(i).name === "introduction" ? "Introduction" : I(i, {
 					mode: "capitalize",
 					replaceDash: !0,
-					removeExt: !0
+					removeExt: !0,
+					acronyms: r
 				}),
-				link: `/${e.docpress.routePrefix ?? ""}${F(e.name, { removeDot: !0 })}/${g(r).name}`
+				link: `/${e.docpress.routePrefix ?? ""}${I(e.name, { removeDot: !0 })}/${g(i).name}`
 			};
 		}) : [];
-		if (typeof r == "object") {
-			let i = F(t, { removeIdx: !0 }), a = _(e.docpress.projectPath, t), o = _(e.docpress.projectPath, i);
-			return i !== t && l(a, o), [{
-				text: F(i, {
+		if (typeof i == "object") {
+			let a = I(t, { removeIdx: !0 }), o = v(e.docpress.projectPath, t), s = v(e.docpress.projectPath, a);
+			return a !== t && l(o, s), [{
+				text: I(a, {
 					mode: "capitalize",
-					replaceDash: !0
+					replaceDash: !0,
+					acronyms: r
 				}),
-				...ft(n),
-				items: vt({
+				...pt(n),
+				items: yt({
 					...e,
-					name: `${e.name}/${i}`,
+					name: `${e.name}/${a}`,
 					docpress: {
 						...e.docpress,
-						projectPath: o
+						projectPath: s
 					}
-				}, r, n)
+				}, i, n, r)
 			}];
 		}
 		return [];
 	});
 }
-function yt(e) {
+function bt(e) {
 	return e.reduce((e, t) => {
 		let [n, ...r] = t.split("/");
-		return r.length ? e[n] = yt([...e[n] ? $(e[n], "") : [], r.join("/")]) : e.$ = [...e.$ || [], n], e;
+		return r.length ? e[n] = bt([...e[n] ? xt(e[n], "") : [], r.join("/")]) : e.$ = [...e.$ || [], n], e;
 	}, {});
 }
-function $(e, t = "") {
-	return Object.entries(e).flatMap(([e, n]) => e === "$" ? Array.isArray(n) ? n.map((e) => t ? `${t}/${e}` : e) : [] : $(n, t ? `${t}/${e}` : e));
+function xt(e, t = "") {
+	return Object.entries(e).flatMap(([e, n]) => e === "$" ? Array.isArray(n) ? n.map((e) => t ? `${t}/${e}` : e) : [] : xt(n, t ? `${t}/${e}` : e));
 }
-function bt(e) {
+function St(e) {
 	if (!Array.isArray(e)) return e;
 	let t = e.findIndex((e) => e.text === "Sources");
 	if (t === -1) return e;
 	let [n] = e.splice(t, 1);
 	return e.push(n), e;
 }
-var xt = 5;
-function St(e, t, n = []) {
+var Ct = 5;
+function wt(e, t, n = []) {
 	return e.flatMap((e) => {
 		if (!("items" in e) || !e.items?.length) return [];
 		let r = [...n, e.text];
-		return t >= xt ? [r.join("/")] : St(e.items, t + 1, r);
+		return t >= Ct ? [r.join("/")] : wt(e.items, t + 1, r);
 	});
 }
-function Ct(e, t) {
+function Tt(e, t) {
 	if (!e) return t;
 	if (Array.isArray(e) && Array.isArray(t)) return [...e, ...t].toSorted((e, t) => (e.text ?? "").localeCompare(t.text ?? ""));
 	let n = (e) => Array.isArray(e) ? { "/": e } : e;
-	return wt({
+	return $({
 		...n(e),
 		...n(t)
 	});
 }
-function wt(e) {
+function $(e) {
 	return Object.fromEntries(Object.entries(e).toSorted(([e], [t]) => e.localeCompare(t)));
 }
-function Tt(e, t, n, r = {}) {
-	let { mode: i = "single", collapsed: a = !0 } = r, o = [], s = [], l = {};
+function Et(e, t, n, r = {}) {
+	let { mode: i = "single", collapsed: a = !0, acronyms: o = [] } = r, s = [], l = [], u = {};
 	for (let t of e) {
-		k(`   Replace urls for repository '${t.name}'.`, "info"), R([t.docpress.projectPath]).forEach((e) => {
-			k(`   Processing file '${p(e)}' for repository '${t.name}'.`, "debug"), we(e, t.docpress.replace_url), p(e).toLowerCase() === "readme.md" && Oe(e, t.docpress.replace_url), De(e);
-		}), k(`   Generate sidebar for repository '${t.name}'.`, "info");
+		j(`   Replace urls for repository '${t.name}'.`, "info"), z([t.docpress.projectPath]).forEach((e) => {
+			j(`   Processing file '${p(e)}' for repository '${t.name}'.`, "debug"), we(e, t.docpress.replace_url), p(e).toLowerCase() === "readme.md" && Oe(e, t.docpress.replace_url), De(e);
+		}), j(`   Generate sidebar for repository '${t.name}'.`, "info");
 		let e = c(t.docpress.projectPath, { recursive: !0 }).filter((e) => {
-			let n = _(t.docpress.projectPath, e.toString());
+			let n = v(t.docpress.projectPath, e.toString());
 			return p(n).endsWith(".md") && ye(n);
 		}).sort();
-		k(`   Add sources for repository '${t.name}'.`, "info");
+		j(`   Add sources for repository '${t.name}'.`, "info");
 		let n;
-		e.length > 1 ? (n = _(t.docpress.projectPath, "sources.md"), e.push("sources.md")) : e.length === 1 && (n = _(t.docpress.projectPath, e[0])), n ? mt(t.html_url, n) : k(`   No markdown files found for repository '${t.name}', skipping sources.`, "warn");
-		let r = bt(vt(t, yt(e), a)), u = St(r, i === "multi" ? 0 : 1);
-		u.length && k(`   Sidebar for repository '${t.name}' nests deeper than Vitepress renders, pages under ${u.map((e) => `'${e}'`).join(", ")} will not appear in the sidebar.`, "warn"), i === "multi" ? l[`/${t.docpress.routePrefix ?? ""}${F(t.name, { removeDot: !0 })}/`] = r : s.push(_t(F(t.name, { removeDot: !0 }), r, a)), o.push(...gt(F(t.name, { removeDot: !0 }), t.description || "", void 0, t.docpress.routePrefix ?? ""));
+		e.length > 1 ? (n = v(t.docpress.projectPath, "sources.md"), e.push("sources.md")) : e.length === 1 && (n = v(t.docpress.projectPath, e[0])), n ? ht(t.html_url, n) : j(`   No markdown files found for repository '${t.name}', skipping sources.`, "warn");
+		let r = St(yt(t, bt(e), a, o)), d = wt(r, i === "multi" ? 0 : 1);
+		d.length && j(`   Sidebar for repository '${t.name}' nests deeper than Vitepress renders, pages under ${d.map((e) => `'${e}'`).join(", ")} will not appear in the sidebar.`, "warn"), i === "multi" ? u[`/${t.docpress.routePrefix ?? ""}${I(t.name, { removeDot: !0 })}/`] = r : l.push(vt(I(t.name, { removeDot: !0 }), r, a, o)), s.push(..._t(I(t.name, { removeDot: !0 }), t.description || "", void 0, t.docpress.routePrefix ?? "", o));
 	}
-	k("   Generate index content.", "info");
-	let u = ht(o.toSorted((e, t) => e.title.localeCompare(t.title)), t, n);
+	j("   Generate index content.", "info");
+	let d = gt(s.toSorted((e, t) => e.title.localeCompare(t.title)), t, n);
 	return {
-		sidebar: i === "multi" ? wt(l) : s.toSorted((e, t) => e.text.localeCompare(t.text)),
-		index: u
+		sidebar: i === "multi" ? $(u) : l.toSorted((e, t) => e.text.localeCompare(t.text)),
+		index: d
 	};
 }
-function Et(e) {
-	let t = R(e), n = [];
-	k("   Add extras Vitepress headers pages.", "info");
+function Dt(e) {
+	let t = z(e), n = [];
+	j("   Add extras Vitepress headers pages.", "info");
 	for (let e of t) {
-		k(`   Processing file '${e}'.`, "debug");
-		let t = _(process.cwd(), e), r = _(ae, F(p(e), {
+		j(`   Processing file '${e}'.`, "debug");
+		let t = v(process.cwd(), e), r = v(re, I(p(e), {
 			mode: "lowercase",
 			removeIdx: !0
 		}));
 		i(t, r), n.push({
-			text: F(g(t).name, {
+			text: I(g(t).name, {
 				replaceDash: !0,
 				removeIdx: !0
 			}),
-			link: `/${F(g(t).name, {
+			link: `/${I(g(t).name, {
 				removeIdx: !0,
 				mode: "lowercase"
 			})}`
@@ -1001,18 +1023,18 @@ function Et(e) {
 	}
 	return n;
 }
-function Dt(e, t, n) {
+function Ot(e, t, n) {
 	for (let r of Array.isArray(e) ? e : [e]) {
-		let e = _(process.cwd(), r), a = L(e);
+		let e = v(process.cwd(), r), a = R(e);
 		for (let o of a) {
 			let a = o.replace(e, ".");
-			k(`   Processing file '${a}' for entry '${r}'.`, "debug");
-			let s = _(process.cwd(), o), c = _(t, a);
+			j(`   Processing file '${a}' for entry '${r}'.`, "debug");
+			let s = v(process.cwd(), o), c = v(t, a);
 			n && n(), i(s, c);
 		}
 	}
 }
-function Ot(e) {
+function kt(e) {
 	let t = e.map(({ repository: e, contributions: t }) => {
 		let { name: n, owner: r, html_url: i, description: a, stargazers_count: o } = e;
 		return {
@@ -1024,11 +1046,11 @@ function Ot(e) {
 			contributions: t
 		};
 	});
-	k("   Generate forks page.", "info"), f(oe, "---\nlayout: fork-page\nrepoList:\n" + v.stringify(t) + "---\n\n# External contributions\n\nThis gallery is a visual representation of the collaborative work done across a variety of open-source projects, each driven by a shared passion for innovation and community growth.\n\nEvery tile below represents a unique project where contributions have been made-ranging from code enhancements to documentation improvements. Each project includes a summary of its goals, features, and links to GitHub for direct access.\n\nThis page serves as both a portfolio of past work and a resource for revisiting projects that have made a meaningful impact.\n");
+	j("   Generate forks page.", "info"), f(ie, "---\nlayout: fork-page\nrepoList:\n" + y.stringify(t) + "---\n\n# External contributions\n\nThis gallery is a visual representation of the collaborative work done across a variety of open-source projects, each driven by a shared passion for innovation and community growth.\n\nEvery tile below represents a unique project where contributions have been made-ranging from code enhancements to documentation improvements. Each project includes a summary of its goals, features, and links to GitHub for direct access.\n\nThis page serves as both a portfolio of past work and a resource for revisiting projects that have made a meaningful impact.\n");
 }
-async function kt(e, t, n) {
-	Ot(await Promise.all(e.map(async (e) => {
-		let { source: r, contributors: i } = await ze({
+async function At(e, t, n) {
+	kt(await Promise.all(e.map(async (e) => {
+		let { source: r, contributors: i } = await Be({
 			repository: e,
 			token: n
 		});
@@ -1038,31 +1060,32 @@ async function kt(e, t, n) {
 		};
 	})).then((e) => e.filter(({ repository: e, contributions: t }) => !!e && t)));
 }
-async function At(e) {
+async function jt(e) {
 	try {
-		let { config: t } = await import(_(process.cwd(), e));
+		let { config: t } = await import(v(process.cwd(), e));
 		return t ?? {};
 	} catch (t) {
-		return k(`   Unable to load existing Vitepress config '${e}', starting from an empty config. ${N(t)}`, "warn"), {};
+		return j(`   Unable to load existing Vitepress config '${e}', starting from an empty config. ${P(t)}`, "warn"), {};
 	}
 }
-async function jt(e) {
-	let t = (await re(_(process.cwd(), e))).toString();
-	return v.parse(t);
-}
-var Mt = "\nfunction escapeInlineCode(md) {\n  const render = md.renderer.rules.code_inline\n  md.renderer.rules.code_inline = (tokens, idx, options, env, self) => {\n    tokens[idx].attrSet('v-pre', '')\n    return render(tokens, idx, options, env, self)\n  }\n}\n\nexport default { ...config, markdown: { ...config.markdown, config: escapeInlineCode } }\n";
-function Nt(e, t) {
-	I(m(T)), k("   Generate Vitepress config.", "info"), f(T, `export const config = ${JSON.stringify(e, null, 2)}\n${Mt}`), k("   Generate index file.", "info"), f(w, "---\n" + v.stringify(t));
-	let n = L(E);
-	if (!n.length) throw Error(`No template theme files found at '${E}'. The Vitepress build cannot succeed without them.`);
-	k("   Add Docpress theme files.", "info"), n.forEach((e) => {
-		let t = e.replace(`${E}/`, "");
-		lt(e, _(se, t));
+async function Mt(e) {
+	let t = (await te(v(process.cwd(), e))).toString();
+	return y.parse(t);
+}
+var Nt = "\nfunction escapeInlineCode(md) {\n  const render = md.renderer.rules.code_inline\n  md.renderer.rules.code_inline = (tokens, idx, options, env, self) => {\n    tokens[idx].attrSet('v-pre', '')\n    return render(tokens, idx, options, env, self)\n  }\n}\n\nexport default { ...config, markdown: { ...config.markdown, config: escapeInlineCode } }\n";
+function Pt(e, t) {
+	L(m(D)), j("   Generate Vitepress config.", "info"), f(D, `export const config = ${JSON.stringify(e, null, 2)}\n${Nt}`), j("   Generate index file.", "info"), f(E, "---\n" + y.stringify(t));
+	let n = R(O);
+	if (!n.length) throw Error(`No template theme files found at '${O}'. The Vitepress build cannot succeed without them.`);
+	j("   Add Docpress theme files.", "info"), n.forEach((e) => {
+		let t = e.replace(`${O}/`, "");
+		ut(e, v(ae, t));
 	});
 }
 //#endregion
 //#region src/commands/prepare.ts
-var Pt = "prepare", Ft = [
+var Ft = "prepare", It = [
+	n("--acronyms <string>", K.shape.acronyms.description),
 	n("-c, --extra-public-content <string>", K.shape.extraPublicContent.description),
 	n("-f, --forks", K.shape.forks.description),
 	n("-p, --extra-header-pages <string>", K.shape.extraHeaderPages.description),
@@ -1072,17 +1095,17 @@ var Pt = "prepare", Ft = [
 	n("-v, --vitepress-config <string>", K.shape.vitepressConfig.description),
 	n("--website-title <string>", K.shape.websiteTitle.description),
 	n("--website-tagline <string>", K.shape.websiteTagline.description)
-], It = X(t(Pt), [...Ft, ...Q]).description("Transform doc to the target vitepress format.").action(async (e, t) => {
-	await Lt(J(Pt, Y(t, e)));
+], Lt = X(t(Ft), [...It, ...Q]).description("Transform doc to the target vitepress format.").action(async (e, t) => {
+	await Rt(J(Ft, Y(t, e)));
 });
-async function Lt(e) {
-	let { extraHeaderPages: t, extraPublicContent: n, extraTheme: r, vitepressConfig: i, forks: a, gitProvider: o, lastUpdated: s, sidebarMode: c, sidebarCollapsed: l, token: u, usernames: d, websiteTitle: f, websiteTagline: p } = e;
-	k("\n-> Start transform files to prepare Vitepress build.", "info");
-	let h = Date.now();
-	I(m(T), { clean: !0 });
-	let g = [];
-	for (let e of d) try {
-		await pt({
+async function Rt(e) {
+	let { extraHeaderPages: t, extraPublicContent: n, extraTheme: r, vitepressConfig: i, forks: a, gitProvider: o, lastUpdated: s, sidebarMode: c, sidebarCollapsed: l, acronyms: u, token: d, usernames: f, websiteTitle: p, websiteTagline: h } = e;
+	j("\n-> Start transform files to prepare Vitepress build.", "info");
+	let g = Date.now();
+	L(m(D), { clean: !0 });
+	let _ = [];
+	for (let e of f) try {
+		await mt({
 			extraHeaderPages: t,
 			extraPublicContent: n,
 			extraTheme: r,
@@ -1092,40 +1115,41 @@ async function Lt(e) {
 			lastUpdated: s,
 			sidebarMode: c,
 			sidebarCollapsed: l,
-			token: u,
+			acronyms: u,
+			token: d,
 			username: e,
-			websiteTitle: f,
-			websiteTagline: p
+			websiteTitle: p,
+			websiteTagline: h
 		});
 	} catch (t) {
-		g.push(e), k(`   Failed to prepare documentation for '${e}': ${N(t)}`, "error");
+		_.push(e), j(`   Failed to prepare documentation for '${e}': ${P(t)}`, "error");
 	}
-	if (g.length === d.length) throw Error(`Failed to prepare documentation for all requested username(s): ${g.join(", ")}.`);
-	k(`   Prepared documentation for ${d.length - g.length}/${d.length} username(s) in ${P(Date.now() - h)}.`, g.length ? "warn" : "success");
+	if (_.length === f.length) throw Error(`Failed to prepare documentation for all requested username(s): ${_.join(", ")}.`);
+	j(`   Prepared documentation for ${f.length - _.length}/${f.length} username(s) in ${F(Date.now() - g)}.`, _.length ? "warn" : "success");
 }
 //#endregion
 //#region src/cli.ts
-function Rt() {
-	let t = new e().name("docpress").description("Build your doc website faster than light ⚡️⚡️⚡️").version(`${ie.version}`).action(async (e, t) => {
+function zt() {
+	let t = new e().name("docpress").description("Build your doc website faster than light ⚡️⚡️⚡️").version(`${ne.version}`).action(async (e, t) => {
 		let n = J("global", Y(t, e));
-		await at(n), await Lt(n), await ct();
+		await ot(n), await Rt(n), await lt();
 	}).configureHelp({
 		sortSubcommands: !0,
 		sortOptions: !0,
 		showGlobalOptions: !0
-	}).enablePositionalOptions().passThroughOptions().addCommand(it).addCommand(It).addCommand(st);
+	}).enablePositionalOptions().passThroughOptions().addCommand(at).addCommand(Lt).addCommand(ct);
 	return X(t, [
-		...rt,
-		...Ft,
+		...it,
+		...It,
 		...Q
 	]), t;
 }
-function zt() {
-	Rt().parseAsync(process.argv).catch((e) => {
-		k(`\n${N(e)}`, "error"), process.exit(1);
+function Bt() {
+	zt().parseAsync(process.argv).catch((e) => {
+		j(`\n${P(e)}`, "error"), process.exit(1);
 	});
 }
 //#endregion
-export { Rt as getProgram, zt as main };
+export { zt as getProgram, Bt as main };
 
 //# sourceMappingURL=cli.js.map