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

package/dist/framework/components/BrandedCard.js

@@ -0,0 +1,73 @@
+/**
+ * @hua-labs/hua-ux/framework - BrandedCard
+ *
+ * Card 컴포넌트에 branding을 자동으로 적용하는 wrapper
+ * Wrapper that automatically applies branding to Card component
+ *
+ * CSS 변수를 사용하여 Tailwind의 최적화를 활용합니다.
+ * Uses CSS variables to leverage Tailwind's optimization.
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { Card, merge } from '@hua-labs/ui';
+import { useBranding } from '../branding/context';
+/**
+ * BrandedCard Component
+ *
+ * Card 컴포넌트에 branding 설정을 자동으로 적용합니다.
+ * Automatically applies branding configuration to Card component.
+ *
+ * **자동 적용되는 branding**:
+ * - Accent 색상: `variant="outline"`일 때 `border-[var(--color-accent)]` 사용
+ * - Primary 색상: `variant="default"`일 때 `bg-[var(--color-primary)]/5` 사용
+ *
+ * **Auto-applied branding**:
+ * - Accent color: Uses `border-[var(--color-accent)]` when `variant="outline"`
+ * - Primary color: Uses `bg-[var(--color-primary)]/5` when `variant="default"`
+ *
+ * **CSS 변수 방식의 장점**:
+ * - Tailwind의 JIT 컴파일러 최적화 활용
+ * - 인라인 스타일 없이 깔끔한 코드
+ * - 런타임에 동적으로 색상 변경 가능
+ *
+ * **Advantages of CSS variables**:
+ * - Leverages Tailwind's JIT compiler optimization
+ * - Clean code without inline styles
+ * - Dynamic color changes at runtime
+ *
+ * @example
+ * ```tsx
+ * // branding 설정이 있으면 자동으로 색상 적용
+ * // Automatically applies colors if branding is configured
+ * <BrandedCard variant="outline">
+ *   <CardContent>내용</CardContent>
+ * </BrandedCard>
+ *
+ * // branding이 없으면 기본 Card와 동일하게 동작
+ * // Works same as default Card if branding is not configured
+ * <BrandedCard variant="elevated">
+ *   <CardContent>내용</CardContent>
+ * </BrandedCard>
+ * ```
+ */
+export const BrandedCard = React.forwardRef(({ variant = 'default', className, ...props }, ref) => {
+    const branding = useBranding();
+    // Branding 색상이 있으면 Tailwind arbitrary values 사용
+    // Use Tailwind arbitrary values if branding colors exist
+    let brandingClasses = '';
+    if (branding?.colors) {
+        if (variant === 'outline' && branding.colors.accent) {
+            // Accent 색상을 테두리로 사용
+            // Use accent color as border
+            brandingClasses = 'border-[var(--color-accent)]';
+        }
+        else if (variant === 'default' && branding.colors.primary) {
+            // Primary 색상의 약간의 tint를 배경에 적용
+            // Apply slight tint of primary color to background
+            brandingClasses = 'bg-[var(--color-primary)]/5';
+        }
+    }
+    return (_jsx(Card, { ref: ref, variant: variant, className: merge(brandingClasses, className), ...props }));
+});
+BrandedCard.displayName = 'BrandedCard';

