prev-cli 0.14.0 → 0.15.0

package/dist/cli.js

@@ -2,8 +2,9 @@
 
 // src/cli.ts
 import { parseArgs } from "util";
-import path7 from "path";
-import { existsSync as existsSync5, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } 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
 import { createServer as createServer2, build as build2, preview } from "vite";
@@ -895,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");
@@ -905,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({
@@ -921,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 = {}) {
@@ -960,6 +1029,21 @@ async function previewSite(rootDir, options = {}) {
 }
 
 // src/cli.ts
+function getVersion() {
+  try {
+    let dir = path8.dirname(fileURLToPath3(import.meta.url));
+    for (let i = 0;i < 5; i++) {
+      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 = path8.dirname(dir);
+    }
+  } catch {}
+  return "unknown";
+}
 var { values, positionals } = parseArgs({
   args: process.argv.slice(2),
   options: {
@@ -967,12 +1051,13 @@ var { values, positionals } = parseArgs({
     days: { type: "string", short: "d" },
     cwd: { type: "string", short: "c" },
     include: { type: "string", short: "i", multiple: true },
-    help: { type: "boolean", short: "h" }
+    help: { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" }
   },
   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
@@ -982,7 +1067,8 @@ Usage:
   prev build [options]        Build for production
   prev preview [options]      Preview production build
   prev create [name]          Create preview in previews/<name>/ (default: "example")
-  prev clean [options]        Remove old cache directories
+  prev clearcache             Clear Vite cache (.vite directory)
+  prev clean [options]        Remove old prev-cli caches
 
 Options:
   -c, --cwd <path>       Set working directory
@@ -990,6 +1076,7 @@ Options:
   -i, --include <dir>    Include dot-prefixed directory (can use multiple times)
   -d, --days <days>      Cache age threshold for clean (default: 30)
   -h, --help             Show this help message
+  -v, --version          Show version number
 
 Previews:
   Previews must be in the previews/ directory at your project root.
@@ -1033,9 +1120,30 @@ Examples:
   prev clean -d 7            Remove caches older than 7 days
 `);
 }
+function clearViteCache(rootDir2) {
+  const viteCacheDir = path8.join(rootDir2, ".vite");
+  const nodeModulesVite = path8.join(rootDir2, "node_modules", ".vite");
+  let cleared = 0;
+  if (existsSync6(viteCacheDir)) {
+    rmSync3(viteCacheDir, { recursive: true });
+    cleared++;
+    console.log(`  ✓ Removed .vite/`);
+  }
+  if (existsSync6(nodeModulesVite)) {
+    rmSync3(nodeModulesVite, { recursive: true });
+    cleared++;
+    console.log(`  ✓ Removed node_modules/.vite/`);
+  }
+  if (cleared === 0) {
+    console.log("  No Vite cache found");
+  } else {
+    console.log(`
+  Cleared ${cleared} cache director${cleared === 1 ? "y" : "ies"}`);
+  }
+}
 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);
   }
@@ -1160,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}/
 
@@ -1178,6 +1286,10 @@ export default function App() {
 `);
 }
 async function main() {
+  if (values.version) {
+    console.log(`prev-cli v${getVersion()}`);
+    process.exit(0);
+  }
   if (values.help) {
     printHelp();
     process.exit(0);
@@ -1204,6 +1316,9 @@ async function main() {
         const previewName = positionals[1] || "example";
         createPreview(rootDir, previewName);
         break;
+      case "clearcache":
+        clearViteCache(rootDir);
+        break;
       default:
         console.error(`Unknown command: ${command}`);
         printHelp();

package/package.json

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