@tobi-or-not/docpress 0.2.3 → 0.3.1

package/dist/cli.js

@@ -1,30 +1,31 @@
-import { createOption as f, createCommand as D, Command as le } from "commander";
-import T from "chalk";
-import { fromError as pe } from "zod-validation-error";
-import { readFileSync as w, existsSync as G, mkdirSync as ue, readdirSync as Y, statSync as L, appendFileSync as K, cpSync as j, rmSync as A, writeFileSync as y, renameSync as fe } from "node:fs";
-import { resolve as c, join as me, basename as h, dirname as Q, parse as $ } from "node:path";
-import { z as l } from "zod";
-import ge from "axios";
-import { rimrafSync as he } from "rimraf";
-import { Octokit as be } from "octokit";
-import { simpleGit as ve } from "simple-git";
-import { build as ye } from "vitepress";
-import we from "yaml";
-const Se = "@tobi-or-not/docpress", $e = "module", xe = "0.2.3", Ce = "pnpm@9.12.3", ke = "dist/docpress.js", _e = "types/index.d.ts", Oe = {
+import { createOption as m, createCommand as A, Command as Se } from "commander";
+import W from "chalk";
+import { fromZodError as ce } from "zod-validation-error";
+import { z as u } from "zod";
+import { readFileSync as C, existsSync as q, mkdirSync as xe, readdirSync as ae, statSync as G, appendFileSync as de, cpSync as N, rmSync as K, writeFileSync as v, renameSync as Pe } from "node:fs";
+import { resolve as d, join as _e, basename as b, dirname as M, parse as x } from "node:path";
+import Ee from "axios";
+import { rimrafSync as Oe } from "rimraf";
+import { Octokit as ue } from "@octokit/rest";
+import { simpleGit as Fe } from "simple-git";
+import { build as Re } from "vitepress";
+import pe from "yaml";
+const Te = "@tobi-or-not/docpress", De = "module", Le = "0.3.1", Ie = "pnpm@9.12.3", Ve = "dist/docpress.js", je = "types/index.d.ts", Ae = {
   docpress: "bin/docpress.js"
-}, Pe = [
+}, Ge = [
   "bin",
   "dist",
   "types"
-], Ee = {
+], Ne = {
   node: ">=20"
-}, Re = {
+}, Me = {
   build: "pnpm run build:types && pnpm run build:vite",
   "build:clean": "rimraf ./dist ./types ./tsconfig.tsbuildinfo",
   "build:docker": "docker build --tag tobi-or-not/docpress --target prod .",
   "build:types": "tsc",
   "build:vite": "vite build",
-  dev: "rimraf ./docpress && vite-node ./dev/docpress.ts",
+  dev: "vite-node ./dev/docpress.ts",
+  "dev:clean": "rimraf ./docpress && pnpm run dev",
   format: "eslint . --fix",
   lint: "eslint .",
   prepare: "husky",
@@ -38,53 +39,55 @@ const Se = "@tobi-or-not/docpress", $e = "module", xe = "0.2.3", Ce = "pnpm@9.12
   "vp:dev": "vitepress dev ./docpress --port 8080",
   "vp:dev:docker": "docker run --publish 8080:8080 --name docpress-vp --rm tobi-or-not/docs",
   "vp:preview": "vitepress preview ./docpress --port 8080"
-}, De = {
+}, Ue = {
+  "@octokit/rest": "^21.0.2",
   axios: "^1.7.7",
   chalk: "^5.3.0",
   commander: "^12.1.0",
   octokit: "^4.0.2",
   rimraf: "^6.0.1",
   "simple-git": "^3.27.0",
-  vitepress: "^1.4.1",
-  yaml: "^2.6.0",
+  vitepress: "^1.5.0",
+  yaml: "^2.6.1",
   zod: "^3.23.8",
   "zod-validation-error": "^3.4.0"
-}, Le = {
-  "@antfu/eslint-config": "^3.8.0",
-  "@commitlint/cli": "^19.5.0",
-  "@commitlint/config-conventional": "^19.5.0",
-  "@types/node": "^22.7.7",
-  "@vitest/coverage-v8": "^2.1.3",
-  eslint: "^9.13.0",
-  husky: "^9.1.6",
+}, He = {
+  "@antfu/eslint-config": "^3.9.2",
+  "@commitlint/cli": "^19.6.0",
+  "@commitlint/config-conventional": "^19.6.0",
+  "@octokit/types": "^13.6.1",
+  "@types/node": "^22.9.1",
+  "@vitest/coverage-v8": "^2.1.5",
+  eslint: "^9.15.0",
+  husky: "^9.1.7",
   "lint-staged": "^15.2.10",
   typescript: "^5.6.3",
-  vite: "^5.4.9",
-  "vite-node": "^2.1.3",
-  vitest: "^2.1.3"
-}, je = {
+  vite: "^5.4.11",
+  "vite-node": "^2.1.5",
+  vitest: "^2.1.5"
+}, ze = {
   registry: "https://registry.npmjs.org/",
   access: "public",
   tag: "latest"
-}, Fe = {
-  name: Se,
-  type: $e,
-  version: xe,
-  packageManager: Ce,
-  module: ke,
-  types: _e,
-  bin: Oe,
-  files: Pe,
-  engines: Ee,
-  scripts: Re,
-  dependencies: De,
-  devDependencies: Le,
-  publishConfig: je
+}, Be = {
+  name: Te,
+  type: De,
+  version: Le,
+  packageManager: Ie,
+  module: Ve,
+  types: je,
+  bin: Ae,
+  files: Ge,
+  engines: Ne,
+  scripts: Me,
+  dependencies: Ue,
+  devDependencies: He,
+  publishConfig: ze
 };
-function Ie() {
+function Je() {
   return typeof Number(process.env.LOG_LEVEL) == "number" && !Number.isNaN(Number(process.env.LOG_LEVEL)) ? Number(process.env.LOG_LEVEL) : 30;
 }
-const M = {
+const X = {
   info: { color: "white", level: 30 },
   warn: { color: "yellow", level: 20 },
   error: { color: "red", level: 10 },
@@ -92,219 +95,311 @@ const M = {
   trace: { color: "white", level: 40 },
   success: { color: "green", level: 30 }
 };
-function d(e, t = "info", r) {
-  const o = r ? T[r](e) : T[M[t].color](e), n = t === "success" ? "info" : t;
-  Ie() >= M[t].level && console[n](o);
+function c(e, t = "info", r) {
+  const s = r ? W[r](e) : W[X[t].color](e), n = t === "success" ? "info" : t;
+  Je() >= X[t].level && console[n](s);
 }
-const Z = l.object({}), k = c(process.cwd(), "docpress"), ee = c(process.cwd(), "docpress/repositories.json"), te = c(process.cwd(), "docpress/owner.json"), re = c(process.cwd(), "docpress/docs"), Ve = c(process.cwd(), "docpress/docs/index.md"), U = c(process.cwd(), "docpress/.vitepress/config.ts");
-async function P(e) {
+const U = d(process.cwd(), "docpress"), le = d(process.cwd(), "docpress/repositories.json"), fe = d(process.cwd(), "docpress/owner.json"), me = d(process.cwd(), "docpress/docs"), We = d(process.cwd(), "docpress/docs/index.md"), qe = d(process.cwd(), "docpress/docs/forks.md"), Y = d(process.cwd(), "docpress/.vitepress/config.ts"), Z = d(process.cwd(), "docpress/.vitepress/theme"), Ke = d(process.cwd(), "docpress/.vitepress/theme/extras"), L = d(import.meta.dirname, "../templates/theme");
+async function I(e) {
   try {
-    return (await ge.head(e)).status;
+    return (await Ee.head(e)).status;
   } catch (t) {
     return t.response?.status || t.status || 500;
   }
 }
-function b(e, t) {
+function k(e, t) {
   let r = "";
   return t?.removeIdx && (r = e.replace(/^\d{2}-/, "")), t?.replaceDash && (r = (r || e).replaceAll("-", " ")), t?.mode === "capitalize" ? r = (r || e).slice(0, 1).toUpperCase() + (r || e).slice(1).toLowerCase() : t?.mode === "lowercase" ? r = (r || e).toLowerCase() : t?.mode === "uppercase" && (r = (r || e).toUpperCase()), r || e;
 }
-function F(e, { clean: t } = { clean: !1 }) {
+function E(e, { clean: t } = { clean: !1 }) {
   try {
-    t && G(e) && he(`${e}/*`, { glob: !0 }), G(e) || ue(e, { recursive: !0 });
+    t && q(e) && Oe(`${e}/*`, { glob: !0 }), q(e) || xe(e, { recursive: !0 });
   } catch (r) {
     console.error(r);
   }
 }
-function Ne(e) {
+function Xe(e) {
   try {
-    return L(e).isDirectory();
+    return G(e).isDirectory();
   } catch {
     return !1;
   }
 }
-function Te(e) {
+function Ye(e) {
   try {
-    return L(e).isFile();
+    return G(e).isFile();
   } catch {
     return !1;
   }
 }
-function I(e) {
-  return (Array.isArray(e) ? e : [e]).flatMap((t) => Te(t) ? [t] : Ne(t) ? Y(t).flatMap((r) => I(me(t, r))) : []);
+function O(e) {
+  return (Array.isArray(e) ? e : [e]).flatMap((t) => Ye(t) ? [t] : Xe(t) ? ae(t).flatMap((r) => O(_e(t, r))) : []);
 }
-function se(e) {
-  return I(e).filter((t) => h(t).endsWith(".md"));
+function ge(e) {
+  return O(e).filter((t) => b(t).endsWith(".md"));
 }
-function Ge(e) {
-  return e.reduce((t, r, o, n) => o ? o === n.length - 1 ? `${t} or "${r}"` : `${t}, "${r}"` : `"${r}"`, "");
+function Ze(e) {
+  return e.reduce((t, r, s, n) => s ? s === n.length - 1 ? `${t} or "${r}"` : `${t}, "${r}"` : `"${r}"`, "");
 }
-function Ae() {
-  return JSON.parse(w(te).toString());
+function Qe() {
+  return JSON.parse(C(fe).toString());
 }
-function Me() {
-  return JSON.parse(w(ee).toString());
+function et() {
+  return JSON.parse(C(le).toString());
 }
-function R(...e) {
-  return e.reduce((t, r) => (r === null || Object.keys(r).forEach((o) => {
-    const n = t ? t[o] : null, s = r[o];
-    z(n) && z(s) ? t[o] = R(n, s) : t[o] = s;
+function j(...e) {
+  return e.reduce((t, r) => (r === null || Object.keys(r).forEach((s) => {
+    const n = t ? t[s] : null, o = r[s];
+    Q(n) && Q(o) ? t[s] = j(n, o) : t[s] = o;
   }), t), {});
 }
-function z(e) {
+function Q(e) {
   return e && typeof e == "object" && !Array.isArray(e);
 }
-const J = ["github"], m = l.object({
-  branch: l.string().describe("Branch used to collect Git provider data.").optional().default("main"),
-  gitProvider: l.enum(J).describe(`Git provider used to retrieve data. Values should be ${Ge(J)}.`).optional().default("github"),
-  reposFilter: l.string().transform((e) => e.split(",")).or(l.string().array()).describe("List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories.").optional(),
-  token: l.string().describe("Git provider token used to collect data.").optional(),
-  username: l.string().describe("Git provider username used to collect data.")
-}), v = l.object({
-  extraHeaderPages: l.string().describe("List of comma separated additional files or directories to process Vitepress header pages.").transform((e) => e.split(",")).optional(),
-  extraPublicContent: l.string().describe("List of comma separated additional files or directories to process Vitepress public folder.").transform((e) => e.split(",")).optional(),
-  extraTheme: l.string().describe("List of comma separated additional files or directories to use as Vitepress theme.").transform((e) => e.split(",")).optional(),
-  vitepressConfig: l.string().describe("Path to the vitepress configuration file.").transform((e) => JSON.parse(w(c(process.cwd(), e)).toString())).optional()
-}), V = l.object({
-  config: l.string().describe("Path to the docpress configuration file.").transform((e) => JSON.parse(w(c(process.cwd(), e)).toString())).optional()
+function ee(e) {
+  if (!e)
+    return {};
+  try {
+    const t = d(process.cwd(), e), r = C(t, "utf8");
+    return JSON.parse(r);
+  } catch {
+    return {};
+  }
+}
+function P(e) {
+  return e.split(",");
+}
+const te = ["github"], p = u.object({
+  // Global
+  username: u.string().describe("Git provider username used to collect data."),
+  // Fetch
+  branch: u.string().describe("Branch used to collect Git provider data.").default("main"),
+  gitProvider: u.enum(te).describe(`Git provider used to retrieve data. Values should be ${Ze(te)}.`).default("github"),
+  reposFilter: u.array(u.string()).describe("List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories."),
+  // Prepare
+  extraHeaderPages: u.array(u.string()).describe("List of comma separated additional files or directories to process Vitepress header pages."),
+  extraPublicContent: u.array(u.string()).describe("List of comma separated additional files or directories to process Vitepress public folder."),
+  extraTheme: u.array(u.string()).describe("List of comma separated additional files or directories to use as Vitepress theme."),
+  forks: u.boolean().describe("Whether or not to create the dedicated fork page that aggregate external contributions.").default(!1),
+  vitepressConfig: u.any().describe("Path to the vitepress configuration file.")
 });
-m.merge(v).merge(Z);
-const Ue = {
-  build: Z,
-  fetch: m,
-  prepare: v,
-  global: V
+function H(e) {
+  const { config: t, vitepressConfig: r, token: s, ...n } = e;
+  try {
+    const o = p.partial().parse(ee(t)), i = ee(r), a = p.partial().required({ branch: !0, gitProvider: !0 }).parse({}), l = {
+      ...i,
+      ...o.vitepressConfig
+    }, g = {
+      ...o,
+      ...a,
+      ...n,
+      ...Object.keys(l).length && { vitepressConfig: l }
+    };
+    return { ...p.partial().required({ username: !0 }).parse(g), token: s };
+  } catch (o) {
+    c(`   An error occurred while checking configuration.
+     ${ce(o).toString()}`, "error"), process.exit(1);
+  }
+}
+const F = p.partial().extend({
+  config: u.string().describe("Path to the docpress configuration file.").optional(),
+  token: u.string().describe("Git provider token used to collect data.").optional(),
+  reposFilter: u.string().describe(p.shape.reposFilter.description || "").transform(P).optional(),
+  extraHeaderPages: u.string().describe(p.shape.extraHeaderPages.description || "").transform(P).optional(),
+  extraPublicContent: u.string().describe(p.shape.extraPublicContent.description || "").transform(P).optional(),
+  extraTheme: u.string().describe(p.shape.extraTheme.description || "").transform(P).optional(),
+  vitepressConfig: u.string().describe(p.shape.vitepressConfig.description || "").optional()
+}), _ = F.partial().transform(H), tt = F.pick({}), rt = F.pick({
+  branch: !0,
+  config: !0,
+  gitProvider: !0,
+  reposFilter: !0,
+  token: !0,
+  username: !0
+}).transform(H), ot = F.pick({
+  extraHeaderPages: !0,
+  extraPublicContent: !0,
+  extraTheme: !0,
+  config: !0,
+  gitProvider: !0,
+  reposFilter: !0,
+  token: !0,
+  username: !0,
+  vitepressConfig: !0
+}).transform(H), st = {
+  build: tt,
+  fetch: rt,
+  prepare: ot,
+  global: _
 };
-function N(e, t) {
-  d("Initializing Docpress...", "info", "blue"), d(`
+function z(e, t) {
+  c("Initializing Docpress...", "info", "blue"), c(`
 
 -> Checking for required environment settings and configurations.`, "info");
-  function r(n, s) {
-    const i = Ue[n].safeParse({
-      ...V.parse(s).config,
-      ...s
-    });
-    if (i.success)
-      return i.data;
-    d(`   An error occurred while checking configuration: ${pe(i.error).toString()}`, "error"), process.exit(0);
-  }
-  const o = e.reduce((n, s) => {
-    const i = r(s, t);
-    return Object.assign(n, i);
-  }, {});
-  return d("   Setup complete! Ready to process your documentation.", "info"), o;
+  const r = st[e].safeParse(t);
+  return r.error && (c(`   An error occurred while checking configuration.
+     ${ce(r.error).toString()}`, "error"), process.exit(1)), c("   Setup complete! Ready to process your documentation.", "info"), r.data;
 }
-function _(e, t) {
+function R(e, t) {
   return t.forEach((r) => e.addOption(r)), e;
 }
-async function ze({ username: e, token: t, branch: r }) {
-  d(`   Get infos for username '${e}'.`, "info");
-  const o = new be({ auth: t }), { data: n } = await o.request("GET /users/{username}", { username: e }), { data: s } = await o.request("GET /users/{username}/repos", { username: e, sort: "full_name" });
-  return { user: n, repos: s, branch: r };
+async function nt({ username: e, token: t, branch: r }) {
+  c(`   Get infos for username '${e}'.`, "info");
+  const s = new ue({ auth: t });
+  c("   Get user infos.", "debug");
+  const { data: n } = await s.rest.users.getByUsername({ username: e });
+  c("   Get repositories infos.", "debug");
+  const { data: o } = await s.rest.repos.listForUser({ username: e, sort: "full_name" });
+  return { user: n, repos: o, branch: r };
+}
+async function it({
+  repository: e,
+  token: t
+}) {
+  c(`   Get contributors infos for repository '${e.name}'.`, "info");
+  const r = new ue({
+    auth: t,
+    log: {
+      debug: () => {
+      },
+      info: () => {
+      },
+      warn: (o) => {
+        o.includes("404") || console.warn(o);
+      },
+      error: (o) => {
+        o.includes("404") || console.error(o);
+      }
+    }
+  }), { data: s } = await r.rest.repos.get({
+    owner: e.owner.login,
+    repo: e.name
+  });
+  if (!s.source?.owner?.login)
+    return { source: s.source, contributors: [] };
+  const n = [];
+  try {
+    for await (const { data: o } of r.paginate.iterator(
+      r.rest.repos.listContributors,
+      {
+        owner: s.source.owner.login,
+        repo: s.name,
+        per_page: 500
+      }
+    ))
+      n.push(...o);
+  } catch {
+    return c(
+      `   Failed to get contributors infos for repository '${e.name}'.`,
+      "warn"
+    ), { source: s.source, contributors: [] };
+  }
+  return { source: s.source, contributors: n };
 }
-async function Je(e, t, r, o) {
-  F(t, { clean: !0 });
+async function ct(e, t, r, s, n) {
+  E(r, { clean: !0 });
   try {
-    const n = ve({ baseDir: t });
-    await n.init().addConfig("core.sparseCheckout", "true", !0, "local").addRemote("origin", e);
-    for (const s of o)
-      K(c(t, ".git/info/sparse-checkout"), `${s}
+    const o = Fe({ baseDir: r });
+    await o.init().addConfig("core.sparseCheckout", "true", !0, "local").addRemote("origin", t);
+    for (const i of n)
+      c(`   Add '${i}' to '${e}' sparse-checkout file.`, "debug"), de(d(r, ".git/info/sparse-checkout"), `${i}
 `, "utf8");
-    await n.pull("origin", r), o.some((s) => s.includes("docs")) && (j(c(t, "docs"), t, { recursive: !0 }), A(c(t, "docs"), { recursive: !0 })), A(c(t, ".git"), { recursive: !0 });
-  } catch (n) {
-    d(`   Error when cloning repository: ${n}.`, "error");
+    c(`   Clone repository '${e}'.`, "info"), await o.pull("origin", s), n.some((i) => i.includes("docs")) && (N(d(r, "docs"), r, { recursive: !0 }), K(d(r, "docs"), { recursive: !0 })), K(d(r, ".git"), { recursive: !0 });
+  } catch (o) {
+    c(`   Error when cloning repository: ${o}.`, "error");
   }
 }
-async function Be(e, t, r) {
-  const o = `https://github.com/${e}/${t}/tree/${r}/README.md`, n = `https://github.com/${e}/${t}/tree/${r}/docs`, s = `https://github.com/${e}/${t}/tree/${r}/docs/01-readme.md`, i = await P(o), a = await P(n), u = await P(s);
+async function at(e, t, r) {
+  const s = `https://github.com/${e}/${t}/tree/${r}/README.md`, n = `https://github.com/${e}/${t}/tree/${r}/docs`, o = `https://github.com/${e}/${t}/tree/${r}/docs/01-readme.md`, i = await I(s), a = await I(n), l = await I(o);
   return {
     rootReadmeStatus: i,
     docsFolderStatus: a,
-    docsReadmeStatus: u
+    docsReadmeStatus: l
   };
 }
-async function He({ username: e, branch: t, reposFilter: r, token: o }) {
-  F(k, { clean: !0 }), await ze({ username: e, token: o, branch: t }).then(async ({ user: n, repos: s, branch: i }) => Xe(n, s, i, r)).then(async ({ repos: n }) => Ye(n, r));
+async function dt({ username: e, branch: t, reposFilter: r, token: s }) {
+  E(U, { clean: !0 }), await nt({ username: e, token: s, branch: t }).then(async ({ user: n, repos: o, branch: i }) => lt(n, o, i, r)).then(async ({ repos: n }) => ft(n, r));
 }
-async function We(e, t, r) {
-  const o = [];
+async function ut(e, t, r) {
+  const s = [];
   return await Promise.all(
     e.map(async (n) => {
-      const s = t ?? n.default_branch ?? "main", i = c(re, n.name), a = oe(n, r);
-      let u = [];
-      !n.fork && !n.private && !a && (u = await qe(n, s)), o.push({
+      const o = t ?? n.default_branch ?? "main", i = d(me, n.name), a = he(n, r);
+      let l = [];
+      !n.fork && !n.private && !a && (l = await pt(n, o)), s.push({
         ...n,
         docpress: {
           filtered: a,
-          branch: s,
-          includes: u,
+          branch: o,
+          includes: l,
           projectPath: i,
-          raw_url: `https://raw.githubusercontent.com/${n.owner.login}/${n.name}/${s}`,
-          replace_url: `https://github.com/${n.owner.login}/${n.name}/tree/${s}`
+          raw_url: `https://raw.githubusercontent.com/${n.owner.login}/${n.name}/${o}`,
+          replace_url: `https://github.com/${n.owner.login}/${n.name}/tree/${o}`
         }
       });
     })
-  ), o;
+  ), s;
 }
-async function qe(e, t) {
-  const r = await Be(e.owner.login, e.name, t), o = [];
-  return Object.values(r).every((n) => n === 404) || !e.size ? [] : (r.docsFolderStatus !== 404 && o.push("docs/*"), (r.docsFolderStatus === 404 || r.docsReadmeStatus === 404) && o.push("README.md", "!*/**/README.md"), o);
+async function pt(e, t) {
+  const r = await at(e.owner.login, e.name, t), s = [];
+  return Object.values(r).every((n) => n === 404) || !e.size ? [] : (r.docsFolderStatus !== 404 && s.push("docs/*"), (r.docsFolderStatus === 404 || r.docsReadmeStatus === 404) && s.push("README.md", "!*/**/README.md"), s);
 }
-async function Xe(e, t, r, o) {
-  y(te, JSON.stringify(e, null, 2));
-  const n = await We(t, r, o);
-  return y(ee, JSON.stringify(n, null, 2)), { user: e, repos: n };
+async function lt(e, t, r, s) {
+  v(fe, JSON.stringify(e, null, 2));
+  const n = await ut(t, r, s);
+  return v(le, JSON.stringify(n, null, 2)), { user: e, repos: n };
 }
-async function Ye(e, t) {
+async function ft(e, t) {
   if (!e) {
-    d("   No repository respect docpress rules.", "warn");
+    c("   No repository respect docpress rules.", "warn");
     return;
   }
   await Promise.all(
-    e.filter((r) => !oe(r, t)).map(async (r) => {
-      d(`   Clone repository '${r.name}'.`, "info"), await Je(r.clone_url, r.docpress.projectPath, r.docpress.branch, r.docpress.includes);
+    e.filter((r) => !he(r, t)).map(async (r) => {
+      await ct(r.name, r.clone_url, r.docpress.projectPath, r.docpress.branch, r.docpress.includes);
     })
   );
 }
-function oe(e, t) {
-  const r = t?.every((i) => i.startsWith("!")), o = t?.filter((i) => i.startsWith("!")).some((i) => e.name === i.substring(1)), n = !t || t?.filter((i) => !i.startsWith("!")).includes(e.name) || r && !o, s = o || !n;
-  return "docpress" in e && !e.docpress.includes.length ? !0 : !(e.clone_url && !e.fork && !e.private && !s);
-}
-const O = [
-  f("-C, --config <string>", V.shape.config._def.description)
-], B = "fetch", ne = [
-  f("-b, --branch <string>", m.shape.branch._def.description).default(m.shape.branch._def.defaultValue()),
-  f("-g, --git-provider <string>", m.shape.gitProvider._def.description).default(m.shape.gitProvider._def.defaultValue()),
-  f("-r, --repos-filter <string>", m.shape.reposFilter._def.description),
-  f("-T, --token <string>", m.shape.token._def.description),
-  f("-u, --username <string>", m.shape.username._def.description)
-], Ke = _(D(B), [...ne, ...O]).description("Fetch docs with the given username and git provider.").action(async (e) => {
-  const t = N([B], e);
-  await ie(t);
+function he(e, t) {
+  const r = t?.every((i) => i.startsWith("!")), s = t?.filter((i) => i.startsWith("!")).some((i) => e.name === i.substring(1)), n = !t || t?.filter((i) => !i.startsWith("!")).includes(e.name) || e.fork && !s || r && !s, o = s || !n;
+  return "docpress" in e && !e.docpress.includes.length ? !0 : !(e.clone_url && !e.private && !o);
+}
+const T = [
+  m("-C, --config <string>", _.innerType().shape.config._def.description),
+  m("-T, --token <string>", _.innerType().shape.token._def.description),
+  m("-U, --username <string>", _.innerType().shape.username._def.description)
+], re = "fetch", be = [
+  m("-b, --branch <string>", p.shape.branch._def.description).default(p.shape.branch._def.defaultValue()),
+  m("-g, --git-provider <string>", p.shape.gitProvider._def.description).default(p.shape.gitProvider._def.defaultValue()),
+  m("-r, --repos-filter <string>", p.shape.reposFilter._def.description)
+], mt = R(A(re), [...be, ...T]).description("Fetch docs with the given username and git provider.").action(async (e) => {
+  const t = z(re, e);
+  await ve(t);
 });
-async function ie(e) {
-  const { username: t, reposFilter: r, token: o, branch: n, gitProvider: s } = e;
-  d(`
--> Start fetching documentation files. This may take a moment, especially for larger repositories.`, "info"), await He({ username: t, branch: n, reposFilter: r, gitProvider: s, token: o });
+async function ve(e) {
+  const { username: t, reposFilter: r, token: s, branch: n, gitProvider: o } = e;
+  c(`
+-> Start fetching documentation files. This may take a moment, especially for larger repositories.`, "info"), await dt({ username: t, branch: n, reposFilter: r, gitProvider: o, token: s });
 }
-const Qe = "build", Ze = _(D(Qe), O).description("Build vitepress website.").action(async (e) => {
-  await ce();
+const gt = "build", ht = R(A(gt), T).description("Build vitepress website.").action(async (e) => {
+  await ye();
 });
-async function ce() {
-  d(`
+async function ye() {
+  c(`
 -> Start building Vitepress website.
 
 `, "info");
   try {
-    await ye(k), d(`
+    await Re(U), c(`
 
 Docpress build succedeed.`, "success");
   } catch (e) {
-    d(`
+    c(`
 
 Docpress build failed : ${e}`, "error");
   }
 }
-const H = {
+const oe = {
   base: "/",
   lang: "en-US",
   vite: {
@@ -341,150 +436,206 @@ const H = {
     }
   }
 };
-function et(e, t, r) {
-  return r ? R(H, r, { themeConfig: { sidebar: e, nav: t } }) : R(H, { themeConfig: { sidebar: e, nav: t } });
+function bt(e, t, r) {
+  return r ? j(oe, r, { themeConfig: { sidebar: e, nav: t } }) : j(oe, { themeConfig: { sidebar: e, nav: t } });
 }
-function tt(e, t) {
-  const o = w(e, "utf8").replace(/\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, (n, s, i) => `[${s}](${t}/${i})`);
-  y(e, o, "utf8");
+function vt(e, t) {
+  const r = C(e, { encoding: "utf8" });
+  E(M(t)), v(t, r);
 }
-function rt(e, t) {
-  const o = w(e, "utf8").replace(/\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.?\/)?([^/][^)]+)\)/g, (n, s, i, a) => `[${s}](${t}/${a})`).replace(/\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, (n, s, i, a) => `[${s}](${a})`);
-  y(e, o, "utf8");
+function yt(e, t) {
+  const s = C(e, "utf8").replace(/\[([^\]]+)\]\(\.\.\/([^)]+)\)/g, (n, o, i) => `[${o}](${t}/${i})`);
+  v(e, s, "utf8");
 }
-function W(e, t) {
-  const n = `${h(t) === "introduction.md" ? `
+function wt(e, t) {
+  const s = C(e, "utf8").replace(/\[([^\]]+)\]\((?!\.?\/docs\/|docs\/|http|#)(\.?\/)?([^/][^)]+)\)/g, (n, o, i, a) => `[${o}](${t}/${a})`).replace(/\[([^\]]+)\]\((\.?\/docs\/|docs\/)([^)]*)\)/g, (n, o, i, a) => `[${o}](${a})`);
+  v(e, s, "utf8");
+}
+function se(e, t) {
+  const n = `${b(t) === "introduction.md" ? `
 ## Sources` : "# Sources"}
 
 Take a look at the [project sources](${e}).
 `;
-  K(t, n, "utf8");
+  de(t, n, "utf8");
 }
-function st(e, t) {
-  const { name: r, login: o, bio: n } = t;
+function kt(e, t) {
+  const { name: r, login: s, bio: n } = t;
   return {
     layout: "home",
     hero: {
-      name: r ? `${r}'s projects` : `${o}'s projects`,
+      name: r ? `${r}'s projects` : `${s}'s projects`,
       tagline: n ?? "Robots are everywhere 🤖"
       // \U0001F916
     },
     features: e
   };
 }
-function ot(e, t, r) {
-  const o = {
-    title: b(e, { mode: "capitalize", replaceDash: !0 }),
+function $t(e, t, r) {
+  const s = {
+    title: k(e, { mode: "capitalize", replaceDash: !0 }),
     details: t,
     link: `/${e}/introduction`
   };
-  return r ? [...r, o] : [o];
+  return r ? [...r, s] : [s];
 }
-function nt(e, t) {
+function Ct(e, t) {
   return {
-    text: b(e, { mode: "capitalize", replaceDash: !0 }),
+    text: k(e, { mode: "capitalize", replaceDash: !0 }),
     collapsed: !0,
     items: t
   };
 }
-function E(e, t, r) {
-  const o = {
-    text: t === "introduction" ? "Introduction" : b(t, { mode: "capitalize", replaceDash: !0 }),
+function V(e, t, r) {
+  const s = {
+    text: t === "introduction" ? "Introduction" : k(t, { mode: "capitalize", replaceDash: !0 }),
     link: `/${e}/${t}`
   };
-  return r ? [...r, o] : [o];
-}
-function it(e, t) {
-  const r = [], o = [];
-  for (const s of e) {
-    d(`   Replace urls for repository '${s.name}'.`, "info"), se([s.docpress.projectPath]).forEach((a) => {
-      tt(a, `https://github.com/${s.owner.login}/${s.name}/tree/${s.docpress.branch}`), h(a).toLowerCase() === "readme.md" && rt(a, `https://github.com/${s.owner.login}/${s.name}/tree/${s.docpress.branch}`);
-    }), d(`   Generate sidebar for repository '${s.name}'.`, "info");
-    const i = Y(s.docpress.projectPath).filter((a) => L(c(s.docpress.projectPath, a)).isFile() && h(c(s.docpress.projectPath, a)).endsWith(".md")).sort((a, u) => a.localeCompare(u)).reduce((a, u, x, C) => {
-      const g = c(s.docpress.projectPath, u);
-      let p = b(h(g), { mode: "lowercase", removeIdx: !0 });
-      if (p === "readme.md" && (p = "introduction.md"), p !== h(g) && fe(g, c(Q(g), p)), x === C.length - 1) {
-        let S;
-        if (C.length > 1)
-          return S = c(s.docpress.projectPath, "sources.md"), W(s.html_url, S), E(
-            s.name,
-            $(S).name,
-            E(s.name, $(p).name, a)
+  return r ? [...r, s] : [s];
+}
+function St(e, t) {
+  const r = [], s = [];
+  for (const o of e) {
+    c(`   Replace urls for repository '${o.name}'.`, "info"), ge([o.docpress.projectPath]).forEach((a) => {
+      c(`   Processing file '${b(a)}' for repository '${o.name}'.`, "debug"), yt(a, `https://github.com/${o.owner.login}/${o.name}/tree/${o.docpress.branch}`), b(a).toLowerCase() === "readme.md" && wt(a, `https://github.com/${o.owner.login}/${o.name}/tree/${o.docpress.branch}`);
+    }), c(`   Generate sidebar for repository '${o.name}'.`, "info");
+    const i = ae(o.docpress.projectPath).filter((a) => G(d(o.docpress.projectPath, a)).isFile() && b(d(o.docpress.projectPath, a)).endsWith(".md")).sort((a, l) => a.localeCompare(l)).reduce((a, l, g, y) => {
+      const h = d(o.docpress.projectPath, l);
+      let f = k(b(h), { mode: "lowercase", removeIdx: !0 });
+      if (f === "readme.md" && (f = "introduction.md"), f !== b(h) && Pe(h, d(M(h), f)), g === y.length - 1) {
+        let w;
+        if (y.length > 1)
+          return w = d(o.docpress.projectPath, "sources.md"), c(`   Add sources for repository '${o.name}'.`, "info"), se(o.html_url, w), V(
+            o.name,
+            x(w).name,
+            V(o.name, x(f).name, a)
           );
-        S = c(s.docpress.projectPath, p), W(s.html_url, S);
+        w = d(o.docpress.projectPath, f), se(o.html_url, w);
       }
-      return E(s.name, $(p).name, a);
+      return V(o.name, x(f).name, a);
     }, []);
-    o.push(nt(s.name, i)), r.push(...ot(s.name, s.description || ""));
+    s.push(Ct(o.name, i)), r.push(...$t(o.name, o.description || ""));
   }
-  d("   Generate index content.", "info");
-  const n = st(r.sort((s, i) => s.title.localeCompare(i.title)), t);
+  c("   Generate index content.", "info");
+  const n = kt(r.sort((o, i) => o.title.localeCompare(i.title)), t);
   return {
-    sidebar: o.sort((s, i) => s.text.localeCompare(i.text)),
+    sidebar: s.sort((o, i) => o.text.localeCompare(i.text)),
     index: n
   };
 }
-function ct(e) {
-  const t = se(e), r = [];
-  d("   Add extras Vitepress headers pages.", "info");
-  for (const o of t) {
-    const n = c(process.cwd(), o), s = c(re, b(h(o), { mode: "lowercase", removeIdx: !0 }));
-    j(n, s), r.push({
-      text: b($(n).name, { replaceDash: !0, removeIdx: !0 }),
-      link: `/${b($(n).name, { removeIdx: !0, mode: "lowercase" })}`
+function xt(e) {
+  const t = ge(e), r = [];
+  c("   Add extras Vitepress headers pages.", "info");
+  for (const s of t) {
+    c(`   Processing file '${s}'.`, "debug");
+    const n = d(process.cwd(), s), o = d(me, k(b(s), { mode: "lowercase", removeIdx: !0 }));
+    N(n, o), r.push({
+      text: k(x(n).name, { replaceDash: !0, removeIdx: !0 }),
+      link: `/${k(x(n).name, { removeIdx: !0, mode: "lowercase" })}`
     });
   }
   return r;
 }
-function q(e, t, r) {
-  for (const o of Array.isArray(e) ? e : [e]) {
-    const n = c(process.cwd(), o), s = I(n);
-    for (const i of s) {
-      const a = c(process.cwd(), i), u = c(t, i.replace(n, "."));
-      j(a, u);
+function ne(e, t, r) {
+  for (const s of Array.isArray(e) ? e : [e]) {
+    const n = d(process.cwd(), s), o = O(n);
+    for (const i of o) {
+      const a = i.replace(n, ".");
+      c(`   Processing file '${a}' for entry '${s}'.`, "debug");
+      const l = d(process.cwd(), i), g = d(t, a);
+      N(l, g);
     }
   }
 }
-function at(e, t) {
+function Pt(e) {
+  const t = `---
+`, r = `layout: fork-page
+repoList:
+`, s = `
+# External contributions
+
+This 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.
+
+Every 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.
+
+This page serves as both a portfolio of past work and a resource for revisiting projects that have made a meaningful impact.
+`, n = e.map(({ repository: o, contributions: i }) => {
+    const { name: a, owner: l, html_url: g, description: y, stargazers_count: h } = o;
+    return { name: a, owner: l.login, html_url: g, description: y, stargazers_count: h, contributions: i };
+  });
+  c("   Generate forks page.", "info"), v(qe, t.concat(r, pe.stringify(n), t, s));
+}
+async function _t(e, t, r) {
+  const s = await Promise.all(
+    e.map(async (n) => {
+      const { source: o, contributors: i } = await it({ repository: n, token: r });
+      return {
+        contributions: i?.find((a) => a.login === t)?.contributions ?? 0,
+        repository: o
+      };
+    })
+  ).then((n) => n.filter(({ repository: o, contributions: i }) => !!o && i));
+  Pt(s);
+}
+function Et(e, t) {
   const r = `---
 `;
-  F(Q(U)), d("   Generate Vitepress config.", "info"), y(U, `export default ${JSON.stringify(e, null, 2)}
-`), d("   Generate index file.", "info"), y(Ve, r.concat(we.stringify(t), r));
-}
-const X = "prepare", ae = [
-  f("-c, --extra-public-content <string>", v.shape.extraPublicContent._def.description),
-  f("-p, --extra-header-pages <string>", v.shape.extraHeaderPages._def.description),
-  f("-t, --extra-theme <string>", v.shape.extraTheme._def.description),
-  f("-v, --vitepress-config <string>", v.shape.vitepressConfig._def.description)
-], dt = _(D(X), [...ae, ...O]).description("Transform doc to the target vitepress format.").action(async (e) => {
-  const t = N([X], e);
-  await de(t);
+  E(M(Y)), c("   Generate Vitepress config.", "info"), v(Y, `export default ${JSON.stringify(e, null, 2)}
+`), c("   Generate index file.", "info"), v(We, r.concat(pe.stringify(t), r)), c("   Add Docpress theme files.", "info");
+  const s = O(L);
+  for (const n of s) {
+    const o = n.replace(`${L}/`, "");
+    c(`   Processing file '${d(Z, o)}'.`, "debug"), vt(d(L, n), d(Z, o));
+  }
+}
+const ie = "prepare", we = [
+  m("-c, --extra-public-content <string>", p.shape.extraPublicContent._def.description),
+  m("-f, --forks", p.shape.forks._def.description),
+  m("-p, --extra-header-pages <string>", p.shape.extraHeaderPages._def.description),
+  m("-t, --extra-theme <string>", p.shape.extraTheme._def.description),
+  m("-v, --vitepress-config <string>", p.shape.vitepressConfig._def.description)
+], Ot = R(A(ie), [...we, ...T]).description("Transform doc to the target vitepress format.").action(async (e) => {
+  const t = z(ie, e);
+  await ke(t);
 });
-async function de(e) {
-  const { extraHeaderPages: t, extraPublicContent: r, extraTheme: o, vitepressConfig: n } = e;
-  d(`
+async function ke(e) {
+  const { extraHeaderPages: t, extraPublicContent: r, extraTheme: s, vitepressConfig: n, forks: o, token: i, username: a } = e;
+  c(`
 -> Start transform files to prepare Vitepress build.`, "info");
-  const s = Ae(), i = Me().reduce((g, p) => p.clone_url && !p.fork && !p.private && p.docpress.includes.length && !p.docpress.filtered ? [...g, p] : g, []), { sidebar: a, index: u } = it(i, s), x = [];
-  t && x.push(...ct(t)), r && (d("   Add extras Vitepress public folder content.", "info"), q(r, c(k, "public"))), o && (d("   Add extras Vitepress theme files.", "info"), q(o, c(k, ".vitepress/theme")));
-  const C = et(a, x, n);
-  at(C, u);
-}
-function lt() {
-  const e = new le().name("docpress").description("Build your doc website faster than light ⚡️⚡️⚡️").version(`${Fe.version}`).addCommand(Ke).addCommand(dt).addCommand(Ze).action(async (t, r) => {
-    const o = N(["fetch", "prepare"], t);
-    await ie(o), await de(o), await ce();
+  const l = Qe(), g = et().reduce(({ internals: $, forks: S }, D) => {
+    const { clone_url: $e, private: Ce, fork: B, docpress: J } = D;
+    if ($e && !Ce && !J.filtered) {
+      if (!B && J.includes.length)
+        return { internals: [...$, D], forks: S };
+      if (B)
+        return { internals: $, forks: [...S, D] };
+    }
+    return { internals: $, forks: S };
+  }, { internals: [], forks: [] }), { sidebar: y, index: h } = St(g.internals, l), f = [];
+  if (t) {
+    const $ = xt(t);
+    o ? f.push(...$.filter((S) => S.link !== "/forks")) : f.push(...$);
+  }
+  r && (c("   Add extras Vitepress public folder content.", "info"), ne(r, d(U, "public"))), s && (c("   Add extras Vitepress theme files.", "info"), ne(s, d(Ke))), o && a && (c("   Add fork page to display external contributions.", "info"), await _t(g.forks, a, i), f.push({ text: "Forks", link: "/forks" }));
+  const w = bt(y, f, n);
+  Et(w, h);
+}
+function Ft() {
+  const e = new Se().name("docpress").description("Build your doc website faster than light ⚡️⚡️⚡️").version(`${Be.version}`).action(async (t, r) => {
+    const s = z("global", t);
+    await ve(s), await ke(s), await ye();
   }).configureHelp({
     sortSubcommands: !0,
     sortOptions: !0,
     showGlobalOptions: !0
-  }).enablePositionalOptions().passThroughOptions();
-  return _(e, [...ne, ...ae, ...O]), e;
+  }).enablePositionalOptions().passThroughOptions().addCommand(mt).addCommand(Ot).addCommand(ht);
+  return R(e, [...be, ...we, ...T]), e;
 }
-function xt() {
-  lt().parseAsync();
+function Ht() {
+  Ft().parseAsync(process.argv);
 }
 export {
-  lt as getProgram,
-  xt as main
+  Ft as getProgram,
+  Ht as main
 };
 //# sourceMappingURL=cli.js.map