@tobi-or-not/docpress 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# Docpress :robot:
+
+This project aims to automate the construction of documentation website based on a Github username and optionally a list of repositories.
+
+## Explanation
+
+The package will download the documentation files for the given repository list, to do this it will check if a `docs/` folder is present at root level and download this entire folder or only the `README.md` file if this is not the case.
+After downloading all project documentation files, it will build a static website using [vitepress](https://vitepress.dev/).
+
+> If a `docs/` folder is present, all files in it will be sorted and renamed without the prefix number so it will not appeared inside the generated website. Example: `docs/01-get-started.md` will become `get-started.md`.
+
+## Quickstart
+
+```sh
+git clone https://github.com/this-is-tobi/docpress.git
+cd ./docpress
+docker build --tag robots/docpress --target prod .
+docker run --publish 8080:8080 --name docpress --rm -v $(pwd)/docpress:/app/docpress:rw robots/docpress -u <username>
+```
+
+## Advanced usage
+
+```txt
+Usage: docpress [options] [command]
+
+Build your doc website faster than light ⚡️⚡️⚡️
+
+Options:
+  -b, --branch <string>                Branch used to collect Git provider data. (default: "main")
+  -c, --extra-public-content <string>  List of comma separated additional files or directories to process Vitepress public folder.
+  -C, --config <string>                Path to the docpress configuration file.
+  -g, --git-provider <string>          Git provider used to retrieve data. Values should be one of "github" or "gitlab". (default: "github")
+  -h, --help                           display help for command
+  -p, --extra-header-pages <string>    List of comma separated additional files or directories to process Vitepress header pages.
+  -r, --repos-filter <string>          List of comma separated repositories to retrieve from Git provider. Default to all user's public repositories.
+  -t, --extra-theme <string>           List of comma separated additional files or directories to process Vitepress public folder.
+  -T, --token <string>                 Git provider token used to collect data.
+  -u, --username <string>              Git provider username used to collect data.
+  -v, --vitepress-config <string>      Path to the vitepress configuration file.
+  -V, --version                        output the version number
+
+Commands:
+  build [options]                      Build vitepress website.
+  fetch [options]                      Fetch docs with the given username and git provider.
+  prepare [options]                    Transform doc to the target vitepress format.
+```
+
+## Development
+
+### Prerequisites
+
+To run the application in development mode, install :
+- [nodejs](https://nodejs.org/) *- javascript runtime.*
+- [pnpm](https://pnpm.io/) *- powerful, space efficient node package manager.*
+
+### Use CLI
+
+1. Install project nodejs dependencies.
+    ```sh
+    pnpm install
+    ```
+2. Fetch and build website.
+    ```sh
+    pnpm run dev -u <username>
+    ```
+3. Preview website.
+    ```sh
+    pnpm run vp:dev
+    ```
+
+Preview website is available at <http://localhost:8080>.
+
+> [!TIP]
+> Use command `pnpm run dev -h` to print options.

package/bin/docpress.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env -S NODE_OPTIONS=--no-warnings node
+
+import main from '../dist/index.js'
+
+main()

package/dist/commands/build.js

@@ -0,0 +1,16 @@
+import { build as vitepressBuild } from 'vitepress';
+import { createCommand } from 'commander';
+import { addOptions } from '../utils/commands.js';
+import { DOCPRESS_DIR } from '../utils/const.js';
+import { globalOpts } from './global.js';
+const cmdName = 'build';
+export const buildOpts = [];
+export const buildCmd = addOptions(createCommand(cmdName), globalOpts)
+    .description('Build vitepress website.')
+    .action(async (_opts) => {
+    await main();
+});
+export async function main() {
+    await vitepressBuild(DOCPRESS_DIR);
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,cAAc,EAAE,MAAM,WAAW,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,OAAO,GAAG,OAAO,CAAA;AAEvB,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAA;AAE3B,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;KACnE,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;IACtB,MAAM,IAAI,EAAE,CAAA;AACd,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,cAAc,CAAC,YAAY,CAAC,CAAA;AACpC,CAAC"}

package/dist/commands/fetch.js

@@ -0,0 +1,25 @@
+import { createCommand, createOption } from 'commander';
+import { addOptions, parseOptions } from '../utils/commands.js';
+import { fetchOptsSchema } from '../schemas/fetch.js';
+import { fetchDoc } from '../lib/fetch.js';
+import { globalOpts } from './global.js';
+const cmdName = 'fetch';
+export const fetchOpts = [
+    createOption('-b, --branch <string>', fetchOptsSchema.shape.branch._def.description)
+        .default(fetchOptsSchema.shape.branch._def.defaultValue()),
+    createOption('-g, --git-provider <string>', fetchOptsSchema.shape.gitProvider._def.description)
+        .default(fetchOptsSchema.shape.gitProvider._def.defaultValue()),
+    createOption('-r, --repos-filter <string>', fetchOptsSchema.shape.reposFilter._def.description),
+    createOption('-T, --token <string>', fetchOptsSchema.shape.token._def.description),
+    createOption('-u, --username <string>', fetchOptsSchema.shape.username._def.description),
+];
+export const fetchCmd = addOptions(createCommand(cmdName), [...fetchOpts, ...globalOpts])
+    .description('Fetch docs with the given username and git provider.')
+    .action(async (opts) => {
+    await main(opts);
+});
+export async function main(opts) {
+    const { username, reposFilter, token, branch, gitProvider } = parseOptions(cmdName, opts);
+    await fetchDoc({ username, branch, reposFilter, gitProvider, token });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/commands/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/commands/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExC,MAAM,OAAO,GAAG,OAAO,CAAA;AAEvB,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,CAAC,uBAAuB,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;SACjF,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IAC5D,YAAY,CAAC,6BAA6B,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;SAC5F,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;IACjE,YAAY,CAAC,6BAA6B,EAAE,eAAe,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC;IAC/F,YAAY,CAAC,sBAAsB,EAAE,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;IAClF,YAAY,CAAC,yBAAyB,EAAE,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC;CACzF,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,UAAU,CAAC,CAAC;KACtF,WAAW,CAAC,sDAAsD,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAA;AAClB,CAAC,CAAC,CAAA;AAEJ,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY;IACrC,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAEzF,MAAM,QAAQ,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;AACvE,CAAC"}

package/dist/commands/global.js

@@ -0,0 +1,6 @@
+import { createOption } from 'commander';
+import { globalOptsSchema } from '../schemas/global.js';
+export const globalOpts = [
+    createOption('-C, --config <string>', globalOptsSchema.shape.config._def.description),
+];
+//# sourceMappingURL=global.js.map

package/dist/commands/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/commands/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAEvD,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,YAAY,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC;CACtF,CAAA"}

package/dist/commands/prepare.js

@@ -0,0 +1,46 @@
+import { resolve } from 'node:path';
+import { createCommand, createOption } from 'commander';
+import { DOCPRESS_DIR } from '../utils/const.js';
+import { getUserInfos, getUserRepos } from '../utils/functions.js';
+import { addOptions, parseOptions } from '../utils/commands.js';
+import { getVitepressConfig } from '../lib/vitepress.js';
+import { addContent, addExtraPages, generateVitepressFiles, transformDoc } from '../lib/prepare.js';
+import { prepareOptsSchema } from '../schemas/prepare.js';
+import { globalOpts } from './global.js';
+const cmdName = 'prepare';
+export const prepareOpts = [
+    createOption('-c, --extra-public-content <string>', prepareOptsSchema.shape.extraPublicContent._def.description),
+    createOption('-p, --extra-header-pages <string>', prepareOptsSchema.shape.extraHeaderPages._def.description),
+    createOption('-t, --extra-theme <string>', prepareOptsSchema.shape.extraTheme._def.description),
+    createOption('-v, --vitepress-config <string>', prepareOptsSchema.shape.vitepressConfig._def.description),
+];
+export const prepareCmd = addOptions(createCommand(cmdName), [...prepareOpts, ...globalOpts])
+    .description('Transform doc to the target vitepress format.')
+    .action(async (opts) => {
+    await main(opts);
+});
+export async function main(opts) {
+    const { extraHeaderPages, extraPublicContent, extraTheme, vitepressConfig } = parseOptions(cmdName, opts);
+    const user = getUserInfos();
+    const repositories = getUserRepos()
+        .reduce((acc, cur) => {
+        if (cur.clone_url && !cur.fork && !cur.private && cur.docpress.includes.length && !cur.docpress.filtered) {
+            return [...acc, cur];
+        }
+        return acc;
+    }, []);
+    const { sidebar, index } = transformDoc(repositories, user);
+    const nav = [];
+    if (extraHeaderPages) {
+        nav.push(...addExtraPages(extraHeaderPages));
+    }
+    if (extraPublicContent) {
+        addContent(extraPublicContent, resolve(DOCPRESS_DIR, 'public'));
+    }
+    if (extraTheme) {
+        addContent(extraTheme, resolve(DOCPRESS_DIR, '.vitepress/theme'));
+    }
+    const config = getVitepressConfig(sidebar, nav, vitepressConfig);
+    generateVitepressFiles(config, index);
+}
+//# sourceMappingURL=prepare.js.map

package/dist/commands/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/commands/prepare.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,31 @@
+import { program } from 'commander';
+import pkg from '../package.json' with { type: 'json' };
+import { fetchCmd, main as fetchFn, fetchOpts } from './commands/fetch.js';
+import { buildCmd, main as buildFn } from './commands/build.js';
+import { prepareCmd, main as prepareFn, prepareOpts } from './commands/prepare.js';
+import { addOptions } from './utils/commands.js';
+import { globalOpts } from './commands/global.js';
+export default function main() {
+    const pm = program
+        .name('docpress')
+        .description('Build your doc website faster than light ⚡️⚡️⚡️')
+        .version(`${pkg.version}`)
+        .addCommand((fetchCmd))
+        .addCommand(prepareCmd)
+        .addCommand(buildCmd)
+        .action(async (opts, _cmd) => {
+        await fetchFn(opts);
+        await prepareFn(opts);
+        await buildFn();
+    })
+        .configureHelp({
+        sortSubcommands: true,
+        sortOptions: true,
+        showGlobalOptions: true,
+    })
+        .enablePositionalOptions()
+        .passThroughOptions();
+    addOptions(pm, [...fetchOpts, ...prepareOpts, ...globalOpts]);
+    pm.parseAsync();
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,MAAM,CAAC,OAAO,UAAU,IAAI;IAC1B,MAAM,EAAE,GAAG,OAAO;SACf,IAAI,CAAC,UAAU,CAAC;SAChB,WAAW,CAAC,iDAAiD,CAAC;SAC9D,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;SACzB,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC;SACtB,UAAU,CAAC,UAAU,CAAC;SACtB,UAAU,CAAC,QAAQ,CAAC;SACpB,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QACnB,MAAM,SAAS,CAAC,IAAI,CAAC,CAAA;QACrB,MAAM,OAAO,EAAE,CAAA;IACjB,CAAC,CAAC;SACD,aAAa,CAAC;QACb,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,IAAI;QACjB,iBAAiB,EAAE,IAAI;KACxB,CAAC;SACD,uBAAuB,EAAE;SACzB,kBAAkB,EAAE,CAAA;IAEvB,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC,CAAA;IAE7D,EAAE,CAAC,UAAU,EAAE,CAAA;AACjB,CAAC"}

package/dist/lib/fetch.js

@@ -0,0 +1,92 @@
+import { resolve } from 'node:path';
+import { writeFileSync } from 'node:fs';
+import { checkHttpStatus, createDir } from '../utils/functions.js';
+import { DOCPRESS_DIR, DOCS_DIR, USER_INFOS, USER_REPOS_INFOS } from '../utils/const.js';
+import { cloneRepo, getInfos } from './git.js';
+export async function checkDoc(repoOwner, repoName, branch) {
+    const rootReadmeUrl = `https://github.com/${repoOwner}/${repoName}/tree/${branch}/README.md`;
+    const docsFolderUrl = `https://github.com/${repoOwner}/${repoName}/tree/${branch}/docs`;
+    const docsReadmeUrl = `https://github.com/${repoOwner}/${repoName}/tree/${branch}/docs/01-readme.md`;
+    const rootReadmeStatus = await checkHttpStatus(rootReadmeUrl);
+    const docsFolderStatus = await checkHttpStatus(docsFolderUrl);
+    const docsReadmeStatus = await checkHttpStatus(docsReadmeUrl);
+    return {
+        rootReadmeStatus,
+        docsFolderStatus,
+        docsReadmeStatus,
+    };
+}
+export async function fetchDoc({ username, branch, reposFilter, token }) {
+    createDir(DOCPRESS_DIR, { clean: true });
+    await getInfos({ username, token, branch })
+        .then(async ({ user, repos, branch }) => generateInfos(user, repos, branch, reposFilter))
+        .then(async ({ repos }) => getDoc(repos, reposFilter));
+}
+async function enhanceRepositories(repos, branch, reposFilter) {
+    const enhancedRepos = [];
+    await Promise.all(repos.map(async (repo) => {
+        const computedBranch = branch ?? repo.default_branch ?? 'main';
+        const projectPath = resolve(DOCS_DIR, repo.name);
+        const filtered = isRepoFiltered(repo, reposFilter);
+        let includes = [];
+        if (!repo.fork && !repo.private && !filtered) {
+            includes = await getSparseCheckout(repo, computedBranch);
+        }
+        enhancedRepos.push({
+            ...repo,
+            docpress: {
+                filtered,
+                branch: computedBranch,
+                includes,
+                projectPath,
+                raw_url: `https://raw.githubusercontent.com/${repo.owner.login}/${repo.name}/${computedBranch}`,
+                replace_url: `https://github.com/${repo.owner.login}/${repo.name}/tree/${computedBranch}`,
+            },
+        });
+    }));
+    return enhancedRepos;
+}
+async function getSparseCheckout(repo, branch) {
+    const docsStatus = await checkDoc(repo.owner.login, repo.name, branch);
+    const includes = [];
+    if (Object.values(docsStatus).every(status => status === 404) || !repo.size) {
+        return [];
+    }
+    if (docsStatus.docsFolderStatus !== 404) {
+        includes.push('docs/*');
+    }
+    if (docsStatus.docsFolderStatus === 404 || docsStatus.docsReadmeStatus === 404) {
+        includes.push('README.md', '!*/**/README.md');
+    }
+    return includes;
+}
+async function generateInfos(user, repos, branch, reposFilter) {
+    writeFileSync(USER_INFOS, JSON.stringify(user, null, 2));
+    const enhancedRepos = await enhanceRepositories(repos, branch, reposFilter);
+    writeFileSync(USER_REPOS_INFOS, JSON.stringify(enhancedRepos, null, 2));
+    return { user, repos: enhancedRepos };
+}
+async function getDoc(repos, reposFilter) {
+    if (!repos) {
+        console.warn('No repository respect docpress rules.');
+        return;
+    }
+    await Promise.all(repos
+        .filter(repo => !isRepoFiltered(repo, reposFilter))
+        .map(async (repo) => cloneRepo(repo.clone_url, repo.docpress.projectPath, repo.docpress.branch, repo.docpress.includes)));
+}
+export function isRepoFiltered(repo, reposFilter) {
+    const isExcluded = reposFilter?.filter(filter => filter.startsWith('!'))
+        .some(filter => repo.name === filter.substring(1));
+    const isIncluded = !reposFilter || reposFilter?.filter(filter => !filter.startsWith('!'))
+        .includes(repo.name);
+    const isFiltered = isExcluded || !isIncluded;
+    if ('docpress' in repo && !repo.docpress.includes.length) {
+        return true;
+    }
+    if (!!repo.clone_url && !repo.fork && !repo.private && !isFiltered) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/lib/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/lib/fetch.ts"],"names":[],"mappings":"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"}

package/dist/lib/git.js

@@ -0,0 +1,33 @@
+import { appendFileSync, cpSync, rmSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { Octokit } from 'octokit';
+import { simpleGit } from 'simple-git';
+import { createDir } from '../utils/functions.js';
+export async function getInfos({ username, token, branch }) {
+    const octokit = new Octokit({ auth: token });
+    const { data: user } = await octokit.request('GET /users/{username}', { username });
+    const { data: repos } = await octokit.request('GET /users/{username}/repos', { username, sort: 'full_name' });
+    return { user, repos, branch };
+}
+export async function cloneRepo(url, projectDir, branch, includes) {
+    createDir(projectDir, { clean: true });
+    try {
+        const git = simpleGit({ baseDir: projectDir });
+        await git.init()
+            .addConfig('core.sparseCheckout', 'true', true, 'local')
+            .addRemote('origin', url);
+        for (const item of includes) {
+            appendFileSync(resolve(projectDir, '.git/info/sparse-checkout'), `${item}\n`, 'utf8');
+        }
+        await git.pull('origin', branch);
+        if (includes.some(item => item.includes('docs'))) {
+            cpSync(resolve(projectDir, 'docs'), projectDir, { recursive: true });
+            rmSync(resolve(projectDir, 'docs'), { recursive: true });
+        }
+        rmSync(resolve(projectDir, '.git'), { recursive: true });
+    }
+    catch (e) {
+        console.error(e);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGjD,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAoD;IAC1G,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAA;IACnF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAA;IAE7G,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,UAAkB,EAAE,MAAc,EAAE,QAAkB;IACjG,SAAS,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IAEtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAA;QAC9C,MAAM,GAAG,CAAC,IAAI,EAAE;aACb,SAAS,CAAC,qBAAqB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC;aACvD,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QAE3B,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,2BAA2B,CAAC,EAAE,GAAG,IAAI,IAAI,EAAE,MAAM,CAAC,CAAA;QACvF,CAAC;QAED,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAEhC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACpE,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/lib/prepare.js

@@ -0,0 +1,128 @@
+import { basename, dirname, parse, resolve } from 'node:path';
+import { appendFileSync, cpSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from 'node:fs';
+import YAML from 'yaml';
+import { createDir, extractFiles, getMdFiles, prettify } from '../utils/functions.js';
+import { DOCS_DIR, INDEX_FILE, VITEPRESS_CONFIG } from '../utils/const.js';
+import { replaceReadmePath, replaceRelativePath } from '../utils/regex.js';
+function addSources(repoUrl, outputPath) {
+    const fileName = basename(outputPath);
+    const title = fileName === 'readme.md' ? '\n## Sources' : '# Sources';
+    const sourcesContent = `${title}\n\nTake a look at the [project sources](${repoUrl}).\n`;
+    appendFileSync(outputPath, sourcesContent, 'utf8');
+}
+// export function addContribution(outputPath: string) {
+//   const sourcesContent = `
+// If you'd like to improve or fix the code, check out the [contribution guidelines](/contribute).
+// `
+//   appendFileSync(outputPath, sourcesContent, 'utf8')
+// }
+export function generateIndex(features, user) {
+    const { name, login, bio } = user;
+    return {
+        layout: 'home',
+        hero: {
+            name: name ? `${name}'s projects` : `${login}'s projects`,
+            tagline: bio ?? 'Robots are everywhere 🤖', // \U0001F916
+        },
+        features,
+    };
+}
+export function generateFeatures(repoName, description, features) {
+    const content = {
+        title: prettify(repoName, { mode: 'capitalize', replaceDash: true }),
+        details: description,
+        link: `/${repoName}/readme`,
+    };
+    return features ? [...features, content] : [content];
+}
+export function generateSidebarProject(repoName, sidebarPages) {
+    return {
+        text: prettify(repoName, { mode: 'capitalize', replaceDash: true }),
+        collapsed: true,
+        items: sidebarPages,
+    };
+}
+export function generateSidebarPages(repoName, fileName, sidebarPages) {
+    const content = {
+        text: fileName === 'readme' ? 'Introduction' : prettify(fileName, { mode: 'capitalize', replaceDash: true }),
+        link: `/${repoName}/${fileName}`,
+    };
+    return sidebarPages ? [...sidebarPages, content] : [content];
+}
+export function transformDoc(repositories, user) {
+    const features = [];
+    const sidebar = [];
+    for (const repository of repositories) {
+        getMdFiles([repository.docpress.projectPath]).forEach((file) => {
+            replaceRelativePath(file, `https://github.com/${repository.owner.login}/${repository.name}/tree/${repository.docpress.branch}`);
+            if (basename(file).toLowerCase() === 'readme.md') {
+                replaceReadmePath(file, `https://github.com/${repository.owner.login}/${repository.name}/tree/${repository.docpress.branch}`);
+            }
+        });
+        const sidebarItems = readdirSync(repository.docpress.projectPath)
+            .filter((file) => {
+            return statSync(resolve(repository.docpress.projectPath, file)).isFile()
+                && basename(resolve(repository.docpress.projectPath, file)).endsWith('.md');
+        })
+            .sort((a, b) => a.localeCompare(b))
+            .reduce((acc, cur, idx, arr) => {
+            const file = resolve(repository.docpress.projectPath, cur);
+            const filename = prettify(basename(file), { mode: 'lowercase', removeIdx: true });
+            if (filename !== basename(file)) {
+                renameSync(file, resolve(dirname(file), filename));
+            }
+            if (idx === arr.length - 1) {
+                let sourceFile;
+                if (arr.length > 1) {
+                    sourceFile = resolve(repository.docpress.projectPath, 'sources.md');
+                    addSources(repository.html_url, sourceFile);
+                    return generateSidebarPages(repository.name, parse(sourceFile).name, generateSidebarPages(repository.name, parse(filename).name, acc));
+                }
+                sourceFile = resolve(repository.docpress.projectPath, 'readme.md');
+                addSources(repository.html_url, sourceFile);
+            }
+            return generateSidebarPages(repository.name, parse(filename).name, acc);
+        }, []);
+        sidebar.push(generateSidebarProject(repository.name, sidebarItems));
+        features.push(...generateFeatures(repository.name, repository.description || ''));
+    }
+    const index = generateIndex(features.sort((a, b) => a.title.localeCompare(b.title)), user);
+    return {
+        sidebar: sidebar.sort((a, b) => a.text.localeCompare(b.text)),
+        index,
+    };
+}
+export function addExtraPages(paths) {
+    const files = getMdFiles(paths);
+    const nav = [];
+    for (const file of files) {
+        const src = resolve(process.cwd(), file);
+        const dest = resolve(DOCS_DIR, prettify(basename(file), { mode: 'lowercase', removeIdx: true }));
+        cpSync(src, dest);
+        nav.push({
+            text: prettify(parse(src).name, { replaceDash: true, removeIdx: true }),
+            link: `/${prettify(parse(src).name, { removeIdx: true })}`,
+        });
+    }
+    return nav;
+}
+export function addContent(path, dir, fn) {
+    const files = extractFiles(path);
+    for (const file of files) {
+        const src = resolve(process.cwd(), file);
+        const dest = resolve(dir, basename(file));
+        if (fn) {
+            fn();
+        }
+        cpSync(src, dest);
+    }
+}
+export function parseVitepressConfig(path) {
+    return JSON.parse(readFileSync(resolve(process.cwd(), path)).toString());
+}
+export function generateVitepressFiles(vitepressConfig, index) {
+    createDir(dirname(VITEPRESS_CONFIG));
+    writeFileSync(VITEPRESS_CONFIG, `import { defineConfig } from 'vitepress'\n\nexport default defineConfig(${JSON.stringify(vitepressConfig, null, 2)})\n`);
+    writeFileSync(INDEX_FILE, '---\n'.concat(YAML.stringify(index)));
+}
+//# sourceMappingURL=prepare.js.map

package/dist/lib/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","sourceRoot":"","sources":["../../src/lib/prepare.ts"],"names":[],"mappings":"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"}

package/dist/lib/vitepress.js

@@ -0,0 +1,50 @@
+import { deepMerge } from '../utils/functions.js';
+const defaultVitepressConfig = {
+    base: '/',
+    lang: 'en-US',
+    vite: {
+        publicDir: '../public',
+    },
+    title: 'Home',
+    description: 'Docpress',
+    srcDir: './docs',
+    cleanUrls: true,
+    ignoreDeadLinks: 'localhostLinks',
+    themeConfig: {
+        outline: [2, 3],
+        search: {
+            provider: 'local',
+            options: {
+                translations: {
+                    button: {
+                        buttonText: 'Search...',
+                        buttonAriaLabel: 'Search',
+                    },
+                    modal: {
+                        backButtonTitle: 'erase search',
+                        displayDetails: 'show details',
+                        noResultsText: 'No results for : ',
+                        resetButtonTitle: 'cancel search',
+                        footer: {
+                            selectText: 'go to',
+                            navigateText: 'navigate in results',
+                            closeText: 'close',
+                        },
+                    },
+                },
+            },
+        },
+    },
+};
+export function getVitepressConfig(sidebar, nav, vitepressConfig) {
+    const mergedConfig = deepMerge(defaultVitepressConfig, vitepressConfig ?? {});
+    return {
+        ...mergedConfig,
+        themeConfig: {
+            ...mergedConfig.themeConfig,
+            sidebar,
+            nav,
+        },
+    };
+}
+//# sourceMappingURL=vitepress.js.map

package/dist/lib/vitepress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitepress.js","sourceRoot":"","sources":["../../src/lib/vitepress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGjD,MAAM,sBAAsB,GAAoC;IAC9D,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,OAAO;IACb,IAAI,EAAE;QACJ,SAAS,EAAE,WAAW;KACvB;IACD,KAAK,EAAE,MAAM;IACb,WAAW,EAAE,UAAU;IACvB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,IAAI;IACf,eAAe,EAAE,gBAAgB;IACjC,WAAW,EAAE;QACX,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACf,MAAM,EAAE;YACN,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE;gBACP,YAAY,EAAE;oBACZ,MAAM,EAAE;wBACN,UAAU,EAAE,WAAW;wBACvB,eAAe,EAAE,QAAQ;qBAC1B;oBACD,KAAK,EAAE;wBACL,eAAe,EAAE,cAAc;wBAC/B,cAAc,EAAE,cAAc;wBAC9B,aAAa,EAAE,mBAAmB;wBAClC,gBAAgB,EAAE,eAAe;wBACjC,MAAM,EAAE;4BACN,UAAU,EAAE,OAAO;4BACnB,YAAY,EAAE,qBAAqB;4BACnC,SAAS,EAAE,OAAO;yBACnB;qBACF;iBACF;aACF;SACF;KACF;CACF,CAAA;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAyB,EAAE,GAAW,EAAE,eAAiD;IAC1H,MAAM,YAAY,GAAG,SAAS,CAAC,sBAAsB,EAAE,eAAe,IAAI,EAAE,CAAC,CAAA;IAE7E,OAAO;QACL,GAAG,YAAY;QACf,WAAW,EAAE;YACX,GAAG,YAAY,CAAC,WAAW;YAC3B,OAAO;YACP,GAAG;SACJ;KACF,CAAA;AACH,CAAC"}

package/dist/schemas/build.js

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export const buildOptsSchema = z.object({});
+//# sourceMappingURL=build.js.map

package/dist/schemas/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/schemas/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA"}

package/dist/schemas/fetch.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import { prettifyEnum } from '../utils/functions.js';
+const providers = ['github', 'gitlab'];
+export const fetchOptsSchema = z.object({
+    branch: z.string()
+        .describe('Branch used to collect Git provider data.')
+        .optional()
+        .default('main'),
+    gitProvider: z.enum(providers)
+        .describe(`Git provider used to retrieve data. Values should be one of ${prettifyEnum(providers)}.`)
+        .optional()
+        .default('github'),
+    reposFilter: z.string()
+        .transform(repos => repos.split(','))
+        .or(z.string().array())
+        .describe('List of comma separated repositories to retrieve from Git provider. Default to all user\'s public repositories.')
+        .optional(),
+    token: z.string()
+        .describe('Git provider token used to collect data.')
+        .optional(),
+    username: z.string()
+        .describe('Git provider username used to collect data.'),
+});
+//# sourceMappingURL=fetch.js.map

package/dist/schemas/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/schemas/fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEpD,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,2CAA2C,CAAC;SACrD,QAAQ,EAAE;SACV,OAAO,CAAC,MAAM,CAAC;IAClB,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;SAC3B,QAAQ,CAAC,+DAA+D,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC;SACnG,QAAQ,EAAE;SACV,OAAO,CAAC,QAAQ,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;SACpB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;SACtB,QAAQ,CAAC,iHAAiH,CAAC;SAC3H,QAAQ,EAAE;IACb,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;SACd,QAAQ,CAAC,0CAA0C,CAAC;SACpD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,QAAQ,CAAC,6CAA6C,CAAC;CAC3D,CAAC,CAAA"}

package/dist/schemas/global.js

@@ -0,0 +1,16 @@
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { z } from 'zod';
+import { buildOptsSchema } from './build.js';
+import { fetchOptsSchema } from './fetch.js';
+import { prepareOptsSchema } from './prepare.js';
+export const globalOptsSchema = z.object({
+    config: z.string()
+        .describe('Path to the docpress configuration file.')
+        .transform(path => JSON.parse(readFileSync(resolve(process.cwd(), path)).toString()))
+        .optional(),
+});
+export const configSchema = fetchOptsSchema
+    .merge(prepareOptsSchema)
+    .merge(buildOptsSchema);
+//# sourceMappingURL=global.js.map

package/dist/schemas/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../src/schemas/global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACf,QAAQ,CAAC,0CAA0C,CAAC;SACpD,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAA4B,CAAC;SAC/G,QAAQ,EAAE;CACd,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,YAAY,GAAG,eAAe;KACxC,KAAK,CAAC,iBAAiB,CAAC;KACxB,KAAK,CAAC,eAAe,CAAC,CAAA"}