mintlify 3.0.7 → 3.0.9

package/bin/browser.js

@@ -0,0 +1,24 @@
+import { launch } from "puppeteer";
+export async function startBrowser() {
+    try {
+        return await launch({
+            headless: true,
+            ignoreHTTPSErrors: true,
+        });
+    }
+    catch (err) {
+        console.log("Could not create a browser instance: ", err);
+        process.exit(1);
+    }
+}
+export async function getHtmlWithPuppeteer(href) {
+    const browser = await startBrowser();
+    const page = await browser.newPage();
+    await page.goto(href, {
+        waitUntil: "networkidle2",
+    });
+    const html = await page.content();
+    browser.close();
+    return html;
+}
+//# sourceMappingURL=browser.js.map

package/bin/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI;QACF,OAAO,MAAM,MAAM,CAAC;YAClB,QAAQ,EAAE,IAAI;YACd,iBAAiB,EAAE,IAAI;SACxB,CAAC,CAAC;KACJ;IAAC,OAAO,GAAG,EAAE;QACZ,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY;IACrD,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,SAAS,EAAE,cAAc;KAC1B,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/bin/constants.js

@@ -0,0 +1,31 @@
+import path from "path";
+import * as url from "url";
+import os from "os";
+// Change this to bump to a newer version of mint's client
+export const TARGET_MINT_VERSION = "v0.0.4";
+// package installation location
+export const INSTALL_PATH = url.fileURLToPath(new URL(".", import.meta.url));
+export const HOME_DIR = os.homedir();
+export const DOT_MINTLIFY = path.join(HOME_DIR, ".mintlify");
+export const VERSION_PATH = path.join(DOT_MINTLIFY, "mint", "mint-version.txt");
+export const CLIENT_PATH = path.join(DOT_MINTLIFY, "mint", "client");
+// command execution location
+export const CMD_EXEC_PATH = process.cwd();
+export const SUPPORTED_MEDIA_EXTENSIONS = [
+    "jpeg",
+    "jpg",
+    "jfif",
+    "pjpeg",
+    "pjp",
+    "png",
+    "svg",
+    "svgz",
+    "ico",
+    "webp",
+    "gif",
+    "apng",
+    "avif",
+    "bmp",
+    "mp4",
+];
+//# sourceMappingURL=constants.js.map

package/bin/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,mBAAmB,GAAG,QAAQ,CAAC;AAE5C,gCAAgC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;AAErC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAErE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE3C,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;CACN,CAAC"}

package/bin/downloadImage.js

@@ -0,0 +1,72 @@
+import { existsSync, mkdirSync, createWriteStream } from "fs";
+import path from "path";
+import axios from "axios";
+import { getFileExtension } from "./util.js";
+import { SUPPORTED_MEDIA_EXTENSIONS } from "./constants.js";
+async function writeImageToFile(imageSrc, writePath, overwrite) {
+    // Avoid unnecessary downloads
+    if (existsSync(writePath) && !overwrite) {
+        return Promise.reject({
+            code: "EEXIST",
+        });
+    }
+    // Create the folders needed if they're missing
+    mkdirSync(path.dirname(writePath), { recursive: true });
+    const writer = createWriteStream(writePath);
+    const response = await axios.get(imageSrc, {
+        responseType: "stream",
+    });
+    // wx prevents overwriting an image with the exact same name
+    // being created in the time we were downloading
+    response.data.pipe(writer, {
+        flag: "wx",
+    });
+    return new Promise((resolve, reject) => {
+        writer.on("finish", resolve);
+        writer.on("error", reject);
+    });
+}
+export function isValidImageSrc(src) {
+    if (!src) {
+        return false;
+    }
+    // We do not support downloading base64 in-line images.
+    if (src.startsWith("data:")) {
+        return false;
+    }
+    const imageHref = removeMetadataFromImageSrc(src);
+    const ext = getFileExtension(imageHref);
+    if (!SUPPORTED_MEDIA_EXTENSIONS.includes(ext)) {
+        console.error("🚨 We do not support the file extension: " + ext);
+        return false;
+    }
+    return true;
+}
+export function removeMetadataFromImageSrc(src) {
+    // Part of the URL standard
+    const metadataSymbols = ["?", "#"];
+    metadataSymbols.forEach((dividerSymbol) => {
+        // Some frameworks add metadata after the file extension, we need to remove that.
+        src = src.split(dividerSymbol)[0];
+    });
+    return src;
+}
+export function cleanImageSrc(src, origin) {
+    // Add origin if the image tags are using relative sources
+    return src.startsWith("http") ? src : new URL(src, origin).href;
+}
+export default async function downloadImage(imageSrc, writePath, overwrite = false) {
+    await writeImageToFile(imageSrc, writePath, overwrite)
+        .then(() => {
+        console.log("🖼️ - " + writePath);
+    })
+        .catch((e) => {
+        if (e.code === "EEXIST") {
+            console.log(`❌ Skipping existing image ${writePath}`);
+        }
+        else {
+            console.error(e);
+        }
+    });
+}
+//# sourceMappingURL=downloadImage.js.map

