@amineslab/ui 0.1.0-next.20260925131012 → 0.1.0

package/dist/label-NwHLobGQ.d.cts

@@ -0,0 +1,590 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
+import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
+import * as SelectPrimitive from '@radix-ui/react-select';
+
+type FieldControlVariant = 'filled' | 'outline';
+declare const fieldControlVariants: (props?: ({
+    variant?: "outline" | "filled" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type FieldControlVariants = VariantProps<typeof fieldControlVariants>;
+
+/** FileUpload와 PhotoField가 공유하는 drop surface 표현입니다. */
+type FileDropzoneVariant = FieldControlVariant;
+/** 레이아웃은 소유하지 않고 표면·focus·drag·invalid 상태만 제공하는 공통 variant입니다. */
+declare const fileDropzoneVariants: (props?: ({
+    variant?: "outline" | "filled" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type FileDropzoneVariants = VariantProps<typeof fileDropzoneVariants>;
+
+/** FileInput·FileUpload·FilePicker가 공유하는 파일 모델과 검증 함수. */
+type FileItem = {
+    kind: 'local';
+    file: File;
+    id: string;
+} | {
+    kind: 'remote';
+    name: string;
+    url: string;
+    size?: number;
+    mimeType?: string;
+    id?: string;
+};
+type FileErrorReason = 'too-large' | 'invalid-type' | 'too-many';
+interface FileError {
+    fileName: string;
+    reason: FileErrorReason;
+    message: string;
+}
+declare function getFileName(item: FileItem): string;
+declare function getFileSize(item: FileItem): number | undefined;
+declare function getItemKey(item: FileItem): string;
+declare function formatBytes(bytes: number): string;
+/** MIME type, MIME glob, 확장자를 모두 지원하는 accept 매칭. */
+declare function matchesAccept(file: File, accept?: string): boolean;
+declare function newLocalId(): string;
+declare function isImageFile(item: FileItem): boolean;
+declare function isPdfFile(item: FileItem): boolean;
+
+declare const fileInputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface FileInputProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onError'>, VariantProps<typeof fileInputVariants> {
+    variant?: 'filled' | 'outline';
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onChange?: (files: FileItem[]) => void;
+    multiple?: boolean;
+    accept?: string;
+    maxSize?: number;
+    maxFiles?: number;
+    disabled?: boolean;
+    uploading?: boolean;
+    onError?: (errors: FileError[]) => void;
+    placeholder?: React.ReactNode;
+    triggerLabel?: React.ReactNode;
+    invalid?: boolean;
+    id?: string;
+}
+/** 한 줄 폼 리듬에 맞춘 파일 선택기. DnD가 필요하면 FileUpload를 사용한다. */
+declare const FileInput: React.ForwardRefExoticComponent<FileInputProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const fileDropAreaVariants: (props?: ({
+    variant?: "outline" | "filled" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onError'>, Omit<VariantProps<typeof fileDropAreaVariants>, 'variant'> {
+    variant?: FileDropzoneVariant;
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onChange?: (files: FileItem[]) => void;
+    multiple?: boolean;
+    accept?: string;
+    maxSize?: number;
+    maxFiles?: number;
+    disabled?: boolean;
+    uploading?: boolean;
+    onError?: (errors: FileError[]) => void;
+    placeholder?: React.ReactNode;
+    helpText?: React.ReactNode;
+    invalid?: boolean;
+    itemsClassName?: string;
+    itemsPlacement?: 'outside' | 'inside';
+    id?: string;
+}
+/** 클릭·키보드·드래그앤드롭과 로컬/원격 미리보기를 하나의 파일 수명주기로 묶는다. */
+declare const FileUpload: React.ForwardRefExoticComponent<FileUploadProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 단일 날짜 선택기 — `Popover` + 트리거 `Button`(outline) + `Calendar` 조합.
+ * value/onChange 는 `YYYY-MM-DD` 문자열(`includeTime` 시 `YYYY-MM-DDTHH:mm`)을 주고받는다.
+ * controlled 컴포넌트이므로 호출부에서 상태를 관리한다 — react-hook-form 연동은
+ * `<FormField render={({ field }) => <DatePicker value={field.value} onChange={field.onChange} />} />`.
+ */
+interface DatePickerProps {
+    /** YYYY-MM-DD 문자열 (includeTime 시 YYYY-MM-DDTHH:mm) */
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 선택 가능한 최소 날짜 (YYYY-MM-DD) */
+    minDate?: string;
+    /** 선택 가능한 최대 날짜 (YYYY-MM-DD) */
+    maxDate?: string;
+    /** 시간(HH:mm)까지 선택한다. value 형식이 YYYY-MM-DDTHH:mm 으로 바뀐다. */
+    includeTime?: boolean;
+    /** 팝오버/드로어가 닫힐 때(편집 완료) 호출. 소비측이 시작↔종료 정합성 보정 등에 쓴다. */
+    onClose?: () => void;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    variant?: FieldControlVariant;
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-describedby'?: string;
+    /** 필수 입력 상태를 실제 트리거에 전달한다. */
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    /** FormControl이 주입하는 invalid 상태. `invalid`와 병합해 실제 트리거에 전달한다. */
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    className?: string;
+    id?: string;
+}
+declare const DatePicker: React.ForwardRefExoticComponent<DatePickerProps & React.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * 시작일/종료일을 선택하는 날짜 범위 입력기 — `Calendar`(range mode).
+ * 기본은 `DatePicker` 와 같은 1개월 뷰이고, `numberOfMonths={2}` 로 2개월을 좌우로 펼친다.
+ * value/onChange 는 `{ from, to }` (각각 `YYYY-MM-DD` 문자열, 미선택 시 빈 문자열)을 주고받는다.
+ * `includeTime` 시 `from`/`to` 형식이 `YYYY-MM-DDTHH:mm` 으로 바뀐다.
+ *
+ * **반응형 캡슐화** — 데스크톱은 `Popover`, 모바일은 vaul `Drawer`(content-height, multi-detent)
+ * 로 풀폭 캘린더를 띄운다. 사용처는 분기 없이 한 번만 쓴다.
+ *
+ * **C2 전면 전환(plan 079)**: 이미 시트 안(`useInSheetPanel`)에서 열릴 때 종전엔 인라인
+ * `Collapsible` 아코디언으로 펼쳤으나, 본 플랜에서 **중첩 content-height 시트**(vaul NestedRoot)로
+ * 띄운다. nested 전환은 `Drawer` 프리미티브 내부에서 `useInSheetPanel()` 자동 감지로 처리되므로,
+ * 모바일이면 시트 안/밖 무관하게 동일하게 `Drawer` 를 렌더한다(`Combobox`·`Select` 와 동일 패턴).
+ *
+ * `to >= from` 같은 기간 정합성은 컴포넌트가 강제하지 않는다 — 소비측 zod refine 책임.
+ */
+interface DateRange {
+    /** YYYY-MM-DD 문자열 (includeTime 시 YYYY-MM-DDTHH:mm), 미선택 시 빈 문자열 */
+    from: string;
+    /** YYYY-MM-DD 문자열 (includeTime 시 YYYY-MM-DDTHH:mm), 미선택 시 빈 문자열 */
+    to: string;
+}
+interface DateRangePickerProps {
+    value: DateRange;
+    onChange: (range: DateRange) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 시작·종료 시간(HH:mm)까지 선택한다. value.from/to 형식이 YYYY-MM-DDTHH:mm 으로 바뀐다. */
+    includeTime?: boolean;
+    /** 캘린더에 펼칠 개월 수. 기본 1(DatePicker 와 동일한 단일 뷰), 2 로 두 달을 좌우로 펼친다. */
+    numberOfMonths?: 1 | 2;
+    /**
+     * 트리거+팝오버 대신 **캘린더를 그 자리에 인라인**으로 렌더한다(중첩 오버레이 회피).
+     * 모바일 필터 시트처럼 이미 떠 있는 표면 안에서 날짜를 고를 때 사용 — 시트 위에 또
+     * 작은 팝오버를 띄우지 않는다(연구 권고). `className` 은 인라인 래퍼에 적용된다.
+     */
+    inline?: boolean;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    variant?: FieldControlVariant;
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-describedby'?: string;
+    /** 필수 입력 상태를 실제 트리거에 전달한다. */
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    /** FormControl이 주입하는 invalid 상태. `invalid`와 병합해 실제 트리거에 전달한다. */
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** inline 캘린더 group의 접근 가능한 이름. 트리거 모드에서는 필요하지 않다. */
+    'aria-label'?: string;
+    /** inline 캘린더 group을 외부 제목에 연결한다. */
+    'aria-labelledby'?: string;
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    className?: string;
+    id?: string;
+}
+declare const DateRangePicker: React.ForwardRefExoticComponent<DateRangePickerProps & React.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * 시간 단독 선택 — PC Popover + 시·분 dropdown / 모바일 bottom Drawer(시·분 리스트).
+ *
+ * `DatePicker` 의 짝꿍. value/onChange 는 `'HH:mm'` 24 시간 문자열을 주고받는다.
+ * `DatePicker` 의 `includeTime` 은 날짜와 시간을 함께 선택하지만, 시간만 필요한 폼
+ * (회의 시작 시각·약속 시간 등) 에는 본 컴포넌트가 더 가볍다.
+ *
+ * - 좌측 `Clock` 아이콘 (`DatePicker` 의 캘린더 아이콘과 동일 위치)
+ * - **PC**: native `<select>`(시/분) Popover — 마우스 친화, 기존 동작 유지.
+ * - **모바일(plan 079 C4)**: vaul `Drawer` 안 시·분 2열 리스트(`SelectableOption`) — 네이티브
+ *   `<select>` popover 제거(모바일 popover 0 완성). 시트 안에서 열리면 `Drawer` 가 자동으로
+ *   중첩 시트(NestedRoot)로 뜬다(C1·C2).
+ * - `step` 으로 분 단위 제어 (1·5·10·15·30 등)
+ * - `minTime` / `maxTime` 로 선택 가능 범위 제약 — 옵션 목록을 동적으로 필터
+ * - `Button` outline 트리거 (`DatePicker` 와 동일 시각)
+ */
+interface TimeInputProps {
+    /** `'HH:mm'` 24시간 문자열 */
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 선택 가능한 최소 시간 (`'HH:mm'`). */
+    minTime?: string;
+    /** 선택 가능한 최대 시간 (`'HH:mm'`). */
+    maxTime?: string;
+    /** 분 단위 step (1·5·10·15·30 등). 기본 1. */
+    step?: number;
+    /** 트리거 사이즈 (Button 과 동일 척도). */
+    size?: 'sm' | 'md' | 'lg';
+    /** invalid 시 destructive 보더. */
+    invalid?: boolean;
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-describedby'?: string;
+    /** 필수 입력 상태를 실제 트리거에 전달한다. */
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    /** FormControl이 주입하는 invalid 상태. `invalid`와 병합해 실제 트리거에 전달한다. */
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    variant?: FieldControlVariant;
+    className?: string;
+    id?: string;
+}
+declare const TimeInput: React.ForwardRefExoticComponent<TimeInputProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const checkboxVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CheckboxProps extends React.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, VariantProps<typeof checkboxVariants> {
+    label?: React.ReactNode;
+    indeterminate?: boolean;
+}
+declare const Checkbox: React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof inputVariants> {
+    variant?: FieldControlVariant;
+    invalid?: boolean;
+    leftSlot?: React.ReactNode;
+    rightSlot?: React.ReactNode;
+    wrapperClassName?: string;
+}
+interface InputFrameProps extends React.HTMLAttributes<HTMLDivElement> {
+    leftSlot?: React.ReactNode;
+    rightSlot?: React.ReactNode;
+    disabled?: boolean;
+}
+declare const InputFrame: React.ForwardRefExoticComponent<InputFrameProps & React.RefAttributes<HTMLDivElement>>;
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+
+type InputSize = NonNullable<InputProps['size']>;
+
+declare const radioItemVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const RadioGroupRoot: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    label?: React.ReactNode;
+} & React.RefAttributes<HTMLDivElement>>;
+interface RadioGroupItemProps extends React.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item>, VariantProps<typeof radioItemVariants> {
+    label?: React.ReactNode;
+}
+declare const RadioGroupItem: React.ForwardRefExoticComponent<RadioGroupItemProps & React.RefAttributes<HTMLButtonElement>>;
+declare const RadioGroup: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    label?: React.ReactNode;
+} & React.RefAttributes<HTMLDivElement>> & {
+    Root: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+        label?: React.ReactNode;
+    } & React.RefAttributes<HTMLDivElement>>;
+    Item: React.ForwardRefExoticComponent<RadioGroupItemProps & React.RefAttributes<HTMLButtonElement>>;
+};
+type RadioGroupProps = React.ComponentPropsWithoutRef<typeof RadioGroupRoot>;
+
+declare const SelectGroup: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectValue: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectValueProps & React.RefAttributes<HTMLSpanElement>, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare const selectTriggerVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SelectTriggerProps extends React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, VariantProps<typeof selectTriggerVariants> {
+    variant?: FieldControlVariant;
+    required?: boolean;
+}
+declare const SelectTrigger: React.ForwardRefExoticComponent<SelectTriggerProps & React.RefAttributes<HTMLButtonElement>>;
+declare const SelectScrollUpButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectScrollDownButton: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectContent: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectLabel: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectItem: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const SelectSeparator: React.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+interface SelectProps extends React.ComponentPropsWithoutRef<typeof SelectPrimitive.Root> {
+}
+declare function Select({ value: controlled, defaultValue, onValueChange, disabled, open: openProp, defaultOpen, onOpenChange, children, ...rootProps }: SelectProps): React.JSX.Element;
+declare namespace Select {
+    var displayName: string;
+}
+
+declare const textareaVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'size'>, VariantProps<typeof textareaVariants> {
+    resize?: TextareaResize;
+    showCount?: boolean;
+    footer?: React.ReactNode;
+    wrapperClassName?: string;
+    variant?: FieldControlVariant;
+    invalid?: boolean;
+}
+type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
+declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
+
+interface ComboboxOption {
+    value: string;
+    label: string;
+    keywords?: readonly string[];
+    disabled?: boolean;
+    leading?: React.ReactNode;
+}
+interface ComboboxProps {
+    options: readonly ComboboxOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    /** Accessible name for the search input inside the list surface. */
+    searchLabel?: string;
+    emptyLabel?: string;
+    disabled?: boolean;
+    invalid?: boolean;
+    triggerClassName?: string;
+    contentClassName?: string;
+    align?: 'start' | 'center' | 'end';
+    'aria-label'?: string;
+    'aria-describedby'?: string;
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    variant?: FieldControlVariant;
+    id?: string;
+}
+/** Searchable single selection that renders as a popover on pointer-fine screens and a Drawer on mobile. */
+declare const Combobox: React.ForwardRefExoticComponent<ComboboxProps & React.RefAttributes<HTMLButtonElement>>;
+
+declare const FormStack: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+interface FormLayoutFieldProps {
+    label?: React.ReactNode;
+    htmlFor?: string;
+    /** 복합 컨트롤의 accessible name을 연결할 label id입니다. */
+    labelId?: string;
+    required?: boolean;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+    descriptionId?: string;
+    errorId?: string;
+    labelClassName?: string;
+    className?: string;
+    children: React.ReactNode;
+}
+/** RHF 여부와 무관하게 라벨·설명·오류 리듬을 동일하게 유지하는 필드 레이아웃. */
+declare function FormLayoutField({ children, className, description, descriptionId, error, errorId, htmlFor, label, labelId, labelClassName, required, }: FormLayoutFieldProps): React.JSX.Element;
+declare namespace FormLayoutField {
+    var displayName: string;
+}
+/** Daeium의 `Field`와 같은 의미를 명시적으로 드러내는 별칭. */
+declare const FieldLayout: typeof FormLayoutField;
+
+interface NumberInputProps extends Omit<InputProps, 'type' | 'value' | 'onChange' | 'inputMode'> {
+    /** 천 단위 구분 기호를 표시한다. 기본값은 true다. */
+    commaize?: boolean;
+    /** 표시 문자열 정렬. */
+    textAlign?: 'left' | 'right';
+    /** 소비자가 받는 실제 숫자 값. 빈 값은 null이다. */
+    value?: number | null;
+    onChange?: (value: number | null) => void;
+}
+/** 표시 문자열과 실제 number 값을 분리하는 숫자 입력. */
+declare const NumberInput: React.ForwardRefExoticComponent<NumberInputProps & React.RefAttributes<HTMLInputElement>>;
+
+interface PasswordInputProps extends Omit<InputProps, 'type'> {
+    showToggle?: boolean;
+}
+/** 비밀번호 표시 상태를 키보드·스크린리더와 함께 제공하는 입력. */
+declare const PasswordInput: React.ForwardRefExoticComponent<PasswordInputProps & React.RefAttributes<HTMLInputElement>>;
+
+interface PhoneInputProps extends Omit<InputProps, 'type' | 'value' | 'onChange' | 'inputMode'> {
+    value?: string;
+    onChange?: (value: string) => void;
+    onValidityChange?: (valid: boolean) => void;
+}
+/** 입력 중에도 캐럿 위치를 보존하는 한국 전화번호 입력. */
+declare const PhoneInput: React.ForwardRefExoticComponent<PhoneInputProps & React.RefAttributes<HTMLInputElement>>;
+
+interface ManagedFieldProps<Value> extends Omit<FormLayoutFieldProps, 'children' | 'className'> {
+    /** 필드 레이아웃에만 적용할 클래스. `className`은 실제 컨트롤에 전달됩니다. */
+    containerClassName?: string;
+    value?: Value;
+    onChange?: (value: Value) => void;
+    onAfterChange?: (value: Value) => void;
+}
+interface TextFieldProps extends ManagedFieldProps<string>, Omit<InputProps, 'value' | 'onChange' | 'size'> {
+    size?: InputProps['size'];
+    submitOnEnter?: boolean;
+}
+declare const TextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;
+interface PasswordFieldProps extends ManagedFieldProps<string>, Omit<PasswordInputProps, 'value' | 'onChange' | 'size'> {
+    size?: PasswordInputProps['size'];
+    submitOnEnter?: boolean;
+}
+declare const PasswordField: React.ForwardRefExoticComponent<PasswordFieldProps & React.RefAttributes<HTMLInputElement>>;
+interface NumberFieldProps extends ManagedFieldProps<number | null>, Omit<NumberInputProps, 'value' | 'onChange'> {
+    submitOnEnter?: boolean;
+}
+declare const NumberField: React.ForwardRefExoticComponent<NumberFieldProps & React.RefAttributes<HTMLInputElement>>;
+interface PhoneFieldProps extends ManagedFieldProps<string>, Omit<PhoneInputProps, 'value' | 'onChange'> {
+    submitOnEnter?: boolean;
+}
+declare const PhoneField: React.ForwardRefExoticComponent<PhoneFieldProps & React.RefAttributes<HTMLInputElement>>;
+interface TextareaFieldProps extends ManagedFieldProps<string>, Omit<TextareaProps, 'value' | 'onChange'> {
+}
+declare const TextareaField: React.ForwardRefExoticComponent<TextareaFieldProps & React.RefAttributes<HTMLTextAreaElement>>;
+interface CheckboxFieldProps extends ManagedFieldProps<boolean>, Omit<CheckboxProps, 'checked' | 'onCheckedChange' | 'onChange' | 'label' | 'value'> {
+    invalid?: boolean;
+}
+declare function CheckboxField({ 'aria-describedby': ariaDescribedBy, 'aria-label': ariaLabel, 'aria-invalid': ariaInvalid, className, containerClassName, description, error, htmlFor, id, invalid, label, labelClassName, onAfterChange, onChange, required, value, ...props }: CheckboxFieldProps): React.JSX.Element;
+declare namespace CheckboxField {
+    var displayName: string;
+}
+interface RadioOption extends Pick<RadioGroupItemProps, 'value' | 'disabled'> {
+    label: React.ReactNode;
+}
+interface RadioGroupFieldProps extends ManagedFieldProps<string>, Omit<React.ComponentPropsWithoutRef<typeof RadioGroup>, 'value' | 'onValueChange' | 'onChange' | 'children'> {
+    /** 간단한 라디오 목록을 만들 때 사용합니다. `children`과 함께 쓸 수 없습니다. */
+    options?: RadioOption[];
+    /** RadioGroupItem을 직접 조합할 때 사용합니다. */
+    children?: React.ReactNode;
+    invalid?: boolean;
+}
+declare function RadioGroupField({ 'aria-describedby': ariaDescribedBy, 'aria-labelledby': ariaLabelledBy, 'aria-invalid': ariaInvalid, className, containerClassName, children, description, error, htmlFor: _htmlFor, id, invalid, label, labelClassName: _labelClassName, onAfterChange, onChange, options, required, value, ...props }: RadioGroupFieldProps): React.JSX.Element;
+declare namespace RadioGroupField {
+    var displayName: string;
+}
+interface SelectOption {
+    value: string;
+    label: React.ReactNode;
+    disabled?: boolean;
+}
+interface SelectFieldProps extends ManagedFieldProps<string>, Omit<React.ComponentPropsWithoutRef<typeof Select>, 'value' | 'onValueChange' | 'children'> {
+    options: SelectOption[];
+    placeholder?: string;
+    triggerProps?: React.ComponentPropsWithoutRef<typeof SelectTrigger>;
+    /** 트리거에 적용할 추가 클래스. */
+    className?: string;
+    invalid?: boolean;
+    'aria-describedby'?: string;
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+}
+declare function SelectField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, error, htmlFor: _htmlFor, invalid, label, labelClassName: _labelClassName, onAfterChange, onChange, options, placeholder, required, triggerProps, value, ...props }: SelectFieldProps): React.JSX.Element;
+declare namespace SelectField {
+    var displayName: string;
+}
+/** 검색 가능한 선택 필드. Combobox가 PC Popover·모바일 Drawer 전환을 소유한다. */
+interface ComboboxFieldProps extends ManagedFieldProps<string>, Omit<ComboboxProps, 'value' | 'onValueChange' | 'defaultValue' | 'invalid'> {
+    invalid?: boolean;
+}
+declare function ComboboxField({ 'aria-describedby': ariaDescribedBy, 'aria-label': ariaLabel, 'aria-invalid': ariaInvalid, containerClassName, description, error, htmlFor: _htmlFor, id, invalid, label, labelClassName, onAfterChange, onChange, required, value, ...props }: ComboboxFieldProps): React.JSX.Element;
+declare namespace ComboboxField {
+    var displayName: string;
+}
+interface DateFieldProps extends ManagedFieldProps<string>, Omit<DatePickerProps, 'value' | 'onChange'> {
+}
+declare function DateField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, id, error, htmlFor, invalid, label, labelClassName, onAfterChange, onChange, required, value, ...props }: DateFieldProps): React.JSX.Element;
+declare namespace DateField {
+    var displayName: string;
+}
+interface TimeFieldProps extends ManagedFieldProps<string>, Omit<TimeInputProps, 'value' | 'onChange'> {
+}
+declare function TimeField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, id, error, htmlFor, invalid, label, labelClassName, onAfterChange, onChange, required, value, ...props }: TimeFieldProps): React.JSX.Element;
+declare namespace TimeField {
+    var displayName: string;
+}
+interface DateRangeFieldProps extends ManagedFieldProps<DateRange>, Omit<DateRangePickerProps, 'value' | 'onChange'> {
+}
+declare function DateRangeField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, id, error, htmlFor, invalid, label, labelClassName, onAfterChange, onChange, required, value, ...props }: DateRangeFieldProps): React.JSX.Element;
+declare namespace DateRangeField {
+    var displayName: string;
+}
+type LunarConvertChoice = 'replace' | 'flag';
+declare function resolveLunarConvertPreview(choice: LunarConvertChoice, current: string, converted: string): string;
+interface LunarConvertDialogProps {
+    open: boolean;
+    next: boolean;
+    current: string;
+    converted: string;
+    onConfirm: (choice: LunarConvertChoice) => void;
+    onCancel: () => void;
+}
+/** 음력 토글의 치환/표기만 선택 UI. 날짜 변환 라이브러리는 호출부가 주입한다. */
+declare function LunarConvertDialog({ open, next, current, converted, onCancel, onConfirm, }: LunarConvertDialogProps): React.JSX.Element;
+declare namespace LunarConvertDialog {
+    var displayName: string;
+}
+type LunarToggleDecision = {
+    mode: 'plain';
+} | {
+    mode: 'modal';
+    converted: string;
+};
+declare function decideLunarToggle(current: string | undefined, nextLunar: boolean, convert?: (value: string, toLunar: boolean) => string | null): LunarToggleDecision;
+interface LunarDateFieldProps extends Omit<DatePickerProps, 'value' | 'onChange'> {
+    htmlFor?: string;
+    containerClassName?: string;
+    labelClassName?: string;
+    value?: string;
+    lunar?: boolean;
+    onChange?: (value: string) => void;
+    onAfterChange?: (value: string) => void;
+    onLunarChange?: (value: boolean) => void;
+    /** RHF가 음력 플래그 컨트롤을 직접 focus·touched 처리할 때 사용하는 ref입니다. */
+    lunarRef?: React.Ref<HTMLButtonElement>;
+    /** 음력 플래그 컨트롤에서 포커스가 빠질 때 호출합니다. */
+    onLunarBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    convert?: (value: string, toLunar: boolean) => string | null;
+    lunarLabel?: React.ReactNode;
+    label?: React.ReactNode;
+    required?: boolean;
+    description?: React.ReactNode;
+    error?: React.ReactNode;
+}
+/** 날짜와 음력 플래그를 한 필드로 보여주며, 변환은 주입된 순수 함수로 확인한다. */
+declare function LunarDateField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, containerClassName, convert, description, error, htmlFor, id, invalid, label, labelClassName, lunar, lunarLabel, lunarRef, onLunarBlur, onAfterChange, onChange, onLunarChange, required, value, ...dateProps }: LunarDateFieldProps): React.JSX.Element;
+declare namespace LunarDateField {
+    var displayName: string;
+}
+
+/** 폼 검증 오류에서 사용자에게 보여 줄 첫 번째 메시지를 찾는다. */
+declare function firstInvalidMessage(errors: unknown): string | null;
+interface InvalidSubmitOptions {
+    /** 제품의 toast·알림 시스템을 주입한다. 생략하면 메시지를 반환하기만 한다. */
+    notify?: (message: string) => void;
+    fallback?: string;
+}
+/** 숨겨진/조건부 필드 때문에 조용히 실패하는 제출을 보완하는 프레임워크 독립 핸들러. */
+declare function reportInvalidSubmit(errors: unknown, { fallback, notify }?: InvalidSubmitOptions): string;
+
+interface SubmitGuardSchema {
+    safeParse: (value: unknown) => {
+        success: boolean;
+    };
+}
+interface SubmitGuardOptions {
+    busy?: boolean;
+    busyReason?: string;
+    incompleteReason?: string;
+}
+interface SubmitGuard {
+    canSubmit: boolean;
+    complete: boolean;
+    reason: string | null;
+}
+/**
+ * 검증 스키마와 현재 값을 연결하는 프레임워크 독립 제출 게이트.
+ * React Hook Form 연결은 optional subpath에서 values를 구독해 이 훅에 넘긴다.
+ */
+declare function useSubmitGuard(values: unknown, schema: SubmitGuardSchema, { busy, busyReason, incompleteReason }?: SubmitGuardOptions): SubmitGuard;
+
+interface LabelProps extends React.LabelHTMLAttributes<HTMLLabelElement> {
+    asChild?: boolean;
+}
+/** Standalone label. Use Field.Label when the surrounding Field owns IDs and validation. */
+declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLLabelElement>>;
+
+export { Label as $, type DateRangePickerProps as A, type FieldControlVariants as B, type CheckboxFieldProps as C, type DateFieldProps as D, FieldLayout as E, type FileInputProps as F, type FileDropzoneVariant as G, type FileDropzoneVariants as H, type InputProps as I, type FileError as J, type FileErrorReason as K, type LabelProps as L, FileInput as M, type NumberFieldProps as N, type FileItem as O, type PasswordFieldProps as P, FileUpload as Q, type RadioGroupFieldProps as R, type SubmitGuardOptions as S, type TextFieldProps as T, FormLayoutField as U, type FormLayoutFieldProps as V, FormStack as W, Input as X, InputFrame as Y, type InputSize as Z, type InvalidSubmitOptions as _, type ComboboxFieldProps as a, type LunarConvertChoice as a0, LunarConvertDialog as a1, type LunarConvertDialogProps as a2, LunarDateField as a3, type LunarToggleDecision as a4, NumberField as a5, NumberInput as a6, type NumberInputProps as a7, PasswordField as a8, PasswordInput as a9, TextareaField as aA, type TextareaProps as aB, type TextareaResize as aC, TimeField as aD, TimeInput as aE, type TimeInputProps as aF, checkboxVariants as aG, decideLunarToggle as aH, fileDropAreaVariants as aI, fieldControlVariants as aJ, fileDropzoneVariants as aK, fileInputVariants as aL, formatBytes as aM, getFileName as aN, getFileSize as aO, getItemKey as aP, inputVariants as aQ, isImageFile as aR, isPdfFile as aS, matchesAccept as aT, newLocalId as aU, radioItemVariants as aV, resolveLunarConvertPreview as aW, selectTriggerVariants as aX, textareaVariants as aY, useSubmitGuard as aZ, type PasswordInputProps as aa, PhoneField as ab, PhoneInput as ac, type PhoneInputProps as ad, RadioGroup as ae, RadioGroupField as af, RadioGroupItem as ag, type RadioGroupItemProps as ah, type RadioGroupProps as ai, RadioGroupRoot as aj, Select as ak, SelectContent as al, SelectField as am, SelectGroup as an, SelectItem as ao, SelectLabel as ap, type SelectOption as aq, type SelectProps as ar, SelectScrollDownButton as as, SelectScrollUpButton as at, SelectSeparator as au, SelectTrigger as av, type SelectTriggerProps as aw, SelectValue as ax, TextField as ay, Textarea as az, type DateRangeFieldProps as b, type FileUploadProps as c, type LunarDateFieldProps as d, type PhoneFieldProps as e, type SelectFieldProps as f, type TextareaFieldProps as g, type TimeFieldProps as h, type SubmitGuardSchema as i, type SubmitGuard as j, firstInvalidMessage as k, type FieldControlVariant as l, Checkbox as m, CheckboxField as n, type CheckboxProps as o, Combobox as p, ComboboxField as q, reportInvalidSubmit as r, type ComboboxOption as s, type ComboboxProps as t, DateField as u, DatePicker as v, type DatePickerProps as w, type DateRange as x, DateRangeField as y, DateRangePicker as z };