prev-cli 0.14.1 → 0.15.0

package/dist/cli.js

@@ -2,8 +2,8 @@
 
 // src/cli.ts
 import { parseArgs } from "util";
-import path7 from "path";
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, rmSync as rmSync2, readFileSync as readFileSync4 } from "fs";
+import path8 from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3, rmSync as rmSync3, readFileSync as readFileSync4 } from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/vite/start.ts
@@ -896,6 +896,9 @@ async function findAvailablePort(minPort, maxPort) {
 }
 
 // src/vite/start.ts
+import { exec as exec2 } from "child_process";
+import { existsSync as existsSync5, rmSync as rmSync2 } from "fs";
+import path7 from "path";
 function printWelcome(type) {
   console.log();
   console.log("  ✨ prev");
@@ -906,12 +909,69 @@ function printWelcome(type) {
     console.log("  Previewing your production build:");
   }
 }
+function printShortcuts() {
+  console.log();
+  console.log("  Shortcuts:");
+  console.log("    o  →  open in browser");
+  console.log("    c  →  clear cache");
+  console.log("    h  →  show this help");
+  console.log("    q  →  quit");
+  console.log();
+}
 function printReady() {
   console.log();
   console.log("  Edit your .md/.mdx files and see changes instantly.");
-  console.log("  Press Ctrl+C to stop.");
+  console.log("  Press h for shortcuts.");
   console.log();
 }
+function openBrowser(url) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+  exec2(`${cmd} ${url}`);
+  console.log(`  ↗ Opened ${url}`);
+}
+function clearCache(rootDir) {
+  const viteCacheDir = path7.join(rootDir, ".vite");
+  const nodeModulesVite = path7.join(rootDir, "node_modules", ".vite");
+  let cleared = 0;
+  if (existsSync5(viteCacheDir)) {
+    rmSync2(viteCacheDir, { recursive: true });
+    cleared++;
+  }
+  if (existsSync5(nodeModulesVite)) {
+    rmSync2(nodeModulesVite, { recursive: true });
+    cleared++;
+  }
+  if (cleared === 0) {
+    console.log("  No cache to clear");
+  } else {
+    console.log(`  ✓ Cleared Vite cache`);
+  }
+}
+function setupKeyboardShortcuts(rootDir, url, quit) {
+  if (!process.stdin.isTTY)
+    return;
+  process.stdin.setRawMode(true);
+  process.stdin.resume();
+  process.stdin.setEncoding("utf8");
+  process.stdin.on("data", (key) => {
+    switch (key.toLowerCase()) {
+      case "o":
+        openBrowser(url);
+        break;
+      case "c":
+        clearCache(rootDir);
+        break;
+      case "h":
+        printShortcuts();
+        break;
+      case "q":
+      case "\x03":
+        quit();
+        break;
+    }
+  });
+}
 async function startDev(rootDir, options = {}) {
   const port = options.port ?? await getRandomPort();
   const config = await createViteConfig({
@@ -922,9 +982,17 @@ async function startDev(rootDir, options = {}) {
   });
   const server = await createServer2(config);
   await server.listen();
+  const actualPort = server.config.server.port || port;
+  const url = `http://localhost:${actualPort}/`;
   printWelcome("dev");
   server.printUrls();
   printReady();
+  setupKeyboardShortcuts(rootDir, url, async () => {
+    console.log(`
+  Shutting down...`);
+    await server.close();
+    process.exit(0);
+  });
   return server;
 }
 async function buildSite(rootDir, options = {}) {
@@ -963,15 +1031,15 @@ async function previewSite(rootDir, options = {}) {
 // src/cli.ts
 function getVersion() {
   try {
-    let dir = path7.dirname(fileURLToPath3(import.meta.url));
+    let dir = path8.dirname(fileURLToPath3(import.meta.url));
     for (let i = 0;i < 5; i++) {
-      const pkgPath = path7.join(dir, "package.json");
-      if (existsSync5(pkgPath)) {
+      const pkgPath = path8.join(dir, "package.json");
+      if (existsSync6(pkgPath)) {
         const pkg = JSON.parse(readFileSync4(pkgPath, "utf-8"));
         if (pkg.name === "prev-cli")
           return pkg.version;
       }
-      dir = path7.dirname(dir);
+      dir = path8.dirname(dir);
     }
   } catch {}
   return "unknown";
@@ -989,7 +1057,7 @@ var { values, positionals } = parseArgs({
   allowPositionals: true
 });
 var command = positionals[0] || "dev";
-var rootDir = path7.resolve(values.cwd || positionals[1] || ".");
+var rootDir = path8.resolve(values.cwd || positionals[1] || ".");
 function printHelp() {
   console.log(`
 prev - Zero-config documentation site generator
@@ -1053,16 +1121,16 @@ Examples:
 `);
 }
 function clearViteCache(rootDir2) {
-  const viteCacheDir = path7.join(rootDir2, ".vite");
-  const nodeModulesVite = path7.join(rootDir2, "node_modules", ".vite");
+  const viteCacheDir = path8.join(rootDir2, ".vite");
+  const nodeModulesVite = path8.join(rootDir2, "node_modules", ".vite");
   let cleared = 0;
-  if (existsSync5(viteCacheDir)) {
-    rmSync2(viteCacheDir, { recursive: true });
+  if (existsSync6(viteCacheDir)) {
+    rmSync3(viteCacheDir, { recursive: true });
     cleared++;
     console.log(`  ✓ Removed .vite/`);
   }
-  if (existsSync5(nodeModulesVite)) {
-    rmSync2(nodeModulesVite, { recursive: true });
+  if (existsSync6(nodeModulesVite)) {
+    rmSync3(nodeModulesVite, { recursive: true });
     cleared++;
     console.log(`  ✓ Removed node_modules/.vite/`);
   }
@@ -1074,8 +1142,8 @@ function clearViteCache(rootDir2) {
   }
 }
 function createPreview(rootDir2, name) {
-  const previewDir = path7.join(rootDir2, "previews", name);
-  if (existsSync5(previewDir)) {
+  const previewDir = path8.join(rootDir2, "previews", name);
+  if (existsSync6(previewDir)) {
     console.error(`Preview "${name}" already exists at: ${previewDir}`);
     process.exit(1);
   }
@@ -1200,8 +1268,8 @@ export default function App() {
   .dark\\:text-white { color: #fff; }
 }
 `;
-  writeFileSync3(path7.join(previewDir, "App.tsx"), appTsx);
-  writeFileSync3(path7.join(previewDir, "styles.css"), stylesCss);
+  writeFileSync3(path8.join(previewDir, "App.tsx"), appTsx);
+  writeFileSync3(path8.join(previewDir, "styles.css"), stylesCss);
   console.log(`
   ✨ Created preview: previews/${name}/
 

package/package.json

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