package/bin/downloadImage.js.map

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

package/bin/index.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import yargs from "yargs";
+import { hideBin } from "yargs/helpers";
+import { scrapePageAutomatically, scrapePageWrapper, } from "./scraping/scrapePageCommands.js";
+import { scrapeGitBookPage } from "./scraping/site-scrapers/scrapeGitBookPage.js";
+import { scrapeReadMePage } from "./scraping/site-scrapers/scrapeReadMePage.js";
+import { scrapeSectionAutomatically, scrapeSectionAxiosWrapper, scrapeGitbookSectionCommand, } from "./scraping/scrapeSectionCommands.js";
+import { scrapeReadMeSection } from "./scraping/site-scrapers/scrapeReadMeSection.js";
+import dev from "./local-preview/index.js";
+import installDepsCommand from "./local-preview/helper-commands/installDepsCommand.js";
+yargs(hideBin(process.argv))
+    .command("dev", "Runs Mintlify locally (Must run in directory with mint.json)", () => { }, async (argv) => {
+    await dev(argv);
+})
+    .command("install", "Install dependencies for local Mintlify", () => { }, installDepsCommand)
+    .command("scrape-page [url]", "Scrapes a page", () => { }, async (argv) => {
+    await scrapePageAutomatically(argv);
+})
+    .command("scrape-gitbook-page [url]", "Scrapes a GitBook page", () => { }, async (argv) => {
+    await scrapePageWrapper(argv, scrapeGitBookPage);
+})
+    .command("scrape-readme-page [url]", "Scrapes a ReadMe page", () => { }, async (argv) => {
+    await scrapePageWrapper(argv, scrapeReadMePage);
+})
+    .command("scrape-section [url]", "Scrapes the docs in the section", () => { }, async (argv) => {
+    await scrapeSectionAutomatically(argv);
+})
+    .command("scrape-gitbook-section [url]", "Scrapes the Gitbook section", () => { }, async (argv) => {
+    await scrapeGitbookSectionCommand(argv);
+})
+    .command("scrape-readme-section [url]", "Scrapes the ReadMe section", () => { }, async (argv) => {
+    await scrapeSectionAxiosWrapper(argv, scrapeReadMeSection);
+})
+    // Print the help menu when the user enters an invalid command.
+    .demandCommand(1, "Unknown command. See above for the list of supported commands.")
+    // Alias option flags --help = -h, --version = -v
+    .alias("h", "help")
+    .alias("v", "version")
+    .parse();
+//# sourceMappingURL=index.js.map

