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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 HUA Labs Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

package/README.md

@@ -0,0 +1,183 @@
+# @hua-labs/create-hua-ux
+
+**Scaffolding tool for creating hua-ux projects**
+
+Quickly create a new Next.js project with hua-ux framework pre-configured.
+
+## Installation
+
+```bash
+pnpm create hua-ux my-app
+# or
+npm create hua-ux my-app
+# or
+yarn create hua-ux my-app
+```
+
+## Usage
+
+### Interactive Mode (Recommended)
+
+When you run the CLI, you'll be prompted to select which AI context files to generate:
+
+```bash
+pnpm create hua-ux my-app
+# or
+npx tsx src/index.ts my-app
+```
+
+You'll see interactive prompts:
+1. **Select AI context files** (checkboxes):
+   - `.cursorrules` (Cursor IDE rules) - default: checked
+   - `ai-context.md` (General AI context) - default: checked
+   - `.claude/project-context.md` (Claude context) - default: checked
+   - `.claude/skills/` (Claude skills) - default: unchecked
+
+2. **Documentation language**:
+   - Korean only
+   - English only
+   - Both Korean and English (default)
+
+### Non-Interactive Mode
+
+For CI/CD or automated scripts, use environment variable:
+
+```bash
+NON_INTERACTIVE=1 pnpm create hua-ux my-app
+```
+
+This will use default options (all files except Claude skills, both languages).
+
+### CLI Flags
+
+You can also use CLI flags to specify options:
+
+```bash
+npx tsx src/index.ts my-app --claude-skills --lang both
+```
+
+Available flags:
+- `--claude-skills`: Include Claude skills
+- `--no-cursorrules`: Skip .cursorrules
+- `--no-ai-context`: Skip ai-context.md
+- `--no-claude-context`: Skip .claude/project-context.md
+- `--lang <ko|en|both>`: Set documentation language
+
+### After Creation
+
+```bash
+cd my-app
+pnpm install
+pnpm dev
+```
+
+## What Gets Created
+
+- ✅ Next.js 16 project with App Router
+- ✅ TypeScript configuration
+- ✅ Tailwind CSS setup
+- ✅ `@hua-labs/hua-ux` pre-installed and configured
+- ✅ Basic project structure (`app/`, `components/`, `lib/`, `store/`)
+- ✅ i18n setup with Korean and English translations
+- ✅ Example page using `HuaUxLayout` and `HuaUxPage` with translation keys
+- ✅ `hua-ux.config.ts` configuration file
+- ✅ Dynamic language setting in layout (middleware-ready)
+- ✅ Improved error handling in translation API
+- ✅ ESLint configuration ready
+
+## Project Structure
+
+```
+my-app/
+├── app/
+│   ├── layout.tsx          # Root layout with HuaUxLayout
+│   ├── page.tsx            # Home page with HuaUxPage
+│   ├── globals.css         # Tailwind CSS
+│   └── api/
+│       └── translations/   # i18n API route
+├── components/             # Your components
+├── lib/
+│   └── i18n-setup.ts      # i18n configuration
+├── store/
+│   └── useAppStore.ts     # Zustand store
+├── translations/           # Translation files
+│   ├── ko/
+│   └── en/
+├── hua-ux.config.ts       # Framework configuration
+├── next.config.ts
+├── tailwind.config.js
+└── tsconfig.json
+```
+
+## Next Steps
+
+1. **Customize configuration**: Edit `hua-ux.config.ts`
+2. **Add translations**: Add more keys to `translations/ko/common.json` and `translations/en/common.json`
+3. **Create pages**: Add new pages in `app/` directory
+4. **Add components**: Create reusable components in `components/` directory
+5. **Optional: Add middleware**: If you need automatic language detection, rename `middleware.ts.example` to `middleware.ts` and uncomment the code (⚠️ Note: Runs on Edge Runtime)
+   - The layout will automatically read the language from the `x-language` header set by middleware
+
+## Template Features
+
+### GEO (Generative Engine Optimization)
+Example files for AI search engine optimization are included:
+- `app/layout-with-geo.example.tsx` - Layout with GEO metadata
+- `app/page-with-geo.example.tsx` - Page with GEO and SEO metadata
+
+These examples show how to integrate GEO metadata for better AI discoverability.
+
+### Dynamic Language Setting
+The generated `app/layout.tsx` automatically reads the language from middleware headers:
+
+```tsx
+// app/layout.tsx
+import { headers } from "next/headers";
+
+const headersList = headers();
+const language = headersList.get('x-language') || 'ko';
+
+return <html lang={language}>...</html>;
+```
+
+### Translation Keys Usage
+The example page uses translation keys instead of hardcoded text:
+
+```tsx
+// app/page.tsx
+import { useTranslation } from '@hua-labs/hua-ux';
+
+const { t } = useTranslation('common');
+return <h1>{t('title')}</h1>;
+```
+
+### Improved Error Handling
+The translation API route includes proper error handling with type distinction and validation.
+
+## Framework Layer
+
+생성된 프로젝트는 프레임워크 레이어를 사용합니다:
+
+- **`HuaUxLayout`**: 자동으로 i18n, motion, state 프로바이더 설정
+- **`HuaUxPage`**: 페이지 래퍼 (자동 모션 적용)
+- **`hua-ux.config.ts`**: 프레임워크 설정 파일
+
+자세한 내용은 [프레임워크 레이어 문서](../../packages/hua-ux/src/framework/README.md)를 참고하세요.
+
+## Troubleshooting
+
+### Edge Runtime 이슈
+
+미들웨어를 사용할 때 Edge Runtime 제약사항이 있습니다:
+- Node.js API 사용 불가 (fs, path 등)
+- 일부 npm 패키지가 호환되지 않을 수 있음
+
+**해결 방법**:
+1. 미들웨어를 사용하지 않고 API Route나 클라이언트 컴포넌트에서 언어 감지
+2. Edge Runtime을 명시적으로 설정: `export const runtime = 'edge';`
+
+자세한 내용은 [프레임워크 레이어 문서](../../packages/hua-ux/src/framework/README.md)를 참고하세요.
+
+## License
+
+MIT

