@hua-labs/create-hua-ux 0.1.0-alpha.0.1

package/dist/utils.js

@@ -0,0 +1,896 @@
+"use strict";
+/**
+ * create-hua-ux - Utilities
+ *
+ * Utility functions for project creation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.promptProjectName = promptProjectName;
+exports.promptAiContextOptions = promptAiContextOptions;
+exports.copyTemplate = copyTemplate;
+exports.generatePackageJson = generatePackageJson;
+exports.generateConfig = generateConfig;
+exports.generateAiContextFiles = generateAiContextFiles;
+exports.checkPrerequisites = checkPrerequisites;
+exports.validateTemplate = validateTemplate;
+exports.validateGeneratedProject = validateGeneratedProject;
+exports.validateTranslationFiles = validateTranslationFiles;
+exports.generateSummary = generateSummary;
+exports.displaySummary = displaySummary;
+exports.displayNextSteps = displayNextSteps;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const inquirer_1 = __importDefault(require("inquirer"));
+const chalk_1 = __importDefault(require("chalk"));
+const version_1 = require("./version");
+const versions_1 = require("./constants/versions");
+// Resolve template directory
+// When compiled, __dirname points to dist/, so we need to go up to templates/
+// When running with tsx, __dirname points to src/, so we need to go up one level
+const TEMPLATE_DIR = path.join(__dirname, '../templates/nextjs');
+/**
+ * Check if English-only mode is enabled
+ */
+function isEnglishOnly() {
+    return process.env.LANG === 'en' || process.env.CLI_LANG === 'en' || process.argv.includes('--english-only');
+}
+/**
+ * Get localized message
+ */
+function t(key) {
+    if (isEnglishOnly()) {
+        const messages = {
+            projectNamePrompt: 'What is your project name?',
+            projectNameRequired: 'Project name is required',
+            selectAiContext: 'Select AI context files to generate:',
+            documentationLanguage: 'Documentation language:',
+        };
+        return messages[key] || key;
+    }
+    // Bilingual (Korean + English)
+    const messages = {
+        projectNamePrompt: 'What is your project name? / 프로젝트 이름을 입력하세요:',
+        projectNameRequired: 'Project name is required / 프로젝트 이름이 필요합니다',
+        selectAiContext: 'Select AI context files to generate / 생성할 AI 컨텍스트 파일을 선택하세요:',
+        documentationLanguage: 'Documentation language / 문서 언어:',
+    };
+    return messages[key] || key;
+}
+/**
+ * Prompt for project name
+ */
+async function promptProjectName() {
+    // If not interactive, cannot prompt
+    if (!isInteractive()) {
+        throw new Error('Project name is required when running in non-interactive mode. Please provide it as an argument: npx tsx src/index.ts <project-name>');
+    }
+    const { projectName } = await inquirer_1.default.prompt([
+        {
+            type: 'input',
+            name: 'projectName',
+            message: t('projectNamePrompt'),
+            validate: (input) => {
+                if (!input.trim()) {
+                    return t('projectNameRequired');
+                }
+                return true;
+            },
+        },
+    ]);
+    return projectName;
+}
+/**
+ * Check if running in interactive mode
+ *
+ * For PowerShell and other environments, we check:
+ * 1. stdin/stdout are TTY (if available)
+ * 2. Not in CI environment
+ * 3. Not explicitly set to non-interactive
+ * 4. stdin is readable (not piped)
+ *
+ * In PowerShell, isTTY might be undefined, so we use a more lenient check.
+ */
+function isInteractive() {
+    // Explicitly non-interactive
+    if (process.env.CI || process.env.NON_INTERACTIVE) {
+        return false;
+    }
+    // Check if stdin is TTY (available in most terminals)
+    // In PowerShell, this might be undefined, so we check if it's explicitly false
+    // If undefined, we assume it might be interactive (PowerShell can be interactive)
+    const stdinTTY = process.stdin.isTTY;
+    const stdoutTTY = process.stdout.isTTY;
+    // If both are explicitly false, definitely not interactive
+    if (stdinTTY === false && stdoutTTY === false) {
+        return false;
+    }
+    // If either is true, or both are undefined (PowerShell case), assume interactive
+    // This allows inquirer to attempt to use prompts
+    // Inquirer will handle the actual TTY check internally
+    return stdinTTY !== false && stdoutTTY !== false;
+}
+/**
+ * Prompt for AI context generation options
+ */
+async function promptAiContextOptions() {
+    // If not interactive, use defaults
+    if (!isInteractive()) {
+        console.log('Running in non-interactive mode, using default options...');
+        return {
+            cursorrules: true,
+            aiContext: true,
+            claudeContext: true,
+            claudeSkills: false,
+            language: 'both',
+        };
+    }
+    // Use inquirer with proper error handling
+    try {
+        const isEn = isEnglishOnly();
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'checkbox',
+                name: 'options',
+                message: t('selectAiContext'),
+                choices: [
+                    {
+                        name: isEn ? '.cursorrules (Cursor IDE rules)' : '.cursorrules (Cursor IDE rules) / Cursor IDE 규칙',
+                        value: 'cursorrules',
+                        checked: true,
+                    },
+                    {
+                        name: isEn ? 'ai-context.md (General AI context)' : 'ai-context.md (General AI context) / 범용 AI 컨텍스트',
+                        value: 'aiContext',
+                        checked: true,
+                    },
+                    {
+                        name: isEn ? '.claude/project-context.md (Claude context)' : '.claude/project-context.md (Claude context) / Claude 컨텍스트',
+                        value: 'claudeContext',
+                        checked: true,
+                    },
+                    {
+                        name: isEn ? '.claude/skills/ (Claude skills)' : '.claude/skills/ (Claude skills) / Claude 스킬',
+                        value: 'claudeSkills',
+                        checked: false,
+                    },
+                ],
+            },
+            {
+                type: 'list',
+                name: 'language',
+                message: t('documentationLanguage'),
+                choices: [
+                    { name: isEn ? 'Korean only' : 'Korean only / 한국어만', value: 'ko' },
+                    { name: isEn ? 'English only' : 'English only / 영어만', value: 'en' },
+                    { name: isEn ? 'Both Korean and English' : 'Both Korean and English / 한국어와 영어 모두', value: 'both' },
+                ],
+                default: 'both',
+            },
+        ]);
+        return {
+            cursorrules: answers.options.includes('cursorrules'),
+            aiContext: answers.options.includes('aiContext'),
+            claudeContext: answers.options.includes('claudeContext'),
+            claudeSkills: answers.options.includes('claudeSkills'),
+            language: answers.language || 'both',
+        };
+    }
+    catch (error) {
+        // If inquirer fails (e.g., in non-interactive environment), use defaults
+        console.warn('Failed to get interactive input, using default options...');
+        return {
+            cursorrules: true,
+            aiContext: true,
+            claudeContext: true,
+            claudeSkills: false,
+            language: 'both',
+        };
+    }
+}
+/**
+ * Copy template files to project directory
+ *
+ * @param projectPath - Target project directory
+ * @param options - Copy options
+ * @param options.skipAiContext - Skip AI context files (.cursorrules, ai-context.md, .claude/)
+ */
+async function copyTemplate(projectPath, options) {
+    await fs.copy(TEMPLATE_DIR, projectPath, {
+        filter: (src) => {
+            // Skip node_modules and .git
+            if (src.includes('node_modules') || src.includes('.git')) {
+                return false;
+            }
+            // Conditionally skip AI context files
+            if (options?.skipAiContext) {
+                const relativePath = path.relative(TEMPLATE_DIR, src);
+                if (relativePath === '.cursorrules' ||
+                    relativePath === 'ai-context.md' ||
+                    relativePath.startsWith('.claude')) {
+                    return false;
+                }
+            }
+            return true;
+        },
+    });
+}
+/**
+ * Get hua-ux package version
+ *
+ * 모노레포 내부에서는 workspace 버전을, 외부에서는 npm 버전을 사용
+ *
+ * 감지 우선순위:
+ * 1. 환경 변수 (HUA_UX_WORKSPACE_VERSION)
+ * 2. pnpm-workspace.yaml 파일 존재 여부 (더 견고한 방법)
+ * 3. 폴더 이름 기반 감지 (하위 호환성)
+ * 4. hua-ux 패키지의 package.json에서 버전 읽기 (자동화)
+ * 5. npm 버전 (기본값)
+ */
+function getHuaUxVersion() {
+    // 1. 환경 변수 우선 확인
+    if (process.env.HUA_UX_WORKSPACE_VERSION === 'workspace') {
+        return 'workspace:*';
+    }
+    // 2. pnpm-workspace.yaml 파일 존재 여부로 모노레포 감지 (더 견고한 방법)
+    try {
+        const fs = require('fs');
+        const path = require('path');
+        let currentDir = process.cwd();
+        const maxDepth = 10; // 최대 10단계 상위 디렉토리까지 확인
+        for (let i = 0; i < maxDepth; i++) {
+            const workspaceFile = path.join(currentDir, 'pnpm-workspace.yaml');
+            if (fs.existsSync(workspaceFile)) {
+                return 'workspace:*';
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir)
+                break; // 루트 도달
+            currentDir = parentDir;
+        }
+    }
+    catch (error) {
+        // fs 모듈을 사용할 수 없는 경우 (Edge Runtime 등) 무시
+    }
+    // 3. 하위 호환성: 폴더 이름 기반 감지 (기존 방식)
+    const cwd = process.cwd();
+    if (cwd.includes('hua-platform') && !cwd.includes('node_modules')) {
+        return 'workspace:*';
+    }
+    // 4. hua-ux 패키지의 package.json에서 버전 읽기 (자동화)
+    // create-hua-ux 패키지에서 hua-ux 패키지의 package.json을 읽어서 버전 추출
+    try {
+        const fs = require('fs');
+        const path = require('path');
+        // create-hua-ux의 위치에서 hua-ux 패키지 찾기
+        // __dirname은 dist/utils.js 또는 src/utils.ts의 위치
+        // dist/utils.js인 경우: packages/create-hua-ux/dist/utils.js
+        // src/utils.ts인 경우: packages/create-hua-ux/src/utils.ts
+        const currentFile = __dirname;
+        const createHuaUxRoot = path.resolve(currentFile, '../..');
+        const huaUxPackageJson = path.join(createHuaUxRoot, '../hua-ux/package.json');
+        if (fs.existsSync(huaUxPackageJson)) {
+            const huaUxPackage = JSON.parse(fs.readFileSync(huaUxPackageJson, 'utf-8'));
+            const version = huaUxPackage.version;
+            if (version) {
+                // 버전 앞에 ^ 추가 (예: 0.1.0 -> ^0.1.0)
+                return `^${version}`;
+            }
+        }
+    }
+    catch (error) {
+        // 파일을 읽을 수 없는 경우 무시하고 다음 단계로
+    }
+    // 5. 빌드 시점에 생성된 버전 상수 사용 (npm 배포 후)
+    // 빌드 스크립트에서 hua-ux 패키지의 버전을 읽어서 생성한 상수
+    return version_1.HUA_UX_VERSION;
+}
+/**
+ * Get hua-ux related package version
+ *
+ * hua-ux와 관련된 패키지들의 버전을 반환합니다.
+ * 모노레포 내부에서는 workspace 버전을, 외부에서는 npm 버전을 사용합니다.
+ */
+function getHuaUxRelatedPackageVersion() {
+    return getHuaUxVersion();
+}
+/**
+ * Generate package.json
+ */
+async function generatePackageJson(projectPath, projectName) {
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    // 기존 package.json이 있다면 삭제 (템플릿에서 복사된 파일이 있을 수 있음)
+    if (await fs.pathExists(packageJsonPath)) {
+        await fs.remove(packageJsonPath);
+    }
+    const packageJson = {
+        name: projectName,
+        version: '0.1.0',
+        private: true,
+        scripts: {
+            dev: 'next dev --turbopack',
+            build: 'next build',
+            start: 'next start',
+            lint: "next lint",
+            'lint:fix': 'next lint --fix',
+        },
+        dependencies: {
+            '@hua-labs/hua-ux': getHuaUxVersion(),
+            '@hua-labs/i18n-core-zustand': getHuaUxRelatedPackageVersion(),
+            '@hua-labs/state': getHuaUxRelatedPackageVersion(),
+            next: versions_1.NEXTJS_VERSION,
+            react: versions_1.REACT_VERSION,
+            'react-dom': versions_1.REACT_DOM_VERSION,
+            zustand: versions_1.ZUSTAND_VERSION,
+        },
+        devDependencies: {
+            '@types/node': versions_1.TYPES_NODE_VERSION,
+            '@types/react': versions_1.TYPES_REACT_VERSION,
+            '@types/react-dom': versions_1.TYPES_REACT_DOM_VERSION,
+            '@tailwindcss/postcss': versions_1.TAILWIND_POSTCSS_VERSION,
+            autoprefixer: versions_1.AUTOPREFIXER_VERSION,
+            postcss: versions_1.POSTCSS_VERSION,
+            tailwindcss: versions_1.TAILWIND_VERSION,
+            typescript: versions_1.TYPESCRIPT_VERSION,
+        },
+    };
+    await fs.writeJSON(packageJsonPath, packageJson, { spaces: 2 });
+}
+/**
+ * Generate hua-ux.config.ts
+ */
+async function generateConfig(projectPath) {
+    const configContent = `import { defineConfig } from '@hua-labs/hua-ux/framework';
+
+/**
+ * hua-ux 프레임워크 설정
+ * 
+ * Preset을 선택하면 대부분의 설정이 자동으로 적용됩니다.
+ * - 'product': 제품 페이지용 (전문적, 효율적)
+ * - 'marketing': 마케팅 페이지용 (화려함, 눈에 띄는)
+ * 
+ * **바이브 모드 (간단)**: \`preset: 'product'\`
+ * **개발자 모드 (세부 설정)**: \`preset: { type: 'product', motion: {...} }\`
+ */
+export default defineConfig({
+  /**
+   * 프리셋 선택
+   * 
+   * Preset을 선택하면 motion, spacing, i18n 등이 자동 설정됩니다.
+   * 
+   * 바이브 모드 (간단):
+   *   preset: 'product'
+   * 
+   * 개발자 모드 (세부 설정):
+   *   preset: {
+   *     type: 'product',
+   *     motion: { duration: 300 },
+   *   }
+   */
+  preset: 'product',
+  
+  /**
+   * 다국어 설정
+   */
+  i18n: {
+    defaultLanguage: 'ko',
+    supportedLanguages: ['ko', 'en'],
+    namespaces: ['common'],
+    translationLoader: 'api',
+    translationApiPath: '/api/translations',
+  },
+  
+  /**
+   * 모션/애니메이션 설정
+   * 
+   * 바이브 코더용 (명사 중심):
+   *   motion: { style: 'smooth' }  // 'smooth' | 'dramatic' | 'minimal'
+   * 
+   * 개발자용 (기술적):
+   *   motion: {
+   *     defaultPreset: 'product',
+   *     enableAnimations: true,
+   *     duration: 300,
+   *   }
+   */
+  motion: {
+    defaultPreset: 'product',
+    enableAnimations: true,
+    // style: 'smooth',  // 바이브 코더용: 'smooth' | 'dramatic' | 'minimal'
+  },
+  
+  /**
+   * 상태 관리 설정
+   */
+  state: {
+    persist: true,
+    ssr: true,
+  },
+  
+  /**
+   * 브랜딩 설정 (화이트 라벨링)
+   * 
+   * 색상, 타이포그래피 등을 설정하면 모든 컴포넌트에 자동 적용됩니다.
+   * 
+   * branding: {
+   *   colors: {
+   *     primary: '#3B82F6',
+   *     secondary: '#8B5CF6',
+   *   },
+   * }
+   */
+  // branding: {
+  //   colors: {
+  //     primary: '#3B82F6',
+  //   },
+  // },
+  
+  /**
+   * 라이선스 설정 (Pro/Enterprise 플러그인 사용 시)
+   * 
+   * license: {
+   *   apiKey: process.env.HUA_UX_LICENSE_KEY,
+   * }
+   */
+  // license: {
+  //   apiKey: process.env.HUA_UX_LICENSE_KEY,
+  // },
+  
+  /**
+   * 플러그인 설정 (Pro/Enterprise 기능)
+   * 
+   * plugins: [
+   *   motionProPlugin,
+   *   i18nProPlugin,
+   * ]
+   */
+  // plugins: [],
+});
+`;
+    await fs.writeFile(path.join(projectPath, 'hua-ux.config.ts'), configContent);
+}
+/**
+ * Generate AI context files
+ *
+ * Cursor, Claude 등 다양한 AI 도구를 위한 컨텍스트 파일 생성
+ * 템플릿 파일을 복사한 후 프로젝트별 정보를 동적으로 추가합니다.
+ */
+async function generateAiContextFiles(projectPath, projectName, options) {
+    const opts = options || {
+        cursorrules: true,
+        aiContext: true,
+        claudeContext: true,
+        claudeSkills: false,
+        language: 'both',
+    };
+    // 옵션에 따라 파일 삭제 (생성하지 않을 파일)
+    if (!opts.cursorrules) {
+        const cursorrulesPath = path.join(projectPath, '.cursorrules');
+        if (await fs.pathExists(cursorrulesPath)) {
+            await fs.remove(cursorrulesPath);
+        }
+    }
+    if (!opts.aiContext) {
+        const aiContextPath = path.join(projectPath, 'ai-context.md');
+        if (await fs.pathExists(aiContextPath)) {
+            await fs.remove(aiContextPath);
+        }
+    }
+    if (!opts.claudeContext) {
+        const claudeContextPath = path.join(projectPath, '.claude', 'project-context.md');
+        if (await fs.pathExists(claudeContextPath)) {
+            await fs.remove(claudeContextPath);
+        }
+    }
+    if (!opts.claudeSkills) {
+        const claudeSkillsPath = path.join(projectPath, '.claude', 'skills');
+        if (await fs.pathExists(claudeSkillsPath)) {
+            await fs.remove(claudeSkillsPath);
+        }
+    }
+    // 프로젝트별 커스터마이징
+    if (projectName) {
+        // ai-context.md에 프로젝트 이름 추가
+        if (opts.aiContext) {
+            const aiContextPath = path.join(projectPath, 'ai-context.md');
+            if (await fs.pathExists(aiContextPath)) {
+                let content = await fs.readFile(aiContextPath, 'utf-8');
+                // Add project name to document header
+                content = content.replace(/^# hua-ux Project AI Context/, `# ${projectName} - hua-ux Project AI Context\n\n**Project Name**: ${projectName}`);
+                await fs.writeFile(aiContextPath, content, 'utf-8');
+            }
+        }
+        // .claude/project-context.md에도 프로젝트 이름 추가
+        if (opts.claudeContext) {
+            const claudeContextPath = path.join(projectPath, '.claude', 'project-context.md');
+            if (await fs.pathExists(claudeContextPath)) {
+                let content = await fs.readFile(claudeContextPath, 'utf-8');
+                content = content.replace(/^# hua-ux Project Context/, `# ${projectName} - hua-ux Project Context\n\n**Project Name**: ${projectName}`);
+                await fs.writeFile(claudeContextPath, content, 'utf-8');
+            }
+        }
+    }
+    // package.json에서 실제 설치된 패키지 버전 정보 추출하여 컨텍스트에 추가
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    if (await fs.pathExists(packageJsonPath)) {
+        try {
+            const packageJson = await fs.readJSON(packageJsonPath);
+            const dependencies = packageJson.dependencies || {};
+            const devDependencies = packageJson.devDependencies || {};
+            // 버전 정보를 ai-context.md에 추가
+            if (opts.aiContext) {
+                const aiContextPath = path.join(projectPath, 'ai-context.md');
+                if (await fs.pathExists(aiContextPath)) {
+                    let content = await fs.readFile(aiContextPath, 'utf-8');
+                    // 의존성 정보 섹션 추가
+                    const depsSection = `
+## 설치된 패키지 버전 / Installed Package Versions
+
+### 핵심 의존성 / Core Dependencies
+${Object.entries(dependencies)
+                        .filter(([name]) => name.startsWith('@hua-labs/') || name === 'next' || name === 'react')
+                        .map(([name, version]) => `- \`${name}\`: ${version}`)
+                        .join('\n')}
+
+### 개발 의존성 / Dev Dependencies
+${Object.entries(devDependencies)
+                        .filter(([name]) => name.includes('typescript') || name.includes('tailwind') || name.includes('@types'))
+                        .map(([name, version]) => `- \`${name}\`: ${version}`)
+                        .join('\n')}
+`;
+                    // 참고 자료 섹션 앞에 추가
+                    content = content.replace(/## 참고 자료/, `${depsSection}\n## 참고 자료`);
+                    await fs.writeFile(aiContextPath, content, 'utf-8');
+                }
+            }
+        }
+        catch (error) {
+            // package.json 파싱 실패 시 무시 (선택적 기능)
+            console.warn('Failed to extract package versions for AI context:', error);
+        }
+    }
+}
+/**
+ * Check prerequisites before project creation
+ *
+ * Verifies Node.js version, pnpm installation, and template integrity
+ */
+async function checkPrerequisites() {
+    const isEn = isEnglishOnly();
+    const errors = [];
+    const warnings = [];
+    // 1. Node.js version check
+    const nodeVersion = process.version;
+    const requiredVersion = '18.0.0';
+    // Simple version comparison (major.minor.patch)
+    const parseVersion = (v) => {
+        return v.replace(/^v/, '').split('.').map(Number);
+    };
+    const compareVersions = (v1, v2) => {
+        const v1Parts = parseVersion(v1);
+        const v2Parts = parseVersion(v2);
+        for (let i = 0; i < 3; i++) {
+            if (v1Parts[i] > v2Parts[i])
+                return 1;
+            if (v1Parts[i] < v2Parts[i])
+                return -1;
+        }
+        return 0;
+    };
+    if (compareVersions(nodeVersion, requiredVersion) < 0) {
+        errors.push(isEn
+            ? `Node.js ${requiredVersion}+ required. Current: ${nodeVersion}`
+            : `Node.js ${requiredVersion}+ 필요합니다. 현재: ${nodeVersion}`);
+    }
+    // 2. pnpm installation check
+    try {
+        (0, child_process_1.execSync)('pnpm --version', { stdio: 'ignore' });
+    }
+    catch {
+        errors.push(isEn
+            ? 'pnpm is required. Install: npm install -g pnpm'
+            : 'pnpm이 필요합니다. 설치: npm install -g pnpm');
+    }
+    // 3. Template validation
+    try {
+        await validateTemplate();
+    }
+    catch (error) {
+        errors.push(isEn
+            ? `Template validation failed: ${error instanceof Error ? error.message : String(error)}`
+            : `템플릿 검증 실패: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    // Display warnings
+    if (warnings.length > 0) {
+        console.log(chalk_1.default.yellow('\n⚠️  Warnings:'));
+        warnings.forEach(w => console.log(chalk_1.default.yellow(`  - ${w}`)));
+    }
+    // Throw error if prerequisites not met
+    if (errors.length > 0) {
+        const errorMessage = isEn
+            ? `Prerequisites check failed:\n${errors.map(e => `  ❌ ${e}`).join('\n')}\n\n💡 Tips:\n  - Update Node.js: https://nodejs.org/\n  - Install pnpm: npm install -g pnpm`
+            : `사전 검증 실패:\n${errors.map(e => `  ❌ ${e}`).join('\n')}\n\n💡 팁:\n  - Node.js 업데이트: https://nodejs.org/\n  - pnpm 설치: npm install -g pnpm`;
+        throw new Error(errorMessage);
+    }
+}
+/**
+ * Validate template files integrity
+ *
+ * Checks if all required template files exist before project creation
+ */
+async function validateTemplate() {
+    // Check if template directory exists
+    if (!(await fs.pathExists(TEMPLATE_DIR))) {
+        const isEn = isEnglishOnly();
+        throw new Error(isEn
+            ? `Template directory not found: ${TEMPLATE_DIR}`
+            : `템플릿 디렉토리를 찾을 수 없습니다: ${TEMPLATE_DIR}`);
+    }
+    // Note: package.json is generated dynamically, not in template
+    const requiredFiles = [
+        'tsconfig.json',
+        'next.config.ts',
+        'tailwind.config.js',
+        'app/layout.tsx',
+        'app/page.tsx',
+        'app/globals.css',
+        'lib/i18n-setup.ts',
+        'store/useAppStore.ts',
+        'translations/ko/common.json',
+        'translations/en/common.json',
+    ];
+    const missingFiles = [];
+    for (const file of requiredFiles) {
+        const filePath = path.join(TEMPLATE_DIR, file);
+        if (!(await fs.pathExists(filePath))) {
+            missingFiles.push(file);
+        }
+    }
+    if (missingFiles.length > 0) {
+        const isEn = isEnglishOnly();
+        throw new Error(isEn
+            ? `Template files missing: ${missingFiles.join(', ')}`
+            : `템플릿 파일 누락: ${missingFiles.join(', ')}`);
+    }
+}
+/**
+ * Validate generated project
+ *
+ * 프로젝트 생성 후 필수 파일과 설정이 올바르게 생성되었는지 검증
+ */
+async function validateGeneratedProject(projectPath) {
+    const errors = [];
+    // 1. package.json 검증
+    const packageJsonPath = path.join(projectPath, 'package.json');
+    if (!(await fs.pathExists(packageJsonPath))) {
+        const isEn = isEnglishOnly();
+        errors.push(isEn ? 'package.json file was not created' : 'package.json 파일이 생성되지 않았습니다.');
+    }
+    else {
+        try {
+            const packageJson = await fs.readJSON(packageJsonPath);
+            // lint 스크립트 검증
+            if (packageJson.scripts?.lint !== 'next lint') {
+                errors.push(`package.json의 lint 스크립트가 올바르지 않습니다. 예상: "next lint", 실제: "${packageJson.scripts?.lint}"`);
+            }
+            // 필수 의존성 검증
+            const requiredDeps = ['@hua-labs/hua-ux', 'next', 'react', 'react-dom'];
+            for (const dep of requiredDeps) {
+                if (!packageJson.dependencies?.[dep]) {
+                    errors.push(`필수 의존성 ${dep}이 package.json에 없습니다.`);
+                }
+            }
+        }
+        catch (error) {
+            errors.push(`package.json 파싱 실패: ${error}`);
+        }
+    }
+    // 2. hua-ux.config.ts 검증
+    const configPath = path.join(projectPath, 'hua-ux.config.ts');
+    if (!(await fs.pathExists(configPath))) {
+        const isEn = isEnglishOnly();
+        errors.push(isEn ? 'hua-ux.config.ts file was not created' : 'hua-ux.config.ts 파일이 생성되지 않았습니다.');
+    }
+    // 3. 필수 디렉토리 검증
+    const requiredDirs = ['app', 'lib', 'store', 'translations'];
+    for (const dir of requiredDirs) {
+        const dirPath = path.join(projectPath, dir);
+        if (!(await fs.pathExists(dirPath))) {
+            const isEn = isEnglishOnly();
+            errors.push(isEn ? `Required directory ${dir} was not created` : `필수 디렉토리 ${dir}가 생성되지 않았습니다.`);
+        }
+    }
+    // 4. 필수 파일 검증
+    const requiredFiles = [
+        'app/layout.tsx',
+        'app/page.tsx',
+        'tsconfig.json',
+        'next.config.ts',
+    ];
+    for (const file of requiredFiles) {
+        const filePath = path.join(projectPath, file);
+        if (!(await fs.pathExists(filePath))) {
+            const isEn = isEnglishOnly();
+            errors.push(isEn ? `Required file ${file} was not created` : `필수 파일 ${file}이 생성되지 않았습니다.`);
+        }
+    }
+    // 에러가 있으면 예외 발생
+    if (errors.length > 0) {
+        const isEn = isEnglishOnly();
+        throw new Error(isEn
+            ? `Project validation failed:\n${errors.map(e => `  ❌ ${e}`).join('\n')}\n\n💡 Tips:\n  - Check file permissions\n  - Ensure disk space is available\n  - Try running again`
+            : `프로젝트 검증 실패:\n${errors.map(e => `  ❌ ${e}`).join('\n')}\n\n💡 팁:\n  - 파일 권한 확인\n  - 디스크 공간 확인\n  - 다시 실행해보세요`);
+    }
+}
+/**
+ * Validate translation files JSON syntax
+ */
+async function validateTranslationFiles(projectPath) {
+    const translationFiles = [
+        'translations/ko/common.json',
+        'translations/en/common.json',
+    ];
+    const errors = [];
+    const isEn = isEnglishOnly();
+    for (const file of translationFiles) {
+        const filePath = path.join(projectPath, file);
+        if (await fs.pathExists(filePath)) {
+            try {
+                const content = await fs.readFile(filePath, 'utf-8');
+                JSON.parse(content);
+            }
+            catch (error) {
+                if (error instanceof SyntaxError) {
+                    errors.push(isEn
+                        ? `Invalid JSON in ${file}: ${error.message}`
+                        : `${file}의 JSON 문법 오류: ${error.message}`);
+                }
+                else {
+                    errors.push(isEn
+                        ? `Failed to read ${file}: ${error instanceof Error ? error.message : String(error)}`
+                        : `${file} 읽기 실패: ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(isEn
+            ? `Translation files validation failed:\n${errors.map(e => `  ❌ ${e}`).join('\n')}`
+            : `번역 파일 검증 실패:\n${errors.map(e => `  ❌ ${e}`).join('\n')}`);
+    }
+}
+/**
+ * Generate installation summary
+ */
+async function generateSummary(projectPath, aiContextOptions) {
+    let directories = 0;
+    let files = 0;
+    const countItems = async (dirPath) => {
+        try {
+            const items = await fs.readdir(dirPath, { withFileTypes: true });
+            for (const item of items) {
+                // Skip hidden files and common ignore patterns
+                if (item.name.startsWith('.') && item.name !== '.cursorrules' && !item.name.startsWith('.claude')) {
+                    continue;
+                }
+                if (item.name === 'node_modules' || item.name === '.git') {
+                    continue;
+                }
+                const itemPath = path.join(dirPath, item.name);
+                if (item.isDirectory()) {
+                    directories++;
+                    await countItems(itemPath);
+                }
+                else {
+                    files++;
+                }
+            }
+        }
+        catch (error) {
+            // Ignore permission errors or other issues
+        }
+    };
+    await countItems(projectPath);
+    const aiContextFiles = [];
+    if (aiContextOptions) {
+        if (aiContextOptions.cursorrules)
+            aiContextFiles.push('.cursorrules');
+        if (aiContextOptions.aiContext)
+            aiContextFiles.push('ai-context.md');
+        if (aiContextOptions.claudeContext)
+            aiContextFiles.push('.claude/project-context.md');
+        if (aiContextOptions.claudeSkills)
+            aiContextFiles.push('.claude/skills/');
+    }
+    const languages = [];
+    if (aiContextOptions?.language === 'ko' || aiContextOptions?.language === 'both') {
+        languages.push('ko');
+    }
+    if (aiContextOptions?.language === 'en' || aiContextOptions?.language === 'both') {
+        languages.push('en');
+    }
+    return {
+        directories,
+        files,
+        aiContextFiles,
+        languages,
+    };
+}
+/**
+ * Display installation summary
+ */
+function displaySummary(summary) {
+    const isEn = isEnglishOnly();
+    console.log(chalk_1.default.cyan('\n📊 Summary:'));
+    console.log(chalk_1.default.white(`  📁 Directories: ${summary.directories}`));
+    console.log(chalk_1.default.white(`  📄 Files: ${summary.files}`));
+    if (summary.aiContextFiles.length > 0) {
+        console.log(chalk_1.default.white(`  🤖 AI Context: ${summary.aiContextFiles.join(', ')}`));
+    }
+    else {
+        console.log(chalk_1.default.gray(`  🤖 AI Context: None`));
+    }
+    if (summary.languages.length > 0) {
+        console.log(chalk_1.default.white(`  🌐 Languages: ${summary.languages.join(', ')}`));
+    }
+}
+/**
+ * Display next steps with customized guidance
+ */
+function displayNextSteps(projectPath, aiContextOptions) {
+    const isEn = isEnglishOnly();
+    const relativePath = path.relative(process.cwd(), projectPath);
+    const displayPath = relativePath || path.basename(projectPath);
+    console.log(chalk_1.default.cyan(`\n📚 Next Steps:`));
+    console.log(chalk_1.default.white(`  cd ${displayPath}`));
+    console.log(chalk_1.default.white(`  pnpm install`));
+    console.log(chalk_1.default.white(`  pnpm dev`));
+    if (aiContextOptions?.claudeSkills) {
+        console.log(chalk_1.default.cyan(`\n💡 Claude Skills enabled:`));
+        console.log(chalk_1.default.white(isEn
+            ? '  Check .claude/skills/ for framework usage guide'
+            : '  .claude/skills/에서 프레임워크 사용 가이드를 확인하세요'));
+    }
+    if (aiContextOptions?.language === 'both') {
+        console.log(chalk_1.default.cyan(`\n🌐 Bilingual mode:`));
+        console.log(chalk_1.default.white(isEn
+            ? '  Edit translations/ko/ and translations/en/ for your content'
+            : '  translations/ko/와 translations/en/에서 번역을 수정하세요'));
+    }
+}