@knowcode/doc-builder 1.9.30 → 1.10.0

package/package/index.js

@@ -1,38 +0,0 @@
-/**
- * @knowcode/doc-builder - Programmatic API
- * 
- * This module exports functions for use in scripts or other tools
- */
-
-const { build } = require('./lib/builder');
-const { startDevServer } = require('./lib/dev-server');
-const { deployToVercel, setupVercelProject } = require('./lib/deploy');
-const { loadConfig, createDefaultConfig } = require('./lib/config');
-
-module.exports = {
-  // Main functions
-  build,
-  startDevServer,
-  deployToVercel,
-  setupVercelProject,
-  
-  // Config utilities
-  loadConfig,
-  createDefaultConfig,
-  
-  // Convenience wrapper for common operations
-  async buildDocs(configPath = 'doc-builder.config.js', options = {}) {
-    const config = await loadConfig(configPath, options);
-    return build(config);
-  },
-  
-  async deploy(configPath = 'doc-builder.config.js', options = {}) {
-    const config = await loadConfig(configPath, options);
-    return deployToVercel(config, options.prod);
-  },
-  
-  async dev(configPath = 'doc-builder.config.js', options = {}) {
-    const config = await loadConfig(configPath, options);
-    return startDevServer(config, options.port || 3000);
-  }
-};

package/package/lib/builder.js

@@ -1,32 +0,0 @@
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-const { buildDocumentation } = require('./core-builder');
-
-/**
- * Main build function
- * Now fully self-contained!
- */
-async function build(config) {
-  console.log(chalk.blue(`\n🚀 Building ${config.siteName}...\n`));
-  
-  // Validate config
-  if (!config || typeof config !== 'object') {
-    throw new Error('Invalid configuration provided to build function');
-  }
-  
-  try {
-    // Use the self-contained builder
-    await buildDocumentation(config);
-    console.log(chalk.green('\n✨ Build complete!\n'));
-  } catch (error) {
-    console.error(chalk.red('\n❌ Build failed:'), error.message);
-    throw error;
-  }
-}
-
-// Asset copying is now handled in core-builder.js
-
-module.exports = {
-  build
-};

package/package/lib/config.js

