boltdocs 1.0.4 → 1.3.0

package/dist/node/index.mjs

@@ -1,133 +1,24 @@
+import {
+  FileCache,
+  TransformCache,
+  capitalize,
+  escapeHtml,
+  extractNumberPrefix,
+  fileToRoutePath,
+  isDocFile,
+  normalizePath,
+  parseFrontmatter,
+  stripNumberPrefix
+} from "../chunk-GSYECEZY.mjs";
+
 // src/node/plugin/index.ts
 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();
 }
@@ -240,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
@@ -248,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) {
@@ -336,7 +238,7 @@ import { ViteImageOptimizer } from "vite-plugin-image-optimizer";
 // src/node/config.ts
 import path2 from "path";
 import { pathToFileURL } from "url";
-import fs2 from "fs";
+import fs from "fs";
 var CONFIG_FILES = [
   "boltdocs.config.js",
   "boltdocs.config.mjs",
@@ -357,7 +259,7 @@ async function resolveConfig(docsDir) {
   };
   for (const filename of CONFIG_FILES) {
     const configPath = path2.resolve(projectRoot, filename);
-    if (fs2.existsSync(configPath)) {
+    if (fs.existsSync(configPath)) {
       try {
         const fileUrl = pathToFileURL(configPath).href + "?t=" + Date.now();
         const mod = await import(fileUrl);
@@ -383,7 +285,7 @@ async function resolveConfig(docsDir) {
 }
 
 // src/node/ssg/index.ts
-import fs3 from "fs";
+import fs2 from "fs";
 import path3 from "path";
 import { fileURLToPath } from "url";
 import { createRequire } from "module";
@@ -456,7 +358,7 @@ async function generateStaticPages(options) {
   const siteTitle = config?.themeConfig?.title || "Boltdocs";
   const siteDescription = config?.themeConfig?.description || "";
   const ssrModulePath = path3.resolve(_dirname, "../client/ssr.js");
-  if (!fs3.existsSync(ssrModulePath)) {
+  if (!fs2.existsSync(ssrModulePath)) {
     console.error(
       "[boltdocs] SSR module not found at",
       ssrModulePath,
@@ -466,11 +368,11 @@ async function generateStaticPages(options) {
   }
   const { render } = _require(ssrModulePath);
   const templatePath = path3.join(outDir, "index.html");
-  if (!fs3.existsSync(templatePath)) {
+  if (!fs2.existsSync(templatePath)) {
     console.warn("[boltdocs] No index.html found in outDir, skipping SSG.");
     return;
   }
-  const template = fs3.readFileSync(templatePath, "utf-8");
+  const template = fs2.readFileSync(templatePath, "utf-8");
   let homePageComp;
   if (config?._homePagePath) {
     try {
@@ -497,8 +399,8 @@ async function generateStaticPages(options) {
           description: escapeHtml(pageDescription)
         }).replace("<!--app-html-->", appHtml).replace(`<div id="root"></div>`, `<div id="root">${appHtml}</div>`);
         const routeDir = path3.join(outDir, route.path);
-        await fs3.promises.mkdir(routeDir, { recursive: true });
-        await fs3.promises.writeFile(
+        await fs2.promises.mkdir(routeDir, { recursive: true });
+        await fs2.promises.writeFile(
           path3.join(routeDir, "index.html"),
           html,
           "utf-8"
@@ -512,10 +414,12 @@ async function generateStaticPages(options) {
     routes.map((r) => r.path),
     config
   );
-  fs3.writeFileSync(path3.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
@@ -696,6 +600,8 @@ function boltdocsPlugin(options = {}, passedConfig) {
         if (!isBuild) return;
         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({
@@ -725,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,
@@ -736,16 +645,64 @@ 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
 async function boltdocs(options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "boltdocs",
-  "version": "1.0.4",
+  "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"

package/src/client/app/index.tsx

@@ -40,27 +40,6 @@ const PackageManagerTabs = lazy(() =>
     default: m.PackageManagerTabs,
   })),
 );
-const Playground = lazy(() =>
-  import("../theme/components/Playground").then((m) => ({
-    default: m.Playground,
-  })),
-);
-
-import {
-  Button,
-  Badge,
-  Card,
-  Cards,
-  Tabs,
-  Tab,
-  Admonition,
-  Note,
-  Tip,
-  Warning,
-  Danger,
-  InfoBox,
-  List,
-} from "../theme/components/mdx";
 declare global {
   interface ImportMeta {
     env: Record<string, any>;
@@ -115,24 +94,6 @@ const mdxComponents = {
       <PackageManagerTabs {...props} />
     </Suspense>
   ),
-  Playground: (props: any) => (
-    <Suspense fallback={<div className="playground-skeleton" />}>
-      <Playground {...props} />
-    </Suspense>
-  ),
-  Button,
-  Badge,
-  Card,
-  Cards,
-  Tabs,
-  Tab,
-  Admonition,
-  Note,
-  Tip,
-  Warning,
-  Danger,
-  InfoBox,
-  List,
 };
 
 export function AppShell({
@@ -152,20 +113,9 @@ export function AppShell({
 }) {
   const [routesInfo, setRoutesInfo] = useState<ComponentRoute[]>(initialRoutes);
   const [config] = useState(initialConfig);
-  const [resolvedRoutes, setResolvedRoutes] = useState<any[]>([]);
-
-  // Subscribe to HMR events
-  useEffect(() => {
-    if (hot) {
-      hot.on("boltdocs:routes-update", (newRoutes: ComponentRoute[]) => {
-        setRoutesInfo(newRoutes);
-      });
-    }
-  }, [hot]);
 
-  // Resolve MDX components
-  useEffect(() => {
-    const mapped = routesInfo
+  const resolveRoutes = (infos: ComponentRoute[]) => {
+    return infos
       .filter(
         (route) => !(HomePage && (route.path === "/" || route.path === "")),
       )
@@ -184,8 +134,24 @@ export function AppShell({
           }),
         };
       });
+  };
+
+  const [resolvedRoutes, setResolvedRoutes] = useState<any[]>(() =>
+    resolveRoutes(initialRoutes),
+  );
+
+  // Subscribe to HMR events
+  useEffect(() => {
+    if (hot) {
+      hot.on("boltdocs:routes-update", (newRoutes: ComponentRoute[]) => {
+        setRoutesInfo(newRoutes);
+      });
+    }
+  }, [hot]);
 
-    setResolvedRoutes(mapped);
+  // Sync resolved routes when info or modules change
+  useEffect(() => {
+    setResolvedRoutes(resolveRoutes(routesInfo));
   }, [routesInfo, modules]);
 
   return (
@@ -213,7 +179,10 @@ export function AppShell({
           )}
 
           {/* Documentation pages WITH sidebar + TOC layout */}
-          <Route element={<DocsLayout config={config} routes={routesInfo} />}>
+          <Route
+            key="docs-layout"
+            element={<DocsLayout config={config} routes={routesInfo} />}
+          >
             {resolvedRoutes.map((route: any) => (
               <Route
                 key={route.path}
@@ -255,6 +224,8 @@ function ScrollHandler() {
   const { pathname, hash } = useLocation();
 
   useLayoutEffect(() => {
+    // Only scroll if we are not in a pending transition state (if we were using useTransition)
+    // For now, we ensure the scroll happens.
     if (hash) {
       const id = hash.replace("#", "");
       const element = document.getElementById(id);

package/src/client/theme/components/mdx/mdx-components.css

@@ -6,54 +6,77 @@
 
 /* ─── Button ──────────────────────────────────────────────── */
 .ld-btn {
+  /* Total Reset */
+  all: unset;
+  box-sizing: border-box !important;
   display: inline-flex;
   align-items: center;
-  gap: 0.4rem;
+  justify-content: center;
+  gap: 0.5rem;
+
+  /* Typography */
+  font-family: var(--ld-font-sans);
   font-weight: 600;
+  font-size: 0.9375rem;
+  line-height: normal; /* Essential for flex centering */
+  letter-spacing: -0.01em;
+  text-align: center;
+  text-decoration: none !important;
+  white-space: nowrap;
+
+  /* Appearance */
   border-radius: var(--ld-radius-md);
   cursor: pointer;
-  transition: all 300ms cubic-bezier(0.16, 1, 0.3, 1);
-  font-family: var(--ld-font-sans);
+  transition: all 250ms cubic-bezier(0.4, 0, 0.2, 1);
   border: 1px solid transparent;
-  line-height: 1;
-  letter-spacing: -0.01em;
+  user-select: none;
+  position: relative;
 }
 
 .ld-btn:hover {
-  transform: scale(1.05);
+  transform: translateY(-1px);
 }
 
 .ld-btn:active {
-  transform: scale(0.95);
+  transform: translateY(0) scale(0.98);
 }
 
 /* sizes */
 .ld-btn--sm {
-  padding: 0.45rem 1.1rem;
+  min-height: 2rem;
+  padding: 0 1rem;
   font-size: 0.8125rem;
   border-radius: var(--ld-radius-md);
 }
 .ld-btn--md {
-  padding: 0.7rem 1.6rem;
+  min-height: 2.625rem;
+  padding: 0 1.6rem;
   font-size: 0.9375rem;
 }
 .ld-btn--lg {
-  padding: 0.85rem 2.1rem;
+  min-height: 3.25rem;
+  padding: 0 2.2rem;
   font-size: 1.05rem;
 }
 
 /* variants */
 .ld-btn--primary {
-  background-color: var(--ld-ui-btn-primary-bg, var(--ld-btn-primary-bg));
+  background-color: var(
+    --ld-ui-btn-primary-bg,
+    var(--ld-btn-primary-bg)
+  ) !important;
   color: var(--ld-ui-btn-primary-text, var(--ld-btn-primary-text)) !important;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
 }
 .ld-btn--primary:hover {
-  opacity: 0.92;
-  color: var(--ld-ui-btn-primary-text, var(--ld-btn-primary-text)) !important;
+  filter: brightness(1.1);
 }
 
 .ld-btn--secondary {
-  background-color: var(--ld-ui-btn-secondary-bg, var(--ld-btn-secondary-bg));
+  background-color: var(
+    --ld-ui-btn-secondary-bg,
+    var(--ld-btn-secondary-bg)
+  ) !important;
   color: var(
     --ld-ui-btn-secondary-text,
     var(--ld-btn-secondary-text)
@@ -63,14 +86,10 @@
 .ld-btn--secondary:hover {
   background-color: var(--ld-bg-mute);
   border-color: var(--ld-border-strong);
-  color: var(
-    --ld-ui-btn-secondary-text,
-    var(--ld-btn-secondary-text)
-  ) !important;
 }
 
 .ld-btn--outline {
-  background: transparent;
+  background: transparent !important;
   color: var(--ld-text-main) !important;
   border-color: var(--ld-border-strong);
 }
@@ -80,7 +99,7 @@
 }
 
 .ld-btn--ghost {
-  background: transparent;
+  background: transparent !important;
   color: var(--ld-text-muted) !important;
 }
 .ld-btn--ghost:hover {

package/src/client/theme/styles/markdown.css

@@ -288,7 +288,7 @@
 
 .boltdocs-page pre > code {
   display: grid;
-  padding: 1rem 0;
+  padding: 1rem 1rem;
   background-color: transparent;
   border: none;
   color: inherit;

package/src/client/theme/styles.css

@@ -27,7 +27,6 @@
 @import "./ui/Layout/pagination.css";
 
 /* Pages */
-@import "./styles/home.css";
 @import "./ui/NotFound/not-found.css";
 @import "./ui/Loading/loading.css";
 

package/src/client/theme/ui/Layout/Layout.tsx

@@ -139,22 +139,11 @@ export function ThemeLayout({
           <Sidebar
             routes={filteredRoutes}
             config={config}
-            onCollapse={() => setIsSidebarOpen(false)}
+            isCollapsed={!isSidebarOpen}
+            onToggle={() => setIsSidebarOpen(!isSidebarOpen)}
           />
         )}
 
-        {/* Floating Expand Button when Sidebar is Collapsed */}
-        {sidebar === undefined && (
-          <button
-            className="sidebar-toggle-floating"
-            onClick={() => setIsSidebarOpen(true)}
-            aria-label="Expand Sidebar"
-            title="Expand Sidebar"
-          >
-            <Menu size={20} />
-          </button>
-        )}
-
         <main className="boltdocs-content">
           {breadcrumbs !== undefined ? (
             breadcrumbs

package/src/client/theme/ui/Layout/responsive.css

@@ -12,10 +12,6 @@
     display: none;
   }
 
-  .sidebar-toggle-floating {
-    display: none !important;
-  }
-
   .boltdocs-content {
     padding: 1.5rem 1rem 3rem;
   }