package/dist/bin/create-hua-ux.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * create-hua-ux CLI Entry Point
+ *
+ * This file is compiled to dist/bin/create-hua-ux.js
+ * and used as the executable when the package is installed.
+ */
+export {};
+//# sourceMappingURL=create-hua-ux.d.ts.map

package/dist/bin/create-hua-ux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-hua-ux.d.ts","sourceRoot":"","sources":["../../src/bin/create-hua-ux.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/bin/create-hua-ux.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * create-hua-ux CLI Entry Point
+ *
+ * This file is compiled to dist/bin/create-hua-ux.js
+ * and used as the executable when the package is installed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../index");
+// Run the main function
+(0, index_1.main)().catch((error) => {
+    console.error('\n❌ Error:', error.message || String(error));
+    // 에러 타입별 가이드 제공
+    if (error.code === 'EACCES') {
+        console.error('\n💡 Tip: 폴더 권한을 확인하세요.');
+        console.error(`   chmod 755 ${process.cwd()}`);
+    }
+    else if (error.code === 'ENOENT') {
+        console.error('\n💡 Tip: Node.js가 설치되어 있는지 확인하세요.');
+        console.error('   node --version');
+    }
+    else if (error.message?.includes('already exists')) {
+        console.error('\n💡 Tip: 다른 프로젝트 이름을 사용하거나 기존 폴더를 삭제하세요.');
+    }
+    else if (error.message?.includes('EADDRINUSE')) {
+        console.error('\n💡 Tip: 포트가 이미 사용 중입니다.');
+    }
+    else {
+        console.error('\n💡 Troubleshooting:');
+        console.error('   1. Node.js 버전 확인: node --version (>=18.0.0 권장)');
+        console.error('   2. 폴더 권한 확인');
+        console.error('   3. 디스크 공간 확인');
+        console.error('   4. GitHub Issues: https://github.com/HUA-Labs/HUA-Labs-public/issues');
+    }
+    process.exit(1);
+});

package/dist/constants/versions.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Framework and dependency versions
+ *
+ * This file centralizes all version numbers used in generated projects.
+ * Update versions here when upgrading dependencies.
+ */
+/**
+ * Next.js version
+ */
+export declare const NEXTJS_VERSION = "16.0.10";
+/**
+ * React version
+ */
+export declare const REACT_VERSION = "19.2.1";
+/**
+ * React DOM version (should match React version)
+ */
+export declare const REACT_DOM_VERSION = "19.2.1";
+/**
+ * Zustand version
+ */
+export declare const ZUSTAND_VERSION = "^5.0.8";
+/**
+ * TypeScript version
+ */
+export declare const TYPESCRIPT_VERSION = "^5.9.3";
+/**
+ * Node.js types version
+ */
+export declare const TYPES_NODE_VERSION = "^22.0.0";
+/**
+ * React types version
+ */
+export declare const TYPES_REACT_VERSION = "^19.2.7";
+/**
+ * React DOM types version
+ */
+export declare const TYPES_REACT_DOM_VERSION = "^19.2.3";
+/**
+ * Tailwind CSS PostCSS version
+ */
+export declare const TAILWIND_POSTCSS_VERSION = "^4";
+/**
+ * Autoprefixer version
+ */
+export declare const AUTOPREFIXER_VERSION = "^10.4.21";
+/**
+ * PostCSS version
+ */
+export declare const POSTCSS_VERSION = "^8.5.6";
+/**
+ * Tailwind CSS version
+ */
+export declare const TAILWIND_VERSION = "^4.1.13";
+//# sourceMappingURL=versions.d.ts.map

