@aravindc26/velu 0.12.8 → 0.12.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aravindc26/velu",
-  "version": "0.12.8",
+  "version": "0.12.10",
   "description": "A modern documentation site generator powered by Markdown and JSON configuration",
   "type": "module",
   "license": "MIT",

package/src/build.ts

@@ -11,6 +11,9 @@ const __dirname = dirname(__filename);
 const PACKAGED_ENGINE_DIR = join(__dirname, "engine");
 const DEV_ENGINE_DIR = join(__dirname, "..", "src", "engine");
 const ENGINE_DIR = existsSync(DEV_ENGINE_DIR) ? DEV_ENGINE_DIR : PACKAGED_ENGINE_DIR;
+const PACKAGED_ENGINE_CORE_DIR = join(__dirname, "engine-core");
+const DEV_ENGINE_CORE_DIR = join(__dirname, "..", "src", "engine-core");
+const ENGINE_CORE_DIR = existsSync(DEV_ENGINE_CORE_DIR) ? DEV_ENGINE_CORE_DIR : PACKAGED_ENGINE_CORE_DIR;
 const CLI_PACKAGE_JSON_PATH = join(__dirname, "..", "package.json");
 const PRIMARY_CONFIG_NAME = "docs.json";
 const LEGACY_CONFIG_NAME = "velu.json";
