@olundot/ui 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -4,14 +4,14 @@ import * as React from 'react';
 import { SVGProps } from 'react';
 import { VariantProps } from 'class-variance-authority';
 import { LucideIcon } from 'lucide-react';
-import { Select as Select$1, Tabs as Tabs$1, Dialog as Dialog$1, Separator as Separator$1, Avatar as Avatar$1, DropdownMenu as DropdownMenu$1, Tooltip as Tooltip$1, Checkbox as Checkbox$1, RadioGroup, ScrollArea as ScrollArea$1 } from 'radix-ui';
+import { Select as Select$1, Label as Label$1, Switch as Switch$1, Tabs as Tabs$1, Dialog as Dialog$1, Separator as Separator$1, Avatar as Avatar$1, DropdownMenu as DropdownMenu$1, Tooltip as Tooltip$1, Popover as Popover$1, Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, ScrollArea as ScrollArea$1 } from 'radix-ui';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 declare function cn(...inputs: ClassValue[]): string;
 
 declare const buttonVariants: (props?: ({
-    variant?: "primary" | "secondary" | "destructive" | "outline" | "ghost" | "danger" | "emergency" | "subtle" | "default" | "link" | null | undefined;
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | "icon" | "icon-xs" | null | undefined;
+    variant?: "primary" | "outline" | "ghost" | "danger" | "emergency" | "subtle" | "default" | "destructive" | "secondary" | "link" | null | undefined;
+    size?: "default" | "xs" | "sm" | "md" | "lg" | "xl" | "icon" | "icon-xs" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ButtonVariant = NonNullable<VariantProps<typeof buttonVariants>['variant']>;
 type ButtonSize = NonNullable<VariantProps<typeof buttonVariants>['size']>;
@@ -32,7 +32,7 @@ type CopyButtonProps = Omit<ButtonProps, 'children' | 'leadingIcon' | 'loading'
     variant?: ButtonVariant;
     duration?: number;
 };
-declare const CopyButton: React.ForwardRefExoticComponent<Omit<ButtonProps, "variant" | "size" | "leadingIcon" | "trailingIcon" | "loading" | "children"> & {
+declare const CopyButton: React.ForwardRefExoticComponent<Omit<ButtonProps, "size" | "variant" | "leadingIcon" | "trailingIcon" | "loading" | "children"> & {
     value: string;
     label?: React.ReactNode;
     copiedLabel?: React.ReactNode;
@@ -43,16 +43,48 @@ declare const CopyButton: React.ForwardRefExoticComponent<Omit<ButtonProps, "var
 } & React.RefAttributes<HTMLButtonElement>>;
 
 declare const inputVariants: (props?: ({
-    inputSize?: "xs" | "sm" | "md" | "lg" | "default" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    fullWidth?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const inputMessageVariants: (props?: ({
-    state?: "error" | "success" | "default" | null | undefined;
-    inputSize?: "xs" | "sm" | "md" | "lg" | "default" | null | undefined;
+    state?: "default" | "success" | "error" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type InputState = NonNullable<VariantProps<typeof inputMessageVariants>["state"]>;
+/** Canonical size type (0.2.0+). Use `size` prop with these values. */
+type InputSize = "sm" | "md" | "lg";
+/**
+ * @deprecated Use `InputSize` instead.
+ * Legacy values: xs→sm, default→md, sm (was 34px — now maps to md for safety), md→md, lg→lg.
+ */
+type InputSizeLegacy = "xs" | "sm" | "md" | "lg" | "default";
 interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size">, VariantProps<typeof inputVariants> {
+    /**
+     * Field height preset. Replaces `inputSize` (deprecated).
+     * - sm: 32px  (compact toolbar/search)
+     * - md: 38px  (default form field)
+     * - lg: 44px  (prominent / WCAG 2.5.5 touch target)
+     */
+    size?: InputSize;
+    /**
+     * @deprecated Use `size` instead.
+     * xs → sm, default → md, sm → md, md → md, lg → lg.
+     * Will be removed in the next major version.
+     */
+    inputSize?: InputSizeLegacy;
+    /**
+     * Whether the field stretches to fill its container.
+     * - `true` (default): `w-full` — fills the container width (existing behavior).
+     * - `false`: `w-fit` — shrinks to the intrinsic content width.
+     */
+    fullWidth?: boolean;
     invalid?: boolean;
     label?: React.ReactNode;
+    /**
+     * Pre-input hint text (always visible in default state). Hidden when
+     * `state` is "error" or "success" — `message` takes over.
+     */
+    description?: React.ReactNode;
     message?: React.ReactNode;
     state?: InputState;
 }
@@ -76,10 +108,10 @@ interface FileUploadZoneProps extends Omit<React.LabelHTMLAttributes<HTMLLabelEl
 declare const FileUploadZone: React.ForwardRefExoticComponent<FileUploadZoneProps & React.RefAttributes<HTMLLabelElement>>;
 
 declare const alertVariants: (props?: ({
-    variant?: "error" | "warning" | "info" | "success" | null | undefined;
+    variant?: "success" | "error" | "info" | "warning" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const inlineAlertVariants: (props?: ({
-    variant?: "error" | "warning" | "info" | "success" | null | undefined;
+    variant?: "success" | "error" | "info" | "warning" | null | undefined;
     surface?: "filled" | "plain" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type AlertVariant = NonNullable<VariantProps<typeof alertVariants>['variant']>;
@@ -104,16 +136,47 @@ declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttri
 declare const InlineAlert: React.ForwardRefExoticComponent<InlineAlertProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const textareaVariants: (props?: ({
-    textareaSize?: "default" | "compact" | "large" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    fullWidth?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const textareaMessageVariants: (props?: ({
-    state?: "error" | "success" | "default" | null | undefined;
+    state?: "default" | "success" | "error" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type TextareaState = NonNullable<VariantProps<typeof textareaMessageVariants>["state"]>;
-type TextareaSize = NonNullable<VariantProps<typeof textareaVariants>["textareaSize"]>;
+/** Canonical size type (0.2.0+). Use `size` prop with these values. */
+type TextareaSize = "sm" | "md" | "lg";
+/**
+ * @deprecated Use `TextareaSize` instead.
+ * Legacy values: compact→sm, default→md, large→lg.
+ */
+type TextareaSizeLegacy = "compact" | "default" | "large";
 interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "children">, VariantProps<typeof textareaVariants> {
+    /**
+     * Min-height preset. Replaces `textareaSize` (deprecated). Font size is unchanged across all sizes.
+     * - sm: 72px   (compact admin reason field)
+     * - md: 88px   (default note / explanation field)
+     * - lg: 120px  (long response, audit comment)
+     */
+    size?: TextareaSize;
+    /**
+     * @deprecated Use `size` instead.
+     * compact → sm, default → md, large → lg (height only, font unchanged).
+     * Will be removed in the next major version.
+     */
+    textareaSize?: TextareaSizeLegacy;
+    /**
+     * Whether the field stretches to fill its container.
+     * - `true` (default): `w-full` — fills the container width (existing behavior).
+     * - `false`: `w-fit` — shrinks to the intrinsic content width.
+     */
+    fullWidth?: boolean;
     invalid?: boolean;
     label?: React.ReactNode;
+    /**
+     * Pre-input hint text (always visible in default state). Hidden when
+     * `state` is "error" or "success" — `message` takes over.
+     */
+    description?: React.ReactNode;
     message?: React.ReactNode;
     state?: TextareaState;
     valueLength?: number;
@@ -121,24 +184,38 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
 
 declare const selectVariants: (props?: ({
-    selectVariant?: "inline" | "field" | null | undefined;
-    selectSize?: "sm" | "md" | "lg" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    fullWidth?: boolean | null | undefined;
+    appearance?: "inline" | "field" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const selectMessageVariants: (props?: ({
-    state?: "error" | "success" | "default" | null | undefined;
-    selectSize?: "sm" | "md" | "lg" | null | undefined;
+    state?: "default" | "success" | "error" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type SelectState = NonNullable<VariantProps<typeof selectMessageVariants>["state"]>;
-type SelectSize = NonNullable<VariantProps<typeof selectVariants>["selectSize"]>;
+/** Canonical size type (0.2.0+). Use `size` prop with these values. */
+type SelectSize = "sm" | "md" | "lg";
+/** Appearance axis for Select trigger (0.2.0+). */
+type SelectAppearance = "field" | "inline";
+/**
+ * @deprecated Use `fullWidth` + `appearance` props instead.
+ * Legacy variant alias: "field" = `fullWidth=true, appearance="field"`, "inline" = `fullWidth=false, appearance="inline"`.
+ */
+type SelectVariant = "field" | "inline";
 interface SelectOption {
     value: string;
     label: React.ReactNode;
     disabled?: boolean;
 }
-interface SelectProps extends Omit<React.ComponentPropsWithoutRef<typeof Select$1.Root>, "children" | "dir">, VariantProps<typeof selectVariants> {
+interface SelectProps extends Omit<React.ComponentPropsWithoutRef<typeof Select$1.Root>, "children" | "dir"> {
     className?: string;
     id?: string;
     label?: React.ReactNode;
+    /**
+     * Pre-input hint text (always visible in default state). Hidden when
+     * `state` is "error" or "success" — `message` takes over.
+     */
+    description?: React.ReactNode;
     message?: React.ReactNode;
     invalid?: boolean;
     state?: SelectState;
@@ -147,16 +224,65 @@ interface SelectProps extends Omit<React.ComponentPropsWithoutRef<typeof Select$
     "aria-label"?: React.AriaAttributes["aria-label"];
     "aria-describedby"?: string;
     "aria-invalid"?: React.AriaAttributes["aria-invalid"];
+    /**
+     * Field height preset.
+     * - sm: 32px  (compact toolbar/filter)
+     * - md: 34px  (default, matches Input density)
+     * - lg: 38px  (prominent)
+     */
+    size?: SelectSize;
+    /**
+     * @deprecated Use `size` instead. Values are identical: sm→sm, md→md, lg→lg.
+     * Will be removed in the next major version.
+     */
+    selectSize?: SelectSize;
+    /**
+     * Whether the trigger stretches to fill its container.
+     * - `true` (default): `w-full` — fills the container width (existing behavior).
+     * - `false`: `w-fit` — shrinks to intrinsic content width.
+     */
+    fullWidth?: boolean;
+    /**
+     * Visual style axis for the select trigger.
+     * - `"field"` (default): standard form field look with no extra styles.
+     * - `"inline"`: compact contextual look — `min-w-[112px] max-w-full font-medium`.
+     *   Combine with `fullWidth={false}` to replicate the legacy `selectVariant="inline"` behavior.
+     */
+    appearance?: SelectAppearance;
+    /**
+     * @deprecated Use `fullWidth={false} + appearance="inline"` instead.
+     * - `"inline"` → resolves to `fullWidth=false, appearance="inline"`.
+     * - `"field"` → resolves to `fullWidth=true, appearance="field"`.
+     * Will be removed in the next major version.
+     */
+    selectVariant?: SelectVariant;
+    /**
+     * When `true`, prepends a reset option to the dropdown. Selecting it fires
+     * `onValueChange("")` and restores the trigger placeholder. Default `false`.
+     *
+     * Eliminates the need for callers to manage a sentinel value themselves —
+     * use `value=""` + `onValueChange` with `clearable` for the standard pattern.
+     */
+    clearable?: boolean;
+    /**
+     * Custom label for the clear/reset option.
+     * Defaults to `placeholder` (so reset option text matches trigger placeholder — visual unity).
+     */
+    clearLabel?: React.ReactNode;
 }
 declare const Select: React.ForwardRefExoticComponent<SelectProps & React.RefAttributes<HTMLButtonElement>>;
 
 declare const formFieldVariants: (props?: ({
     layout?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const formFieldLabelClassName = "text-[13px] font-medium leading-[1.35] text-[var(--text-secondary)]";
+/**
+ * @deprecated Use `<Label>` primitive instead. This className alias is kept for
+ * 1 cycle (0.2.0 → 0.3.0 removal) for raw label patterns.
+ */
+declare const formFieldLabelClassName = "text-body-sm font-medium leading-snug text-text-secondary";
 declare const formFieldRequiredClassName = "ml-[2px] text-[var(--semantic-error,var(--error))]";
-declare const formFieldDescriptionClassName = "ml-[var(--space-1-5)] text-[12px] leading-[1.4] text-[var(--text-tertiary)]";
-declare const formFieldErrorClassName = "ml-[var(--space-1-5)] text-[12px] leading-[1.4] text-[var(--semantic-error,var(--error))]";
+declare const formFieldDescriptionClassName = "text-[12px] leading-snug text-text-tertiary";
+declare const formFieldErrorClassName = "text-[12px] leading-snug text-[var(--semantic-error,var(--error))]";
 declare const formFieldControlStackClassName = "flex min-w-0 flex-col gap-[var(--space-0-5)]";
 interface FormFieldProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
     label: React.ReactNode;
@@ -172,6 +298,14 @@ interface FormFieldRenderProps {
         id?: string;
         "aria-describedby"?: string;
         "aria-invalid"?: true;
+        /** Forwarded in delegated mode: required semantic (control's required attribute + aria-required). */
+        required?: boolean;
+        /** Forwarded in delegated mode: pre-input hint (visible when no error). */
+        description?: React.ReactNode;
+        /** Forwarded in delegated mode: error message (error takes priority over description). */
+        message?: React.ReactNode;
+        /** Forwarded in delegated mode: "error" when error is set, "default" otherwise. */
+        state?: "default" | "success" | "error";
     };
     descriptionId?: string;
     errorId?: string;
@@ -179,6 +313,38 @@ interface FormFieldRenderProps {
 }
 declare function FormField({ label, required, description, error, children, layout, id, className, ...props }: FormFieldProps): react_jsx_runtime.JSX.Element;
 
+interface LabelProps extends React.ComponentPropsWithoutRef<typeof Label$1.Root> {
+    htmlFor?: string;
+    required?: boolean;
+    children: React.ReactNode;
+    className?: string;
+}
+/**
+ * Label primitive — wraps Radix UI Label for consistent typography and
+ * required-marker behaviour across form fields.
+ *
+ * Matches the visual spec of `formFieldLabelClassName` in form-field.tsx:
+ * 13 px / medium / 1.35 leading / --text-secondary.
+ *
+ * @example
+ * <Label htmlFor="email">이메일</Label>
+ * <Label htmlFor="sn" required>학번</Label>
+ */
+declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLLabelElement>>;
+
+interface SwitchProps extends Omit<React.ComponentPropsWithoutRef<typeof Switch$1.Root>, "children"> {
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    /** Marks the switch as required (passes aria-required). */
+    required?: boolean;
+    /**
+     * Loading state — shows spinner, disables interaction, sets aria-busy.
+     * Use for pending async preference changes (e.g., saving remote setting).
+     */
+    loading?: boolean;
+}
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLButtonElement>>;
+
 type PermissionFallback = "hide" | "disabled" | React.ReactNode;
 interface PermissionScope {
     resourceId?: string;
@@ -270,8 +436,47 @@ interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<t
 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<HTMLHeadingElement> & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Card 제목 아래 한 줄 helper text (subtitle).
+ *
+ * Semantic: **single semantic paragraph만 허용**. 시각적으로 2-3줄 wrap은 OK이지만,
+ * 여러 단락/리스트/구조화 body는 `CardContent` + `CardProse`로 분리한다.
+ * 중첩 paragraph/list를 박으면 `<p>` 안에 `<p>`가 nest되어 HTML invalid.
+ *
+ * @example
+ * ```tsx
+ * <CardHeader>
+ *   <CardTitle>강의 1주차</CardTitle>
+ *   <CardDescription>32문항 · 45분</CardDescription>
+ * </CardHeader>
+ * ```
+ *
+ * @see CardProse — multi-paragraph body 전용 composition helper
+ */
 declare const CardDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
 declare const CardContent: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Card body multi-paragraph 전용 composition helper.
+ *
+ * `CardContent` 안에 다중 `<p>` / `<ul>` / `<ol>`을 넣을 때 sibling 간 spacing과
+ * body typography를 자동 적용. `CardDescription`은 single semantic paragraph 한정,
+ * 그 외 body 구조는 `CardContent > CardProse` 패턴이 정본.
+ *
+ * @example
+ * ```tsx
+ * <CardContent>
+ *   <CardProse>
+ *     <p>첫 단락. 시험 응시 안내.</p>
+ *     <p>둘째 단락. 점수 산정 기준.</p>
+ *     <ul>
+ *       <li>총 32문항</li>
+ *       <li>제한 시간 45분</li>
+ *     </ul>
+ *   </CardProse>
+ * </CardContent>
+ * ```
+ */
+declare const CardProse: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 declare const CardFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 
 interface PageHeaderProps extends Omit<React.HTMLAttributes<HTMLElement>, "title"> {
@@ -553,13 +758,52 @@ interface SheetDrawerProps {
 declare function SheetDrawer({ open, onOpenChange, title, description, children, expandHref, onExpand, expandLabel, footer, width, closeLabel, }: SheetDrawerProps): react_jsx_runtime.JSX.Element;
 
 declare function TooltipProvider({ delayDuration, ...props }: React.ComponentProps<typeof Tooltip$1.Provider>): react_jsx_runtime.JSX.Element;
-declare function Tooltip({ ...props }: React.ComponentProps<typeof Tooltip$1.Root>): react_jsx_runtime.JSX.Element;
-declare function TooltipTrigger({ ...props }: React.ComponentProps<typeof Tooltip$1.Trigger>): react_jsx_runtime.JSX.Element;
+interface TooltipProps extends React.ComponentProps<typeof Tooltip$1.Root> {
+    /**
+     * Enable mobile click/touch trigger via internal state + onClick toggle on TooltipTrigger.
+     * Default `true` — hover/focus + click 모두 동작 (**uncontrolled에서만**).
+     *
+     * **Controlled (`open` prop 전달) 시 이 prop은 무시되어 click toggle이 비활성화된다.**
+     * 외부 state와의 이중 toggle/conflict 방지가 목적이다. controlled mobile click은
+     * consumer가 trigger의 `onClick`에서 `onOpenChange(!open)`을 직접 호출해야 한다.
+     *
+     * `false` — uncontrolled에서도 click toggle 끄고 desktop hover-only 강제.
+     */
+    enableTouch?: boolean;
+}
+declare function Tooltip({ open: controlledOpen, defaultOpen, onOpenChange: userOnOpenChange, enableTouch, children, ...props }: TooltipProps): react_jsx_runtime.JSX.Element;
+declare function TooltipTrigger({ onClick: userOnClick, ...props }: React.ComponentProps<typeof Tooltip$1.Trigger>): react_jsx_runtime.JSX.Element;
 declare function TooltipContent({ className, sideOffset, children, ...props }: React.ComponentProps<typeof Tooltip$1.Content>): react_jsx_runtime.JSX.Element;
 
+interface PopoverProps extends React.ComponentPropsWithoutRef<typeof Popover$1.Root> {
+    /**
+     * Whether the popover blocks background interaction.
+     * Default `false` — interactive content with non-blocking dismiss.
+     * Set `true` only for full focus trap (consider `<Dialog>` instead).
+     */
+    modal?: boolean;
+}
+declare function Popover({ modal, ...props }: PopoverProps): react_jsx_runtime.JSX.Element;
+declare const PopoverTrigger: React.ForwardRefExoticComponent<Popover$1.PopoverTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const PopoverAnchor: React.ForwardRefExoticComponent<Popover$1.PopoverAnchorProps & React.RefAttributes<HTMLDivElement>>;
+declare const PopoverClose: React.ForwardRefExoticComponent<Popover$1.PopoverCloseProps & React.RefAttributes<HTMLButtonElement>>;
+interface PopoverContentProps extends React.ComponentPropsWithoutRef<typeof Popover$1.Content> {
+    /**
+     * Whether to render the arrow pointing to the trigger.
+     * Default `false` — set to `true` for visual anchor cue.
+     */
+    showArrow?: boolean;
+}
+declare const PopoverContent: React.ForwardRefExoticComponent<PopoverContentProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Standalone Arrow export — for advanced anchor patterns that need
+ * arrow positioning outside of Content (rare). Prefer `<PopoverContent showArrow>`.
+ */
+declare const PopoverArrow: React.ForwardRefExoticComponent<Omit<Popover$1.PopoverArrowProps & React.RefAttributes<SVGSVGElement>, "ref"> & React.RefAttributes<SVGSVGElement>>;
+
 declare const badgeVariants: (props?: ({
-    variant?: "brand" | "neutral" | "status" | "semantic" | "pill" | null | undefined;
-    tone?: "accent" | "warning" | "info" | "success" | "neutral" | "danger" | null | undefined;
+    variant?: "status" | "semantic" | "neutral" | "brand" | "pill" | "vibrant" | null | undefined;
+    tone?: "accent" | "danger" | "success" | "info" | "warning" | "neutral" | null | undefined;
     size?: "xs" | "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const badgeDotVariants: (props?: class_variance_authority_types.ClassProp | undefined) => string;
@@ -573,11 +817,11 @@ interface BadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'color'
 declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
 
 declare const twoTierBadgeVariants: (props?: ({
-    align?: "end" | "center" | "start" | null | undefined;
+    align?: "end" | "start" | "center" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const twoTierBadgeLineVariants: (props?: ({
     tier?: "primary" | "secondary" | null | undefined;
-    intent?: "muted" | "accent" | "warning" | "success" | "neutral" | "danger" | null | undefined;
+    intent?: "accent" | "danger" | "success" | "warning" | "neutral" | "muted" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type TwoTierBadgeIntent = NonNullable<VariantProps<typeof twoTierBadgeLineVariants>["intent"]>;
 interface TwoTierBadgeProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof twoTierBadgeVariants> {
@@ -591,13 +835,19 @@ interface TwoTierBadgeProps extends React.HTMLAttributes<HTMLDivElement>, Varian
 declare const TwoTierBadge: React.ForwardRefExoticComponent<TwoTierBadgeProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const statusBadgeVariants: (props?: ({
-    status?: "error" | "warning" | "info" | "success" | "active" | "pending" | "archived" | null | undefined;
+    status?: "success" | "error" | "info" | "warning" | "active" | "pending" | "archived" | null | undefined;
     size?: "xs" | "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const statusBadgeDotVariants: (props?: class_variance_authority_types.ClassProp | undefined) => string;
 type StatusBadgeStatus = NonNullable<VariantProps<typeof statusBadgeVariants>["status"]>;
 interface StatusBadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof statusBadgeVariants> {
     showDot?: boolean;
+    /**
+     * Dot pulse animation — default `true` (status indicator는 "살아있음" 시각 cue 필수,
+     * 플랫 dot는 AI slop 느낌). `motion-reduce` 환경에서는 자동 비활성.
+     * Opt-out 시 `pulse={false}`.
+     */
+    pulse?: boolean;
 }
 declare const StatusBadge: React.ForwardRefExoticComponent<StatusBadgeProps & React.RefAttributes<HTMLSpanElement>>;
 
@@ -614,13 +864,13 @@ interface NotificationBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanEleme
 declare const NotificationBadge: React.ForwardRefExoticComponent<NotificationBadgeProps & React.RefAttributes<HTMLSpanElement>>;
 
 declare const chipVariants: (props?: ({
-    variant?: "filter" | "choice" | "status-filter" | "removable" | null | undefined;
-    tone?: "muted" | "accent" | "warning" | "success" | "neutral" | "danger" | null | undefined;
+    variant?: "filter" | "choice" | "removable" | "status-filter" | null | undefined;
+    tone?: "accent" | "danger" | "success" | "warning" | "neutral" | "muted" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
     pressed?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const chipCountVariants: (props?: ({
-    tone?: "muted" | "accent" | "warning" | "success" | "neutral" | "danger" | null | undefined;
+    tone?: "accent" | "danger" | "success" | "warning" | "neutral" | "muted" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type ChipVariant = NonNullable<VariantProps<typeof chipVariants>["variant"]>;
@@ -636,7 +886,7 @@ declare const Chip: React.ForwardRefExoticComponent<ChipProps & React.RefAttribu
 
 declare const emptyStateVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
-    tone?: "raised" | "muted" | "neutral" | null | undefined;
+    tone?: "neutral" | "muted" | "raised" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const emptyStateIconVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
@@ -668,7 +918,7 @@ declare const skeletonVariants: (props?: ({
     shape?: "text" | "block" | "circle" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const spinnerVariants: (props?: ({
-    size?: 16 | 24 | 32 | null | undefined;
+    size?: "sm" | "md" | "lg" | 16 | 24 | 32 | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof skeletonVariants> {
 }
@@ -687,8 +937,12 @@ interface SkeletonRowProps extends React.HTMLAttributes<HTMLDivElement> {
     count?: number;
 }
 declare const SkeletonRow: React.ForwardRefExoticComponent<SkeletonRowProps & React.RefAttributes<HTMLDivElement>>;
-interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof spinnerVariants> {
+interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** Semantic sizes: sm (16px) · md (24px, default) · lg (32px).
+     * @deprecated number values 16/24/32 — use "sm"/"md"/"lg" instead (remove after 1 release cycle). */
+    size?: 'sm' | 'md' | 'lg' | 16 | 24 | 32;
     label?: string;
+    className?: string;
 }
 declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<HTMLSpanElement>>;
 
@@ -785,7 +1039,7 @@ interface ActionFooterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, '
 declare const ActionFooter: React.ForwardRefExoticComponent<ActionFooterProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const toastVariants: (props?: ({
-    variant?: "error" | "warning" | "info" | "success" | "default" | null | undefined;
+    variant?: "default" | "success" | "error" | "info" | "warning" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const toastViewportVariants: (props?: class_variance_authority_types.ClassProp | undefined) => string;
 type ToastVariant = NonNullable<VariantProps<typeof toastVariants>['variant']>;
@@ -835,7 +1089,7 @@ declare const otpCellVariants: (props?: ({
     size?: "default" | "compact" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const otpFieldMessageVariants: (props?: ({
-    state?: "error" | "default" | null | undefined;
+    state?: "default" | "error" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type OTPFieldSize = NonNullable<VariantProps<typeof otpCellVariants>["size"]>;
 interface OTPFieldProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, "onChange" | "children" | "defaultValue" | "value">, VariantProps<typeof otpFieldVariants> {
@@ -882,6 +1136,10 @@ type CheckboxCheckedState = React.ComponentProps<typeof Checkbox$1.Root>["checke
 interface CheckboxProps extends Omit<React.ComponentPropsWithoutRef<typeof Checkbox$1.Root>, "children" | "color">, VariantProps<typeof checkboxVariants> {
     label: React.ReactNode;
     description?: React.ReactNode;
+    /** Marks the field as required and appends `*` to label. */
+    required?: boolean;
+    /** Validation error message. Replaces description when present. */
+    error?: React.ReactNode;
 }
 declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLButtonElement>>;
 
@@ -907,13 +1165,28 @@ type AccessibleGroupName = {
     "aria-label"?: never;
     "aria-labelledby": string;
 };
-type RadioCardGroupRootProps = Omit<React.ComponentPropsWithoutRef<typeof RadioGroup.Root>, "children" | "orientation" | "aria-label" | "aria-labelledby">;
+type RadioCardGroupRootProps = Omit<React.ComponentPropsWithoutRef<typeof RadioGroup$1.Root>, "children" | "orientation" | "aria-label" | "aria-labelledby">;
 type RadioCardGroupProps = RadioCardGroupRootProps & AccessibleGroupName & VariantProps<typeof radioCardGroupVariants> & {
     options: readonly RadioCardOption[];
     density?: RadioCardDensity;
 };
 declare const RadioCardGroup: React.ForwardRefExoticComponent<RadioCardGroupProps & React.RefAttributes<HTMLDivElement>>;
 
+interface RadioOption {
+    value: string;
+    label: React.ReactNode;
+    description?: React.ReactNode;
+    disabled?: boolean;
+}
+interface RadioGroupProps extends Omit<React.ComponentPropsWithoutRef<typeof RadioGroup$1.Root>, "children"> {
+    options: readonly RadioOption[];
+    orientation?: "vertical" | "horizontal";
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    required?: boolean;
+}
+declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+
 declare function ScrollArea({ className, children, ...props }: React.ComponentProps<typeof ScrollArea$1.Root>): react_jsx_runtime.JSX.Element;
 declare function ScrollBar({ className, orientation, ...props }: React.ComponentProps<typeof ScrollArea$1.ScrollAreaScrollbar>): react_jsx_runtime.JSX.Element;
 
@@ -973,4 +1246,4 @@ interface JbnuEmblemProps extends SVGProps<SVGSVGElement> {
 }
 declare function JbnuEmblem({ size, className, style, ...props }: JbnuEmblemProps): react_jsx_runtime.JSX.Element;
 
-export { ActionFooter, type ActionFooterAction, type ActionFooterProps, type ActionFooterStatus, Alert, type AlertProps, type AlertVariant, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariant, Checkbox, type CheckboxCheckedState, type CheckboxProps, type CheckboxSize, Chip, type ChipProps, type ChipSize, type ChipTone, type ChipVariant, ChoiceGroup, type ChoiceGroupOption, type ChoiceGroupProps, type ChoiceGroupType, type ChoiceGroupVariant, ConfirmDialog, type ConfirmDialogProps, CopyButton, type CopyButtonProps, DataTable, type DataTableBulkAction, type DataTableColumn, type DataTableProps, type DataTableSort, DetailLayout, type DetailLayoutProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogRawContent, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, type EmptyStateTone, ErrorState, type ErrorStateProps, FileUploadZone, type FileUploadZoneProps, FilterToolbar, type FilterToolbarProps, FormField, type FormFieldProps, type FormFieldRenderProps, FormLayout, type FormLayoutProps, type FormLayoutSection, FormModal, type FormModalProps, IconButton, type IconButtonBadgeTone, type IconButtonProps, type IconButtonSize, type IconButtonVariant, InfoModal, type InfoModalProps, InlineAlert, type InlineAlertProps, Input, type InputProps, type InputState, JbnuEmblem, type JbnuEmblemProps, ModeToggle, type ModeToggleOption, type ModeToggleProps, NotificationBadge, type NotificationBadgePlacement, type NotificationBadgeProps, type NotificationBadgeSize, OTPField, type OTPFieldProps, type OTPFieldSize, OlunLogo, OlunSymbol, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, type PaginationSize, PermissionContext, type PermissionEvaluator, type PermissionFallback, PermissionGuard, type PermissionGuardProps, PermissionProvider, type PermissionProviderProps, type PermissionScope, type PermissionState, Progress, type RadioCardColumns, type RadioCardDensity, RadioCardGroup, type RadioCardGroupProps, type RadioCardOption, ScrollArea, ScrollBar, SearchField, type SearchFieldProps, type SearchFieldSize, Select, type SelectOption, type SelectProps, type SelectSize, type SelectState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetDrawer, type SheetDrawerProps, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, SkeletonRow, type SkeletonRowColumn, type SkeletonRowProps, SkeletonText, type SkeletonTextProps, Spinner, type SpinnerProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, type TabItem, Tabs, TabsContent, type TabsProps, Textarea, type TextareaProps, type TextareaSize, type TextareaState, ThemeFab, type ThemeFabProps, ThemeToggle, type ToastAction, type ToastItem, type ToastOptions, ToastProvider, ToastRoot, type ToastVariant, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TwoTierBadge, type TwoTierBadgeIntent, type TwoTierBadgeProps, WizardLayout, type WizardLayoutProps, type WizardStep, type WizardStepState, actionFooterStatusVariants, actionFooterVariants, alertVariants, badgeDotVariants, badgeVariants, buttonVariants, cardVariants, checkboxBoxVariants, checkboxVariants, chipCountVariants, chipVariants, choiceBodyVariants, choiceGroupVariants, choiceMarkerVariants, choiceRowVariants, cn, dataTableRowVariants, dataTableVariants, emptyStateIconVariants, emptyStateVariants, errorStateVariants, evaluatePermission, fileUploadIconVariants, fileUploadZoneVariants, formFieldControlStackClassName, formFieldDescriptionClassName, formFieldErrorClassName, formFieldLabelClassName, formFieldRequiredClassName, formFieldVariants, getToastDuration, iconButtonBadgeVariants, iconButtonVariants, inlineAlertVariants, inputMessageVariants, inputVariants, limitToasts, modeToggleItemVariants, modeToggleVariants, notificationBadgeVariants, otpCellVariants, otpFieldGroupVariants, otpFieldMessageVariants, otpFieldVariants, paginationControlVariants, paginationVariants, radioCardControlVariants, radioCardGroupVariants, radioCardItemVariants, searchFieldInputVariants, searchFieldVariants, selectMessageVariants, selectVariants, skeletonVariants, spinnerVariants, statusBadgeDotVariants, statusBadgeVariants, tabsBadgeVariants, tabsListVariants, tabsTriggerVariants, textareaMessageVariants, textareaVariants, toast, toastVariants, toastViewportVariants, twoTierBadgeLineVariants, twoTierBadgeVariants, usePermission };
+export { ActionFooter, type ActionFooterAction, type ActionFooterProps, type ActionFooterStatus, Alert, type AlertProps, type AlertVariant, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, type BadgeSize, type BadgeTone, type BadgeVariant, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardProse, CardTitle, type CardVariant, Checkbox, type CheckboxCheckedState, type CheckboxProps, type CheckboxSize, Chip, type ChipProps, type ChipSize, type ChipTone, type ChipVariant, ChoiceGroup, type ChoiceGroupOption, type ChoiceGroupProps, type ChoiceGroupType, type ChoiceGroupVariant, ConfirmDialog, type ConfirmDialogProps, CopyButton, type CopyButtonProps, DataTable, type DataTableBulkAction, type DataTableColumn, type DataTableProps, type DataTableSort, DetailLayout, type DetailLayoutProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogRawContent, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, type EmptyStateSize, type EmptyStateTone, ErrorState, type ErrorStateProps, FileUploadZone, type FileUploadZoneProps, FilterToolbar, type FilterToolbarProps, FormField, type FormFieldProps, type FormFieldRenderProps, FormLayout, type FormLayoutProps, type FormLayoutSection, FormModal, type FormModalProps, IconButton, type IconButtonBadgeTone, type IconButtonProps, type IconButtonSize, type IconButtonVariant, InfoModal, type InfoModalProps, InlineAlert, type InlineAlertProps, Input, type InputProps, type InputSize, type InputSizeLegacy, type InputState, JbnuEmblem, type JbnuEmblemProps, Label, type LabelProps, ModeToggle, type ModeToggleOption, type ModeToggleProps, NotificationBadge, type NotificationBadgePlacement, type NotificationBadgeProps, type NotificationBadgeSize, OTPField, type OTPFieldProps, type OTPFieldSize, OlunLogo, OlunSymbol, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, type PaginationSize, PermissionContext, type PermissionEvaluator, type PermissionFallback, PermissionGuard, type PermissionGuardProps, PermissionProvider, type PermissionProviderProps, type PermissionScope, type PermissionState, Popover, PopoverAnchor, PopoverArrow, PopoverClose, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type RadioCardColumns, type RadioCardDensity, RadioCardGroup, type RadioCardGroupProps, type RadioCardOption, RadioGroup, type RadioGroupProps, type RadioOption, ScrollArea, ScrollBar, SearchField, type SearchFieldProps, type SearchFieldSize, Select, type SelectAppearance, type SelectOption, type SelectProps, type SelectSize, type SelectState, type SelectVariant, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetDrawer, type SheetDrawerProps, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Skeleton, type SkeletonProps, SkeletonRow, type SkeletonRowColumn, type SkeletonRowProps, SkeletonText, type SkeletonTextProps, Spinner, type SpinnerProps, StatusBadge, type StatusBadgeProps, type StatusBadgeStatus, Switch, type SwitchProps, type TabItem, Tabs, TabsContent, type TabsProps, Textarea, type TextareaProps, type TextareaSize, type TextareaSizeLegacy, type TextareaState, ThemeFab, type ThemeFabProps, ThemeToggle, type ToastAction, type ToastItem, type ToastOptions, ToastProvider, ToastRoot, type ToastVariant, ToastViewport, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TwoTierBadge, type TwoTierBadgeIntent, type TwoTierBadgeProps, WizardLayout, type WizardLayoutProps, type WizardStep, type WizardStepState, actionFooterStatusVariants, actionFooterVariants, alertVariants, badgeDotVariants, badgeVariants, buttonVariants, cardVariants, checkboxBoxVariants, checkboxVariants, chipCountVariants, chipVariants, choiceBodyVariants, choiceGroupVariants, choiceMarkerVariants, choiceRowVariants, cn, dataTableRowVariants, dataTableVariants, emptyStateIconVariants, emptyStateVariants, errorStateVariants, evaluatePermission, fileUploadIconVariants, fileUploadZoneVariants, formFieldControlStackClassName, formFieldDescriptionClassName, formFieldErrorClassName, formFieldLabelClassName, formFieldRequiredClassName, formFieldVariants, getToastDuration, iconButtonBadgeVariants, iconButtonVariants, inlineAlertVariants, inputMessageVariants, inputVariants, limitToasts, modeToggleItemVariants, modeToggleVariants, notificationBadgeVariants, otpCellVariants, otpFieldGroupVariants, otpFieldMessageVariants, otpFieldVariants, paginationControlVariants, paginationVariants, radioCardControlVariants, radioCardGroupVariants, radioCardItemVariants, searchFieldInputVariants, searchFieldVariants, selectMessageVariants, selectVariants, skeletonVariants, spinnerVariants, statusBadgeDotVariants, statusBadgeVariants, tabsBadgeVariants, tabsListVariants, tabsTriggerVariants, textareaMessageVariants, textareaVariants, toast, toastVariants, toastViewportVariants, twoTierBadgeLineVariants, twoTierBadgeVariants, usePermission };