@knowcode/doc-builder 1.10.4 → 1.10.6

package/lib/core-builder.js

@@ -413,7 +413,12 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
   // Get doc-builder version from package.json
   const packageJson = require('../package.json');
   const docBuilderVersion = packageJson.version;
-  
+
+  // Extract source metadata if available
+  const sourceMetadata = config._sourceMetadata || {};
+  const sourcePath = sourceMetadata.sourcePath || '';
+  const generatedAt = sourceMetadata.generatedAt || new Date().toISOString();
+
   // SEO preparation
   let seoTags = '';
   let jsonLd = '';
@@ -498,7 +503,11 @@ function generateHTML(title, content, navigation, currentPath = '', config = {},
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <meta name="description" content="${escapeHtml(pageDescription || generateDescription(originalContent || content) || siteDescription)}">
     <title>${escapeHtml(finalSeoTitle || `${title} - ${siteName}`)}</title>
-    
+
+    <!-- Source metadata -->
+    ${sourcePath ? `<meta name="md-source" content="${escapeHtml(sourcePath)}">` : ''}
+    <meta name="doc-generated" content="${escapeHtml(generatedAt)}">
+
 ${seoTags}
     
     <!-- Fonts -->
@@ -833,6 +842,13 @@ ${seoTags}
         mermaidEnhanced: ${config.features?.mermaidEnhanced !== false}
       }
     };
+
+    // Source metadata for JS consumers
+    window.__DOC_SOURCE__ = {
+      mdSource: ${sourcePath ? `"${escapeHtml(sourcePath)}"` : 'null'},
+      generatedAt: "${escapeHtml(generatedAt)}",
+      docBuilderVersion: "${docBuilderVersion}"
+    };
     </script>
     <script src="${resourcePath}js/main.js"></script>
     ${(config.features?.authentication === 'supabase' || config.features?.privateDirectoryAuth === true) ? `<script src="https://unpkg.com/@supabase/supabase-js@2"></script>
@@ -1140,16 +1156,26 @@ async function processMarkdownFile(filePath, outputPath, allFiles, config, useSt
   
   // Process content
   const htmlContent = processMarkdownContent(content, config);
-  
+
+  // Create config with source metadata for HTML generation
+  const generationTimestamp = new Date().toISOString();
+  const htmlConfig = {
+    ...config,
+    _sourceMetadata: {
+      sourcePath: relativePath,  // e.g., "docs/technical/local-dev-troubleshooting.md"
+      generatedAt: generationTimestamp
+    }
+  };
+
   // Build navigation - pass config to handle private file filtering
   // For static HTML, we need to build navigation with relative paths
-  const navConfig = useStaticHTML ? { ...config, isStaticOutput: true } : config;
+  const navConfig = useStaticHTML ? { ...htmlConfig, isStaticOutput: true } : htmlConfig;
   const navigation = buildNavigationStructure(allFiles, urlPath, navConfig);
-  
+
   // Generate full HTML (pass original content and front matter for SEO)
-  const html = useStaticHTML 
-    ? generateStaticHTML(title, htmlContent, navigation, urlPath, config, content, frontMatter)
-    : generateHTML(title, htmlContent, navigation, urlPath, config, content, frontMatter);
+  const html = useStaticHTML
+    ? generateStaticHTML(title, htmlContent, navigation, urlPath, htmlConfig, content, frontMatter)
+    : generateHTML(title, htmlContent, navigation, urlPath, htmlConfig, content, frontMatter);
   
   // Write file
   await fs.ensureDir(path.dirname(outputPath));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.10.4",
+  "version": "1.10.6",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {