@tobi-or-not/docpress 0.10.2 → 0.10.3

package/dist/cli.js

@@ -1,11 +1,10 @@
 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 _, resolve as v } from "node:path";
-import { rimrafSync as y } from "rimraf";
-import b from "yaml";
-import x from "chalk";
-import { z as S } from "zod";
-import { Octokit as C } from "@octokit/rest";
+import y from "yaml";
+import b from "picocolors";
+import { z as x } from "zod";
+import { Octokit as S } from "@octokit/rest";
 import { simpleGit as ee } from "simple-git";
 import { build as te } from "vitepress";
 import { withMermaid as ne } from "vitepress-plugin-mermaid";
@@ -13,7 +12,7 @@ import { readFile as re } from "node:fs/promises";
 var ie = {
 	name: "@tobi-or-not/docpress",
 	type: "module",
-	version: "0.10.2",
+	version: "0.10.3",
 	packageManager: "bun@1.3.14",
 	homepage: "https://this-is-tobi.com/docpress/introduction",
 	repository: {
@@ -22,15 +21,18 @@ var ie = {
 	},
 	bin: { docpress: "bin/docpress.js" },
 	files: ["bin", "dist"],
-	engines: { node: ">=22.12.0" },
+	engines: {
+		node: ">=22.12.0",
+		bun: ">=1.3.0"
+	},
 	scripts: {
 		build: "bun run build:clean && bun run build:types && bun run build:vite",
-		"build:clean": "rimraf ./dist ./types ./tsconfig.tsbuildinfo",
+		"build:clean": "node -e \"for (const p of ['./dist','./types','./tsconfig.tsbuildinfo']) require('node:fs').rmSync(p,{recursive:true,force:true})\"",
 		"build:docker": "docker build --tag tobi-or-not/docpress --target prod .",
 		"build:types": "tsc",
 		"build:vite": "vite build",
 		dev: "bun ./dev/docpress.ts",
-		"dev:clean": "rimraf ./docpress && bun run dev",
+		"dev:clean": "node -e \"require('node:fs').rmSync('./docpress',{recursive:true,force:true})\" && bun run dev",
 		format: "eslint . --fix",
 		lint: "eslint .",
 		prepare: "husky || true",
@@ -47,9 +49,8 @@ var ie = {
 	},
 	dependencies: {
 		"@octokit/rest": "^22.0.1",
-		chalk: "^5.6.2",
 		commander: "^15.0.0",
-		rimraf: "^6.1.3",
+		picocolors: "^1.1.1",
 		"simple-git": "^3.36.0",
 		vitepress: "^1.6.4",
 		"vitepress-plugin-mermaid": "^2.0.17",
@@ -58,33 +59,37 @@ var ie = {
 	},
 	devDependencies: {
 		"@antfu/eslint-config": "^9.1.0",
-		"@commitlint/cli": "^21.2.0",
+		"@commitlint/cli": "^21.2.1",
 		"@commitlint/config-conventional": "^21.2.0",
 		"@octokit/types": "^16.0.0",
-		"@types/node": "^26.1.0",
-		"@vitejs/plugin-vue": "^6.0.7",
-		"@vitest/coverage-v8": "^4.1.9",
-		eslint: "^10.6.0",
+		"@types/node": "^26.1.1",
+		"@vitejs/plugin-vue": "^6.0.8",
+		"@vitest/coverage-v8": "^4.1.10",
+		eslint: "^10.7.0",
 		husky: "^9.1.7",
-		"lint-staged": "^17.0.8",
+		"nano-staged": "^1.0.2",
 		typescript: "^6.0.3",
-		vite: "^8.1.3",
-		vitest: "^4.1.9",
-		vue: "^3.5.39"
+		vite: "^8.1.5",
+		vitest: "^4.1.10",
+		vue: "^3.5.40"
 	},
 	publishConfig: {
 		registry: "https://registry.npmjs.org/",
 		access: "public",
 		tag: "latest"
 	}
-}, w = v(process.cwd(), "docpress"), T = v(process.cwd(), "docpress/docs"), E = v(process.cwd(), "docpress/docs/index.md"), ae = v(process.cwd(), "docpress/docs/forks.md"), D = v(process.cwd(), "docpress/.vitepress/config.ts"), oe = v(process.cwd(), "docpress/.vitepress/theme"), se = 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");
-//#endregion
-//#region src/utils/logger.ts
-function ce() {
+}, C = v(process.cwd(), "docpress"), ae = v(process.cwd(), "docpress/docs"), w = v(process.cwd(), "docpress/docs/index.md"), oe = v(process.cwd(), "docpress/docs/forks.md"), T = v(process.cwd(), "docpress/.vitepress/config.ts"), se = v(process.cwd(), "docpress/.vitepress/theme"), ce = v(process.cwd(), "docpress/.vitepress/theme/extras"), le = process.env.NODE_ENV === "development" ? v(import.meta.dirname, "../../public/templates/theme") : v(import.meta.dirname, "./templates/theme"), E = {
+	red: b.red,
+	yellow: b.yellow,
+	white: b.white,
+	green: b.green,
+	blue: b.blue
+};
+function ue() {
 	let e = Number(process.env.LOG_LEVEL);
 	return Number.isNaN(e) ? 30 : e;
 }
-var k = {
+var D = {
 	error: {
 		color: "red",
 		level: 10
@@ -110,53 +115,57 @@ var k = {
 		level: 50
 	}
 };
-function A(e, t = "info", n) {
-	let r = n ? x[n](e) : x[k[t].color](e), i = t === "success" ? "info" : t;
-	ce() >= k[t].level && console[i](r);
+function O(e, t = "info", n) {
+	let r = n ? E[n](e) : E[D[t].color](e), i = t === "success" ? "info" : t;
+	ue() >= D[t].level && console[i](r);
 }
 //#endregion
 //#region src/utils/regex.ts
-var le = /\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, ue = /\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.\/)?([^/][^)]+)\)/g, de = /\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, fe = /^\d{2}-/, pe = /^---\r?\n([\s\S]*?)\r?\n---\r?\n/, me = /\[([^\]]+)\]\((?!https?:|\/|#|mailto:)([^)#]*\/)?([^)#/]+\.md)(#[^)]*)?\)/g;
+var de = /\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, fe = /\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.\/)?([^/][^)]+)\)/g, pe = /\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, me = /^\d{2}-/, k = /^---\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 A(e) {
 	try {
 		return (await fetch(e, {
 			method: "HEAD",
 			redirect: "manual"
 		})).status;
 	} catch (t) {
-		return A(`   Network error while checking '${e}': ${t instanceof Error ? t.message : String(t)}`, "debug"), 500;
+		return O(`   Network error while checking '${e}': ${t instanceof Error ? t.message : String(t)}`, "debug"), 500;
 	}
 }
-function M(e) {
-	return (e.split(/[/\\]/).pop() ?? "").replace(/[^\w.-]/g, "_").replace(/^\.+/, "");
+function j(e) {
+	return (e.split(/[/\\]/).pop() ?? "").replace(/[^\w.-]/g, "_").replace(/^\.+/, "") || "_";
 }
-function N(e) {
+function M(e) {
 	return !z(e) || !("token" in e) ? e : {
 		...e,
 		token: e.token ? "***" : e.token
 	};
 }
-function P(e, t) {
+function N(e, t) {
 	let n = "";
-	return t?.removeDot && (n = e.startsWith(".") ? e.slice(1) : e, n = n.replaceAll(".", "-")), t?.removeIdx && (n = (n || e).replace(fe, "")), 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(me, "")), 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;
 }
-function F(e, { clean: t } = { clean: !1 }) {
+function P(e, { clean: t } = { clean: !1 }) {
 	try {
-		t && a(e) && y(`${e}/*`, { glob: !0 }), a(e) || o(e, { recursive: !0 });
+		if (t && a(e)) for (let t of c(e)) u(v(e, t), {
+			recursive: !0,
+			force: !0
+		});
+		a(e) || o(e, { recursive: !0 });
 	} catch (t) {
 		throw Error(`Unable to create directory '${e}': ${t instanceof Error ? t.message : String(t)}`);
 	}
 }
-function he(e) {
+function ge(e) {
 	try {
 		return d(e).isDirectory();
 	} catch {
 		return !1;
 	}
 }
-function ge(e) {
+function F(e) {
 	try {
 		return d(e).isFile();
 	} catch {
@@ -164,7 +173,7 @@ function ge(e) {
 	}
 }
 function I(e) {
-	return (Array.isArray(e) ? e : [e]).flatMap((e) => ge(e) ? [e] : he(e) ? c(e).filter((e) => e !== ".git").sort().flatMap((t) => I(h(e, t))) : []);
+	return (Array.isArray(e) ? e : [e]).flatMap((e) => F(e) ? [e] : ge(e) ? c(e).filter((e) => e !== ".git").sort().flatMap((t) => I(h(e, t))) : []);
 }
 function L(e) {
 	return I(e).filter((e) => p(e).endsWith(".md"));
@@ -173,10 +182,10 @@ function _e(e) {
 	return e.reduce((e, t, n, r) => n ? n === r.length - 1 ? `${e} or "${t}"` : `${e}, "${t}"` : `"${t}"`, "");
 }
 function ve(e) {
-	return JSON.parse(s(`${w}/user-${M(e)}.json`).toString());
+	return JSON.parse(s(`${C}/user-${j(e)}.json`).toString());
 }
 function ye(e) {
-	return JSON.parse(s(`${w}/repos-${M(e)}.json`).toString());
+	return JSON.parse(s(`${C}/repos-${j(e)}.json`).toString());
 }
 var be = /* @__PURE__ */ new Set([
 	"__proto__",
@@ -211,18 +220,18 @@ function V(e) {
 	return e.split(",");
 }
 function xe(e, t) {
-	f(e, s(e, "utf8").replace(le, (e, n, r) => `[${n}](${t}/${r})`), "utf8");
+	f(e, s(e, "utf8").replace(de, (e, n, r) => `[${n}](${t}/${r})`), "utf8");
 }
 function Se(e, t) {
-	let n = s(e, "utf8"), r = n.match(pe);
+	let n = s(e, "utf8"), r = n.match(k);
 	if (r) {
-		let i = b.parse(r[1]) ?? {};
-		i.lastUpdated = t, f(e, n.replace(pe, `---\n${b.stringify(i)}---\n`), "utf8");
+		let i = y.parse(r[1]) ?? {};
+		i.lastUpdated = t, f(e, n.replace(k, `---\n${y.stringify(i)}---\n`), "utf8");
 	} else f(e, `---\nlastUpdated: ${t}\n---\n\n${n}`, "utf8");
 }
 function Ce(e) {
-	f(e, s(e, "utf8").replace(me, (e, t, n, r, i) => {
-		let a = P(r, {
+	f(e, s(e, "utf8").replace(he, (e, t, n, r, i) => {
+		let a = N(r, {
 			mode: "lowercase",
 			removeIdx: !0
 		});
@@ -230,36 +239,36 @@ function Ce(e) {
 	}), "utf8");
 }
 function we(e, t) {
-	f(e, s(e, "utf8").replace(ue, (e, n, r, i) => `[${n}](${t}/${i})`).replace(de, (e, t, n, r) => `[${t}](${r})`), "utf8");
+	f(e, s(e, "utf8").replace(fe, (e, n, r, i) => `[${n}](${t}/${i})`).replace(pe, (e, t, n, r) => `[${t}](${r})`), "utf8");
 }
 //#endregion
 //#region src/schemas/global.ts
-var H = ["github", "gitlab"], U = /^\w[\w./-]*$/, W = "Branch name must start with a letter, digit or underscore and only contain letters, digits, \".\", \"-\", \"_\" or \"/\".", G = S.object({
-	usernames: S.string().array().describe("List of comma separated Git provider usernames used to collect data."),
-	branch: S.string().regex(U, W).default("main").describe("Branch used to collect Git provider data."),
-	gitProvider: S.enum(H).default("github").describe(`Git provider used to retrieve data. Values should be ${_e(H)}.`),
-	reposFilter: S.string().array().describe("List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories."),
-	extraHeaderPages: S.string().array().describe("List of comma separated additional files or directories to process Vitepress header pages."),
-	extraPublicContent: S.string().array().describe("List of comma separated additional files or directories to process Vitepress public folder."),
-	extraTheme: S.string().array().describe("List of comma separated additional files or directories to use as Vitepress theme."),
-	forks: S.boolean().default(!1).describe("Whether or not to create the dedicated fork page that aggregate external contributions."),
-	lastUpdated: S.boolean().default(!1).describe("Whether or not to inject each page's last Git commit date as Vitepress \"lastUpdated\" frontmatter."),
-	vitepressConfig: S.any().optional().describe("Path to the vitepress configuration file."),
-	websiteTitle: S.string().describe("Website title."),
-	websiteTagline: S.string().describe("Website tagline.")
+var H = ["github", "gitlab"], U = /^\w[\w./-]*$/, W = "Branch name must start with a letter, digit or underscore and only contain letters, digits, \".\", \"-\", \"_\" or \"/\".", G = x.object({
+	usernames: x.string().array().describe("List of comma separated Git provider usernames used to collect data."),
+	branch: x.string().regex(U, W).optional().describe("Branch used to collect Git provider data. Defaults to each repository's own default branch when not set."),
+	gitProvider: x.enum(H).default("github").describe(`Git provider used to retrieve data. Values should be ${_e(H)}.`),
+	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."),
+	vitepressConfig: x.any().optional().describe("Path to the vitepress configuration file."),
+	websiteTitle: x.string().describe("Website title."),
+	websiteTagline: x.string().describe("Website tagline.")
 }), K = G.partial().extend({
-	branch: S.string().regex(U, W).optional().describe(G.shape.branch.description || ""),
-	gitProvider: S.enum(H).optional().describe(G.shape.gitProvider.description || ""),
-	forks: S.boolean().optional().describe(G.shape.forks.description || ""),
-	lastUpdated: S.boolean().optional().describe(G.shape.lastUpdated.description || ""),
-	config: S.string().optional().describe("Path to the docpress configuration file."),
-	token: S.string().optional().describe("Git provider token used to collect data."),
-	usernames: S.string().transform(V).optional().describe(G.shape.usernames.description || ""),
-	reposFilter: S.string().transform(V).optional().describe(G.shape.reposFilter.description || ""),
-	extraHeaderPages: S.string().transform(V).optional().describe(G.shape.extraHeaderPages.description || ""),
-	extraPublicContent: S.string().transform(V).optional().describe(G.shape.extraPublicContent.description || ""),
-	extraTheme: S.string().transform(V).optional().describe(G.shape.extraTheme.description || ""),
-	vitepressConfig: S.string().optional().describe(G.shape.vitepressConfig.description || "")
+	branch: x.string().regex(U, W).optional().describe(G.shape.branch.description || ""),
+	gitProvider: x.enum(H).optional().describe(G.shape.gitProvider.description || ""),
+	forks: x.boolean().optional().describe(G.shape.forks.description || ""),
+	lastUpdated: x.boolean().optional().describe(G.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(V).optional().describe(G.shape.usernames.description || ""),
+	reposFilter: x.string().transform(V).optional().describe(G.shape.reposFilter.description || ""),
+	extraHeaderPages: x.string().transform(V).optional().describe(G.shape.extraHeaderPages.description || ""),
+	extraPublicContent: x.string().transform(V).optional().describe(G.shape.extraPublicContent.description || ""),
+	extraTheme: x.string().transform(V).optional().describe(G.shape.extraTheme.description || ""),
+	vitepressConfig: x.string().optional().describe(G.shape.vitepressConfig.description || "")
 });
 function Te(e) {
 	if (!e) return {};
@@ -275,7 +284,7 @@ function Te(e) {
 }
 function Ee(e) {
 	let t = G.partial().safeParse(e);
-	if (!t.success) throw Error(S.prettifyError(t.error));
+	if (!t.success) throw Error(x.prettifyError(t.error));
 	return t.data;
 }
 function De(e) {
@@ -287,12 +296,11 @@ function Oe(e, t) {
 	let n = t === "gitlab" ? process.env.GITLAB_TOKEN : process.env.GITHUB_TOKEN;
 	return process.env.DOCPRESS_TOKEN ?? n;
 }
-var ke = K.partial().transform((e) => {
+var ke = K.partial().transform((e, t) => {
 	try {
 		let { config: t, vitepressConfig: n, token: r, ...i } = e;
-		A(`Debug: Schema transform input: ${JSON.stringify(N(e))}`, "debug");
+		O(`Debug: Schema transform input: ${JSON.stringify(M(e))}`, "debug");
 		let a = Ee(Te(B(t))), o = {
-			branch: "main",
 			gitProvider: "github",
 			forks: !1,
 			lastUpdated: !1,
@@ -303,20 +311,23 @@ var ke = K.partial().transform((e) => {
 				...B(n) || {}
 			} } : {}
 		};
-		return A(`Debug: Final merged config: ${JSON.stringify(o)}`, "debug"), De({
+		return O(`Debug: Final merged config: ${JSON.stringify(o)}`, "debug"), De({
 			...o,
 			token: Oe(r, o.gitProvider)
 		});
 	} catch (e) {
-		A("   An error occurred while checking configuration.", "error"), e instanceof Error ? A(`     ${e.message}`, "error") : A(`     ${JSON.stringify(e, null, 2)}`, "error"), process.exit(1);
+		return t.addIssue({
+			code: "custom",
+			message: e instanceof Error ? e.message : JSON.stringify(e, null, 2)
+		}), x.NEVER;
 	}
 });
 //#endregion
 //#region src/utils/commands.ts
 function q(e, t) {
-	A("Initializing Docpress...", "info", "blue"), A("\n\n-> Checking for required environment settings and configurations.", "info"), A(`   Debug info - opts: ${JSON.stringify(N(t))}`, "debug"), A(`   Debug info - cmd: ${e}`, "debug");
+	O("Initializing Docpress...", "info", "blue"), O("\n\n-> Checking for required environment settings and configurations.", "info"), O(`   Debug info - opts: ${JSON.stringify(M(t))}`, "debug"), O(`   Debug info - cmd: ${e}`, "debug");
 	let n = ke.safeParse(t);
-	return n.success || (A(`   An error occurred while checking configuration.\n     ${S.prettifyError(n.error)}`, "error"), process.exit(1)), A("   Setup complete! Ready to process your documentation.", "info"), n.data;
+	return n.success || (O(`   An error occurred while checking configuration.\n     ${x.prettifyError(n.error)}`, "error"), process.exit(1)), O("   Setup complete! Ready to process your documentation.", "info"), n.data;
 }
 function J(e, t) {
 	return Object.fromEntries(Object.entries(t).filter(([t]) => e.getOptionValueSource(t) !== "default"));
@@ -338,16 +349,16 @@ var X = {
 	}
 };
 async function Ae({ username: e, token: t, branch: n }) {
-	A(`   Get infos for username '${e}'.`, "info");
-	let r = new C({
+	O(`   Get infos for username '${e}'.`, "info");
+	let r = new S({
 		auth: t,
 		log: X
 	});
-	A("   Get user infos.", "debug");
+	O("   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 A("   Get repositories infos.", "debug"), {
+	return O("   Get repositories infos.", "debug"), {
 		user: i,
 		repos: await r.paginate(r.rest.repos.listForUser, {
 			username: e,
@@ -358,14 +369,22 @@ async function Ae({ username: e, token: t, branch: n }) {
 	};
 }
 async function je({ repository: e, token: t }) {
-	A(`   Get contributors infos for repository '${e.name}'.`, "info");
-	let n = new C({
+	O(`   Get contributors infos for repository '${e.name}'.`, "info");
+	let n = new S({
 		auth: t,
 		log: X
-	}), { data: r } = await n.rest.repos.get({
-		owner: e.owner.login,
-		repo: e.name
-	});
+	}), r;
+	try {
+		r = (await n.rest.repos.get({
+			owner: e.owner.login,
+			repo: e.name
+		})).data;
+	} catch (t) {
+		return O(`   Failed to get repository infos for '${e.name}'. Error : ${t instanceof Error ? t.message : String(t)}`, "warn"), {
+			source: void 0,
+			contributors: []
+		};
+	}
 	if (!r.source?.owner?.login) return {
 		source: r.source,
 		contributors: []
@@ -378,7 +397,7 @@ async function je({ repository: e, token: t }) {
 			per_page: 100
 		})) i.push(...e);
 	} catch (t) {
-		return A(`   Failed to get contributors infos for repository '${e.name}'. Error : ${t instanceof Error ? t.message : String(t)}`, "warn"), {
+		return O(`   Failed to get contributors infos for repository '${e.name}'. Error : ${t instanceof Error ? t.message : String(t)}`, "warn"), {
 			source: r.source,
 			contributors: []
 		};
@@ -408,12 +427,14 @@ async function Ne(e, t, n) {
 	let i;
 	try {
 		i = Me(await e.raw([
+			"-c",
+			"core.quotePath=false",
 			"log",
 			"--format=%cI",
 			"--name-only"
 		]));
 	} catch (e) {
-		A(`   Unable to read commit history for repository '${n}'. Error : ${e instanceof Error ? e.message : String(e)}`, "warn");
+		O(`   Unable to read commit history for repository '${n}'. Error : ${e instanceof Error ? e.message : String(e)}`, "warn");
 		return;
 	}
 	for (let e of r) {
@@ -422,8 +443,8 @@ async function Ne(e, t, n) {
 	}
 }
 async function Pe(e, t, n, a, o, s) {
-	if (t.startsWith("-") || a.startsWith("-")) return A(`   Refusing to clone '${e}': unsafe repository URL or branch name.`, "error"), !1;
-	F(n, { clean: !0 });
+	if (t.startsWith("-") || a.startsWith("-")) return O(`   Refusing to clone '${e}': unsafe repository URL or branch name.`, "error"), !1;
+	P(n, { clean: !0 });
 	try {
 		let c = ee({
 			baseDir: n,
@@ -434,10 +455,10 @@ async function Pe(e, t, n, a, o, s) {
 			]
 		});
 		await c.init().addConfig("core.sparseCheckout", "true", !0, "local").addRemote("origin", t);
-		for (let t of o) A(`   Add '${t}' to '${e}' sparse-checkout file.`, "debug"), r(v(n, ".git/info/sparse-checkout"), `${t}\n`, "utf8");
-		return A(`   Clone repository '${e}'.`, "info"), await c.pull("origin", a), s && await Ne(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;
+		for (let t of o) O(`   Add '${t}' to '${e}' sparse-checkout file.`, "debug"), r(v(n, ".git/info/sparse-checkout"), `${t}\n`, "utf8");
+		return O(`   Clone repository '${e}'.`, "info"), await c.pull("origin", a), s && await Ne(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 A(`   Error when cloning repository '${e}': ${t instanceof Error ? t.message : String(t)}.`, "error"), !1;
+		return O(`   Error when cloning repository '${e}': ${t instanceof Error ? t.message : String(t)}.`, "error"), !1;
 	}
 }
 //#endregion
@@ -483,11 +504,11 @@ function Le(e, t) {
 	};
 }
 async function Re({ username: e, token: t, branch: n }) {
-	A(`   Get infos for username '${e}'.`, "info");
+	O(`   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])), A("   Get repositories infos.", "debug");
+		t && (i = await Z(`/users/${r[0].id}`, t).then((e) => e.data).catch(() => r[0])), O("   Get repositories infos.", "debug");
 		let a = await Q(`/users/${r[0].id}/projects`, t);
 		return {
 			user: Ie(i),
@@ -495,7 +516,7 @@ async function Re({ username: e, token: t, branch: n }) {
 			branch: n
 		};
 	}
-	A(`   No GitLab user '${e}' found, trying groups.`, "debug");
+	O(`   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 Q(`/groups/${encodeURIComponent(e)}/projects`, t);
@@ -525,9 +546,9 @@ function ze(e, t, n) {
 }
 async function Be(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`)
+		A(`${e.blob_url}/README.md`),
+		A(`${e.tree_url}/docs`),
+		A(`${e.blob_url}/docs/01-readme.md`)
 	]);
 	return {
 		rootReadmeStatus: t,
@@ -535,46 +556,47 @@ async function Be(e) {
 		docsReadmeStatus: r
 	};
 }
-async function Ve({ username: e, branch: t, reposFilter: n, gitProvider: r, token: i, lastUpdated: a }) {
-	let { user: o, repos: s, branch: c } = await (r === "gitlab" ? Re : Ae)({
+async function Ve({ username: e, branch: t, reposFilter: n, gitProvider: r, token: i, lastUpdated: a, multiUser: o }) {
+	let { user: s, repos: c, branch: l } = await (r === "gitlab" ? Re : Ae)({
 		username: e,
 		token: i,
 		branch: t
-	}), { repos: l } = await We(o, s, c, n, r);
-	await Ge(l, n, a);
+	}), { repos: u } = await We(s, c, l, n, r, o ? `${j(e)}/` : "");
+	await Ge(u, n, a);
 }
-async function He(e, t, n, r) {
-	let i = [];
+async function He(e, t, n, r, i = "") {
+	let a = [];
 	return await Promise.all(e.map(async (e) => {
-		let a = t ?? e.default_branch ?? "main", o = v(T, P(M(e.name), { removeDot: !0 })), s = Ke(e, n), c = ze(e, a, r), l = [];
-		!e.fork && !e.private && !s && (l = await Ue(e, a, r, c)), i.push({
+		let o = t ?? e.default_branch ?? "main", s = v(ae, `${i}${N(j(e.name), { removeDot: !0 })}`), c = Ke(e, n), l = ze(e, o, r), u = [];
+		!e.fork && !e.private && !c && (u = await Ue(e, o, r, l)), a.push({
 			...e,
 			docpress: {
-				filtered: s,
-				branch: a,
-				includes: l,
-				projectPath: o,
-				raw_url: c.raw_url,
-				replace_url: c.tree_url
+				filtered: c,
+				branch: o,
+				includes: u,
+				projectPath: s,
+				raw_url: l.raw_url,
+				replace_url: l.tree_url,
+				routePrefix: i
 			}
 		});
-	})), i;
+	})), a;
 }
 async function Ue(e, t, n, r) {
 	let i = await Be(r ?? ze(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 We(e, t, n, r, i) {
-	f(`${w}/user-${M(e.login)}.json`, JSON.stringify(e, null, 2));
-	let a = await He(t, n, r, i);
-	return f(`${w}/repos-${M(e.login)}.json`, JSON.stringify(a, null, 2)), {
+async function We(e, t, n, r, i, a = "") {
+	f(`${C}/user-${j(e.login)}.json`, JSON.stringify(e, null, 2));
+	let o = await He(t, n, r, i, a);
+	return f(`${C}/repos-${j(e.login)}.json`, JSON.stringify(o, null, 2)), {
 		user: e,
-		repos: a
+		repos: o
 	};
 }
 async function Ge(e, t, n) {
 	if (!e) {
-		A("   No repository respect docpress rules.", "warn");
+		O("   No repository respect docpress rules.", "warn");
 		return;
 	}
 	let r = (await Promise.all(e.filter((e) => !Ke(e, t)).map(async (e) => {
@@ -584,7 +606,7 @@ async function Ge(e, t, n) {
 			success: t
 		};
 	}))).filter(({ success: e }) => !e).map(({ name: e }) => e);
-	r.length && A(`   ${r.length} repository(ies) failed to clone: ${r.join(", ")}.`, "warn");
+	r.length && O(`   ${r.length} repository(ies) failed to clone: ${r.join(", ")}.`, "warn");
 }
 function Ke(e, t) {
 	if ("docpress" in e && !e.docpress.includes.length) return !0;
@@ -598,7 +620,7 @@ var $ = [
 	n("-T, --token <string>", K.shape.token.description),
 	n("-U, --usernames <string>", K.shape.usernames.description)
 ], qe = "fetch", Je = [
-	n("-b, --branch <string>", G.shape.branch.description).default(G.shape.branch.def.defaultValue),
+	n("-b, --branch <string>", G.shape.branch.description),
 	n("-g, --git-provider <string>", G.shape.gitProvider.description).default(G.shape.gitProvider.def.defaultValue),
 	n("-l, --last-updated", G.shape.lastUpdated.description),
 	n("-r, --repos-filter <string>", G.shape.reposFilter.description)
@@ -607,7 +629,7 @@ var $ = [
 });
 async function Xe(e) {
 	let { usernames: t, reposFilter: n, token: r, branch: i, gitProvider: a, lastUpdated: o } = e;
-	A("\n-> Start fetching documentation files. This may take a moment, especially for larger repositories.", "info"), F(w, { clean: !0 });
+	O("\n-> Start fetching documentation files. This may take a moment, especially for larger repositories.", "info"), P(C, { clean: !0 });
 	let s = [];
 	for (let e of t) {
 		let c = t.length > 1 ? n?.filter((t) => t.replace(/^!/, "").startsWith(`${e}/`)).map((t) => t.replace(`${e}/`, "")) : n;
@@ -618,10 +640,11 @@ async function Xe(e) {
 				reposFilter: c,
 				gitProvider: a,
 				token: r,
-				lastUpdated: o
+				lastUpdated: o,
+				multiUser: t.length > 1
 			});
 		} catch (t) {
-			s.push(e), A(`   Failed to fetch documentation for '${e}': ${t instanceof Error ? t.message : String(t)}`, "error");
+			s.push(e), O(`   Failed to fetch documentation for '${e}': ${t instanceof Error ? t.message : String(t)}`, "error");
 		}
 	}
 	if (s.length === t.length) throw Error(`Failed to fetch documentation for all requested username(s): ${s.join(", ")}.`);
@@ -643,22 +666,22 @@ var Qe = Y(t("build"), $).description("Build vitepress website.").action(async (
 	await $e();
 });
 async function $e() {
-	A("\n-> Start building Vitepress website.\n\n", "info");
+	O("\n-> Start building Vitepress website.\n\n", "info");
 	try {
 		await Ze(async () => {
-			await te(w, { onAfterConfigResolve(e) {
+			await te(C, { onAfterConfigResolve(e) {
 				ne(e);
 			} });
-		}), A("\n\nDocpress build succeeded.", "success");
+		}), O("\n\nDocpress build succeeded.", "success");
 	} catch (e) {
-		A(`\n\nDocpress build failed : ${e}`, "error"), process.exit(1);
+		O(`\n\nDocpress build failed : ${e}`, "error"), process.exit(1);
 	}
 }
 //#endregion
 //#region src/utils/templates.ts
 function et(e, t) {
 	let n = s(e, { encoding: "utf8" });
-	F(m(t)), f(t, n);
+	P(m(t)), f(t, n);
 }
 //#endregion
 //#region src/lib/vitepress.ts
@@ -708,7 +731,7 @@ function nt(e, t, n) {
 //#region src/lib/prepare.ts
 async function rt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, vitepressConfig: r, forks: i, gitProvider: o, lastUpdated: s, token: c, username: l, websiteTitle: u, websiteTagline: d }) {
 	let f = i && o !== "gitlab";
-	i && !f && A("   The forks page is not supported with the 'gitlab' provider, skipping.", "warn");
+	i && !f && O("   The forks page is not supported with the 'gitlab' provider, skipping.", "warn");
 	let p = ve(l), m = ye(l).reduce(({ internals: e, forks: t }, n) => {
 		let { clone_url: r, private: i, fork: a, docpress: o } = n;
 		if (r && !i && !o.filtered) {
@@ -732,8 +755,8 @@ async function rt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, v
 		title: u,
 		tagline: d
 	}, { index: g, sidebar: _ } = ft(m.internals, p, h), y, b;
-	if (a(E) && a(D)) {
-		let e = await _t(D), t = await vt(E);
+	if (a(w) && a(T)) {
+		let e = await _t(T), t = await vt(w);
 		y = [...e.themeConfig?.sidebar ?? [], ..._].sort((e, t) => e.text.localeCompare(t.text)), b = {
 			...g,
 			features: [...t.features, ...g.features].sort((e, t) => e.title.localeCompare(t.title))
@@ -744,7 +767,7 @@ async function rt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, v
 		let t = pt(e);
 		f ? x.push(...t.filter((e) => e.link !== "/forks")) : x.push(...t);
 	}
-	t && (A("   Add extras Vitepress public folder content.", "info"), mt(t, v(w, "public"))), n && (A("   Add extras Vitepress theme files.", "info"), mt(n, v(se))), f && l.length && (A("   Add fork page to display external contributions.", "info"), await gt(m.forks, l, c), x.push({
+	t && (O("   Add extras Vitepress public folder content.", "info"), mt(t, v(C, "public"))), n && (O("   Add extras Vitepress theme files.", "info"), mt(n, v(ce))), f && l.length && (O("   Add fork page to display external contributions.", "info"), await gt(m.forks, l, c), x.push({
 		text: "Forks",
 		link: "/forks"
 	}));
@@ -755,7 +778,7 @@ async function rt({ extraHeaderPages: e, extraPublicContent: t, extraTheme: n, v
 	yt(nt(y, x, S), b);
 }
 function it(e, t) {
-	r(t, `${P(p(t), {
+	r(t, `${N(p(t), {
 		mode: "lowercase",
 		removeIdx: !0
 	}) === "readme.md" ? "\n## Sources" : "# Sources"}\n\nTake a look at the [project sources](${e}).\n`, "utf8");
@@ -774,20 +797,20 @@ function at(e, t, n) {
 		features: e
 	};
 }
-function ot(e, t, n) {
-	let r = {
-		title: P(e, {
+function ot(e, t, n, r = "") {
+	let i = {
+		title: N(e, {
 			mode: "capitalize",
 			replaceDash: !0
 		}),
 		details: t,
-		link: `/${P(e, { removeDot: !0 })}/introduction`
+		link: `/${r}${N(e, { removeDot: !0 })}/introduction`
 	};
-	return n ? [...n, r] : [r];
+	return n ? [...n, i] : [i];
 }
 function st(e, t) {
 	return {
-		text: P(e, {
+		text: N(e, {
 			mode: "capitalize",
 			replaceDash: !0
 		}),
@@ -797,20 +820,20 @@ function st(e, t) {
 }
 function ct(e, t) {
 	return Object.entries(t).flatMap(([t, n]) => t === "$" ? Array.isArray(n) ? n.map((t) => {
-		let n = v(e.docpress.projectPath, t), r = P(p(n), {
+		let n = v(e.docpress.projectPath, t), r = N(p(n), {
 			mode: "lowercase",
 			removeIdx: !0
 		});
 		return r === "readme.md" && (r = "introduction.md"), r !== p(n) && l(n, v(m(n), r)), {
-			text: g(r).name === "introduction" ? "Introduction" : P(r, {
+			text: g(r).name === "introduction" ? "Introduction" : N(r, {
 				mode: "capitalize",
 				replaceDash: !0,
 				removeExt: !0
 			}),
-			link: `/${P(e.name, { removeDot: !0 })}/${g(r).name}`
+			link: `/${e.docpress.routePrefix ?? ""}${N(e.name, { removeDot: !0 })}/${g(r).name}`
 		};
 	}) : [] : typeof n == "object" ? [{
-		text: P(t, {
+		text: N(t, {
 			mode: "capitalize",
 			replaceDash: !0
 		}),
@@ -840,20 +863,20 @@ function dt(e) {
 function ft(e, t, n) {
 	let r = [], i = [];
 	for (let t of e) {
-		A(`   Replace urls for repository '${t.name}'.`, "info"), L([t.docpress.projectPath]).forEach((e) => {
-			A(`   Processing file '${p(e)}' for repository '${t.name}'.`, "debug"), xe(e, t.docpress.replace_url), p(e).toLowerCase() === "readme.md" && we(e, t.docpress.replace_url), Ce(e);
-		}), A(`   Generate sidebar for repository '${t.name}'.`, "info");
+		O(`   Replace urls for repository '${t.name}'.`, "info"), L([t.docpress.projectPath]).forEach((e) => {
+			O(`   Processing file '${p(e)}' for repository '${t.name}'.`, "debug"), xe(e, t.docpress.replace_url), p(e).toLowerCase() === "readme.md" && we(e, t.docpress.replace_url), Ce(e);
+		}), O(`   Generate sidebar for repository '${t.name}'.`, "info");
 		let e = c(t.docpress.projectPath, { recursive: !0 }).filter((e) => {
 			let n = v(t.docpress.projectPath, e.toString());
-			return p(n).endsWith(".md") && ge(n);
+			return p(n).endsWith(".md") && F(n);
 		}).sort();
-		A(`   Add sources for repository '${t.name}'.`, "info");
+		O(`   Add sources for repository '${t.name}'.`, "info");
 		let n;
-		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 ? it(t.html_url, n) : A(`   No markdown files found for repository '${t.name}', skipping sources.`, "warn");
+		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 ? it(t.html_url, n) : O(`   No markdown files found for repository '${t.name}', skipping sources.`, "warn");
 		let a = dt(ct(t, lt(e)));
-		i.push(st(P(t.name, { removeDot: !0 }), a)), r.push(...ot(P(t.name, { removeDot: !0 }), t.description || ""));
+		i.push(st(N(t.name, { removeDot: !0 }), a)), r.push(...ot(N(t.name, { removeDot: !0 }), t.description || "", void 0, t.docpress.routePrefix ?? ""));
 	}
-	A("   Generate index content.", "info");
+	O("   Generate index content.", "info");
 	let a = at(r.toSorted((e, t) => e.title.localeCompare(t.title)), t, n);
 	return {
 		sidebar: i.toSorted((e, t) => e.text.localeCompare(t.text)),
@@ -862,19 +885,19 @@ function ft(e, t, n) {
 }
 function pt(e) {
 	let t = L(e), n = [];
-	A("   Add extras Vitepress headers pages.", "info");
+	O("   Add extras Vitepress headers pages.", "info");
 	for (let e of t) {
-		A(`   Processing file '${e}'.`, "debug");
+		O(`   Processing file '${e}'.`, "debug");
 		let t = v(process.cwd(), e);
-		i(t, v(T, P(p(e), {
+		i(t, v(ae, N(p(e), {
 			mode: "lowercase",
 			removeIdx: !0
 		}))), n.push({
-			text: P(g(t).name, {
+			text: N(g(t).name, {
 				replaceDash: !0,
 				removeIdx: !0
 			}),
-			link: `/${P(g(t).name, {
+			link: `/${N(g(t).name, {
 				removeIdx: !0,
 				mode: "lowercase"
 			})}`
@@ -887,7 +910,7 @@ function mt(e, t, n) {
 		let e = v(process.cwd(), r), a = I(e);
 		for (let o of a) {
 			let a = o.replace(e, ".");
-			A(`   Processing file '${a}' for entry '${r}'.`, "debug");
+			O(`   Processing file '${a}' for entry '${r}'.`, "debug");
 			let s = v(process.cwd(), o), c = v(t, a);
 			n && n(), i(s, c);
 		}
@@ -905,7 +928,7 @@ function ht(e) {
 			contributions: t
 		};
 	});
-	A("   Generate forks page.", "info"), f(ae, "---\nlayout: fork-page\nrepoList:\n" + b.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");
+	O("   Generate forks page.", "info"), f(oe, "---\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 gt(e, t, n) {
 	ht(await Promise.all(e.map(async (e) => {
@@ -924,16 +947,16 @@ async function _t(e) {
 		let { config: t } = await import(v(process.cwd(), e));
 		return t ?? {};
 	} catch (t) {
-		return A(`   Unable to load existing Vitepress config '${e}', starting from an empty config. ${t instanceof Error ? t.message : ""}`, "warn"), {};
+		return O(`   Unable to load existing Vitepress config '${e}', starting from an empty config. ${t instanceof Error ? t.message : ""}`, "warn"), {};
 	}
 }
 async function vt(e) {
 	let t = (await re(v(process.cwd(), e))).toString();
-	return b.parse(t);
+	return y.parse(t);
 }
 function yt(e, t) {
-	return F(m(D)), A("   Generate Vitepress config.", "info"), f(D, `export const config = ${JSON.stringify(e, null, 2)}\n\nexport default config\n`), A("   Generate index file.", "info"), f(E, "---\n" + b.stringify(t)), A("   Add Docpress theme files.", "info"), I(O).forEach((e) => {
-		et(e, v(oe, e.replace(`${O}/`, "")));
+	return P(m(T)), O("   Generate Vitepress config.", "info"), f(T, `export const config = ${JSON.stringify(e, null, 2)}\n\nexport default config\n`), O("   Generate index file.", "info"), f(w, "---\n" + y.stringify(t)), O("   Add Docpress theme files.", "info"), I(le).forEach((e) => {
+		et(e, v(se, e.replace(`${le}/`, "")));
 	});
 }
 //#endregion
@@ -951,7 +974,7 @@ var bt = "prepare", xt = [
 });
 async function Ct(e) {
 	let { extraHeaderPages: t, extraPublicContent: n, extraTheme: r, vitepressConfig: i, forks: a, gitProvider: o, lastUpdated: s, token: c, usernames: l, websiteTitle: u, websiteTagline: d } = e;
-	A("\n-> Start transform files to prepare Vitepress build.", "info"), F(m(D), { clean: !0 });
+	O("\n-> Start transform files to prepare Vitepress build.", "info"), P(m(T), { clean: !0 });
 	for (let e of l) await rt({
 		extraHeaderPages: t,
 		extraPublicContent: n,
@@ -985,7 +1008,7 @@ function wt() {
 }
 function Tt() {
 	wt().parseAsync(process.argv).catch((e) => {
-		A(`\n${e instanceof Error ? e.message : String(e)}`, "error"), process.exit(1);
+		O(`\n${e instanceof Error ? e.message : String(e)}`, "error"), process.exit(1);
 	});
 }
 //#endregion