package/dist/framework/components/ErrorBoundary.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @hua-labs/hua-ux/framework - ErrorBoundary
+ *
+ * React Error Boundary component for catching and handling errors
+ */
+import { Component, ReactNode, ErrorInfo } from 'react';
+/**
+ * Global error reporter interface
+ *
+ * 프로덕션 환경에서 에러 리포팅 서비스(Sentry, LogRocket 등)와 통합하기 위한 인터페이스
+ * Interface for integrating with error reporting services (Sentry, LogRocket, etc.) in production
+ *
+ * @example
+ * ```ts
+ * // Sentry 통합 예시
+ * window.__ERROR_REPORTER__ = (error, errorInfo) => {
+ *   Sentry.captureException(error, {
+ *     contexts: { react: errorInfo },
+ *   });
+ * };
+ * ```
+ */
+declare global {
+    interface Window {
+        __ERROR_REPORTER__?: (error: Error, errorInfo: ErrorInfo) => void;
+    }
+}
+/**
+ * Error Boundary Props
+ */
+export interface ErrorBoundaryProps {
+    /**
+     * Children to render
+     */
+    children: ReactNode;
+    /**
+     * Fallback UI to show when error occurs
+     * Can be a ReactNode or a function that receives error and reset callback
+     */
+    fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
+    /**
+     * Callback when error is caught
+     */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /**
+     * Custom error filter - return true to catch, false to rethrow
+     */
+    onReset?: () => void;
+}
+/**
+ * Error Boundary State
+ */
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Error Boundary Component
+ *
+ * Catches JavaScript errors anywhere in the child component tree,
+ * logs those errors, and displays a fallback UI.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary fallback={<div>Something went wrong</div>}>
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary
+ *   fallback={(error, reset) => (
+ *     <div>
+ *       <h1>Error: {error.message}</h1>
+ *       <button onClick={reset}>Try again</button>
+ *     </div>
+ *   )}
+ * >
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    reset: () => void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/framework/components/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/framework/components/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAc,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE/D;;;;;;;;;;;;;;;GAeG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;KACnE;CACF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,SAAS,CAAC,CAAC;IAExE;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IAEvD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAyDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAKjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IA4B3D,KAAK,QAAO,IAAI,CAMd;IAEF,MAAM,IAAI,SAAS;CAmBpB"}

package/dist/framework/components/ErrorBoundary.js

@@ -0,0 +1,121 @@
+/**
+ * @hua-labs/hua-ux/framework - ErrorBoundary
+ *
+ * React Error Boundary component for catching and handling errors
+ */
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from 'react';
+/**
+ * Default fallback UI
+ */
+function DefaultFallback({ error, reset }) {
+    return (_jsxs("div", { role: "alert", style: {
+            padding: '2rem',
+            margin: '2rem auto',
+            maxWidth: '600px',
+            border: '1px solid #ef4444',
+            borderRadius: '0.5rem',
+            backgroundColor: '#fef2f2',
+            color: '#991b1b',
+        }, children: [_jsx("h2", { style: { fontSize: '1.5rem', fontWeight: 'bold', marginBottom: '1rem' }, children: "\u26A0\uFE0F \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4 / An error occurred" }), _jsxs("details", { style: { marginBottom: '1rem' }, children: [_jsx("summary", { style: { cursor: 'pointer', fontWeight: 500 }, children: "\uC5D0\uB7EC \uC0C1\uC138 \uC815\uBCF4 / Error details" }), _jsx("pre", { style: {
+                            marginTop: '0.5rem',
+                            padding: '1rem',
+                            backgroundColor: '#fee2e2',
+                            borderRadius: '0.25rem',
+                            overflow: 'auto',
+                            fontSize: '0.875rem',
+                        }, children: error.message })] }), _jsx("button", { onClick: reset, style: {
+                    padding: '0.5rem 1rem',
+                    backgroundColor: '#dc2626',
+                    color: 'white',
+                    border: 'none',
+                    borderRadius: '0.25rem',
+                    cursor: 'pointer',
+                    fontWeight: 500,
+                }, children: "\uD83D\uDD04 \uB2E4\uC2DC \uC2DC\uB3C4 / Try again" })] }));
+}
+/**
+ * Error Boundary Component
+ *
+ * Catches JavaScript errors anywhere in the child component tree,
+ * logs those errors, and displays a fallback UI.
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary fallback={<div>Something went wrong</div>}>
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary
+ *   fallback={(error, reset) => (
+ *     <div>
+ *       <h1>Error: {error.message}</h1>
+ *       <button onClick={reset}>Try again</button>
+ *     </div>
+ *   )}
+ * >
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ */
+export class ErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.reset = () => {
+            // Call onReset callback if provided
+            this.props.onReset?.();
+            // Reset error state
+            this.setState({ hasError: false, error: null });
+        };
+        this.state = { hasError: false, error: null };
+    }
+    static getDerivedStateFromError(error) {
+        // Update state so the next render will show the fallback UI
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        // 개발 모드: 콘솔에 에러 로그
+        // Development mode: Log error to console
+        if (process.env.NODE_ENV === 'development') {
+            console.error('[ErrorBoundary] Caught error:', error);
+            console.error('[ErrorBoundary] Error info:', errorInfo);
+        }
+        // 프로덕션 모드: 에러 리포팅 서비스 통합 (선택적)
+        // Production mode: Integrate with error reporting service (optional)
+        if (process.env.NODE_ENV === 'production') {
+            // 전역 에러 리포터가 설정되어 있으면 사용
+            // Use global error reporter if configured
+            if (typeof window !== 'undefined' && window.__ERROR_REPORTER__) {
+                try {
+                    window.__ERROR_REPORTER__(error, errorInfo);
+                }
+                catch (reportingError) {
+                    // 에러 리포팅 자체가 실패해도 앱은 계속 동작해야 함
+                    // App should continue working even if error reporting fails
+                    console.error('[ErrorBoundary] Error reporting failed:', reportingError);
+                }
+            }
+        }
+        // Call onError callback if provided
+        this.props.onError?.(error, errorInfo);
+    }
+    render() {
+        if (this.state.hasError && this.state.error) {
+            // Render fallback UI
+            const { fallback } = this.props;
+            if (typeof fallback === 'function') {
+                return fallback(this.state.error, this.reset);
+            }
+            if (fallback) {
+                return fallback;
+            }
+            // Default fallback
+            return _jsx(DefaultFallback, { error: this.state.error, reset: this.reset });
+        }
+        return this.props.children;
+    }
+}

