@knowcode/doc-builder 1.9.6 → 1.9.8

package/doc-builder.config.js

@@ -1,16 +1,41 @@
 module.exports = {
-  "siteName": "@knowcode/doc-builder",
-  "siteDescription": "Beautiful documentation with the least effort possible",
+  "configVersion": "1.9.7",
   "docsDir": "docs",
   "outputDir": "html",
-  "productionUrl": "https://doc-builder-delta.vercel.app",
+  "siteName": "@knowcode/doc-builder",
+  "siteDescription": "Beautiful documentation with the least effort possible",
+  "favicon": "✨",
   "features": {
     "authentication": false,
     "changelog": true,
     "mermaid": true,
+    "tooltips": true,
+    "search": false,
     "darkMode": true,
     "phosphorIcons": true,
-    "menuDefaultOpen": false
+    "phosphorWeight": "regular",
+    "phosphorSize": "1.2em",
+    "normalizeTitle": true,
+    "showPdfDownload": true,
+    "menuDefaultOpen": false,
+    "attachments": true,
+    "dynamicNavIcons": true,
+    "subtleColors": true
+  },
+  "auth": {
+    "supabaseUrl": "https://xcihhnfcitjrwbynxmka.supabase.co",
+    "supabaseAnonKey": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhjaWhobmZjaXRqcndieW54bWthIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NTM0Mzc2MzcsImV4cCI6MjA2OTAxMzYzN30.zvWp3JFIR8fBIiwuFF5gqOR_Kxb42baZS5fsBz60XOY"
+  },
+  "changelog": {
+    "daysBack": 14,
+    "enabled": true
+  },
+  "folderOrder": [],
+  "folderDescriptions": {},
+  "folderIcons": {},
+  "deployment": {
+    "platform": "vercel",
+    "outputDirectory": "html"
   },
   "seo": {
     "enabled": true,
@@ -25,13 +50,18 @@ module.exports = {
       "vercel",
       "notion-style"
     ],
-    "generateSitemap": true,
-    "generateRobotsTxt": true,
-    "ogImage": "/og-default.png",
+    "titleTemplate": "{pageTitle} | {siteName}",
+    "autoKeywords": true,
+    "keywordLimit": 7,
+    "descriptionFallback": "smart",
     "organization": {
       "name": "Knowcode Ltd",
-      "url": "https://knowcode.tech"
+      "url": "https://knowcode.tech",
+      "logo": ""
     },
+    "ogImage": "/og-default.png",
+    "generateSitemap": true,
+    "generateRobotsTxt": true,
     "customMetaTags": [
       {
         "name": "google-site-verification",
@@ -42,5 +72,43 @@ module.exports = {
         "content": "B2D8C4C12C530D47AA962B24CAA09630"
       }
     ]
-  }
+  },
+  "attachmentTypes": [
+    ".pdf",
+    ".doc",
+    ".docx",
+    ".xls",
+    ".xlsx",
+    ".csv",
+    ".ppt",
+    ".pptx",
+    ".txt",
+    ".rtf",
+    ".html",
+    ".htm",
+    ".zip",
+    ".tar",
+    ".gz",
+    ".7z",
+    ".rar",
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".svg",
+    ".webp",
+    ".ico",
+    ".bmp",
+    ".json",
+    ".xml",
+    ".yaml",
+    ".yml",
+    ".toml",
+    ".mp4",
+    ".mp3",
+    ".wav",
+    ".avi",
+    ".mov"
+  ],
+  "productionUrl": "https://doc-builder-delta.vercel.app"
 };

package/doc-builder.config.js.backup.1753793768283

