@hua-labs/ui 2.0.2 → 2.1.1

package/dist/landing.d.mts

@@ -0,0 +1,417 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { S as SectionProps } from './Section-BWzyshgX.mjs';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+
+type LandingThemeName = 'corporate' | 'marketing' | 'product' | 'dashboard' | 'app' | 'immersive' | 'portfolio';
+interface LandingMotionOverride {
+    type?: 'fadeIn' | 'slideUp' | 'slideLeft' | 'slideRight' | 'scaleIn' | 'bounceIn';
+    duration?: number;
+    easing?: string;
+    delay?: number;
+}
+interface LandingColorTokens {
+    /** HSL triple — 페이지 배경 (e.g. "0 0% 100%") */
+    background: string;
+    /** HSL triple — 기본 텍스트 */
+    foreground: string;
+    /** HSL triple — 뮤트 배경 */
+    muted: string;
+    /** HSL triple — 보조 텍스트 */
+    mutedForeground: string;
+    /** HSL triple — 브랜드/강조색 */
+    primary: string;
+    /** HSL triple — 강조색 위 텍스트 */
+    primaryForeground: string;
+    /** HSL triple — 보조 색상 */
+    secondary: string;
+    /** HSL triple — 보조 색상 위 텍스트 */
+    secondaryForeground: string;
+    /** HSL triple — 카드 배경 */
+    card: string;
+    /** HSL triple — 카드 텍스트 */
+    cardForeground: string;
+    /** HSL triple — 테두리 */
+    border: string;
+    /** HSL triple — 교차 섹션 배경 */
+    sectionAlt: string;
+}
+interface LandingTheme {
+    name: LandingThemeName;
+    /** 테마 색상 팔레트 */
+    colors: LandingColorTokens;
+    hero: {
+        /** 배경 스타일 */
+        background: 'gradient' | 'animated-gradient' | 'dark';
+        /** 히어로 사이즈 */
+        size: 'xl' | 'full';
+        /** 입장 모션 */
+        motion: Required<LandingMotionOverride>;
+    };
+    features: {
+        /** 카드 타입 */
+        card: 'spotlight' | 'glow' | 'feature-glass';
+        /** stagger 딜레이 (ms) */
+        staggerDelay: number;
+        /** 모션 타입 */
+        motion: Required<LandingMotionOverride>;
+        /** 섹션 데코레이터 */
+        decorator: boolean;
+    };
+    stats: {
+        /** 숫자 사이즈 Tailwind class */
+        numberSize: string;
+        /** count-up 활성화 */
+        countUp: boolean;
+        /** stagger 딜레이 (ms) */
+        staggerDelay: number;
+        /** 모션 타입 */
+        motion: Required<LandingMotionOverride>;
+    };
+    cta: {
+        /** 배경 스타일 */
+        background: 'gradient-soft' | 'animated-gradient' | 'dark';
+        /** 입장 모션 */
+        motion: Required<LandingMotionOverride>;
+    };
+    testimonials: {
+        /** 기본 표시 방식 */
+        variant: 'carousel' | 'grid' | 'marquee';
+        /** stagger 딜레이 (ms) */
+        staggerDelay: number;
+        /** 모션 타입 */
+        motion: Required<LandingMotionOverride>;
+    };
+    logoCloud: {
+        /** 기본 표시 방식 */
+        variant: 'marquee' | 'grid';
+        /** Marquee 속도 (px/s) */
+        speed: number;
+    };
+    showcase: {
+        /** stagger 딜레이 (ms) */
+        staggerDelay: number;
+        /** 모션 타입 */
+        motion: Required<LandingMotionOverride>;
+    };
+}
+interface LandingProviderProps {
+    theme: LandingThemeName | LandingTheme;
+    children: ReactNode;
+}
+interface LandingHeroProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    title: ReactNode;
+    subtitle?: ReactNode;
+    description?: ReactNode;
+    primaryAction?: ReactNode;
+    secondaryAction?: ReactNode;
+    /** 히어로 사이즈 오버라이드 */
+    size?: 'xl' | 'full';
+    /** 배경 오버라이드 */
+    background?: 'gradient' | 'animated-gradient' | 'dark';
+    /** AnimatedGradient 색상 */
+    gradientColors?: string[];
+    /** 스크롤 표시기 */
+    scrollIndicator?: boolean;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+interface LandingFeatureItem {
+    icon?: string;
+    title: string;
+    description: string;
+}
+interface LandingFeaturesProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingFeatureItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 그리드 열 수 @default items.length에 따라 자동 */
+    columns?: 2 | 3 | 4;
+    /** 카드 타입 오버라이드 */
+    card?: 'spotlight' | 'glow' | 'feature-glass';
+    /** 섹션 props 오버라이드 */
+    sectionProps?: Partial<SectionProps>;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+    /** 데코레이터 오버라이드 */
+    decorator?: boolean;
+}
+interface LandingStatItem {
+    value: string;
+    label: string;
+    /** 접두사 (예: "$") */
+    prefix?: string;
+    /** 접미사 (예: "+", "M") */
+    suffix?: string;
+}
+interface LandingStatsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingStatItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** count-up 오버라이드 */
+    countUp?: boolean;
+    /** 숫자 사이즈 오버라이드 */
+    numberSize?: string;
+    /** 섹션 props 오버라이드 */
+    sectionProps?: Partial<SectionProps>;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingCTAProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    title: ReactNode;
+    subtitle?: ReactNode;
+    primaryAction?: ReactNode;
+    secondaryAction?: ReactNode;
+    /** 배경 오버라이드 */
+    background?: 'gradient-soft' | 'animated-gradient' | 'dark';
+    /** AnimatedGradient 색상 */
+    gradientColors?: string[];
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+interface LandingTestimonialItem {
+    quote: string;
+    author: string;
+    role?: string;
+    company?: string;
+    avatar?: string;
+}
+interface LandingTestimonialsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingTestimonialItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 표시 방식 @default 'carousel' */
+    variant?: 'carousel' | 'grid' | 'marquee';
+    /** 그리드 열 수 @default 자동 */
+    columns?: 2 | 3;
+    /** Carousel 자동 재생 @default true */
+    autoPlay?: boolean;
+    /** Carousel 재생 간격 (ms) @default 5000 */
+    interval?: number;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingLogoItem {
+    src: string;
+    alt: string;
+    href?: string;
+}
+interface LandingLogoCloudProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    logos: LandingLogoItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 표시 방식 @default 'marquee' */
+    variant?: 'marquee' | 'grid';
+    /** Marquee 속도 (px/s) @default 50 */
+    speed?: number;
+    /** 로고 최대 높이 (px) @default 40 */
+    logoHeight?: number;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+interface LandingShowcaseItem {
+    image: string;
+    title: string;
+    description: string;
+}
+interface LandingShowcaseProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingShowcaseItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingSocialLink {
+    icon: string;
+    href: string;
+    label: string;
+}
+interface LandingAboutProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    name: string;
+    role: string;
+    bio: string | ReactNode;
+    avatar?: string;
+    socialLinks?: LandingSocialLink[];
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+interface LandingProjectItem {
+    title: string;
+    description: string;
+    image?: string;
+    tags?: string[];
+    href?: string;
+    github?: string;
+}
+interface LandingProjectsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingProjectItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 그리드 열 수 @default 3 */
+    columns?: 2 | 3;
+    /** 태그 필터 활성화 @default false */
+    filter?: boolean;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingSkillItem {
+    name: string;
+    level?: number;
+    icon?: string;
+    category?: string;
+}
+interface LandingSkillsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingSkillItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 표시 방식 @default 'grid' */
+    variant?: 'bars' | 'grid' | 'marquee';
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingExperienceItem {
+    title: string;
+    company: string;
+    period: string;
+    description?: string;
+    current?: boolean;
+}
+interface LandingExperienceProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingExperienceItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+    /** stagger 딜레이 오버라이드 */
+    staggerDelay?: number;
+}
+interface LandingMetricItem {
+    label: string;
+    value: number;
+    description?: string;
+}
+interface LandingMetricsTab {
+    label: string;
+    items: LandingMetricItem[];
+}
+interface LandingMetricsProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    items: LandingMetricItem[];
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 탭 그룹 (옵션) */
+    tabs?: LandingMetricsTab[];
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+interface LandingContactProps extends Omit<React.HTMLAttributes<HTMLElement>, 'title'> {
+    /** 섹션 제목 */
+    title?: string;
+    /** 섹션 부제목 */
+    subtitle?: string;
+    /** 이메일 주소 */
+    email?: string;
+    /** 소셜 링크 목록 */
+    socialLinks?: LandingSocialLink[];
+    /** 모션 오버라이드 */
+    motion?: LandingMotionOverride;
+}
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+
+declare function useLandingTheme(): LandingTheme;
+declare function LandingProvider({ theme, children }: LandingProviderProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingHero({ title, subtitle, description, primaryAction, secondaryAction, size: sizeProp, background: bgProp, gradientColors, scrollIndicator, motion: motionOverride, className, ...rest }: LandingHeroProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingFeatures({ items, title, subtitle, columns: columnsProp, card: cardProp, sectionProps, motion: motionOverride, staggerDelay: staggerDelayProp, decorator: decoratorProp, className, ...rest }: LandingFeaturesProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingStats({ items, title, subtitle, countUp: countUpProp, numberSize: numberSizeProp, sectionProps, motion: motionOverride, staggerDelay: staggerDelayProp, className, ...rest }: LandingStatsProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingCTA({ title, subtitle, primaryAction, secondaryAction, background: bgProp, gradientColors, motion: motionOverride, className, ...rest }: LandingCTAProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingTestimonials({ items, title, subtitle, variant: variantProp, columns: colsProp, autoPlay, interval, motion: motionOverride, staggerDelay: staggerProp, className, ...rest }: LandingTestimonialsProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingLogoCloud({ logos, title, variant: variantProp, speed: speedProp, logoHeight, motion: motionOverride, className, ...rest }: LandingLogoCloudProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingShowcase({ items, title, subtitle, motion: motionOverride, staggerDelay: staggerProp, className, ...rest }: LandingShowcaseProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingAbout({ name, role, bio, avatar, socialLinks, motion: motionOverride, className, ...rest }: LandingAboutProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingProjects({ items, title, subtitle, columns, filter, motion: motionOverride, staggerDelay: staggerProp, className, ...rest }: LandingProjectsProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingSkills({ items, title, subtitle, variant, motion: motionOverride, staggerDelay: staggerProp, className, ...rest }: LandingSkillsProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingExperience({ items, title, subtitle, motion: motionOverride, staggerDelay: staggerProp, className, ...rest }: LandingExperienceProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingMetrics({ items, title, subtitle, tabs, motion: motionOverride, className, ...rest }: LandingMetricsProps): react_jsx_runtime.JSX.Element;
+
+declare function LandingContact({ title, subtitle, email, socialLinks, motion: motionOverride, className, ...rest }: LandingContactProps): react_jsx_runtime.JSX.Element;
+
+declare const corporate: LandingTheme;
+
+declare const marketing: LandingTheme;
+
+declare const product: LandingTheme;
+
+declare const dashboard: LandingTheme;
+
+declare const app: LandingTheme;
+
+declare const immersive: LandingTheme;
+
+declare const portfolio: LandingTheme;
+
+declare function resolveTheme(theme: LandingThemeName | LandingTheme): LandingTheme;
+/** 기존 테마를 기반으로 커스텀 테마 생성 */
+declare function createLandingTheme(base: LandingThemeName, overrides: DeepPartial<Omit<LandingTheme, 'name'>> & {
+    name: string;
+}): LandingTheme;
+
+declare const Landing: {
+    readonly Provider: typeof LandingProvider;
+    readonly Hero: typeof LandingHero;
+    readonly Features: typeof LandingFeatures;
+    readonly Stats: typeof LandingStats;
+    readonly CTA: typeof LandingCTA;
+    readonly Testimonials: typeof LandingTestimonials;
+    readonly LogoCloud: typeof LandingLogoCloud;
+    readonly Showcase: typeof LandingShowcase;
+    readonly About: typeof LandingAbout;
+    readonly Projects: typeof LandingProjects;
+    readonly Skills: typeof LandingSkills;
+    readonly Experience: typeof LandingExperience;
+    readonly Metrics: typeof LandingMetrics;
+    readonly Contact: typeof LandingContact;
+};
+
+export { type DeepPartial, Landing, LandingAbout, type LandingAboutProps, LandingCTA, type LandingCTAProps, type LandingColorTokens, LandingContact, type LandingContactProps, LandingExperience, type LandingExperienceItem, type LandingExperienceProps, type LandingFeatureItem, LandingFeatures, type LandingFeaturesProps, LandingHero, type LandingHeroProps, LandingLogoCloud, type LandingLogoCloudProps, type LandingLogoItem, type LandingMetricItem, LandingMetrics, type LandingMetricsProps, type LandingMetricsTab, type LandingMotionOverride, type LandingProjectItem, LandingProjects, type LandingProjectsProps, LandingProvider, type LandingProviderProps, LandingShowcase, type LandingShowcaseItem, type LandingShowcaseProps, type LandingSkillItem, LandingSkills, type LandingSkillsProps, type LandingSocialLink, type LandingStatItem, LandingStats, type LandingStatsProps, type LandingTestimonialItem, LandingTestimonials, type LandingTestimonialsProps, type LandingTheme, type LandingThemeName, app, corporate, createLandingTheme, dashboard, immersive, marketing, portfolio, product, resolveTheme, useLandingTheme };