@exem-ui/react 0.3.4-next.20260902003121 → 0.3.4-next.20260908085941

package/dist/{FlatTooltip-DqHMNx-V.d.mts → FlatTooltip-CQYzMWkr.d.mts}

@@ -390,4 +390,4 @@ declare namespace ConditionalTooltip {
     var displayName: string;
 }
 
-export { type TooltipDescriptionProps as A, type TooltipProviderProps as B, type ColorPaletteColor as C, type TooltipRootProps as D, type TooltipTitleProps as E, type TooltipTriggerProps as F, type ColorPaletteProps as G, type ColorPaletteSwatchProps as H, type Icon as I, ColorPalette as J, ColorPaletteColors as K, DEFAULT_COLOR as L, getColorPaletteColor as M, isInPalette as N, type ConditionalTooltipProps as O, type FlatTooltipProps as P, type TooltipConfig as Q, FlatTooltip as R, type Size as S, Tabs as T, type Variant as V, ConditionalTooltip as a, type TabsComponent as b, type TabsContentProps as c, type TabsListProps as d, type TabsRootProps as e, type TabsTriggerProps as f, Select as g, type SelectBoxProps as h, type SelectComponent as i, type SelectDescriptionProps as j, type SelectEmptyProps as k, type SelectGroupProps as l, type SelectItemProps as m, type SelectLabelProps as n, type SelectListProps as o, type SelectRootProps as p, type SelectTriggerProps as q, Segment as r, type SegmentComponent as s, type SegmentContentProps as t, type SegmentItemProps as u, type SegmentListProps as v, type SegmentRootProps as w, Tooltip as x, type TooltipComponent as y, type TooltipContentProps as z };
+export { type TooltipDescriptionProps as A, type TooltipProviderProps as B, type ColorPaletteColor as C, type TooltipRootProps as D, type TooltipTitleProps as E, type TooltipTriggerProps as F, type ColorPaletteProps as G, type ColorPaletteSwatchProps as H, type Icon as I, ColorPalette as J, ColorPaletteColors as K, DEFAULT_COLOR as L, getColorPaletteColor as M, isInPalette as N, type FlatTooltipProps as O, type TooltipConfig as P, ConditionalTooltip as Q, FlatTooltip as R, type Size as S, Tabs as T, type Variant as V, type ConditionalTooltipProps as a, type TabsComponent as b, type TabsContentProps as c, type TabsListProps as d, type TabsRootProps as e, type TabsTriggerProps as f, Select as g, type SelectBoxProps as h, type SelectComponent as i, type SelectDescriptionProps as j, type SelectEmptyProps as k, type SelectGroupProps as l, type SelectItemProps as m, type SelectLabelProps as n, type SelectListProps as o, type SelectRootProps as p, type SelectTriggerProps as q, Segment as r, type SegmentComponent as s, type SegmentContentProps as t, type SegmentItemProps as u, type SegmentListProps as v, type SegmentRootProps as w, Tooltip as x, type TooltipComponent as y, type TooltipContentProps as z };

package/dist/{FlatTooltip-DqHMNx-V.d.ts → FlatTooltip-CQYzMWkr.d.ts}

@@ -390,4 +390,4 @@ declare namespace ConditionalTooltip {
     var displayName: string;
 }
 
