create-react-forge 1.0.0

package/README.md

@@ -0,0 +1,109 @@
+# react-scaffold
+
+Production-ready React CLI scaffolder with first-class testing support, flexible runtimes (Vite/Next.js), and a composable template system based on [bulletproof-react](https://github.com/alan2207/bulletproof-react) architecture.
+
+## Features
+
+- 🚀 **Vite & Next.js Support** — Choose your runtime
+- 🧪 **Testing as First-Class Citizen** — Vitest, Jest, React Testing Library, Playwright, Cypress
+- 🎨 **Flexible Styling** — Tailwind CSS, CSS Modules, or plain CSS
+- 📦 **State Management** — Zustand or Redux Toolkit
+- 🔄 **Data Fetching** — TanStack Query with DevTools
+- 📁 **Feature-Based Architecture** — Scalable project structure
+- ⚡ **Zero Config** — Smart defaults, minimal prompts
+
+## Quick Start
+
+```bash
+npx create-react-forge
+```
+
+Or install globally:
+
+```bash
+npm install -g create-react-forge
+create-react-forge
+```
+
+## What You Get
+
+A production-ready React project with:
+
+```
+my-app/
+├── src/
+│   ├── app/              # App setup (providers, router)
+│   ├── components/       # Shared UI components
+│   ├── features/         # Feature-based modules
+│   ├── hooks/            # Custom hooks
+│   ├── lib/              # Utilities, API client
+│   ├── stores/           # State management
+│   ├── testing/          # Test utilities, mocks
+│   └── types/            # TypeScript types
+├── tests/                # E2E tests
+└── [config files]
+```
+
+## Configuration Options
+
+| Option | Choices |
+|--------|---------|
+| **Runtime** | Vite, Next.js |
+| **Language** | TypeScript, JavaScript |
+| **Styling** | Tailwind, CSS Modules, CSS |
+| **State** | Zustand, Redux, None |
+| **Data Fetching** | TanStack Query, None |
+| **Unit Testing** | Vitest, Jest |
+| **E2E Testing** | Playwright, Cypress, None |
+| **Package Manager** | npm, yarn, pnpm |
+
+## Architecture
+
+This project implements a modular, layered CLI architecture. Generated projects follow the [bulletproof-react](https://github.com/alan2207/bulletproof-react) patterns:
+
+- Feature-based folder structure
+- Co-located tests with features
+- Centralized API client
+- Type-safe throughout
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed design documentation.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run CLI in dev mode
+npm run dev
+
+# Run tests
+npm run test
+npm run test:watch
+
+# Build for production
+npm run build
+```
+
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+### Quick Contribution Steps
+
+1. Fork the repository
+2. Create a feature branch: `git checkout -b feature/amazing-feature`
+3. Make your changes
+4. Run tests: `npm run test`
+5. Submit a pull request
+
+## Related Projects
+
+- [bulletproof-react](https://github.com/alan2207/bulletproof-react) — Architecture reference
+- [Vite](https://vitejs.dev/) — Build tool
+- [Next.js](https://nextjs.org/) — React framework
+- [TanStack Query](https://tanstack.com/query) — Data fetching
+
+## License
+
+MIT

package/dist/assembler/index.d.ts

@@ -0,0 +1,100 @@
+import type { ProjectConfig } from '../config/schema.js';
+/**
+ * Manages assembly of generated project files
+ */
+export declare class ProjectAssembler {
+    private projectPath;
+    private config;
+    private fileMap;
+    private packageJson;
+    constructor(projectPath: string, config: ProjectConfig);
+    /**
+     * Create base package.json structure
+     */
+    private createBasePackageJson;
+    /**
+     * Add a file to the project
+     */
+    addFile(filePath: string, content: string): void;
+    /**
+     * Add multiple files from a Map
+     */
+    addFiles(files: Map<string, string>): void;
+    /**
+     * Get all registered files
+     */
+    getFiles(): Map<string, string>;
+    /**
+     * Add dependencies to package.json
+     */
+    addDependencies(deps: Record<string, string>): void;
+    /**
+     * Add dev dependencies to package.json
+     */
+    addDevDependencies(devDeps: Record<string, string>): void;
+    /**
+     * Add scripts to package.json
+     */
+    addScripts(scripts: Record<string, string>): void;
+    /**
+     * Merge template dependencies and scripts
+     */
+    mergeTemplateDeps(data: {
+        dependencies: Record<string, string>;
+        devDependencies: Record<string, string>;
+        scripts: Record<string, string>;
+    }): void;
+    /**
+     * Set package.json content
+     */
+    setPackageJson(pkg: PackageJson): void;
+    /**
+     * Get package.json
+     */
+    getPackageJson(): PackageJson;
+    /**
+     * Sort dependencies alphabetically
+     */
+    private sortDependencies;
+    /**
+     * Finalize package.json with sorted dependencies
+     */
+    private finalizePackageJson;
+    /**
+     * Create project directory
+     */
+    createProjectDirectory(): void;
+    /**
+     * Write a single file to disk
+     */
+    private writeFile;
+    /**
+     * Write all files to disk
+     */
+    writeFiles(): {
+        filesWritten: number;
+        errors: string[];
+    };
+    /**
+     * Get configuration
+     */
+    getConfig(): ProjectConfig;
+    /**
+     * Get project path
+     */
+    getProjectPath(): string;
+}
+/**
+ * Package.json structure
+ */
+export interface PackageJson {
+    name: string;
+    version: string;
+    private?: boolean;
+    type?: string;
+    scripts?: Record<string, string>;
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assembler/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAyBzD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAc;gBAErB,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa;IAMtD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAMhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAM1C;;OAEG;IACH,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI/B;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOnD;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOzD;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOjD;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACjC,GAAG,IAAI;IAMR;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAItC;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,sBAAsB,IAAI,IAAI;IAM9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,UAAU,IAAI;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA4BxD;;OAEG;IACH,SAAS,IAAI,aAAa;IAI1B;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/assembler/index.js

@@ -0,0 +1,198 @@
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+/**
+ * Template variable substitution patterns
+ */
+const TEMPLATE_VARIABLES = {
+    '{{PROJECT_NAME}}': (config) => config.name,
+    '{{PROJECT_DESCRIPTION}}': () => 'A production-ready React application',
+    '{{AUTHOR}}': () => '',
+    '{{LICENSE}}': () => 'MIT',
+};
+/**
+ * Apply template variable substitution to content
+ */
+function applyTemplateVariables(content, config) {
+    let result = content;
+    for (const [pattern, getValue] of Object.entries(TEMPLATE_VARIABLES)) {
+        result = result.replaceAll(pattern, getValue(config));
+    }
+    return result;
+}
+/**
+ * Manages assembly of generated project files
+ */
+export class ProjectAssembler {
+    constructor(projectPath, config) {
+        this.fileMap = new Map();
+        this.projectPath = projectPath;
+        this.config = config;
+        this.packageJson = this.createBasePackageJson();
+    }
+    /**
+     * Create base package.json structure
+     */
+    createBasePackageJson() {
+        return {
+            name: this.config.name,
+            version: '0.1.0',
+            private: true,
+            type: 'module',
+            scripts: {},
+            dependencies: {},
+            devDependencies: {},
+        };
+    }
+    /**
+     * Add a file to the project
+     */
+    addFile(filePath, content) {
+        // Apply template variable substitution
+        const processedContent = applyTemplateVariables(content, this.config);
+        this.fileMap.set(filePath, processedContent);
+    }
+    /**
+     * Add multiple files from a Map
+     */
+    addFiles(files) {
+        files.forEach((content, path) => {
+            this.addFile(path, content);
+        });
+    }
+    /**
+     * Get all registered files
+     */
+    getFiles() {
+        return new Map(this.fileMap);
+    }
+    /**
+     * Add dependencies to package.json
+     */
+    addDependencies(deps) {
+        this.packageJson.dependencies = {
+            ...this.packageJson.dependencies,
+            ...deps,
+        };
+    }
+    /**
+     * Add dev dependencies to package.json
+     */
+    addDevDependencies(devDeps) {
+        this.packageJson.devDependencies = {
+            ...this.packageJson.devDependencies,
+            ...devDeps,
+        };
+    }
+    /**
+     * Add scripts to package.json
+     */
+    addScripts(scripts) {
+        this.packageJson.scripts = {
+            ...this.packageJson.scripts,
+            ...scripts,
+        };
+    }
+    /**
+     * Merge template dependencies and scripts
+     */
+    mergeTemplateDeps(data) {
+        this.addDependencies(data.dependencies);
+        this.addDevDependencies(data.devDependencies);
+        this.addScripts(data.scripts);
+    }
+    /**
+     * Set package.json content
+     */
+    setPackageJson(pkg) {
+        this.packageJson = { ...pkg };
+    }
+    /**
+     * Get package.json
+     */
+    getPackageJson() {
+        return this.packageJson;
+    }
+    /**
+     * Sort dependencies alphabetically
+     */
+    sortDependencies(deps) {
+        return Object.fromEntries(Object.entries(deps).sort(([a], [b]) => a.localeCompare(b)));
+    }
+    /**
+     * Finalize package.json with sorted dependencies
+     */
+    finalizePackageJson() {
+        return {
+            ...this.packageJson,
+            dependencies: this.sortDependencies(this.packageJson.dependencies || {}),
+            devDependencies: this.sortDependencies(this.packageJson.devDependencies || {}),
+        };
+    }
+    /**
+     * Create project directory
+     */
+    createProjectDirectory() {
+        if (!existsSync(this.projectPath)) {
+            mkdirSync(this.projectPath, { recursive: true });
+        }
+    }
+    /**
+     * Write a single file to disk
+     */
+    writeFile(relativePath, content) {
+        const fullPath = join(this.projectPath, relativePath);
+        const dir = dirname(fullPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Handle binary files (marked with __BINARY__:)
+        if (content.startsWith('__BINARY__:')) {
+            const sourcePath = content.replace('__BINARY__:', '');
+            copyFileSync(sourcePath, fullPath);
+        }
+        else {
+            writeFileSync(fullPath, content, 'utf-8');
+        }
+    }
+    /**
+     * Write all files to disk
+     */
+    writeFiles() {
+        const errors = [];
+        let filesWritten = 0;
+        this.createProjectDirectory();
+        for (const [filePath, content] of this.fileMap.entries()) {
+            try {
+                this.writeFile(filePath, content);
+                filesWritten++;
+            }
+            catch (error) {
+                errors.push(`Failed to write ${filePath}: ${error}`);
+            }
+        }
+        // Write package.json
+        try {
+            const pkgPath = join(this.projectPath, 'package.json');
+            const finalPkg = this.finalizePackageJson();
+            writeFileSync(pkgPath, JSON.stringify(finalPkg, null, 2) + '\n', 'utf-8');
+            filesWritten++;
+        }
+        catch (error) {
+            errors.push(`Failed to write package.json: ${error}`);
+        }
+        return { filesWritten, errors };
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Get project path
+     */
+    getProjectPath() {
+        return this.projectPath;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/assembler/index.js.map

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

package/dist/assembler/merger.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Merges configuration objects with smart strategies
+ */
+export declare class ConfigMerger {
+    /**
+     * Deep merge objects with array concatenation
+     */
+    static merge(...objects: Record<string, unknown>[]): Record<string, unknown>;
+    /**
+     * Merge package.json files intelligently
+     */
+    static mergePackageJson(...packages: Record<string, unknown>[]): Record<string, unknown>;
+}
+//# sourceMappingURL=merger.d.ts.map

package/dist/assembler/merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.d.ts","sourceRoot":"","sources":["../../src/assembler/merger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAM5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CA8CzF"}

package/dist/assembler/merger.js

@@ -0,0 +1,58 @@
+import deepmerge from 'deepmerge';
+/**
+ * Merges configuration objects with smart strategies
+ */
+export class ConfigMerger {
+    /**
+     * Deep merge objects with array concatenation
+     */
+    static merge(...objects) {
+        return deepmerge.all(objects, {
+            arrayMerge: (target, source) => [...target, ...source],
+        });
+    }
+    /**
+     * Merge package.json files intelligently
+     */
+    static mergePackageJson(...packages) {
+        const merged = {};
+        for (const pkg of packages) {
+            // Regular merge for most fields
+            for (const [key, value] of Object.entries(pkg)) {
+                if (key === 'scripts') {
+                    // Merge scripts by combining them
+                    if (!merged.scripts) {
+                        merged.scripts = {};
+                    }
+                    Object.assign(merged.scripts, value);
+                }
+                else if (key === 'dependencies' ||
+                    key === 'devDependencies' ||
+                    key === 'peerDependencies') {
+                    // Merge dependencies, later versions win
+                    if (!merged[key]) {
+                        merged[key] = {};
+                    }
+                    Object.assign(merged[key], value);
+                }
+                else if (Array.isArray(value)) {
+                    // Deduplicate arrays
+                    if (!merged[key]) {
+                        merged[key] = [];
+                    }
+                    merged[key] = Array.from(new Set([...merged[key], ...value]));
+                }
+                else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+                    // Deep merge objects
+                    merged[key] = this.merge(merged[key], value);
+                }
+                else {
+                    // Primitive: later value wins
+                    merged[key] = value;
+                }
+            }
+        }
+        return merged;
+    }
+}
+//# sourceMappingURL=merger.js.map

package/dist/assembler/merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merger.js","sourceRoot":"","sources":["../../src/assembler/merger.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,WAAW,CAAC;AAElC;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,OAAkC;QAChD,OAAO,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE;YAC5B,UAAU,EAAE,CAAC,MAAiB,EAAE,MAAiB,EAAE,EAAE,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;SAC7E,CAA4B,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,QAAmC;QAC5D,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,gCAAgC;YAChC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,kCAAkC;oBAClC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBACpB,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC;oBACtB,CAAC;oBACD,MAAM,CAAC,MAAM,CACX,MAAM,CAAC,OAAkC,EACzC,KAAgC,CACjC,CAAC;gBACJ,CAAC;qBAAM,IACL,GAAG,KAAK,cAAc;oBACtB,GAAG,KAAK,iBAAiB;oBACzB,GAAG,KAAK,kBAAkB,EAC1B,CAAC;oBACD,yCAAyC;oBACzC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;wBACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACnB,CAAC;oBACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAA4B,EAAE,KAAgC,CAAC,CAAC;gBAC1F,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChC,qBAAqB;oBACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;wBACjB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBACnB,CAAC;oBACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAI,MAAM,CAAC,GAAG,CAAe,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBAC/E,CAAC;qBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChF,qBAAqB;oBACrB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CACtB,MAAM,CAAC,GAAG,CAA4B,EACtC,KAAgC,CACjC,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,8BAA8B;oBAC9B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/cli/index.d.ts

@@ -0,0 +1,57 @@
+import type { PromptAnswers } from './prompts.js';
+/**
+ * Convert prompt answers to ProjectConfig
+ */
+export declare function promptAnswersToConfig(answers: PromptAnswers): {
+    path: string;
+    name: string;
+    runtime: "vite" | "nextjs";
+    language: "javascript" | "typescript";
+    styling: {
+        solution: "css" | "tailwind" | "styled-components" | "css-modules";
+    };
+    stateManagement: "none" | "redux" | "zustand";
+    dataFetching: {
+        enabled: boolean;
+        library: "tanstack-query";
+    };
+    testing: {
+        enabled: boolean;
+        unit: {
+            enabled: boolean;
+            runner: "vitest" | "jest";
+        };
+        component: {
+            enabled: boolean;
+            library: "testing-library";
+        };
+        e2e: {
+            enabled: boolean;
+            runner: "none" | "playwright" | "cypress";
+        };
+    };
+    linting: {
+        prettier: boolean;
+    };
+    packageManager: "npm" | "yarn" | "pnpm";
+    git: {
+        init: boolean;
+        initialCommit: boolean;
+    };
+    plugins: {
+        name: string;
+        config?: unknown;
+    }[];
+};
+/**
+ * Validate user input
+ */
+export declare function validateProjectName(name: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Main CLI entry point
+ */
+export declare function main(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAQpF;AAuBD;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA2C1C"}

package/dist/cli/index.js

@@ -0,0 +1,110 @@
+import chalk from 'chalk';
+import { resolve } from 'path';
+import { ConfigBuilder } from '../config/builder.js';
+import { generateProject } from '../generator/index.js';
+import { promptForProjectDetails } from './prompts.js';
+/**
+ * Convert prompt answers to ProjectConfig
+ */
+export function promptAnswersToConfig(answers) {
+    const builder = new ConfigBuilder();
+    // Resolve project path to absolute path
+    const projectPath = resolve(process.cwd(), answers.projectPath);
+    builder
+        .setName(answers.projectName)
+        .setPath(projectPath)
+        .setRuntime(answers.runtime)
+        .setLanguage(answers.language)
+        .setStyling(answers.styling)
+        .setStateManagement(answers.stateManagement)
+        .setPackageManager(answers.packageManager)
+        .setGitInit(answers.git)
+        .setDataFetchingEnabled(answers.dataFetching);
+    if (answers.testing !== 'none') {
+        builder
+            .setTestingEnabled(true)
+            .setUnitTestRunner(answers.unitRunner)
+            .setE2ETestRunner(answers.e2eRunner);
+    }
+    else {
+        builder.setTestingEnabled(false);
+    }
+    if (!answers.git) {
+        builder.setGitInit(false);
+    }
+    return builder.build();
+}
+/**
+ * Validate user input
+ */
+export function validateProjectName(name) {
+    if (!name) {
+        return { valid: false, error: 'Project name is required' };
+    }
+    if (!/^[a-z0-9-]+$/.test(name)) {
+        return { valid: false, error: 'Project name must be lowercase alphanumeric with hyphens' };
+    }
+    return { valid: true };
+}
+/**
+ * Display project summary
+ */
+function displayProjectSummary(config) {
+    console.log(chalk.cyan('\n📋 Project Configuration:\n'));
+    console.log(chalk.gray('  Name:            ') + chalk.white(config.name));
+    console.log(chalk.gray('  Path:            ') + chalk.white(config.path));
+    console.log(chalk.gray('  Runtime:         ') + chalk.white(config.runtime));
+    console.log(chalk.gray('  Language:        ') + chalk.white(config.language));
+    console.log(chalk.gray('  Styling:         ') + chalk.white(config.styling.solution));
+    console.log(chalk.gray('  State:           ') + chalk.white(config.stateManagement || 'none'));
+    console.log(chalk.gray('  Data Fetching:   ') + chalk.white(config.dataFetching.enabled ? 'TanStack Query' : 'none'));
+    console.log(chalk.gray('  Testing:         ') + chalk.white(config.testing.enabled ? `${config.testing.unit?.runner}` : 'disabled'));
+    if (config.testing.enabled && config.testing.e2e?.enabled) {
+        console.log(chalk.gray('  E2E Testing:     ') + chalk.white(config.testing.e2e.runner));
+    }
+    console.log(chalk.gray('  Package Manager: ') + chalk.white(config.packageManager));
+    console.log(chalk.gray('  Git:             ') + chalk.white(config.git.init ? 'yes' : 'no'));
+    console.log();
+}
+/**
+ * Main CLI entry point
+ */
+export async function main() {
+    console.log(chalk.cyan.bold('\n  ⚛️  react-setup\n'));
+    console.log(chalk.gray('  Production-ready React scaffolder with first-class testing\n'));
+    try {
+        // Get user input
+        const answers = await promptForProjectDetails();
+        // Convert to config
+        const config = promptAnswersToConfig(answers);
+        // Validate
+        const validation = new ConfigBuilder(config).validate();
+        if (!validation.success) {
+            console.error(chalk.red('\n❌ Configuration validation failed:'));
+            validation.errors?.forEach((error) => console.error(chalk.red(`  • ${error}`)));
+            process.exit(1);
+        }
+        // Display summary
+        displayProjectSummary(config);
+        // Generate project
+        console.log(chalk.cyan('🚀 Creating project...\n'));
+        const result = await generateProject(config);
+        if (!result.success) {
+            console.error(chalk.red('\n❌ Project generation failed:'));
+            result.errors.forEach((error) => console.error(chalk.red(`  • ${error}`)));
+            process.exit(1);
+        }
+        if (result.warnings.length > 0) {
+            console.log(chalk.yellow('\n⚠️  Warnings:'));
+            result.warnings.forEach((warning) => console.log(chalk.yellow(`  • ${warning}`)));
+        }
+    }
+    catch (error) {
+        if (error instanceof Error && error.message === 'User force closed the prompt') {
+            console.log(chalk.yellow('\n✋ Setup cancelled\n'));
+            process.exit(0);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map