package/dist/framework/components/HuaUxLayout.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @hua-labs/hua-ux/framework - HuaUxLayout
+ *
+ * Root layout wrapper that automatically sets up all providers
+ */
+import type { HuaUxLayoutProps } from '../types';
+/**
+ * HuaUxLayout Component
+ *
+ * Automatically configures i18n, motion, and state providers based on configuration.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { HuaUxLayout } from '@hua-labs/hua-ux/framework';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html lang="ko">
+ *       <body>
+ *         <HuaUxLayout>{children}</HuaUxLayout>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export declare function HuaUxLayout({ children, config }: HuaUxLayoutProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HuaUxLayout.d.ts.map

package/dist/framework/components/HuaUxLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuaUxLayout.d.ts","sourceRoot":"","sources":["../../../src/framework/components/HuaUxLayout.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,gBAAgB,2CAEjE"}

package/dist/framework/components/HuaUxLayout.js

@@ -0,0 +1,32 @@
+/**
+ * @hua-labs/hua-ux/framework - HuaUxLayout
+ *
+ * Root layout wrapper that automatically sets up all providers
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { UnifiedProviders } from './Providers';
+/**
+ * HuaUxLayout Component
+ *
+ * Automatically configures i18n, motion, and state providers based on configuration.
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { HuaUxLayout } from '@hua-labs/hua-ux/framework';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html lang="ko">
+ *       <body>
+ *         <HuaUxLayout>{children}</HuaUxLayout>
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export function HuaUxLayout({ children, config }) {
+    return _jsx(UnifiedProviders, { config: config, children: children });
+}

package/dist/framework/components/HuaUxPage.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @hua-labs/hua-ux/framework - HuaUxPage
+ *
+ * Page wrapper with automatic motion and i18n support
+ */
+import type { HuaUxPageProps } from '../types';
+/**
+ * HuaUxPage Component
+ *
+ * 페이지 콘텐츠를 자동 모션 애니메이션과 i18n 지원으로 감싸는 컴포넌트입니다.
+ * Wraps page content with automatic motion animations and i18n support.
+ *
+ * **바이브 코딩 친화적 / Vibe Coding Friendly**:
+ * - 한 파일에서 SEO, Motion, i18n을 모두 결정할 수 있습니다.
+ * - You can decide SEO, Motion, and i18n all in one file.
+ * - AI가 파일 하나만 보고도 완벽한 페이지를 생성할 수 있습니다.
+ * - AI can generate a perfect page by looking at just one file.
+ *
+ * @example
+ * ```tsx
+ * // app/page.tsx
+ * import { HuaUxPage } from '@hua-labs/hua-ux/framework';
+ *
+ * export default function HomePage() {
+ *   return (
+ *     <HuaUxPage
+ *       vibe="clean"
+ *       i18nKey="home"
+ *       title="홈"
+ *       description="환영합니다"
+ *     >
+ *       <h1>Welcome</h1>
+ *     </HuaUxPage>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 바이브 코더용: vibe만으로 스타일 결정
+ * // For vibe coders: decide style with just vibe
+ * <HuaUxPage vibe="fancy">
+ *   <div>화려한 인터랙션이 자동 적용됩니다</div>
+ * </HuaUxPage>
+ * ```
+ */
+export declare function HuaUxPage({ children, title, description, vibe, i18nKey, enableMotion, enableErrorBoundary, errorBoundaryFallback, seo, motion, }: HuaUxPageProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=HuaUxPage.d.ts.map

package/dist/framework/components/HuaUxPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HuaUxPage.d.ts","sourceRoot":"","sources":["../../../src/framework/components/HuaUxPage.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,WAAW,EACX,IAAI,EACJ,OAAO,EACP,YAAmB,EACnB,mBAA0B,EAC1B,qBAAqB,EACrB,GAAG,EACH,MAAM,GACP,EAAE,cAAc,2CAwEhB"}

package/dist/framework/components/HuaUxPage.js

@@ -0,0 +1,105 @@
+/**
+ * @hua-labs/hua-ux/framework - HuaUxPage
+ *
+ * Page wrapper with automatic motion and i18n support
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { getConfig } from '../config';
+import { useMotion } from '../hooks/useMotion';
+import { ErrorBoundary } from './ErrorBoundary';
+/**
+ * HuaUxPage Component
+ *
+ * 페이지 콘텐츠를 자동 모션 애니메이션과 i18n 지원으로 감싸는 컴포넌트입니다.
+ * Wraps page content with automatic motion animations and i18n support.
+ *
+ * **바이브 코딩 친화적 / Vibe Coding Friendly**:
+ * - 한 파일에서 SEO, Motion, i18n을 모두 결정할 수 있습니다.
+ * - You can decide SEO, Motion, and i18n all in one file.
+ * - AI가 파일 하나만 보고도 완벽한 페이지를 생성할 수 있습니다.
+ * - AI can generate a perfect page by looking at just one file.
+ *
+ * @example
+ * ```tsx
+ * // app/page.tsx
+ * import { HuaUxPage } from '@hua-labs/hua-ux/framework';
+ *
+ * export default function HomePage() {
+ *   return (
+ *     <HuaUxPage
+ *       vibe="clean"
+ *       i18nKey="home"
+ *       title="홈"
+ *       description="환영합니다"
+ *     >
+ *       <h1>Welcome</h1>
+ *     </HuaUxPage>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 바이브 코더용: vibe만으로 스타일 결정
+ * // For vibe coders: decide style with just vibe
+ * <HuaUxPage vibe="fancy">
+ *   <div>화려한 인터랙션이 자동 적용됩니다</div>
+ * </HuaUxPage>
+ * ```
+ */
+export function HuaUxPage({ children, title, description, vibe, i18nKey, enableMotion = true, enableErrorBoundary = true, errorBoundaryFallback, seo, motion, }) {
+    const config = getConfig();
+    // vibe에 따라 모션 설정 조정
+    // Adjust motion settings based on vibe
+    const motionDuration = vibe === 'fancy' ? 800 : vibe === 'minimal' ? 300 : 600;
+    const shouldEnableMotion = enableMotion && config.motion?.enableAnimations !== false;
+    // motion prop 또는 vibe에 따라 모션 타입 결정
+    // Determine motion type based on motion prop or vibe
+    const motionType = motion || (vibe === 'fancy' ? 'slideUp' : vibe === 'minimal' ? 'fadeIn' : 'fadeIn');
+    // 통합 Motion Hook 사용 (성능 최적화)
+    // Use unified Motion Hook (performance optimization)
+    // Note: React Rules of Hooks를 준수하기 위해 내부적으로 모든 hook을 호출하지만,
+    // 실제로는 선택된 hook만 활성화되어 성능 오버헤드를 최소화합니다.
+    // Note: All hooks are called internally to respect React Rules of Hooks,
+    // but only the selected hook is actually activated to minimize performance overhead.
+    const motionResult = useMotion({
+        type: motionType,
+        duration: motionDuration,
+        autoStart: false, // 수동으로 start 호출
+    });
+    // Start the selected motion if enabled
+    // 모션이 활성화된 경우 선택된 모션 시작
+    React.useEffect(() => {
+        if (shouldEnableMotion) {
+            motionResult.start?.();
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [shouldEnableMotion]); // motionResult.start는 안정적인 함수이므로 dependency에서 제외
+    const pageRef = motionResult.ref;
+    // SEO 메타데이터는 Next.js App Router에서 page.tsx의 export const metadata로 처리하는 것이 권장됩니다.
+    // 이 컴포넌트는 Client Component이므로 메타데이터를 직접 설정할 수 없습니다.
+    // SEO 설정이 있으면 개발자에게 경고 메시지 표시 (개발 모드에서만)
+    React.useEffect(() => {
+        if (process.env.NODE_ENV === 'development' && seo) {
+            console.warn('[HuaUxPage] SEO metadata should be set using `export const metadata` in page.tsx.\n' +
+                'Use `generatePageMetadata()` helper function from @hua-labs/hua-ux/framework');
+        }
+    }, [seo]);
+    // i18nKey가 있으면 해당 네임스페이스를 자동으로 로드하도록 안내
+    // (실제 로드는 I18nProvider에서 자동 처리됨)
+    React.useEffect(() => {
+        if (process.env.NODE_ENV === 'development' && i18nKey) {
+            // i18nKey가 설정되어 있으면 해당 네임스페이스가 자동으로 로드됩니다.
+            // 번역 키는 `${i18nKey}:title`, `${i18nKey}:description` 형식으로 사용할 수 있습니다.
+            // Translation keys can be used in the format `${i18nKey}:title`, `${i18nKey}:description`
+        }
+    }, [i18nKey]);
+    const pageContent = (_jsx("div", { ref: pageRef, style: motionResult.style, children: children }));
+    // Wrap with ErrorBoundary if enabled
+    if (enableErrorBoundary) {
+        return (_jsx(ErrorBoundary, { fallback: errorBoundaryFallback, children: pageContent }));
+    }
+    return pageContent;
+}

package/dist/framework/components/Providers.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @hua-labs/hua-ux/framework - Providers
+ *
+ * Unified providers for i18n, motion, and state
+ */
+import type { ReactNode } from 'react';
+import type { HuaUxConfig } from '../types';
+/**
+ * UnifiedProviders component
+ *
+ * Automatically creates and wraps children with all necessary providers
+ */
+export declare function UnifiedProviders({ children, config: overrideConfig, }: {
+    children: ReactNode;
+    config?: Partial<HuaUxConfig>;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Providers.d.ts.map

package/dist/framework/components/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../../../src/framework/components/Providers.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAiE5C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,cAAc,GACvB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B,2CAWA"}

package/dist/framework/components/Providers.js

@@ -0,0 +1,72 @@
+/**
+ * @hua-labs/hua-ux/framework - Providers
+ *
+ * Unified providers for i18n, motion, and state
+ */
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { getConfig } from '../config';
+import { createZustandI18n } from '@hua-labs/i18n-core-zustand';
+import { createI18nStore } from '@hua-labs/state';
+import { BrandingProvider } from '../branding/context';
+/**
+ * Create providers based on configuration
+ *
+ * Provider 체인을 생성합니다. Branding Provider는 가장 바깥쪽에 위치하여
+ * 다른 Provider들이 브랜딩 설정을 사용할 수 있도록 합니다.
+ *
+ * Creates a provider chain. Branding Provider is placed at the outermost level
+ * so other providers can use branding configuration.
+ */
+function createProviders(config) {
+    const providers = [];
+    // Branding Provider를 먼저 추가 (다른 Provider들이 사용 가능하도록)
+    // Add Branding Provider first (so other providers can use it)
+    if (config.branding) {
+        providers.push(({ children }) => (_jsx(BrandingProvider, { branding: config.branding || null, children: children })));
+    }
+    // i18n Provider
+    if (config.i18n) {
+        const i18nStore = createI18nStore({
+            defaultLanguage: config.i18n.defaultLanguage,
+            supportedLanguages: config.i18n.supportedLanguages,
+            persist: config.state?.persist ?? true,
+            ssr: config.state?.ssr ?? true,
+        });
+        // Type assertion: I18nStoreState extends ZustandLanguageStore, so this is safe
+        const I18nProvider = createZustandI18n(i18nStore, // Type assertion needed due to Zustand's complex type system
+        {
+            fallbackLanguage: config.i18n.fallbackLanguage || 'en',
+            namespaces: config.i18n.namespaces || ['common'],
+            translationLoader: config.i18n.translationLoader || 'api',
+            translationApiPath: config.i18n.translationApiPath || '/api/translations',
+            defaultLanguage: config.i18n.defaultLanguage,
+            loadTranslations: config.i18n.loadTranslations,
+            debug: config.i18n.debug,
+        });
+        providers.push(I18nProvider);
+    }
+    // Return a combined provider
+    return function CombinedProvider({ children }) {
+        // Provider 체인 생성 (Branding Provider가 가장 바깥쪽)
+        // Create provider chain (Branding Provider is outermost)
+        const wrapped = providers.reduceRight((acc, Provider) => _jsx(Provider, { children: acc }), children);
+        return wrapped;
+    };
+}
+/**
+ * UnifiedProviders component
+ *
+ * Automatically creates and wraps children with all necessary providers
+ */
+export function UnifiedProviders({ children, config: overrideConfig, }) {
+    const baseConfig = getConfig();
+    const config = overrideConfig
+        ? { ...baseConfig, ...overrideConfig }
+        : baseConfig;
+    const Provider = React.useMemo(() => createProviders(config), [config]);
+    // Provider 체인은 createProviders 내부에서 처리됨
+    // Provider chain is handled inside createProviders
+    return _jsx(Provider, { children: children });
+}

package/dist/framework/components/WelcomePage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @hua-labs/hua-ux/framework - WelcomePage
+ *
+ * Default welcome page component for new projects
+ * Similar to Next.js default welcome page
+ */
+import React from 'react';
+import type { HuaUxPageProps } from '../types';
+export interface WelcomePageProps extends Omit<HuaUxPageProps, 'children'> {
+    /**
+     * Project name to display
+     */
+    projectName?: string;
+    /**
+     * Show framework features
+     */
+    showFeatures?: boolean;
+    /**
+     * Show quick links
+     */
+    showQuickLinks?: boolean;
+    /**
+     * Custom content to display
+     */
+    children?: React.ReactNode;
+}
+/**
+ * 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 declare function WelcomePage({ projectName, showFeatures, showQuickLinks, children, ...pageProps }: WelcomePageProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WelcomePage.d.ts.map

package/dist/framework/components/WelcomePage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WelcomePage.d.ts","sourceRoot":"","sources":["../../../src/framework/components/WelcomePage.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC;IACxE;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAC1B,WAAsB,EACtB,YAAmB,EACnB,cAAqB,EACrB,QAAQ,EACR,GAAG,SAAS,EACb,EAAE,gBAAgB,2CAmJlB"}