@knowcode/doc-builder 1.9.13 → 1.9.14

package/assets/css/notion-style.css

@@ -459,6 +459,43 @@ pre code {
   color: var(--color-text-primary);
 }
 
+/* Banner types */
+.banner-warning {
+  background: var(--color-accent-yellow-bg);
+  border-bottom: 1px solid var(--color-accent-yellow);
+}
+
+.banner-warning .banner-icon {
+  color: var(--color-accent-yellow);
+}
+
+.banner-info {
+  background: var(--color-accent-blue-bg);
+  border-bottom: 1px solid var(--color-accent-blue);
+}
+
+.banner-info .banner-icon {
+  color: var(--color-accent-blue);
+}
+
+.banner-success {
+  background: var(--color-accent-green-bg);
+  border-bottom: 1px solid var(--color-accent-green);
+}
+
+.banner-success .banner-icon {
+  color: var(--color-accent-green);
+}
+
+.banner-error {
+  background: var(--color-accent-red-bg);
+  border-bottom: 1px solid var(--color-accent-red);
+}
+
+.banner-error .banner-icon {
+  color: var(--color-accent-red);
+}
+
 /* Breadcrumbs - definition moved to line 888 to avoid duplication */
 
 .breadcrumb-item {

package/lib/config.js

@@ -39,7 +39,8 @@ const defaultConfig = {
     attachments: true,         // Copy attachments (Excel, PDF, etc.) to output
     dynamicNavIcons: true,     // Use status-based icons in navigation
     subtleColors: true,        // Apply subtle colors to status icons
-    privateDirectoryAuth: false // Enable auth for private directories only (auto-detected)
+    privateDirectoryAuth: false, // Enable auth for private directories only (auto-detected)
+    banner: false              // Show preview banner at top of pages
   },
   
   // Authentication - Supabase only (basic auth removed for security)
@@ -54,6 +55,15 @@ const defaultConfig = {
     enabled: true
   },
   
+  // Banner configuration
+  banner: {
+    enabled: false,
+    text: 'This documentation is a preview version - some content may be incomplete',
+    icon: 'fas fa-exclamation-triangle',
+    type: 'warning', // warning, info, success, error
+    dismissible: true
+  },
+  
   // Navigation configuration
   folderOrder: [],
   folderDescriptions: {},
@@ -127,7 +137,8 @@ const notionInspiredPreset = {
     normalizeTitle: true,
     showPdfDownload: true,
     menuDefaultOpen: true,
-    attachments: true
+    attachments: true,
+    banner: false              // Show preview banner at top of pages
   },
   
   auth: {
@@ -140,6 +151,15 @@ const notionInspiredPreset = {
     enabled: true
   },
   
+  // Banner configuration
+  banner: {
+    enabled: false,
+    text: 'This documentation is a preview version - some content may be incomplete',
+    icon: 'fas fa-exclamation-triangle',
+    type: 'warning',
+    dismissible: true
+  },
+  
   // Folder descriptions from existing code
   folderDescriptions: {
     'product-roadmap': 'Strategic vision, timeline, and feature planning',
@@ -296,6 +316,9 @@ function migrateConfig(userConfig, targetVersion) {
   if (!userConfig.features?.phosphorSize) {
     newFeatures.push('Phosphor icon sizing');
   }
+  if (userConfig.features?.banner === undefined) {
+    newFeatures.push('Configurable preview banner');
+  }
   
   if (newFeatures.length > 0) {
     console.log(chalk.green(`✨ Added new features: ${newFeatures.join(', ')}`));

package/lib/core-builder.js

@@ -548,16 +548,20 @@ ${seoTags}
         </div>
     </header>
     
+    ${config.banner?.enabled || config.features?.banner ? `
     <!-- Preview Banner -->
-    <div id="preview-banner" class="preview-banner">
+    <div id="preview-banner" class="preview-banner banner-${config.banner?.type || 'warning'}">
         <div class="banner-content">
-            <i class="fas fa-exclamation-triangle banner-icon"></i>
-            <span class="banner-text">This documentation is a preview version - some content may be incomplete</span>
+            <i class="${config.banner?.icon || 'fas fa-exclamation-triangle'} banner-icon"></i>
+            <span class="banner-text">${config.banner?.text || 'This documentation is a preview version - some content may be incomplete'}</span>
+            ${config.banner?.dismissible !== false ? `
             <button id="dismiss-banner" class="banner-dismiss" aria-label="Dismiss banner">
                 <i class="fas fa-times"></i>
             </button>
+            ` : ''}
         </div>
     </div>
+    ` : ''}
     
     <!-- Breadcrumbs -->
     <nav class="breadcrumbs" id="breadcrumbs">
@@ -570,7 +574,7 @@ ${seoTags}
         <aside class="sidebar">
             <div class="sidebar-header">
                 <div class="filter-box">
-                    <input type="text" placeholder="Filter items..." class="filter-input" id="nav-filter">
+                    <input type="text" placeholder="Search menu..." class="filter-input" id="nav-filter">
                     <i class="fas fa-search filter-icon"></i>
                 </div>
             </div>

package/package.json

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