prev-cli 0.24.4 → 0.24.6

package/dist/cli.js

@@ -2,8 +2,8 @@
 
 // src/cli.ts
 import { parseArgs } from "util";
-import path10 from "path";
-import { existsSync as existsSync7, mkdirSync as mkdirSync2, writeFileSync as writeFileSync4, rmSync as rmSync3, readFileSync as readFileSync5 } from "fs";
+import path11 from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, writeFileSync as writeFileSync5, rmSync as rmSync3, readFileSync as readFileSync5 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/vite/start.ts
@@ -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 path8 from "path";
+import path9 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { existsSync as existsSync5, readFileSync as readFileSync4 } from "fs";
 
@@ -697,6 +697,56 @@ function createConfigPlugin(config) {
   };
 }
 
+// src/vite/plugins/debug-plugin.ts
+function debugPlugin(collector) {
+  return {
+    name: "prev-debug",
+    enforce: "pre",
+    configResolved() {
+      collector.startPhase("configResolved");
+    },
+    buildStart() {
+      collector.startPhase("buildStart");
+    },
+    resolveId(id, importer) {
+      const start = performance.now();
+      collector.trackFile(id, "resolve", start);
+      if (importer) {
+        collector.trackFile(`${id} <- ${importer}`, "resolve", start);
+      }
+      return null;
+    },
+    load(id) {
+      const start = performance.now();
+      collector.trackFile(id, "load", start);
+      return null;
+    },
+    transform(_code, id) {
+      const start = performance.now();
+      collector.trackFile(id, "transform", start);
+      return null;
+    },
+    configureServer(server) {
+      collector.startPhase("configureServer");
+      server.httpServer?.once("listening", () => {
+        collector.startPhase("serverListening");
+      });
+      server.middlewares.use((req, _res, next) => {
+        if (req.url && !req.url.startsWith("/@") && !req.url.includes("__")) {
+          collector.trackFile(req.url, "resolve", performance.now());
+        }
+        next();
+      });
+    },
+    handleHotUpdate({ file }) {
+      collector.trackFile(file, "transform", performance.now());
+    },
+    buildEnd() {
+      collector.endPhase("build");
+    }
+  };
+}
+
 // src/config/schema.ts
 var defaultConfig = {
   theme: "system",
@@ -778,6 +828,104 @@ function updateOrder(rootDir, pathKey, order) {
   config.order[pathKey] = order;
   saveConfig(rootDir, config);
 }
+// src/utils/debug.ts
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync4 } from "fs";
+import path8 from "path";
+
+class DebugCollector {
+  startTime;
+  files = [];
+  phases = {};
+  currentPhase = "init";
+  rootDir;
+  constructor(rootDir) {
+    this.startTime = performance.now();
+    this.rootDir = rootDir;
+    this.startPhase("init");
+  }
+  startPhase(name) {
+    const now = performance.now();
+    if (this.phases[this.currentPhase] && !this.phases[this.currentPhase].endMs) {
+      this.phases[this.currentPhase].endMs = Math.round(now - this.startTime);
+    }
+    this.currentPhase = name;
+    this.phases[name] = { startMs: Math.round(now - this.startTime) };
+  }
+  endPhase(name) {
+    const phaseName = name || this.currentPhase;
+    const now = performance.now();
+    if (this.phases[phaseName]) {
+      this.phases[phaseName].endMs = Math.round(now - this.startTime);
+    }
+  }
+  trackFile(filePath, event, startTime) {
+    const now = performance.now();
+    this.files.push({
+      path: filePath,
+      event,
+      ms: Math.round(now - startTime),
+      phase: this.currentPhase,
+      timestamp: Math.round(startTime - this.startTime)
+    });
+  }
+  generateSummary() {
+    const byDirectory = {};
+    const byEvent = { resolve: 0, load: 0, transform: 0 };
+    const fileTimeAccum = {};
+    for (const file of this.files) {
+      byEvent[file.event] = (byEvent[file.event] || 0) + 1;
+      fileTimeAccum[file.path] = (fileTimeAccum[file.path] || 0) + file.ms;
+      const relativePath = file.path.startsWith(this.rootDir) ? file.path.slice(this.rootDir.length) : file.path;
+      let dir;
+      if (relativePath.includes("node_modules")) {
+        const nmIndex = relativePath.indexOf("node_modules");
+        const prefix = relativePath.slice(0, nmIndex + "node_modules".length);
+        const afterNm = relativePath.slice(nmIndex + "node_modules/".length);
+        const pkgName = afterNm.split("/")[0].startsWith("@") ? afterNm.split("/").slice(0, 2).join("/") : afterNm.split("/")[0];
+        dir = `${prefix}/${pkgName}`;
+      } else {
+        const parts = relativePath.split("/").filter(Boolean);
+        dir = parts.length > 1 ? `/${parts[0]}` : "/";
+      }
+      byDirectory[dir] = (byDirectory[dir] || 0) + 1;
+    }
+    const slowest = Object.entries(fileTimeAccum).map(([path9, totalMs]) => ({ path: path9, totalMs })).sort((a, b) => b.totalMs - a.totalMs).slice(0, 20);
+    return {
+      totalFiles: this.files.length,
+      byDirectory,
+      byEvent,
+      slowest
+    };
+  }
+  writeReport() {
+    const now = performance.now();
+    const totalStartupMs = Math.round(now - this.startTime);
+    this.endPhase();
+    const report = {
+      timestamp: new Date().toISOString(),
+      totalStartupMs,
+      phases: this.phases,
+      files: this.files,
+      summary: this.generateSummary()
+    };
+    const debugDir = path8.join(this.rootDir, ".prev-debug");
+    mkdirSync2(debugDir, { recursive: true });
+    const date = new Date;
+    const filename = `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, "0")}-${String(date.getDate()).padStart(2, "0")}-${String(date.getHours()).padStart(2, "0")}-${String(date.getMinutes()).padStart(2, "0")}-${String(date.getSeconds()).padStart(2, "0")}.json`;
+    const filepath = path8.join(debugDir, filename);
+    writeFileSync4(filepath, JSON.stringify(report, null, 2));
+    return filepath;
+  }
+}
+var currentCollector = null;
+function createDebugCollector(rootDir) {
+  currentCollector = new DebugCollector(rootDir);
+  return currentCollector;
+}
+function getDebugCollector() {
+  return currentCollector;
+}
+
 // src/vite/config.ts
 function createFriendlyLogger() {
   const logger = createLogger("info", { allowClearScreen: false });
@@ -833,9 +981,9 @@ function createFriendlyLogger() {
   };
 }
 function findCliRoot2() {
-  let dir = path8.dirname(fileURLToPath2(import.meta.url));
+  let dir = path9.dirname(fileURLToPath2(import.meta.url));
   for (let i = 0;i < 10; i++) {
-    const pkgPath = path8.join(dir, "package.json");
+    const pkgPath = path9.join(dir, "package.json");
     if (existsSync5(pkgPath)) {
       try {
         const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
@@ -844,24 +992,24 @@ function findCliRoot2() {
         }
       } catch {}
     }
-    const parent = path8.dirname(dir);
+    const parent = path9.dirname(dir);
     if (parent === dir)
       break;
     dir = parent;
   }
-  return path8.dirname(path8.dirname(fileURLToPath2(import.meta.url)));
+  return path9.dirname(path9.dirname(fileURLToPath2(import.meta.url)));
 }
 function findNodeModules(cliRoot2) {
-  const localNodeModules = path8.join(cliRoot2, "node_modules");
-  if (existsSync5(path8.join(localNodeModules, "react"))) {
+  const localNodeModules = path9.join(cliRoot2, "node_modules");
+  if (existsSync5(path9.join(localNodeModules, "react"))) {
     return localNodeModules;
   }
   let dir = cliRoot2;
   for (let i = 0;i < 10; i++) {
-    const parent = path8.dirname(dir);
+    const parent = path9.dirname(dir);
     if (parent === dir)
       break;
-    if (path8.basename(parent) === "node_modules" && existsSync5(path8.join(parent, "react"))) {
+    if (path9.basename(parent) === "node_modules" && existsSync5(path9.join(parent, "react"))) {
       return parent;
     }
     dir = parent;
@@ -870,11 +1018,15 @@ function findNodeModules(cliRoot2) {
 }
 var cliRoot2 = findCliRoot2();
 var cliNodeModules = findNodeModules(cliRoot2);
-var srcRoot2 = path8.join(cliRoot2, "src");
+var srcRoot2 = path9.join(cliRoot2, "src");
 async function createViteConfig(options) {
-  const { rootDir, mode, port, include, base } = options;
+  const { rootDir, mode, port, include, base, debug } = options;
   const cacheDir = await ensureCacheDir(rootDir);
   const config = loadConfig(rootDir);
+  const debugCollector = debug ? createDebugCollector(rootDir) : null;
+  if (debugCollector) {
+    debugCollector.startPhase("configLoad");
+  }
   return {
     root: rootDir,
     mode,
@@ -885,13 +1037,14 @@ async function createViteConfig(options) {
     envDir: cliRoot2,
     envPrefix: "PREV_",
     plugins: [
+      ...debugCollector ? [debugPlugin(debugCollector)] : [],
       mdx({
         remarkPlugins: [remarkGfm],
         rehypePlugins: [rehypeHighlight],
         providerImportSource: "@mdx-js/react",
         include: [
-          path8.join(rootDir, "**/*.md"),
-          path8.join(rootDir, "**/*.mdx")
+          path9.join(rootDir, "**/*.md"),
+          path9.join(rootDir, "**/*.mdx")
         ],
         exclude: [
           "**/node_modules/**",
@@ -939,7 +1092,7 @@ async function createViteConfig(options) {
               if (urlPath.startsWith("/__") || urlPath.startsWith("/@") || urlPath.startsWith("/node_modules") || urlPath.includes(".")) {
                 return next();
               }
-              const indexPath = path8.join(srcRoot2, "theme/index.html");
+              const indexPath = path9.join(srcRoot2, "theme/index.html");
               if (existsSync5(indexPath)) {
                 server.transformIndexHtml(req.url, readFileSync4(indexPath, "utf-8")).then((html) => {
                   res.setHeader("Content-Type", "text/html");
@@ -957,8 +1110,8 @@ async function createViteConfig(options) {
         resolveId(id) {
           if (id.startsWith("/_preview/")) {
             const relativePath = id.slice("/_preview/".length);
-            const previewsDir = path8.join(rootDir, "previews");
-            const resolved = path8.resolve(previewsDir, relativePath);
+            const previewsDir = path9.join(rootDir, "previews");
+            const resolved = path9.resolve(previewsDir, relativePath);
             if (resolved.startsWith(previewsDir)) {
               return resolved;
             }
@@ -968,7 +1121,7 @@ async function createViteConfig(options) {
           server.middlewares.use(async (req, res, next) => {
             const urlPath = req.url?.split("?")[0] || "";
             if (urlPath === "/_preview-runtime") {
-              const templatePath = path8.join(srcRoot2, "preview-runtime/template.html");
+              const templatePath = path9.join(srcRoot2, "preview-runtime/template.html");
               if (existsSync5(templatePath)) {
                 const html = readFileSync4(templatePath, "utf-8");
                 res.setHeader("Content-Type", "text/html");
@@ -978,8 +1131,8 @@ async function createViteConfig(options) {
             }
             if (urlPath.startsWith("/_preview-config/")) {
               const previewName = decodeURIComponent(urlPath.slice("/_preview-config/".length));
-              const previewsDir = path8.join(rootDir, "previews");
-              const previewDir = path8.resolve(previewsDir, previewName);
+              const previewsDir = path9.join(rootDir, "previews");
+              const previewDir = path9.resolve(previewsDir, previewName);
               if (!previewDir.startsWith(previewsDir)) {
                 res.statusCode = 403;
                 res.end("Forbidden");
@@ -1000,11 +1153,11 @@ async function createViteConfig(options) {
               }
             }
             if (urlPath.startsWith("/_preview/")) {
-              const isHtmlRequest = !path8.extname(urlPath) || urlPath.endsWith("/");
+              const isHtmlRequest = !path9.extname(urlPath) || urlPath.endsWith("/");
               if (isHtmlRequest) {
                 const previewName = decodeURIComponent(urlPath.slice("/_preview/".length).replace(/\/$/, ""));
-                const previewsDir = path8.join(rootDir, "previews");
-                const htmlPath = path8.resolve(previewsDir, previewName, "index.html");
+                const previewsDir = path9.join(rootDir, "previews");
+                const htmlPath = path9.resolve(previewsDir, previewName, "index.html");
                 if (!htmlPath.startsWith(previewsDir)) {
                   return next();
                 }
@@ -1031,15 +1184,15 @@ async function createViteConfig(options) {
     ],
     resolve: {
       alias: {
-        "@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")
+        "@prev/ui": path9.join(srcRoot2, "ui"),
+        "@prev/theme": path9.join(srcRoot2, "theme"),
+        react: path9.join(cliNodeModules, "react"),
+        "react-dom": path9.join(cliNodeModules, "react-dom"),
+        "@tanstack/react-router": path9.join(cliNodeModules, "@tanstack/react-router"),
+        "@mdx-js/react": path9.join(cliNodeModules, "@mdx-js/react"),
+        mermaid: path9.join(cliNodeModules, "mermaid"),
+        dayjs: path9.join(cliNodeModules, "dayjs"),
+        "@terrastruct/d2": path9.join(cliNodeModules, "@terrastruct/d2")
       },
       dedupe: [
         "react",
@@ -1048,19 +1201,17 @@ async function createViteConfig(options) {
       ]
     },
     optimizeDeps: {
-      entries: [],
       noDiscovery: true,
       include: [
         "react",
         "react-dom",
         "react-dom/client",
-        "@tanstack/react-router",
         "react/jsx-runtime",
         "react/jsx-dev-runtime",
-        "@mdx-js/react",
-        "mermaid",
-        "dayjs",
-        "@terrastruct/d2"
+        "@tanstack/react-router",
+        "use-sync-external-store",
+        "use-sync-external-store/shim/with-selector.js",
+        "@mdx-js/react"
       ],
       exclude: [
         "virtual:prev-config",
@@ -1081,8 +1232,8 @@ async function createViteConfig(options) {
       },
       warmup: {
         clientFiles: [
-          path8.join(srcRoot2, "theme/entry.tsx"),
-          path8.join(srcRoot2, "theme/styles.css")
+          path9.join(srcRoot2, "theme/entry.tsx"),
+          path9.join(srcRoot2, "theme/styles.css")
         ]
       }
     },
@@ -1091,12 +1242,12 @@ async function createViteConfig(options) {
       strictPort: false
     },
     build: {
-      outDir: path8.join(rootDir, "dist"),
+      outDir: path9.join(rootDir, "dist"),
       reportCompressedSize: false,
       chunkSizeWarningLimit: 1e4,
       rollupOptions: {
         input: {
-          main: path8.join(srcRoot2, "theme/index.html")
+          main: path9.join(srcRoot2, "theme/index.html")
         }
       }
     },
@@ -1141,7 +1292,7 @@ async function findAvailablePort(minPort, maxPort) {
 // src/vite/start.ts
 import { exec as exec2 } from "child_process";
 import { existsSync as existsSync6, rmSync as rmSync2, copyFileSync } from "fs";
-import path9 from "path";
+import path10 from "path";
 function printWelcome(type) {
   console.log();
   console.log("  ✨ prev");
@@ -1174,8 +1325,8 @@ function openBrowser(url) {
   console.log(`  ↗ Opened ${url}`);
 }
 function clearCache(rootDir) {
-  const viteCacheDir = path9.join(rootDir, ".vite");
-  const nodeModulesVite = path9.join(rootDir, "node_modules", ".vite");
+  const viteCacheDir = path10.join(rootDir, ".vite");
+  const nodeModulesVite = path10.join(rootDir, "node_modules", ".vite");
   let cleared = 0;
   if (existsSync6(viteCacheDir)) {
     rmSync2(viteCacheDir, { recursive: true });
@@ -1229,10 +1380,17 @@ async function startDev(rootDir, options = {}) {
     rootDir,
     mode: "development",
     port,
-    include: options.include
+    include: options.include,
+    debug: options.debug
   });
   const server = await createServer2(config);
   await server.listen();
+  const debugCollector = getDebugCollector();
+  if (debugCollector) {
+    debugCollector.startPhase("serverReady");
+    const reportPath = debugCollector.writeReport();
+    console.log(`  \uD83D\uDCCA Debug trace written to: ${reportPath}`);
+  }
   const actualPort = server.config.server.port || port;
   const url = `http://localhost:${actualPort}/`;
   printWelcome("dev");
@@ -1281,12 +1439,19 @@ async function buildSite(rootDir, options = {}) {
     rootDir,
     mode: "production",
     include: options.include,
-    base: options.base
+    base: options.base,
+    debug: options.debug
   });
   await build2(config);
-  const distDir = path9.join(rootDir, "dist");
-  const indexPath = path9.join(distDir, "index.html");
-  const notFoundPath = path9.join(distDir, "404.html");
+  const debugCollector = getDebugCollector();
+  if (debugCollector) {
+    debugCollector.startPhase("buildComplete");
+    const reportPath = debugCollector.writeReport();
+    console.log(`  \uD83D\uDCCA Debug trace written to: ${reportPath}`);
+  }
+  const distDir = path10.join(rootDir, "dist");
+  const indexPath = path10.join(distDir, "index.html");
+  const notFoundPath = path10.join(distDir, "404.html");
   if (existsSync6(indexPath)) {
     copyFileSync(indexPath, notFoundPath);
   }
@@ -1301,9 +1466,16 @@ async function previewSite(rootDir, options = {}) {
     rootDir,
     mode: "production",
     port,
-    include: options.include
+    include: options.include,
+    debug: options.debug
   });
   const server = await preview(config);
+  const debugCollector = getDebugCollector();
+  if (debugCollector) {
+    debugCollector.startPhase("previewReady");
+    const reportPath = debugCollector.writeReport();
+    console.log(`  \uD83D\uDCCA Debug trace written to: ${reportPath}`);
+  }
   printWelcome("preview");
   server.printUrls();
   console.log();
@@ -1316,15 +1488,15 @@ async function previewSite(rootDir, options = {}) {
 import yaml2 from "js-yaml";
 function getVersion() {
   try {
-    let dir = path10.dirname(fileURLToPath3(import.meta.url));
+    let dir = path11.dirname(fileURLToPath3(import.meta.url));
     for (let i = 0;i < 5; i++) {
-      const pkgPath = path10.join(dir, "package.json");
+      const pkgPath = path11.join(dir, "package.json");
       if (existsSync7(pkgPath)) {
         const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
         if (pkg.name === "prev-cli")
           return pkg.version;
       }
-      dir = path10.dirname(dir);
+      dir = path11.dirname(dir);
     }
   } catch {}
   return "unknown";
@@ -1336,13 +1508,14 @@ var { values, positionals } = parseArgs({
     days: { type: "string", short: "d" },
     cwd: { type: "string", short: "c" },
     base: { type: "string", short: "b" },
+    debug: { type: "boolean" },
     help: { type: "boolean", short: "h" },
     version: { type: "boolean", short: "v" }
   },
   allowPositionals: true
 });
 var command = positionals[0] || "dev";
-var rootDir = path10.resolve(values.cwd || (command === "config" || command === "create" ? "." : positionals[1]) || ".");
+var rootDir = path11.resolve(values.cwd || (command === "config" || command === "create" ? "." : positionals[1]) || ".");
 function printHelp() {
   console.log(`
 prev - Zero-config documentation site generator
@@ -1367,6 +1540,7 @@ Options:
   -p, --port <port>      Specify port (dev/preview)
   -b, --base <path>      Base path for deployment (e.g., /repo-name/ for GitHub Pages)
   -d, --days <days>      Cache age threshold for clean (default: 30)
+  --debug                Write debug trace to .prev-debug/ for performance analysis
   -h, --help             Show this help message
   -v, --version          Show version number
 
@@ -1451,8 +1625,8 @@ async function clearViteCache(rootDir2) {
       console.log(`  ✓ Removed ${prevCacheDir}`);
     }
   } catch {}
-  const viteCacheDir = path10.join(rootDir2, ".vite");
-  const nodeModulesVite = path10.join(rootDir2, "node_modules", ".vite");
+  const viteCacheDir = path11.join(rootDir2, ".vite");
+  const nodeModulesVite = path11.join(rootDir2, "node_modules", ".vite");
   if (existsSync7(viteCacheDir)) {
     rmSync3(viteCacheDir, { recursive: true });
     cleared++;
@@ -1504,7 +1678,7 @@ function handleConfig(rootDir2, subcommand) {
       break;
     }
     case "init": {
-      const targetPath = path10.join(rootDir2, ".prev.yaml");
+      const targetPath = path11.join(rootDir2, ".prev.yaml");
       if (configPath) {
         console.log(`
   Config already exists: ${configPath}
@@ -1540,7 +1714,7 @@ order: {}
   #   - "getting-started.md"
   #   - "guides/"
 `;
-      writeFileSync4(targetPath, configContent, "utf-8");
+      writeFileSync5(targetPath, configContent, "utf-8");
       console.log(`
   ✨ Created ${targetPath}
 `);
@@ -1563,12 +1737,12 @@ Available subcommands: show, init, path`);
   }
 }
 function createPreview(rootDir2, name) {
-  const previewDir = path10.join(rootDir2, "previews", name);
+  const previewDir = path11.join(rootDir2, "previews", name);
   if (existsSync7(previewDir)) {
     console.error(`Preview "${name}" already exists at: ${previewDir}`);
     process.exit(1);
   }
-  mkdirSync2(previewDir, { recursive: true });
+  mkdirSync3(previewDir, { recursive: true });
   const appTsx = `import { useState } from 'react'
 import './styles.css'
 
@@ -1689,8 +1863,8 @@ export default function App() {
   .dark\\:text-white { color: #fff; }
 }
 `;
-  writeFileSync4(path10.join(previewDir, "App.tsx"), appTsx);
-  writeFileSync4(path10.join(previewDir, "styles.css"), stylesCss);
+  writeFileSync5(path11.join(previewDir, "App.tsx"), appTsx);
+  writeFileSync5(path11.join(previewDir, "styles.css"), stylesCss);
   console.log(`
   ✨ Created preview: previews/${name}/
 
@@ -1722,13 +1896,13 @@ async function main() {
   try {
     switch (command) {
       case "dev":
-        await startDev(rootDir, { port, include });
+        await startDev(rootDir, { port, include, debug: values.debug });
         break;
       case "build":
-        await buildSite(rootDir, { include, base: values.base });
+        await buildSite(rootDir, { include, base: values.base, debug: values.debug });
         break;
       case "preview":
-        await previewSite(rootDir, { port, include });
+        await previewSite(rootDir, { port, include, debug: values.debug });
         break;
       case "clean":
         const removed = await cleanCache({ maxAgeDays: days });

package/dist/utils/debug.d.ts

@@ -0,0 +1,42 @@
+export interface FileEvent {
+    path: string;
+    event: 'resolve' | 'load' | 'transform';
+    ms: number;
+    phase: string;
+    timestamp: number;
+}
+export interface PhaseInfo {
+    startMs: number;
+    endMs?: number;
+}
+export interface DebugSummary {
+    totalFiles: number;
+    byDirectory: Record<string, number>;
+    byEvent: Record<string, number>;
+    slowest: Array<{
+        path: string;
+        totalMs: number;
+    }>;
+}
+export interface DebugReport {
+    timestamp: string;
+    totalStartupMs: number;
+    phases: Record<string, PhaseInfo>;
+    files: FileEvent[];
+    summary: DebugSummary;
+}
+export declare class DebugCollector {
+    private startTime;
+    private files;
+    private phases;
+    private currentPhase;
+    private rootDir;
+    constructor(rootDir: string);
+    startPhase(name: string): void;
+    endPhase(name?: string): void;
+    trackFile(filePath: string, event: 'resolve' | 'load' | 'transform', startTime: number): void;
+    private generateSummary;
+    writeReport(): string;
+}
+export declare function createDebugCollector(rootDir: string): DebugCollector;
+export declare function getDebugCollector(): DebugCollector | null;

package/dist/vite/config.d.ts

@@ -1,9 +1,12 @@
 import type { InlineConfig } from 'vite';
+import { getDebugCollector } from '../utils/debug';
+export { getDebugCollector };
 export interface ConfigOptions {
     rootDir: string;
     mode: 'development' | 'production';
     port?: number;
     include?: string[];
     base?: string;
+    debug?: boolean;
 }
 export declare function createViteConfig(options: ConfigOptions): Promise<InlineConfig>;

package/dist/vite/plugins/debug-plugin.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from 'vite';
+import { DebugCollector } from '../../utils/debug';
+export declare function debugPlugin(collector: DebugCollector): Plugin;

package/dist/vite/start.d.ts

@@ -1,10 +1,12 @@
 export interface DevOptions {
     port?: number;
     include?: string[];
+    debug?: boolean;
 }
 export interface BuildOptions {
     include?: string[];
     base?: string;
+    debug?: boolean;
 }
 export declare function startDev(rootDir: string, options?: DevOptions): Promise<import("vite").ViteDevServer>;
 export declare function buildSite(rootDir: string, options?: BuildOptions): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prev-cli",
-  "version": "0.24.4",
+  "version": "0.24.6",
   "description": "Transform MDX directories into beautiful documentation websites",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,7 @@
   "scripts": {
     "build": "bun build src/cli.ts --outdir dist --target node --packages external && tsc --emitDeclarationOnly",
     "build:docs": "bun run build && bun ./dist/cli.js build",
+    "prepublishOnly": "bun run build",
     "dev": "tsc --watch",
     "test": "bun test src",
     "test:integration": "bun run build && bun test test/integration.test.ts",