prev-cli 0.22.3 → 0.22.4

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { parseArgs } from "util";
-import path9 from "path";
+import path10 from "path";
 import { existsSync as existsSync7, mkdirSync as mkdirSync2, writeFileSync as writeFileSync4, rmSync as rmSync3, readFileSync as readFileSync5 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
@@ -15,7 +15,7 @@ import react from "@vitejs/plugin-react";
 import mdx from "@mdx-js/rollup";
 import remarkGfm from "remark-gfm";
 import rehypeHighlight from "rehype-highlight";
-import path7 from "path";
+import path8 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 
@@ -70,6 +70,9 @@ async function ensureCacheDir(rootDir) {
   return cacheDir;
 }
 
+// src/vite/plugins/pages-plugin.ts
+import path3 from "path";
+
 // src/vite/pages.ts
 import fg from "fast-glob";
 import { readFile } from "fs/promises";
@@ -254,45 +257,82 @@ function buildSidebarTree(pages) {
 // src/vite/plugins/pages-plugin.ts
 var VIRTUAL_MODULE_ID = "virtual:prev-pages";
 var RESOLVED_VIRTUAL_MODULE_ID = "\x00" + VIRTUAL_MODULE_ID;
+var VIRTUAL_MODULES_ID = "virtual:prev-page-modules";
+var RESOLVED_VIRTUAL_MODULES_ID = "\x00" + VIRTUAL_MODULES_ID;
 function pagesPlugin(rootDir, options = {}) {
   const { include } = options;
+  let cachedPages = null;
+  async function getPages() {
+    if (!cachedPages) {
+      cachedPages = await scanPages(rootDir, { include });
+    }
+    return cachedPages;
+  }
   return {
     name: "prev-pages",
     resolveId(id) {
       if (id === VIRTUAL_MODULE_ID) {
         return RESOLVED_VIRTUAL_MODULE_ID;
       }
+      if (id === VIRTUAL_MODULES_ID) {
+        return RESOLVED_VIRTUAL_MODULES_ID;
+      }
     },
     async load(id) {
       if (id === RESOLVED_VIRTUAL_MODULE_ID) {
-        const pages = await scanPages(rootDir, { include });
+        const pages = await getPages();
         const sidebar = buildSidebarTree(pages);
         return `
           export const pages = ${JSON.stringify(pages)};
           export const sidebar = ${JSON.stringify(sidebar)};
         `;
       }
+      if (id === RESOLVED_VIRTUAL_MODULES_ID) {
+        const pages = await getPages();
+        const imports = pages.map((page, i) => {
+          const absolutePath = path3.join(rootDir, page.file);
+          return `import * as _page${i} from ${JSON.stringify(absolutePath)};`;
+        }).join(`
+`);
+        const entries = pages.map((page, i) => {
+          return `  ${JSON.stringify("/" + page.file)}: _page${i}`;
+        }).join(`,
+`);
+        return `${imports}
+
+export const pageModules = {
+${entries}
+};`;
+      }
     },
     handleHotUpdate({ file, server }) {
       if (file.endsWith(".mdx") || file.endsWith(".md")) {
+        cachedPages = null;
         const mod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_MODULE_ID);
+        const modulesMod = server.moduleGraph.getModuleById(RESOLVED_VIRTUAL_MODULES_ID);
+        const mods = [];
         if (mod) {
           server.moduleGraph.invalidateModule(mod);
-          return [mod];
+          mods.push(mod);
+        }
+        if (modulesMod) {
+          server.moduleGraph.invalidateModule(modulesMod);
+          mods.push(modulesMod);
         }
+        return mods.length > 0 ? mods : undefined;
       }
     }
   };
 }
 
 // src/vite/plugins/entry-plugin.ts
-import path3 from "path";
+import path4 from "path";
 import { fileURLToPath } from "url";
 import { existsSync, readFileSync, writeFileSync, unlinkSync } from "fs";
 function findCliRoot() {
-  let dir = path3.dirname(fileURLToPath(import.meta.url));
+  let dir = path4.dirname(fileURLToPath(import.meta.url));
   for (let i = 0;i < 10; i++) {
-    const pkgPath = path3.join(dir, "package.json");
+    const pkgPath = path4.join(dir, "package.json");
     if (existsSync(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
@@ -301,15 +341,15 @@ function findCliRoot() {
         }
       } catch {}
     }
-    const parent = path3.dirname(dir);
+    const parent = path4.dirname(dir);
     if (parent === dir)
       break;
     dir = parent;
   }
-  return path3.dirname(path3.dirname(fileURLToPath(import.meta.url)));
+  return path4.dirname(path4.dirname(fileURLToPath(import.meta.url)));
 }
 var cliRoot = findCliRoot();
-var srcRoot = path3.join(cliRoot, "src");
+var srcRoot = path4.join(cliRoot, "src");
 function getHtml(entryPath, forBuild = false) {
   const scriptSrc = forBuild ? entryPath : `/@fs${entryPath}`;
   return `<!DOCTYPE html>
@@ -332,13 +372,13 @@ function getHtml(entryPath, forBuild = false) {
 </html>`;
 }
 function entryPlugin(rootDir) {
-  const entryPath = path3.join(srcRoot, "theme/entry.tsx");
+  const entryPath = path4.join(srcRoot, "theme/entry.tsx");
   let tempHtmlPath = null;
   return {
     name: "prev-entry",
     config(config, { command }) {
       if (command === "build" && rootDir) {
-        tempHtmlPath = path3.join(rootDir, "index.html");
+        tempHtmlPath = path4.join(rootDir, "index.html");
         writeFileSync(tempHtmlPath, getHtml(entryPath, true));
         const existingInput = config.build?.rollupOptions?.input || {};
         const inputObj = typeof existingInput === "string" ? { _original: existingInput } : Array.isArray(existingInput) ? Object.fromEntries(existingInput.map((f, i) => [`entry${i}`, f])) : existingInput;
@@ -385,10 +425,10 @@ function entryPlugin(rootDir) {
 
 // src/vite/previews.ts
 import fg2 from "fast-glob";
-import path4 from "path";
+import path5 from "path";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
 async function scanPreviews(rootDir) {
-  const previewsDir = path4.join(rootDir, "previews");
+  const previewsDir = path5.join(rootDir, "previews");
   if (!existsSync2(previewsDir)) {
     return [];
   }
@@ -398,17 +438,17 @@ async function scanPreviews(rootDir) {
   });
   const previewDirs = new Map;
   for (const file of entryFiles) {
-    const dir = path4.dirname(file);
+    const dir = path5.dirname(file);
     if (!previewDirs.has(dir)) {
       previewDirs.set(dir, file);
     }
   }
   return Array.from(previewDirs.entries()).map(([dir, file]) => {
-    const name = dir === "." ? path4.basename(previewsDir) : dir;
+    const name = dir === "." ? path5.basename(previewsDir) : dir;
     return {
       name,
       route: `/_preview/${name}`,
-      htmlPath: path4.join(previewsDir, file)
+      htmlPath: path5.join(previewsDir, file)
     };
   });
 }
@@ -418,8 +458,8 @@ async function scanPreviewFiles(previewDir) {
     ignore: ["node_modules/**", "dist/**"]
   });
   return files.map((file) => {
-    const content = readFileSync2(path4.join(previewDir, file), "utf-8");
-    const ext = path4.extname(file).slice(1);
+    const content = readFileSync2(path5.join(previewDir, file), "utf-8");
+    const ext = path5.extname(file).slice(1);
     return {
       path: file,
       content,
@@ -563,7 +603,7 @@ async function buildPreviewHtml(config) {
 
 // src/vite/plugins/previews-plugin.ts
 import { existsSync as existsSync3, mkdirSync, rmSync, writeFileSync as writeFileSync2 } from "fs";
-import path5 from "path";
+import path6 from "path";
 var VIRTUAL_MODULE_ID2 = "virtual:prev-previews";
 var RESOLVED_VIRTUAL_MODULE_ID2 = "\x00" + VIRTUAL_MODULE_ID2;
 function previewsPlugin(rootDir) {
@@ -596,10 +636,10 @@ function previewsPlugin(rootDir) {
     async closeBundle() {
       if (!isBuild)
         return;
-      const distDir = path5.join(rootDir, "dist");
-      const targetDir = path5.join(distDir, "_preview");
-      const previewsDir = path5.join(rootDir, "previews");
-      const oldPreviewsDir = path5.join(distDir, "previews");
+      const distDir = path6.join(rootDir, "dist");
+      const targetDir = path6.join(distDir, "_preview");
+      const previewsDir = path6.join(rootDir, "previews");
+      const oldPreviewsDir = path6.join(distDir, "previews");
       if (existsSync3(oldPreviewsDir)) {
         rmSync(oldPreviewsDir, { recursive: true });
       }
@@ -612,7 +652,7 @@ function previewsPlugin(rootDir) {
       console.log(`
   Building ${previews.length} preview(s)...`);
       for (const preview of previews) {
-        const previewDir = path5.join(previewsDir, preview.name);
+        const previewDir = path6.join(previewsDir, preview.name);
         try {
           const config = await buildPreviewConfig(previewDir);
           const result = await buildPreviewHtml(config);
@@ -620,9 +660,9 @@ function previewsPlugin(rootDir) {
             console.error(`    ✗ ${preview.name}: ${result.error}`);
             continue;
           }
-          const outputDir = path5.join(targetDir, preview.name);
+          const outputDir = path6.join(targetDir, preview.name);
           mkdirSync(outputDir, { recursive: true });
-          writeFileSync2(path5.join(outputDir, "index.html"), result.html);
+          writeFileSync2(path6.join(outputDir, "index.html"), result.html);
           console.log(`    ✓ ${preview.name}`);
         } catch (err) {
           console.error(`    ✗ ${preview.name}: ${err}`);
@@ -693,11 +733,11 @@ function validateConfig(raw) {
 }
 // src/config/loader.ts
 import { readFileSync as readFileSync3, existsSync as existsSync4, writeFileSync as writeFileSync3 } from "fs";
-import path6 from "path";
+import path7 from "path";
 import yaml from "js-yaml";
 function findConfigFile(rootDir) {
-  const yamlPath = path6.join(rootDir, ".prev.yaml");
-  const ymlPath = path6.join(rootDir, ".prev.yml");
+  const yamlPath = path7.join(rootDir, ".prev.yaml");
+  const ymlPath = path7.join(rootDir, ".prev.yml");
   if (existsSync4(yamlPath))
     return yamlPath;
   if (existsSync4(ymlPath))
@@ -719,7 +759,7 @@ function loadConfig(rootDir) {
   }
 }
 function saveConfig(rootDir, config) {
-  const configPath = findConfigFile(rootDir) || path6.join(rootDir, ".prev.yaml");
+  const configPath = findConfigFile(rootDir) || path7.join(rootDir, ".prev.yaml");
   const content = yaml.dump(config, {
     indent: 2,
     lineWidth: -1,
@@ -788,9 +828,9 @@ function createFriendlyLogger() {
   };
 }
 function findCliRoot2() {
-  let dir = path7.dirname(fileURLToPath2(import.meta.url));
+  let dir = path8.dirname(fileURLToPath2(import.meta.url));
   for (let i = 0;i < 10; i++) {
-    const pkgPath = path7.join(dir, "package.json");
+    const pkgPath = path8.join(dir, "package.json");
     if (existsSync5(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
@@ -799,24 +839,24 @@ function findCliRoot2() {
         }
       } catch {}
     }
-    const parent = path7.dirname(dir);
+    const parent = path8.dirname(dir);
     if (parent === dir)
       break;
     dir = parent;
   }
-  return path7.dirname(path7.dirname(fileURLToPath2(import.meta.url)));
+  return path8.dirname(path8.dirname(fileURLToPath2(import.meta.url)));
 }
 function findNodeModules(cliRoot2) {
-  const localNodeModules = path7.join(cliRoot2, "node_modules");
-  if (existsSync5(path7.join(localNodeModules, "react"))) {
+  const localNodeModules = path8.join(cliRoot2, "node_modules");
+  if (existsSync5(path8.join(localNodeModules, "react"))) {
     return localNodeModules;
   }
   let dir = cliRoot2;
   for (let i = 0;i < 10; i++) {
-    const parent = path7.dirname(dir);
+    const parent = path8.dirname(dir);
     if (parent === dir)
       break;
-    if (path7.basename(parent) === "node_modules" && existsSync5(path7.join(parent, "react"))) {
+    if (path8.basename(parent) === "node_modules" && existsSync5(path8.join(parent, "react"))) {
       return parent;
     }
     dir = parent;
@@ -825,7 +865,7 @@ function findNodeModules(cliRoot2) {
 }
 var cliRoot2 = findCliRoot2();
 var cliNodeModules = findNodeModules(cliRoot2);
-var srcRoot2 = path7.join(cliRoot2, "src");
+var srcRoot2 = path8.join(cliRoot2, "src");
 async function createViteConfig(options) {
   const { rootDir, mode, port, include } = options;
   const cacheDir = await ensureCacheDir(rootDir);
@@ -883,7 +923,7 @@ async function createViteConfig(options) {
               if (urlPath.startsWith("/__") || urlPath.startsWith("/@") || urlPath.startsWith("/node_modules") || urlPath.includes(".")) {
                 return next();
               }
-              const indexPath = path7.join(srcRoot2, "theme/index.html");
+              const indexPath = path8.join(srcRoot2, "theme/index.html");
               if (existsSync5(indexPath)) {
                 server.transformIndexHtml(req.url, readFileSync4(indexPath, "utf-8")).then((html) => {
                   res.setHeader("Content-Type", "text/html");
@@ -901,8 +941,8 @@ async function createViteConfig(options) {
         resolveId(id) {
           if (id.startsWith("/_preview/")) {
             const relativePath = id.slice("/_preview/".length);
-            const previewsDir = path7.join(rootDir, "previews");
-            const resolved = path7.resolve(previewsDir, relativePath);
+            const previewsDir = path8.join(rootDir, "previews");
+            const resolved = path8.resolve(previewsDir, relativePath);
             if (resolved.startsWith(previewsDir)) {
               return resolved;
             }
@@ -912,7 +952,7 @@ async function createViteConfig(options) {
           server.middlewares.use(async (req, res, next) => {
             const urlPath = req.url?.split("?")[0] || "";
             if (urlPath === "/_preview-runtime") {
-              const templatePath = path7.join(srcRoot2, "preview-runtime/template.html");
+              const templatePath = path8.join(srcRoot2, "preview-runtime/template.html");
               if (existsSync5(templatePath)) {
                 const html = readFileSync4(templatePath, "utf-8");
                 res.setHeader("Content-Type", "text/html");
@@ -922,8 +962,8 @@ async function createViteConfig(options) {
             }
             if (urlPath.startsWith("/_preview-config/")) {
               const previewName = decodeURIComponent(urlPath.slice("/_preview-config/".length));
-              const previewsDir = path7.join(rootDir, "previews");
-              const previewDir = path7.resolve(previewsDir, previewName);
+              const previewsDir = path8.join(rootDir, "previews");
+              const previewDir = path8.resolve(previewsDir, previewName);
               if (!previewDir.startsWith(previewsDir)) {
                 res.statusCode = 403;
                 res.end("Forbidden");
@@ -944,11 +984,11 @@ async function createViteConfig(options) {
               }
             }
             if (urlPath.startsWith("/_preview/")) {
-              const isHtmlRequest = !path7.extname(urlPath) || urlPath.endsWith("/");
+              const isHtmlRequest = !path8.extname(urlPath) || urlPath.endsWith("/");
               if (isHtmlRequest) {
                 const previewName = decodeURIComponent(urlPath.slice("/_preview/".length).replace(/\/$/, ""));
-                const previewsDir = path7.join(rootDir, "previews");
-                const htmlPath = path7.resolve(previewsDir, previewName, "index.html");
+                const previewsDir = path8.join(rootDir, "previews");
+                const htmlPath = path8.resolve(previewsDir, previewName, "index.html");
                 if (!htmlPath.startsWith(previewsDir)) {
                   return next();
                 }
@@ -975,15 +1015,15 @@ async function createViteConfig(options) {
     ],
     resolve: {
       alias: {
-        "@prev/ui": path7.join(srcRoot2, "ui"),
-        "@prev/theme": path7.join(srcRoot2, "theme"),
-        react: path7.join(cliNodeModules, "react"),
-        "react-dom": path7.join(cliNodeModules, "react-dom"),
-        "@tanstack/react-router": path7.join(cliNodeModules, "@tanstack/react-router"),
-        "@mdx-js/react": path7.join(cliNodeModules, "@mdx-js/react"),
-        mermaid: path7.join(cliNodeModules, "mermaid"),
-        dayjs: path7.join(cliNodeModules, "dayjs"),
-        "@terrastruct/d2": path7.join(cliNodeModules, "@terrastruct/d2")
+        "@prev/ui": path8.join(srcRoot2, "ui"),
+        "@prev/theme": path8.join(srcRoot2, "theme"),
+        react: path8.join(cliNodeModules, "react"),
+        "react-dom": path8.join(cliNodeModules, "react-dom"),
+        "@tanstack/react-router": path8.join(cliNodeModules, "@tanstack/react-router"),
+        "@mdx-js/react": path8.join(cliNodeModules, "@mdx-js/react"),
+        mermaid: path8.join(cliNodeModules, "mermaid"),
+        dayjs: path8.join(cliNodeModules, "dayjs"),
+        "@terrastruct/d2": path8.join(cliNodeModules, "@terrastruct/d2")
       },
       dedupe: [
         "react",
@@ -1008,6 +1048,7 @@ async function createViteConfig(options) {
         "virtual:prev-config",
         "virtual:prev-previews",
         "virtual:prev-pages",
+        "virtual:prev-page-modules",
         "@prev/theme"
       ]
     },
@@ -1022,8 +1063,8 @@ async function createViteConfig(options) {
       },
       warmup: {
         clientFiles: [
-          path7.join(srcRoot2, "theme/entry.tsx"),
-          path7.join(srcRoot2, "theme/styles.css")
+          path8.join(srcRoot2, "theme/entry.tsx"),
+          path8.join(srcRoot2, "theme/styles.css")
         ]
       }
     },
@@ -1032,12 +1073,12 @@ async function createViteConfig(options) {
       strictPort: false
     },
     build: {
-      outDir: path7.join(rootDir, "dist"),
+      outDir: path8.join(rootDir, "dist"),
       reportCompressedSize: false,
       chunkSizeWarningLimit: 1e4,
       rollupOptions: {
         input: {
-          main: path7.join(srcRoot2, "theme/index.html")
+          main: path8.join(srcRoot2, "theme/index.html")
         }
       }
     }
@@ -1078,7 +1119,7 @@ async function findAvailablePort(minPort, maxPort) {
 // src/vite/start.ts
 import { exec as exec2 } from "child_process";
 import { existsSync as existsSync6, rmSync as rmSync2 } from "fs";
-import path8 from "path";
+import path9 from "path";
 function printWelcome(type) {
   console.log();
   console.log("  ✨ prev");
@@ -1111,8 +1152,8 @@ function openBrowser(url) {
   console.log(`  ↗ Opened ${url}`);
 }
 function clearCache(rootDir) {
-  const viteCacheDir = path8.join(rootDir, ".vite");
-  const nodeModulesVite = path8.join(rootDir, "node_modules", ".vite");
+  const viteCacheDir = path9.join(rootDir, ".vite");
+  const nodeModulesVite = path9.join(rootDir, "node_modules", ".vite");
   let cleared = 0;
   if (existsSync6(viteCacheDir)) {
     rmSync2(viteCacheDir, { recursive: true });
@@ -1212,15 +1253,15 @@ async function previewSite(rootDir, options = {}) {
 import yaml2 from "js-yaml";
 function getVersion() {
   try {
-    let dir = path9.dirname(fileURLToPath3(import.meta.url));
+    let dir = path10.dirname(fileURLToPath3(import.meta.url));
     for (let i = 0;i < 5; i++) {
-      const pkgPath = path9.join(dir, "package.json");
+      const pkgPath = path10.join(dir, "package.json");
       if (existsSync7(pkgPath)) {
         const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
         if (pkg.name === "prev-cli")
           return pkg.version;
       }
-      dir = path9.dirname(dir);
+      dir = path10.dirname(dir);
     }
   } catch {}
   return "unknown";
@@ -1237,7 +1278,7 @@ var { values, positionals } = parseArgs({
   allowPositionals: true
 });
 var command = positionals[0] || "dev";
-var rootDir = path9.resolve(values.cwd || (command === "config" || command === "create" ? "." : positionals[1]) || ".");
+var rootDir = path10.resolve(values.cwd || (command === "config" || command === "create" ? "." : positionals[1]) || ".");
 function printHelp() {
   console.log(`
 prev - Zero-config documentation site generator
@@ -1345,8 +1386,8 @@ async function clearViteCache(rootDir2) {
       console.log(`  ✓ Removed ${prevCacheDir}`);
     }
   } catch {}
-  const viteCacheDir = path9.join(rootDir2, ".vite");
-  const nodeModulesVite = path9.join(rootDir2, "node_modules", ".vite");
+  const viteCacheDir = path10.join(rootDir2, ".vite");
+  const nodeModulesVite = path10.join(rootDir2, "node_modules", ".vite");
   if (existsSync7(viteCacheDir)) {
     rmSync3(viteCacheDir, { recursive: true });
     cleared++;
@@ -1398,7 +1439,7 @@ function handleConfig(rootDir2, subcommand) {
       break;
     }
     case "init": {
-      const targetPath = path9.join(rootDir2, ".prev.yaml");
+      const targetPath = path10.join(rootDir2, ".prev.yaml");
       if (configPath) {
         console.log(`
   Config already exists: ${configPath}
@@ -1457,7 +1498,7 @@ Available subcommands: show, init, path`);
   }
 }
 function createPreview(rootDir2, name) {
-  const previewDir = path9.join(rootDir2, "previews", name);
+  const previewDir = path10.join(rootDir2, "previews", name);
   if (existsSync7(previewDir)) {
     console.error(`Preview "${name}" already exists at: ${previewDir}`);
     process.exit(1);
@@ -1583,8 +1624,8 @@ export default function App() {
   .dark\\:text-white { color: #fff; }
 }
 `;
-  writeFileSync4(path9.join(previewDir, "App.tsx"), appTsx);
-  writeFileSync4(path9.join(previewDir, "styles.css"), stylesCss);
+  writeFileSync4(path10.join(previewDir, "App.tsx"), appTsx);
+  writeFileSync4(path10.join(previewDir, "styles.css"), stylesCss);
   console.log(`
   ✨ Created preview: previews/${name}/
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prev-cli",
-  "version": "0.22.3",
+  "version": "0.22.4",
   "description": "Transform MDX directories into beautiful documentation websites",
   "type": "module",
   "license": "MIT",

package/src/theme/entry.tsx

@@ -14,6 +14,7 @@ import {
 } from '@tanstack/react-router'
 import { MDXProvider } from '@mdx-js/react'
 import { pages, sidebar } from 'virtual:prev-pages'
+import { pageModules } from 'virtual:prev-page-modules'
 import { previews } from 'virtual:prev-previews'
 import { Preview } from './Preview'
 import { useDiagrams } from './diagrams'
@@ -64,11 +65,10 @@ function convertToPageTree(items: any[]): PageTree.Root {
   }
 }
 
-// Dynamic imports for MDX pages (include dot directories for --include flag)
-const pageModules = import.meta.glob(['/**/*.{md,mdx}', '/.*/**/*.{md,mdx}'], { eager: true })
-
+// Page modules are dynamically generated by the pages plugin
+// This ensures all MDX files are included regardless of dot-prefixed directories
 function getPageComponent(file: string): React.ComponentType | null {
-  const mod = pageModules[`/${file}`] as { default: React.ComponentType } | undefined
+  const mod = pageModules[`/${file}`]
   return mod?.default || null
 }