@mgks/docmd 0.3.4 → 0.3.5

package/src/live/live.css

@@ -0,0 +1,167 @@
+:root {
+    --header-height: 50px;
+    --border-color: #e0e0e0;
+    --bg-color: #f9fafb;
+    --primary-color: #007bff;
+    --resizer-width: 8px;
+}
+
+body {
+    margin: 0;
+    height: 100vh;
+    display: flex;
+    flex-direction: column;
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+    overflow: hidden;
+}
+
+/* --- Top Bar --- */
+.top-bar {
+    height: var(--header-height);
+    background: #fff;
+    border-bottom: 1px solid var(--border-color);
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    padding: 0 1rem;
+    flex-shrink: 0;
+}
+
+.logo { 
+    font-weight: 700; 
+    font-size: 1.1rem; 
+    display: flex; 
+    align-items: center; 
+    gap: 12px;
+}
+
+.logo span { 
+    background: var(--primary-color); 
+    color: white; 
+    padding: 2px 6px; 
+    border-radius: 4px; 
+    font-size: 0.75rem; 
+    text-transform: uppercase; 
+}
+
+.back-link {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: #666;
+    transition: color 0.2s, transform 0.2s;
+    text-decoration: none;
+    padding: 4px;
+    border-radius: 4px;
+}
+
+.back-link:hover {
+    color: var(--primary-color);
+    background: #f0f0f0;
+    transform: translateX(-2px);
+}
+
+.view-controls { display: flex; gap: 8px; background: #f0f0f0; padding: 3px; border-radius: 6px; }
+.view-btn { border: none; background: transparent; padding: 6px 10px; border-radius: 4px; cursor: pointer; font-size: 0.85rem; color: #666; font-weight: 500; }
+.view-btn.active { background: white; color: black; box-shadow: 0 1px 3px rgba(0,0,0,0.1); }
+
+/* --- Main Layout --- */
+.workspace {
+    flex: 1;
+    display: flex;
+    position: relative;
+    overflow: hidden;
+}
+
+.pane {
+    height: 100%;
+    display: flex;
+    flex-direction: column;
+    min-width: 300px; /* Minimum width constraint */
+    background: white;
+}
+
+.pane-header {
+    padding: 8px 16px;
+    font-size: 0.75rem;
+    font-weight: 600;
+    text-transform: uppercase;
+    color: #888;
+    background: var(--bg-color);
+    border-bottom: 1px solid var(--border-color);
+    flex-shrink: 0;
+}
+
+/* Editor Pane */
+.editor-pane { width: 50%; }
+textarea#input {
+    flex: 1;
+    border: none;
+    resize: none;
+    padding: 20px;
+    font-family: 'JetBrains Mono', 'Fira Code', Consolas, monospace;
+    font-size: 14px;
+    line-height: 1.6;
+    outline: none;
+    background: var(--bg-color);
+}
+
+/* Preview Pane */
+.preview-pane { flex: 1; background: white; }
+iframe#preview { width: 100%; height: 100%; border: none; display: block; }
+
+/* --- Resizer Handle --- */
+.resizer {
+    width: var(--resizer-width);
+    background: var(--bg-color);
+    border-left: 1px solid var(--border-color);
+    border-right: 1px solid var(--border-color);
+    cursor: col-resize;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transition: background 0.2s;
+    z-index: 10;
+}
+.resizer:hover, .resizer.resizing { background: #e0e0e0; }
+.resizer::after { content: "||"; color: #aaa; font-size: 10px; letter-spacing: 1px; }
+
+/* --- View Modes (Single vs Split) --- */
+
+/* Single Mode (Mobile style on Desktop) */
+body.mode-single .resizer { display: none; }
+body.mode-single .pane { width: 100% !important; min-width: 0; }
+body.mode-single .editor-pane { display: none; }
+body.mode-single .preview-pane { display: none; }
+body.mode-single.show-editor .editor-pane { display: flex; }
+body.mode-single.show-preview .preview-pane { display: flex; }
+
+/* --- Mobile Responsive Overrides --- */
+@media (max-width: 768px) {
+    /* Force single mode on mobile, hide desktop view controls */
+    .desktop-only { display: none !important; }
+    .resizer { display: none !important; }
+    
+    .pane { width: 100% !important; }
+    .editor-pane { display: none; }
+    .preview-pane { display: none; }
+    
+    body.mobile-tab-editor .editor-pane { display: flex; }
+    body.mobile-tab-preview .preview-pane { display: flex; }
+    
+    .mobile-tabs {
+        display: flex !important;
+        position: fixed;
+        bottom: 0; left: 0; right: 0;
+        height: 50px;
+        background: white;
+        border-top: 1px solid var(--border-color);
+        z-index: 100;
+    }
+    .mobile-tab-btn { flex: 1; border: none; background: transparent; font-weight: 600; color: #888; cursor: pointer; }
+    .mobile-tab-btn.active { color: var(--primary-color); border-top: 2px solid var(--primary-color); }
+    
+    .workspace { padding-bottom: 50px; } /* Space for tabs */
+}
+
+.mobile-tabs { display: none; } /* Hidden on desktop */

package/src/live/shims.js

@@ -0,0 +1 @@
+import { Buffer } from 'buffer'; globalThis.Buffer = Buffer;

package/src/live/templates.js

@@ -0,0 +1,9 @@
+
+const templates = {
+  "layout.ejs": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n\n    <%- metaTagsHtml || '' %> <%# SEO Plugin Meta Tags %>\n\n    <title><%= pageTitle %> : <%= siteTitle %></title>\n    <% if (description && !(metaTagsHtml && metaTagsHtml.includes('name=\"description\"'))) { %>\n      <meta name=\"description\" content=\"<%= description %>\">\n    <% } %>\n\n    <%- faviconLinkHtml || '' %> <%# Favicon %>\n\n    <!-- Define Default Mode (Variable for script) -->\n    <script>\n      window.DOCMD_DEFAULT_MODE = \"<%= defaultMode %>\";\n    </script>\n\n    <!-- Highlight.js Theme -->\n    <% if (config.theme?.codeHighlight !== false) { %>\n        <link rel=\"stylesheet\" id=\"highlight-theme\" href=\"<%= relativePathToRoot %>assets/css/docmd-highlight-<%= defaultMode === 'dark' ? 'dark' : 'light' %>.css\" data-base-href=\"<%= relativePathToRoot %>assets/css/\">\n    <% } %>\n\n    <!-- Main Theme -->\n    <link rel=\"stylesheet\" href=\"<%= relativePathToRoot %>assets/css/docmd-main.css\">\n    \n    <%- themeCssLinkHtml || '' %> <%# For theme.name specific CSS %>\n\n    <% (customCssFiles || []).forEach(cssFile => { %>\n      <link rel=\"stylesheet\" href=\"<%= relativePathToRoot %><%- cssFile.startsWith('/') ? cssFile.substring(1) : cssFile %>\">\n    <% }); %>\n\n    <%- pluginStylesHtml || '' %> <%# Plugin specific CSS %>\n\n    <!-- This checks storage and updates HTML attr + Highlight CSS before final paint -->\n    <%- themeInitScript %>\n\n    <%- pluginHeadScriptsHtml || '' %> <%# Plugin specific head scripts %>\n</head>\n<body class=\"<%= sidebarConfig.collapsible ? 'sidebar-collapsible' : 'sidebar-not-collapsible' %>\"\n    data-default-collapsed=\"<%= sidebarConfig.defaultCollapsed %>\"\n    data-copy-code-enabled=\"<%= config.copyCode === true %>\">\n    <aside class=\"sidebar\">\n        <div class=\"sidebar-header\">\n        <% if (logo && logo.light && logo.dark) { %>\n            <a href=\"<%= logo.href || relativePathToRoot %>\" class=\"logo-link\">\n                <img src=\"<%= relativePathToRoot %><%- logo.light.startsWith('/') ? logo.light.substring(1) : logo.light %>\" alt=\"<%= logo.alt || siteTitle %>\" class=\"logo-light\" <% if (logo.height) { %>style=\"height: <%= logo.height %>;\"<% } %>>\n                <img src=\"<%= relativePathToRoot %><%- logo.dark.startsWith('/') ? logo.dark.substring(1) : logo.dark %>\" alt=\"<%= logo.alt || siteTitle %>\" class=\"logo-dark\" <% if (logo.height) { %>style=\"height: <%= logo.height %>;\"<% } %>>\n            </a>\n        <% } else { %>\n            <h1><a href=\"<%= relativePathToRoot %>index.html\"><%= siteTitle %></a></h1>\n        <% } %>\n            <span class=\"mobile-view sidebar-menu-button float-right\">\n                <%- renderIcon(\"ellipsis-vertical\") %>\n            </span>\n        </div>\n        <%- navigationHtml %>\n        <% if (theme && theme.enableModeToggle && theme.positionMode !== 'top') { %>\n          <button id=\"theme-toggle-button\" aria-label=\"Toggle theme\" class=\"theme-toggle-button\">\n            <%- renderIcon('sun', { class: 'icon-sun' }) %>\n            <%- renderIcon('moon', { class: 'icon-moon' }) %>\n          </button>\n        <% } %>\n    </aside>\n    <div class=\"main-content-wrapper\">\n        <div class=\"page-header\">\n            <div class=\"header-left\">\n                <% if (sidebarConfig.collapsible) { %>\n                <button id=\"sidebar-toggle-button\" class=\"sidebar-toggle-button\" aria-label=\"Toggle Sidebar\">\n                    <%- renderIcon('panel-left-close') %>\n                </button>\n                <% } %>\n                <h1><%= pageTitle %></h1>\n            </div>\n            <% if (theme && theme.enableModeToggle && theme.positionMode === 'top') { %>\n            <div class=\"header-right\">\n                <% if (config.search !== false) { %>\n                <button class=\"docmd-search-trigger\" aria-label=\"Search\">\n                    <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>\n                    <span class=\"search-label\">Search</span>\n                    <span class=\"search-keys\">\n                        <kbd class=\"docmd-kbd\">⌘</kbd><kbd class=\"docmd-kbd\">k</kbd>\n                    </span>\n                </button>\n                <% } %>\n                <button id=\"theme-toggle-button\" aria-label=\"Toggle theme\" class=\"theme-toggle-button theme-toggle-header\">\n                    <%# renderIcon is available in the global EJS scope from html-generator %>\n                    <%- renderIcon('sun', { class: 'icon-sun' }) %>\n                    <%- renderIcon('moon', { class: 'icon-moon' }) %>\n                </button>\n            </div>\n            <% } %>\n        </div>\n        <main class=\"content-area\">\n            <div class=\"content-layout\">\n                <div class=\"main-content\">\n                    <%- content %>\n                    \n                    <% if (config.pageNavigation && (prevPage || nextPage)) { %>\n                    <div class=\"page-navigation\">\n                        <% if (prevPage) { %>\n                        <a href=\"<%= prevPage.url %>\" class=\"prev-page\">\n                            <%- renderIcon('arrow-left', { class: 'page-nav-icon' }) %>\n                            <span>\n                                <small>Previous</small>\n                                <strong><%= prevPage.title %></strong>\n                            </span>\n                        </a>\n                        <% } else { %>\n                        <div class=\"prev-page-placeholder\"></div>\n                        <% } %>\n                        \n                        <% if (nextPage) { %>\n                        <a href=\"<%= nextPage.url %>\" class=\"next-page\">\n                            <span>\n                                <small>Next</small>\n                                <strong><%= nextPage.title %></strong>\n                            </span>\n                            <%- renderIcon('arrow-right', { class: 'page-nav-icon' }) %>\n                        </a>\n                        <% } else { %>\n                        <div class=\"next-page-placeholder\"></div>\n                        <% } %>\n                    </div>\n                    <% } %>\n                </div>\n                \n                <!-- DEBUG: <%- JSON.stringify({headingsLength: headings ? headings.length : 0}) %> -->\n                \n                <!-- TOC sidebar -->\n                <div class=\"toc-sidebar\">\n                    <%- include('toc', { content, headings, navigationHtml, isActivePage }) %>\n                </div>\n            </div>\n\n            <!-- Page footer actions -->\n            <div class=\"page-footer-actions\">\n                <% if (locals.editUrl) { %>\n                    <a href=\"<%= editUrl %>\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"edit-link\">\n                        <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>\n                        <%= editLinkText %>\n                    </a>\n                <% } %>\n\n                <% if (locals.lastUpdated) { %>\n                    <!-- Placeholder for future Last Updated feature -->\n                <% } %>\n            </div>\n        </main>\n\n        <footer class=\"page-footer\">\n            <div class=\"footer-content\">\n                <div class=\"user-footer\">\n                    <%- footerHtml || '' %>\n                </div>\n                <div class=\"branding-footer\">\n                    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>\n                </div>\n            </div>\n        </footer>\n    </div>\n\n    <% if (config.search !== false) { %>\n    <!-- Search Modal -->\n    <div id=\"docmd-search-modal\" class=\"docmd-search-modal\" style=\"display: none;\">\n        <div class=\"docmd-search-box\">\n            <div class=\"docmd-search-header\">\n                <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>\n                <input type=\"text\" id=\"docmd-search-input\" placeholder=\"Search documentation...\" autocomplete=\"off\" spellcheck=\"false\">\n                <button onclick=\"window.closeDocmdSearch()\" class=\"docmd-search-close\" aria-label=\"Close search\">\n                    <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>\n                </button>\n            </div>\n            <div id=\"docmd-search-results\" class=\"docmd-search-results\">\n                <!-- Results injected here -->\n            </div>\n            <div class=\"docmd-search-footer\">\n                <span><kbd class=\"docmd-kbd\">↑</kbd> <kbd class=\"docmd-kbd\">↓</kbd> to navigate</span>\n                <span><kbd class=\"docmd-kbd\">ESC</kbd> to close</span>\n            </div>\n        </div>\n    </div>\n    <% } %>\n\n    <script>\n      window.DOCMD_ROOT = \"<%= relativePathToRoot %>\";\n    </script>\n\n    <script src=\"<%= relativePathToRoot %>assets/js/docmd-main.js\"></script>\n\n    <% if (config.search !== false) { %>\n    <!-- Search Scripts -->\n    <script src=\"<%= relativePathToRoot %>assets/js/minisearch.js\"></script>\n    <script src=\"<%= relativePathToRoot %>assets/js/docmd-search.js\"></script>\n    <% } %>\n\n    <!-- Mermaid.js for diagram rendering -->\n    <script src=\"<%= relativePathToRoot %>assets/js/mermaid.min.js\"></script>\n    <script src=\"<%= relativePathToRoot %>assets/js/docmd-mermaid.js\"></script>\n\n    <% (customJsFiles || []).forEach(jsFile => { %>\n      <script src=\"<%= relativePathToRoot %><%- jsFile.startsWith('/') ? jsFile.substring(1) : jsFile %>\"></script>\n    <% }); %>\n\n    <%- pluginBodyScriptsHtml || '' %>\n    \n    <% if (sponsor && sponsor.enabled) { %>\n    <div class=\"sponsor-ribbon\">\n        <a href=\"<%= sponsor.link %>\" target=\"_blank\" rel=\"noopener noreferrer\" class=\"sponsor-link\">\n            <%- renderIcon('heart', { class: 'sponsor-icon' }) %>\n            <span class=\"sponsor-text\"><%= sponsor.title %></span>\n        </a>\n    </div>\n    <% } %>\n</body>\n</html>",
+  "navigation.ejs": "<%# navigation.ejs - Renders the sidebar navigation %>\n<nav class=\"sidebar-nav\" aria-label=\"Main navigation\">\n  <ul>\n    <%\n      // Helper: Normalize paths for comparison\n      function normalizePath(p) {\n        if (!p) return '#';\n        let path = p.replace(/\\\\/g, '/');\n        \n        // Strip leading ./ if present\n        if (path.startsWith('./')) {\n            path = path.substring(2);\n        }\n\n        // Handle file extensions\n        if (path.endsWith('index.md')) {\n          path = path.slice(0, -'index.md'.length);\n        } else {\n          path = path.replace(/\\.md$/, '');\n        }\n\n        // Ensure leading slash\n        if (!path.startsWith('/')) path = '/' + path;\n\n        // Ensure trailing slash\n        if (path.length > 1 && !path.endsWith('/')) {\n          path += '/';\n        }\n        \n        // Handle root\n        if (path === '') path = '/';\n        \n        return path;\n      }\n\n      // Helper: Recursively check if an item contains the active page\n      function hasActiveChild(item, currentPagePath) {\n        if (!item.children || !Array.isArray(item.children)) return false;\n        return item.children.some(child => {\n          if (!child.path || child.external) return false;\n          const childPath = normalizePath(child.path);\n          \n          if (currentPagePath === childPath) return true;\n          \n          return hasActiveChild(child, currentPagePath);\n        });\n      }\n\n      // Recursive function to render navigation items\n      function renderNav(items) {\n        if (!items || !Array.isArray(items)) return;\n        \n        items.forEach(item => {\n          const isExternal = item.external || false;\n          let itemPath = item.path || '#';\n          const normalizedItemPath = isExternal ? itemPath : normalizePath(itemPath);\n\n          // 1. Determine State\n          const isActive = !isExternal && currentPagePath === normalizedItemPath;\n          const isParentOfActive = !isActive && hasActiveChild(item, currentPagePath);\n          const isCollapsible = item.children && item.collapsible;\n          \n          // 2. Open State (Server-Side Calculation)\n          const shouldBeOpen = isParentOfActive || (isActive && item.children && item.children.length > 0);\n\n          // 3. Build Attributes String\n          const liClasses = [];\n          if (isActive) liClasses.push('active');\n          if (isParentOfActive) liClasses.push('active-parent');\n          if (isCollapsible) liClasses.push('collapsible');\n          \n          let liAttributes = `class=\"${liClasses.join(' ')}\"`;\n          if (isCollapsible) {\n              liAttributes += ` data-nav-id=\"${item.path}\"`;\n              if (shouldBeOpen) {\n                  liAttributes += ` aria-expanded=\"true\"`;\n              }\n          }\n\n          // 4. Build Link URL\n          let finalHref = item.path;\n          \n          if (!isExternal) {\n             if (!itemPath || itemPath === '#') {\n                 finalHref = '#';\n             } else {\n                 let cleanPath = item.path;\n                 if (cleanPath.startsWith('/')) cleanPath = cleanPath.substring(1);\n                 \n                 finalHref = relativePathToRoot + cleanPath;\n\n                 const offline = (typeof locals !== 'undefined' && locals.isOfflineMode) === true;\n\n                 if (offline) {\n                     // Offline Mode Logic\n                     if (finalHref.endsWith('/')) {\n                         finalHref += 'index.html';\n                     } else if (finalHref === './') {\n                         finalHref = './index.html';\n                     } else if (!finalHref.includes('#')) {\n                         // FIX: Check only the last segment for a dot (extension)\n                         // e.g. \"../../guide\" -> last segment \"guide\" (no dot) -> add index.html\n                         // e.g. \"../../guide.html\" -> last segment \"guide.html\" (has dot) -> skip\n                         \n                         const parts = finalHref.split('?')[0].split('/'); // Remove query, split by slash\n                         const lastSegment = parts[parts.length - 1];\n                         \n                         if (!lastSegment.includes('.')) {\n                             finalHref += '/index.html';\n                         }\n                     }\n                 } else {\n                     // Clean URL Mode\n                     if (finalHref.endsWith('/index.html')) {\n                         finalHref = finalHref.substring(0, finalHref.length - 10);\n                     }\n                 }\n             }\n          }\n    %>\n    <li <%- liAttributes %>>\n      <a href=\"<%- finalHref %>\" class=\"<%- isActive ? 'active' : '' %>\" <%- isExternal ? 'target=\"_blank\" rel=\"noopener\"' : '' %>>\n        <% if (item.icon) { %> <%- renderIcon(item.icon) %> <% } %>\n        <span class=\"nav-item-title\"><%= item.title %></span>\n        <% if (isCollapsible) { %> <%- renderIcon('chevron-right', { class: 'collapse-icon' }) %> <% } %>\n        <% if (isExternal) { %> <%- renderIcon('external-link', { class: 'nav-external-icon' }) %> <% } %>\n      </a>\n      <% if (item.children) { %>\n        <ul class=\"submenu\" style=\"display: <%= (isCollapsible && shouldBeOpen) ? 'block' : 'none' %>;\">\n          <% renderNav(item.children); %>\n        </ul>\n      <% } %>\n    </li>\n    <%\n        });\n      }\n      renderNav(navItems);\n    %>\n  </ul>\n</nav>",
+  "no-style.ejs": "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n\n    <% if (frontmatter.components?.meta !== false) { %>\n        <%- metaTagsHtml || '' %>\n        <title><%= pageTitle %><% if (frontmatter.components?.siteTitle !== false) { %> | <%= siteTitle %><% } %></title>\n        <% if (description && !(metaTagsHtml && metaTagsHtml.includes('name=\"description\"'))) { %>\n            <meta name=\"description\" content=\"<%= description %>\">\n        <% } %>\n    <% } %>\n\n    <% if (frontmatter.components?.favicon !== false) { %>\n        <%- faviconLinkHtml || '' %>\n    <% } %>\n\n    <% if (frontmatter.components?.themeMode !== false) { %>\n        <script>window.DOCMD_DEFAULT_MODE = \"<%= defaultMode %>\";</script>\n    <% } %>\n\n    <% if (frontmatter.components?.css !== false) { %>\n        <link rel=\"stylesheet\" href=\"<%= relativePathToRoot %>assets/css/docmd-main.css\">\n        <% if (frontmatter.components?.highlight !== false) { %>\n            <link rel=\"stylesheet\" href=\"<%= relativePathToRoot %>assets/css/docmd-highlight-<%= defaultMode === 'dark' ? 'dark' : 'light' %>.css\" id=\"highlight-theme\">\n        <% } %>\n    <% } %>\n\n    <% if (frontmatter.components?.themeMode !== false) { %>\n        <%- themeInitScript %>\n    <% } %>\n\n    <% if (frontmatter.components?.theme !== false) { %>\n        <%- themeCssLinkHtml || '' %>\n    <% } %>\n\n    <% if (frontmatter.components?.customCss !== false && customCssFiles && customCssFiles.length > 0) { %>\n        <% customCssFiles.forEach(cssFile => { %>\n            <link rel=\"stylesheet\" href=\"<%= relativePathToRoot %><%- cssFile.startsWith('/') ? cssFile.substring(1) : cssFile %>\">\n        <% }); %>\n    <% } %>\n\n    <% if (frontmatter.components?.pluginStyles !== false) { %>\n        <%- pluginStylesHtml || '' %>\n    <% } %>\n\n    <% if (frontmatter.components?.pluginHeadScripts !== false) { %>\n        <%- pluginHeadScriptsHtml || '' %>\n    <% } %>\n    \n    <% if (frontmatter.customHead) { %>\n        <%- frontmatter.customHead %>\n    <% } %>\n</head>\n<body\n    <%\n    if (frontmatter.components?.theme !== false) {\n        %> data-theme=\"<%= defaultMode %>\"<%\n    }\n    %><%\n    if (frontmatter.bodyClass) {\n        %> class=\"<%= frontmatter.bodyClass %>\"<%\n    }\n    %> data-copy-code-enabled=\"<%= config.copyCode === true %>\">\n    <% if (frontmatter.components?.layout === true || frontmatter.components?.layout === 'full') { %>\n        <div class=\"main-content-wrapper\">\n            <% if (frontmatter.components?.header !== false) { %>\n                <header class=\"page-header\">\n                    <% if (frontmatter.components?.pageTitle !== false) { %>\n                        <h1><%= pageTitle %></h1>\n                    <% } %>\n                </header>\n            <% } %>\n            <main class=\"content-area\">\n                <div class=\"content-layout\">\n                    <div class=\"main-content\">\n                        <%- content %>\n                    </div>\n                </div>\n            </main>\n            <% if (frontmatter.components?.footer !== false) { %>\n                <footer class=\"page-footer\">\n                    <div class=\"footer-content\">\n                        <div class=\"user-footer\">\n                            <%- footerHtml || '' %>\n                        </div>\n                        <% if (frontmatter.components?.branding !== false) { %>\n                            <div class=\"branding-footer\">\n                                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>\n                            </div>\n                        <% } %>\n                    </div>\n                </footer>\n            <% } %>\n        </div>\n    <% } else if (frontmatter.components?.sidebar === true) { %>\n        <aside class=\"sidebar\">\n            <% if (frontmatter.components?.logo !== false && logo && logo.light && logo.dark) { %>\n                <div class=\"sidebar-header\">\n                    <a href=\"<%= logo.href || (relativePathToRoot + 'index.html') %>\" class=\"logo-link\">\n                        <img src=\"<%= relativePathToRoot %><%- logo.light.startsWith('/') ? logo.light.substring(1) : logo.light %>\" alt=\"<%= logo.alt || siteTitle %>\" class=\"logo-light\" <% if (logo.height) { %>style=\"height: <%= logo.height %>;\"<% } %>>\n                        <img src=\"<%= relativePathToRoot %><%- logo.dark.startsWith('/') ? logo.dark.substring(1) : logo.dark %>\" alt=\"<%= logo.alt || siteTitle %>\" class=\"logo-dark\" <% if (logo.height) { %>style=\"height: <%= logo.height %>;\"<% } %>>\n                    </a>\n                </div>\n            <% } %>\n            <% if (frontmatter.components?.navigation !== false) { %>\n                <%- navigationHtml %>\n            <% } %>\n            <% if (frontmatter.components?.themeToggle !== false && theme && theme.enableModeToggle) { %>\n                <button id=\"theme-toggle-button\" aria-label=\"Toggle theme\" class=\"theme-toggle-button\">\n                    <%- renderIcon('sun', { class: 'icon-sun' }) %>\n                    <%- renderIcon('moon', { class: 'icon-moon' }) %>\n                </button>\n            <% } %>\n        </aside>\n        <div class=\"main-content-wrapper\">\n            <% if (frontmatter.components?.header !== false) { %>\n                <header class=\"page-header\">\n                    <% if (frontmatter.components?.pageTitle !== false) { %>\n                        <h1><%= pageTitle %></h1>\n                    <% } %>\n                </header>\n            <% } %>\n            <main class=\"content-area\">\n                <div class=\"content-layout\">\n                    <div class=\"main-content\">\n                        <%- content %>\n                    </div>\n                    <% if (frontmatter.components?.toc !== false && headings && headings.length > 0) { %>\n                        <div class=\"toc-sidebar\">\n                            <%- include('toc', { content, headings, navigationHtml, isActivePage }) %>\n                        </div>\n                    <% } %>\n                </div>\n            </main>\n            <% if (frontmatter.components?.footer !== false) { %>\n                <footer class=\"page-footer\">\n                    <div class=\"footer-content\">\n                        <div class=\"user-footer\">\n                            <%- footerHtml || '' %>\n                        </div>\n                        <% if (frontmatter.components?.branding !== false) { %>\n                            <div class=\"branding-footer\">\n                                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>\n                            </div>\n                        <% } %>\n                    </div>\n                </footer>\n            <% } %>\n        </div>\n    <% } else { %>\n        <%- content %>\n    <% } %>\n\n    <% if (frontmatter.components?.scripts === true) { %>\n        <% if (frontmatter.components?.mainScripts === true) { %>\n            <script src=\"<%= relativePathToRoot %>assets/js/docmd-main.js\"></script>\n        <% } %>\n        \n        <% if (frontmatter.components?.lightbox === true && frontmatter.components?.mainScripts === true) { %>\n            <script src=\"<%= relativePathToRoot %>assets/js/docmd-image-lightbox.js\"></script>\n        <% } %>\n        \n        <% if (frontmatter.components?.customJs === true && customJsFiles && customJsFiles.length > 0) { %>\n            <% customJsFiles.forEach(jsFile => { %>\n                <script src=\"<%= relativePathToRoot %><%- jsFile.startsWith('/') ? jsFile.substring(1) : jsFile %>\"></script>\n            <% }); %>\n        <% } %>\n        \n        <% if (frontmatter.components?.pluginBodyScripts === true) { %>\n            <%- pluginBodyScriptsHtml || '' %>\n        <% } %>\n    <% } %>\n    \n    <% if (frontmatter.customScripts) { %>\n        <%- frontmatter.customScripts %>\n    <% } %>\n</body>\n</html> ",
+  "toc.ejs": "<%# src/templates/toc.ejs %>\n<% \n// Helper function to decode HTML entities\nfunction decodeHtmlEntities(html) {\n  return html\n    .replace(/&amp;/g, '&')\n    .replace(/&lt;/g, '<')\n    .replace(/&gt;/g, '>')\n    .replace(/&quot;/g, '\"')\n    .replace(/&#39;/g, \"'\")\n    .replace(/&nbsp;/g, ' ');\n}\n\n// Use the isActivePage flag if provided, otherwise fall back to checking navigationHtml\nconst shouldShowToc = typeof isActivePage !== 'undefined' ? isActivePage : \n                      (typeof navigationHtml !== 'undefined' && navigationHtml && navigationHtml.includes('class=\"active\"'));\n\nif (shouldShowToc && !frontmatter?.toc || frontmatter?.toc !== 'false') {\n  // If direct headings aren't available, we'll try to extract them from the content\n  let tocHeadings = [];\n  if (headings && headings.length > 0) {\n    // Use provided headings if available\n    tocHeadings = headings.filter(h => h.level >= 2 && h.level <= 4);\n  } else if (content) {\n    // Basic regex to extract headings from HTML content\n    const headingRegex = /<h([2-4])[^>]*?(?:id=\"([^\"]*)\")?[^>]*?>([\\s\\S]*?)<\\/h\\1>/g;\n    let match;\n    let contentStr = content.toString();\n    \n    while ((match = headingRegex.exec(contentStr)) !== null) {\n      const level = parseInt(match[1], 10);\n      // Use ID if available, or generate one from the text\n      let id = match[2];\n      // Remove any HTML tags inside the heading text\n      const textWithTags = match[3].replace(/<\\/?[^>]+(>|$)/g, '');\n      // Decode HTML entities\n      const text = decodeHtmlEntities(textWithTags);\n      \n      if (!id) {\n        // Generate an ID from the heading text if none exists\n        id = text\n          .toLowerCase()\n          .replace(/\\s+/g, '-')\n          .replace(/[^\\w-]/g, '')\n          .replace(/--+/g, '-')\n          .replace(/^-+|-+$/g, '');\n      }\n      \n      tocHeadings.push({ id, level, text });\n    }\n  }\n\n  // Only show TOC if there are enough headings\n  if (tocHeadings.length > 1) { \n%>\n  <div class=\"toc-container\">\n    <h2 class=\"toc-title\">On This Page<span class=\"mobile-view toc-menu-button float-right\"><%- renderIcon(\"chevrons-down-up\") %></span></h2>\n    <ul class=\"toc-list\">\n      <% tocHeadings.forEach(heading => { %>\n        <li class=\"toc-item toc-level-<%= heading.level %>\">\n          <a href=\"#<%= heading.id %>\" class=\"toc-link\"><%- heading.text %></a>\n        </li>\n      <% }); %>\n    </ul>\n  </div>\n<% } \n} %> "
+};
+if (typeof globalThis !== 'undefined') globalThis.__DOCMD_TEMPLATES__ = templates;
+module.exports = templates;

package/src/templates/layout.ejs

@@ -44,17 +44,17 @@
     data-copy-code-enabled="<%= config.copyCode === true %>">
     <aside class="sidebar">
         <div class="sidebar-header">
-            <% if (logo && logo.light && logo.dark) { %>
-                <a href="<%= logo.href || (relativePathToRoot + 'index.html') %>" class="logo-link">
-                    <img src="<%= relativePathToRoot %><%- logo.light.startsWith('/') ? logo.light.substring(1) : logo.light %>" alt="<%= logo.alt || siteTitle %>" class="logo-light" <% if (logo.height) { %>style="height: <%= logo.height %>;"<% } %>>
-                    <img src="<%= relativePathToRoot %><%- logo.dark.startsWith('/') ? logo.dark.substring(1) : logo.dark %>" alt="<%= logo.alt || siteTitle %>" class="logo-dark" <% if (logo.height) { %>style="height: <%= logo.height %>;"<% } %>>
-                </a>
-            <% } else { %>
-                <h1><a href="<%= relativePathToRoot %>index.html"><%= siteTitle %></a></h1>
-            <% } %>
-                <span class="mobile-view sidebar-menu-button float-right">
-                    <%- renderIcon("ellipsis-vertical") %>
-                </span>
+        <% if (logo && logo.light && logo.dark) { %>
+            <a href="<%= logo.href || relativePathToRoot %>" class="logo-link">
+                <img src="<%= relativePathToRoot %><%- logo.light.startsWith('/') ? logo.light.substring(1) : logo.light %>" alt="<%= logo.alt || siteTitle %>" class="logo-light" <% if (logo.height) { %>style="height: <%= logo.height %>;"<% } %>>
+                <img src="<%= relativePathToRoot %><%- logo.dark.startsWith('/') ? logo.dark.substring(1) : logo.dark %>" alt="<%= logo.alt || siteTitle %>" class="logo-dark" <% if (logo.height) { %>style="height: <%= logo.height %>;"<% } %>>
+            </a>
+        <% } else { %>
+            <h1><a href="<%= relativePathToRoot %>index.html"><%= siteTitle %></a></h1>
+        <% } %>
+            <span class="mobile-view sidebar-menu-button float-right">
+                <%- renderIcon("ellipsis-vertical") %>
+            </span>
         </div>
         <%- navigationHtml %>
         <% if (theme && theme.enableModeToggle && theme.positionMode !== 'top') { %>

package/src/templates/navigation.ejs

@@ -2,36 +2,46 @@
 <nav class="sidebar-nav" aria-label="Main navigation">
   <ul>
     <%
-      // A robust, centralized function to normalize navigation paths
+      // Helper: Normalize paths for comparison
       function normalizePath(p) {
         if (!p) return '#';
         let path = p.replace(/\\/g, '/');
         
+        // Strip leading ./ if present
+        if (path.startsWith('./')) {
+            path = path.substring(2);
+        }
+
+        // Handle file extensions
         if (path.endsWith('index.md')) {
           path = path.slice(0, -'index.md'.length);
         } else {
           path = path.replace(/\.md$/, '');
         }
 
+        // Ensure leading slash
         if (!path.startsWith('/')) path = '/' + path;
 
+        // Ensure trailing slash
         if (path.length > 1 && !path.endsWith('/')) {
           path += '/';
         }
         
-        // Handle root case where path might be "" after stripping index.md
+        // Handle root
         if (path === '') path = '/';
         
         return path;
       }
 
-      // Helper to check for active children recursively
+      // Helper: Recursively check if an item contains the active page
       function hasActiveChild(item, currentPagePath) {
         if (!item.children || !Array.isArray(item.children)) return false;
         return item.children.some(child => {
           if (!child.path || child.external) return false;
           const childPath = normalizePath(child.path);
+          
           if (currentPagePath === childPath) return true;
+          
           return hasActiveChild(child, currentPagePath);
         });
       }
@@ -39,24 +49,76 @@
       // Recursive function to render navigation items
       function renderNav(items) {
         if (!items || !Array.isArray(items)) return;
+        
         items.forEach(item => {
           const isExternal = item.external || false;
           let itemPath = item.path || '#';
-          
           const normalizedItemPath = isExternal ? itemPath : normalizePath(itemPath);
 
+          // 1. Determine State
           const isActive = !isExternal && currentPagePath === normalizedItemPath;
           const isParentOfActive = !isActive && hasActiveChild(item, currentPagePath);
           const isCollapsible = item.children && item.collapsible;
+          
+          // 2. Open State (Server-Side Calculation)
+          const shouldBeOpen = isParentOfActive || (isActive && item.children && item.children.length > 0);
 
+          // 3. Build Attributes String
           const liClasses = [];
           if (isActive) liClasses.push('active');
           if (isParentOfActive) liClasses.push('active-parent');
           if (isCollapsible) liClasses.push('collapsible');
           
-          const finalHref = isExternal ? item.path : (itemPath === '#' ? '#' : (relativePathToRoot + (item.path.startsWith('/') ? item.path.substring(1) : item.path)));
+          let liAttributes = `class="${liClasses.join(' ')}"`;
+          if (isCollapsible) {
+              liAttributes += ` data-nav-id="${item.path}"`;
+              if (shouldBeOpen) {
+                  liAttributes += ` aria-expanded="true"`;
+              }
+          }
+
+          // 4. Build Link URL
+          let finalHref = item.path;
+          
+          if (!isExternal) {
+             if (!itemPath || itemPath === '#') {
+                 finalHref = '#';
+             } else {
+                 let cleanPath = item.path;
+                 if (cleanPath.startsWith('/')) cleanPath = cleanPath.substring(1);
+                 
+                 finalHref = relativePathToRoot + cleanPath;
+
+                 const offline = (typeof locals !== 'undefined' && locals.isOfflineMode) === true;
+
+                 if (offline) {
+                     // Offline Mode Logic
+                     if (finalHref.endsWith('/')) {
+                         finalHref += 'index.html';
+                     } else if (finalHref === './') {
+                         finalHref = './index.html';
+                     } else if (!finalHref.includes('#')) {
+                         // FIX: Check only the last segment for a dot (extension)
+                         // e.g. "../../guide" -> last segment "guide" (no dot) -> add index.html
+                         // e.g. "../../guide.html" -> last segment "guide.html" (has dot) -> skip
+                         
+                         const parts = finalHref.split('?')[0].split('/'); // Remove query, split by slash
+                         const lastSegment = parts[parts.length - 1];
+                         
+                         if (!lastSegment.includes('.')) {
+                             finalHref += '/index.html';
+                         }
+                     }
+                 } else {
+                     // Clean URL Mode
+                     if (finalHref.endsWith('/index.html')) {
+                         finalHref = finalHref.substring(0, finalHref.length - 10);
+                     }
+                 }
+             }
+          }
     %>
-    <li class="<%= liClasses.join(' ') %>" <%- isCollapsible ? `data-nav-id="${item.path}"` : '' %>>
+    <li <%- liAttributes %>>
       <a href="<%- finalHref %>" class="<%- isActive ? 'active' : '' %>" <%- isExternal ? 'target="_blank" rel="noopener"' : '' %>>
         <% if (item.icon) { %> <%- renderIcon(item.icon) %> <% } %>
         <span class="nav-item-title"><%= item.title %></span>
@@ -64,7 +126,7 @@
         <% if (isExternal) { %> <%- renderIcon('external-link', { class: 'nav-external-icon' }) %> <% } %>
       </a>
       <% if (item.children) { %>
-        <ul class="submenu">
+        <ul class="submenu" style="display: <%= (isCollapsible && shouldBeOpen) ? 'block' : 'none' %>;">
           <% renderNav(item.children); %>
         </ul>
       <% } %>

package/config.js

@@ -1,175 +0,0 @@
-// Source file from the docmd project — https://github.com/mgks/docmd
-
-module.exports = {
-  // --- Core Metadata ---
-  siteTitle: 'docmd',
-  siteUrl: 'https://docmd.mgks.dev', // No trailing slash
-
-  // --- Branding ---
-  logo: {
-    light: '/assets/images/docmd-logo-light.png',
-    dark: '/assets/images/docmd-logo-dark.png',
-    alt: 'docmd Logo',
-    href: '/',
-  },
-  favicon: '/assets/favicon.ico',
-
-  // --- Structure ---
-  srcDir: 'docs',       // Source markdown files directory
-  outputDir: 'site',    // Output directory for generated site
-
-  // --- Features & UX ---
-  search: true,           // Built-in offline search
-  minify: true,           // Production build optimization
-  autoTitleFromH1: true,  // Auto-generate title from first H1 if frontmatter title is missing
-  copyCode: true,         // Enable "copy to clipboard" on code blocks
-  pageNavigation: true,   // Next/Prev links
-
-  // --- Sidebar & Theme ---
-  sidebar: {
-    collapsible: true,
-    defaultCollapsed: false,
-  },
-  theme: {
-    name: 'sky',            // 'default', 'sky', 'ruby', 'retro'
-    defaultMode: 'light',   // 'light' or 'dark'
-    enableModeToggle: true, // Show theme mode toggle button 
-    positionMode: 'top',    // 'top' or 'bottom' of header
-    codeHighlight: true,    // Enable code syntax highlighting
-    customCss: [],          // Add paths relative to outputDir here
-  },
-  customJs: [
-    '/assets/js/docmd-image-lightbox.js',
-  ],
-
-  // --- Plugins ---
-  plugins: {
-    seo: {
-      defaultDescription: 'The minimalist, zero-config documentation generator for Node.js developers.',
-      openGraph: {
-        defaultImage: '/assets/images/docmd-preview.png',
-      },
-      twitter: {
-        cardType: 'summary_large_image',
-      }
-    },
-    analytics: {
-      googleV4: {
-        measurementId: 'G-8QVBDQ4KM1'
-      }
-    },
-    sitemap: {
-      defaultChangefreq: 'weekly',
-      defaultPriority: 0.8
-    }
-  },
-
-  // --- Doc Source Link ---
-  editLink: {
-    enabled: true,
-    baseUrl: 'https://github.com/mgks/docmd/edit/main/docs',
-    text: 'Edit this page on GitHub'
-  },
-
-  // --- Navigation ---
-  navigation: [
-    { title: 'Welcome', path: '/', icon: 'feather' },
-    { title: 'Overview', path: '/overview', icon: 'home' },
-
-    {
-      title: 'Getting Started',
-      icon: 'rocket',
-      path: '/getting-started/',
-      children: [
-        { title: 'Installation', path: '/getting-started/installation', icon: 'download' },
-        { title: 'Basic Usage', path: '/getting-started/basic-usage', icon: 'play' },
-      ],
-    },
-
-    { title: 'Configuration', path: '/configuration', icon: 'settings' },
-
-    {
-      title: 'Content',
-      icon: 'layout-template',
-      path: '/content/',
-      collapsible: true,
-      children: [
-        { title: 'Markdown Syntax', path: '/content/markdown-syntax', icon: 'code-2' },
-        { title: 'Frontmatter', path: '/content/frontmatter', icon: 'file-text' },
-        { title: 'Images & Lightbox', path: '/content/images', icon: 'image' },
-        { title: 'Search', path: '/content/search', icon: 'search' },
-        { title: 'Mermaid Diagrams', path: '/content/mermaid', icon: 'network' },
-        {
-          title: 'Containers',
-          path: '/content/containers/',
-          icon: 'box',
-          collapsible: true,
-          children: [
-            { title: 'Callouts', path: '/content/containers/callouts', icon: 'megaphone' },
-            { title: 'Cards', path: '/content/containers/cards', icon: 'panel-top' },
-            { title: 'Steps', path: '/content/containers/steps', icon: 'list-ordered' },
-            { title: 'Tabs', path: '/content/containers/tabs', icon: 'columns-3' },
-            { title: 'Collapsible', path: '/content/containers/collapsible', icon: 'chevrons-down' },
-            { title: 'Changelogs', path: '/content/containers/changelogs', icon: 'history' },
-            { title: 'Buttons', path: '/content/containers/buttons', icon: 'mouse-pointer-click' },
-            { title: 'Nested Containers', path: '/content/containers/nested-containers', icon: 'folder-tree' },
-          ]
-        },
-        { title: 'No-Style Pages', path: '/content/no-style-pages', icon: 'layout' },
-      ],
-    },
-
-    {
-      title: 'Theming',
-      icon: 'palette',
-      path: '/theming/',
-      collapsible: true,
-      children: [
-        { title: 'Available Themes', path: '/theming/available-themes', icon: 'layout-grid' },
-        { title: 'Light & Dark Mode', path: '/theming/light-dark-mode', icon: 'sun-moon' },
-        { title: 'Custom CSS & JS', path: '/theming/custom-css-js', icon: 'file-code' },
-        { title: 'Icons', path: '/theming/icons', icon: 'pencil-ruler' },
-      ],
-    },
-
-    {
-      title: 'Plugins',
-      icon: 'puzzle',
-      path: '/plugins/',
-      collapsible: true,
-      children: [
-        { title: 'SEO & Meta', path: '/plugins/seo', icon: 'search' },
-        { title: 'Analytics', path: '/plugins/analytics', icon: 'bar-chart' },
-        { title: 'Sitemap', path: '/plugins/sitemap', icon: 'map' },
-      ],
-    },
-
-    {
-      title: 'Recipes',
-      icon: 'chef-hat',
-      path: '/recipes/',
-      collapsible: true,
-      children: [
-        { title: 'Landing Page', path: '/recipes/landing-page', icon: 'layout-template' },
-        { title: 'Custom Fonts', path: '/recipes/custom-fonts', icon: 'type' },
-        { title: 'Favicon', path: '/recipes/favicon', icon: 'image-plus' },
-      ],
-    },
-
-    { title: 'CLI Commands', path: '/cli-commands', icon: 'terminal' },
-    { title: 'Deployment', path: '/deployment', icon: 'upload-cloud' },
-    { title: 'Comparison', path: '/comparison', icon: 'scale' },
-    { title: 'Contributing', path: '/contributing', icon: 'git-pull-request' },
-
-    { title: 'GitHub', path: 'https://github.com/mgks/docmd', icon: 'github', external: true },
-    { title: 'Discussions', path: 'https://github.com/mgks/docmd/discussions', icon: 'message-circle', external: true },
-  ],
-
-  // --- Footer & Sponsor ---
-  footer: '© ' + new Date().getFullYear() + ' Project docmd.',
-  sponsor: {
-    enabled: true,
-    title: 'Sponsor',
-    link: 'https://github.com/sponsors/mgks',
-  },
-};