@3w-witim/ui 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,971 @@
+import { ClassValue } from 'clsx';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Class name utility (clsx + tailwind-merge)
+ */
+
+declare function cn(...inputs: ClassValue[]): string;
+
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "neutral" | "ghost" | "danger" | "danger-outline" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const inputVariants: (props?: ({
+    state?: "default" | "error" | null | undefined;
+    inputSize?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React.ComponentProps<"input">, "size">, VariantProps<typeof inputVariants> {
+    /** Presentational leading icon (e.g. search). Rendered inside the field. */
+    startIcon?: React.ReactNode;
+    /** Presentational trailing icon or affix. */
+    endIcon?: React.ReactNode;
+    /** Helper / error text rendered below the field. */
+    helperText?: React.ReactNode;
+}
+/**
+ * Presentation-only input. Wraps the native <input> so leading/trailing icons
+ * and helper text render with the field. Error state pairs colour with a
+ * status icon + helper text for non-colour accessibility.
+ */
+declare const Input: React.ForwardRefExoticComponent<Omit<InputProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+
+declare const textareaVariants: (props?: ({
+    state?: "default" | "error" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TextareaProps extends Omit<React.ComponentProps<"textarea">, "size">, VariantProps<typeof textareaVariants> {
+}
+declare const Textarea: React.ForwardRefExoticComponent<Omit<TextareaProps, "ref"> & React.RefAttributes<HTMLTextAreaElement>>;
+
+declare const cardVariants: (props?: ({
+    variant?: "default" | "raised" | "outline" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
+}
+declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+declare const CardHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+declare const ScrollArea: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ScrollBar: React.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+
+declare const labelVariants: (props?: ({
+    variant?: "neutral" | "danger" | "brand" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface LabelProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof labelVariants> {
+}
+declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLSpanElement>>;
+
+declare const skeletonVariants: (props?: ({
+    variant?: "text" | "circle" | "rect" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof skeletonVariants> {
+}
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const progressTrackVariants: (props?: ({
+    size?: "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const progressFillVariants: (props?: ({
+    indeterminate?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, VariantProps<typeof progressTrackVariants> {
+    /** Progress value between 0 and 100. Ignored when `indeterminate` is true. */
+    value?: number;
+    /** Shows an ongoing, unquantified progress animation. */
+    indeterminate?: boolean;
+    /** Accessible label describing what is loading. */
+    label?: string;
+}
+declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Checkbox — 20px box, radius xs(4px), 2px border, 12px check icon.
+ * off  = border-border-strong / bg-surface-default
+ * on   = bg-brand-solid + text-text-on-brand check
+ * error= border-danger-border
+ *
+ * Native input[type=checkbox]를 sr-only로 두고 span 박스를 시각 스타일링한다.
+ * 제어(checked) / 비제어(defaultChecked) 모두 지원하는 프리젠테이션 구현.
+ */
+declare const checkboxVariants: (props?: ({
+    state?: "default" | "error" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type CheckboxVariantProps = VariantProps<typeof checkboxVariants>;
+interface CheckboxProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size">, CheckboxVariantProps {
+    /** 우측에 표시할 라벨 (문자열/노드 모두 허용) */
+    label?: React.ReactNode;
+    /** 에러 상태 (state="error"와 동일, 편의용) */
+    error?: boolean;
+}
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLInputElement>>;
+
+interface RadioGroupProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** name shared by all radios in the group */
+    name?: string;
+    /** controlled selected value */
+    value?: string;
+    /** uncontrolled default selected value */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** disables every radio in the group */
+    disabled?: boolean;
+    /** renders every radio in the error state */
+    error?: boolean;
+}
+declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+declare const radioVariants: (props?: ({
+    state?: "default" | "error" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface RadioProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "type" | "size">, VariantProps<typeof radioVariants> {
+    /** required option value */
+    value: string;
+    /** visible label rendered next to the control */
+    label?: React.ReactNode;
+    /** optional helper/description text under the label */
+    description?: React.ReactNode;
+    /** force error styling on this single radio */
+    error?: boolean;
+    onValueChange?: (value: string) => void;
+}
+declare const Radio: React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLInputElement>>;
+
+declare const toggleTrackVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const toggleThumbVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ToggleProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onChange" | "type">, VariantProps<typeof toggleTrackVariants> {
+    /** Controlled on/off state. */
+    checked?: boolean;
+    /** Uncontrolled initial state. */
+    defaultChecked?: boolean;
+    /** Fired with the next boolean state when toggled. */
+    onCheckedChange?: (checked: boolean) => void;
+}
+declare const Toggle: React.ForwardRefExoticComponent<ToggleProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const chipVariants: (props?: ({
+    variant?: "default" | "selected" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ChipProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof chipVariants> {
+    /** Show a leading check icon when the chip is selected. */
+    showSelectedIcon?: boolean;
+    /** Render a trailing remove (x) affordance. */
+    removable?: boolean;
+    /** Called when the remove affordance is activated. */
+    onRemove?: () => void;
+    /** Accessible label for the remove control. */
+    removeLabel?: string;
+}
+declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const alertVariants: (props?: ({
+    variant?: "danger" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AlertProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
+}
+declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
+type AlertTitleProps = React.HTMLAttributes<HTMLParagraphElement>;
+declare const AlertTitle: React.ForwardRefExoticComponent<AlertTitleProps & React.RefAttributes<HTMLParagraphElement>>;
+type AlertDescriptionProps = React.HTMLAttributes<HTMLParagraphElement>;
+declare const AlertDescription: React.ForwardRefExoticComponent<AlertDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+
+type PresenceStatus = "online" | "away" | "offline" | "remote";
+type PresenceSize = "sm" | "md" | "lg";
+declare const PRESENCE_LABEL: Record<PresenceStatus, string>;
+interface PresenceProps extends React.HTMLAttributes<HTMLSpanElement> {
+    status?: PresenceStatus;
+    size?: PresenceSize;
+}
+declare function Presence({ status, size, className, ...props }: PresenceProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Avatar — 프로필 미설정 시 WITIM 마스코트 기본 이미지(이니셜 미사용).
+ * presence 표시는 공용 Presence 컴포넌트를 그대로 사용(온라인/자리비움 Z/재택 집/오프라인).
+ */
+declare const avatarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xs" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type AvatarSize = NonNullable<VariantProps<typeof avatarVariants>["size"]>;
+type AvatarPresence = PresenceStatus;
+interface AvatarProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof avatarVariants> {
+    /** 이미지 소스. 없거나 로드 실패 시 마스코트 기본 이미지 렌더(이니셜 미사용) */
+    src?: string;
+    /** 대체 텍스트 및 마스코트 색 배정 시드가 되는 이름 */
+    alt?: string;
+    /** 마스코트 색 — 사용자가 직접 선택(6색 동등). 미지정 시 이름 기반 기본값. */
+    color?: AvatarColor;
+    /** presence 상태 badge — 공용 Presence 컴포넌트로 렌더(자리비움 Z · 재택 집 · 오프라인 흐림) */
+    presence?: AvatarPresence;
+}
+/** 마스코트 색 — 6색 모두 동등한 위계. 사용자가 직접 선택하고 이후 변경 가능. */
+type AvatarColor = "gray" | "lavender" | "mint" | "peach" | "pink" | "sky";
+/** 선택 가능한 마스코트 색 목록 (동등 — 색상 선택 UI 구성용). */
+declare const AVATAR_COLORS: AvatarColor[];
+declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLSpanElement>>;
+interface AvatarImageProps extends React.ImgHTMLAttributes<HTMLImageElement> {
+    /** 로드 실패 시 사용할 마스코트 색(사용자 선택) */
+    color?: AvatarColor;
+    /** 로드 실패 시 색 미선택이면 색 배정에 쓸 시드(이름/ID) */
+    seed?: string;
+}
+declare const AvatarImage: React.ForwardRefExoticComponent<AvatarImageProps & React.RefAttributes<HTMLImageElement>>;
+interface AvatarFallbackProps extends React.HTMLAttributes<HTMLSpanElement> {
+}
+declare const AvatarFallback: React.ForwardRefExoticComponent<AvatarFallbackProps & React.RefAttributes<HTMLSpanElement>>;
+interface AvatarGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 최대 표시 개수. 초과분은 '+N' 카운터로 요약 */
+    max?: number;
+    /** 카운터/겹침 사이즈(자식 Avatar와 맞춤) */
+    size?: AvatarSize;
+}
+declare const AvatarGroup: React.ForwardRefExoticComponent<AvatarGroupProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Tooltip — presentation-only catalog component.
+ *
+ * Overlay/positioning here is a visual approximation for the design catalog
+ * (no @radix-ui). Real positioning/portal behavior is wired by the app dev.
+ * Placement is controlled via the `placement` prop; visibility via `open`
+ * (controlled) or hover (uncontrolled, using React.useState).
+ */
+type TooltipPlacement = "top" | "top-left" | "top-right" | "right" | "bottom" | "bottom-left" | "bottom-right" | "left";
+declare const tooltipContentVariants: (props?: ({
+    placement?: "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const tooltipArrowVariants: (props?: ({
+    placement?: "left" | "right" | "bottom" | "top" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TooltipProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content">, VariantProps<typeof tooltipContentVariants> {
+    /** The tooltip bubble content. */
+    content: React.ReactNode;
+    /** The trigger element the tooltip is anchored to. */
+    children: React.ReactNode;
+    /** Controlled visibility. When set, hover state is ignored. */
+    open?: boolean;
+    /** Show the arrow pointing at the trigger. */
+    arrow?: boolean;
+    /** Disable the tooltip entirely (never shows). */
+    disabled?: boolean;
+}
+declare const Tooltip: React.ForwardRefExoticComponent<TooltipProps & React.RefAttributes<HTMLDivElement>>;
+
+interface DropdownMenuProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Controlled open state. */
+    open?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Fired whenever the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+}
+declare const DropdownMenu: React.ForwardRefExoticComponent<DropdownMenuProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+}
+declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<DropdownMenuTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const dropdownMenuContentVariants: (props?: ({
+    align?: "end" | "start" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface DropdownMenuContentProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof dropdownMenuContentVariants> {
+    /** Force render even when closed (useful for catalog/visual specs). */
+    forceMount?: boolean;
+}
+declare const DropdownMenuContent: React.ForwardRefExoticComponent<DropdownMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+declare const dropdownMenuItemVariants: (props?: ({
+    variant?: "danger" | "default" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface DropdownMenuItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "disabled">, VariantProps<typeof dropdownMenuItemVariants> {
+    disabled?: boolean;
+    /** Optional leading icon element. */
+    icon?: React.ReactNode;
+    /** Optional trailing content (shortcut hint, chevron, etc.). */
+    trailing?: React.ReactNode;
+}
+declare const DropdownMenuItem: React.ForwardRefExoticComponent<DropdownMenuItemProps & React.RefAttributes<HTMLButtonElement>>;
+interface DropdownMenuLabelProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownMenuLabel: React.ForwardRefExoticComponent<DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuSeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuEmptyProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DropdownMenuEmpty: React.ForwardRefExoticComponent<DropdownMenuEmptyProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const selectTriggerVariants: (props?: ({
+    state?: "default" | "error" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SelectOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+}
+interface SelectProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange">, VariantProps<typeof selectTriggerVariants> {
+    /** Available options rendered in the dropdown panel. */
+    options: SelectOption[];
+    /** Currently selected value (controlled). */
+    value?: string;
+    /** Placeholder shown when no value is selected. */
+    placeholder?: string;
+    /** Fired when an option is chosen. */
+    onValueChange?: (value: string) => void;
+    /** Disable the whole control. */
+    disabled?: boolean;
+    /** Force the panel open (presentational / catalog use). */
+    defaultOpen?: boolean;
+    /** Accessible label for the trigger button. */
+    "aria-label"?: string;
+    /** Optional id linking to an external error message element. */
+    errorMessageId?: string;
+}
+/**
+ * Select — presentational dropdown for the design catalog.
+ *
+ * Open/close is managed with `React.useState`; wiring to a real
+ * accessibility-complete listbox library is left to the developer.
+ */
+declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLDivElement>>;
+
+interface DialogOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogOverlay: React.ForwardRefExoticComponent<DialogOverlayProps & React.RefAttributes<HTMLDivElement>>;
+declare const dialogPanelVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface DialogProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof dialogPanelVariants> {
+    /** Presentation-only open control. When false nothing renders. */
+    open?: boolean;
+    /** Fired when the overlay (or Escape) requests a close. */
+    onOpenChange?: (open: boolean) => void;
+    /** Accessible label id wired to aria-labelledby. */
+    "aria-labelledby"?: string;
+    /** Accessible description id wired to aria-describedby. */
+    "aria-describedby"?: string;
+    /** Class applied to the panel element. */
+    className?: string;
+    /** Class applied to the overlay element. */
+    overlayClassName?: string;
+}
+declare const Dialog: React.ForwardRefExoticComponent<DialogProps & React.RefAttributes<HTMLDivElement>>;
+interface DialogHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogHeader: React.ForwardRefExoticComponent<DialogHeaderProps & React.RefAttributes<HTMLDivElement>>;
+interface DialogTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+}
+declare const DialogTitle: React.ForwardRefExoticComponent<DialogTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+interface DialogDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+}
+declare const DialogDescription: React.ForwardRefExoticComponent<DialogDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+interface DialogBodyProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogBody: React.ForwardRefExoticComponent<DialogBodyProps & React.RefAttributes<HTMLDivElement>>;
+interface DialogFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const DialogFooter: React.ForwardRefExoticComponent<DialogFooterProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sheet — presentational bottom sheet (design catalog).
+ *
+ * Overlay + edge-anchored panel with an optional drag handle.
+ * Visibility is controlled via the `open` prop; `onOpenChange` is invoked
+ * when the overlay or close affordance is activated. Actual gesture /
+ * focus-trap behaviour is left to the app integration.
+ */
+declare const sheetOverlayVariants: (props?: ({
+    open?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const sheetPanelVariants: (props?: ({
+    side?: "left" | "right" | "bottom" | "top" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SheetProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof sheetPanelVariants> {
+    /** Whether the sheet is visible. */
+    open?: boolean;
+    /** Called when a dismiss affordance (overlay) is activated. */
+    onOpenChange?: (open: boolean) => void;
+    /** Show the drag handle (only meaningful for the bottom/top sides). */
+    showHandle?: boolean;
+    /** Accessible label for the dialog surface. */
+    "aria-label"?: string;
+}
+declare const Sheet: React.ForwardRefExoticComponent<SheetProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetHandle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const SheetHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const SheetTitle: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLHeadingElement> & React.RefAttributes<HTMLHeadingElement>>;
+declare const SheetDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const SheetBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const SheetFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+
+interface TabsProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Controlled active tab value. */
+    value?: string;
+    /** Initial active tab value (uncontrolled). */
+    defaultValue?: string;
+    /** Fires when the active tab changes. */
+    onValueChange?: (value: string) => void;
+}
+declare const Tabs: React.ForwardRefExoticComponent<TabsProps & React.RefAttributes<HTMLDivElement>>;
+declare const tabsListVariants: (props?: ({
+    fullWidth?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TabsListProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof tabsListVariants> {
+}
+declare const TabsList: React.ForwardRefExoticComponent<TabsListProps & React.RefAttributes<HTMLDivElement>>;
+declare const tabsTriggerVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TabsTriggerProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value"> {
+    /** Unique value identifying this tab. */
+    value: string;
+}
+declare const TabsTrigger: React.ForwardRefExoticComponent<TabsTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+interface TabsContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Value of the tab this panel belongs to. */
+    value: string;
+    /** Keep the panel mounted even when inactive (hidden via CSS). */
+    forceMount?: boolean;
+}
+declare const TabsContent: React.ForwardRefExoticComponent<TabsContentProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const tableVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TableProps extends React.TableHTMLAttributes<HTMLTableElement>, VariantProps<typeof tableVariants> {
+    /** Wrapper element props (the scroll container). */
+    containerProps?: React.HTMLAttributes<HTMLDivElement>;
+}
+declare const Table: React.ForwardRefExoticComponent<TableProps & React.RefAttributes<HTMLTableElement>>;
+type TableHeaderProps = React.HTMLAttributes<HTMLTableSectionElement>;
+declare const TableHeader: React.ForwardRefExoticComponent<TableHeaderProps & React.RefAttributes<HTMLTableSectionElement>>;
+type TableBodyProps = React.HTMLAttributes<HTMLTableSectionElement>;
+declare const TableBody: React.ForwardRefExoticComponent<TableBodyProps & React.RefAttributes<HTMLTableSectionElement>>;
+declare const tableRowVariants: (props?: ({
+    interactive?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TableRowProps extends React.HTMLAttributes<HTMLTableRowElement>, VariantProps<typeof tableRowVariants> {
+    /** Visual selected state (also drives aria-selected). */
+    selected?: boolean;
+}
+declare const TableRow: React.ForwardRefExoticComponent<TableRowProps & React.RefAttributes<HTMLTableRowElement>>;
+interface TableHeadProps extends React.ThHTMLAttributes<HTMLTableCellElement> {
+    /** Sort indicator for accessible sortable columns. */
+    sort?: "asc" | "desc" | "none";
+}
+declare const TableHead: React.ForwardRefExoticComponent<TableHeadProps & React.RefAttributes<HTMLTableCellElement>>;
+type TableCellProps = React.TdHTMLAttributes<HTMLTableCellElement>;
+declare const TableCell: React.ForwardRefExoticComponent<TableCellProps & React.RefAttributes<HTMLTableCellElement>>;
+type TableCaptionProps = React.HTMLAttributes<HTMLTableCaptionElement>;
+declare const TableCaption: React.ForwardRefExoticComponent<TableCaptionProps & React.RefAttributes<HTMLTableCaptionElement>>;
+
+declare const paginationItemVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PaginationItemProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "value">, VariantProps<typeof paginationItemVariants> {
+    /** Page number this item represents. */
+    page: number;
+}
+declare const PaginationItem: React.ForwardRefExoticComponent<PaginationItemProps & React.RefAttributes<HTMLButtonElement>>;
+declare const PaginationEllipsis: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+interface PaginationNavProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+}
+declare const PaginationPrevious: React.ForwardRefExoticComponent<PaginationNavProps & React.RefAttributes<HTMLButtonElement>>;
+declare const PaginationNext: React.ForwardRefExoticComponent<PaginationNavProps & React.RefAttributes<HTMLButtonElement>>;
+type PageRangeItem = number | "ellipsis";
+declare function buildPageRange(current: number, total: number, siblingCount?: number): PageRangeItem[];
+interface PaginationProps extends Omit<React.HTMLAttributes<HTMLElement>, "onChange"> {
+    /** Total number of pages. */
+    totalPages: number;
+    /** Currently active page (1-based). */
+    page: number;
+    /** Called when a page control is activated. */
+    onPageChange?: (page: number) => void;
+    /** How many page items to show on each side of the current page. */
+    siblingCount?: number;
+    /** Accessible label for the navigation landmark. */
+    label?: string;
+}
+declare const Pagination: React.ForwardRefExoticComponent<PaginationProps & React.RefAttributes<HTMLElement>>;
+
+/**
+ * SegmentedControl — 값 기반 세그먼트 컨트롤.
+ * height 32 · padding 2 · radius sm(8) · thumb radius 8 · font 14.
+ * 컨테이너 bg-surface-sunken, active thumb=bg-surface-default shadow-sm 슬라이드.
+ * value/onValueChange 로 제어(controlled) 하거나 defaultValue 로 비제어(uncontrolled).
+ */
+declare const segmentContainerVariants: (props?: ({
+    fullWidth?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const segmentItemVariants: (props?: ({
+    active?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SegmentedControlItem {
+    /** 세그먼트 값 (고유) */
+    value: string;
+    /** 표시 라벨 */
+    label: React.ReactNode;
+    /** 선택적 아이콘 (색만으로 정보전달 금지 — 아이콘/텍스트 병행 용도) */
+    icon?: React.ReactNode;
+    /** 개별 비활성화 */
+    disabled?: boolean;
+}
+interface SegmentedControlProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, VariantProps<typeof segmentContainerVariants> {
+    /** 세그먼트 항목 목록 */
+    items: SegmentedControlItem[];
+    /** 제어 값 */
+    value?: string;
+    /** 비제어 초기 값 */
+    defaultValue?: string;
+    /** 값 변경 콜백 */
+    onValueChange?: (value: string) => void;
+    /** 전체 비활성화 */
+    disabled?: boolean;
+    /** 접근성 라벨 */
+    "aria-label"?: string;
+}
+declare const SegmentedControl: React.ForwardRefExoticComponent<SegmentedControlProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Toast — presentation-only visual component (design catalog).
+ * TODO: A real ToastProvider / useToast hook (queueing, auto-dismiss,
+ * portal, aria-live region) must be wired by the app developer.
+ * This component renders a single toast surface for visual spec review.
+ */
+declare const toastVariants: (props?: ({
+    variant?: "danger" | "default" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ToastProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">, VariantProps<typeof toastVariants> {
+    /** Main message content of the toast. */
+    message: React.ReactNode;
+    /** Optional emphasized title rendered above the message. */
+    title?: React.ReactNode;
+    /** Render the leading status icon (default true). */
+    icon?: boolean;
+    /** Show the trailing close button (default true). */
+    dismissible?: boolean;
+    /** Fired when the close button is pressed. */
+    onClose?: () => void;
+    /** Accessible label for the close button. */
+    closeLabel?: string;
+}
+declare const Toast: React.ForwardRefExoticComponent<ToastProps & React.RefAttributes<HTMLDivElement>>;
+
+type EmptyStateSize = "lg" | "md" | "sm";
+interface EmptyStateProps extends React.HTMLAttributes<HTMLDivElement> {
+    size?: EmptyStateSize;
+    /** 라운드 플레이트 안에 들어갈 일러스트(TIMI 캐릭터). <img>/<svg> */
+    illustration?: React.ReactNode;
+    title: string;
+    description?: string;
+    /** 하단 CTA (예: <Button>) — 없으면 생략 */
+    action?: React.ReactNode;
+}
+declare function EmptyState({ size, illustration, title, description, action, className, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+interface AccordionItemData {
+    /** 고유 키(미지정 시 title 사용) */
+    id?: string;
+    /** 제목(요약 행) */
+    title: React.ReactNode;
+    /** 펼쳤을 때 본문 */
+    content: React.ReactNode;
+    /** 기본 펼침 여부 */
+    defaultOpen?: boolean;
+}
+interface AccordionItemProps extends Omit<React.ComponentPropsWithoutRef<"details">, "title"> {
+    /** 제목(요약 행) */
+    title: React.ReactNode;
+}
+/**
+ * 단일 아코디언 행. `<details>/<summary>` 기반 — JS 없이 펼침/접힘.
+ * 셰브론은 열림 시 180° 회전(group-open).
+ */
+declare const AccordionItem: React.ForwardRefExoticComponent<AccordionItemProps & React.RefAttributes<HTMLDetailsElement>>;
+interface AccordionProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 데이터 기반 렌더. 미지정 시 children 사용. */
+    items?: AccordionItemData[];
+}
+/**
+ * 아코디언 컨테이너(surface 카드). 행 사이 구분선, 첫 행은 상단선 없음.
+ * `items` prop으로 데이터 기반 렌더하거나 `children`으로 직접 조립.
+ */
+declare const Accordion: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<HTMLDivElement>>;
+
+interface KpiItem {
+    /** 지표/상태 라벨 */
+    label: string;
+    /** 값(문자열: 건수 "0", "21" 또는 "92%") */
+    value: string;
+    /** 상태 점 색 클래스(bg-*). 지정 시 라벨 앞에 상태 점 표시 — 색은 소비처 주입 */
+    dot?: string;
+}
+interface KpiRowProps extends React.HTMLAttributes<HTMLDivElement> {
+    items: KpiItem[];
+}
+declare const KpiRow: React.ForwardRefExoticComponent<KpiRowProps & React.RefAttributes<HTMLDivElement>>;
+interface ProgressItem {
+    label: string;
+    /** 0–100 */
+    pct: number;
+    /** 위험(초과 등) 강조 */
+    danger?: boolean;
+}
+interface ProgressListProps extends React.HTMLAttributes<HTMLDivElement> {
+    items: ProgressItem[];
+}
+declare const ProgressList: React.ForwardRefExoticComponent<ProgressListProps & React.RefAttributes<HTMLDivElement>>;
+interface RingProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 0–100 */
+    pct: number;
+    /** 지름(px) */
+    size?: number;
+    /** 가운데 라벨(기본: `${pct}%`) */
+    label?: React.ReactNode;
+}
+declare const Ring: React.ForwardRefExoticComponent<RingProps & React.RefAttributes<HTMLDivElement>>;
+interface StackSegment {
+    label: string;
+    /** 비율(%) */
+    pct: number;
+    /** 세그먼트 색 클래스(bg-*). 미지정 시 bg-brand-solid */
+    className?: string;
+}
+interface StackBarProps extends React.HTMLAttributes<HTMLDivElement> {
+    segments: StackSegment[];
+    /** 범례 표시 여부 */
+    showLegend?: boolean;
+}
+declare const StackBar: React.ForwardRefExoticComponent<StackBarProps & React.RefAttributes<HTMLDivElement>>;
+type WorkHoursState = "reached" | "unreached" | "pending";
+interface WorkHoursItem {
+    /** 요일 라벨 */
+    day: string;
+    /** 근무 시간 */
+    hours: number;
+    /** reached=목표도달 · unreached=미달 · pending=출근전 */
+    state: WorkHoursState;
+    /** 오늘 강조 */
+    today?: boolean;
+    /** 미래(예정) */
+    future?: boolean;
+}
+interface WorkHoursBarProps extends React.HTMLAttributes<HTMLDivElement> {
+    data: WorkHoursItem[];
+    /** y축 최대치(시간). 기본 12 */
+    max?: number;
+    /** 차트 높이(px). 기본 120 */
+    height?: number;
+    /** 하단 캡션 */
+    caption?: React.ReactNode;
+}
+declare const WorkHoursBar: React.ForwardRefExoticComponent<WorkHoursBarProps & React.RefAttributes<HTMLDivElement>>;
+
+/** 키보드 단축키 배지. 활성 행에선 현재 색(brand)을 따라간다. */
+interface KbdProps extends React.HTMLAttributes<HTMLElement> {
+    /** 활성(하이라이트) 컨텍스트에 놓였는지 여부. */
+    active?: boolean;
+}
+declare const Kbd: React.ForwardRefExoticComponent<KbdProps & React.RefAttributes<HTMLElement>>;
+/** 커맨드 팔레트의 개별 명령. */
+interface CommandItem {
+    /** 선택 콜백 식별용 고유 값. */
+    id: string;
+    /** 선행 아이콘(예: ./icons 의 PlusIcon). */
+    icon?: React.ReactNode;
+    /** 표시 라벨. */
+    label: string;
+    /** 단축키 표기(예: "⌘N"). */
+    kbd?: string;
+}
+/** 헤딩으로 묶인 명령 그룹. */
+interface CommandGroup {
+    /** 그룹 헤딩(생략 시 헤딩 없이 렌더). */
+    heading?: string;
+    items: CommandItem[];
+}
+interface CommandPaletteProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onSelect"> {
+    /** 그룹으로 묶인 명령 목록. */
+    groups: CommandGroup[];
+    /** 명령 선택 시 호출. */
+    onSelect?: (item: CommandItem) => void;
+    /** 현재 하이라이트(활성)된 명령의 id. */
+    activeId?: string;
+    /** 검색 입력의 표시 문구. */
+    placeholder?: string;
+    /** 검색 입력 우측에 표시할 단축키. */
+    searchKbd?: string;
+    /** 열림 여부. false면 렌더하지 않는다. */
+    open?: boolean;
+}
+/**
+ * 검색 입력 + 그룹 헤딩 + 결과 행(아이콘·라벨·단축키)으로 구성된 커맨드 팔레트.
+ * 활성 행은 brand-subtle 배경 + brand-text 로 하이라이트된다.
+ */
+declare const CommandPalette: React.ForwardRefExoticComponent<CommandPaletteProps & React.RefAttributes<HTMLDivElement>>;
+
+interface AvatarWithPresenceProps {
+    /** 이름 (Avatar alt) */
+    name: string;
+    /** presence 상태 — offline 이면 아바타 흐림(opacity .55) */
+    status?: PresenceStatus;
+    /** 마스코트 색 */
+    color?: AvatarColor;
+    /** 프로필 이미지 URL */
+    src?: string;
+    /** 아바타 크기 — 미지정 시 Avatar 자체 기본값 사용 */
+    size?: AvatarSize;
+    /** presence dot 링 색 — 얹히는 표면과 맞춘다(기본 surface-default) */
+    ringClassName?: string;
+    className?: string;
+}
+/** Avatar + Presence 코너 dot 조합(오프라인 흐림 포함) — 사이드바 DM·멤버 리스트 공용 SSOT. */
+declare const AvatarWithPresence: React.ForwardRefExoticComponent<AvatarWithPresenceProps & React.RefAttributes<HTMLSpanElement>>;
+
+interface SidebarSectionProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 섹션 제목 (예: "채널", "다이렉트 메시지") */
+    title: string;
+    /** 헤더 우측 추가(+) 버튼 노출 */
+    addable?: boolean;
+    /** 추가 버튼 클릭 핸들러 */
+    onAdd?: () => void;
+    /** 추가 버튼 접근성 레이블 */
+    addLabel?: string;
+}
+declare const SidebarSection: React.ForwardRefExoticComponent<SidebarSectionProps & React.RefAttributes<HTMLDivElement>>;
+interface SidebarChannelProps extends React.HTMLAttributes<HTMLButtonElement> {
+    /** 채널 이름 */
+    name: string;
+    /** 커스텀 아이콘. 미지정 시 locked에 따라 Lock/Hash */
+    icon?: React.ReactNode;
+    /** 비공개 채널 — 기본 아이콘을 자물쇠로 */
+    locked?: boolean;
+    /** 현재 선택된 채널 */
+    active?: boolean;
+    /** 미읽음 카운트 배지 */
+    badge?: string | number;
+}
+declare const SidebarChannel: React.ForwardRefExoticComponent<SidebarChannelProps & React.RefAttributes<HTMLButtonElement>>;
+interface SidebarDmProps extends React.HTMLAttributes<HTMLButtonElement> {
+    /** 상대 이름 */
+    name: string;
+    /** presence 상태 */
+    status?: PresenceStatus;
+    /** 마스코트 색 (Avatar 재사용). 미지정 시 이름 기반 기본값 */
+    color?: AvatarColor;
+    /** 프로필 이미지 URL (있으면 Avatar가 우선 사용) */
+    avatarSrc?: string;
+    /** 고정 표시 */
+    pinned?: boolean;
+}
+declare const SidebarDm: React.ForwardRefExoticComponent<SidebarDmProps & React.RefAttributes<HTMLButtonElement>>;
+/** 채널 아이템 데이터 (kind 생략 시 채널로 간주) */
+interface SidebarChannelData extends Omit<SidebarChannelProps, "className"> {
+    kind?: "channel";
+    /** 고유 키 */
+    id?: string;
+}
+/** DM 아이템 데이터 */
+interface SidebarDmData extends Omit<SidebarDmProps, "className"> {
+    kind: "dm";
+    /** 고유 키 */
+    id?: string;
+}
+type SidebarItem = SidebarChannelData | SidebarDmData;
+interface SidebarSectionData {
+    /** 섹션 제목 */
+    title: string;
+    /** 헤더 추가(+) 버튼 노출 */
+    addable?: boolean;
+    /** 추가 버튼 핸들러 */
+    onAdd?: () => void;
+    /** 섹션 아이템 목록 */
+    items: SidebarItem[];
+}
+interface SidebarProps extends React.HTMLAttributes<HTMLElement> {
+    /** 섹션 목록 (헤더 + 채널/DM 아이템) */
+    sections: SidebarSectionData[];
+    /** panel(기본: 라운드 카드) | shell(앱 셸 임베드: 라운드 없음·우측 보더·풀 높이 — 폭은 소비자가 className으로 지정) */
+    variant?: "panel" | "shell";
+}
+/** 사이드바 컨테이너 변형 (스토리 프리뷰·Sidebar 공용 SSOT) */
+declare const sidebarContainerVariants: (props?: ({
+    variant?: "panel" | "shell" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** 스토리/문서용 사이드바 패널 컨테이너 — Sidebar 컨테이너와 동일 크롬. 앱에서는 Sidebar(nav landmark)를 사용할 것. */
+declare const SidebarPanel: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const Sidebar: React.ForwardRefExoticComponent<SidebarProps & React.RefAttributes<HTMLElement>>;
+
+interface ListProps extends React.HTMLAttributes<HTMLUListElement> {
+    /** 컨테이너 테두리 + 라운드 표시 (기본 true) */
+    bordered?: boolean;
+    /** 행 사이 구분선 표시 (기본 true) */
+    divided?: boolean;
+}
+declare const List: React.ForwardRefExoticComponent<ListProps & React.RefAttributes<HTMLUListElement>>;
+interface ListItemProps extends Omit<React.LiHTMLAttributes<HTMLLIElement>, "title"> {
+    /** 좌측 요소(아바타/아이콘 등) */
+    leading?: React.ReactNode;
+    /** 제목(필수) */
+    title: React.ReactNode;
+    /** 보조 설명 */
+    description?: React.ReactNode;
+    /** 우측 요소(배지/버튼/아이콘 등) */
+    trailing?: React.ReactNode;
+}
+declare const ListItem: React.ForwardRefExoticComponent<ListItemProps & React.RefAttributes<HTMLLIElement>>;
+
+interface SuccessCheckProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** 뱃지 지름(px). 기본 22. 체크 아이콘은 이 값의 약 60%로 렌더된다. */
+    size?: number;
+}
+/**
+ * SuccessCheck — brand 솔리드 원형 배지 + 흰 체크.
+ * success/green 토큰 없이 완료 상태를 시맨틱 brand 토큰만으로 표현하는 프리미티브.
+ */
+declare const SuccessCheck: React.ForwardRefExoticComponent<SuccessCheckProps & React.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * Separator — presentation primitive (shadcn/Radix Separator 대응).
+ *
+ * 선 색은 시맨틱 토큰 `border-border-default`, 두께는 Foundation border-width(1px).
+ * - horizontal: 1px 풀폭 라인 (border-t)
+ * - vertical: 1px 세로 라인, 부모 높이 채움 (border-l + self-stretch)
+ * - label: 가운데 텍스트 + 양옆 flex-1 라인 (항상 horizontal)
+ *
+ * 접근성: 기본은 role="separator" + aria-orientation. `decorative`면 순수 장식으로
+ * 취급해 role="none" 으로 a11y 트리에서 제거한다.
+ */
+declare const separatorVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SeparatorProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof separatorVariants> {
+    /** 가운데 라벨. 있으면 텍스트 양옆에 라인을 그린다(라벨형은 항상 수평). */
+    label?: React.ReactNode;
+    /** 순수 장식이면 true — a11y 트리에서 제거(role="none"). 기본 false = 시맨틱 구분선. */
+    decorative?: boolean;
+}
+declare const Separator: React.ForwardRefExoticComponent<SeparatorProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Popover — presentation-only floating container for arbitrary content.
+ *
+ * Click the trigger to toggle; outside-click and ESC close it. Positioning here
+ * is a lightweight Tailwind approximation for the design catalog (no @radix-ui /
+ * floating-ui) — real portal/collision behavior is wired by the app dev.
+ * Visibility is `open` (controlled) or internal state (uncontrolled via
+ * `defaultOpen`). `placement` picks the side, `align` slides along that side.
+ */
+type PopoverPlacement = "top" | "bottom" | "left" | "right";
+type PopoverAlign = "start" | "center" | "end";
+declare const popoverContentVariants: (props?: ({
+    placement?: "left" | "right" | "bottom" | "top" | null | undefined;
+    align?: "center" | "end" | "start" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PopoverProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content">, VariantProps<typeof popoverContentVariants> {
+    /** The floating panel content (any node). */
+    content: React.ReactNode;
+    /** The trigger element the popover is anchored to. */
+    children: React.ReactNode;
+    /** Controlled open state. When set, internal state is ignored. */
+    open?: boolean;
+    /** Uncontrolled initial open state. */
+    defaultOpen?: boolean;
+    /** Fired whenever the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+}
+declare const Popover: React.ForwardRefExoticComponent<PopoverProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Field — form-field wrapper (FormField).
+ *
+ * Lays out a label (+ required mark / optional badge), a control
+ * (`children`: input / textarea / select) and a helper or error message
+ * in a consistent vertical stack. When `error` is set it takes priority
+ * over `hint`, and the control is wired with `aria-invalid` /
+ * `aria-describedby` for non-colour accessibility.
+ */
+declare const fieldVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface FieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, VariantProps<typeof fieldVariants> {
+    /** Field label text. Rendered inside a native `<label htmlFor>`. */
+    label?: React.ReactNode;
+    /** id of the control this field labels (also applied to the child). */
+    htmlFor?: string;
+    /** Show a red required marker (`*`, text-danger-text). */
+    required?: boolean;
+    /** Show a subtle "선택" badge (reuses the DS Label). Ignored when required. */
+    optional?: boolean;
+    /** Helper text below the control (text-text-subtle). */
+    hint?: React.ReactNode;
+    /** Error text below the control. Takes priority over `hint` (text-danger-text). */
+    error?: React.ReactNode;
+    /** The control: input / textarea / select. */
+    children?: React.ReactNode;
+}
+declare const Field: React.ForwardRefExoticComponent<FieldProps & React.RefAttributes<HTMLDivElement>>;
+
+interface SearchFieldProps extends Omit<React.ComponentProps<"input">, "size" | "value" | "defaultValue" | "onChange" | "type"> {
+    /** Controlled query value. */
+    value?: string;
+    /** Uncontrolled initial value. */
+    defaultValue?: string;
+    /** Fires with the next query string on typing or clear. */
+    onValueChange?: (value: string) => void;
+    /** Placeholder copy. Defaults to "검색". */
+    placeholder?: string;
+    /** When a number, renders a "{n}건" result count on the trailing side. */
+    resultCount?: number;
+    /** Shows a previous-result nav button when provided. */
+    onPrev?: () => void;
+    /** Shows a next-result nav button when provided. */
+    onNext?: () => void;
+    /** Shows a clear (x) button when provided and the field has a value. */
+    onClear?: () => void;
+    /** Field height/padding scale. Mirrors Input's inputSize. */
+    size?: VariantProps<typeof inputVariants>["inputSize"];
+}
+/**
+ * SearchField — a search input built on Input's visual tokens (inputVariants).
+ * Adds a leading search icon plus optional trailing accessories: a result
+ * count, previous/next navigation, and a clear (x) button. Query state is
+ * controlled via `value`/`onValueChange` or uncontrolled via `defaultValue`.
+ */
+declare const SearchField: React.ForwardRefExoticComponent<Omit<SearchFieldProps, "ref"> & React.RefAttributes<HTMLInputElement>>;
+
+/**
+ * Banner — dismissible, full-width inline notification.
+ *
+ * Distinct from Alert: a Banner spans the full width of its container and is
+ * meant for persistent, dismissible announcements (release notes, billing
+ * notices, maintenance windows). Colour comes only from semantic variant
+ * tokens; the icon + close button inherit the variant text colour.
+ */
+declare const bannerVariants: (props?: ({
+    variant?: "neutral" | "danger" | "brand" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BannerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">, VariantProps<typeof bannerVariants> {
+    /** Leading status icon. Inherits the variant text colour. */
+    icon?: React.ReactNode;
+    /** Emphasised heading rendered above the body (children). */
+    title?: React.ReactNode;
+    /** When true, renders a trailing close button that calls `onDismiss`. */
+    dismissible?: boolean;
+    /** Fired when the close button is pressed. */
+    onDismiss?: () => void;
+}
+declare const Banner: React.ForwardRefExoticComponent<BannerProps & React.RefAttributes<HTMLDivElement>>;
+
+export { AVATAR_COLORS, Accordion, AccordionItem, type AccordionItemData, type AccordionItemProps, type AccordionProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, AlertTitle, type AlertTitleProps, Avatar, type AvatarColor, AvatarFallback, type AvatarFallbackProps, AvatarGroup, type AvatarGroupProps, AvatarImage, type AvatarImageProps, type AvatarPresence, type AvatarProps, type AvatarSize, AvatarWithPresence, type AvatarWithPresenceProps, Banner, type BannerProps, Button, type ButtonProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, Chip, type ChipProps, type CommandGroup, type CommandItem, CommandPalette, type CommandPaletteProps, Dialog, Button as DialogAction, DialogBody, type DialogBodyProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, type DialogProps, DialogTitle, type DialogTitleProps, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuEmpty, type DropdownMenuEmptyProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, type DropdownMenuProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuTrigger, type DropdownMenuTriggerProps, EmptyState, type EmptyStateProps, Field, type FieldProps, Input, type InputProps, Kbd, type KbdProps, type KpiItem, KpiRow, type KpiRowProps, Label, type LabelProps, List, ListItem, type ListItemProps, type ListProps, PRESENCE_LABEL, Pagination, PaginationEllipsis, PaginationItem, type PaginationItemProps, type PaginationNavProps, PaginationNext, PaginationPrevious, type PaginationProps, Popover, type PopoverAlign, type PopoverPlacement, type PopoverProps, Presence, type PresenceProps, type PresenceSize, type PresenceStatus, Progress, type ProgressItem, ProgressList, type ProgressListProps, type ProgressProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, Ring, type RingProps, ScrollArea, ScrollBar, SearchField, type SearchFieldProps, SegmentedControl, type SegmentedControlItem, type SegmentedControlProps, Select, type SelectOption, type SelectProps, Separator, type SeparatorProps, Sheet, SheetBody, SheetDescription, SheetFooter, SheetHandle, SheetHeader, type SheetProps, SheetTitle, Sidebar, SidebarChannel, type SidebarChannelData, type SidebarChannelProps, SidebarDm, type SidebarDmData, type SidebarDmProps, type SidebarItem, SidebarPanel, type SidebarProps, SidebarSection, type SidebarSectionData, type SidebarSectionProps, Skeleton, type SkeletonProps, StackBar, type StackBarProps, type StackSegment, SuccessCheck, type SuccessCheckProps, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, Toast, type ToastProps, Toggle, type ToggleProps, Tooltip, type TooltipPlacement, type TooltipProps, WorkHoursBar, type WorkHoursBarProps, type WorkHoursItem, type WorkHoursState, alertVariants, avatarVariants, bannerVariants, buildPageRange, buttonVariants, cardVariants, checkboxVariants, chipVariants, cn, dialogPanelVariants, dropdownMenuContentVariants, dropdownMenuItemVariants, fieldVariants, inputVariants, labelVariants, paginationItemVariants, popoverContentVariants, progressFillVariants, progressTrackVariants, radioVariants, segmentContainerVariants, segmentItemVariants, selectTriggerVariants, separatorVariants, sheetOverlayVariants, sheetPanelVariants, sidebarContainerVariants, skeletonVariants, tableRowVariants, tableVariants, tabsListVariants, tabsTriggerVariants, textareaVariants, toastVariants, toggleThumbVariants, toggleTrackVariants, tooltipArrowVariants, tooltipContentVariants };