@knowcode/doc-builder 1.6.4 → 1.7.0

package/html/sitemap.xml

@@ -2,127 +2,127 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
   <url>
     <loc>https://doc-builder-delta.vercel.app/404.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/README.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/documentation-index.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/authentication-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/document-standards.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/documentation-standards.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/phosphor-icons-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/search-engine-verification-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/seo-optimization-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/troubleshooting-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/guides/windows-setup-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/index.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/README.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/bubble-plugin-specification.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/go-to-market-strategy.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/launch/launch-announcements.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.6</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>
   <url>
     <loc>https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html</loc>
-    <lastmod>2025-07-23T09:32:06.341Z</lastmod>
+    <lastmod>2025-07-24T08:19:52.302Z</lastmod>
     <changefreq>monthly</changefreq>
     <priority>0.8</priority>
   </url>

package/html/vercel-cli-setup-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T09:32:06.313Z",
-  "dateModified": "2025-07-23T09:32:06.313Z",
+  "datePublished": "2025-07-24T08:19:52.285Z",
+  "dateModified": "2025-07-24T08:19:52.285Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-cli-setup-guide.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.3">Last updated: Jul 23, 2025, 09:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.5">Last updated: Jul 24, 2025, 08:19 AM UTC</span>
                 </div>
                 
                 
@@ -402,6 +402,15 @@ vercel --scope team-name
     </div>
     
     <!-- Scripts -->
+    <script>
+    // Pass configuration to frontend
+    window.docBuilderConfig = {
+      features: {
+        showPdfDownload: true,
+        menuDefaultOpen: true
+      }
+    };
+    </script>
     <script src="/js/main.js"></script>
     
 </body>

package/html/vercel-first-time-setup-guide.html

@@ -63,8 +63,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-23T09:32:06.319Z",
-  "dateModified": "2025-07-23T09:32:06.319Z",
+  "datePublished": "2025-07-24T08:19:52.288Z",
+  "dateModified": "2025-07-24T08:19:52.288Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/vercel-first-time-setup-guide.html"
@@ -97,7 +97,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.6.3">Last updated: Jul 23, 2025, 09:32 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.6.5">Last updated: Jul 24, 2025, 08:19 AM UTC</span>
                 </div>
                 
                 
@@ -245,7 +245,7 @@
 <li>Deploy to their global CDN</li>
 <li>Provide your live URL</li>
 </ol>
-<pre><code><i class="ph ph-check" aria-label="check"></i> Production: https://my-docs.vercel.app [copied to clipboard]
+<pre><code>✓ Production: https://my-docs.vercel.app [copied to clipboard]
 </code></pre>
 <h2>Post-Deployment Configuration</h2>
 <h3>Making Your Docs Public</h3>
@@ -324,13 +324,13 @@
 <li>You have internet connection</li>
 </ol>
 <h2>Quick Checklist</h2>
-<pre><code><i class="ph ph-check-circle" aria-label="checked"></i> 1. Run: npx @knowcode/doc-builder@latest deploy
-<i class="ph ph-check-circle" aria-label="checked"></i> 2. Enter project name (e.g., my-docs)
-<i class="ph ph-check-circle" aria-label="checked"></i> 3. Skip custom URL (press Enter)
-<i class="ph ph-check-circle" aria-label="checked"></i> 4. Confirm deployment when Vercel asks
-<i class="ph ph-check-circle" aria-label="checked"></i> 5. Select your account/scope
-<i class="ph ph-check-circle" aria-label="checked"></i> 6. Accept suggested project name
-<i class="ph ph-check-circle" aria-label="checked"></i> 7. Get your live URL!
+<pre><code>✅ 1. Run: npx @knowcode/doc-builder@latest deploy
+✅ 2. Enter project name (e.g., my-docs)
+✅ 3. Skip custom URL (press Enter)
+✅ 4. Confirm deployment when Vercel asks
+✅ 5. Select your account/scope
+✅ 6. Accept suggested project name
+✅ 7. Get your live URL!
 </code></pre>
 <h2>Best Practices</h2>
 <ol>
@@ -361,6 +361,15 @@
     </div>
     
     <!-- Scripts -->
+    <script>
+    // Pass configuration to frontend
+    window.docBuilderConfig = {
+      features: {
+        showPdfDownload: true,
+        menuDefaultOpen: true
+      }
+    };
+    </script>
     <script src="/js/main.js"></script>
     
 </body>

package/lib/config.js

@@ -28,7 +28,9 @@ const defaultConfig = {
     phosphorIcons: true,
     phosphorWeight: 'regular', // Options: thin, light, regular, bold, fill, duotone
     phosphorSize: '1.2em',     // Relative to text size
-    normalizeTitle: true       // Auto-normalize all-caps titles to title case
+    normalizeTitle: true,      // Auto-normalize all-caps titles to title case
+    showPdfDownload: true,     // Show PDF download icon in header
+    menuDefaultOpen: true      // Menu/sidebar open by default
   },
   
   // Authentication (if enabled)
@@ -96,7 +98,10 @@ const notionInspiredPreset = {
     darkMode: true,
     phosphorIcons: true,
     phosphorWeight: 'regular',
-    phosphorSize: '1.2em'
+    phosphorSize: '1.2em',
+    normalizeTitle: true,
+    showPdfDownload: true,
+    menuDefaultOpen: true
   },
   
   auth: {
@@ -248,6 +253,12 @@ async function loadConfig(configPath, options = {}) {
     config.features.changelog = false;
     config.changelog.enabled = false;
   }
+  if (options.pdf === false) {
+    config.features.showPdfDownload = false;
+  }
+  if (options.menuClosed === true) {
+    config.features.menuDefaultOpen = false;
+  }
   
   // Legacy mode - auto-detect structure
   if (options.legacy) {

package/lib/core-builder.js

@@ -425,6 +425,15 @@ ${seoTags}
     </div>
     
     <!-- Scripts -->
+    <script>
+    // Pass configuration to frontend
+    window.docBuilderConfig = {
+      features: {
+        showPdfDownload: ${config.features?.showPdfDownload !== false},
+        menuDefaultOpen: ${config.features?.menuDefaultOpen !== false}
+      }
+    };
+    </script>
     <script src="/js/main.js"></script>
     ${config.features?.authentication ? `<script src="/js/auth.js"></script>` : ''}
 </body>

package/lib/emoji-mapper.js

@@ -15,6 +15,7 @@ const emojiToPhosphor = {
   '⛔': '<i class="ph ph-prohibit" aria-label="prohibited"></i>',
   '🚫': '<i class="ph ph-prohibit-inset" aria-label="not allowed"></i>',
   '🚨': '<i class="ph ph-siren" aria-label="alert"></i>',
+  '🆘': '<i class="ph ph-first-aid" aria-label="emergency"></i>',
   
   // Development & Tech
   '💻': '<i class="ph ph-laptop" aria-label="laptop"></i>',
@@ -190,6 +191,7 @@ const emojiToPhosphor = {
   // Money & Commerce
   '💰': '<i class="ph ph-money" aria-label="money"></i>',
   '💵': '<i class="ph ph-currency-dollar" aria-label="dollar"></i>',
+  '💸': '<i class="ph ph-money-wavy" aria-label="money flying"></i>',
   '💳': '<i class="ph ph-credit-card" aria-label="payment"></i>',
   '🏦': '<i class="ph ph-bank" aria-label="bank"></i>',
   '🏥': '<i class="ph ph-hospital" aria-label="hospital"></i>',
@@ -210,6 +212,7 @@ const emojiToPhosphor = {
   '⏸️': '<i class="ph ph-pause" aria-label="pause"></i>',
   '▶️': '<i class="ph ph-play" aria-label="play"></i>',
   '⏹️': '<i class="ph ph-stop" aria-label="stop"></i>',
+  '🔄': '<i class="ph ph-arrows-clockwise" aria-label="refresh"></i>',
   
   // Special
   '🌈': '<i class="ph ph-rainbow" aria-label="diversity"></i>',
@@ -231,6 +234,17 @@ function replaceEmojisWithIcons(html, config = {}) {
   // Check if feature is enabled
   if (!config.features?.phosphorIcons) return html;
   
+  // First, protect code blocks and inline code from emoji replacement
+  const codeBlocks = [];
+  const codePattern = /(<code[^>]*>[\s\S]*?<\/code>|<pre[^>]*>[\s\S]*?<\/pre>)/g;
+  
+  // Replace code blocks with placeholders
+  html = html.replace(codePattern, (match, p1) => {
+    const placeholder = `CODE_BLOCK_${codeBlocks.length}`;
+    codeBlocks.push(match);
+    return placeholder;
+  });
+  
   // Build regex pattern once with all emoji patterns
   // Sort by length to match longer emojis first (e.g., ⚠️ before ⚠)
   const emojiPattern = new RegExp(
@@ -251,7 +265,7 @@ function replaceEmojisWithIcons(html, config = {}) {
     ? ` style="font-size: ${config.features.phosphorSize}"` 
     : '';
   
-  return html.replace(emojiPattern, match => {
+  html = html.replace(emojiPattern, match => {
     let iconHtml = emojiToPhosphor[match];
     if (!iconHtml) return match;
     
@@ -267,6 +281,13 @@ function replaceEmojisWithIcons(html, config = {}) {
     
     return iconHtml;
   });
+  
+  // Restore code blocks
+  codeBlocks.forEach((block, index) => {
+    html = html.replace(`CODE_BLOCK_${index}`, block);
+  });
+  
+  return html;
 }
 
 module.exports = {

package/package.json

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