@amineslab/ui 0.1.0-next.20260925131012 → 0.1.0

package/dist/use-submit-guard-DyOToVDM.d.cts

@@ -0,0 +1,600 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+import { ReactNode, ComponentType, ExoticComponent } 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';
+/** Shared surface contract for text fields and selection triggers. */
+interface FieldControlProps {
+    variant?: FieldControlVariant;
+    /** Add an opaque theme surface beneath the elevation layer. */
+    opaque?: boolean;
+    /** Preserve error styling while focused or open. */
+    invalid?: boolean;
+}
+declare const fieldControlVariants: (props?: ({
+    opaque?: boolean | null | undefined;
+    variant?: "outline" | "filled" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type FieldControlVariants = VariantProps<typeof fieldControlVariants>;
+
+/** 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;
+interface FileConstraints {
+    /** MIME type 또는 확장자 목록. 예: .jpg,.png,.pdf */
+    accept?: string;
+    /** 파일당 최대 용량(MB). 생략하면 제한하지 않습니다. */
+    maxSize?: number;
+    /** 최대 파일 개수. 생략하면 multiple 설정만 적용합니다. */
+    maxFiles?: number;
+}
+
+declare const fileInputVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface FileInputProps extends FileConstraints, Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onError'>, VariantProps<typeof fileInputVariants> {
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onValueChange?: (files: FileItem[]) => void;
+    multiple?: boolean;
+    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>>;
+
+/** 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>;
+
+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 FileConstraints, Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onError'>, Omit<VariantProps<typeof fileDropAreaVariants>, 'variant'> {
+    variant?: FileDropzoneVariant;
+    opaque?: FieldControlProps['opaque'];
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onValueChange?: (files: FileItem[]) => void;
+    multiple?: boolean;
+    /** 업로드 영역에 표시할 형식 안내. 실제 검증은 accept를 사용합니다. */
+    acceptLabel?: string;
+    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>>;
+
+declare const checkboxVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | 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>>;
+
+/** An icon component reference, or a rendered node such as an SVG or emoji. */
+type ButtonIcon = ReactNode | ComponentType<{
+    className?: string;
+    size?: number;
+}> | ExoticComponent<{
+    className?: string;
+    size?: number;
+}>;
+
+/** Shared five-step control scale. Density changes spacing, not named sizes. */
+type ControlSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+/**
+ * 단일 날짜 선택기 · `Popover` + 트리거 `Button`(outline) + `Calendar` 조합.
+ * value/onChange 는 `YYYY-MM-DD` 문자열(`showTime` 시 `YYYY-MM-DDTHH:mm`)을 주고받는다.
+ * controlled 컴포넌트이므로 호출부에서 상태를 관리한다 · react-hook-form 연동은
+ * `<FormField render={({ field }) => <DatePicker value={field.value} onChange={field.onChange} />} />`.
+ */
+interface DatePickerProps {
+    size?: ControlSize;
+    /** YYYY-MM-DD 문자열 (showTime 시 YYYY-MM-DDTHH:mm) */
+    value?: string;
+    onValueChange?: (value: string) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 선택 가능한 최소 날짜 (YYYY-MM-DD) */
+    minDate?: string;
+    /** 선택 가능한 최대 날짜 (YYYY-MM-DD) */
+    maxDate?: string;
+    /** 시간(HH:mm)까지 선택한다. value 형식이 YYYY-MM-DDTHH:mm 으로 바뀐다. */
+    showTime?: boolean;
+    hourCycle?: 12 | 24;
+    /** 팝오버/드로어가 닫힐 때(편집 완료) 호출. 소비측이 시작↔종료 정합성 보정 등에 쓴다. */
+    onClose?: () => void;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-errormessage'?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    '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` 문자열, 미선택 시 빈 문자열)을 주고받는다.
+ * `showTime` 시 `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 문자열 (showTime 시 YYYY-MM-DDTHH:mm), 미선택 시 빈 문자열 */
+    from: string;
+    /** YYYY-MM-DD 문자열 (showTime 시 YYYY-MM-DDTHH:mm), 미선택 시 빈 문자열 */
+    to: string;
+}
+interface DateRangePickerProps {
+    size?: ControlSize;
+    value: DateRange;
+    onValueChange: (range: DateRange) => void;
+    placeholder?: string;
+    disabled?: boolean;
+    /** 시작·종료 시간(HH:mm)까지 선택한다. value.from/to 형식이 YYYY-MM-DDTHH:mm 으로 바뀐다. */
+    showTime?: boolean;
+    hourCycle?: 12 | 24;
+    /** 캘린더에 펼칠 개월 수. 기본 1(DatePicker 와 동일한 단일 뷰), 2 로 두 달을 좌우로 펼친다. */
+    numberOfMonths?: 1 | 2;
+    /**
+     * 트리거+팝오버 대신 **캘린더를 그 자리에 인라인**으로 렌더한다(중첩 오버레이 회피).
+     * 모바일 필터 시트처럼 이미 떠 있는 표면 안에서 날짜를 고를 때 사용 · 시트 위에 또
+     * 작은 팝오버를 띄우지 않는다(연구 권고). `className` 은 인라인 래퍼에 적용된다.
+     */
+    inline?: boolean;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-errormessage'?: string;
+    '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>>;
+
+interface TimeInputProps {
+    /** `'HH:mm'` 24시간 문자열 */
+    value?: string;
+    onValueChange?: (value: string) => void;
+    placeholder?: string;
+    /** 트리거 없이 시·분 선택을 직접 표시합니다. PC는 직접 입력, 모바일은 휠을 표시합니다. */
+    inline?: boolean;
+    /** 표시 형식. value/onChange는 항상 24시간 HH:mm입니다. */
+    hourCycle?: 12 | 24;
+    inlineLabel?: string;
+    inlineLabelPosition?: 'top' | 'start';
+    disabled?: boolean;
+    /** 선택 가능한 최소 시간 (`'HH:mm'`). */
+    minTime?: string;
+    /** 선택 가능한 최대 시간 (`'HH:mm'`). */
+    maxTime?: string;
+    /** 분 단위 step (1·5·10·15·30 등). 기본 1. */
+    step?: number;
+    /** 입력 또는 모바일 트리거 크기. */
+    size?: ControlSize;
+    /** invalid 시 destructive 보더. */
+    invalid?: boolean;
+    /** FormControl이 주입하는 설명/오류 메시지 연결 ID. 실제 트리거에 전달한다. */
+    'aria-errormessage'?: string;
+    'aria-describedby'?: string;
+    /** 필수 입력 상태를 실제 트리거에 전달한다. */
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    /** FormControl이 주입하는 invalid 상태. `invalid`와 병합해 실제 트리거에 전달한다. */
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLInputElement | HTMLButtonElement | HTMLFieldSetElement>;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    className?: string;
+    id?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+type TimeInputElement = HTMLInputElement | HTMLButtonElement | HTMLFieldSetElement;
+/** One time field: direct masked input on desktop, wheel on mobile. */
+declare const TimeInput: React.ForwardRefExoticComponent<TimeInputProps & React.RefAttributes<TimeInputElement>>;
+
+interface ComboboxOption {
+    value: string;
+    label: string;
+    keywords?: readonly string[];
+    disabled?: boolean;
+    icon?: React.ReactNode;
+}
+interface ComboboxProps {
+    size?: ControlSize;
+    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-errormessage'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-required'?: React.AriaAttributes['aria-required'];
+    'aria-invalid'?: React.AriaAttributes['aria-invalid'];
+    /** 트리거가 포커스를 잃을 때 호출합니다. RHF touched 처리에 사용합니다. */
+    onBlur?: React.FocusEventHandler<HTMLButtonElement>;
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    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>>;
+
+interface FormStackProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** 필드 사이 간격. 기본 테마에서 sm 8px, md 16px, lg 24px입니다. */
+    gap?: 'sm' | 'md' | 'lg';
+    /** PC 열 수. 모바일에서는 항상 한 열입니다. */
+    columns?: 1 | 2;
+}
+declare const FormStack: React.ForwardRefExoticComponent<FormStackProps & React.RefAttributes<HTMLDivElement>>;
+/** @deprecated 새 조합에는 FormFieldProps를 사용하세요. */
+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;
+}
+/** @deprecated 새 조합에는 FormField를 사용하세요. 기존 수동 ID 연결 계약을 유지하는 호환 wrapper입니다. */
+declare function FormLayoutField({ children, className, description, descriptionId, error, errorId, htmlFor, label, labelId, labelClassName, required, }: FormLayoutFieldProps): React.JSX.Element;
+declare namespace FormLayoutField {
+    var displayName: string;
+}
+/** @deprecated FormField를 사용하세요. */
+declare const FieldLayout: typeof FormLayoutField;
+
+declare const inputVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof inputVariants> {
+    variant?: FieldControlProps['variant'];
+    /** Place an opaque theme surface below the elevation layer. Defaults to false. */
+    opaque?: FieldControlProps['opaque'];
+    invalid?: boolean;
+    startAdornment?: ButtonIcon;
+    endAdornment?: ButtonIcon;
+    wrapperClassName?: string;
+}
+interface InputFrameProps extends React.HTMLAttributes<HTMLDivElement> {
+    startAdornment?: React.ReactNode;
+    endAdornment?: React.ReactNode;
+    disabled?: boolean;
+    /** Control size that sets the slot gap and icon size. Defaults to md. */
+    size?: ControlSize;
+}
+declare const InputFrame: React.ForwardRefExoticComponent<InputFrameProps & React.RefAttributes<HTMLDivElement>>;
+declare const Input: React.ForwardRefExoticComponent<InputProps & React.RefAttributes<HTMLInputElement>>;
+
+type InputSize = NonNullable<InputProps['size']>;
+
+interface NumberInputProps extends Omit<InputProps, 'type' | 'value' | 'onChange' | 'inputMode'> {
+    /** 천 단위 구분 기호를 표시한다. 기본값은 true다. */
+    showThousandsSeparator?: boolean;
+    /** 표시 문자열 정렬. */
+    textAlign?: 'start' | 'end';
+    /** 소비자가 받는 실제 숫자 값. 빈 값은 null이다. */
+    value?: number | null;
+    onValueChange?: (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;
+    onValueChange?: (value: string) => void;
+    onValidityChange?: (valid: boolean) => void;
+}
+/** 입력 중에도 캐럿 위치를 보존하는 한국 전화번호 입력. */
+declare const PhoneInput: React.ForwardRefExoticComponent<PhoneInputProps & React.RefAttributes<HTMLInputElement>>;
+
+declare const radioItemVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const RadioGroupRoot: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+    label?: React.ReactNode;
+    size?: ControlSize;
+} & 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;
+    size?: ControlSize;
+} & React.RefAttributes<HTMLDivElement>> & {
+    Root: React.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React.RefAttributes<HTMLDivElement>, "ref"> & {
+        label?: React.ReactNode;
+        size?: ControlSize;
+    } & 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?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SelectTriggerProps extends React.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger>, VariantProps<typeof selectTriggerVariants> {
+    invalid?: FieldControlProps['invalid'];
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    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(props: SelectProps): React.JSX.Element;
+declare namespace Select {
+    var displayName: string;
+}
+
+declare const textareaVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | 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;
+    opaque?: FieldControlProps['opaque'];
+    variant?: FieldControlProps['variant'];
+    invalid?: boolean;
+}
+type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
+declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLTextAreaElement>>;
+
+interface ManagedFieldProps<Value> extends Omit<FormLayoutFieldProps, 'children' | 'className'> {
+    /** 필드 레이아웃에만 적용할 클래스. `className`은 실제 컨트롤에 전달됩니다. */
+    containerClassName?: string;
+    value?: Value;
+    onValueChange?: (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' | 'onValueChange'> {
+    submitOnEnter?: boolean;
+}
+declare const NumberField: React.ForwardRefExoticComponent<NumberFieldProps & React.RefAttributes<HTMLInputElement>>;
+interface PhoneFieldProps extends ManagedFieldProps<string>, Omit<PhoneInputProps, 'value' | 'onValueChange'> {
+    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, descriptionId, error, errorId, htmlFor, id, invalid, label, labelId, labelClassName, onAfterChange, onValueChange, required, value, size, ...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, descriptionId, error, errorId, htmlFor: _htmlFor, id, invalid, label, labelId, labelClassName: _labelClassName, onAfterChange, onValueChange, options, required, value, size, ...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>, FieldControlProps, 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({ variant, opaque, 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, descriptionId, error, errorId, htmlFor: _htmlFor, invalid, label, labelId, labelClassName: _labelClassName, onAfterChange, onValueChange, 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' | 'invalid'> {
+    invalid?: boolean;
+}
+declare function ComboboxField({ 'aria-describedby': ariaDescribedBy, 'aria-label': ariaLabel, 'aria-invalid': ariaInvalid, containerClassName, description, descriptionId, error, errorId, htmlFor: _htmlFor, id, invalid, label, labelId, labelClassName, onAfterChange, onValueChange, required, value, ...props }: ComboboxFieldProps): React.JSX.Element;
+declare namespace ComboboxField {
+    var displayName: string;
+}
+interface DateFieldProps extends ManagedFieldProps<string>, Omit<DatePickerProps, 'value' | 'onValueChange'> {
+}
+declare function DateField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, descriptionId, id, error, errorId, htmlFor, invalid, label, labelId, labelClassName, onAfterChange, onValueChange, required, value, ...props }: DateFieldProps): React.JSX.Element;
+declare namespace DateField {
+    var displayName: string;
+}
+interface TimeFieldProps extends ManagedFieldProps<string>, Omit<TimeInputProps, 'value' | 'onValueChange'> {
+}
+declare function TimeField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, descriptionId, id, error, errorId, htmlFor, invalid, label, labelId, labelClassName, onAfterChange, onValueChange, required, value, ...props }: TimeFieldProps): React.JSX.Element;
+declare namespace TimeField {
+    var displayName: string;
+}
+interface DateRangeFieldProps extends ManagedFieldProps<DateRange>, Omit<DateRangePickerProps, 'value' | 'onValueChange'> {
+}
+declare function DateRangeField({ 'aria-describedby': ariaDescribedBy, 'aria-invalid': ariaInvalid, className, containerClassName, description, descriptionId, id, error, errorId, htmlFor, invalid, label, labelId, labelClassName, onAfterChange, onValueChange, required, value, ...props }: DateRangeFieldProps): React.JSX.Element;
+declare namespace DateRangeField {
+    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 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>>;
+
+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;
+
+export { Input as $, DateRangeField as A, type ButtonIcon as B, type CheckboxFieldProps as C, type DateFieldProps as D, DateRangePicker as E, type FileInputProps as F, type DateRangePickerProps as G, type FieldControlVariant as H, type InputProps as I, type FieldControlVariants as J, FieldLayout as K, type LabelProps as L, type FileDropzoneVariant as M, type NumberFieldProps as N, type FileDropzoneVariants as O, type PasswordFieldProps as P, type FileErrorReason as Q, type RadioGroupFieldProps as R, type SubmitGuardOptions as S, type TextFieldProps as T, FileInput as U, type FileItem as V, FileUpload as W, FormLayoutField as X, type FormLayoutFieldProps as Y, FormStack as Z, type FormStackProps as _, type ComboboxFieldProps as a, InputFrame as a0, type InputSize as a1, type InvalidSubmitOptions as a2, Label as a3, NumberField as a4, NumberInput as a5, type NumberInputProps as a6, PasswordField as a7, PasswordInput as a8, type PasswordInputProps as a9, type TextareaProps as aA, type TextareaResize as aB, TimeField as aC, TimeInput as aD, type TimeInputElement as aE, type TimeInputProps as aF, checkboxVariants as aG, fileDropAreaVariants as aH, fieldControlVariants as aI, fileDropzoneVariants as aJ, fileInputVariants as aK, formatBytes as aL, getFileName as aM, getFileSize as aN, getItemKey as aO, inputVariants as aP, isImageFile as aQ, isPdfFile as aR, matchesAccept as aS, newLocalId as aT, radioItemVariants as aU, selectTriggerVariants as aV, textareaVariants as aW, useSubmitGuard as aX, PhoneField as aa, PhoneInput as ab, type PhoneInputProps as ac, RadioGroup as ad, RadioGroupField as ae, RadioGroupItem as af, type RadioGroupItemProps as ag, type RadioGroupProps as ah, RadioGroupRoot as ai, Select as aj, SelectContent as ak, SelectField as al, SelectGroup as am, SelectItem as an, SelectLabel as ao, type SelectOption as ap, type SelectProps as aq, SelectScrollDownButton as ar, SelectScrollUpButton as as, SelectSeparator as at, SelectTrigger as au, type SelectTriggerProps as av, SelectValue as aw, TextField as ax, Textarea as ay, TextareaField as az, type DateRangeFieldProps as b, type FileUploadProps as c, type PhoneFieldProps as d, type SelectFieldProps as e, type TextareaFieldProps as f, type TimeFieldProps as g, type SubmitGuardSchema as h, type SubmitGuard as i, firstInvalidMessage as j, type FileConstraints as k, type FileError as l, type FieldControlProps as m, type ControlSize as n, Checkbox as o, CheckboxField as p, type CheckboxProps as q, reportInvalidSubmit as r, Combobox as s, ComboboxField as t, type ComboboxOption as u, type ComboboxProps as v, DateField as w, DatePicker as x, type DatePickerProps as y, type DateRange as z };