-export { type TooltipDescriptionProps as A, type TooltipProviderProps as B, type ColorPaletteColor as C, type TooltipRootProps as D, type TooltipTitleProps as E, type TooltipTriggerProps as F, type ColorPaletteProps as G, type ColorPaletteSwatchProps as H, type Icon as I, ColorPalette as J, ColorPaletteColors as K, DEFAULT_COLOR as L, getColorPaletteColor as M, isInPalette as N, type ConditionalTooltipProps as O, type FlatTooltipProps as P, type TooltipConfig as Q, FlatTooltip as R, type Size as S, Tabs as T, type Variant as V, ConditionalTooltip as a, type TabsComponent as b, type TabsContentProps as c, type TabsListProps as d, type TabsRootProps as e, type TabsTriggerProps as f, Select as g, type SelectBoxProps as h, type SelectComponent as i, type SelectDescriptionProps as j, type SelectEmptyProps as k, type SelectGroupProps as l, type SelectItemProps as m, type SelectLabelProps as n, type SelectListProps as o, type SelectRootProps as p, type SelectTriggerProps as q, Segment as r, type SegmentComponent as s, type SegmentContentProps as t, type SegmentItemProps as u, type SegmentListProps as v, type SegmentRootProps as w, Tooltip as x, type TooltipComponent as y, type TooltipContentProps as z };
+export { type TooltipDescriptionProps as A, type TooltipProviderProps as B, type ColorPaletteColor as C, type TooltipRootProps as D, type TooltipTitleProps as E, type TooltipTriggerProps as F, type ColorPaletteProps as G, type ColorPaletteSwatchProps as H, type Icon as I, ColorPalette as J, ColorPaletteColors as K, DEFAULT_COLOR as L, getColorPaletteColor as M, isInPalette as N, type FlatTooltipProps as O, type TooltipConfig as P, ConditionalTooltip as Q, FlatTooltip as R, type Size as S, Tabs as T, type Variant as V, type ConditionalTooltipProps as a, type TabsComponent as b, type TabsContentProps as c, type TabsListProps as d, type TabsRootProps as e, type TabsTriggerProps as f, Select as g, type SelectBoxProps as h, type SelectComponent as i, type SelectDescriptionProps as j, type SelectEmptyProps as k, type SelectGroupProps as l, type SelectItemProps as m, type SelectLabelProps as n, type SelectListProps as o, type SelectRootProps as p, type SelectTriggerProps as q, Segment as r, type SegmentComponent as s, type SegmentContentProps as t, type SegmentItemProps as u, type SegmentListProps as v, type SegmentRootProps as w, Tooltip as x, type TooltipComponent as y, type TooltipContentProps as z };

package/dist/flat/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as ColorPaletteColor, G as ColorPaletteProps, I as Icon, S as Size, V as Variant, u as SegmentItemProps, w as SegmentRootProps, g as Select, f as TabsTriggerProps, e as TabsRootProps } from '../FlatTooltip-DqHMNx-V.mjs';
-export { a as ConditionalTooltip, O as ConditionalTooltipProps, R as FlatTooltip, P as FlatTooltipProps, Q as TooltipConfig } from '../FlatTooltip-DqHMNx-V.mjs';
+import { C as ColorPaletteColor, G as ColorPaletteProps, I as Icon, S as Size, V as Variant, u as SegmentItemProps, w as SegmentRootProps, g as Select, f as TabsTriggerProps, e as TabsRootProps } from '../FlatTooltip-CQYzMWkr.mjs';
+export { Q as ConditionalTooltip, a as ConditionalTooltipProps, R as FlatTooltip, O as FlatTooltipProps, P as TooltipConfig } from '../FlatTooltip-CQYzMWkr.mjs';
 import { ReactNode, ComponentProps } from 'react';
 import '@radix-ui/react-tabs';
 import '@radix-ui/react-radio-group';

package/dist/flat/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as ColorPaletteColor, G as ColorPaletteProps, I as Icon, S as Size, V as Variant, u as SegmentItemProps, w as SegmentRootProps, g as Select, f as TabsTriggerProps, e as TabsRootProps } from '../FlatTooltip-DqHMNx-V.js';
-export { a as ConditionalTooltip, O as ConditionalTooltipProps, R as FlatTooltip, P as FlatTooltipProps, Q as TooltipConfig } from '../FlatTooltip-DqHMNx-V.js';
+import { C as ColorPaletteColor, G as ColorPaletteProps, I as Icon, S as Size, V as Variant, u as SegmentItemProps, w as SegmentRootProps, g as Select, f as TabsTriggerProps, e as TabsRootProps } from '../FlatTooltip-CQYzMWkr.js';
+export { Q as ConditionalTooltip, a as ConditionalTooltipProps, R as FlatTooltip, O as FlatTooltipProps, P as TooltipConfig } from '../FlatTooltip-CQYzMWkr.js';
 import { ReactNode, ComponentProps } from 'react';
 import '@radix-ui/react-tabs';
 import '@radix-ui/react-radio-group';

package/dist/index.d.mts

