create-nexo 1.0.0

package/dist/core/setup.js

@@ -0,0 +1,96 @@
+import path from 'node:path';
+import { authConfigurator, cicdConfigurator, dataFetchingConfigurator, formsConfigurator, frameworkConfigurator, i18nConfigurator, iconsConfigurator, languageConfigurator, mandatoryConfigurator, routingConfigurator, stateConfigurator, structureConfigurator, stylingConfigurator, uiConfigurator, variantConfigurator, } from '../configurators/index.js';
+import { createEntryFiles, createReadme, createStyles } from '../templates/index.js';
+import { createProjectDir, spinner } from '../utils/index.js';
+import { executeParallel } from './parallel.js';
+/**
+ * Create steps with dependency information for parallel execution
+ */
+const createSteps = ({ ctx, cicd = false }) => [
+    // Phase 1: Project setup (sequential)
+    { name: 'Creating project directory', fn: () => createProjectDir(ctx) },
+    { name: 'Setting up framework', fn: () => frameworkConfigurator(ctx), dependencies: ['Creating project directory'] },
+    { name: 'Configuring build variant', fn: () => variantConfigurator(ctx), dependencies: ['Setting up framework'] },
+    { name: 'Setting up language', fn: () => languageConfigurator(ctx), dependencies: ['Configuring build variant'] },
+    // Phase 2: Independent configurators (can run in parallel)
+    { name: 'Configuring styling', fn: () => stylingConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Setting up forms', fn: () => formsConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Configuring state management', fn: () => stateConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Setting up routing', fn: () => routingConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Configuring data fetching', fn: () => dataFetchingConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Adding icon library', fn: () => iconsConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Creating project structure', fn: () => structureConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Setting up internationalization', fn: () => i18nConfigurator(ctx), dependencies: ['Setting up language'] },
+    { name: 'Configuring authentication', fn: () => authConfigurator(ctx), dependencies: ['Setting up language'] },
+    // Phase 3: UI (depends on styling for Tailwind check)
+    { name: 'Adding UI library', fn: () => uiConfigurator(ctx), dependencies: ['Configuring styling'] },
+    // Phase 4: Finalization
+    {
+        name: 'Adding mandatory features',
+        fn: () => mandatoryConfigurator(ctx),
+        dependencies: [
+            'Configuring styling', 'Setting up forms', 'Configuring state management',
+            'Setting up routing', 'Configuring data fetching', 'Adding icon library',
+            'Creating project structure', 'Setting up internationalization', 'Configuring authentication'
+        ]
+    },
+    {
+        name: 'Creating entry files',
+        fn: () => createEntryFiles(ctx),
+        dependencies: ['Adding mandatory features', 'Adding UI library']
+    },
+    {
+        name: 'Creating styles',
+        fn: () => createStyles(ctx),
+        dependencies: ['Adding mandatory features']
+    },
+    {
+        name: 'Generating documentation',
+        fn: () => createReadme(ctx),
+        dependencies: ['Creating entry files', 'Creating styles']
+    },
+    // Optional: CI/CD configuration
+    ...(cicd ? [{
+            name: 'Setting up CI/CD',
+            fn: () => cicdConfigurator(ctx),
+            dependencies: ['Generating documentation']
+        }] : []),
+];
+/**
+ * Execute setup with sequential spinner display
+ */
+const executeSequential = async (steps) => {
+    for (const step of steps) {
+        const s = spinner(step.name);
+        try {
+            await step.fn();
+            s.succeed();
+        }
+        catch (error) {
+            s.fail();
+            throw error;
+        }
+    }
+};
+/**
+ * Main setup function
+ */
+export const setup = async ({ selections, targetDir, parallel = false, cicd = false }) => {
+    const projectPath = path.resolve(targetDir, selections.projectName);
+    const ctx = {
+        projectPath,
+        selections,
+    };
+    const steps = createSteps({ ctx, cicd });
+    if (parallel) {
+        // Use parallel execution for better performance
+        await executeParallel(steps, { verbose: true, maxConcurrency: 4 });
+    }
+    else {
+        // Use sequential execution with spinner (default for better UX)
+        await executeSequential(steps);
+    }
+};
+// Export for testing
+export { createSteps, executeSequential };
+//# sourceMappingURL=setup.js.map

package/dist/core/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/core/setup.ts"],"names":[],"mappings":"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"}

package/dist/core/wizard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * NEXO CLI - Wizard Mode
+ *
+ * A simplified, guided mode for beginners that automatically
+ * recommends configurations based on project type.
+ */
+import type { UserSelections } from '../types/index.js';
+export type ProjectType = 'webapp' | 'dashboard' | 'landing' | 'api-client' | 'portfolio' | 'ecommerce';
+export interface WizardResult {
+    projectName: string;
+    projectType: ProjectType;
+    selections: UserSelections;
+    useRecommended: boolean;
+}
+export interface ProjectTypeConfig {
+    name: string;
+    description: string;
+    icon: string;
+    recommendations: Partial<UserSelections>;
+    features: string[];
+}
+export declare const projectTypes: Record<ProjectType, ProjectTypeConfig>;
+/**
+ * Run the wizard mode
+ */
+export declare const runWizard: () => Promise<WizardResult | null>;
+/**
+ * Get recommendations for a project type
+ */
+export declare const getRecommendationsFor: (type: ProjectType) => ProjectTypeConfig;
+/**
+ * Get all project types
+ */
+export declare const getProjectTypes: () => Array<{
+    value: ProjectType;
+    config: ProjectTypeConfig;
+}>;
+export default runWizard;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/core/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/core/wizard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,cAAc,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CAmJ/D,CAAC;AAaF;;GAEG;AACH,eAAO,MAAM,SAAS,QAAa,OAAO,CAAC,YAAY,GAAG,IAAI,CAmF7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,MAAM,WAAW,KAAG,iBAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,QAAO,KAAK,CAAC;IAAE,KAAK,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAKzF,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/core/wizard.js

@@ -0,0 +1,259 @@
+/**
+ * NEXO CLI - Wizard Mode
+ *
+ * A simplified, guided mode for beginners that automatically
+ * recommends configurations based on project type.
+ */
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+// ============================================
+// Project Type Configurations
+// ============================================
+export const projectTypes = {
+    webapp: {
+        name: 'Web Application',
+        description: 'Interactive web application with forms and state',
+        icon: '🌐',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'shadcn',
+            forms: 'rhf-zod',
+            state: 'zustand',
+            routing: 'react-router',
+            dataFetching: 'tanstack-query',
+            icons: 'lucide',
+            structure: 'feature-based',
+        },
+        features: [
+            'TypeScript for type safety',
+            'Tailwind CSS + shadcn/ui',
+            'Form handling with validation',
+            'State management',
+            'Client-side routing',
+            'Data fetching with caching',
+        ],
+    },
+    dashboard: {
+        name: 'Admin Dashboard',
+        description: 'Data-rich admin panel with charts and tables',
+        icon: '📊',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'shadcn',
+            forms: 'rhf-zod',
+            state: 'redux',
+            routing: 'react-router',
+            dataFetching: 'tanstack-query',
+            icons: 'lucide',
+            structure: 'fsd',
+        },
+        features: [
+            'TypeScript for type safety',
+            'Tailwind CSS + shadcn/ui',
+            'Redux for complex state',
+            'FSD architecture',
+            'Data fetching with caching',
+            'Ready for charts integration',
+        ],
+    },
+    landing: {
+        name: 'Landing Page',
+        description: 'Fast, SEO-optimized marketing page',
+        icon: '🚀',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'none',
+            forms: 'none',
+            state: 'none',
+            routing: 'none',
+            dataFetching: 'none',
+            icons: 'lucide',
+            structure: 'simple',
+        },
+        features: [
+            'TypeScript for type safety',
+            'Tailwind CSS for styling',
+            'Minimal dependencies',
+            'Fast load times',
+            'Simple structure',
+            'Easy to customize',
+        ],
+    },
+    'api-client': {
+        name: 'API Client',
+        description: 'Application consuming external APIs',
+        icon: '🔌',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'mantine',
+            forms: 'rhf-zod',
+            state: 'zustand',
+            routing: 'react-router',
+            dataFetching: 'tanstack-query',
+            icons: 'lucide',
+            structure: 'feature-based',
+        },
+        features: [
+            'TypeScript for type safety',
+            'TanStack Query for API calls',
+            'Zustand for client state',
+            'Mantine UI components',
+            'Form handling',
+            'Feature-based structure',
+        ],
+    },
+    portfolio: {
+        name: 'Portfolio Website',
+        description: 'Personal portfolio or showcase site',
+        icon: '👤',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'none',
+            forms: 'none',
+            state: 'none',
+            routing: 'react-router',
+            dataFetching: 'none',
+            icons: 'lucide',
+            structure: 'simple',
+        },
+        features: [
+            'TypeScript for type safety',
+            'Tailwind CSS for styling',
+            'Client-side routing',
+            'Lucide icons',
+            'Simple structure',
+            'Easy to personalize',
+        ],
+    },
+    ecommerce: {
+        name: 'E-Commerce',
+        description: 'Online store with cart and checkout',
+        icon: '🛒',
+        recommendations: {
+            variant: 'ts',
+            styling: 'tailwind',
+            ui: 'shadcn',
+            forms: 'rhf-zod',
+            state: 'zustand',
+            routing: 'tanstack-router',
+            dataFetching: 'tanstack-query',
+            icons: 'lucide',
+            structure: 'fsd',
+            auth: 'jwt',
+        },
+        features: [
+            'TypeScript for type safety',
+            'Tailwind CSS + shadcn/ui',
+            'Zustand for cart state',
+            'TanStack Router (type-safe)',
+            'TanStack Query for products',
+            'JWT authentication ready',
+            'FSD architecture',
+        ],
+    },
+};
+// ============================================
+// Wizard Functions
+// ============================================
+/**
+ * Format features list for display
+ */
+const formatFeatures = (features) => {
+    return features.map(f => `  ${pc.green('✓')} ${f}`).join('\n');
+};
+/**
+ * Run the wizard mode
+ */
+export const runWizard = async () => {
+    console.log(pc.cyan('\n🧙 Welcome to NEXO Wizard!\n'));
+    console.log(pc.dim('Let me help you set up your project.\n'));
+    // Step 1: Project name
+    const projectName = await p.text({
+        message: 'What is your project name?',
+        placeholder: 'my-awesome-app',
+        defaultValue: 'my-app',
+        validate: (value) => {
+            const v = value || 'my-app';
+            if (!/^[a-z0-9-_]+$/i.test(v)) {
+                return 'Project name can only contain letters, numbers, hyphens, and underscores';
+            }
+            return undefined;
+        },
+    });
+    if (p.isCancel(projectName)) {
+        p.cancel('Wizard cancelled.');
+        return null;
+    }
+    // Step 2: Project type
+    const projectType = await p.select({
+        message: 'What are you building?',
+        options: Object.entries(projectTypes).map(([value, config]) => ({
+            value: value,
+            label: `${config.icon} ${config.name}`,
+            hint: config.description,
+        })),
+    });
+    if (p.isCancel(projectType)) {
+        p.cancel('Wizard cancelled.');
+        return null;
+    }
+    const selectedType = projectTypes[projectType];
+    // Step 3: Show recommendations
+    console.log();
+    p.note(`${pc.bold('Recommended stack for ' + selectedType.name + ':')}\n\n${formatFeatures(selectedType.features)}`, '📦 Configuration');
+    // Step 4: Confirm or customize
+    const useRecommended = await p.confirm({
+        message: 'Use these recommended settings?',
+        initialValue: true,
+    });
+    if (p.isCancel(useRecommended)) {
+        p.cancel('Wizard cancelled.');
+        return null;
+    }
+    // Build selections
+    const recommendations = selectedType.recommendations;
+    const selections = {
+        projectName: projectName,
+        framework: 'react',
+        variant: recommendations.variant || 'ts',
+        language: (recommendations.variant || 'ts').startsWith('ts') ? 'typescript' : 'javascript',
+        styling: recommendations.styling || 'tailwind',
+        ui: recommendations.ui || 'none',
+        forms: recommendations.forms || 'none',
+        state: recommendations.state || 'none',
+        routing: recommendations.routing || 'none',
+        dataFetching: recommendations.dataFetching || 'none',
+        icons: recommendations.icons || 'none',
+        structure: recommendations.structure || 'simple',
+        i18n: recommendations.i18n || 'none',
+        auth: recommendations.auth || 'none',
+    };
+    return {
+        projectName: projectName,
+        projectType: projectType,
+        selections,
+        useRecommended: useRecommended,
+    };
+};
+/**
+ * Get recommendations for a project type
+ */
+export const getRecommendationsFor = (type) => {
+    return projectTypes[type];
+};
+/**
+ * Get all project types
+ */
+export const getProjectTypes = () => {
+    return Object.entries(projectTypes).map(([value, config]) => ({
+        value: value,
+        config,
+    }));
+};
+export default runWizard;
+//# sourceMappingURL=wizard.js.map

