@exem-ui/react 0.3.2 → 0.3.3-next.20260309061812

package/dist/FlatTooltip-Dyj1pCh4.d.mts

@@ -0,0 +1,251 @@
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import * as React$1 from 'react';
+import React__default, { ComponentProps } from 'react';
+import * as SelectPrimitive from '@radix-ui/react-select';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from '@exem-ui/core/utils';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+
+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;
+}
+
+export { FlatTooltip as A, ConditionalTooltip as C, type FlatTooltipProps as F, type Icon as I, type Size as S, Tooltip as T, type Variant as V, Select as a, type SelectBoxProps as b, type SelectComponent as c, type SelectDescriptionProps as d, type SelectEmptyProps as e, type SelectGroupProps as f, type SelectItemProps as g, type SelectLabelProps as h, type SelectListProps as i, type SelectRootProps as j, type SelectTriggerProps as k, Segment as l, type SegmentComponent as m, type SegmentContentProps as n, type SegmentItemProps as o, type SegmentListProps as p, type SegmentRootProps as q, type TooltipComponent as r, type TooltipContentProps as s, type TooltipDescriptionProps as t, type TooltipProviderProps as u, type TooltipRootProps as v, type TooltipTitleProps as w, type TooltipTriggerProps as x, type ConditionalTooltipProps as y, type TooltipConfig as z };

package/dist/FlatTooltip-Dyj1pCh4.d.ts

@@ -0,0 +1,251 @@
+import * as TabsPrimitive from '@radix-ui/react-tabs';
+import * as React$1 from 'react';
+import React__default, { ComponentProps } from 'react';
+import * as SelectPrimitive from '@radix-ui/react-select';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from '@exem-ui/core/utils';
+import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+
+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;
+}
+
+export { FlatTooltip as A, ConditionalTooltip as C, type FlatTooltipProps as F, type Icon as I, type Size as S, Tooltip as T, type Variant as V, Select as a, type SelectBoxProps as b, type SelectComponent as c, type SelectDescriptionProps as d, type SelectEmptyProps as e, type SelectGroupProps as f, type SelectItemProps as g, type SelectLabelProps as h, type SelectListProps as i, type SelectRootProps as j, type SelectTriggerProps as k, Segment as l, type SegmentComponent as m, type SegmentContentProps as n, type SegmentItemProps as o, type SegmentListProps as p, type SegmentRootProps as q, type TooltipComponent as r, type TooltipContentProps as s, type TooltipDescriptionProps as t, type TooltipProviderProps as u, type TooltipRootProps as v, type TooltipTitleProps as w, type TooltipTriggerProps as x, type ConditionalTooltipProps as y, type TooltipConfig as z };