@@ -1,278 +0,0 @@
-const fs = require('fs-extra');
-const path = require('path');
-const chalk = require('chalk');
-
-/**
- * Default configuration
- */
-const defaultConfig = {
-  // Source and output directories
-  docsDir: 'docs',
-  outputDir: 'html',
-  
-  // Site metadata
-  siteName: 'Documentation',
-  siteDescription: 'Documentation site built with @knowcode/doc-builder',
-  
-  // Features
-  features: {
-    authentication: false,
-    changelog: true,
-    mermaid: true,
-    tooltips: true,
-    search: false,
-    darkMode: true
-  },
-  
-  // Authentication (if enabled)
-  auth: {
-    username: 'admin',
-    password: 'password'
-  },
-  
-  // Changelog settings
-  changelog: {
-    daysBack: 14,
-    enabled: true
-  },
-  
-  // Navigation configuration
-  folderOrder: [],
-  folderDescriptions: {},
-  folderIcons: {},
-  
-  // Deployment
-  deployment: {
-    platform: 'vercel',
-    outputDirectory: 'html'
-  }
-};
-
-/**
- * Notion-inspired preset - clean, modern documentation style
- */
-const notionInspiredPreset = {
-  docsDir: 'docs',
-  outputDir: 'html',
-  siteName: 'Documentation',  // Clean default name
-  siteDescription: 'Transforming complex sales through intelligent automation',
-  
-  features: {
-    authentication: true,
-    changelog: true,
-    mermaid: true,
-    tooltips: true,
-    search: false,
-    darkMode: true
-  },
-  
-  auth: {
-    username: 'admin',
-    password: 'docs2025'
-  },
-  
-  changelog: {
-    daysBack: 14,
-    enabled: true
-  },
-  
-  // Folder descriptions from existing code
-  folderDescriptions: {
-    'product-roadmap': 'Strategic vision, timeline, and feature planning',
-    'product-requirements': 'Detailed product specifications, requirements documents, and feature definitions',
-    'architecture': 'System design, data flows, and technical infrastructure documentation',
-    'system-analysis': 'Comprehensive system analysis, functional requirements, and cross-component documentation',
-    'bubble': 'Core application platform - business logic, UI/UX, and user workflows',
-    'quickbase': 'Database schema, data management, and backend operations',
-    'activecampaign': 'Marketing automation integration and lead management system',
-    'juno-signer': 'Document signing service for digital signatures and PDF generation',
-    'juno-api-deprecated': 'Legacy API documentation (deprecated, for reference only)',
-    'postman': 'API testing tools, collections, and test automation',
-    'mcp': 'Model Context Protocol setup and configuration guides',
-    'team': 'Team roles, responsibilities, and task assignments',
-    'thought-leadership': 'Strategic thinking, industry insights, and future vision',
-    'paths': 'Dynamic pathway routing system for insurance applications',
-    'testing': 'Testing procedures, checklists, and quality assurance',
-    'technical': 'Technical documentation and implementation details',
-    'application': 'Application components, data types, and workflows'
-  },
-  
-  folderIcons: {
-    'root': 'fas fa-home',
-    'product-roadmap': 'fas fa-road',
-    'product-requirements': 'fas fa-clipboard-list',
-    'architecture': 'fas fa-sitemap',
-    'system-analysis': 'fas fa-analytics',
-    'system': 'fas fa-cogs',
-    'bubble': 'fas fa-bubble',
-    'quickbase': 'fas fa-database',
-    'activecampaign': 'fas fa-envelope',
-    'juno-signer': 'fas fa-signature',
-    'juno-api-deprecated': 'fas fa-archive',
-    'postman': 'fas fa-flask',
-    'mcp': 'fas fa-puzzle-piece',
-    'team': 'fas fa-users',
-    'thought-leadership': 'fas fa-lightbulb',
-    'middleware': 'fas fa-layer-group',
-    'paths': 'fas fa-route',
-    'testing': 'fas fa-vial',
-    'juno-api': 'fas fa-plug'
-  },
-  
-  folderOrder: [
-    'product-roadmap',
-    'product-requirements',
-    'architecture',
-    'system-analysis',
-    'bubble',
-    'quickbase',
-    'activecampaign',
-    'juno-signer',
-    'juno-api-deprecated',
-    'postman',
-    'mcp',
-    'team',
-    'thought-leadership'
-  ]
-};
-
-/**
- * Load configuration
- */
-async function loadConfig(configPath, options = {}) {
-  let config = { ...defaultConfig };
-  
-  // Apply preset if specified
-  if (options.preset === 'notion-inspired') {
-    config = { ...config, ...notionInspiredPreset };
-  }
-  
-  // Load custom config file if it exists
-  const customConfigPath = path.join(process.cwd(), configPath);
-  if (fs.existsSync(customConfigPath)) {
-    try {
-      const customConfig = require(customConfigPath);
-      config = { ...config, ...customConfig };
-      
-      // Handle alternative config formats
-      if (customConfig.site) {
-        // Map site.title to siteName
-        if (customConfig.site.title) {
-          config.siteName = customConfig.site.title;
-          console.log(chalk.gray(`  Using site name: ${config.siteName}`));
-        }
-        if (customConfig.site.description) {
-          config.siteDescription = customConfig.site.description;
-        }
-      }
-      
-      // Map input/output to docsDir/outputDir
-      if (customConfig.input) {
-        config.docsDir = customConfig.input;
-      }
-      if (customConfig.output) {
-        config.outputDir = customConfig.output;
-      }
-      
-      console.log(chalk.gray(`Loaded config from ${configPath}`));
-    } catch (error) {
-      console.warn(chalk.yellow(`Warning: Failed to load config file: ${error.message}`));
-    }
-  } else if (!options.preset && !options.legacy) {
-    console.log(chalk.gray('No config file found, using defaults'));
-  }
-  
-  // Apply CLI options (these override config file)
-  if (options.input) {
-    config.docsDir = options.input;
-  }
-  if (options.output) {
-    config.outputDir = options.output;
-  }
-  if (options.auth === false) {
-    config.features.authentication = false;
-  }
-  if (options.changelog === false) {
-    config.features.changelog = false;
-    config.changelog.enabled = false;
-  }
-  
-  // Legacy mode - auto-detect structure
-  if (options.legacy) {
-    const docsPath = path.join(process.cwd(), 'docs');
-    const htmlPath = path.join(process.cwd(), 'html');
-    
-    if (fs.existsSync(docsPath) && fs.existsSync(htmlPath)) {
-      console.log(chalk.gray('Legacy mode: detected docs/ and html/ structure'));
-      config.docsDir = 'docs';
-      config.outputDir = 'html';
-    }
-  }
-  
-  // Validate paths - but be lenient for deploy command
-  const docsPath = path.join(process.cwd(), config.docsDir);
-  if (!fs.existsSync(docsPath)) {
-    console.warn(chalk.yellow(`Warning: Documentation directory not found: ${config.docsDir}`));
-    console.log(chalk.gray(`Create it with: mkdir ${config.docsDir} && echo "# Documentation" > ${config.docsDir}/README.md`));
-    // Don't throw error - let commands handle missing directories appropriately
-  }
-  
-  return config;
-}
-
-/**
- * Create default configuration
- */
-async function createDefaultConfig() {
-  const answers = await require('prompts')([
-    {
-      type: 'text',
-      name: 'siteName',
-      message: 'Site name:',
-      initial: 'My Documentation'
-    },
-    {
-      type: 'text',
-      name: 'siteDescription',
-      message: 'Site description:',
-      initial: 'Documentation for my project'
-    },
-    {
-      type: 'confirm',
-      name: 'authentication',
-      message: 'Enable authentication?',
-      initial: false
-    },
-    {
-      type: prev => prev ? 'text' : null,
-      name: 'authUsername',
-      message: 'Authentication username:',
-      initial: 'admin'
-    },
-    {
-      type: prev => prev ? 'password' : null,
-      name: 'authPassword',
-      message: 'Authentication password:',
-      initial: 'password'
-    }
-  ]);
-  
-  const config = { ...defaultConfig };
-  config.siteName = answers.siteName;
-  config.siteDescription = answers.siteDescription;
-  config.features.authentication = answers.authentication;
-  
-  if (answers.authentication) {
-    config.auth.username = answers.authUsername;
-    config.auth.password = answers.authPassword;
-  }
-  
-  return config;
-}
-
-module.exports = {
-  defaultConfig,
-  notionInspiredPreset,
-  loadConfig,
-  createDefaultConfig
-};