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

package/dist/framework/components/WelcomePage.js

@@ -0,0 +1,80 @@
+/**
+ * @hua-labs/hua-ux/framework - WelcomePage
+ *
+ * Default welcome page component for new projects
+ * Similar to Next.js default welcome page
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { HuaUxPage } from './HuaUxPage';
+import { Button, Card, Badge } from '@hua-labs/ui';
+import { useTranslation } from '@hua-labs/i18n-core';
+/**
+ * WelcomePage Component
+ *
+ * Default welcome page for new hua-ux projects.
+ * Displays project information, framework features, and quick links.
+ *
+ * @example
+ * ```tsx
+ * // app/page.tsx
+ * import { WelcomePage } from '@hua-labs/hua-ux/framework';
+ *
+ * export default function HomePage() {
+ *   return <WelcomePage projectName="My App" />;
+ * }
+ * ```
+ */
+export function WelcomePage({ projectName = 'My App', showFeatures = true, showQuickLinks = true, children, ...pageProps }) {
+    const { t, currentLanguage } = useTranslation();
+    const features = [
+        {
+            title: t('features.ui.title', 'UI Components'),
+            description: t('features.ui.description', 'Pre-built, accessible components'),
+            icon: '🎨',
+        },
+        {
+            title: t('features.i18n.title', 'i18n Support'),
+            description: t('features.i18n.description', 'Multi-language support out of the box'),
+            icon: '🌐',
+        },
+        {
+            title: t('features.motion.title', 'Motion'),
+            description: t('features.motion.description', 'Smooth animations and transitions'),
+            icon: '✨',
+        },
+        {
+            title: t('features.ai.title', 'AI-First'),
+            description: t('features.ai.description', 'Built for vibe coding with AI'),
+            icon: '🤖',
+        },
+    ];
+    const quickLinks = [
+        {
+            title: t('links.docs.title', 'Documentation'),
+            description: t('links.docs.description', 'Learn more about hua-ux'),
+            href: 'https://github.com/HUA-Labs/HUA-Labs-public',
+            external: true,
+        },
+        {
+            title: t('links.examples.title', 'Examples'),
+            description: t('links.examples.description', 'See examples and patterns'),
+            href: '/examples',
+            external: false,
+        },
+        {
+            title: t('links.github.title', 'GitHub'),
+            description: t('links.github.description', 'View source code'),
+            href: 'https://github.com/HUA-Labs/HUA-Labs-public',
+            external: true,
+        },
+    ];
+    return (_jsx(HuaUxPage, { title: t('welcome.title', 'Welcome'), description: t('welcome.description', `Get started by editing app/page.tsx`), vibe: "clean", ...pageProps, children: _jsx("div", { className: "min-h-screen flex flex-col items-center justify-center p-8 bg-gradient-to-br from-gray-50 to-gray-100 dark:from-gray-900 dark:to-gray-800", children: _jsxs("div", { className: "max-w-4xl w-full space-y-8", children: [_jsxs("div", { className: "text-center space-y-4", children: [_jsxs("div", { className: "flex items-center justify-center gap-3", children: [_jsx("h1", { className: "text-5xl font-bold bg-gradient-to-r from-blue-600 to-purple-600 bg-clip-text text-transparent", children: projectName }), _jsx(Badge, { variant: "secondary", className: "text-sm", children: t('badge.alpha', 'Alpha') })] }), _jsx("p", { className: "text-xl text-gray-600 dark:text-gray-400", children: t('welcome.subtitle', 'Built with @hua-labs/hua-ux') }), _jsx("p", { className: "text-gray-500 dark:text-gray-500", children: t('welcome.description', 'Get started by editing app/page.tsx') })] }), children && (_jsx("div", { className: "flex justify-center", children: children })), showFeatures && (_jsx("div", { className: "grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 gap-4", children: features.map((feature, index) => (_jsx(Card, { className: "p-6 hover:shadow-lg transition-shadow cursor-pointer", children: _jsxs("div", { className: "space-y-2", children: [_jsx("div", { className: "text-3xl mb-2", children: feature.icon }), _jsx("h3", { className: "font-semibold text-lg", children: feature.title }), _jsx("p", { className: "text-sm text-gray-600 dark:text-gray-400", children: feature.description })] }) }, index))) })), showQuickLinks && (_jsx("div", { className: "grid grid-cols-1 md:grid-cols-3 gap-4", children: quickLinks.map((link, index) => (_jsx(Card, { className: "p-6 hover:shadow-lg transition-shadow", children: _jsxs("div", { className: "space-y-2", children: [_jsx("h3", { className: "font-semibold text-lg", children: link.title }), _jsx("p", { className: "text-sm text-gray-600 dark:text-gray-400", children: link.description }), _jsxs(Button, { variant: "outline", size: "sm", className: "mt-4", onClick: () => {
+                                            if (link.external) {
+                                                window.open(link.href, '_blank', 'noopener,noreferrer');
+                                            }
+                                            else {
+                                                window.location.href = link.href;
+                                            }
+                                        }, children: [t('links.visit', 'Visit'), " \u2192"] })] }) }, index))) })), _jsxs("div", { className: "text-center text-sm text-gray-500 dark:text-gray-400 space-y-2", children: [_jsxs("p", { children: [t('footer.language', 'Language'), ": ", _jsx("strong", { children: currentLanguage })] }), _jsxs("p", { children: [t('footer.framework', 'Framework'), ": ", _jsx("strong", { children: "@hua-labs/hua-ux" })] })] })] }) }) }));
+}

