@aravindc26/velu 0.12.11 → 0.12.13

package/package.json

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

package/src/cli.ts

@@ -578,7 +578,7 @@ async function previewServer(port: number) {
       ...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",
+      WATCHPACK_POLLING: process.env.WATCHPACK_POLLING || "false",
     },
   });
 

package/src/engine/app/_preview/api/sessions/[sessionId]/init/route.ts

@@ -1,7 +1,37 @@
 import { NextRequest } from 'next/server';
+import { existsSync, utimesSync, statSync } from 'node:fs';
+import { resolve } from 'node:path';
 import { generateSessionContent } from '@/lib/preview-content';
 import { verifyApiSecret, unauthorizedResponse } from '@/lib/preview-auth';
 
+/**
+ * Touch source.config.ts to trigger fumadocs-mdx rescan,
+ * then wait for the .source output to regenerate.
+ */
+async function triggerMdxRegeneration(): Promise<void> {
+  const configPath = resolve(process.cwd(), 'source.config.ts');
+  const sourceDir = resolve(process.cwd(), '.source');
+
+  // Record current .source mtime (if it exists)
+  const beforeMtime = existsSync(sourceDir)
+    ? statSync(sourceDir).mtimeMs
+    : 0;
+
+  // Touch source.config.ts to trigger chokidar → fumadocs-mdx full reload
+  const now = new Date();
+  utimesSync(configPath, now, now);
+
+  // Wait for .source directory to be updated (up to 30s)
+  for (let i = 0; i < 300; i++) {
+    await new Promise((r) => setTimeout(r, 100));
+    if (existsSync(sourceDir)) {
+      const currentMtime = statSync(sourceDir).mtimeMs;
+      if (currentMtime > beforeMtime) return;
+    }
+  }
+  console.warn('[PREVIEW] MDX regeneration timed out after 30s');
+}
+
 export async function POST(
   request: NextRequest,
   { params }: { params: Promise<{ sessionId: string }> },
@@ -12,6 +42,10 @@ export async function POST(
 
   try {
     const result = generateSessionContent(sessionId);
+
+    // Trigger fumadocs-mdx to discover the new content files
+    await triggerMdxRegeneration();
+
     return Response.json({
       status: 'ready',
       url: `/${sessionId}/`,

package/src/engine/lib/docs-layout.tsx

@@ -2,7 +2,7 @@
  * Shared docs layout rendering logic.
  * Used by both (docs)/[...slug]/layout.tsx (production) and _preview/ routes.
  */
-import { isValidElement, type ReactNode } from 'react';
+import React, { isValidElement, type ReactNode } from 'react';
 import { DocsLayout } from 'fumadocs-ui/layouts/notebook';
 import type { LinkItemType, BaseLayoutProps } from 'fumadocs-ui/layouts/shared';
 import { SidebarLinks } from '@/components/sidebar-links';
@@ -477,7 +477,7 @@ export interface DocsLayoutConfig {
   urlPrefix?: string;
 }
 
-export function renderDocsLayout(config: DocsLayoutConfig, children: ReactNode): JSX.Element {
+export function renderDocsLayout(config: DocsLayoutConfig, children: ReactNode): React.JSX.Element {
   const {
     slug: slugInput,
     tree: localePageTree,

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

@@ -110,7 +110,7 @@ interface PageMapping {
 
 interface MetaFile {
   dir: string;
-  data: { pages: string[]; title?: string; description?: string };
+  data: { pages: string[]; title?: string; description?: string; [key: string]: unknown };
 }
 
 interface BuildArtifacts {
@@ -415,7 +415,7 @@ function buildArtifacts(config: VeluConfig, docsDir?: string): BuildArtifacts {
       }
     }
 
-    const groupMetaData: Record<string, unknown> = {
+    const groupMetaData: MetaFile['data'] = {
       title: group.group,
       pages: groupMetaPages,
       defaultOpen: group.expanded !== false,