boltdocs 1.0.1 → 1.3.0

package/dist/node/index.mjs

@@ -1,9 +1,15 @@
 import {
-  CONFIG_FILES,
-  init_config,
-  resolveConfig
-} from "../chunk-X2TDGMTR.mjs";
-import "../chunk-X6BYQHVC.mjs";
+  FileCache,
+  TransformCache,
+  capitalize,
+  escapeHtml,
+  extractNumberPrefix,
+  fileToRoutePath,
+  isDocFile,
+  normalizePath,
+  parseFrontmatter,
+  stripNumberPrefix
+} from "../chunk-GSYECEZY.mjs";
 
 // src/node/plugin/index.ts
 import { loadEnv } from "vite";
@@ -11,130 +17,8 @@ import { loadEnv } from "vite";
 // src/node/routes/index.ts
 import fastGlob from "fast-glob";
 
-// src/node/utils.ts
-import fs from "fs";
-import matter from "gray-matter";
-function normalizePath(p) {
-  return p.replace(/\\/g, "/");
-}
-function stripNumberPrefix(name) {
-  return name.replace(/^\d+\./, "");
-}
-function extractNumberPrefix(name) {
-  const match = name.match(/^(\d+)\./);
-  return match ? parseInt(match[1], 10) : void 0;
-}
-function isDocFile(filePath) {
-  return /\.mdx?$/.test(filePath);
-}
-function getFileMtime(filePath) {
-  try {
-    return fs.statSync(filePath).mtimeMs;
-  } catch {
-    return 0;
-  }
-}
-function parseFrontmatter(filePath) {
-  const raw = fs.readFileSync(filePath, "utf-8");
-  const { data, content } = matter(raw);
-  return { data, content };
-}
-function escapeHtml(str) {
-  return str.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-}
-function fileToRoutePath(relativePath) {
-  let cleanedPath = relativePath.split("/").map(stripNumberPrefix).join("/");
-  let routePath = cleanedPath.replace(/\.mdx?$/, "");
-  if (routePath === "index" || routePath.endsWith("/index")) {
-    routePath = routePath.replace(/index$/, "");
-  }
-  if (!routePath.startsWith("/")) {
-    routePath = "/" + routePath;
-  }
-  if (routePath.length > 1 && routePath.endsWith("/")) {
-    routePath = routePath.slice(0, -1);
-  }
-  return routePath;
-}
-function capitalize(str) {
-  return str.charAt(0).toUpperCase() + str.slice(1);
-}
-
-// src/node/cache.ts
-var FileCache = class {
-  entries = /* @__PURE__ */ new Map();
-  /**
-   * Retrieves parsed data for a file from the cache.
-   * Compares the current filesystem mtime with the cached mtime.
-   *
-   * @param filePath - The absolute path of the file
-   * @returns The cached data if valid, or `null` if the file has changed or doesn't exist
-   */
-  get(filePath) {
-    const entry = this.entries.get(filePath);
-    if (!entry) return null;
-    const currentMtime = getFileMtime(filePath);
-    if (currentMtime !== entry.mtime) return null;
-    return entry.data;
-  }
-  /**
-   * Stores parsed data for a file in the cache, recording its current mtime.
-   *
-   * @param filePath - The absolute path to the file
-   * @param data - The parsed data to store
-   */
-  set(filePath, data) {
-    this.entries.set(filePath, {
-      data,
-      mtime: getFileMtime(filePath)
-    });
-  }
-  /**
-   * Checks if a specific file's cache is still valid (based on its mtime).
-   *
-   * @param filePath - The absolute path to the file
-   * @returns `true` if the cache is valid, `false` otherwise
-   */
-  isValid(filePath) {
-    return this.get(filePath) !== null;
-  }
-  /**
-   * Manually removes a specific file from the cache.
-   * Useful when forcefully invalidating a single updated file.
-   *
-   * @param filePath - The absolute path to the file
-   */
-  invalidate(filePath) {
-    this.entries.delete(filePath);
-  }
-  /**
-   * Clears the entire cache, forcing all files to be re-parsed on the next request.
-   * Useful when global dependencies (like config) change.
-   */
-  invalidateAll() {
-    this.entries.clear();
-  }
-  /**
-   * Removes cached entries for files that no longer exist on the filesystem.
-   * Prevents memory leaks from deleted files.
-   *
-   * @param currentFiles - A Set of absolute file paths currently discovered on the disk
-   */
-  pruneStale(currentFiles) {
-    for (const key of this.entries.keys()) {
-      if (!currentFiles.has(key)) {
-        this.entries.delete(key);
-      }
-    }
-  }
-  /** Number of cached entries */
-  get size() {
-    return this.entries.size;
-  }
-};
-
 // src/node/routes/cache.ts
