@mgks/docmd 0.2.8 → 0.3.0

package/src/commands/build.js

@@ -12,6 +12,9 @@ const { version } = require('../../package.json');
 const matter = require('gray-matter');
 const MarkdownIt = require('markdown-it');
 const hljs = require('highlight.js');
+const CleanCSS = require('clean-css');
+const esbuild = require('esbuild');
+const MiniSearch = require('minisearch');
 
 // Debug function to log navigation information
 function logNavigationPaths(pagePath, navPath, normalizedPath) {
@@ -42,12 +45,12 @@ const ASSET_VERSIONS = {
 function formatPathForDisplay(absolutePath, cwd) {
   // Get the relative path from CWD
   const relativePath = path.relative(cwd, absolutePath);
-  
+
   // If it's not a subdirectory, prefix with ./ for clarity
   if (!relativePath.startsWith('..') && !path.isAbsolute(relativePath)) {
     return `./${relativePath}`;
   }
-  
+
   // Return the relative path
   return relativePath;
 }
@@ -61,6 +64,8 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
   const OUTPUT_DIR = path.resolve(CWD, config.outputDir);
   const USER_ASSETS_DIR = path.resolve(CWD, 'assets');
   const md = createMarkdownItInstance(config);
+  const shouldMinify = !options.isDev && config.minify !== false;
+  const searchIndexData = [];
 
   if (!await fs.pathExists(SRC_DIR)) {
     throw new Error(`Source directory not found: ${formatPathForDisplay(SRC_DIR, CWD)}`);
@@ -85,27 +90,70 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
   const preservedFiles = [];
   const userAssetsCopied = [];
 
+  // Function to process and copy a single asset
+  const processAndCopyAsset = async (srcPath, destPath) => {
+    const ext = path.extname(srcPath).toLowerCase();
+
+    if (process.env.DOCMD_DEBUG) {
+      console.log(`[Asset Debug] Processing: ${path.basename(srcPath)} | Minify: ${shouldMinify} | Ext: ${ext}`);
+    }
+
+    if (shouldMinify && ext === '.css') {
+      try {
+        const content = await fs.readFile(srcPath, 'utf8');
+        const output = new CleanCSS({}).minify(content);
+        if (output.errors.length > 0) {
+          console.warn(`⚠️ CSS Minification error for ${path.basename(srcPath)}, using original.`, output.errors);
+          await fs.copyFile(srcPath, destPath);
+        } else {
+          await fs.writeFile(destPath, output.styles);
+        }
+      } catch (e) {
+        console.warn(`⚠️ CSS processing failed: ${e.message}`);
+        await fs.copyFile(srcPath, destPath);
+      }
+    }
+    else if (shouldMinify && ext === '.js') {
+      try {
+        const content = await fs.readFile(srcPath, 'utf8');
+        // Simple minification transform
+        const result = await esbuild.transform(content, {
+          minify: true,
+          loader: 'js',
+          target: 'es2015' // Ensure compatibility
+        });
+        await fs.writeFile(destPath, result.code);
+      } catch (e) {
+        console.warn(`⚠️ JS Minification failed: ${e.message}`);
+        await fs.copyFile(srcPath, destPath);
+      }
+    }
+    else {
+      // Images, fonts, or dev mode -> standard copy
+      await fs.copyFile(srcPath, destPath);
+    }
+  };
+
   // Copy user assets from root assets/ directory if it exists
   if (await fs.pathExists(USER_ASSETS_DIR)) {
     const assetsDestDir = path.join(OUTPUT_DIR, 'assets');
     await fs.ensureDir(assetsDestDir);
-    
+
     if (!options.isDev) {
       console.log(`📂 Copying user assets from ${formatPathForDisplay(USER_ASSETS_DIR, CWD)} to ${formatPathForDisplay(assetsDestDir, CWD)}...`);
     }
-    
+
     const userAssetFiles = await getAllFiles(USER_ASSETS_DIR);
-    
     for (const srcFile of userAssetFiles) {
       const relativePath = path.relative(USER_ASSETS_DIR, srcFile);
       const destFile = path.join(assetsDestDir, relativePath);
-      
-      // Ensure directory exists
+
       await fs.ensureDir(path.dirname(destFile));
-      await fs.copyFile(srcFile, destFile);
+      await processAndCopyAsset(srcFile, destFile);
+
       userAssetsCopied.push(relativePath);
     }
-    
+
     if (!options.isDev && userAssetsCopied.length > 0) {
       console.log(`📦 Copied ${userAssetsCopied.length} user assets`);
     }
@@ -114,41 +162,34 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
   // Copy assets
   const assetsSrcDir = path.join(__dirname, '..', 'assets');
   const assetsDestDir = path.join(OUTPUT_DIR, 'assets');
-  
+
   if (await fs.pathExists(assetsSrcDir)) {
     if (!options.isDev) {
       console.log(`📂 Copying docmd assets to ${formatPathForDisplay(assetsDestDir, CWD)}...`);
     }
-    
+
     // Create destination directory if it doesn't exist
     await fs.ensureDir(assetsDestDir);
-    
+
     // Get all files from source directory recursively
     const assetFiles = await getAllFiles(assetsSrcDir);
-    
-    // Copy each file individually, checking for existing files if preserve flag is set
     for (const srcFile of assetFiles) {
       const relativePath = path.relative(assetsSrcDir, srcFile);
       const destFile = path.join(assetsDestDir, relativePath);
-      
-      // Check if destination file already exists
       const fileExists = await fs.pathExists(destFile);
-      
-      // Skip if the file exists and either:
-      // 1. The preserve flag is set, OR
-      // 2. The file was copied from user assets (user assets take precedence)
+
       if (fileExists && (options.preserve || userAssetsCopied.includes(relativePath))) {
-        // Skip file and add to preserved list
         preservedFiles.push(relativePath);
         if (!options.isDev && options.preserve) {
           console.log(`  Preserving existing file: ${relativePath}`);
         }
+
       } else {
-        // Copy file (either it doesn't exist or we're not preserving)
         await fs.ensureDir(path.dirname(destFile));
-        await fs.copyFile(srcFile, destFile);
+        await processAndCopyAsset(srcFile, destFile);
       }
     }
+
   } else {
     console.warn(`⚠️  Assets source directory not found: ${formatPathForDisplay(assetsSrcDir, CWD)}`);
   }
@@ -189,7 +230,7 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
   for (const filePath of markdownFiles) {
     try {
       const relativePath = path.relative(SRC_DIR, filePath);
-      
+
       // Skip file if already processed in this dev build cycle
       if (options.noDoubleProcessing && processedFiles.has(relativePath)) {
         continue;
@@ -203,12 +244,12 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
       if (!processedData) {
         continue;
       }
-      
+
       // Destructure the valid data
-      const { frontmatter: pageFrontmatter, htmlContent, headings } = processedData;
-      
+      const { frontmatter: pageFrontmatter, htmlContent, headings, searchData } = processedData;
+
       const isIndexFile = path.basename(relativePath) === 'index.md';
-      
+
       let outputHtmlPath;
       if (isIndexFile) {
         const dirPath = path.dirname(relativePath);
@@ -221,9 +262,9 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
 
       let relativePathToRoot = path.relative(path.dirname(finalOutputHtmlPath), OUTPUT_DIR);
       if (relativePathToRoot === '') {
-          relativePathToRoot = './';
+        relativePathToRoot = './';
       } else {
-          relativePathToRoot = relativePathToRoot.replace(/\\/g, '/') + '/';
+        relativePathToRoot = relativePathToRoot.replace(/\\/g, '/') + '/';
       }
 
       let normalizedPath = path.relative(SRC_DIR, filePath).replace(/\\/g, '/');
@@ -259,7 +300,7 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
         const cleanPath = prevPage.path.substring(1);
         prevPage.url = relativePathToRoot + cleanPath;
       }
-      
+
       if (nextPage) {
         const cleanPath = nextPage.path.substring(1);
         nextPage.url = relativePathToRoot + cleanPath;
@@ -286,17 +327,35 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
       await fs.ensureDir(path.dirname(finalOutputHtmlPath));
       await fs.writeFile(finalOutputHtmlPath, pageHtml);
 
-      const sitemapOutputPath = isIndexFile 
-          ? (path.dirname(relativePath) === '.' ? '' : path.dirname(relativePath) + '/')
-          : relativePath.replace(/\.md$/, '/');
+      const sitemapOutputPath = isIndexFile
+        ? (path.dirname(relativePath) === '.' ? '' : path.dirname(relativePath) + '/')
+        : relativePath.replace(/\.md$/, '/');
 
       processedPages.push({
         outputPath: sitemapOutputPath.replace(/\\/g, '/'),
         frontmatter: pageFrontmatter
       });
+
+      // Collect Search Data
+      if (searchData) {
+        let pageUrl = outputHtmlPath.replace(/\\/g, '/');
+        if (pageUrl.endsWith('/index.html')) {
+          pageUrl = pageUrl.substring(0, pageUrl.length - 10); // remove index.html
+        }
+
+        // Add to index array
+        searchIndexData.push({
+          id: pageUrl, // URL is the ID
+          title: searchData.title,
+          text: searchData.content,
+          headings: searchData.headings.join(' ')
+        });
+      }
+
     } catch (error) {
       console.error(`❌ An unexpected error occurred while processing file ${path.relative(CWD, filePath)}:`, error);
     }
+
   }
 
   // Generate sitemap if enabled in config
@@ -308,13 +367,40 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
     }
   }
 
+  // Generate search index if enabled
+  if (config.search !== false) {
+    console.log('🔍 Generating search index...');
+
+    // Create MiniSearch instance
+    const miniSearch = new MiniSearch({
+      fields: ['title', 'headings', 'text'], // fields to index for full-text search
+      storeFields: ['title', 'id', 'text'], // fields to return with search results (don't store full text to keep JSON small)
+      searchOptions: {
+        boost: { title: 2, headings: 1.5 }, // title matches are more important
+        fuzzy: 0.2
+      }
+    });
+
+    // Add documents
+    miniSearch.addAll(searchIndexData);
+
+    // Serialize to JSON
+    const jsonIndex = JSON.stringify(miniSearch.toJSON());
+    const searchIndexPath = path.join(OUTPUT_DIR, 'search-index.json');
+    await fs.writeFile(searchIndexPath, jsonIndex);
+
+    if (!options.isDev) {
+      console.log(`✅ Search index generated (${(jsonIndex.length / 1024).toFixed(1)} KB)`);
+    }
+  }
+
   // Print summary of preserved files at the end of build
   if (preservedFiles.length > 0 && !options.isDev) {
     console.log(`\n📋 Build Summary: ${preservedFiles.length} existing files were preserved:`);
     preservedFiles.forEach(file => console.log(`  - assets/${file}`));
     console.log(`\nTo update these files in future builds, run without the --preserve flag.`);
   }
-  
+
   if (userAssetsCopied.length > 0 && !options.isDev) {
     console.log(`\n📋 User Assets: ${userAssetsCopied.length} files were copied from your assets/ directory:`);
     if (userAssetsCopied.length <= 10) {
@@ -325,6 +411,74 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
     }
   }
 
+  // Bundle third-party libraries into assets
+  const copyLibrary = async (packageName, fileToBundle, destFileName) => {
+    try {
+      let srcPath;
+
+      // 1. Resolve Source Path
+      try {
+        srcPath = require.resolve(`${packageName}/${fileToBundle}`);
+      } catch (e) {
+        const mainPath = require.resolve(packageName);
+        let currentDir = path.dirname(mainPath);
+        let packageRoot = null;
+        
+        for (let i = 0; i < 5; i++) {
+          if (await fs.pathExists(path.join(currentDir, 'package.json'))) {
+            packageRoot = currentDir;
+            break;
+          }
+          currentDir = path.dirname(currentDir);
+        }
+
+        if (packageRoot) {
+          srcPath = path.join(packageRoot, fileToBundle);
+        }
+      }
+
+      // 2. Process and Write
+      if (srcPath && await fs.pathExists(srcPath)) {
+        const destPath = path.join(OUTPUT_DIR, 'assets/js', destFileName);
+        
+        // Read content
+        let content = await fs.readFile(srcPath, 'utf8');
+        
+        // This prevents the browser from looking for index.js.map or similar files we didn't copy
+        content = content.replace(/\/\/# sourceMappingURL=.*$/gm, '');
+        
+        // Minify if production build
+        if (shouldMinify) {
+            try {
+                const result = await esbuild.transform(content, {
+                    minify: true,
+                    loader: 'js',
+                    target: 'es2015'
+                });
+                await fs.writeFile(destPath, result.code);
+            } catch (minErr) {
+                console.warn(`⚠️ Minification failed for ${packageName}, using sanitized original.`, minErr.message);
+                await fs.writeFile(destPath, content);
+            }
+        } else {
+            // Write sanitized original in dev mode
+            await fs.writeFile(destPath, content);
+        }
+
+      } else {
+        console.warn(`⚠️ Could not locate ${fileToBundle} in ${packageName}`);
+      }
+    } catch (e) {
+      console.warn(`⚠️ Failed to bundle ${packageName}: ${e.message}`);
+    }
+  };
+
+  // Bundle MiniSearch 
+  await copyLibrary('minisearch', 'dist/umd/index.js', 'minisearch.js');
+
+  // Bundle Mermaid
+  await copyLibrary('mermaid', 'dist/mermaid.min.js', 'mermaid.min.js');
+
   return {
     config,
     processedPages,
@@ -336,10 +490,10 @@ async function buildSite(configPath, options = { isDev: false, preserve: false,
 async function findFilesToCleanup(dir) {
   const filesToRemove = [];
   const items = await fs.readdir(dir, { withFileTypes: true });
-  
+
   for (const item of items) {
     const fullPath = path.join(dir, item.name);
-    
+
     if (item.isDirectory()) {
       // Don't delete the assets directory
       if (item.name !== 'assets') {
@@ -347,13 +501,13 @@ async function findFilesToCleanup(dir) {
         filesToRemove.push(...subDirFiles);
       }
     } else if (
-      item.name.endsWith('.html') || 
+      item.name.endsWith('.html') ||
       item.name === 'sitemap.xml'
     ) {
       filesToRemove.push(fullPath);
     }
   }
-  
+
   return filesToRemove;
 }
 
@@ -361,7 +515,7 @@ async function findFilesToCleanup(dir) {
 async function getAllFiles(dir) {
   const files = [];
   const items = await fs.readdir(dir, { withFileTypes: true });
-  
+
   for (const item of items) {
     const fullPath = path.join(dir, item.name);
     if (item.isDirectory()) {
@@ -370,7 +524,7 @@ async function getAllFiles(dir) {
       files.push(fullPath);
     }
   }
-  
+
   return files;
 }
 

package/src/commands/init.js

@@ -24,6 +24,12 @@ module.exports = {
   srcDir: 'docs',       // Source directory for Markdown files
   outputDir: 'site',    // Directory for generated static site
 
+  // Search Configuration
+  search: true,        // Enable/disable search functionality
+
+  // Build Options
+  minify: true,        // Enable/disable HTML/CSS/JS minification
+
   // Sidebar Configuration
   sidebar: {
     collapsible: true,        // or false to disable
@@ -88,6 +94,15 @@ module.exports = {
     // Add other future plugin configurations here by their key
   },
 
+  // "Edit this page" Link Configuration
+  editLink: {
+    enabled: false,
+    // The URL to the folder containing your docs in the git repo
+    // Note: It usually ends with /edit/main/docs or /blob/main/docs
+    baseUrl: 'https://github.com/mgks/docmd/edit/main/docs',
+    text: 'Edit this page on GitHub'
+  },
+
   // Navigation Structure (Sidebar)
   // Icons are kebab-case names from Lucide Icons (https://lucide.dev/)
   navigation: [

package/src/core/file-processor.js

@@ -4,6 +4,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const matter = require('gray-matter');
 const { createMarkdownItInstance } = require('./markdown/setup');
+const striptags = require('striptags');
 
 function decodeHtmlEntities(html) {
     return html.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"').replace(/'/g, "'").replace(/ /g, ' ');
@@ -56,8 +57,18 @@ async function processMarkdownFile(filePath, md, config) {
       htmlContent = md.render(markdownContent);
       headings = extractHeadingsFromHtml(htmlContent);
     }
+
+    let searchData = null;
+    if (!frontmatter.noindex) {
+        const rawText = decodeHtmlEntities(striptags(htmlContent));
+        searchData = {
+            title: frontmatter.title || 'Untitled',
+            content: rawText.slice(0, 5000), // Safety cap to prevent massive JSON
+            headings: headings.map(h => h.text)
+        };
+    }
   
-    return { frontmatter, htmlContent, headings };
+    return { frontmatter, htmlContent, headings, searchData };
 }
   
 async function findMarkdownFiles(dir) {

package/src/core/html-generator.js

@@ -100,6 +100,27 @@ async function generateHtmlPage(templateData) {
 
     const isActivePage = currentPagePath && content && content.trim().length > 0;
 
+    // Calculate Edit Link
+    let editUrl = null;
+    let editLinkText = 'Edit this page';
+    
+    if (config.editLink && config.editLink.enabled && config.editLink.baseUrl) {
+        // Normalize URL (remove trailing slash)
+        const baseUrl = config.editLink.baseUrl.replace(/\/$/, '');
+
+        // Get the source file path relative to srcDir
+        let relativeSourcePath = outputPath
+            .replace(/\/index\.html$/, '.md') // folder/index.html -> folder.md
+            .replace(/\\/g, '/'); // fix windows slashes
+
+        // Special case: The root index.html comes from index.md
+        if (relativeSourcePath === 'index.html') relativeSourcePath = 'index.md';
+
+        // Let's assume a standard 1:1 mapping for v0.2.x        
+        editUrl = `${baseUrl}/${relativeSourcePath}`;
+        editLinkText = config.editLink.text || editLinkText;
+    }
+
     const ejsData = {
         content,
         pageTitle,
@@ -107,6 +128,8 @@ async function generateHtmlPage(templateData) {
         description: frontmatter.description,
         siteTitle,
         navigationHtml,
+        editUrl,
+        editLinkText,
         defaultMode: config.theme?.defaultMode || 'light',
         relativePathToRoot,
         logo: config.logo,

package/src/core/markdown/setup.js

@@ -17,20 +17,36 @@ const headingIdPlugin = (md) => {
   const originalHeadingOpen = md.renderer.rules.heading_open || function(tokens, idx, options, env, self) {
     return self.renderToken(tokens, idx, options);
   };
+
   md.renderer.rules.heading_open = function(tokens, idx, options, env, self) {
     const token = tokens[idx];
-    const contentToken = tokens[idx + 1];
-    if (contentToken && contentToken.type === 'inline' && contentToken.content) {
-      const headingText = contentToken.content;
-      const id = headingText
-        .toLowerCase()
-        .replace(/\s+/g, '-')
-        .replace(/[^\w-]+/g, '')
-        .replace(/--+/g, '-')
-        .replace(/^-+/, '')
-        .replace(/-+$/, '');
-      if (id) token.attrSet('id', id);
+    
+    // Check if an ID was already set by markdown-it-attrs (e.g. {#my-id})
+    const existingId = token.attrGet('id');
+
+    // If NO ID exists, generate one automatically from the text content
+    if (!existingId) {
+      const contentToken = tokens[idx + 1];
+      if (contentToken && contentToken.type === 'inline' && contentToken.content) {
+        const headingText = contentToken.content;
+        
+        // Note: markdown-it-attrs strips the curly braces content from .content 
+        // BEFORE this rule runs, so headingText should be clean.
+        
+        const id = headingText
+          .toLowerCase()
+          .replace(/\s+/g, '-')       // Replace spaces with -
+          .replace(/[^\w\u4e00-\u9fa5-]+/g, '') // Remove all non-word chars (keeping hyphens). Added unicode support implies keeping more chars if needed.
+          .replace(/--+/g, '-')       // Replace multiple - with single -
+          .replace(/^-+/, '')         // Trim - from start of text
+          .replace(/-+$/, '');        // Trim - from end of text
+
+        if (id) {
+          token.attrSet('id', id);
+        }
+      }
     }
+    
     return originalHeadingOpen(tokens, idx, options, env, self);
   };
 };

package/src/templates/layout.ejs

@@ -66,6 +66,15 @@
             </div>
             <% if (theme && theme.enableModeToggle && theme.positionMode === 'top') { %>
             <div class="header-right">
+                <% if (config.search !== false) { %>
+                <button class="docmd-search-trigger" aria-label="Search">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="1em" height="1em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-search-icon lucide-search"><path d="m21 21-4.34-4.34"></path><circle cx="11" cy="11" r="8"></circle></svg>
+                    <span class="search-label">Search</span>
+                    <span class="search-keys">
+                        <kbd class="docmd-kbd">⌘</kbd><kbd class="docmd-kbd">k</kbd>
+                    </span>
+                </button>
+                <% } %>
                 <button id="theme-toggle-button" aria-label="Toggle theme" class="theme-toggle-button theme-toggle-header">
                     <%# renderIcon is available in the global EJS scope from html-generator %>
                     <%- renderIcon('sun', { class: 'icon-sun' }) %>
@@ -115,23 +124,66 @@
                     <%- include('toc', { content, headings, navigationHtml, isActivePage }) %>
                 </div>
             </div>
+
+            <!-- Page footer actions -->
+            <div class="page-footer-actions">
+                <% if (locals.editUrl) { %>
+                    <a href="<%= editUrl %>" target="_blank" rel="noopener noreferrer" class="edit-link">
+                        <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-pencil"><path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/><path d="m15 5 4 4"/></svg>
+                        <%= editLinkText %>
+                    </a>
+                <% } %>
+
+                <% if (locals.lastUpdated) { %>
+                    <!-- Placeholder for future Last Updated feature -->
+                <% } %>
+            </div>
         </main>
+
         <footer class="page-footer">
             <div class="footer-content">
                 <div class="user-footer">
                     <%- footerHtml || '' %>
                 </div>
                 <div class="branding-footer">
-                    Build with <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z"></path><path d="M12 5 9.04 7.96a2.17 2.17 0 0 0 0 3.08c.82.82 2.13.85 3 .07l2.07-1.9a2.82 2.82 0 0 1 3.79 0l2.96 2.66"></path><path d="m18 15-2-2"></path><path d="m15 18-2-2"></path></svg> <a href="https://docmd.mgks.dev" target="_blank" rel="noopener">docmd.</a>
+                    Build with <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z"></path><path d="M12 5 9.04 7.96a2.17 2.17 0 0 0 0 3.08c.82.82 2.13.85 3 .07l2.07-1.9a2.82 2.82 0 0 1 3.79 0l2.96 2.66"></path><path d="m18 15-2-2"></path><path d="m15 18-2-2"></path></svg> <a href="https://github.com/mgks/docmd" target="_blank" rel="noopener">docmd.</a>
                 </div>
             </div>
         </footer>
     </div>
 
+    <% if (config.search !== false) { %>
+    <!-- Search Modal -->
+    <div id="docmd-search-modal" class="docmd-search-modal" style="display: none;">
+        <div class="docmd-search-box">
+            <div class="docmd-search-header">
+                <svg xmlns="http://www.w3.org/2000/svg" width="1.25em" height="1.25em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-search-icon lucide-search"><path d="m21 21-4.34-4.34"></path><circle cx="11" cy="11" r="8"></circle></svg>
+                <input type="text" id="docmd-search-input" placeholder="Search documentation..." autocomplete="off" spellcheck="false">
+                <button onclick="window.closeDocmdSearch()" class="docmd-search-close" aria-label="Close search">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="2em" height="2em" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-x-icon lucide-x"><path d="M18 6 6 18"/><path d="m6 6 12 12"/></svg>
+                </button>
+            </div>
+            <div id="docmd-search-results" class="docmd-search-results">
+                <!-- Results injected here -->
+            </div>
+            <div class="docmd-search-footer">
+                <span><kbd class="docmd-kbd">↑</kbd> <kbd class="docmd-kbd">↓</kbd> to navigate</span>
+                <span><kbd class="docmd-kbd">ESC</kbd> to close</span>
+            </div>
+        </div>
+    </div>
+    <% } %>
+
     <script src="<%= relativePathToRoot %>assets/js/docmd-main.js"></script>
-    
+
+    <% if (config.search !== false) { %>
+    <!-- Search Scripts -->
+    <script src="<%= relativePathToRoot %>assets/js/minisearch.js"></script>
+    <script src="<%= relativePathToRoot %>assets/js/docmd-search.js"></script>
+    <% } %>
+
     <!-- Mermaid.js for diagram rendering -->
-    <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
+    <script src="<%= relativePathToRoot %>assets/js/mermaid.min.js"></script>
     <script src="<%= relativePathToRoot %>assets/js/docmd-mermaid.js"></script>
 
     <% (customJsFiles || []).forEach(jsFile => { %>