package/dist/constants/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/constants/versions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,aAAa,WAAW,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,uBAAuB,YAAY,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAC"}

package/dist/constants/versions.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Framework and dependency versions
+ *
+ * This file centralizes all version numbers used in generated projects.
+ * Update versions here when upgrading dependencies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TAILWIND_VERSION = exports.POSTCSS_VERSION = exports.AUTOPREFIXER_VERSION = exports.TAILWIND_POSTCSS_VERSION = exports.TYPES_REACT_DOM_VERSION = exports.TYPES_REACT_VERSION = exports.TYPES_NODE_VERSION = exports.TYPESCRIPT_VERSION = exports.ZUSTAND_VERSION = exports.REACT_DOM_VERSION = exports.REACT_VERSION = exports.NEXTJS_VERSION = void 0;
+/**
+ * Next.js version
+ */
+exports.NEXTJS_VERSION = '16.0.10';
+/**
+ * React version
+ */
+exports.REACT_VERSION = '19.2.1';
+/**
+ * React DOM version (should match React version)
+ */
+exports.REACT_DOM_VERSION = '19.2.1';
+/**
+ * Zustand version
+ */
+exports.ZUSTAND_VERSION = '^5.0.8';
+/**
+ * TypeScript version
+ */
+exports.TYPESCRIPT_VERSION = '^5.9.3';
+/**
+ * Node.js types version
+ */
+exports.TYPES_NODE_VERSION = '^22.0.0';
+/**
+ * React types version
+ */
+exports.TYPES_REACT_VERSION = '^19.2.7';
+/**
+ * React DOM types version
+ */
+exports.TYPES_REACT_DOM_VERSION = '^19.2.3';
+/**
+ * Tailwind CSS PostCSS version
+ */
+exports.TAILWIND_POSTCSS_VERSION = '^4';
+/**
+ * Autoprefixer version
+ */
+exports.AUTOPREFIXER_VERSION = '^10.4.21';
+/**
+ * PostCSS version
+ */
+exports.POSTCSS_VERSION = '^8.5.6';
+/**
+ * Tailwind CSS version
+ */
+exports.TAILWIND_VERSION = '^4.1.13';

package/dist/create-project.d.ts

