@knowcode/doc-builder 1.10.1 → 1.10.2

package/lib/core-builder.js

@@ -1361,18 +1361,19 @@ async function buildDocumentation(config) {
     console.log(chalk.green('✅ Copied 404.html for .md link handling'));
   }
   
-  // Create index.html from index.html, README.html, or generate default
+  // Create index.html with proper priority: index.md > README.md > auto-generated
   const indexPath = path.join(outputDir, 'index.html');
-  const indexSourcePath = path.join(outputDir, 'index.html'); // from index.md
   const readmePath = path.join(outputDir, 'README.html');
-  
+  const indexMdPath = path.join(docsDir, 'index.md');
+
   console.log(chalk.blue('\n📄 Checking for index.html creation...'));
   console.log(chalk.gray(`  - Output directory: ${outputDir}`));
   console.log(chalk.gray(`  - Index path: ${indexPath}`));
   console.log(chalk.gray(`  - README path: ${readmePath}`));
+  console.log(chalk.gray(`  - index.md exists: ${fs.existsSync(indexMdPath)}`));
   console.log(chalk.gray(`  - index.html exists: ${fs.existsSync(indexPath)}`));
   console.log(chalk.gray(`  - README.html exists: ${fs.existsSync(readmePath)}`));
-  
+
   // List all HTML files in output directory
   if (fs.existsSync(outputDir)) {
     const htmlFiles = fs.readdirSync(outputDir)
@@ -1381,22 +1382,27 @@ async function buildDocumentation(config) {
   } else {
     console.log(chalk.red(`  - ERROR: Output directory does not exist!`));
   }
-  
+
   // Check if we need to create/replace index.html
   let shouldCreateIndex = false;
-  
-  if (!fs.existsSync(indexPath)) {
+
+  // Priority 1: If index.md exists, index.html was generated from it - keep it
+  if (fs.existsSync(indexMdPath) && fs.existsSync(indexPath)) {
+    console.log(chalk.gray('ℹ️  index.md exists - index.html was generated from it, keeping as-is'));
+    shouldCreateIndex = false;
+  } else if (!fs.existsSync(indexPath)) {
+    // Priority 2: No index.html exists, need to create it
     console.log(chalk.yellow('⚠️  index.html does not exist, need to create it'));
     shouldCreateIndex = true;
-  } else if (fs.existsSync(readmePath)) {
-    // If README.html exists, always regenerate index.html from it to ensure current version
+  } else if (fs.existsSync(readmePath) && !fs.existsSync(indexMdPath)) {
+    // Priority 3: README.html exists but no index.md, use README as homepage
     console.log(chalk.blue('ℹ️  Regenerating index.html from README.html to ensure current version'));
     shouldCreateIndex = true;
   } else {
     // Check if existing index.html is likely a directory listing or outdated
     const indexStats = fs.statSync(indexPath);
     const indexContent = fs.readFileSync(indexPath, 'utf8');
-    
+
     // Check if it's a small file (likely directory listing) or contains directory listing markers
     if (indexStats.size < 3000 || indexContent.includes('<title>Documentation</title>') && indexContent.includes('<ul>') && !indexContent.includes('class="navigation"')) {
       console.log(chalk.yellow('⚠️  Existing index.html appears to be a directory listing (size: ' + indexStats.size + ' bytes), will replace it'));

package/package.json

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