package/bin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AAChF,OAAO,EACL,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iDAAiD,CAAC;AACtF,OAAO,GAAG,MAAM,0BAA0B,CAAC;AAC3C,OAAO,kBAAkB,MAAM,uDAAuD,CAAC;AAEvF,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;KACzB,OAAO,CACN,KAAK,EACL,8DAA8D,EAC9D,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC,CACF;KACA,OAAO,CACN,SAAS,EACT,yCAAyC,EACzC,GAAG,EAAE,GAAE,CAAC,EACR,kBAAkB,CACnB;KACA,OAAO,CACN,mBAAmB,EACnB,gBAAgB,EAChB,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC,CACF;KACA,OAAO,CACN,2BAA2B,EAC3B,wBAAwB,EACxB,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACnD,CAAC,CACF;KACA,OAAO,CACN,0BAA0B,EAC1B,uBAAuB,EACvB,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AAClD,CAAC,CACF;KACA,OAAO,CACN,sBAAsB,EACtB,iCAAiC,EACjC,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,0BAA0B,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC,CACF;KACA,OAAO,CACN,8BAA8B,EAC9B,6BAA6B,EAC7B,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC,CACF;KACA,OAAO,CACN,6BAA6B,EAC7B,4BAA4B,EAC5B,GAAG,EAAE,GAAE,CAAC,EACR,KAAK,EAAE,IAAI,EAAE,EAAE;IACb,MAAM,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;AAC7D,CAAC,CACF;IAED,+DAA+D;KAC9D,aAAa,CACZ,CAAC,EACD,gEAAgE,CACjE;IAED,iDAAiD;KAChD,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC;KAClB,KAAK,CAAC,GAAG,EAAE,SAAS,CAAC;KAErB,KAAK,EAAE,CAAC"}

package/bin/local-preview/helper-commands/installDepsCommand.js

@@ -0,0 +1,12 @@
+import shell from "shelljs";
+import { CLIENT_PATH } from "../../constants.js";
+import { buildLogger, ensureYarn } from "../../util.js";
+const installDeps = async () => {
+    const logger = buildLogger("");
+    ensureYarn(logger);
+    shell.cd(CLIENT_PATH);
+    shell.exec("yarn");
+    logger.succeed("Dependencies installed.");
+};
+export default installDeps;
+//# sourceMappingURL=installDepsCommand.js.map

package/bin/local-preview/helper-commands/installDepsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installDepsCommand.js","sourceRoot":"","sources":["../../../src/local-preview/helper-commands/installDepsCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,SAAS,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,WAAW,GAAG,KAAK,IAAI,EAAE;IAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC/B,UAAU,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/bin/local-preview/index.js

@@ -0,0 +1,154 @@
+import Chalk from "chalk";
+import child_process from "child_process";
+import open from "open";
+import fse, { pathExists } from "fs-extra";
+import inquirer from "inquirer";
+import { isInternetAvailable } from "is-internet-available";
+import path from "path";
+import shell from "shelljs";
+import { Octokit } from "@octokit/rest";
+import { CLIENT_PATH, HOME_DIR, DOT_MINTLIFY, CMD_EXEC_PATH, TARGET_MINT_VERSION, VERSION_PATH, } from "../constants.js";
+import { buildLogger, ensureYarn } from "../util.js";
+import listener from "./listener/index.js";
+const shellExec = (cmd) => {
+    return shell.exec(cmd, { silent: true });
+};
+const nodeModulesExists = async () => {
+    return pathExists(path.join(DOT_MINTLIFY, "mint", "client", "node_modules"));
+};
+const promptForYarn = async () => {
+    const yarnInstalled = shell.which("yarn");
+    if (!yarnInstalled) {
+        await inquirer
+            .prompt([
+            {
+                type: "confirm",
+                name: "confirm",
+                message: "yarn must be globally installed. Install yarn?",
+                default: true,
+            },
+        ])
+            .then(({ confirm }) => {
+            if (confirm) {
+                shell.exec("npm install --global yarn");
+            }
+            else {
+                console.log("Installation cancelled.");
+            }
+        });
+    }
+};
+const dev = async (argv) => {
+    shell.cd(HOME_DIR);
+    await promptForYarn();
+    const logger = buildLogger("Preparing local Mintlify instance...");
+    await fse.ensureDir(path.join(DOT_MINTLIFY, "mint"));
+    const MINT_PATH = path.join(DOT_MINTLIFY, "mint");
+    shell.cd(MINT_PATH);
+    // The CLI can only run offline if Mint was already downloaded
+    const internet = await isInternetAvailable();
+    if (!internet && !(await pathExists(CLIENT_PATH))) {
+        logger.fail("Running mintlify dev for the first time requires an internet connection.");
+        process.exit(1);
+    }
+    // Avoid checking if we are on the target Mint if we are offline
+    if (internet) {
+        const mintVersionExists = await pathExists(VERSION_PATH);
+        // We always download the target version of Mintlify if the mint-version.txt file doesn't exist.
+        // We do this because users updating from an older version of the CLI never have mint-version.txt set.
+        let downloadTargetMint = !mintVersionExists;
+        // Download target mint if the current version is different. Keep in mind this also allows
+        // downgrading to an older version of Mintlify by installing an older CLI version.
+        if (mintVersionExists) {
+            const currVersion = fse.readFileSync(VERSION_PATH, "utf8");
+            if (currVersion !== TARGET_MINT_VERSION) {
+                downloadTargetMint = true;
+            }
+        }
+        if (downloadTargetMint) {
+            // Delete any existing contents
+            fse.emptyDirSync(MINT_PATH);
+            logger.text = "Downloading Mintlify framework...";
+            const octokit = new Octokit();
+            const downloadRes = await octokit.repos.downloadTarballArchive({
+                owner: "mintlify",
+                repo: "mint",
+                ref: TARGET_MINT_VERSION,
+            });
+            logger.text = "Extracting Mintlify framework...";
+            const TAR_PATH = path.join(MINT_PATH, "mint.tar.gz");
+            // Unzip tar file
+            fse.writeFileSync(TAR_PATH, Buffer.from(downloadRes.data));
+            shellExec("tar -xzf mint.tar.gz");
+            // List all files in tar file and get the first one.
+            // There is never anything else in the tar file, so this is safe.
+            // We do this because the folder name includes the commit sha, so we can't hardcode it.
+            // Lastly, we call .trim() to remove the newline character.
+            const extractedFolderName = shellExec('tar -tzf mint.tar.gz | head -1 | cut -f1 -d"/"').stdout.trim();
+            // Delete tar file
+            fse.removeSync(TAR_PATH);
+            fse.moveSync(path.join(MINT_PATH, extractedFolderName, "client"), path.join(CLIENT_PATH));
+            // Store the currently downloaded version
+            fse.writeFileSync(VERSION_PATH, TARGET_MINT_VERSION);
+            // Delete unnecessary contents downloaded from GitHub
+            fse.removeSync(path.join(MINT_PATH, extractedFolderName));
+            logger.text = "Installing dependencies...";
+            ensureYarn(logger);
+            shell.cd(CLIENT_PATH);
+            shellExec("yarn");
+        }
+    }
+    if (!(await nodeModulesExists())) {
+        if (!internet) {
+            logger.fail(`Dependencies are missing and you are offline. Connect to the internet and run
+  
+      mintlify install
+      
+      `);
+        }
+        else {
+            logger.fail(`Dependencies were not installed correctly, run
+  
+      mintlify install
+      
+      `);
+        }
+        process.exit(1);
+    }
+    const relativePath = path.relative(CLIENT_PATH, CMD_EXEC_PATH);
+    shellExec(`yarn preconfigure ${relativePath}`);
+    logger.succeed("Local Mintlify instance is ready. Launching your site now.");
+    run(argv.port || "3000");
+};
+const run = (port) => {
+    shell.cd(CLIENT_PATH);
+    // next-remote-watch can only receive ports as env variables
+    // https://github.com/hashicorp/next-remote-watch/issues/23
+    const mintlifyDevProcess = child_process.spawn("npm run dev-watch", {
+        env: {
+            ...process.env,
+            PORT: port,
+        },
+        cwd: CLIENT_PATH,
+        stdio: "pipe",
+        shell: true,
+    });
+    mintlifyDevProcess.stdout.on("data", (data) => {
+        const output = data.toString();
+        console.log(output);
+        if (output.startsWith("> Ready on http://localhost:")) {
+            console.log(`🌿 ${Chalk.green(`Your local preview is available at http://localhost:${port}`)}`);
+            console.log(`🌿 ${Chalk.green("Press Ctrl+C any time to stop the local preview.")}`);
+            open(`http://localhost:${port}`);
+        }
+    });
+    const onExit = () => {
+        mintlifyDevProcess.kill("SIGINT");
+        process.exit(0);
+    };
+    process.on("SIGINT", onExit);
+    process.on("SIGTERM", onExit);
+    listener();
+};
+export default dev;
+//# sourceMappingURL=index.js.map

package/bin/local-preview/index.js.map

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

package/bin/local-preview/listener/categorize.js

@@ -0,0 +1,97 @@
+// TODO - put in prebuild package
+import path from "path";
+import { getFileExtension, openApiCheck, getFileList } from "./utils.js";
+export const categorizeFiles = async (contentDirectoryPath) => {
+    const allFilesInCmdExecutionPath = await getFileList(contentDirectoryPath);
+    const contentFilenames = [];
+    const staticFilenames = [];
+    const promises = [];
+    const openApiFiles = [];
+    const snippets = [];
+    allFilesInCmdExecutionPath.forEach((filename) => {
+        promises.push((async () => {
+            const extension = getFileExtension(filename);
+            let isOpenApi = false;
+            if (extension && (extension === "mdx" || extension === "md")) {
+                if (filename.startsWith("/_snippets")) {
+                    snippets.push(filename);
+                }
+                else {
+                    contentFilenames.push(filename);
+                }
+            }
+            else if (extension &&
+                (extension === "json" || extension === "yaml" || extension === "yml")) {
+                const openApiInfo = await openApiCheck(path.join(contentDirectoryPath, filename));
+                isOpenApi = openApiInfo.isOpenApi;
+                if (isOpenApi) {
+                    const fileName = path.parse(filename).base;
+                    openApiFiles.push({
+                        filename: fileName.substring(0, fileName.lastIndexOf(".")),
+                        spec: openApiInfo.spec,
+                    });
+                }
+            }
+            else if ((!filename.endsWith("mint.config.json") ||
+                !filename.endsWith("mint.json")) &&
+                !isOpenApi) {
+                // all other files
+                staticFilenames.push(filename);
+            }
+        })());
+    });
+    await Promise.all(promises);
+    return { contentFilenames, staticFilenames, openApiFiles, snippets };
+};
+const excludedMdFiles = ["readme", "license", "contributing", "contribute"];
+const supportedStaticFileExtensions = [
+    ".jpeg",
+    ".jpg",
+    ".jfif",
+    ".pjpeg",
+    ".pjp",
+    ".png",
+    ".svg",
+    ".svgz",
+    ".ico",
+    ".webp",
+    ".gif",
+    ".apng",
+    ".avif",
+    ".bmp",
+    ".mp4",
+];
+export const getCategory = (filePath) => {
+    filePath = filePath.toLowerCase();
+    const parsed = path.parse(filePath);
+    if (parsed.base === "mint.json") {
+        return "mintConfig";
+    }
+    const fileName = parsed.name;
+    const extension = parsed.ext;
+    if (filePath.startsWith("_snippets") &&
+        (extension === ".mdx" || extension === ".md")) {
+        return "snippet";
+    }
+    else if (extension === ".mdx") {
+        return "page";
+    }
+    else if (extension === ".md") {
+        // Exclude common markdown files people don't want on their docs website
+        if (excludedMdFiles.includes(fileName)) {
+            throw new Error("Excluded Md File");
+        }
+        return "page";
+    }
+    else if (extension === ".yaml" || extension === ".yml") {
+        return "potentialYamlOpenApiSpec";
+    }
+    else if (extension === ".json") {
+        return "potentialJsonOpenApiSpec";
+    }
+    else if (supportedStaticFileExtensions.includes(extension)) {
+        return "staticFile";
+    }
+    throw new Error("Unsupported File Type, No change enacted");
+};
+//# sourceMappingURL=categorize.js.map

package/bin/local-preview/listener/categorize.js.map

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

package/bin/local-preview/listener/generate.js

@@ -0,0 +1,89 @@
+// TODO - add types
+import { promises as _promises } from "fs";
+import { outputFile } from "fs-extra";
+import path from "path";
+import createPage from "./utils/createPage.js";
+import { categorizeFiles } from "./categorize.js";
+import { CMD_EXEC_PATH } from "../../constants.js";
+import { getConfigObj } from "./utils/mintConfigFile.js";
+const { readFile } = _promises;
+// TODO: Put in prebuild package
+const generateNavFromPages = (pages, mintConfigNav) => {
+    const createNav = (nav) => {
+        return {
+            group: nav.group,
+            version: nav.version,
+            pages: nav.pages.map((page) => {
+                if (typeof page === "string") {
+                    return pages[page];
+                }
+                return createNav(page);
+            }),
+        };
+    };
+    if (mintConfigNav == null) {
+        return;
+    }
+    let navFile = mintConfigNav.map((nav) => createNav(nav));
+    const filterOutNullInPages = (pages) => {
+        const newPages = [];
+        pages.forEach((page) => {
+            if (page == null) {
+                return;
+            }
+            if (page?.pages) {
+                const newGroup = filterOutNullInGroup(page);
+                newPages.push(newGroup);
+            }
+            else {
+                newPages.push(page);
+            }
+        });
+        return newPages;
+    };
+    const filterOutNullInGroup = (group) => {
+        const newPages = filterOutNullInPages(group.pages);
+        const newGroup = {
+            ...group,
+            pages: newPages,
+        };
+        return newGroup;
+    };
+    const newNavFile = navFile.map((group) => {
+        return filterOutNullInGroup(group);
+    });
+    return newNavFile;
+};
+// TODO: Put in prebuild package
+const createPagesAcc = async (contentDirectoryPath, contentFilenames, openApiFiles, clientPath, writeFiles = false) => {
+    let pagesAcc = {};
+    const contentPromises = [];
+    contentFilenames.forEach((filename) => {
+        contentPromises.push((async () => {
+            const sourcePath = path.join(contentDirectoryPath, filename);
+            const contentStr = (await readFile(sourcePath)).toString();
+            const { slug, pageMetadata, pageContent } = await createPage(filename, contentStr, contentDirectoryPath, openApiFiles);
+            if (clientPath && writeFiles) {
+                const targetPath = path.join(clientPath, "src", "_props", filename);
+                await outputFile(targetPath, pageContent, {
+                    flag: "w",
+                });
+            }
+            pagesAcc = {
+                ...pagesAcc,
+                [slug]: pageMetadata,
+            };
+        })());
+    });
+    await Promise.all(contentPromises);
+    return pagesAcc;
+};
+export const generateNav = async () => {
+    const { contentFilenames, openApiFiles } = await categorizeFiles(CMD_EXEC_PATH);
+    const [pageAcc, configObj] = await Promise.all([
+        createPagesAcc(CMD_EXEC_PATH, contentFilenames, openApiFiles),
+        getConfigObj(CMD_EXEC_PATH),
+    ]);
+    return generateNavFromPages(pageAcc, configObj?.navigation);
+};
+//# sourceMappingURL=generate.js.map

package/bin/local-preview/listener/generate.js.map

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