@@ -0,0 +1,18 @@
+/**
+ * create-hua-ux - Project Creation
+ *
+ * Creates a new hua-ux project from template
+ */
+import { type AiContextOptions } from './utils';
+/**
+ * Resolve project path
+ *
+ * If running from within the monorepo (packages/create-hua-ux), create project in monorepo root.
+ * Otherwise, create in current working directory.
+ */
+export declare function resolveProjectPath(projectName: string): string;
+export declare function createProject(projectName: string, aiContextOptions?: AiContextOptions, options?: {
+    dryRun?: boolean;
+    skipPrerequisites?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=create-project.d.ts.map

package/dist/create-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-project.d.ts","sourceRoot":"","sources":["../src/create-project.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAuG,KAAK,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErJ;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAe9D;AAED,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,gBAAgB,EACnC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1D,OAAO,CAAC,IAAI,CAAC,CAsKf"}

package/dist/create-project.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * create-hua-ux - Project Creation
+ *
+ * Creates a new hua-ux project from template
+ */
+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.resolveProjectPath = resolveProjectPath;
+exports.createProject = createProject;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const utils_1 = require("./utils");
+/**
+ * Resolve project path
+ *
+ * If running from within the monorepo (packages/create-hua-ux), create project in monorepo root.
+ * Otherwise, create in current working directory.
+ */
+function resolveProjectPath(projectName) {
+    const cwd = process.cwd();
+    // Check if we're running from packages/create-hua-ux directory
+    // More robust check: look for both 'packages' and 'create-hua-ux' in path
+    const normalizedCwd = path.normalize(cwd).replace(/\\/g, '/');
+    if (normalizedCwd.includes('/packages/') && normalizedCwd.includes('/create-hua-ux')) {
+        // Find the packages directory and go up one level to monorepo root
+        const packagesIndex = normalizedCwd.indexOf('/packages/');
+        const monorepoRoot = normalizedCwd.substring(0, packagesIndex);
+        return path.resolve(monorepoRoot, projectName);
+    }
+    // Default: create in current working directory
+    return path.resolve(cwd, projectName);
+}
+async function createProject(projectName, aiContextOptions, options) {
+    const projectPath = resolveProjectPath(projectName);
+    const isDryRun = options?.dryRun ?? false;
+    // Debug: log the resolved path (only in development)
+    if (process.env.NODE_ENV !== 'production' && !isDryRun) {
+        console.log(chalk_1.default.gray(`Project will be created at: ${projectPath}`));
+    }
+    // Check if directory already exists
+    if (!isDryRun && await fs.pathExists(projectPath)) {
+        const isEn = process.env.LANG === 'en' || process.env.CLI_LANG === 'en' || process.argv.includes('--english-only');
+        console.error(chalk_1.default.red(isEn
+            ? `Directory "${projectPath}" already exists`
+            : `디렉토리 "${projectPath}"가 이미 존재합니다`));
+        console.error(chalk_1.default.yellow(isEn
+            ? '💡 Try a different project name or remove the existing directory'
+            : '💡 다른 프로젝트 이름을 사용하거나 기존 디렉토리를 삭제하세요'));
+        process.exit(1);
+    }
+    // Prerequisites check (skip in dry-run mode)
+    if (!isDryRun && !options?.skipPrerequisites) {
+        const { checkPrerequisites } = await Promise.resolve().then(() => __importStar(require('./utils')));
+        try {
+            await checkPrerequisites();
+        }
+        catch (error) {
+            console.error(chalk_1.default.red('\n❌ Prerequisites check failed'));
+            throw error;
+        }
+    }
+    if (isDryRun) {
+        console.log(chalk_1.default.blue(`\n🔍 Dry-run mode: Preview of project creation for "${projectName}"\n`));
+    }
+    else {
+        console.log(chalk_1.default.blue(`\n🚀 Creating hua-ux project: ${projectName}...\n`));
+    }
+    try {
+        // Step 1/5: Creating project structure
+        console.log(chalk_1.default.blue('📦 Step 1/5: Creating project structure...'));
+        if (!isDryRun) {
+            await fs.ensureDir(projectPath);
+        }
+        else {
+            console.log(chalk_1.default.gray(`  Would create directory: ${projectPath}`));
+        }
+        console.log(chalk_1.default.green('✅ Project structure ready'));
+        // Step 2/5: Copying template files
+        console.log(chalk_1.default.blue('\n📋 Step 2/5: Copying template files...'));
+        if (!isDryRun) {
+            // Determine if we should skip AI context files during copy
+            // If user explicitly disabled all AI context, skip them during copy for performance
+            // Note: We still copy them and delete later for safety, but this optimization
+            // can be enabled if all AI context is explicitly disabled
+            const shouldSkipAiContext = aiContextOptions
+                ? !aiContextOptions.cursorrules && !aiContextOptions.aiContext && !aiContextOptions.claudeContext && !aiContextOptions.claudeSkills
+                : false;
+            await (0, utils_1.copyTemplate)(projectPath, { skipAiContext: shouldSkipAiContext });
+        }
+        else {
+            console.log(chalk_1.default.gray('  Would copy template files from templates/nextjs/'));
+            if (aiContextOptions) {
+                const aiFiles = [];
+                if (aiContextOptions.cursorrules)
+                    aiFiles.push('.cursorrules');
+                if (aiContextOptions.aiContext)
+                    aiFiles.push('ai-context.md');
+                if (aiContextOptions.claudeContext)
+                    aiFiles.push('.claude/project-context.md');
+                if (aiContextOptions.claudeSkills)
+                    aiFiles.push('.claude/skills/');
+                if (aiFiles.length > 0) {
+                    console.log(chalk_1.default.gray(`  Would include AI context files: ${aiFiles.join(', ')}`));
+                }
+            }
+        }
+        console.log(chalk_1.default.green('✅ Template files copied'));
+        // Step 3/5: Generating configuration
+        console.log(chalk_1.default.blue('\n⚙️  Step 3/5: Generating configuration...'));
+        if (!isDryRun) {
+            await (0, utils_1.generatePackageJson)(projectPath, projectName);
+            await (0, utils_1.generateConfig)(projectPath);
+        }
+        else {
+            console.log(chalk_1.default.gray('  Would generate package.json'));
+            console.log(chalk_1.default.gray('  Would generate hua-ux.config.ts'));
+        }
+        console.log(chalk_1.default.green('✅ Configuration generated'));
+        // Step 4/5: Generating AI context files
+        console.log(chalk_1.default.blue('\n🤖 Step 4/5: Generating AI context files...'));
+        if (!isDryRun) {
+            await (0, utils_1.generateAiContextFiles)(projectPath, projectName, aiContextOptions);
+        }
+        else {
+            const aiFiles = [];
+            if (aiContextOptions?.cursorrules)
+                aiFiles.push('.cursorrules');
+            if (aiContextOptions?.aiContext)
+                aiFiles.push('ai-context.md');
+            if (aiContextOptions?.claudeContext)
+                aiFiles.push('.claude/project-context.md');
+            if (aiContextOptions?.claudeSkills)
+                aiFiles.push('.claude/skills/');
+            if (aiFiles.length > 0) {
+                console.log(chalk_1.default.gray(`  Would generate: ${aiFiles.join(', ')}`));
+            }
+            else {
+                console.log(chalk_1.default.gray('  No AI context files selected'));
+            }
+        }
+        console.log(chalk_1.default.green('✅ AI context files generated'));
+        // Step 5/5: Validating project
+        console.log(chalk_1.default.blue('\n✅ Step 5/5: Validating project...'));
+        if (!isDryRun) {
+            await (0, utils_1.validateGeneratedProject)(projectPath);
+            // Validate translation files
+            const { validateTranslationFiles } = await Promise.resolve().then(() => __importStar(require('./utils')));
+            await validateTranslationFiles(projectPath);
+            console.log(chalk_1.default.green('✅ Project validation passed'));
+        }
+        else {
+            console.log(chalk_1.default.gray('  Would validate: package.json, tsconfig.json, required directories'));
+            console.log(chalk_1.default.green('✅ Validation would pass'));
+        }
+        if (isDryRun) {
+            console.log(chalk_1.default.green(`\n✅ Dry-run completed successfully!`));
+            console.log(chalk_1.default.cyan(`\n📊 Preview Summary:`));
+            console.log(chalk_1.default.white(`  Project name: ${projectName}`));
+            console.log(chalk_1.default.white(`  Location: ${projectPath}`));
+            if (aiContextOptions) {
+                const aiFiles = [];
+                if (aiContextOptions.cursorrules)
+                    aiFiles.push('.cursorrules');
+                if (aiContextOptions.aiContext)
+                    aiFiles.push('ai-context.md');
+                if (aiContextOptions.claudeContext)
+                    aiFiles.push('.claude/project-context.md');
+                if (aiContextOptions.claudeSkills)
+                    aiFiles.push('.claude/skills/');
+                console.log(chalk_1.default.white(`  AI Context: ${aiFiles.length > 0 ? aiFiles.join(', ') : 'None'}`));
+                console.log(chalk_1.default.white(`  Language: ${aiContextOptions.language}`));
+            }
+            console.log(chalk_1.default.cyan(`\n💡 Run without --dry-run to create the project`));
+            return;
+        }
+        // Generate and display summary
+        const { generateSummary, displaySummary, displayNextSteps } = await Promise.resolve().then(() => __importStar(require('./utils')));
+        const summary = await generateSummary(projectPath, aiContextOptions);
+        console.log(chalk_1.default.green(`\n✅ Project created successfully!`));
+        displaySummary(summary);
+        displayNextSteps(projectPath, aiContextOptions);
+    }
+    catch (error) {
+        // Log error details
+        const isEn = process.env.LANG === 'en' || process.env.CLI_LANG === 'en' || process.argv.includes('--english-only');
+        console.error(chalk_1.default.red(`\n❌ ${isEn ? 'Error creating project' : '프로젝트 생성 중 오류 발생'}:`));
+        if (error instanceof Error) {
+            console.error(chalk_1.default.red(error.message));
+        }
+        else {
+            console.error(error);
+        }
+        // Cleanup on error
+        if (!isDryRun && await fs.pathExists(projectPath)) {
+            console.log(chalk_1.default.yellow('\n🧹 Cleaning up...'));
+            await fs.remove(projectPath);
+        }
+        throw error;
+    }
+}

package/dist/doctor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * create-hua-ux - Doctor Command
+ *
+ * Diagnoses project health and provides solutions
+ */
+/**
+ * Diagnose project health
+ */
+export declare function diagnoseProject(projectPath: string): Promise<{
+    healthy: boolean;
+    issues: Array<{
+        type: 'error' | 'warning';
+        message: string;
+        solution?: string;
+    }>;
+}>;
+/**
+ * Run doctor command
+ */
+export declare function runDoctor(projectPath: string): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAClE,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClF,CAAC,CAgJD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2DlE"}