@knowcode/doc-builder 1.10.5 → 1.10.6

package/lib/core-builder.js

@@ -349,21 +349,16 @@ function processMarkdownContent(content, config = {}) {
   
   // Parse the markdown
   let html = marked.parse(processedContent);
-
+  
   // Replace placeholders with actual mermaid blocks
   mermaidBlocks.forEach((block, index) => {
     html = html.replace(`<p>MERMAID_BLOCK_${index}</p>`, block);
     html = html.replace(`MERMAID_BLOCK_${index}`, block);
   });
-
-  // Convert internal .md links to .html links
-  // Matches href="...md" or href='...md' and converts to .html
-  // Handles: file.md, path/file.md, file.md#anchor, file.md?query
-  html = html.replace(/href=(["'])([^"']*?)\.md((?:#[^"']*)?(?:\?[^"']*)?)\1/gi, 'href=$1$2.html$3$1');
-
+  
   // Replace emojis with Phosphor icons if enabled
   html = replaceEmojisWithIcons(html, config);
-
+  
   return html;
 }
 
@@ -418,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 = '';
@@ -503,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 -->
@@ -838,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>
@@ -1145,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.5",
+  "version": "1.10.6",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {