@knowcode/doc-builder 1.9.9 → 1.9.11

package/lib/core-builder.js

@@ -64,6 +64,27 @@ function escapeHtml(text) {
   return text.replace(/[&<>"']/g, m => map[m]);
 }
 
+// Helper function to smartly capitalize text while preserving existing capitalization
+function smartCapitalize(text) {
+  if (!text) return text;
+  
+  return text
+    .replace(/[-_]/g, ' ') // Replace hyphens and underscores with spaces
+    .split(' ')
+    .map(word => {
+      if (!word) return word;
+      
+      // If word has any uppercase letters (like "AI", "API", "iPhone"), preserve it
+      if (/[A-Z]/.test(word)) {
+        return word;
+      }
+      
+      // If word is all lowercase, capitalize first letter
+      return word.charAt(0).toUpperCase() + word.slice(1);
+    })
+    .join(' ');
+}
+
 // Detect document status from content and front matter
 function detectDocumentStatus(content, frontMatter = {}) {
   // Check front matter first
@@ -650,9 +671,9 @@ function buildNavigationStructure(files, currentFile, config = {}) {
     
     // Clean up title by removing common prefixes and improving formatting
     title = title
-      .replace(/^(bubble|system|quickbase|middleware|product-roadmap)-?/, '')
-      .replace(/-/g, ' ')
-      .replace(/\b\w/g, l => l.toUpperCase());
+      .replace(/^(bubble|system|quickbase|middleware|product-roadmap)-?/, '');
+    
+    title = smartCapitalize(title);
     
     return title;
   };
@@ -687,7 +708,7 @@ function buildNavigationStructure(files, currentFile, config = {}) {
     };
     
     const displayName = folderName === 'root' ? 'Documentation' : 
-                       folderName.replace(/-/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
+                       smartCapitalize(folderName);
     const icon = icons[folderName] || 'ph ph-folder';
     
     if (!folderData.files.length && !Object.keys(folderData.folders).length) {
@@ -803,7 +824,7 @@ function buildNavigationStructure(files, currentFile, config = {}) {
         if (contentDivEnd !== -1) {
           let additionalFiles = '';
           otherRootFiles.forEach(file => {
-            const title = file.displayName.replace(/[-_]/g, ' ').replace(/\b\w/g, l => l.toUpperCase());
+            const title = smartCapitalize(file.displayName);
             let isActive = '';
             if (currentFile === file.urlPath) {
               isActive = ' active';
@@ -878,9 +899,7 @@ async function getAllMarkdownFiles(dir, baseDir = dir) {
     } else if (item.endsWith('.md') && !item.startsWith('_')) {
       const relativePath = path.relative(baseDir, fullPath);
       const urlPath = relativePath.replace(/\.md$/, '.html').replace(/\\/g, '/');
-      const displayName = path.basename(item, '.md')
-        .replace(/[-_]/g, ' ')
-        .replace(/\b\w/g, l => l.toUpperCase());
+      const displayName = smartCapitalize(path.basename(item, '.md'));
       
       // Read file to extract summary and status
       const rawContent = await fs.readFile(fullPath, 'utf-8');
@@ -1166,6 +1185,7 @@ async function buildDocumentation(config) {
     
     const attachmentTypes = config.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',

package/lib/emoji-mapper.js

@@ -12,6 +12,7 @@ const emojiToPhosphor = {
   '❓': '<i class="ph ph-question" aria-label="question"></i>',
   '❗': '<i class="ph ph-warning" aria-label="warning"></i>',
   '⚠️': '<i class="ph ph-warning-circle" aria-label="warning"></i>',
+  '⚖️': '<i class="ph ph-scales" aria-label="balance"></i>',
   '⛔': '<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>',
@@ -46,6 +47,7 @@ const emojiToPhosphor = {
   '📁': '<i class="ph ph-folder" aria-label="folder"></i>',
   '📂': '<i class="ph ph-folder-open" aria-label="open folder"></i>',
   '🗂️': '<i class="ph ph-folders" aria-label="folders"></i>',
+  '🗃️': '<i class="ph ph-archive" aria-label="archive"></i>',
   '📚': '<i class="ph ph-books" aria-label="documentation"></i>',
   '📖': '<i class="ph ph-book-open" aria-label="reading"></i>',
   '📕': '<i class="ph ph-book" aria-label="book"></i>',
@@ -208,6 +210,7 @@ const emojiToPhosphor = {
   '➕': '<i class="ph ph-plus" aria-label="add"></i>',
   '➖': '<i class="ph ph-minus" aria-label="remove"></i>',
   '✖️': '<i class="ph ph-x" aria-label="close"></i>',
+  '🗑️': '<i class="ph ph-trash" aria-label="delete"></i>',
   '♻️': '<i class="ph ph-recycle" aria-label="recycle"></i>',
   '❤️': '<i class="ph ph-heart" aria-label="love"></i>',
   '💔': '<i class="ph ph-heart-break" aria-label="broken heart"></i>',

package/lib/seo.js

@@ -128,6 +128,8 @@ function generateMetaTags(options) {
   const tags = [];
   
   // Basic meta tags
+  tags.push(`    <meta name="generator" content="@knowcode/doc-builder by Knowcode Ltd">`);
+  
   if (author) {
     tags.push(`    <meta name="author" content="${escapeHtml(author)}">`);
   }

package/package.json

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