package-installer-cli 1.2.0 → 1.3.0

data/dist/commands/create.js

@@ -3,51 +3,69 @@
  */
 import chalk from 'chalk';
 import path from 'path';
-import gradient from 'gradient-string';
-import boxen from 'boxen';
-import { promptProjectName, promptFrameworkSelection, promptLanguageSelection, promptTemplateSelection, promptFrameworkOptions, promptTemplateConfirmation, promptFeatureSelection, promptFeatureProvider, hasFrameworkOptions, hasUIOptions, hasBundlerOptions, shouldShowTemplates } from '../utils/prompts.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
+import { promptProjectName, promptFrameworkSelection, promptLanguageSelection, promptTemplateSelection, promptFrameworkOptions, promptTemplateConfirmation, promptFeatureSelection, hasFrameworkOptions, hasUIOptions, hasBundlerOptions, shouldShowTemplates } from '../utils/prompts.js';
 import { resolveTemplatePath, generateTemplateName, templateExists, getFrameworkConfig } from '../utils/templateResolver.js';
 import { createProjectFromTemplate, installDependenciesForCreate } from '../utils/templateCreator.js';
-import { updateTemplateUsage, getCachedTemplateFiles, cacheTemplateFiles, getDirectorySize, cacheProjectData } from '../utils/cacheManager.js';
+import { updateTemplateUsage, getCachedTemplateFiles, cacheTemplateFiles, cacheProjectData } from '../utils/cacheManager.js';
 import { CacheManager } from '../utils/cacheUtils.js';