@@ -2,17 +2,19 @@ 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 { C as ColorPaletteColor, a as ConditionalTooltip, S as Size$1, I as Icon, V as Variant } from './FlatTooltip-DqHMNx-V.mjs';
-export { J as ColorPalette, K as ColorPaletteColors, G as ColorPaletteProps, H as ColorPaletteSwatchProps, L as DEFAULT_COLOR, r as Segment, s as SegmentComponent, t as SegmentContentProps, u as SegmentItemProps, v as SegmentListProps, w as SegmentRootProps, g as Select, h as SelectBoxProps, i as SelectComponent, j as SelectDescriptionProps, k as SelectEmptyProps, l as SelectGroupProps, m as SelectItemProps, n as SelectLabelProps, o as SelectListProps, p as SelectRootProps, q as SelectTriggerProps, T as Tabs, b as TabsComponent, c as TabsContentProps, d as TabsListProps, e as TabsRootProps, f as TabsTriggerProps, x as Tooltip, y as TooltipComponent, z as TooltipContentProps, A as TooltipDescriptionProps, B as TooltipProviderProps, D as TooltipRootProps, E as TooltipTitleProps, F as TooltipTriggerProps, M as getColorPaletteColor, N as isInPalette } from './FlatTooltip-DqHMNx-V.mjs';
+import { C as ColorPaletteColor, a as ConditionalTooltipProps, S as Size$1, I as Icon, V as Variant } from './FlatTooltip-CQYzMWkr.mjs';
+export { J as ColorPalette, K as ColorPaletteColors, G as ColorPaletteProps, H as ColorPaletteSwatchProps, L as DEFAULT_COLOR, r as Segment, s as SegmentComponent, t as SegmentContentProps, u as SegmentItemProps, v as SegmentListProps, w as SegmentRootProps, g as Select, h as SelectBoxProps, i as SelectComponent, j as SelectDescriptionProps, k as SelectEmptyProps, l as SelectGroupProps, m as SelectItemProps, n as SelectLabelProps, o as SelectListProps, p as SelectRootProps, q as SelectTriggerProps, T as Tabs, b as TabsComponent, c as TabsContentProps, d as TabsListProps, e as TabsRootProps, f as TabsTriggerProps, x as Tooltip, y as TooltipComponent, z as TooltipContentProps, A as TooltipDescriptionProps, B as TooltipProviderProps, D as TooltipRootProps, E as TooltipTitleProps, F as TooltipTriggerProps, M as getColorPaletteColor, N as isInPalette } from './FlatTooltip-CQYzMWkr.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Button as Button$1 } from '@base-ui/react/button';
 import { I as IconBaseProps } from './types-xnO0gkCW.mjs';
 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 * as react_jsx_runtime from 'react/jsx-runtime';
 import { DayPicker } from 'react-day-picker';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import { Combobox as Combobox$1 } from '@base-ui/react/combobox';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
+import { Dialog } from '@base-ui/react/dialog';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import { Toaster as Toaster$1, ExternalToast, toast as toast$1 } from 'sonner';
 import '@radix-ui/react-tabs';
@@ -225,18 +227,15 @@ type ButtonVariantProps = {
     color?: ButtonColor;
     background?: ButtonBackground;
 };