@@ -0,0 +1,47 @@
+module.exports = {
+  "configVersion": "1.9.6",
+  "siteName": "@knowcode/doc-builder",
+  "siteDescription": "Beautiful documentation with the least effort possible",
+  "docsDir": "docs",
+  "outputDir": "html",
+  "productionUrl": "https://doc-builder-delta.vercel.app",
+  "features": {
+    "authentication": false,
+    "changelog": true,
+    "mermaid": true,
+    "darkMode": true,
+    "phosphorIcons": true,
+    "menuDefaultOpen": false
+  },
+  "seo": {
+    "enabled": true,
+    "siteUrl": "https://doc-builder-delta.vercel.app",
+    "author": "Lindsay Smith",
+    "twitterHandle": "@planbbackups",
+    "language": "en-US",
+    "keywords": [
+      "documentation",
+      "markdown",
+      "static site generator",
+      "vercel",
+      "notion-style"
+    ],
+    "generateSitemap": true,
+    "generateRobotsTxt": true,
+    "ogImage": "/og-default.png",
+    "organization": {
+      "name": "Knowcode Ltd",
+      "url": "https://knowcode.tech"
+    },
+    "customMetaTags": [
+      {
+        "name": "google-site-verification",
+        "content": "FtzcDTf5BQ9K5EfnGazQkgU2U4FiN3ITzM7gHwqUAqQ"
+      },
+      {
+        "name": "msvalidate.01",
+        "content": "B2D8C4C12C530D47AA962B24CAA09630"
+      }
+    ]
+  }
+};

package/lib/config.js

@@ -1,12 +1,16 @@
 const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
+const semver = require('semver');
 const sharedAuth = require('./shared-auth-config');
 
 /**
  * Default configuration
  */
 const defaultConfig = {
+  // Configuration version - updated when new config options are added
+  configVersion: require('../package.json').version,
+  
   // Source and output directories
   docsDir: 'docs',
   outputDir: 'html',
@@ -214,6 +218,112 @@ const notionInspiredPreset = {
   }
 };
 
+/**
+ * Check if config migration is needed
+ * @param {object} userConfig - Current user configuration
+ * @param {string} packageVersion - Current package version
+ * @returns {boolean} - Whether migration is needed
+ */
+function needsMigration(userConfig, packageVersion) {
+  // If no configVersion in user config, it needs migration
+  if (!userConfig.configVersion) {
+    return true;
+  }
+  
+  try {
+    // Use semver to compare versions
+    return semver.lt(userConfig.configVersion, packageVersion);
+  } catch (error) {
+    console.warn(chalk.yellow(`Warning: Invalid version format in config: ${userConfig.configVersion}`));
+    return true; // Migrate on version parse errors
+  }
+}
+
+/**
+ * Deep merge objects, preserving user customizations
+ * @param {object} target - Target object (defaults)
+ * @param {object} source - Source object (user config)
+ * @returns {object} - Merged object
+ */
+function deepMerge(target, source) {
+  const result = { ...target };
+  
+  for (const key in source) {
+    if (source.hasOwnProperty(key)) {
+      if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
+        // Recursively merge objects
+        result[key] = deepMerge(target[key] || {}, source[key]);
+      } else {
+        // Use source value (user customization takes precedence)
+        result[key] = source[key];
+      }
+    }
+  }
+  
+  return result;
+}
+
+/**
+ * Migrate user configuration to current version
+ * @param {object} userConfig - Current user configuration
+ * @param {string} targetVersion - Target package version
+ * @returns {object} - Migrated configuration
+ */
+function migrateConfig(userConfig, targetVersion) {
+  console.log(chalk.blue(`🔄 Migrating config from ${userConfig.configVersion || 'unknown'} to ${targetVersion}`));
+  
+  // Start with current defaults
+  let migratedConfig = { ...defaultConfig };
+  
+  // Deep merge user customizations
+  migratedConfig = deepMerge(migratedConfig, userConfig);
+  
+  // Update the config version
+  migratedConfig.configVersion = targetVersion;
+  
+  // Log new features added
+  const newFeatures = [];
+  if (!userConfig.features?.dynamicNavIcons) {
+    newFeatures.push('Dynamic navigation icons');
+  }
+  if (!userConfig.features?.subtleColors) {
+    newFeatures.push('Subtle status colors');
+  }
+  if (!userConfig.features?.phosphorWeight) {
+    newFeatures.push('Phosphor icon weight options');
+  }
+  if (!userConfig.features?.phosphorSize) {
+    newFeatures.push('Phosphor icon sizing');
+  }
+  
+  if (newFeatures.length > 0) {
+    console.log(chalk.green(`✨ Added new features: ${newFeatures.join(', ')}`));
+  }
+  
+  return migratedConfig;
+}
+
+/**
+ * Save configuration to file
+ * @param {string} configPath - Path to config file
+ * @param {object} config - Configuration object to save
+ */
+async function saveConfig(configPath, config) {
+  // Create backup of existing config
+  if (fs.existsSync(configPath)) {
+    const backupPath = `${configPath}.backup.${Date.now()}`;
+    await fs.copy(configPath, backupPath);
+    console.log(chalk.gray(`💾 Backed up existing config to ${path.basename(backupPath)}`));
+  }
+  
+  // Format config as module.exports
+  const configContent = `module.exports = ${JSON.stringify(config, null, 2)};
+`;
+  
+  await fs.writeFile(configPath, configContent);
+  console.log(chalk.green(`✅ Updated config file: ${path.basename(configPath)}`));
+}
+
 /**
  * Load configuration
  */