@@ -1193,6 +1196,16 @@ function build(docsDir: string, outDir: string) {
   cpSync(ENGINE_DIR, outDir, { recursive: true });
   // Remove legacy Astro template leftovers if present in the packaged engine.
   rmSync(join(outDir, "src"), { recursive: true, force: true });
+
+  // Copy engine-core for shared components, CSS, and plugins (@core/* imports)
+  cpSync(ENGINE_CORE_DIR, join(outDir, "engine-core"), { recursive: true });
+
+  // Patch tsconfig so @core/* resolves to the co-located engine-core copy
+  const outTsconfigPath = join(outDir, "tsconfig.json");
+  if (existsSync(outTsconfigPath)) {
+    const tsconfigContent = readFileSync(outTsconfigPath, "utf-8");
+    writeFileSync(outTsconfigPath, tsconfigContent.replace('"../engine-core/*"', '"./engine-core/*"'), "utf-8");
+  }
   console.log("📦 Copied engine files");
 
   // ── 2. Create additional directories ─────────────────────────────────────

package/src/cli.ts

@@ -266,7 +266,7 @@ function prepareRuntimeOutDir(docsOutDir: string): string {
 
 async function buildStatic(outDir: string, docsDir: string) {
   await new Promise<void>((res, rej) => {
-    const child = spawn("node", ["_server.mjs", "build"], {
+    const child = spawn(process.execPath, ["_server.mjs", "build"], {
       cwd: outDir,
       stdio: "inherit",
       env: engineEnv(docsDir),
@@ -491,8 +491,14 @@ async function buildSite(docsDir: string) {
 // ── preview-server ───────────────────────────────────────────────────────────────
 
 const PREVIEW_ENGINE_DIR = (() => {
-  const dev = join(PACKAGE_ROOT, "src", "preview-engine");
-  const packaged = join(dirname(__filename), "preview-engine");
+  const dev = join(PACKAGE_ROOT, "src", "engine");
+  const packaged = join(dirname(__filename), "engine");
+  return existsSync(dev) ? dev : packaged;
+})();
+
+const ENGINE_CORE_DIR = (() => {
+  const dev = join(PACKAGE_ROOT, "src", "engine-core");
+  const packaged = join(dirname(__filename), "engine-core");
   return existsSync(dev) ? dev : packaged;
 })();
 
@@ -505,16 +511,57 @@ function previewServerEnv(): NodeJS.ProcessEnv {
 }
 
 async function previewServer(port: number) {
-  const runtimeDir = join(tmpdir(), "velu-preview-out");
+  // Allow Docker to pre-populate the runtime dir via PREVIEW_RUNTIME_DIR
+  const runtimeDir = process.env.PREVIEW_RUNTIME_DIR || join(PACKAGE_ROOT, ".preview-out");
+
+  // Skip engine copy if the runtime dir is already set up (e.g. Docker pre-copy)
+  const runtimeAppDir = join(runtimeDir, "app");
+  if (existsSync(runtimeAppDir) && process.env.PREVIEW_RUNTIME_DIR) {
+    // Runtime dir already exists and was explicitly set — skip copy
+  } else {
+    // Clean and copy MAIN ENGINE to runtime dir
+    try { rmSync(runtimeDir, { recursive: true, force: true }); } catch {}
+    copyDirMerge(PREVIEW_ENGINE_DIR, runtimeDir);
+
+    // Copy engine-core for shared components, CSS, and plugins (@core/* imports)
+    copyDirMerge(ENGINE_CORE_DIR, join(runtimeDir, "engine-core"));
+  }
+
+  // Activate preview routes: move _preview/* to app root (idempotent — skips if already done)
+  const appDir = join(runtimeDir, "app");
+  const previewDir = join(appDir, "_preview");
 
-  // Clean and copy preview engine to runtime dir
-  try { rmSync(runtimeDir, { recursive: true, force: true }); } catch {}
-  copyDirMerge(PREVIEW_ENGINE_DIR, runtimeDir);
+  if (existsSync(previewDir)) {
+    // Remove production-only routes that don't apply to preview
+    for (const dir of ["(docs)", "sitemap.xml", "robots.txt", "og", "llms-file", "llms-full-file", "md-file", "rss-file", "_md"]) {
+      try { rmSync(join(appDir, dir), { recursive: true, force: true }); } catch {}
+    }
+    // Remove production root layout/page (preview has its own in _preview/)
+    for (const file of ["layout.tsx", "page.tsx"]) {
+      try { rmSync(join(appDir, file), { force: true }); } catch {}
+    }
+
+    // Move preview routes to app root
+    copyDirMerge(previewDir, appDir);
+    rmSync(previewDir, { recursive: true, force: true });
+  }
+
+  // Create velu-theme.css that imports fumadocs neutral theme as baseline
+  // (per-session themes override via <style> tags injected in session layout)
+  writeFileSync(join(appDir, "velu-theme.css"), "@import 'fumadocs-ui/css/neutral.css';\n", "utf-8");
+
+  // Patch tsconfig so @core/* resolves to the co-located engine-core copy
+  const runtimeTsconfig = join(runtimeDir, "tsconfig.json");
+  if (existsSync(runtimeTsconfig)) {
+    const tsconfigContent = readFileSync(runtimeTsconfig, "utf-8");
+    writeFileSync(runtimeTsconfig, tsconfigContent.replace('"../engine-core/*"', '"./engine-core/*"'), "utf-8");
+  }
 
-  // Symlink node_modules so Next.js can resolve dependencies (fumadocs-mdx, etc.)
+  // Link node_modules so Next.js can resolve dependencies (fumadocs-mdx, etc.)
+  // Use 'junction' on Windows (no elevation required), symlink on other platforms
   const runtimeNodeModules = join(runtimeDir, "node_modules");
   if (!existsSync(runtimeNodeModules)) {
-    symlinkSync(NODE_MODULES_PATH, runtimeNodeModules);
+    symlinkSync(NODE_MODULES_PATH, runtimeNodeModules, "junction");
   }
 
   console.log(`  Starting preview server on port ${port}...`);
@@ -524,11 +571,13 @@ async function previewServer(port: number) {
   // Resolve the next binary from the CLI's own node_modules
   const nextBinPath = join(NODE_MODULES_PATH, "next", "dist", "bin", "next");
 
-  const child = spawn("node", [nextBinPath, "dev", "--port", String(port), "--turbopack"], {
+  const child = spawn(process.execPath, [nextBinPath, "dev", "--port", String(port), "--turbopack"], {
     cwd: runtimeDir,
     stdio: ["inherit", "pipe", "inherit"],
     env: {
       ...previewServerEnv(),
+      // Align source.config.ts and content-generator on the same content dir
+      PREVIEW_CONTENT_DIR: process.env.PREVIEW_CONTENT_DIR || "./content",
       WATCHPACK_POLLING: process.env.WATCHPACK_POLLING || "true",
     },
   });
@@ -571,7 +620,7 @@ function warmupRoutes(port: number) {
 // ── run ──────────────────────────────────────────────────────────────────────────
 
 function spawnServer(outDir: string, command: string, port: number, docsDir: string) {
-  const child = spawn("node", ["_server.mjs", command, "--port", String(port)], {
+  const child = spawn(process.execPath, ["_server.mjs", command, "--port", String(port)], {
     cwd: outDir,
     stdio: "inherit",
     env: engineEnv(docsDir),