-type ButtonProps = React__default.ButtonHTMLAttributes<HTMLButtonElement> & Omit<VariantProps<typeof buttonVariants>, 'variant' | 'color' | 'background'> & ButtonVariantProps & {
+
+type ButtonProps = Button$1.Props & ButtonVariantProps & {
     size?: ButtonSize;
     icon?: React__default.ReactElement<IconBaseProps>;
 };
-type ButtonComponent = React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
-declare const buttonVariants: (props?: ({
-    background?: "fill" | "none" | null | undefined;
-    color?: "accent" | "primary" | "critical" | null | undefined;
-    size?: "small" | "xsmall" | "medium" | "large" | "xlarge" | null | undefined;
-    variant?: "solid" | "assistive" | "outlined" | "invisible" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const Button: ButtonComponent;
+/** @see https://base-ui.com/react/components/button */
+declare function Button({ className, variant, color, background, size, icon, children, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
+/** @deprecated 컴포넌트 타입은 `typeof Button`으로 바로 얻을 수 있어 이 별칭은 불필요합니다. */
+type ButtonComponent = typeof Button;
 
 /** 색 이름 → Tailwind 토큰 class 매핑(배경/텍스트). 컴포넌트 내부 및 소비자용. */
 declare const colorPaletteColorClasses: Record<ColorPaletteColor, {
@@ -244,16 +243,15 @@ declare const colorPaletteColorClasses: Record<ColorPaletteColor, {
     text: string;
 }>;
 
-type ButtonGroupSize = 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge';
 interface ButtonGroupItem {
     id: string;
     label?: string;
     icon?: React__default.ReactElement<IconBaseProps>;
     /** 툴팁 설정 (문자열 또는 FlatTooltip 설정 객체) */
-    tooltip?: ComponentProps<typeof ConditionalTooltip>['tooltip'];
+    tooltip?: ConditionalTooltipProps['tooltip'];
     onClick?: () => void;
 }
-interface ButtonGroupProps {
+type ButtonGroupProps = Pick<React__default.ComponentProps<'div'>, 'aria-label' | 'aria-labelledby' | 'className' | 'ref'> & {
     /** 버튼 그룹 스타일 변형 */
     variant?: 'contained' | 'outlined';
     /** 아이콘만 표시 */
@@ -261,23 +259,23 @@ interface ButtonGroupProps {
     /** 배경색 표시 여부 (뒷 레이어가 보이지 않아야 할 때) */
     hasBackground?: boolean;
     /** 버튼 크기 */
-    size?: ButtonGroupSize;
+    size?: ButtonSize;
     /** 버튼 항목 목록 */
     items: ButtonGroupItem[];
-    /** 커스텀 className */
-    className?: string;
-}
-type ButtonGroupComponent = React__default.ForwardRefExoticComponent<ButtonGroupProps & React__default.RefAttributes<HTMLDivElement>>;
-declare const ButtonGroup: ButtonGroupComponent;
+};
+declare function ButtonGroup({ variant, iconOnly, hasBackground, size, items, className, ...props }: ButtonGroupProps): react_jsx_runtime.JSX.Element | null;
+/** @deprecated 컴포넌트 타입은 `typeof ButtonGroup`으로 바로 얻을 수 있어 이 별칭은 불필요합니다. */
+type ButtonGroupComponent = typeof ButtonGroup;
 
-type IconButtonProps = Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'children'> & ButtonVariantProps & {
+type IconButtonProps = ButtonProps & {
+    children?: never;
     icon: React__default.ReactElement<IconBaseProps>;
-    size?: ButtonSize;
     /** 툴팁 설정 (문자열 또는 FlatTooltip 설정 객체) */
-    tooltip?: ComponentProps<typeof ConditionalTooltip>['tooltip'];
+    tooltip?: ConditionalTooltipProps['tooltip'];
 };
-type IconButtonComponent = React__default.ForwardRefExoticComponent<IconButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
-declare const IconButton: IconButtonComponent;
+declare function IconButton({ className, tooltip, icon, size, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...props }: IconButtonProps): react_jsx_runtime.JSX.Element;
+/** @deprecated 컴포넌트 타입은 `typeof IconButton`으로 바로 얻을 수 있어 이 별칭은 불필요합니다. */
+type IconButtonComponent = typeof IconButton;
 
 type CheckboxSize = 'small' | 'medium' | 'large';
 type LabelPosition = 'left' | 'right';
@@ -640,19 +638,19 @@ declare function ScrollBar({ className, orientation, ...props }: React__default.
 declare function ScrollArea({ className, children, onScroll, scrollRef, hideVerticalScrollbar, hideHorizontalScrollbar, disableHorizontalScroll, ...props }: ScrollAreaProps): react_jsx_runtime.JSX.Element;
 
 type ModalSize = 'default' | '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> & {
+type ModalRootProps = Dialog.Root.Props;
+type ModalTriggerProps = Dialog.Trigger.Props;
+type ModalPortalProps = Dialog.Portal.Props;
+type ModalOverlayProps = Dialog.Backdrop.Props;
+type ModalContentProps = Dialog.Popup.Props & {
     /**
      * 모달 크기
      * @default 'default'
      */
     size?: ModalSize;
 };
-type ModalCloseProps = Omit<ButtonProps, 'color' | 'variant' | 'background'>;
-type ModalHeaderProps = React__default.HTMLAttributes<HTMLDivElement> & {
+type ModalCloseProps = Omit<ButtonProps, 'color' | 'variant' | 'background'> & React__default.RefAttributes<HTMLButtonElement>;
+type ModalHeaderProps = React__default.ComponentProps<'div'> & {
     /**
      * 하단 구분선 표시 여부
      * @default false
@@ -666,46 +664,141 @@ type ModalHeaderProps = React__default.HTMLAttributes<HTMLDivElement> & {
      */
     rightSlot?: React__default.ReactNode;
 };
-type ModalBodyProps = React__default.HTMLAttributes<HTMLDivElement>;
-type ModalFooterProps = React__default.HTMLAttributes<HTMLDivElement> & {
+type ModalBodyProps = React__default.ComponentProps<'div'> & {
+    /**
+     * 본문을 ScrollArea로 감쌀지 여부. 끄면 스크롤 컨테이너 없이 패딩만 남아
+     * 높이를 소비자가 직접 계산할 수 있다. 넘치는 콘텐츠도 잘리지 않는다.
+     * @default true
+     */
+    scroll?: boolean;
+    /**
+     * 가로 스크롤 허용 여부. 기본은 꺼져 있어 넓은 콘텐츠도 Body 폭 안에 갇힌다.
+     * 넓은 테이블처럼 가로 스크롤이 실제로 필요한 경우에만 켠다.
+     * `scroll={false}`면 의미가 없다.
+     * @default false
+     */
+    horizontalScroll?: boolean;
+};
+type ModalFooterProps = React__default.ComponentProps<'div'> & {
     /**
      * 상단 구분선 표시 여부
      * @default true
      */
     line?: boolean;
 };
-type ModalFooterDescriptionProps = React__default.HTMLAttributes<HTMLDivElement> & {
+type ModalFooterDescriptionProps = React__default.ComponentProps<'div'> & {
     /** 에러 상태 표시 여부 */
     error?: boolean;
     /** 설명 앞에 표시할 아이콘 요소 */
     icon?: React__default.ReactNode;
 };
-type ModalActionsProps = React__default.HTMLAttributes<HTMLDivElement>;
-type ModalActionProps = Omit<ButtonProps, 'color' | 'variant' | 'background'> & {
+type ModalActionsProps = React__default.ComponentProps<'div'>;
+type ModalActionProps = Omit<ButtonProps, 'color' | 'variant' | 'background'> & React__default.RefAttributes<HTMLButtonElement> & {
     /**
      * 버튼 색상
      * @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: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<ModalTriggerProps> & React__default.RefAttributes<React__default.ElementRef<typeof DialogPrimitive.Trigger>>>;
-    Portal: React__default.FC<ModalPortalProps>;
-    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>>>;
+type ModalTitleProps = Dialog.Title.Props;
+type ModalDescriptionProps = Dialog.Description.Props;
+/**
+ * 사용자 인터랙션이 필요한 오버레이 다이얼로그 컴포넌트입니다.
+ * Base UI Dialog 기반이며 Compound Component 패턴으로 하위 컴포넌트와 함께 사용합니다.
+ *
+ * @example
+ * ```tsx
+ * <Modal>
+ *   <Modal.Trigger>열기</Modal.Trigger>
+ *   <Modal.Content>
+ *     <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 상세
+ * @see https://base-ui.com/react/components/dialog
+ */
+declare function ModalRoot(props: ModalRootProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalRoot {
+    var displayName: string;
+}
+declare function ModalTrigger(props: ModalTriggerProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalTrigger {
+    var displayName: string;
+}
+declare function ModalPortal(props: ModalPortalProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalPortal {
+    var displayName: string;
+}
+declare function ModalOverlay({ className, ...props }: ModalOverlayProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalOverlay {
+    var displayName: string;
+}
+declare function ModalClose({ size, ...props }: ModalCloseProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalClose {
+    var displayName: string;
+}
+declare function ModalContent({ className, children, size, ...props }: ModalContentProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalContent {
+    var displayName: string;
+}
+declare function ModalHeader({ className, line, rightSlot, children, ...props }: ModalHeaderProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalHeader {
+    var displayName: string;
+}
+declare function ModalBody({ className, children, scroll, horizontalScroll, ...props }: ModalBodyProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalBody {
+    var displayName: string;
+}
+declare function ModalFooter({ className, line, ...props }: ModalFooterProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalFooter {
+    var displayName: string;
+}
+declare function ModalFooterDescription({ className, error, icon, children, ...props }: ModalFooterDescriptionProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalFooterDescription {
+    var displayName: string;
+}
+declare function ModalActions({ className, ...props }: ModalActionsProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalActions {
+    var displayName: string;
+}
+declare function ModalAction({ color, size, ...props }: ModalActionProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalAction {
+    var displayName: string;
+}
+declare function ModalTitle({ className, ...props }: ModalTitleProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalTitle {
+    var displayName: string;
+}
+declare function ModalDescription({ className, ...props }: ModalDescriptionProps): react_jsx_runtime.JSX.Element;
+declare namespace ModalDescription {
+    var displayName: string;
+}
+declare const Modal: typeof ModalRoot & {
+    Trigger: typeof ModalTrigger;
+    Portal: typeof ModalPortal;
+    Close: typeof ModalClose;
+    Overlay: typeof ModalOverlay;
+    Content: typeof ModalContent;
+    Header: typeof ModalHeader;
+    Body: typeof ModalBody;
+    Footer: typeof ModalFooter;
+    FooterDescription: typeof ModalFooterDescription;
+    Actions: typeof ModalActions;
+    Action: typeof ModalAction;
+    Title: typeof ModalTitle;
+    Description: typeof ModalDescription;
 };
-declare const Modal: ModalComponent;
+type ModalComponent = typeof Modal;
 
 type SheetResizeOptions = {
     /** @default true (객체를 전달한 경우) */
@@ -788,30 +881,83 @@ type SheetComponent = typeof DialogPrimitive.Root & {
 declare const Sheet: SheetComponent;
 
 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> & {
+type MessageBoxRootProps = Dialog.Root.Props;
+type MessageBoxTriggerProps = Dialog.Trigger.Props;
+type MessageBoxContentProps = Dialog.Popup.Props & {
     /**
      * 메시지 박스 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' | 'background'>;
-type MessageBoxActionProps = Omit<ButtonProps, 'color' | 'variant' | 'background'>;
-type MessageBoxComponent = React__default.FC<MessageBoxRootProps> & {
-    Trigger: React__default.ForwardRefExoticComponent<React__default.PropsWithoutRef<MessageBoxTriggerProps> & React__default.RefAttributes<React__default.ElementRef<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>>;
+type MessageBoxTitleProps = Dialog.Title.Props;
+type MessageBoxDescriptionProps = Dialog.Description.Props;
+type MessageBoxActionsProps = React__default.ComponentProps<'div'>;
+type MessageBoxCancelProps = Omit<ButtonProps, 'color' | 'variant' | 'background'> & React__default.RefAttributes<HTMLButtonElement>;
+type MessageBoxActionProps = Omit<ButtonProps, 'color' | 'variant' | 'background'> & React__default.RefAttributes<HTMLButtonElement>;
+/**
+ * 확인/경고 다이얼로그 컴포넌트입니다.
+ * Modal보다 단순한 구조로, title + description + 버튼(취소/확인)으로 구성됩니다.
+ *
+ * @example
+ * ```tsx
+ * <MessageBox>
+ *   <MessageBox.Trigger>열기</MessageBox.Trigger>
+ *   <MessageBox.Content variant="default">
+ *     <MessageBox.Title>상태를 확인하시겠습니까?</MessageBox.Title>
+ *     <MessageBox.Description>현재 상태에 대한 추가 확인이 필요합니다.</MessageBox.Description>
+ *     <MessageBox.Actions>
+ *       <MessageBox.Cancel>취소</MessageBox.Cancel>
+ *       <MessageBox.Action>확인</MessageBox.Action>
+ *     </MessageBox.Actions>
+ *   </MessageBox.Content>
+ * </MessageBox>
+ * ```
+ *
+ * @see https://base-ui.com/react/components/dialog
+ */
+declare function MessageBoxRoot(props: MessageBoxRootProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxRoot {
+    var displayName: string;
+}
+declare function MessageBoxTrigger(props: MessageBoxTriggerProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxTrigger {
+    var displayName: string;
+}
+declare function MessageBoxContent({ className, children, variant, ...props }: MessageBoxContentProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxContent {
+    var displayName: string;
+}
+declare function MessageBoxTitle({ className, ...props }: MessageBoxTitleProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxTitle {
+    var displayName: string;
+}
+declare function MessageBoxDescription({ className, ...props }: MessageBoxDescriptionProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxDescription {
+    var displayName: string;
+}
+declare function MessageBoxActions({ className, ...props }: MessageBoxActionsProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxActions {
+    var displayName: string;
+}
+declare function MessageBoxCancel({ size, ...props }: MessageBoxCancelProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxCancel {
+    var displayName: string;
+}
+declare function MessageBoxAction({ size, ...props }: MessageBoxActionProps): react_jsx_runtime.JSX.Element;
+declare namespace MessageBoxAction {
+    var displayName: string;
+}
+declare const MessageBox: typeof MessageBoxRoot & {
+    Trigger: typeof MessageBoxTrigger;
+    Content: typeof MessageBoxContent;
+    Title: typeof MessageBoxTitle;
+    Description: typeof MessageBoxDescription;
+    Actions: typeof MessageBoxActions;
+    Cancel: typeof MessageBoxCancel;
+    Action: typeof MessageBoxAction;
 };
-declare const MessageBox: MessageBoxComponent;
+type MessageBoxComponent = typeof MessageBox;
 
 declare const containerVariants: (props?: ({
     position?: "fixed" | "absolute" | null | undefined;