@exem-ui/react 0.1.0-next.bf3c711 → 0.1.0-next.ef0891e

package/dist/index.d.mts

@@ -1,37 +1,1166 @@
-export { Avatar, AvatarComponent, AvatarProps } from './avatar/index.mjs';
-export { Badge, BadgeComponent, BadgeProps } from './badge/index.mjs';
-export { Star, StarComponent, StarProps } from './star/index.mjs';
-export { DoubleTag, DoubleTagProps, Tag, TagColor, TagComponent, TagProps } from './tag/index.mjs';
-export { Breadcrumb, BreadcrumbComponent, BreadcrumbEllipsisProps, BreadcrumbItemProps, BreadcrumbLinkProps, BreadcrumbListProps, BreadcrumbPageProps, BreadcrumbRootProps, BreadcrumbSeparatorProps } from './breadcrumb/index.mjs';
-export { Tabs, TabsComponent, TabsContentProps, TabsListProps, TabsRootProps, TabsTriggerProps } from './tabs/index.mjs';
-export { B as Button, a as ButtonComponent, b as ButtonProps } from './Button-CMenVfb7.mjs';
-export { B as ButtonGroup, a as ButtonGroupComponent, b as ButtonGroupItem, c as ButtonGroupProps, I as IconButton, d as IconButtonComponent, e as IconButtonProps } from './index-CXip5Wb1.mjs';
-export { Checkbox, CheckboxComponent, CheckboxProps } from './checkbox/index.mjs';
-export { Radio, RadioComponent, RadioItemProps, RadioRootProps } from './radio/index.mjs';
-export { Switch, SwitchComponent, SwitchProps } from './switch/index.mjs';
-export { DatePicker, DatePickerProps } from './picker/index.mjs';
-export { S as Select, a as SelectBoxProps, b as SelectComponent, c as SelectDescriptionProps, d as SelectEmptyProps, e as SelectGroupProps, f as SelectItemProps, g as SelectLabelProps, h as SelectListProps, i as SelectRootProps, j as SelectTriggerProps } from './Select-DMvWV_rF.mjs';
-export { TextArea, TextAreaComponent, TextAreaDescriptionProps, TextAreaFieldProps, TextAreaLabelProps, TextAreaRootProps, TextField, TextFieldComponent, TextFieldDescriptionProps, TextFieldInputProps, TextFieldLabelProps, TextFieldRootProps } from './input/index.mjs';
-export { Segment, SegmentComponent, SegmentContentProps, SegmentItemProps, SegmentListProps, SegmentRootProps } from './segment/index.mjs';
-export { ScrollArea, ScrollAreaProps, ScrollBar } from './scrollArea/index.mjs';
-export { Modal, ModalActionsProps, ModalBodyProps, ModalCloseProps, ModalComponent, ModalContentProps, ModalDescriptionProps, ModalFooterDescriptionProps, ModalFooterProps, ModalHeaderProps, ModalOverlayProps, ModalPortalProps, ModalRootProps, ModalTitleProps, ModalTriggerProps } from './modal/index.mjs';
-export { MessageBox, MessageBoxActionProps, MessageBoxActionsProps, MessageBoxCancelProps, MessageBoxComponent, MessageBoxContentProps, MessageBoxDescriptionProps, MessageBoxRootProps, MessageBoxTitleProps, MessageBoxTriggerProps, MessageBoxVariant } from './messageBox/index.mjs';
-export { Tooltip, TooltipComponent, TooltipContentProps, TooltipDescriptionProps, TooltipProviderProps, TooltipRootProps, TooltipTitleProps, TooltipTriggerProps } from './tooltip/index.mjs';
-export { Loading, LoadingComponent, LoadingProps } from './loading/index.mjs';
-export { Progress, ProgressComponent, ProgressProps } from './progress/index.mjs';
-export { ExtendedExternalToast, SonnerToastOptions, ToastAction, ToastInput, ToastOptions, ToastProvider, ToastProviderProps, Toaster, ToasterActionProps, ToasterComponent, ToasterContainerProps, ToasterDescriptionProps, ToasterIconProps, ToasterRootProps, ToasterTitleProps, toast, useToast } from './toast/index.mjs';
-import 'class-variance-authority/types';
-import '@exem-ui/core/utils';
-import 'react';
-import '@radix-ui/react-tabs';
-import './flat/tooltip.mjs';
-import 'react/jsx-runtime';
-import '@radix-ui/react-checkbox';
-import '@radix-ui/react-radio-group';
-import '@radix-ui/react-switch';
-import 'react-day-picker';
-import '@radix-ui/react-select';
-import '@radix-ui/react-scroll-area';
-import '@radix-ui/react-dialog';
-import '@radix-ui/react-tooltip';
-import 'sonner';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from '@exem-ui/core/utils';
+import * as React$1 from 'react';
+import React__default, { ComponentProps } from 'react';
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
+import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
+import * as SwitchPrimitives from '@radix-ui/react-switch';
+import { DayPicker } from 'react-day-picker';
+import * as SelectPrimitive from '@radix-ui/react-select';
+import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+import { Toaster as Toaster$1, ExternalToast, toast as toast$1 } from 'sonner';
+
+interface AvatarProps extends React__default.HTMLAttributes<HTMLDivElement>, VariantProps<typeof avatarVariants> {
+    /** 사용자 이름. 이미지가 없을 때 이니셜 폴백에 사용됩니다. */
+    name?: string;
+    /** 아바타 이미지 URL */
+    src?: string;
+    /** 이미지 대체 텍스트 */
+    alt?: string;
+}
+type AvatarComponent = React__default.ForwardRefExoticComponent<AvatarProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const avatarVariants: (props?: ({
+    size?: "small" | "xsmall" | "medium" | "large" | null | undefined;
+    type?: "image" | "initial" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * 사용자 아바타를 표시하는 컴포넌트입니다. 이니셜, 이미지, 아이콘 폴백을 지원합니다.
+ *
+ * @example
+ * ```tsx
+ * // 이니셜 표시
+ * <Avatar name="홍길동" size="large" />
+ *
+ * // 이미지 표시
+ * <Avatar type="image" src="/avatar.png" name="홍길동" />
+ *
+ * // 이미지 없을 때 아이콘 폴백
+ * <Avatar type="image" name="홍길동" />
+ * ```
+ *
+ * @see {@link AvatarProps} props 상세
+ */
+declare const Avatar: AvatarComponent;
+
+interface BadgeProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /**
+     * 배지 스타일 변형
+     * @default 'default'
+     */
+    variant?: 'default' | 'accent';
+    /**
+     * 비활성화 상태
+     * @default false
+     */
+    disabled?: boolean;
+}
+type BadgeComponent = React__default.ForwardRefExoticComponent<BadgeProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * 상태나 카운트를 표시하는 배지 컴포넌트입니다.
+ *
+ * @example
+ * ```tsx
+ * <Badge variant="accent">3</Badge>
+ * <Badge variant="default" disabled>0</Badge>
+ * ```
+ *
+ * @see {@link BadgeProps} props 상세
+ */
+declare const Badge: BadgeComponent;
+
+interface StarProps extends React__default.SVGProps<SVGSVGElement> {
+    /**
+     * 별 아이콘 크기
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * 선택(채워짐) 상태 여부
+     * @default false
+     */
+    selected?: boolean;
+    /** 클릭 이벤트 핸들러 */
+    onClick?: (event: React__default.MouseEvent<SVGSVGElement>) => void;
+}
+type StarComponent = React__default.ForwardRefExoticComponent<Omit<StarProps, 'ref'> & React__default.RefAttributes<SVGSVGElement>>;
+/**
+ * 별점 평가에 사용되는 Star 아이콘 컴포넌트입니다.
+ *
+ * @example
+ * ```tsx
+ * <Star selected size="medium" onClick={() => console.log('clicked')} />
+ * ```
+ *
+ * @see {@link StarProps} props 상세
+ */
+declare const Star: StarComponent;
+
+type TagColor = VariantProps<typeof tagVariants>['color'];
+interface TagProps extends Pick<React__default.HTMLAttributes<HTMLDivElement>, 'className' | 'children' | 'style'>, VariantProps<typeof tagVariants> {
+    /** 텍스트 왼쪽에 표시할 아이콘 */
+    leftIcon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+    /**
+     * 삭제 아이콘 표시 여부
+     * @default false
+     */
+    canDelete?: boolean;
+    /** 삭제 버튼 클릭 핸들러 */
+    onDelete?: () => void;
+    /** 텍스트 오른쪽에 표시할 슬롯 요소 */
+    rightSlot?: React__default.ReactNode;
+}
+type TagComponent = React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLDivElement>>;
+interface DoubleTagProps {
+    /** 표시할 태그 항목 배열 (각 항목은 color와 content를 가짐) */
+    items: {
+        color: TagColor;
+        content: React__default.ReactNode;
+    }[];
+    className?: string;
+}
+declare const tagVariants: (props?: ({
+    color?: "mono" | "sky" | "red" | "amber" | "green" | "orange" | "cyan" | "violet" | "pink" | "yellow" | "lime" | "emerald" | "teal" | "blue" | "indigo" | "purple" | "fuchsia" | "rose" | null | undefined;
+    type?: "fill" | "line" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * 카테고리나 상태를 나타내는 라벨 컴포넌트입니다.
+ * 18가지 색상과 `fill`/`line` 타입을 지원합니다.
+ *
+ * @example
+ * ```tsx
+ * <Tag color="sky">라벨</Tag>
+ * <Tag color="red" type="line">경고</Tag>
+ * <Tag color="green" canDelete onDelete={handleDelete}>삭제 가능</Tag>
+ * <Tag color="blue" leftIcon={<StarIcon type="regular" />}>아이콘 태그</Tag>
+ * <Tag color="blue" rightSlot={<Icon />}>커스텀 슬롯</Tag>
+ * ```
+ *
+ * @see {@link TagProps} props 상세
+ */
+declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * 두 개의 태그를 나란히 연결하여 키-값 쌍을 표시하는 컴포넌트입니다.
+ * 각 태그는 `line` 타입으로 렌더링되며, 사이에 구분선이 표시됩니다.
+ *
+ * @example
+ * ```tsx
+ * <DoubleTag
+ *   items={[
+ *     { color: 'blue', content: '카테고리' },
+ *     { color: 'red', content: '긴급' },
+ *   ]}
+ * />
+ * ```
+ *
+ * @see {@link DoubleTagProps} props 상세
+ */
+declare const DoubleTag: React__default.ForwardRefExoticComponent<DoubleTagProps & React__default.RefAttributes<HTMLDivElement>>;
+
+type BreadcrumbRootProps = React__default.ComponentPropsWithoutRef<'nav'>;
+type BreadcrumbListProps = React__default.ComponentPropsWithoutRef<'ol'>;
+type BreadcrumbItemProps = React__default.ComponentPropsWithoutRef<'li'>;
+type BreadcrumbLinkProps = React__default.ComponentPropsWithoutRef<'a'> & {
+    asChild?: boolean;
+};
+type BreadcrumbPageProps = React__default.ComponentPropsWithoutRef<'span'>;
+type BreadcrumbSeparatorProps = React__default.ComponentProps<'li'>;
+type BreadcrumbEllipsisProps = React__default.ComponentProps<'span'>;
+type BreadcrumbComponent = React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbRootProps> & React__default.RefAttributes<HTMLElement>> & {
+    List: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbListProps> & React__default.RefAttributes<HTMLOListElement>>;
+    Item: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbItemProps> & React__default.RefAttributes<HTMLLIElement>>;
+    Link: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbLinkProps> & React__default.RefAttributes<HTMLAnchorElement>>;
+    Page: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbPageProps> & React__default.RefAttributes<HTMLSpanElement>>;
+    Separator: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbSeparatorProps> & React__default.RefAttributes<HTMLLIElement>>;
+    Ellipsis: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<BreadcrumbEllipsisProps> & React__default.RefAttributes<HTMLSpanElement>>;
+};
+/**
+ * 현재 페이지의 계층 위치를 표시하는 탐색 경로 컴포넌트입니다.
+ * Compound Component 패턴으로 하위 컴포넌트와 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Breadcrumb>
+ *   <Breadcrumb.List>
+ *     <Breadcrumb.Item>
+ *       <Breadcrumb.Link href="/">홈</Breadcrumb.Link>
+ *     </Breadcrumb.Item>
+ *     <Breadcrumb.Separator />
+ *     <Breadcrumb.Item>
+ *       <Breadcrumb.Page>현재 페이지</Breadcrumb.Page>
+ *     </Breadcrumb.Item>
+ *   </Breadcrumb.List>
+ * </Breadcrumb>
+ * ```
+ *
+ * @see {@link BreadcrumbRootProps} props 상세
+ */
+declare const Breadcrumb: BreadcrumbComponent;
+
+type TabsType = 'primary' | 'secondary';
+type TabsRootProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Root> & {
+    /**
+     * 탭 스타일 유형
+     * @default 'primary'
+     */
+    type?: TabsType;
+};
+type TabsListProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.List>;
+type TabsTriggerProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> & {
+    /** 텍스트 왼쪽에 표시할 아이콘 요소 */
+    leftIcon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+    /** 텍스트 오른쪽에 표시할 아이콘 요소 */
+    rightIcon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+    /** 탭 라벨 옆에 표시할 배지 텍스트 */
+    badge?: string | number;
+};
+type TabsContentProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>;
+type TabsComponent = React__default.ForwardRefExoticComponent<TabsRootProps & React__default.RefAttributes<React__default.ElementRef<typeof TabsPrimitive.Root>>> & {
+    List: React__default.ForwardRefExoticComponent<TabsListProps>;
+    Trigger: React__default.ForwardRefExoticComponent<TabsTriggerProps>;
+    Content: React__default.ForwardRefExoticComponent<TabsContentProps>;
+};
+/**
+ * 탭 형태의 콘텐츠 전환 컴포넌트입니다.
+ * Compound Component 패턴으로 `Tabs.List`, `Tabs.Trigger`, `Tabs.Content`와 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Tabs defaultValue="tab1" type="primary">
+ *   <Tabs.List>
+ *     <Tabs.Trigger value="tab1">첫 번째</Tabs.Trigger>
+ *     <Tabs.Trigger value="tab2">두 번째</Tabs.Trigger>
+ *   </Tabs.List>
+ *   <Tabs.Content value="tab1">첫 번째 내용</Tabs.Content>
+ *   <Tabs.Content value="tab2">두 번째 내용</Tabs.Content>
+ * </Tabs>
+ * ```
+ *
+ * @see {@link TabsRootProps} 루트 props 상세
+ * @see {@link TabsTriggerProps} 트리거 props 상세
+ */
+declare const Tabs: TabsComponent;
+
+type ButtonColorVariantCombination = {
+    color?: 'primary';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'accent';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'critical';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'assistive';
+    variant?: 'contained';
+} | {
+    color?: 'inverse';
+    variant?: 'contained';
+};
+type ButtonProps = React__default.ButtonHTMLAttributes<HTMLButtonElement> & Omit<VariantProps<typeof buttonVariants>, 'variant' | 'color'> & ButtonColorVariantCombination & {
+    size?: 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+    icon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+};
+type ButtonComponent = React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
+declare const buttonVariants: (props?: ({
+    color?: "accent" | "primary" | "critical" | "assistive" | "inverse" | null | undefined;
+    size?: "small" | "xsmall" | "medium" | "large" | "xlarge" | null | undefined;
+    variant?: "contained" | "outlined" | "invisible" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const Button: ButtonComponent;
+
+type SegmentSize = 'small' | 'medium' | 'large';
+type SegmentListProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.List>;
+type SegmentItemProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> & {
+    /** 텍스트 왼쪽에 표시할 아이콘 요소 */
+    leftIcon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+};
+type SegmentContentProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Content>;
+type SegmentRootProps = React__default.ComponentPropsWithoutRef<typeof TabsPrimitive.Root> & {
+    /**
+     * 세그먼트 크기
+     * @default 'medium'
+     */
+    size?: SegmentSize;
+};
+type SegmentComponent = React__default.ForwardRefExoticComponent<SegmentRootProps & React__default.RefAttributes<React__default.ElementRef<typeof TabsPrimitive.Root>>> & {
+    List: React__default.ForwardRefExoticComponent<SegmentListProps>;
+    Item: React__default.ForwardRefExoticComponent<SegmentItemProps>;
+    Content: React__default.ForwardRefExoticComponent<SegmentContentProps>;
+};
+/**
+ * 탭 형태의 세그먼트 컨트롤 컴포넌트입니다.
+ * Compound Component 패턴으로 `Segment.List`, `Segment.Item`, `Segment.Content`와 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Segment defaultValue="tab1" size="medium">
+ *   <Segment.List>
+ *     <Segment.Item value="tab1">첫 번째</Segment.Item>
+ *     <Segment.Item value="tab2">두 번째</Segment.Item>
+ *   </Segment.List>
+ *   <Segment.Content value="tab1">첫 번째 내용</Segment.Content>
+ *   <Segment.Content value="tab2">두 번째 내용</Segment.Content>
+ * </Segment>
+ * ```
+ *
+ * @see {@link SegmentRootProps} 루트 props 상세
+ * @see {@link SegmentItemProps} 아이템 props 상세
+ */
+declare const Segment: SegmentComponent;
+
+type Size = 'xsmall' | 'small' | 'medium' | 'large';
+type Variant = 'fill' | 'line';
+type Icon = React.ReactElement<{
+    className?: string;
+}>;
+
+/** Select 라벨 Props */
+type SelectLabelProps = {
+    children: React$1.ReactNode;
+    required?: boolean;
+    size?: Size;
+    className?: string;
+};
+/** Select 트리거 Props */
+type SelectTriggerProps = {
+    children?: React$1.ReactNode;
+    /** 트리거 왼쪽에 표시할 아이콘 */
+    leftIcon?: Icon;
+    className?: string;
+} & Omit<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, 'children'>;
+/** Select Box (Trigger + Value 조합) Props */
+type SelectBoxProps = {
+    placeholder?: string;
+    /** 트리거 왼쪽에 표시할 아이콘 */
+    leftIcon?: Icon;
+    className?: string;
+} & Omit<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, 'children'>;
+/** Select 아이템 Props */
+type SelectItemProps = {
+    children?: React$1.ReactNode;
+    /** 아이템 왼쪽에 표시할 아이콘 */
+    leftIcon?: Icon;
+    /** 아이템 오른쪽에 표시할 아이콘 */
+    rightIcon?: Icon;
+    /** 왼쪽 아이콘 크기 */
+    leftIconSize?: Size;
+    /** 오른쪽 아이콘 크기 */
+    rightIconSize?: Size;
+    size?: Size;
+    className?: string;
+} & Omit<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Item>, 'children'>;
+type SelectEmptyProps = {
+    children?: React$1.ReactNode;
+    className?: string;
+};
+type SelectDescriptionProps = {
+    children?: React$1.ReactNode;
+    size?: Size;
+    className?: string;
+};
+type SelectGroupProps = {
+    children: React$1.ReactNode;
+    size?: Size;
+    /** 셀렉트 그룹 스타일 변형 */
+    variant?: Variant;
+    /** 불투명 배경 (elevation-0) 사용 여부. 반투명 배경이 비쳐보이는 것을 방지합니다. */
+    hasBackground?: boolean;
+    className?: string;
+};
+/** Select 루트 Props */
+type SelectRootProps = {
+    children?: React$1.ReactNode;
+    /** 셀렉트 크기 */
+    size?: Size;
+    /** 셀렉트 스타일 변형 */
+    variant?: Variant;
+    /** 에러 상태 */
+    error?: boolean;
+    /** 포커스 상태 (line variant에서만 적용) */
+    focus?: boolean;
+    /** 활성화 상태 (필터 적용 등 내부 상태가 활성화됨을 표시) */
+    active?: boolean;
+    /** 비활성화 상태 */
+    disabled?: boolean;
+    className?: string;
+} & Omit<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Root>, 'disabled' | 'children'>;
+type SelectListProps = Omit<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Content>, 'position'>;
+type SelectComponent = React$1.ForwardRefExoticComponent<SelectRootProps & React$1.RefAttributes<HTMLDivElement>> & {
+    Label: React$1.ForwardRefExoticComponent<SelectLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+    Trigger: React$1.ForwardRefExoticComponent<SelectTriggerProps & React$1.RefAttributes<React$1.ComponentRef<typeof SelectPrimitive.Trigger>>>;
+    Box: React$1.ForwardRefExoticComponent<SelectBoxProps & React$1.RefAttributes<React$1.ComponentRef<typeof SelectPrimitive.Trigger>>>;
+    Value: React$1.ForwardRefExoticComponent<React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Value> & React$1.RefAttributes<React$1.ComponentRef<typeof SelectPrimitive.Value>>>;
+    List: React$1.ForwardRefExoticComponent<SelectListProps & React$1.RefAttributes<React$1.ComponentRef<typeof SelectPrimitive.Content>>>;
+    Item: React$1.ForwardRefExoticComponent<SelectItemProps & React$1.RefAttributes<React$1.ComponentRef<typeof SelectPrimitive.Item>>>;
+    Empty: React$1.ForwardRefExoticComponent<SelectEmptyProps & React$1.RefAttributes<HTMLDivElement>>;
+    Description: React$1.ForwardRefExoticComponent<SelectDescriptionProps & React$1.RefAttributes<HTMLDivElement>>;
+    Group: React$1.ForwardRefExoticComponent<SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+};
+declare const Select: SelectComponent;
+
+type TooltipRootProps = React__default.ComponentPropsWithoutRef<typeof TooltipPrimitive.Root>;
+type TooltipProviderProps = React__default.ComponentPropsWithoutRef<typeof TooltipPrimitive.Provider>;
+type TooltipTriggerProps = React__default.ComponentPropsWithoutRef<typeof TooltipPrimitive.Trigger>;
+type TooltipContentProps = React__default.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> & VariantProps<typeof tooltipContentVariants> & {
+    portalContainer?: HTMLElement | null;
+};
+type TooltipTitleProps = React__default.HTMLAttributes<HTMLDivElement>;
+type TooltipDescriptionProps = React__default.HTMLAttributes<HTMLDivElement>;
+type TooltipComponent = typeof TooltipPrimitive.Root & {
+    Provider: typeof TooltipPrimitive.Provider;
+    Trigger: typeof TooltipPrimitive.Trigger;
+    Content: React__default.ForwardRefExoticComponent<TooltipContentProps & React__default.RefAttributes<React__default.ElementRef<typeof TooltipPrimitive.Content>>>;
+    Title: React__default.ForwardRefExoticComponent<TooltipTitleProps & React__default.RefAttributes<HTMLDivElement>>;
+    Description: React__default.ForwardRefExoticComponent<TooltipDescriptionProps & React__default.RefAttributes<HTMLDivElement>>;
+};
+declare const tooltipContentVariants: (props?: ({
+    size?: "small" | "medium" | "large" | "xlarge" | "tiny" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const Tooltip: TooltipComponent;
+
+interface FlatTooltipProps {
+    /** 툴팁을 적용할 자식 요소 */
+    children: React.ReactNode;
+    /** 툴팁 제목 (선택) */
+    title?: React.ReactNode;
+    /** 툴팁 크기 */
+    size: ComponentProps<typeof Tooltip.Content>['size'];
+    /** 툴팁 표시 위치 */
+    side?: ComponentProps<typeof Tooltip.Content>['side'];
+    /** 툴팁 정렬 */
+    align?: ComponentProps<typeof Tooltip.Content>['align'];
+    /** 사이드 방향 오프셋 (px) */
+    sideOffset?: ComponentProps<typeof Tooltip.Content>['sideOffset'];
+    /** 정렬 방향 오프셋 (px) */
+    alignOffset?: ComponentProps<typeof Tooltip.Content>['alignOffset'];
+    /** 툴팁 설명 텍스트 */
+    description: React.ReactNode;
+}
+/**
+ * Tooltip 컴포넌트의 간소화된 Flat API입니다.
+ * Compound Component 없이 props만으로 간편하게 사용할 수 있습니다.
+ *
+ * @example
+ * ```tsx
+ * <FlatTooltip size="small" description="도움말 텍스트">
+ *   <button>호버하세요</button>
+ * </FlatTooltip>
+ *
+ * <FlatTooltip size="tiny" title="제목" description="설명">
+ *   <span>정보</span>
+ * </FlatTooltip>
+ * ```
+ *
+ * @see {@link FlatTooltipProps} props 상세
+ */
+declare const FlatTooltip: {
+    ({ children, title, size, description, ...props }: FlatTooltipProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+/** FlatTooltip 설정 객체 타입 (children 제외) */
+type TooltipConfig = Omit<ComponentProps<typeof FlatTooltip>, 'children' | 'size'> & {
+    /**
+     * 툴팁 사용 여부
+     * @default true
+     */
+    use?: boolean;
+    size?: ComponentProps<typeof FlatTooltip>['size'];
+};
+interface ConditionalTooltipProps {
+    /** 툴팁으로 감쌀 자식 요소 */
+    children: React.ReactNode;
+    /**
+     * 툴팁 설정값
+     * - `string`: 기본 tiny 사이즈의 툴팁 description으로 사용
+     * - `object`: FlatTooltip props를 직접 전달 (`use: false`로 비활성화 가능)
+     */
+    tooltip: ComponentProps<typeof FlatTooltip>['description'] | TooltipConfig;
+}
+/**
+ * 조건부로 FlatTooltip을 적용하는 래퍼 컴포넌트입니다.
+ *
+ * @description
+ * tooltip prop의 타입에 따라 다르게 동작합니다:
+ * - `string`: tiny 사이즈의 기본 툴팁으로 렌더링
+ * - `object` (`use !== false`): 전달된 props로 FlatTooltip 렌더링
+ * - `object` (`use === false`) 또는 기타: children만 반환 (툴팁 없음)
+ *
+ * @example
+ * ```tsx
+ * <ConditionalTooltip tooltip="도움말 텍스트">
+ *   <button>버튼</button>
+ * </ConditionalTooltip>
+ *
+ * <ConditionalTooltip tooltip={{ description: "설명", size: "small", side: "top" }}>
+ *   <button>버튼</button>
+ * </ConditionalTooltip>
+ *
+ * <ConditionalTooltip tooltip={{ use: false, description: "" }}>
+ *   <button>툴팁 없음</button>
+ * </ConditionalTooltip>
+ * ```
+ *
+ * @see {@link ConditionalTooltipProps} props 상세
+ */
+declare function ConditionalTooltip({ children, tooltip }: ConditionalTooltipProps): string | number | bigint | boolean | react_jsx_runtime.JSX.Element | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | null | undefined;
+declare namespace ConditionalTooltip {
+    var displayName: string;
+}
+
+type ButtonGroupSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+interface ButtonGroupItem {
+    id: string;
+    label?: string;
+    icon?: React__default.ReactElement<{
+        className?: string;
+    }>;
+    /** 툴팁 설정 (문자열 또는 FlatTooltip 설정 객체) */
+    tooltip?: ComponentProps<typeof ConditionalTooltip>['tooltip'];
+    onClick?: () => void;
+}
+interface ButtonGroupProps {
+    /** 버튼 그룹 스타일 변형 */
+    variant?: 'contained' | 'outlined';
+    /** 아이콘만 표시 */
+    iconOnly?: boolean;
+    /** 배경색 표시 여부 (뒷 레이어가 보이지 않아야 할 때) */
+    hasBackground?: boolean;
+    /** 버튼 크기 */
+    size?: ButtonGroupSize;
+    /** 버튼 항목 목록 */
+    items: ButtonGroupItem[];
+    /** 커스텀 className */
+    className?: string;
+}
+type ButtonGroupComponent = React__default.ForwardRefExoticComponent<ButtonGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const ButtonGroup: ButtonGroupComponent;
+
+type IconButtonVariant = 'contained' | 'outlined' | 'invisible';
+type IconButtonColorVariantCombination = {
+    color?: 'primary';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'accent';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'critical';
+    variant?: 'contained' | 'outlined' | 'invisible';
+} | {
+    color?: 'assistive';
+    variant?: 'contained';
+} | {
+    color?: 'inverse';
+    variant?: 'contained';
+};
+type IconButtonProps = Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & IconButtonColorVariantCombination & {
+    icon: React__default.ReactElement<{
+        className?: string;
+    }>;
+    variant?: IconButtonVariant;
+    size?: 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
+    /** 툴팁 설정 (문자열 또는 FlatTooltip 설정 객체) */
+    tooltip?: ComponentProps<typeof ConditionalTooltip>['tooltip'];
+};
+type IconButtonComponent = React__default.ForwardRefExoticComponent<IconButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
+declare const IconButton: IconButtonComponent;
+
+type CheckboxSize = 'small' | 'medium' | 'large';
+type LabelPosition = 'left' | 'right';
+interface CheckboxProps extends React__default.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root> {
+    /** 체크 상태. `'indeterminate'`는 부분 선택을 나타냅니다. */
+    checked?: boolean | 'indeterminate';
+    /** 체크박스 옆에 표시할 레이블 */
+    label?: React__default.ReactNode;
+    /** 추가 클래스명 */
+    className?: string;
+    /**
+     * 체크박스 크기
+     * @default 'medium'
+     */
+    size?: CheckboxSize;
+    /**
+     * 레이블 위치
+     * @default 'right'
+     */
+    labelPosition?: LabelPosition;
+    /** 체크 상태 변경 핸들러 */
+    onCheckedChange?: (checked: boolean) => void;
+    /** 초기 체크 상태 (비제어) */
+    defaultChecked?: boolean;
+    /**
+     * 비활성화 상태
+     * @default false
+     */
+    disabled?: boolean;
+}
+type CheckboxComponent = React__default.ForwardRefExoticComponent<CheckboxProps & React__default.RefAttributes<HTMLButtonElement>>;
+/**
+ * 하나 이상의 항목을 선택하는 체크박스 컴포넌트입니다.
+ * 체크, 미체크, indeterminate(부분 선택) 상태를 지원합니다.
+ *
+ * @example
+ * ```tsx
+ * // 기본 사용
+ * <Checkbox label="이용 약관에 동의합니다" />
+ *
+ * // 제어 컴포넌트
+ * <Checkbox checked={isChecked} onCheckedChange={setIsChecked} label="선택" />
+ *
+ * // 부분 선택 상태
+ * <Checkbox checked="indeterminate" label="전체 선택" />
+ * ```
+ *
+ * @see {@link CheckboxProps} props 상세
+ */
+declare const Checkbox: CheckboxComponent;
+
+type RadioRootProps = React__default.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root>;
+type RadioItemProps = React__default.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item> & {
+    /**
+     * 라디오 버튼 크기
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium' | 'large';
+    /** 라디오 버튼 옆에 표시할 레이블 */
+    label?: React__default.ReactNode;
+    /**
+     * 레이블 위치
+     * @default 'right'
+     */
+    labelPosition?: 'left' | 'right';
+};
+type RadioComponent = React__default.ForwardRefExoticComponent<RadioRootProps & React__default.RefAttributes<React__default.ElementRef<typeof RadioGroupPrimitive.Root>>> & {
+    Item: React__default.ForwardRefExoticComponent<RadioItemProps & React__default.RefAttributes<React__default.ElementRef<typeof RadioGroupPrimitive.Item>>>;
+};
+/**
+ * 여러 옵션 중 하나를 선택하는 라디오 그룹 컴포넌트입니다.
+ * Compound Component 패턴으로 `Radio.Item`과 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Radio defaultValue="a">
+ *   <Radio.Item value="a" label="옵션 A" />
+ *   <Radio.Item value="b" label="옵션 B" />
+ * </Radio>
+ * ```
+ *
+ * @see {@link RadioRootProps} 루트 props 상세
+ * @see {@link RadioItemProps} 아이템 props 상세
+ */
+declare const Radio: RadioComponent;
+
+declare const switchVariants: (props?: ({
+    size?: "small" | "medium" | "large" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SwitchProps extends React__default.ComponentPropsWithoutRef<typeof SwitchPrimitives.Root>, VariantProps<typeof switchVariants> {
+    /** 스위치 옆에 표시할 레이블 텍스트 */
+    label?: string;
+    /**
+     * 레이블 위치
+     * @default 'right'
+     */
+    labelPosition?: 'left' | 'right';
+}
+type SwitchComponent = React__default.ForwardRefExoticComponent<SwitchProps & React__default.RefAttributes<HTMLButtonElement>>;
+/**
+ * 켜기/끄기 상태를 전환하는 스위치 컴포넌트입니다.
+ *
+ * @example
+ * ```tsx
+ * <Switch label="알림 받기" size="medium" />
+ * <Switch label="다크 모드" labelPosition="left" defaultChecked />
+ * ```
+ *
+ * @see {@link SwitchProps} props 상세
+ */
+declare const Switch: SwitchComponent;
+
+type DistributiveOmit<T, K extends string> = T extends unknown ? Omit<T, K> : never;
+type DatePickerProps = DistributiveOmit<ComponentProps<typeof DayPicker>, 'mode'> & {
+    /** 날짜 선택 유형 */
+    type?: 'single' | 'range';
+};
+declare function DatePicker({ type, showOutsideDays, ...rest }: DatePickerProps): react_jsx_runtime.JSX.Element;
+
+type TextAreaLabelProps = {
+    children: React$1.ReactNode;
+    required?: boolean;
+    className?: string;
+};
+type TextAreaFieldProps = Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size' | 'disabled' | 'id' | 'value' | 'onChange' | 'maxLength'>;
+type TextAreaDescriptionProps = {
+    children?: React$1.ReactNode;
+    showCounter?: boolean;
+    className?: string;
+};
+type TextAreaRootProps = {
+    children?: React$1.ReactNode;
+    /**
+     * 입력 필드 스타일 유형
+     * @default 'fill'
+     */
+    variant?: Variant;
+    size?: Size;
+    error?: boolean;
+    disabled?: boolean;
+    /**
+     * TextArea의 기본값. Context를 통해 하위 컴포넌트로 전달됩니다.
+     * TextArea.Field에서 value prop이 전달되면 Field의 value가 우선 적용됩니다.
+     *
+     * 사용 패턴:
+     * - 통합 관리: <TextArea value={state}> - Context로 모든 Field에 적용
+     * - 개별 제어: <TextArea.Field value={localState}> - 특정 Field만 개별 제어
+     */
+    value?: string;
+    maxLength?: number;
+    className?: string;
+} & Omit<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size' | 'disabled' | 'id' | 'className'>;
+type TextAreaComponent = React$1.ForwardRefExoticComponent<TextAreaRootProps & React$1.RefAttributes<HTMLDivElement>> & {
+    Label: React$1.ForwardRefExoticComponent<TextAreaLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+    Field: React$1.ForwardRefExoticComponent<TextAreaFieldProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+    Description: React$1.ForwardRefExoticComponent<TextAreaDescriptionProps & React$1.RefAttributes<HTMLDivElement>>;
+};
+declare const TextArea: TextAreaComponent;
+
+type TextFieldRootProps = {
+    children?: React__default.ReactNode;
+    /**
+     * 입력 필드 스타일 유형
+     * @default 'fill'
+     */
+    variant?: Variant;
+    size?: Size;
+    error?: boolean;
+    disabled?: boolean;
+    className?: string;
+    value?: string;
+    onChange?: React__default.ChangeEventHandler<HTMLInputElement>;
+} & Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size' | 'disabled' | 'className' | 'value' | 'onChange'>;
+type TextFieldLabelProps = {
+    children: React__default.ReactNode;
+    required?: boolean;
+    className?: string;
+};
+type TextFieldInputProps = Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'size' | 'disabled' | 'id' | 'value' | 'onChange'> & {
+    leftIcon?: Icon;
+    rightIcon?: Icon;
+    subText?: string;
+};
+type TextFieldDescriptionProps = {
+    children: React__default.ReactNode;
+    className?: string;
+};
+type TextFieldComponent = React__default.ForwardRefExoticComponent<TextFieldRootProps & React__default.RefAttributes<HTMLDivElement>> & {
+    Label: React__default.ForwardRefExoticComponent<TextFieldLabelProps & React__default.RefAttributes<HTMLLabelElement>>;
+    Input: React__default.ForwardRefExoticComponent<TextFieldInputProps & React__default.RefAttributes<HTMLInputElement>>;
+    Description: React__default.ForwardRefExoticComponent<TextFieldDescriptionProps & React__default.RefAttributes<HTMLParagraphElement>>;
+};
+declare const TextField: TextFieldComponent;
+
+interface ScrollAreaProps extends React__default.ComponentProps<typeof ScrollAreaPrimitive.Root> {
+    /** 스크롤 뷰포트의 ref. 스크롤 위치 제어 시 사용합니다. */
+    scrollRef?: React__default.ComponentProps<typeof ScrollAreaPrimitive.Viewport>['ref'];
+    /** 세로 스크롤바 숨김 여부 */
+    hideVerticalScrollbar?: boolean;
+    /** 가로 스크롤바 숨김 여부 */
+    hideHorizontalScrollbar?: boolean;
+    /** 가로 스크롤 비활성화 (overflow-x: hidden) */
+    disableHorizontalScroll?: boolean;
+}
+declare function ScrollBar({ className, orientation, ...props }: React__default.ComponentProps<typeof ScrollAreaPrimitive.ScrollAreaScrollbar>): react_jsx_runtime.JSX.Element;
+/**
+ * 커스텀 스크롤바를 제공하는 스크롤 영역 컴포넌트입니다.
+ * 마우스 호버 시 스크롤바가 나타나는 UX를 제공합니다.
+ *
+ * @example
+ * ```tsx
+ * <ScrollArea className="h-[300px]">
+ *   <div>스크롤 가능한 콘텐츠</div>
+ * </ScrollArea>
+ * ```
+ *
+ * @see {@link ScrollAreaProps} props 상세
+ */
+declare function ScrollArea({ className, children, onScroll, scrollRef, hideVerticalScrollbar, hideHorizontalScrollbar, disableHorizontalScroll, ...props }: ScrollAreaProps): react_jsx_runtime.JSX.Element;
+
+type ModalSize = 'small' | 'medium' | 'large' | 'xlarge' | 'fullsize';
+type ModalRootProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+type ModalTriggerProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
+type ModalPortalProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Portal>;
+type ModalOverlayProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
+type ModalContentProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
+    /**
+     * 모달 크기
+     * @default 'medium'
+     */
+    size?: ModalSize;
+};
+type ModalCloseProps = Omit<ButtonProps, 'color' | 'variant'>;
+type ModalHeaderProps = React__default.HTMLAttributes<HTMLDivElement> & {
+    /**
+     * 하단 구분선 표시 여부
+     * @default false
+     */
+    line?: boolean;
+    /**
+     * 닫기 아이콘 표시 여부
+     * @default true
+     */
+    showCloseIcon?: boolean;
+};
+type ModalBodyProps = React__default.HTMLAttributes<HTMLDivElement>;
+type ModalFooterProps = React__default.HTMLAttributes<HTMLDivElement> & {
+    /**
+     * 상단 구분선 표시 여부
+     * @default true
+     */
+    line?: boolean;
+};
+type ModalFooterDescriptionProps = React__default.HTMLAttributes<HTMLDivElement> & {
+    /** 에러 상태 표시 여부 */
+    error?: boolean;
+    /** 설명 앞에 표시할 아이콘 요소 */
+    icon?: React__default.ReactNode;
+};
+type ModalActionsProps = React__default.HTMLAttributes<HTMLDivElement>;
+type ModalActionProps = Omit<ButtonProps, 'color' | 'variant'> & {
+    /**
+     * 버튼 색상
+     * @default 'primary'
+     */
+    color?: 'primary' | 'critical';
+};
+type ModalTitleProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+type ModalDescriptionProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+type ModalComponent = typeof DialogPrimitive.Root & {
+    Trigger: typeof DialogPrimitive.Trigger;
+    Portal: typeof DialogPrimitive.Portal;
+    Close: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalCloseProps> & React__default.RefAttributes<HTMLButtonElement>>;
+    Overlay: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalOverlayProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Overlay>>>;
+    Content: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalContentProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Content>>>;
+    Header: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalHeaderProps> & React__default.RefAttributes<HTMLDivElement>>;
+    Body: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalBodyProps> & React__default.RefAttributes<HTMLDivElement>>;
+    Footer: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalFooterProps> & React__default.RefAttributes<HTMLDivElement>>;
+    FooterDescription: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalFooterDescriptionProps> & React__default.RefAttributes<HTMLDivElement>>;
+    Actions: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalActionsProps> & React__default.RefAttributes<HTMLDivElement>>;
+    Action: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalActionProps> & React__default.RefAttributes<HTMLButtonElement>>;
+    Title: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalTitleProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Title>>>;
+    Description: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalDescriptionProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Description>>>;
+};
+/**
+ * 사용자 인터랙션이 필요한 오버레이 다이얼로그 컴포넌트입니다.
+ * Compound Component 패턴으로 하위 컴포넌트와 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Modal>
+ *   <Modal.Trigger>열기</Modal.Trigger>
+ *   <Modal.Content size="medium">
+ *     <Modal.Header>
+ *       <Modal.Title>제목</Modal.Title>
+ *     </Modal.Header>
+ *     <Modal.Body>내용</Modal.Body>
+ *     <Modal.Footer>
+ *       <Modal.Actions>
+ *         <Modal.Close>닫기</Modal.Close>
+ *       </Modal.Actions>
+ *     </Modal.Footer>
+ *   </Modal.Content>
+ * </Modal>
+ * ```
+ *
+ * @see {@link ModalContentProps} Content props 상세
+ */
+declare const Modal: ModalComponent;
+
+type MessageBoxVariant = 'default' | 'critical';
+type MessageBoxRootProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+type MessageBoxTriggerProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Trigger>;
+type MessageBoxContentProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & {
+    /**
+     * 메시지 박스 variant
+     * @default 'default'
+     */
+    variant?: MessageBoxVariant;
+};
+type MessageBoxTitleProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+type MessageBoxDescriptionProps = React__default.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+type MessageBoxActionsProps = React__default.HTMLAttributes<HTMLDivElement>;
+type MessageBoxCancelProps = Omit<ButtonProps, 'color' | 'variant'>;
+type MessageBoxActionProps = Omit<ButtonProps, 'color' | 'variant'>;
+type MessageBoxComponent = React__default.FC<MessageBoxRootProps> & {
+    Trigger: typeof DialogPrimitive.Trigger;
+    Content: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxContentProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Content>>>;
+    Title: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxTitleProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Title>>>;
+    Description: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxDescriptionProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Description>>>;
+    Actions: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxActionsProps> & React__default.RefAttributes<HTMLDivElement>>;
+    Cancel: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxCancelProps> & React__default.RefAttributes<HTMLButtonElement>>;
+    Action: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxActionProps> & React__default.RefAttributes<HTMLButtonElement>>;
+};
+declare const MessageBox: MessageBoxComponent;
+
+interface LoadingProps extends VariantProps<typeof containerVariants>, VariantProps<typeof spinnerVariants>, Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /**
+     * 로딩 표시 여부
+     * @default true
+     */
+    isLoading?: boolean;
+    /**
+     * 배경 딤 처리 여부
+     * @default true
+     */
+    dim?: boolean;
+    /**
+     * 로딩 중 하위 요소 인터랙션 차단 여부
+     * @default false
+     */
+    blockInteraction?: boolean;
+    /** 컨테이너 추가 클래스 */
+    containerClassName?: string;
+    /** 오버레이 추가 클래스 */
+    overlayClassName?: string;
+    /** 스피너 추가 클래스 */
+    spinnerClassName?: string;
+}
+type LoadingComponent = React__default.ForwardRefExoticComponent<LoadingProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const containerVariants: (props?: ({
+    position?: "fixed" | "absolute" | null | undefined;
+    blockInteraction?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const spinnerVariants: (props?: ({
+    size?: "small" | "medium" | "large" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * 비동기 작업 중 로딩 상태를 표시하는 오버레이 컴포넌트입니다.
+ *
+ * @example
+ * ```tsx
+ * // 기본 사용 (전체 화면 고정)
+ * <Loading isLoading />
+ *
+ * // 특정 영역 내 로딩 (absolute 위치)
+ * <div style={{ position: 'relative' }}>
+ *   <Loading isLoading position="absolute" size="small" />
+ * </div>
+ * ```
+ *
+ * @see {@link LoadingProps} props 상세
+ */
+declare const Loading: LoadingComponent;
+
+declare const trackVariants: (props?: ({
+    size?: "small" | "medium" | "large" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ProgressProps extends VariantProps<typeof trackVariants>, Omit<React__default.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /**
+     * 현재 진행 값
+     * @default 0
+     */
+    value?: number;
+    /**
+     * 최대 값
+     * @default 100
+     */
+    max?: number;
+    /** 트랙(배경) 추가 클래스 */
+    trackClassName?: string;
+    /** 게이지(채움) 추가 클래스 */
+    gaugeClassName?: string;
+}
+type ProgressComponent = React__default.ForwardRefExoticComponent<ProgressProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * 작업 진행률을 시각적으로 표시하는 바 컴포넌트입니다.
+ *
+ * @example
+ * ```tsx
+ * <Progress value={60} />
+ * <Progress value={30} max={100} size="large" />
+ * ```
+ */
+declare const Progress: ProgressComponent;
+
+type ToasterRootProps = React$1.ComponentProps<typeof Toaster$1>;
+type ToasterContainerProps = {
+    children: React$1.ReactNode;
+} & React$1.HTMLAttributes<HTMLDivElement>;
+type ToasterIconProps = {
+    children: React$1.ReactNode;
+} & React$1.HTMLAttributes<HTMLDivElement>;
+type ToasterTitleProps = {
+    children: React$1.ReactNode;
+} & React$1.HTMLAttributes<HTMLDivElement>;
+type ToasterDescriptionProps = {
+    children: React$1.ReactNode;
+} & React$1.HTMLAttributes<HTMLDivElement>;
+type ToasterActionProps = {
+    children?: React$1.ReactNode;
+    altText?: string;
+} & React$1.ButtonHTMLAttributes<HTMLButtonElement>;
+type ToasterComponent = React$1.FC<ToasterRootProps> & {
+    Container: React$1.ForwardRefExoticComponent<ToasterContainerProps & React$1.RefAttributes<HTMLDivElement>>;
+    Icon: React$1.ForwardRefExoticComponent<ToasterIconProps & React$1.RefAttributes<HTMLDivElement>>;
+    Title: React$1.ForwardRefExoticComponent<ToasterTitleProps & React$1.RefAttributes<HTMLDivElement>>;
+    Description: React$1.ForwardRefExoticComponent<ToasterDescriptionProps & React$1.RefAttributes<HTMLDivElement>>;
+    Action: React$1.ForwardRefExoticComponent<ToasterActionProps & React$1.RefAttributes<HTMLButtonElement>>;
+};
+declare const Toaster: ToasterComponent;
+
+interface ToastProviderProps {
+    children?: React__default.ReactNode;
+    /**
+     * 호버 시 토스트 확장
+     * @default true
+     */
+    expand?: boolean;
+    /**
+     * Rich colors 스타일 적용
+     * @default false
+     */
+    richColors?: boolean;
+    /**
+     * Provider 레벨 닫기 버튼
+     * @default false
+     */
+    closeButton?: boolean;
+    /**
+     * 토스트가 표시될 위치
+     * @default 'top-center'
+     */
+    position?: 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    /**
+     * 토스트 표시 시간 (ms)
+     * @default 4000
+     */
+    duration?: number;
+    /**
+     * 토스트 최대 개수
+     * @default 10
+     */
+    visibleToasts?: number;
+    /**
+     * 추가 Toaster props
+     */
+    toasterProps?: Omit<ToasterRootProps, 'children' | 'expand' | 'richColors' | 'closeButton'>;
+}
+declare const ToastProvider: React__default.FC<ToastProviderProps>;
+
+interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+interface ToastOptions {
+    title: string;
+    description?: string;
+    action?: ToastAction;
+    close?: boolean;
+}
+interface ExtendedExternalToast extends ExternalToast {
+    description?: string;
+    action?: ToastAction;
+    close?: boolean;
+}
+type ToastInput = string | ToastOptions;
+/**
+ * toast() — 커스텀 디자인이 적용된 toast 함수
+ *
+ * sonner의 toast를 래핑하여 프로젝트의 디자인 시스템을 자동으로 적용합니다.
+ *
+ * @example
+ * ```tsx
+ * import { toast } from '@exem-ui/react';
+ *
+ * // 간단한 메시지
+ * toast('기본 메시지');
+ * toast.success('성공');
+ * toast.error('오류');
+ * toast.info('정보');
+ * toast.warning('경고');
+ *
+ * // title + description + action
+ * toast.success({
+ *   title: '저장 완료',
+ *   description: '변경사항이 저장되었습니다.',
+ *   action: { label: '되돌리기', onClick: () => handleUndo() },
+ * });
+ *
+ * // 닫기 버튼
+ * toast.success({ title: '저장 완료', close: true });
+ *
+ * // 문자열 + 옵션 (sonner 스타일)
+ * toast.success('생성 완료', {
+ *   description: '일요일, 12월 3일',
+ *   action: { label: 'Undo', onClick: () => console.log('Undo') },
+ * });
+ * ```
+ */
+declare const toast: ((input: ToastInput, options?: ExtendedExternalToast) => string | number) & {
+    success: (input: ToastInput, options?: ExtendedExternalToast) => string | number;
+    error: (input: ToastInput, options?: ExtendedExternalToast) => string | number;
+    info: (input: ToastInput, options?: ExtendedExternalToast) => string | number;
+    warning: (input: ToastInput, options?: ExtendedExternalToast) => string | number;
+    loading: (input: ToastInput, options?: ExtendedExternalToast) => string | number;
+    dismiss: (id?: number | string) => string | number;
+    promise: typeof toast$1.promise;
+    custom: (jsx: (id: number | string) => React.ReactElement, data?: ExternalToast) => string | number;
+};
+
+type Options = ExternalToast & {
+    description?: React__default.ReactNode;
+};
+type PromiseOptions<T> = {
+    loading: string;
+    success: string | ((data: T) => string | React__default.ReactNode);
+    error: string | ((error: unknown) => string | React__default.ReactNode);
+    description?: string | React__default.ReactNode;
+    finally?: () => void | Promise<void>;
+};
+
+/**
+ * @deprecated `toast` 함수를 직접 사용하세요.
+ *
+ * 하위호환을 위해 유지되며, 내부적으로 `toast`에 위임합니다.
+ *
+ * @example
+ * ```tsx
+ * // Before (useToast)
+ * const { success } = useToast();
+ * success('완료');
+ *
+ * // After (toast 직접 사용)
+ * import { toast } from '@exem-ui/react';
+ * toast.success('완료');
+ * ```
+ */
+declare function useToast(): {
+    show: (message: string, options?: Options) => string | number;
+    dismiss: (toastId: string | number) => string | number;
+    promise: <T>(promiseTask: Promise<T>, options: PromiseOptions<T>, toastOptions?: Options) => (string & {
+        unwrap: () => Promise<T>;
+    }) | (number & {
+        unwrap: () => Promise<T>;
+    }) | {
+        unwrap: () => Promise<T>;
+    };
+    custom: (render: (id: string | number) => React__default.ReactElement, options?: Options) => string | number;
+    success: (message?: string, options?: Options) => string | number;
+    error: (message?: string, options?: Options) => string | number;
+    info: (message?: string, options?: Options) => string | number;
+    warning: (message?: string, options?: Options) => string | number;
+    loading: (message?: string, options?: Options) => string | number;
+};
+
+export { Avatar, type AvatarComponent, type AvatarProps, Badge, type BadgeComponent, type BadgeProps, Breadcrumb, type BreadcrumbComponent, type BreadcrumbEllipsisProps, type BreadcrumbItemProps, type BreadcrumbLinkProps, type BreadcrumbListProps, type BreadcrumbPageProps, type BreadcrumbRootProps, type BreadcrumbSeparatorProps, Button, type ButtonComponent, ButtonGroup, type ButtonGroupComponent, type ButtonGroupItem, type ButtonGroupProps, type ButtonProps, Checkbox, type CheckboxComponent, type CheckboxProps, DatePicker, type DatePickerProps, DoubleTag, type DoubleTagProps, type ExtendedExternalToast, IconButton, type IconButtonComponent, type IconButtonProps, Loading, type LoadingComponent, type LoadingProps, MessageBox, type MessageBoxActionProps, type MessageBoxActionsProps, type MessageBoxCancelProps, type MessageBoxComponent, type MessageBoxContentProps, type MessageBoxDescriptionProps, type MessageBoxRootProps, type MessageBoxTitleProps, type MessageBoxTriggerProps, type MessageBoxVariant, Modal, type ModalActionsProps, type ModalBodyProps, type ModalCloseProps, type ModalComponent, type ModalContentProps, type ModalDescriptionProps, type ModalFooterDescriptionProps, type ModalFooterProps, type ModalHeaderProps, type ModalOverlayProps, type ModalPortalProps, type ModalRootProps, type ModalTitleProps, type ModalTriggerProps, Progress, type ProgressComponent, type ProgressProps, Radio, type RadioComponent, type RadioItemProps, type RadioRootProps, ScrollArea, type ScrollAreaProps, ScrollBar, Segment, type SegmentComponent, type SegmentContentProps, type SegmentItemProps, type SegmentListProps, type SegmentRootProps, Select, type SelectBoxProps, type SelectComponent, type SelectDescriptionProps, type SelectEmptyProps, type SelectGroupProps, type SelectItemProps, type SelectLabelProps, type SelectListProps, type SelectRootProps, type SelectTriggerProps, type Options as SonnerToastOptions, Star, type StarComponent, type StarProps, Switch, type SwitchComponent, type SwitchProps, Tabs, type TabsComponent, type TabsContentProps, type TabsListProps, type TabsRootProps, type TabsTriggerProps, Tag, type TagColor, type TagComponent, type TagProps, TextArea, type TextAreaComponent, type TextAreaDescriptionProps, type TextAreaFieldProps, type TextAreaLabelProps, type TextAreaRootProps, TextField, type TextFieldComponent, type TextFieldDescriptionProps, type TextFieldInputProps, type TextFieldLabelProps, type TextFieldRootProps, type ToastAction, type ToastInput, type ToastOptions, ToastProvider, type ToastProviderProps, Toaster, type ToasterActionProps, type ToasterComponent, type ToasterContainerProps, type ToasterDescriptionProps, type ToasterIconProps, type ToasterRootProps, type ToasterTitleProps, Tooltip, type TooltipComponent, type TooltipContentProps, type TooltipDescriptionProps, type TooltipProviderProps, type TooltipRootProps, type TooltipTitleProps, type TooltipTriggerProps, toast, useToast };