package/dist/core/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/core/wizard.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Base error class for all NEXO errors
+ */
+export declare class NexoError extends Error {
+    code: string;
+    context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+}
+/**
+ * Validation errors - invalid user input or selections
+ */
+export declare class ValidationError extends NexoError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * File system errors - file operations failed
+ */
+export declare class FileSystemError extends NexoError {
+    constructor(message: string, filePath: string, originalError?: Error);
+}
+/**
+ * Configurator errors - configuration step failed
+ */
+export declare class ConfiguratorError extends NexoError {
+    constructor(configuratorName: string, message: string, originalError?: Error);
+}
+/**
+ * Dependency errors - package installation/resolution failed
+ */
+export declare class DependencyError extends NexoError {
+    constructor(dependency: string, message: string);
+}
+/**
+ * Compatibility errors - incompatible selections
+ */
+export declare class CompatibilityError extends NexoError {
+    constructor(message: string, selections: Record<string, string>);
+}
+/**
+ * Security errors - security violation detected
+ */
+export declare class SecurityError extends NexoError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Format and display an error with helpful information
+ */
+export declare const formatError: (error: unknown, context?: Record<string, unknown>) => void;
+/**
+ * Global error handler - use at CLI entry point
+ */
+export declare const handleError: (error: unknown, context?: Record<string, unknown>) => never;
+/**
+ * Wrap an async function with error handling
+ */
+export declare const withErrorHandling: <T extends unknown[], R>(fn: (...args: T) => Promise<R>, errorContext?: Record<string, unknown>) => (...args: T) => Promise<R>;
+/**
+ * Try to execute a function and return a result object
+ */
+export interface Result<T> {
+    success: boolean;
+    data?: T;
+    error?: NexoError;
+}
+export declare const tryExecute: <T>(fn: () => Promise<T>, errorClass?: new (message: string, ...args: unknown[]) => NexoError, ...errorArgs: unknown[]) => Promise<Result<T>>;
+export * from './messages.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAGzB,IAAI,EAAE,MAAM;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFxC,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAM3C;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAOrE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;gBAClC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK;CAO7E;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIhD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,SAAS;gBACnC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAIhE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAoFD;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAyE/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,KAG/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,eAAe,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAExB,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,CAAC,CAQrC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,eAAO,MAAM,UAAU,GAAU,CAAC,EAChC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,aAAY,KAAK,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,SAA+E,EACxI,GAAG,WAAW,OAAO,EAAE,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAWnB,CAAC;AAGF,cAAc,eAAe,CAAC"}