@@ -230,7 +340,15 @@ async function loadConfig(configPath, options = {}) {
   if (fs.existsSync(customConfigPath)) {
     try {
       const customConfig = require(customConfigPath);
-      config = { ...config, ...customConfig };
+      const packageJson = require('../package.json');
+      
+      // Check if migration is needed
+      if (needsMigration(customConfig, packageJson.version)) {
+        config = migrateConfig(customConfig, packageJson.version);
+        await saveConfig(customConfigPath, config);
+      } else {
+        config = { ...config, ...customConfig };
+      }
       
       // Handle alternative config formats
       if (customConfig.site) {
@@ -257,7 +375,10 @@ async function loadConfig(configPath, options = {}) {
       console.warn(chalk.yellow(`Warning: Failed to load config file: ${error.message}`));
     }
   } else if (!options.preset && !options.legacy) {
-    console.log(chalk.gray('No config file found, using defaults'));
+    console.log(chalk.gray('No config file found, creating default config...'));
+    // Create default config file with all settings
+    await saveConfig(customConfigPath, config);
+    console.log(chalk.green(`✅ Created ${configPath} with default settings`));
   }
   
   // Apply CLI options (these override config file)
@@ -358,5 +479,8 @@ module.exports = {
   defaultConfig,
   notionInspiredPreset,
   loadConfig,
-  createDefaultConfig
+  createDefaultConfig,
+  needsMigration,
+  migrateConfig,
+  saveConfig
 };

package/lib/core-builder.js

@@ -1326,7 +1326,7 @@ async function generateSupabaseAuthFiles(outputDir, config) {
   const supabaseAuth = new SupabaseAuth(authConfig);
 
   // Generate auth script and save to js/auth.js
-  const authScript = supabaseAuth.generateAuthScript();
+  const authScript = supabaseAuth.generateAuthScript(config);
   await fs.writeFile(path.join(outputDir, 'js', 'auth.js'), authScript);
 
   // Also copy to root for backward compatibility

package/lib/emoji-mapper.js

@@ -81,6 +81,7 @@ const emojiToPhosphor = {
   '🧭': '<i class="ph ph-compass" aria-label="navigation"></i>',
   '🗺️': '<i class="ph ph-map-trifold" aria-label="map"></i>',
   '🌐': '<i class="ph ph-globe" aria-label="global"></i>',
+  '🌍': '<i class="ph ph-globe-hemisphere-west" aria-label="world"></i>',
   
   // Communication
   '📧': '<i class="ph ph-envelope" aria-label="email"></i>',
@@ -250,6 +251,20 @@ const emojiToPhosphor = {
   '📑': '<i class="ph ph-file-text" aria-label="document"></i>',
   '💀': '<i class="ph ph-skull" aria-label="skull"></i>',
   '🔤': '<i class="ph ph-textbox" aria-label="letters"></i>',
+  '🧱': '<i class="ph ph-wall" aria-label="brick"></i>',
+  '🖼️': '<i class="ph ph-image" aria-label="picture"></i>',
+  '🎂': '<i class="ph ph-cake" aria-label="birthday"></i>',
+  '↩️': '<i class="ph ph-arrow-u-left" aria-label="return"></i>',
+  '📜': '<i class="ph ph-scroll" aria-label="scroll"></i>',
+  '🕰️': '<i class="ph ph-clock" aria-label="clock"></i>',
+  '🧮': '<i class="ph ph-calculator" aria-label="calculator"></i>',
+  '🎫': '<i class="ph ph-ticket" aria-label="ticket"></i>',
+  '🌿': '<i class="ph ph-leaf" aria-label="leaf"></i>',
+  '🥊': '<i class="ph ph-boxing-glove" aria-label="boxing"></i>',
+  '🎛️': '<i class="ph ph-faders" aria-label="controls"></i>',
+  '🗣️': '<i class="ph ph-megaphone-simple" aria-label="speaking"></i>',
+  '💝': '<i class="ph ph-gift" aria-label="gift with bow"></i>',
+  '🐌': '<i class="ph ph-spiral" aria-label="snail"></i>',
 };
 
 /**

package/lib/supabase-auth.js

@@ -26,7 +26,7 @@ class SupabaseAuth {
   /**
    * Generate client-side auth script for inclusion in HTML pages
    */
-  generateAuthScript() {
+  generateAuthScript(fullConfig) {
     return `
 /**
  * Supabase Authentication for Documentation Site
@@ -56,6 +56,9 @@ class SupabaseAuth {
     // Check authentication and site access
     async function checkAuth() {
         try {
+            // Check if global authentication is enabled
+            const isGlobalAuthEnabled = ${fullConfig.features?.authentication === 'supabase'};
+            
             // Check if current page is in private directory
             const currentPath = window.location.pathname;
             const isPrivatePage = currentPath.includes('/private/');
@@ -64,11 +67,11 @@ class SupabaseAuth {
             const { data: { user }, error: userError } = await supabaseClient.auth.getUser();
             
             if (userError || !user) {
-                // Only redirect if we're on a private page
-                if (isPrivatePage) {
+                // Redirect if global auth is enabled OR if we're on a private page
+                if (isGlobalAuthEnabled || isPrivatePage) {
                     redirectToLogin();
                 } else {
-                    // Public page, just show it
+                    // Truly public page (no global auth and not private)
                     document.body.classList.add('authenticated'); // Use same class to show body
                     updateAuthButton(false);
                 }
@@ -84,7 +87,7 @@ class SupabaseAuth {
                 .single();
             
             if (accessError || !access) {
-                if (isPrivatePage) {
+                if (isGlobalAuthEnabled || isPrivatePage) {
                     showAccessDenied();
                 } else {
                     // Public page, show it but don't grant private navigation access
@@ -102,7 +105,8 @@ class SupabaseAuth {
             
         } catch (error) {
             console.error('Auth check failed:', error);
-            if (window.location.pathname.includes('/private/')) {
+            const isGlobalAuthEnabled = ${fullConfig.features?.authentication === 'supabase'};
+            if (isGlobalAuthEnabled || window.location.pathname.includes('/private/')) {
                 redirectToLogin();
             } else {
                 // Public page, show it anyway

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knowcode/doc-builder",
-  "version": "1.9.6",
+  "version": "1.9.8",
   "description": "Reusable documentation builder for markdown-based sites with Vercel deployment support",
   "main": "index.js",
   "bin": {
@@ -37,7 +37,8 @@
     "gray-matter": "^4.0.3",
     "marked": "^15.0.12",
     "ora": "5.4.1",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "semver": "^7.7.2"
   },
   "engines": {
     "node": ">=14.0.0"