@aravindc26/velu 0.12.9 → 0.12.10

package/package.json

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

package/src/cli.ts

@@ -511,30 +511,37 @@ function previewServerEnv(): NodeJS.ProcessEnv {
 }
 
 async function previewServer(port: number) {
-  const runtimeDir = join(PACKAGE_ROOT, ".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");
 
-  // Clean and copy MAIN ENGINE to runtime dir
-  try { rmSync(runtimeDir, { recursive: true, force: true }); } catch {}
-  copyDirMerge(PREVIEW_ENGINE_DIR, runtimeDir);
+  // 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"));
+    // 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
+  // Activate preview routes: move _preview/* to app root (idempotent — skips if already done)
   const appDir = join(runtimeDir, "app");
   const previewDir = join(appDir, "_preview");
 
-  // 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
   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 });
   }

package/src/engine/lib/preview-content.ts

@@ -22,19 +22,15 @@ const WORKSPACE_DIR = process.env.WORKSPACE_DIR || '/mnt/nfs_share/editor_sessio
 const PRIMARY_CONFIG_NAME = 'docs.json';
 const LEGACY_CONFIG_NAME = 'velu.json';
 
-const STATIC_EXTENSIONS = new Set([
-  '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.ico',
-  '.mp4', '.webm',
-  '.mp3', '.wav',
-  '.json', '.yaml', '.yml',
-  '.css',
-]);
-
 /**
- * Copy static assets (images, JSON specs, etc.) from workspace to public/
- * so that OpenAPI spec files and images are resolvable by components.
+ * Copy only spec files (JSON/YAML) from workspace to public/ so the
+ * OpenAPI component can resolve them. Images and other assets are served
+ * on-demand through the session assets API route, so we skip them here
+ * to keep session init fast.
  */
-function copyStaticAssets(docsDir: string): void {
+const SPEC_EXTENSIONS = new Set(['.json', '.yaml', '.yml']);
+
+function copySpecFiles(docsDir: string): void {
   const publicDir = resolve('public');
 
   function walk(dir: string): void {
@@ -49,7 +45,7 @@ function copyStaticAssets(docsDir: string): void {
         continue;
       }
       const ext = extname(entry.name).toLowerCase();
-      if (!STATIC_EXTENSIONS.has(ext)) continue;
+      if (!SPEC_EXTENSIONS.has(ext)) continue;
       const rel = relative(docsDir, srcPath);
       const destPath = join(publicDir, rel);
       mkdirSync(dirname(destPath), { recursive: true });
@@ -622,8 +618,8 @@ export function generateSessionContent(sessionId: string): {
   }
   mkdirSync(outputDir, { recursive: true });
 
-  // Copy static assets (images, OpenAPI specs, etc.) to public/ so components can resolve them
-  copyStaticAssets(workspaceDir);
+  // Copy spec files (JSON/YAML) to public/ so the OpenAPI component can resolve them
+  copySpecFiles(workspaceDir);
 
   const { config, variables } = loadConfig(workspaceDir);
   const navLanguages = config.navigation?.languages;