-import { addFeatureToProject } from './add.js';
 /**
  * Display help for create command
  */
 export function showCreateHelp() {
-    const piGradient = gradient(['#00c6ff', '#0072ff']);
-    const headerGradient = gradient(['#4facfe', '#00f2fe']);
-    console.log('\n' + boxen(headerGradient('🚀 Create Command Help') + '\n\n' +
-        chalk.white('Create a new project from our curated collection of modern templates.') + '\n' +
-        chalk.white('Choose from React, Next.js, Express, Nest.js, Rust, and more!') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')} [project-name]`) + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.gray('  -h, --help    Display help for this command') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')} my-awesome-app    # Create with specific name`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')}                   # Interactive mode - will prompt for name`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')} ${chalk.hex('#ff6b6b')('--show-cache')}       # Show cached preferences`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')} ${chalk.hex('#ff6b6b')('--clear-cache')}      # Clear cached preferences`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('create')} ${chalk.hex('#ff6b6b')('--help')}            # Show this help message`) + '\n\n' +
-        chalk.hex('#00d2d3')('💡 Smart Caching:') + '\n' +
-        chalk.hex('#95afc0')('  • Remembers your preferences from previous sessions') + '\n' +
-        chalk.hex('#95afc0')('  • Suggests framework-specific project names') + '\n' +
-        chalk.hex('#95afc0')('  • Shows project count and usage statistics') + '\n\n' +
-        chalk.hex('#00d2d3')('💡 Available Templates:') + '\n' +
-        chalk.hex('#95afc0')('  • React (Vite) - JavaScript/TypeScript variants') + '\n' +
-        chalk.hex('#95afc0')('  • Next.js - App Router with multiple configurations') + '\n' +
-        chalk.hex('#95afc0')('  • Express - RESTful APIs with authentication') + '\n' +
-        chalk.hex('#95afc0')('  • Nest.js - Enterprise-grade Node.js framework') + '\n' +
-        chalk.hex('#95afc0')('  • Angular - Modern Angular applications') + '\n' +
-        chalk.hex('#95afc0')('  • Vue.js - Progressive Vue.js applications') + '\n' +
-        chalk.hex('#95afc0')('  • Rust - Systems programming templates') + '\n' +
-        chalk.hex('#95afc0')('  • Django - Python web framework'), {
-        padding: 1,
-        borderStyle: 'round',
-        borderColor: 'cyan',
-        backgroundColor: '#0a0a0a'
-    }));
+    const helpConfig = {
+        commandName: 'Create',
+        emoji: '🚀',
+        description: 'Create a new project from our curated collection of modern templates.\nChoose from React, Next.js, Express, Nest.js, Rust, and more!',
+        usage: [
+            'create [project-name] [options]',
+            'create [options]'
+        ],
+        options: [
+            { flag: '-h, --help', description: 'Display help for this command' },
+            { flag: '--show-cache', description: 'Show cached preferences' },
+            { flag: '--clear-cache', description: 'Clear cached preferences' }
+        ],
+        examples: [
+            { command: 'create my-awesome-app', description: 'Create with specific name' },
+            { command: 'create', description: 'Interactive mode - will prompt for name' },
+            { command: 'create --show-cache', description: 'Show cached preferences' },
+            { command: 'create --clear-cache', description: 'Clear cached preferences' }
+        ],
+        additionalSections: [
+            {
+                title: 'Smart Caching',
+                items: [
+                    'Remembers your preferences from previous sessions',
+                    'Suggests framework-specific project names',
+                    'Shows project count and usage statistics'
+                ]
+            },
+            {
+                title: 'Available Templates',
+                items: [
+                    'React (Vite) - JavaScript/TypeScript variants',
+                    'Next.js - App Router with multiple configurations',
+                    'Express - RESTful APIs with authentication',
+                    'Nest.js - Enterprise-grade Node.js framework',
+                    'Angular - Modern Angular applications',
+                    'Vue.js - Progressive Vue.js applications',
+                    'Rust - Systems programming templates',
+                    'Django - Python web framework',
+                    'Flask - Lightweight Python web apps',
+                    'Go - Fast and efficient web services',
+                    'React-Native - Mobile apps for iOS and Android',
+                    'Combination Templates - reactjs+express+shadcn,reactjs=nestjs+shadcn'
+                ]
+            }
+        ],
+        tips: [
+            'Use interactive mode for guided project creation',
+            'Templates include best practices and modern tooling',
+            'All templates support both JavaScript and TypeScript'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Main create project function with comprehensive prompt system
@@ -143,12 +161,10 @@ export async function createProject(providedName, options) {
         await installDependenciesForCreate(projectPath);
         // Step 11.5: Cache template usage and project data
         try {
-            await updateTemplateUsage(templateName || selectedFramework, selectedFramework, selectedLanguage, [] // Features will be updated after adding them
-            );
+            await updateTemplateUsage(templateName || selectedFramework, selectedFramework, selectedLanguage);
             const templateFiles = await getCachedTemplateFiles(templateName || selectedFramework);
-            await cacheTemplateFiles(templateName || selectedFramework, templatePath, templateFiles || {}, await getDirectorySize(projectPath));
-            await cacheProjectData(projectPath, projectName, selectedLanguage, selectedFramework, [], // Features will be added next
-            await getDirectorySize(projectPath));
+            await cacheTemplateFiles(templateName || selectedFramework, templatePath, templateFiles || {});
+            await cacheProjectData(projectPath, projectName, selectedLanguage);
         }
         catch (error) {
             console.warn(chalk.yellow('⚠️  Could not cache project data'));
@@ -157,17 +173,22 @@ export async function createProject(providedName, options) {
         const selectedFeatures = await promptFeatureSelection();
         if (selectedFeatures.length > 0) {
             console.log(chalk.hex('#00d2d3')('\n🚀 Adding Features...\n'));
+            // Import the add command dynamically to avoid circular imports
+            const { addCommand } = await import('./add.js');
             for (const category of selectedFeatures) {
-                const provider = await promptFeatureProvider(category, selectedFramework);
-                if (provider) {
-                    console.log(chalk.cyan(`🔧 Adding ${provider} for ${category}...`));
-                    const success = await addFeatureToProject(projectPath, category, provider, selectedFramework);
-                    if (success) {
-                        console.log(chalk.green(`✅ Successfully added ${provider} for ${category}`));
-                    }
-                    else {
-                        console.log(chalk.yellow(`⚠️  Failed to add ${provider} for ${category}, skipping...`));
-                    }
+                try {
+                    console.log(chalk.cyan(`🔧 Adding ${category} feature...`));
+                    // Use the add command directly with the detected framework
+                    await addCommand(category, undefined, {
+                        framework: selectedFramework,
+                        projectPath: projectPath,
+                        list: false,
+                        verbose: false
+                    });
+                    console.log(chalk.green(`✅ Successfully added ${category} feature`));
+                }
+                catch (error) {
+                    console.log(chalk.yellow(`⚠️  Failed to add ${category} feature, skipping...`));
                 }
             }
         }

data/dist/commands/deploy.js

@@ -4,32 +4,40 @@
 import chalk from 'chalk';
 import gradient from 'gradient-string';
 import boxen from 'boxen';
+import { createStandardHelp } from '../utils/helpFormatter.js';
 /**
  * Display help for deploy command
  */
 export function showDeployHelp() {
-    const piGradient = gradient(['#00c6ff', '#0072ff']);
-    const headerGradient = gradient(['#ff9a9e', '#fecfef']);
-    console.log('\n' + boxen(headerGradient('🚀 Deploy Command Help') + '\n\n' +
-        chalk.white('Deploy your projects to various cloud platforms seamlessly.') + '\n' +
-        chalk.white('This feature is currently under development!') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('deploy')}`) + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.gray('  -h, --help    Display help for this command') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('deploy')}              # Deploy current project`) + '\n' +
-        chalk.gray(`  ${piGradient('pi')} ${chalk.hex('#10ac84')('deploy')} ${chalk.hex('#ff6b6b')('--help')}     # Show this help message`) + '\n\n' +
-        chalk.hex('#00d2d3')('🔮 Planned Features:') + '\n' +
-        chalk.hex('#95afc0')('  • Deploy to Vercel, Netlify, AWS') + '\n' +
-        chalk.hex('#95afc0')('  • Docker container deployment') + '\n' +
-        chalk.hex('#95afc0')('  • Environment variable management') + '\n' +
-        chalk.hex('#95afc0')('  • CI/CD pipeline setup'), {
-        padding: 1,
-        borderStyle: 'round',
-        borderColor: 'magenta',
-        backgroundColor: '#0a0a0a'
-    }));
+    const helpConfig = {
+        commandName: 'deploy',
+        emoji: '🚀',
+        description: 'Deploy your projects to various cloud platforms seamlessly.\nThis feature is currently under development!',
+        usage: ['pi deploy'],
+        options: [
+            { flag: '-h, --help', description: 'Display help for this command' }
+        ],
+        examples: [
+            { command: 'pi deploy', description: 'Deploy current project' },
+            { command: 'pi deploy --help', description: 'Show this help message' }
+        ],
+        additionalSections: [
+            {
+                title: '🔮 Planned Features',
+                items: [
+                    '• Deploy to Vercel, Netlify, AWS',
+                    '• Docker container deployment',
+                    '• Environment variable management',
+                    '• CI/CD pipeline setup'
+                ]
+            }
+        ],
+        tips: [
+            'This feature is currently under development - stay tuned!',
+            'Follow the project on GitHub for updates and releases'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Display coming soon animation

data/dist/commands/doctor.js

@@ -9,6 +9,7 @@ import path from 'path';
 import boxen from 'boxen';
 import gradient from 'gradient-string';
 import { displaySuccessMessage, displayErrorMessage } from '../utils/dashboard.js';
+import { createStandardHelp } from '../utils/helpFormatter.js';
 /**
  * Check if command exists
  */
@@ -181,35 +182,33 @@ async function autoFixIssue(issue, projectPath) {
  * Display help for doctor command
  */
 export function showDoctorHelp() {
+    const helpConfig = {
+        commandName: 'doctor',
+        emoji: '🩺',
+        description: 'Diagnose and fix common development issues.\nComprehensive health check for your development environment and project setup.',
+        usage: ['pi doctor [options]', 'pi diagnose [options]  # (alias)'],
+        options: [
+            { flag: '--fix', description: 'Automatically fix detected issues' },
+            { flag: '--node', description: 'Check Node.js and npm setup only' },
+            { flag: '--deps', description: 'Check project dependencies only' },
+            { flag: '--tools', description: 'Check development tools only' },
+            { flag: '--verbose', description: 'Show detailed diagnostic information' },
+            { flag: '-h, --help', description: 'Show this help message' }
+        ],
+        examples: [
+            { command: 'pi doctor', description: 'Complete health check' },
+            { command: 'pi doctor --fix', description: 'Check and auto-fix issues' },
+            { command: 'pi doctor --deps', description: 'Check dependencies only' },
+            { command: 'pi doctor --node --verbose', description: 'Detailed Node.js check' }
+        ],
+        tips: [
+            'Use --fix to automatically resolve common issues',
+            'Run with --verbose for detailed diagnostic information',
+            '\'pi diagnose\' is an alias for \'pi doctor\''
+        ]
+    };
     console.clear();
-    const helpContent = boxen(gradient(['#ff6b6b', '#4ecdc4'])('🩺 Doctor Command Help') + '\n\n' +
-        chalk.white('Diagnose and fix common development issues') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white('  pi doctor [options]') + '\n' +
-        chalk.white('  pi diagnose [options]') + chalk.gray(' (alias)') + '\n\n' +
-        chalk.cyan('Description:') + '\n' +
-        chalk.white('  Comprehensive health check for your development environment') + '\n' +
-        chalk.white('  and project setup. Detects and fixes common issues.') + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.white('  --fix') + chalk.gray('          Automatically fix detected issues') + '\n' +
-        chalk.white('  --node') + chalk.gray('         Check Node.js and npm setup only') + '\n' +
-        chalk.white('  --deps') + chalk.gray('         Check project dependencies only') + '\n' +
-        chalk.white('  --tools') + chalk.gray('        Check development tools only') + '\n' +
-        chalk.white('  --verbose') + chalk.gray('      Show detailed diagnostic information') + '\n' +
-        chalk.white('  -h, --help') + chalk.gray('     Show this help message') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.gray('  # Complete health check') + '\n' +
-        chalk.white('  pi doctor') + '\n\n' +
-        chalk.gray('  # Check and auto-fix issues') + '\n' +
-        chalk.white('  pi doctor --fix') + '\n\n' +
-        chalk.gray('  # Check dependencies only') + '\n' +
-        chalk.white('  pi doctor --deps'), {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'green'
-    });
-    console.log(helpContent);
+    createStandardHelp(helpConfig);
 }
 /**
  * Main doctor command function

data/dist/commands/env.js

@@ -9,6 +9,7 @@ import path from 'path';
 import boxen from 'boxen';
 import gradient from 'gradient-string';
 import inquirer from 'inquirer';
+import { createStandardHelp } from '../utils/helpFormatter.js';
 import { displaySuccessMessage, displayErrorMessage } from '../utils/dashboard.js';
 import { detectProjectStack } from '../utils/featureInstaller.js';
 /**
@@ -208,37 +209,49 @@ async function validateEnvFile(projectPath) {
  * Display help for environment command
  */
 export function showEnvironmentHelp() {
-    console.clear();
-    const helpContent = boxen(gradient(['#ff6b6b', '#feca57'])('🌍 Environment Command Help') + '\n\n' +
-        chalk.white('Analyze and manage your development environment') + '\n\n' +
-        chalk.cyan('Usage:') + '\n' +
-        chalk.white('  pi env [options]') + '\n' +
-        chalk.white('  pi environment [options]') + chalk.gray(' (alias)') + '\n\n' +
-        chalk.cyan('Description:') + '\n' +
-        chalk.white('  Comprehensive environment analysis and management tools') + '\n' +
-        chalk.white('  for development setup and configuration') + '\n\n' +
-        chalk.cyan('Options:') + '\n' +
-        chalk.white('  --check') + chalk.gray('        Check development tools and versions') + '\n' +
-        chalk.white('  --generate') + chalk.gray('     Generate .env template for project') + '\n' +
-        chalk.white('  --validate') + chalk.gray('     Validate existing .env file') + '\n' +
-        chalk.white('  --export') + chalk.gray('      Export environment info to file') + '\n' +
-        chalk.white('  --system') + chalk.gray('      Show system information only') + '\n' +
-        chalk.white('  -h, --help') + chalk.gray('     Show this help message') + '\n\n' +
-        chalk.cyan('Examples:') + '\n' +
-        chalk.gray('  # Interactive environment analysis') + '\n' +
-        chalk.white('  pi env') + '\n\n' +
-        chalk.gray('  # Check development tools') + '\n' +
-        chalk.white('  pi env --check') + '\n\n' +
-        chalk.gray('  # Generate .env template') + '\n' +
-        chalk.white('  pi env --generate') + '\n\n' +
-        chalk.gray('  # Validate .env file') + '\n' +
-        chalk.white('  pi env --validate'), {
-        padding: 1,
-        margin: 1,
-        borderStyle: 'round',
-        borderColor: 'yellow'
-    });
-    console.log(helpContent);
+    const helpConfig = {
+        commandName: 'Environment',
+        emoji: '🌍',
+        description: 'Analyze and manage your development environment.\nComprehensive environment analysis and management tools for development setup and configuration.',
+        usage: [
+            'env [options]',
+            'environment [options]   # alias'
+        ],
+        options: [
+            { flag: '--check', description: 'Check development tools and versions' },
+            { flag: '--generate', description: 'Generate .env template for project' },
+            { flag: '--validate', description: 'Validate existing .env file' },
+            { flag: '--export', description: 'Export environment info to file' },
+            { flag: '--system', description: 'Show system information only' },
+            { flag: '-h, --help', description: 'Show this help message' }
+        ],
+        examples: [
+            { command: 'env', description: 'Interactive environment analysis' },
+            { command: 'env --check', description: 'Check development tools' },
+            { command: 'env --generate', description: 'Generate .env template' },
+            { command: 'env --validate', description: 'Validate .env file' },
+            { command: 'env --system', description: 'Show system information only' },
+            { command: 'environment --export', description: 'Export environment info to file' }
+        ],
+        additionalSections: [
+            {
+                title: 'Features',
+                items: [
+                    'Development tools version checking',
+                    'Environment file generation and validation',
+                    'System information analysis',
+                    'Configuration management',
+                    'Project environment setup'
+                ]
+            }
+        ],
+        tips: [
+            'Use --generate to create .env templates for your projects',
+            'Regular environment checks help maintain development consistency',
+            'Validate .env files to catch configuration issues early'
+        ]
+    };
+    createStandardHelp(helpConfig);
 }
 /**
  * Main environment command function