package/dist/framework/config/index.d.ts

@@ -0,0 +1,182 @@
+/**
+ * @hua-labs/hua-ux/framework - Config System
+ *
+ * Configuration loading and management
+ */
+import type { HuaUxConfig } from '../types';
+/**
+ * 프레임워크 설정 정의 / Define framework configuration
+ *
+ * IntelliSense를 완벽히 지원하는 설정 함수입니다.
+ * Provides full IntelliSense support for configuration options.
+ *
+ * 모든 옵션은 선택사항이며 기본값 또는 Preset과 병합됩니다.
+ * All options are optional and will be merged with defaults or Preset.
+ *
+ * **Zero-Config**: 설정 파일이 없어도 기본값으로 동작합니다.
+ * **Zero-Config**: Works with defaults even without a config file.
+ *
+ * **Preset 우선**: `preset: 'product'`만 지정해도 대부분의 설정이 자동 적용됩니다.
+ * **Preset First**: Just specify `preset: 'product'` and most settings are auto-applied.
+ *
+ * **바이브 코딩 친화적**: AI가 이해하기 쉬운 한글 주석과 명사 중심 설정
+ * **Vibe Coding Friendly**: Korean comments and noun-centered settings for AI understanding
+ *
+ * @param config - 설정 객체 / Configuration object
+ * @param config.preset - 사용할 프리셋 / Preset to use
+ *   - **바이브 모드 (간단) / Vibe mode (simple)**: `'product' | 'marketing'`
+ *     - 'product': 제품 페이지용 (전문적, 효율적, 기본값) / Product pages (professional, efficient, default)
+ *     - 'marketing': 마케팅 페이지용 (화려함, 눈에 띄는) / Marketing pages (dramatic, eye-catching)
+ *   - **개발자 모드 (세부 설정) / Developer mode (detailed)**: `{ type: 'product' | 'marketing', motion?: {...}, spacing?: {...} }`
+ *     - 세부 설정을 포함한 Preset 객체 / Preset object with detailed settings
+ *   - Preset을 선택하면 motion, spacing, i18n 등이 자동 설정됩니다.
+ *   - Selecting a preset automatically configures motion, spacing, i18n, etc.
+ * @param config.i18n - 다국어 설정 / Internationalization settings
+ * @param config.i18n.defaultLanguage - 기본 언어 코드 (예: 'ko', 'en') / Default language code (e.g., 'ko', 'en')
+ * @param config.i18n.supportedLanguages - 지원하는 언어 코드 배열 / Array of supported language codes
+ * @param config.i18n.namespaces - 로드할 번역 네임스페이스 / Translation namespaces to load
+ * @param config.i18n.translationLoader - 번역 로딩 전략 ('static' | 'api') / Translation loading strategy
+ * @param config.i18n.translationApiPath - 번역 API 경로 ('api' 로더 사용 시) / API path for translations
+ * @param config.motion - 모션/애니메이션 설정 / Motion/animation settings
+ * @param config.motion.style - 모션 스타일 (바이브 코더용) / Motion style (for vibe coders)
+ *   - 'smooth': 부드러운 전환 / Smooth transitions
+ *   - 'dramatic': 드라마틱한 전환 / Dramatic transitions
+ *   - 'minimal': 최소한의 전환 / Minimal transitions
+ * @param config.motion.defaultPreset - 기본 모션 프리셋 (개발자용) / Default motion preset (for developers)
+ *   - 'product': 빠른 전환, 최소 딜레이 / Fast transitions, minimal delay
+ *   - 'marketing': 느린 전환, 긴 딜레이 / Slow transitions, long delay
+ * @param config.motion.enableAnimations - 전역 애니메이션 활성화 여부 / Enable animations globally
+ * @param config.motion.duration - 애니메이션 지속 시간 (밀리초, 개발자용) / Animation duration in milliseconds (for developers)
+ * @param config.motion.easing - 애니메이션 이징 함수 (개발자용) / Animation easing function (for developers)
+ * @param config.state - 상태 관리 설정 / State management settings
+ * @param config.state.persist - localStorage 영속성 활성화 여부 / Enable localStorage persistence
+ * @param config.state.ssr - SSR 지원 활성화 여부 / Enable SSR support
+ * @param config.branding - 브랜딩 설정 (화이트 라벨링) / Branding settings (white labeling)
+ * @param config.branding.name - 회사/서비스 이름 / Company/service name
+ * @param config.branding.logo - 로고 경로 / Logo path
+ * @param config.branding.colors - 색상 팔레트 (primary, secondary, accent 등) / Color palette
+ * @param config.branding.typography - 타이포그래피 설정 (fontFamily, fontSize 등) / Typography settings
+ *
+ * @returns 검증된 설정 객체 / Validated configuration object
+ *
+ * @example
+ * ```ts
+ * // 최소 설정 (Preset만) - 바이브 코더용
+ * // hua-ux.config.ts
+ * import { defineConfig } from '@hua-labs/hua-ux/framework';
+ *
+ * export default defineConfig({
+ *   preset: 'product',  // 끝! 나머지는 자동 설정
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Preset + 일부 커스터마이징
+ * export default defineConfig({
+ *   preset: 'product',
+ *   i18n: {
+ *     supportedLanguages: ['ko', 'en', 'ja'],  // 언어만 추가
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 개발자 모드: Preset 객체 형태 (세부 설정)
+ * export default defineConfig({
+ *   preset: {
+ *     type: 'product',
+ *     motion: { duration: 300 },
+ *     spacing: { default: 'md' },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 바이브 코더용: motion.style 사용
+ * export default defineConfig({
+ *   preset: 'product',
+ *   motion: {
+ *     style: 'smooth',  // 명사 중심, 이해하기 쉬움
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 완전 커스터마이징 (Preset 없이) - 전통 개발자용
+ * export default defineConfig({
+ *   i18n: {
+ *     defaultLanguage: 'ko',
+ *     supportedLanguages: ['ko', 'en'],
+ *     namespaces: ['common'],
+ *     translationLoader: 'api',
+ *     translationApiPath: '/api/translations',
+ *   },
+ *   motion: {
+ *     defaultPreset: 'product',
+ *     enableAnimations: true,
+ *   },
+ *   state: {
+ *     persist: true,
+ *     ssr: true,
+ *   },
+ * });
+ * ```
+ */
+export declare function defineConfig(config: Partial<HuaUxConfig>): HuaUxConfig;
+/**
+ * Load configuration from file
+ *
+ * 동적으로 설정 파일을 로드합니다.
+ *
+ * **로드 순서**:
+ * 1. `hua-ux.config.ts` 시도 (TypeScript)
+ * 2. `hua-ux.config.js` 시도 (JavaScript)
+ * 3. 없으면 기본값 (product preset)
+ *
+ * **Zero-Config**: 설정 파일이 없어도 기본값으로 동작합니다.
+ *
+ * **주의사항**:
+ * - 이 함수는 Node.js 환경(빌드 타임)에서만 동작합니다.
+ * - 런타임에서는 캐시된 설정을 사용합니다.
+ * - **권장**: 설정 파일을 명시적으로 import하여 타입 안전성을 보장하세요.
+ *   ```ts
+ *   // hua-ux.config.ts
+ *   import { defineConfig } from '@hua-labs/hua-ux/framework';
+ *   export default defineConfig({ preset: 'product' });
+ *
+ *   // app/layout.tsx 또는 다른 서버 컴포넌트에서
+ *   import config from '../hua-ux.config';
+ *   import { setConfig } from '@hua-labs/hua-ux/framework';
+ *   setConfig(config);
+ *   ```
+ *
+ * **Fallback 용도**: 이 함수는 설정 파일이 명시적으로 import되지 않은 경우에만 사용됩니다.
+ * 프로덕션 환경에서는 설정 파일을 명시적으로 import하는 것을 권장합니다.
+ */
+export declare function loadConfig(): HuaUxConfig;
+/**
+ * Get current configuration
+ *
+ * 캐시된 설정을 반환하거나, 없으면 로드합니다.
+ *
+ * **클라이언트 안전**: 클라이언트에서는 항상 기본값을 반환합니다.
+ * **Client Safe**: Always returns default config on client side.
+ */
+export declare function getConfig(): HuaUxConfig;
+/**
+ * Set configuration (for testing or manual override)
+ *
+ * 테스트나 수동 오버라이드를 위한 설정 설정 함수
+ */
+export declare function setConfig(config: HuaUxConfig): void;
+/**
+ * Reset configuration cache
+ *
+ * 설정 캐시를 초기화합니다. (주로 테스트용)
+ */
+export declare function resetConfig(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/framework/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/framework/config/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAU,MAAM,UAAU,CAAC;AAWpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyHG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAyCtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,UAAU,IAAI,WAAW,CA4FxC;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,WAAW,CAgBvC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEnD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/framework/config/index.js

@@ -0,0 +1,329 @@
+/**
+ * @hua-labs/hua-ux/framework - Config System
+ *
+ * Configuration loading and management
+ */
+import { validateConfig } from './schema';
+import { mergePresetWithConfig, createConfigFromUserConfig } from './merge';
+import { initLicense } from '../license';
+import { pluginRegistry } from '../plugins';
+/**
+ * Global config cache
+ */
+let cachedConfig = null;
+/**
+ * 프레임워크 설정 정의 / Define framework configuration
+ *
+ * IntelliSense를 완벽히 지원하는 설정 함수입니다.
+ * Provides full IntelliSense support for configuration options.
+ *
+ * 모든 옵션은 선택사항이며 기본값 또는 Preset과 병합됩니다.
+ * All options are optional and will be merged with defaults or Preset.
+ *
+ * **Zero-Config**: 설정 파일이 없어도 기본값으로 동작합니다.
+ * **Zero-Config**: Works with defaults even without a config file.
+ *
+ * **Preset 우선**: `preset: 'product'`만 지정해도 대부분의 설정이 자동 적용됩니다.
+ * **Preset First**: Just specify `preset: 'product'` and most settings are auto-applied.
+ *
+ * **바이브 코딩 친화적**: AI가 이해하기 쉬운 한글 주석과 명사 중심 설정
+ * **Vibe Coding Friendly**: Korean comments and noun-centered settings for AI understanding
+ *
+ * @param config - 설정 객체 / Configuration object
+ * @param config.preset - 사용할 프리셋 / Preset to use
+ *   - **바이브 모드 (간단) / Vibe mode (simple)**: `'product' | 'marketing'`
+ *     - 'product': 제품 페이지용 (전문적, 효율적, 기본값) / Product pages (professional, efficient, default)
+ *     - 'marketing': 마케팅 페이지용 (화려함, 눈에 띄는) / Marketing pages (dramatic, eye-catching)
+ *   - **개발자 모드 (세부 설정) / Developer mode (detailed)**: `{ type: 'product' | 'marketing', motion?: {...}, spacing?: {...} }`
+ *     - 세부 설정을 포함한 Preset 객체 / Preset object with detailed settings
+ *   - Preset을 선택하면 motion, spacing, i18n 등이 자동 설정됩니다.
+ *   - Selecting a preset automatically configures motion, spacing, i18n, etc.
+ * @param config.i18n - 다국어 설정 / Internationalization settings
+ * @param config.i18n.defaultLanguage - 기본 언어 코드 (예: 'ko', 'en') / Default language code (e.g., 'ko', 'en')
+ * @param config.i18n.supportedLanguages - 지원하는 언어 코드 배열 / Array of supported language codes
+ * @param config.i18n.namespaces - 로드할 번역 네임스페이스 / Translation namespaces to load
+ * @param config.i18n.translationLoader - 번역 로딩 전략 ('static' | 'api') / Translation loading strategy
+ * @param config.i18n.translationApiPath - 번역 API 경로 ('api' 로더 사용 시) / API path for translations
+ * @param config.motion - 모션/애니메이션 설정 / Motion/animation settings
+ * @param config.motion.style - 모션 스타일 (바이브 코더용) / Motion style (for vibe coders)
+ *   - 'smooth': 부드러운 전환 / Smooth transitions
+ *   - 'dramatic': 드라마틱한 전환 / Dramatic transitions
+ *   - 'minimal': 최소한의 전환 / Minimal transitions
+ * @param config.motion.defaultPreset - 기본 모션 프리셋 (개발자용) / Default motion preset (for developers)
+ *   - 'product': 빠른 전환, 최소 딜레이 / Fast transitions, minimal delay
+ *   - 'marketing': 느린 전환, 긴 딜레이 / Slow transitions, long delay
+ * @param config.motion.enableAnimations - 전역 애니메이션 활성화 여부 / Enable animations globally
+ * @param config.motion.duration - 애니메이션 지속 시간 (밀리초, 개발자용) / Animation duration in milliseconds (for developers)
+ * @param config.motion.easing - 애니메이션 이징 함수 (개발자용) / Animation easing function (for developers)
+ * @param config.state - 상태 관리 설정 / State management settings
+ * @param config.state.persist - localStorage 영속성 활성화 여부 / Enable localStorage persistence
+ * @param config.state.ssr - SSR 지원 활성화 여부 / Enable SSR support
+ * @param config.branding - 브랜딩 설정 (화이트 라벨링) / Branding settings (white labeling)
+ * @param config.branding.name - 회사/서비스 이름 / Company/service name
+ * @param config.branding.logo - 로고 경로 / Logo path
+ * @param config.branding.colors - 색상 팔레트 (primary, secondary, accent 등) / Color palette
+ * @param config.branding.typography - 타이포그래피 설정 (fontFamily, fontSize 등) / Typography settings
+ *
+ * @returns 검증된 설정 객체 / Validated configuration object
+ *
+ * @example
+ * ```ts
+ * // 최소 설정 (Preset만) - 바이브 코더용
+ * // hua-ux.config.ts
+ * import { defineConfig } from '@hua-labs/hua-ux/framework';
+ *
+ * export default defineConfig({
+ *   preset: 'product',  // 끝! 나머지는 자동 설정
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Preset + 일부 커스터마이징
+ * export default defineConfig({
+ *   preset: 'product',
+ *   i18n: {
+ *     supportedLanguages: ['ko', 'en', 'ja'],  // 언어만 추가
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 개발자 모드: Preset 객체 형태 (세부 설정)
+ * export default defineConfig({
+ *   preset: {
+ *     type: 'product',
+ *     motion: { duration: 300 },
+ *     spacing: { default: 'md' },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 바이브 코더용: motion.style 사용
+ * export default defineConfig({
+ *   preset: 'product',
+ *   motion: {
+ *     style: 'smooth',  // 명사 중심, 이해하기 쉬움
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * ```ts
+ * // 완전 커스터마이징 (Preset 없이) - 전통 개발자용
+ * export default defineConfig({
+ *   i18n: {
+ *     defaultLanguage: 'ko',
+ *     supportedLanguages: ['ko', 'en'],
+ *     namespaces: ['common'],
+ *     translationLoader: 'api',
+ *     translationApiPath: '/api/translations',
+ *   },
+ *   motion: {
+ *     defaultPreset: 'product',
+ *     enableAnimations: true,
+ *   },
+ *   state: {
+ *     persist: true,
+ *     ssr: true,
+ *   },
+ * });
+ * ```
+ */
+export function defineConfig(config) {
+    // 라이선스 초기화
+    if (config.license) {
+        initLicense(config.license);
+    }
+    // 플러그인 등록 및 초기화
+    if (config.plugins && config.plugins.length > 0) {
+        config.plugins.forEach(plugin => {
+            pluginRegistry.register(plugin);
+        });
+    }
+    // Preset이 지정된 경우 Preset과 병합
+    if (config.preset) {
+        const { preset, ...userConfig } = config;
+        const merged = mergePresetWithConfig(preset, userConfig);
+        const validated = validateConfig(merged);
+        // 플러그인 초기화 (설정이 완료된 후)
+        if (config.plugins && config.plugins.length > 0) {
+            pluginRegistry.initializeAll(validated).catch((error) => {
+                console.error('[hua-ux] Plugin initialization error:', error);
+            });
+        }
+        return validated;
+    }
+    // Preset이 없는 경우 사용자 설정만 사용
+    const merged = createConfigFromUserConfig(config);
+    const validated = validateConfig(merged);
+    // 플러그인 초기화 (설정이 완료된 후)
+    if (config.plugins && config.plugins.length > 0) {
+        pluginRegistry.initializeAll(validated).catch((error) => {
+            console.error('[hua-ux] Plugin initialization error:', error);
+        });
+    }
+    return validated;
+}
+/**
+ * Load configuration from file
+ *
+ * 동적으로 설정 파일을 로드합니다.
+ *
+ * **로드 순서**:
+ * 1. `hua-ux.config.ts` 시도 (TypeScript)
+ * 2. `hua-ux.config.js` 시도 (JavaScript)
+ * 3. 없으면 기본값 (product preset)
+ *
+ * **Zero-Config**: 설정 파일이 없어도 기본값으로 동작합니다.
+ *
+ * **주의사항**:
+ * - 이 함수는 Node.js 환경(빌드 타임)에서만 동작합니다.
+ * - 런타임에서는 캐시된 설정을 사용합니다.
+ * - **권장**: 설정 파일을 명시적으로 import하여 타입 안전성을 보장하세요.
+ *   ```ts
+ *   // hua-ux.config.ts
+ *   import { defineConfig } from '@hua-labs/hua-ux/framework';
+ *   export default defineConfig({ preset: 'product' });
+ *
+ *   // app/layout.tsx 또는 다른 서버 컴포넌트에서
+ *   import config from '../hua-ux.config';
+ *   import { setConfig } from '@hua-labs/hua-ux/framework';
+ *   setConfig(config);
+ *   ```
+ *
+ * **Fallback 용도**: 이 함수는 설정 파일이 명시적으로 import되지 않은 경우에만 사용됩니다.
+ * 프로덕션 환경에서는 설정 파일을 명시적으로 import하는 것을 권장합니다.
+ */
+export function loadConfig() {
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    // Node.js 환경에서만 동적 로드 시도 (서버 사이드에서만)
+    // 클라이언트에서는 기본 설정 반환
+    if (typeof window !== 'undefined') {
+        // 브라우저 환경: 기본 설정 반환
+        cachedConfig = mergePresetWithConfig('product', {});
+        return cachedConfig;
+    }
+    // Node.js 환경에서만 동적 로드 시도
+    if (typeof process !== 'undefined' && process.cwd && typeof require !== 'undefined') {
+        try {
+            const fs = require('fs');
+            const path = require('path');
+            const projectRoot = process.cwd();
+            // 설정 파일 경로 후보
+            const configPaths = [
+                path.join(projectRoot, 'hua-ux.config.ts'),
+                path.join(projectRoot, 'hua-ux.config.js'),
+                path.join(projectRoot, 'hua-ux.config.mjs'),
+            ];
+            // 첫 번째로 발견된 설정 파일 사용
+            // 
+            // ⚠️ 주의: 이 코드는 Fallback 용도입니다.
+            // 권장 방법: 설정 파일을 명시적으로 import하여 타입 안전성을 보장하세요.
+            // 
+            // Next.js 빌드 시 동적 require는 경고를 발생시킬 수 있지만,
+            // 런타임에서는 정상 작동합니다. 설정 파일은 보통 빌드 타임에 처리되므로
+            // 이 코드는 주로 개발 환경에서 사용됩니다.
+            // 
+            // 실제 프로덕션에서는 설정 파일을 명시적으로 import하는 것을 권장합니다:
+            // ```ts
+            // import config from './hua-ux.config';
+            // import { setConfig } from '@hua-labs/hua-ux/framework';
+            // setConfig(config);
+            // ```
+            for (const configPath of configPaths) {
+                if (fs.existsSync(configPath)) {
+                    try {
+                        // 동적 require는 Next.js 빌드 시 경고를 발생시킬 수 있지만
+                        // 런타임에서는 정상 작동합니다.
+                        // 실제 프로덕션에서는 설정 파일이 이미 import되어 있으므로
+                        // 이 경로는 거의 사용되지 않습니다.
+                        if (typeof require !== 'undefined' && typeof require.resolve === 'function') {
+                            try {
+                                // webpackIgnore 주석으로 Next.js 빌드 시 무시하도록 시도
+                                // @ts-ignore - 동적 require는 타입 체크를 통과하지 못함
+                                // eslint-disable-next-line @typescript-eslint/no-require-imports
+                                // ⚠️ Fallback 용도: 명시적 import를 권장합니다.
+                                const configModule = require(/* webpackIgnore: true */ configPath);
+                                const userConfig = configModule.default || configModule;
+                                // Preset 병합 처리
+                                if (userConfig && typeof userConfig === 'object') {
+                                    if (userConfig.preset) {
+                                        const { preset, ...rest } = userConfig;
+                                        cachedConfig = mergePresetWithConfig(preset, rest);
+                                    }
+                                    else {
+                                        cachedConfig = createConfigFromUserConfig(userConfig);
+                                    }
+                                    cachedConfig = validateConfig(cachedConfig);
+                                    return cachedConfig;
+                                }
+                            }
+                            catch (requireError) {
+                                // require 실패 (TypeScript 파일 등)
+                                // 기본값 사용
+                                break;
+                            }
+                        }
+                    }
+                    catch (fileError) {
+                        // 파일 읽기 실패
+                        continue;
+                    }
+                }
+            }
+        }
+        catch (error) {
+            // fs, path 등이 없는 환경 (브라우저, Edge Runtime 등)
+            // 기본값 사용
+        }
+    }
+    // 기본값 (product preset)
+    // 설정 파일이 없거나 로드 실패 시
+    cachedConfig = mergePresetWithConfig('product', {});
+    return cachedConfig;
+}
+/**
+ * Get current configuration
+ *
+ * 캐시된 설정을 반환하거나, 없으면 로드합니다.
+ *
+ * **클라이언트 안전**: 클라이언트에서는 항상 기본값을 반환합니다.
+ * **Client Safe**: Always returns default config on client side.
+ */
+export function getConfig() {
+    // 캐시된 설정이 있으면 반환
+    if (cachedConfig) {
+        return cachedConfig;
+    }
+    // 클라이언트 환경에서는 loadConfig를 호출하지 않고 기본값 반환
+    // (loadConfig는 서버 전용이며 fs 모듈을 사용함)
+    // 단, setConfig로 설정된 경우는 캐시를 우선 사용
+    if (typeof window !== 'undefined') {
+        cachedConfig = mergePresetWithConfig('product', {});
+        return cachedConfig;
+    }
+    // 서버 환경에서만 loadConfig 호출
+    return loadConfig();
+}
+/**
+ * Set configuration (for testing or manual override)
+ *
+ * 테스트나 수동 오버라이드를 위한 설정 설정 함수
+ */
+export function setConfig(config) {
+    cachedConfig = validateConfig(config);
+}
+/**
+ * Reset configuration cache
+ *
+ * 설정 캐시를 초기화합니다. (주로 테스트용)
+ */
+export function resetConfig() {
+    cachedConfig = null;
+}

package/dist/framework/config/merge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @hua-labs/hua-ux/framework - Config Merge
+ *
+ * Preset 병합 및 깊은 병합 로직
+ */
+import type { HuaUxConfig, Preset } from '../types';
+/**
+ * Preset과 사용자 설정 병합
+ *
+ * 1. Preset 기본값 로드
+ * 2. Preset 설정 오버라이드 (개발자 모드인 경우)
+ * 3. 사용자 설정으로 병합 (사용자 설정 우선)
+ * 4. 최종 검증
+ *
+ * @param preset - 사용할 Preset (문자열 또는 객체)
+ * @param userConfig - 사용자 설정 (선택적)
+ * @returns 병합된 설정
+ */
+export declare function mergePresetWithConfig(preset: Preset, userConfig?: Partial<HuaUxConfig>): HuaUxConfig;
+/**
+ * Preset 없이 사용자 설정만으로 Config 생성
+ *
+ * Preset을 사용하지 않고 모든 설정을 직접 지정하는 경우
+ */
+export declare function createConfigFromUserConfig(userConfig: Partial<HuaUxConfig>): HuaUxConfig;
+//# sourceMappingURL=merge.d.ts.map

package/dist/framework/config/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../../src/framework/config/merge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAA4B,MAAM,UAAU,CAAC;AAqE9E;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAChC,WAAW,CAiEb;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,OAAO,CAAC,WAAW,CAAC,GAC/B,WAAW,CAyBb"}