-var docCache = new FileCache();
+var docCache = new FileCache({ name: "routes" });
 function invalidateRouteCache() {
   docCache.invalidateAll();
 }
@@ -247,6 +131,7 @@ function compareByGroupPosition(a, b) {
 
 // src/node/routes/index.ts
 async function generateRoutes(docsDir, config, basePath = "/docs") {
+  docCache.load();
   const files = await fastGlob(["**/*.md", "**/*.mdx"], {
     cwd: docsDir,
     absolute: true
@@ -255,15 +140,25 @@ async function generateRoutes(docsDir, config, basePath = "/docs") {
   if (config?.i18n) {
     docCache.invalidateAll();
   }
+  let cacheHits = 0;
   const parsed = await Promise.all(
     files.map(async (file) => {
       const cached = docCache.get(file);
-      if (cached) return cached;
+      if (cached) {
+        cacheHits++;
+        return cached;
+      }
       const result = parseDocFile(file, docsDir, basePath, config);
       docCache.set(file, result);
       return result;
     })
   );
+  if (files.length > 0) {
+    console.log(
+      `[boltdocs] Routes generated: ${files.length} files (${cacheHits} from cache, ${files.length - cacheHits} parsed)`
+    );
+  }
+  docCache.save();
   const groupMeta = /* @__PURE__ */ new Map();
   for (const p of parsed) {
     if (p.relativeDir) {
@@ -338,12 +233,60 @@ async function generateRoutes(docsDir, config, basePath = "/docs") {
 }
 
 // src/node/plugin/index.ts
-init_config();
 import { ViteImageOptimizer } from "vite-plugin-image-optimizer";
 
+// src/node/config.ts
+import path2 from "path";
+import { pathToFileURL } from "url";
+import fs from "fs";
+var CONFIG_FILES = [
+  "boltdocs.config.js",
+  "boltdocs.config.mjs",
+  "boltdocs.config.ts"
+];
+async function resolveConfig(docsDir) {
+  const projectRoot = process.cwd();
+  const defaults = {
+    docsDir: path2.resolve(docsDir),
+    themeConfig: {
+      title: "Boltdocs",
+      description: "A Vite documentation framework",
+      navbar: [
+        { text: "Home", link: "/" },
+        { text: "Documentation", link: "/docs" }
+      ]
+    }
+  };
+  for (const filename of CONFIG_FILES) {
+    const configPath = path2.resolve(projectRoot, filename);
+    if (fs.existsSync(configPath)) {
+      try {
+        const fileUrl = pathToFileURL(configPath).href + "?t=" + Date.now();
+        const mod = await import(fileUrl);
+        const userConfig = mod.default || mod;
+        const userThemeConfig = userConfig.themeConfig || userConfig;
+        return {
+          docsDir: path2.resolve(docsDir),
+          themeConfig: {
+            ...defaults.themeConfig,
+            ...userThemeConfig
+          },
+          i18n: userConfig.i18n,
+          versions: userConfig.versions,
+          siteUrl: userConfig.siteUrl,
+          plugins: userConfig.plugins || []
+        };
+      } catch (e) {
+        console.warn(`[boltdocs] Failed to load config from ${filename}:`, e);
+      }
+    }
+  }
+  return defaults;
+}
+
 // src/node/ssg/index.ts
 import fs2 from "fs";
-import path2 from "path";
+import path3 from "path";
 import { fileURLToPath } from "url";
 import { createRequire } from "module";
 
@@ -407,14 +350,14 @@ ${entries.map(
 
 // src/node/ssg/index.ts
 var _filename = fileURLToPath(import.meta.url);
-var _dirname = path2.dirname(_filename);
+var _dirname = path3.dirname(_filename);
 var _require = createRequire(import.meta.url);
 async function generateStaticPages(options) {
   const { docsDir, outDir, config } = options;
   const routes = await generateRoutes(docsDir, config);
   const siteTitle = config?.themeConfig?.title || "Boltdocs";
   const siteDescription = config?.themeConfig?.description || "";
-  const ssrModulePath = path2.resolve(_dirname, "../client/ssr.js");
+  const ssrModulePath = path3.resolve(_dirname, "../client/ssr.js");
   if (!fs2.existsSync(ssrModulePath)) {
     console.error(
       "[boltdocs] SSR module not found at",
@@ -424,7 +367,7 @@ async function generateStaticPages(options) {
     return;
   }
   const { render } = _require(ssrModulePath);
-  const templatePath = path2.join(outDir, "index.html");
+  const templatePath = path3.join(outDir, "index.html");
   if (!fs2.existsSync(templatePath)) {
     console.warn("[boltdocs] No index.html found in outDir, skipping SSG.");
     return;
@@ -455,10 +398,10 @@ async function generateStaticPages(options) {
           title: escapeHtml(pageTitle),
           description: escapeHtml(pageDescription)
         }).replace("<!--app-html-->", appHtml).replace(`<div id="root"></div>`, `<div id="root">${appHtml}</div>`);
-        const routeDir = path2.join(outDir, route.path);
+        const routeDir = path3.join(outDir, route.path);
         await fs2.promises.mkdir(routeDir, { recursive: true });
         await fs2.promises.writeFile(
-          path2.join(routeDir, "index.html"),
+          path3.join(routeDir, "index.html"),
           html,
           "utf-8"
         );
@@ -471,14 +414,16 @@ async function generateStaticPages(options) {
     routes.map((r) => r.path),
     config
   );
-  fs2.writeFileSync(path2.join(outDir, "sitemap.xml"), sitemap, "utf-8");
+  fs2.writeFileSync(path3.join(outDir, "sitemap.xml"), sitemap, "utf-8");
   console.log(
     `[boltdocs] Generated ${routes.length} static pages + sitemap.xml`
   );
+  const { flushCache } = await import("../cache-EHR7SXRU.mjs");
+  await flushCache();
 }
 
 // src/node/plugin/index.ts
-import path3 from "path";
+import path4 from "path";
 
 // src/node/plugin/entry.ts
 function generateEntryCode(options, config) {
@@ -489,8 +434,8 @@ function generateEntryCode(options, config) {
   const componentImports = pluginComponents.map(
     ([
       name,
-      path4
-    ]) => `import * as _comp_${name} from '${normalizePath(path4)}';
+      path5
+    ]) => `import * as _comp_${name} from '${normalizePath(path5)}';
 const ${name} = _comp_${name}.default || _comp_${name}['${name}'] || _comp_${name};`
   ).join("\n");
   const componentMap = pluginComponents.map(([name]) => name).join(", ");
@@ -560,7 +505,7 @@ ${themeScript}  </head>`);
 
 // src/node/plugin/index.ts
 function boltdocsPlugin(options = {}, passedConfig) {
-  const docsDir = path3.resolve(process.cwd(), options.docsDir || "docs");
+  const docsDir = path4.resolve(process.cwd(), options.docsDir || "docs");
   const normalizedDocsDir = normalizePath(docsDir);
   let config = passedConfig;
   let viteConfig;
@@ -590,7 +535,7 @@ function boltdocsPlugin(options = {}, passedConfig) {
       },
       configureServer(server) {
         const configPaths = CONFIG_FILES.map(
-          (c) => path3.resolve(process.cwd(), c)
+          (c) => path4.resolve(process.cwd(), c)
         );
         server.watcher.add(configPaths);
         const handleFileEvent = async (file, type) => {
@@ -653,8 +598,10 @@ function boltdocsPlugin(options = {}, passedConfig) {
       },
       async closeBundle() {
         if (!isBuild) return;
-        const outDir = viteConfig?.build?.outDir ? path3.resolve(viteConfig.root, viteConfig.build.outDir) : path3.resolve(process.cwd(), "dist");
+        const outDir = viteConfig?.build?.outDir ? path4.resolve(viteConfig.root, viteConfig.build.outDir) : path4.resolve(process.cwd(), "dist");
         await generateStaticPages({ docsDir, outDir, config });
+        const { flushCache } = await import("../cache-EHR7SXRU.mjs");
+        await flushCache();
       }
     },
     ViteImageOptimizer({
@@ -684,10 +631,13 @@ import remarkGfm from "remark-gfm";
 import remarkFrontmatter from "remark-frontmatter";
 import rehypeSlug from "rehype-slug";
 import rehypePrettyCode from "rehype-pretty-code";
+import crypto from "crypto";
+var mdxCache = new TransformCache("mdx");
+var mdxCacheLoaded = false;
 function boltdocsMdxPlugin(config) {
   const extraRemarkPlugins = config?.plugins?.flatMap((p) => p.remarkPlugins || []) || [];
   const extraRehypePlugins = config?.plugins?.flatMap((p) => p.rehypePlugins || []) || [];
-  return mdxPlugin({
+  const baseMdxPlugin = mdxPlugin({
     remarkPlugins: [remarkGfm, remarkFrontmatter, ...extraRemarkPlugins],
     rehypePlugins: [
       rehypeSlug,
@@ -695,19 +645,66 @@ function boltdocsMdxPlugin(config) {
       [
         rehypePrettyCode,
         {
-          theme: "one-dark-pro",
+          theme: config?.themeConfig?.codeTheme || "one-dark-pro",
           keepBackground: false
         }
       ]
     ],
-    // Provide React as default for JSX
     jsxRuntime: "automatic",
     providerImportSource: "@mdx-js/react"
   });
+  return {
+    ...baseMdxPlugin,
+    name: "vite-plugin-boltdocs-mdx",
+    async buildStart() {
+      hits = 0;
+      total = 0;
+      if (!mdxCacheLoaded) {
+        mdxCache.load();
+        mdxCacheLoaded = true;
+      }
+      if (baseMdxPlugin.buildStart) {
+        await baseMdxPlugin.buildStart.call(this);
+      }
+    },
+    async transform(code, id, options) {
+      if (!id.endsWith(".md") && !id.endsWith(".mdx")) {
+        return baseMdxPlugin.transform?.call(this, code, id, options);
+      }
+      total++;
+      const contentHash = crypto.createHash("md5").update(code).digest("hex");
+      const cacheKey = `${id}:${contentHash}`;
+      const cached = mdxCache.get(cacheKey);
+      if (cached) {
+        hits++;
+        return { code: cached, map: null };
+      }
+      const result = await baseMdxPlugin.transform.call(
+        this,
+        code,
+        id,
+        options
+      );
+      if (result && typeof result === "object" && result.code) {
+        mdxCache.set(cacheKey, result.code);
+      } else if (typeof result === "string") {
+        mdxCache.set(cacheKey, result);
+      }
+      return result;
+    },
+    async buildEnd() {
+      mdxCache.save();
+      await mdxCache.flush();
+      if (baseMdxPlugin.buildEnd) {
+        await baseMdxPlugin.buildEnd.call(this);
+      }
+    }
+  };
 }
+var hits = 0;
+var total = 0;
 
 // src/node/index.ts
-init_config();
 async function boltdocs(options) {
   const docsDir = options?.docsDir || "docs";
   const config = await resolveConfig(docsDir);

package/dist/{index-CRQKWAeo.d.mts → types-CvrzTbEX.d.mts}

@@ -1,10 +1,5 @@
 import React from 'react';
 
-declare global {
-    interface ImportMeta {
-        env: Record<string, any>;
-    }
-}
 /**
  * Metadata provided by the server for a specific route.
  * Maps closely to the `RouteMeta` type in the Node environment.
@@ -56,27 +51,5 @@ interface CreateBoltdocsAppOptions {
     /** Optional custom MDX components provided by plugins */
     components?: Record<string, React.ComponentType<any>>;
 }
-/**
- * Creates and mounts the Boltdocs documentation app.
- *
- * Usage:
- * ```tsx
- * import { createBoltdocsApp } from 'boltdocs/client'
- * import routes from 'virtual:boltdocs-routes'
- * import config from 'virtual:boltdocs-config'
- * import 'boltdocs/style.css'
- * import HomePage from './HomePage'
- *
- * createBoltdocsApp({
- *   target: '#root',
- *   routes,
- *   config,
- *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
- *   hot: import.meta.hot,
- *   homePage: HomePage,
- * })
- * ```
- */
-declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
 
-export { type ComponentRoute as C, type CreateBoltdocsAppOptions as a, createBoltdocsApp as c };
+export type { CreateBoltdocsAppOptions as C, ComponentRoute as a };

package/dist/{index-CRQKWAeo.d.ts → types-CvrzTbEX.d.ts}

@@ -1,10 +1,5 @@
 import React from 'react';
 
-declare global {
-    interface ImportMeta {
-        env: Record<string, any>;
-    }
-}
 /**
  * Metadata provided by the server for a specific route.
  * Maps closely to the `RouteMeta` type in the Node environment.
@@ -56,27 +51,5 @@ interface CreateBoltdocsAppOptions {
     /** Optional custom MDX components provided by plugins */
     components?: Record<string, React.ComponentType<any>>;
 }
-/**
- * Creates and mounts the Boltdocs documentation app.
- *
- * Usage:
- * ```tsx
- * import { createBoltdocsApp } from 'boltdocs/client'
- * import routes from 'virtual:boltdocs-routes'
- * import config from 'virtual:boltdocs-config'
- * import 'boltdocs/style.css'
- * import HomePage from './HomePage'
- *
- * createBoltdocsApp({
- *   target: '#root',
- *   routes,
- *   config,
- *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
- *   hot: import.meta.hot,
- *   homePage: HomePage,
- * })
- * ```
- */
-declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
 
-export { type ComponentRoute as C, type CreateBoltdocsAppOptions as a, createBoltdocsApp as c };
+export type { CreateBoltdocsAppOptions as C, ComponentRoute as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boltdocs",
-  "version": "1.0.1",
+  "version": "1.3.0",
   "description": "A lightweight documentation generator for React projects.",
   "main": "dist/node/index.js",
   "module": "dist/node/index.mjs",
@@ -54,7 +54,7 @@
     "remark-gfm": "^4.0.1",
     "sharp": "^0.34.5",
     "shiki": "^3.23.0",
-    "svgo": "^4.0.0",
+    "svgo": "^4.0.1",
     "unist-util-visit": "^5.1.0",
     "vite": "^7.3.1",
     "vite-plugin-image-optimizer": "^2.0.3"