@amineslab/ui 0.1.0-next.20260925131012 → 0.1.0

package/dist/label-BOY-jYQ0.d.cts

@@ -0,0 +1,581 @@
+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. */
+    background?: boolean;
+    /** Preserve error styling while focused or open. */
+    invalid?: boolean;
+}
+declare const fieldControlVariants: (props?: ({
+    background?: boolean | null | undefined;
+    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;
+interface FileConstraints {
+    /** MIME type 또는 확장자 목록. 예: .jpg,.png,.pdf */
+    accept?: string;
+    /** 파일당 최대 용량(MB). 생략하면 제한하지 않습니다. */
+    maxSize?: number;
+    /** 최대 파일 개수. 생략하면 multiple 설정만 적용합니다. */
+    maxFiles?: number;
+}
+
+declare const fileInputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface FileInputProps extends FileConstraints, Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue' | 'onError'>, VariantProps<typeof fileInputVariants> {
+    background?: FieldControlProps['background'];
+    variant?: FieldControlProps['variant'];
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onChange?: (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>>;
+
+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;
+    background?: FieldControlProps['background'];
+    value?: FileItem[];
+    defaultValue?: FileItem[];
+    onChange?: (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>>;
+
+/** 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;
+}>;
+
+/**
+ * 단일 날짜 선택기 · `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;
+    hourCycle?: 12 | 24;
+    /** 팝오버/드로어가 닫힐 때(편집 완료) 호출. 소비측이 시작↔종료 정합성 보정 등에 쓴다. */
+    onClose?: () => void;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    background?: FieldControlProps['background'];
+    variant?: FieldControlProps['variant'];
+    /** 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;
+    hourCycle?: 12 | 24;
+    /** 캘린더에 펼칠 개월 수. 기본 1(DatePicker 와 동일한 단일 뷰), 2 로 두 달을 좌우로 펼친다. */
+    numberOfMonths?: 1 | 2;
+    /**
+     * 트리거+팝오버 대신 **캘린더를 그 자리에 인라인**으로 렌더한다(중첩 오버레이 회피).
+     * 모바일 필터 시트처럼 이미 떠 있는 표면 안에서 날짜를 고를 때 사용 · 시트 위에 또
+     * 작은 팝오버를 띄우지 않는다(연구 권고). `className` 은 인라인 래퍼에 적용된다.
+     */
+    inline?: boolean;
+    /** true면 danger 상태 outline과 `aria-invalid`를 적용한다. */
+    invalid?: boolean;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    background?: FieldControlProps['background'];
+    variant?: FieldControlProps['variant'];
+    /** 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>>;
+
+interface TimeInputProps {
+    /** `'HH:mm'` 24시간 문자열 */
+    value?: string;
+    onChange?: (value: string) => void;
+    placeholder?: string;
+    /** 트리거 없이 시·분 선택을 직접 표시합니다. PC는 직접 입력, 모바일은 휠을 표시합니다. */
+    inline?: boolean;
+    /** 표시 형식. value/onChange는 항상 24시간 HH:mm입니다. */
+    hourCycle?: 12 | 24;
+    inlineLabel?: string;
+    inlineLabelPosition?: 'top' | 'left';
+    disabled?: boolean;
+    /** 선택 가능한 최소 시간 (`'HH:mm'`). */
+    minTime?: string;
+    /** 선택 가능한 최대 시간 (`'HH:mm'`). */
+    maxTime?: string;
+    /** 분 단위 step (1·5·10·15·30 등). 기본 1. */
+    step?: number;
+    /** 입력 또는 모바일 트리거 크기. */
+    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<HTMLInputElement | HTMLButtonElement | HTMLFieldSetElement>;
+    /** 기본은 부모 면 위 alpha surface, 명시적 경계가 필요하면 outline을 선택한다. */
+    background?: FieldControlProps['background'];
+    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>>;
+
+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?: FieldControlProps['variant'];
+    /** Place an opaque theme surface below the elevation layer. Defaults to false. */
+    background?: FieldControlProps['background'];
+    invalid?: boolean;
+    leftSlot?: ButtonIcon;
+    rightSlot?: ButtonIcon;
+    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> {
+    invalid?: FieldControlProps['invalid'];
+    background?: FieldControlProps['background'];
+    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({ 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;
+    background?: FieldControlProps['background'];
+    variant?: FieldControlProps['variant'];
+    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>;
+    background?: FieldControlProps['background'];
+    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>>;
+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;
+}
+/** 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>, 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, background, '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;
+}
+
+/** 폼 검증 오류에서 사용자에게 보여 줄 첫 번째 메시지를 찾는다. */
+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 { InputFrame as $, DateRangePicker as A, type ButtonIcon as B, type CheckboxFieldProps as C, type DateFieldProps as D, type DateRangePickerProps as E, type FileInputProps as F, type FieldControlVariant as G, type FieldControlVariants as H, type InputProps as I, FieldLayout as J, type FileDropzoneVariant as K, type LabelProps as L, type FileDropzoneVariants as M, type NumberFieldProps as N, type FileErrorReason as O, type PasswordFieldProps as P, FileInput as Q, type RadioGroupFieldProps as R, type SubmitGuardOptions as S, type TextFieldProps as T, type FileItem as U, FileUpload as V, FormLayoutField as W, type FormLayoutFieldProps as X, FormStack as Y, type FormStackProps as Z, Input as _, type ComboboxFieldProps as a, type InputSize as a0, type InvalidSubmitOptions as a1, Label as a2, NumberField as a3, NumberInput as a4, type NumberInputProps as a5, PasswordField as a6, PasswordInput as a7, type PasswordInputProps as a8, PhoneField as a9, type TextareaResize as aA, TimeField as aB, TimeInput as aC, type TimeInputElement as aD, type TimeInputProps as aE, checkboxVariants as aF, fileDropAreaVariants as aG, fieldControlVariants as aH, fileDropzoneVariants as aI, fileInputVariants as aJ, formatBytes as aK, getFileName as aL, getFileSize as aM, getItemKey as aN, inputVariants as aO, isImageFile as aP, isPdfFile as aQ, matchesAccept as aR, newLocalId as aS, radioItemVariants as aT, selectTriggerVariants as aU, textareaVariants as aV, useSubmitGuard as aW, PhoneInput as aa, type PhoneInputProps as ab, RadioGroup as ac, RadioGroupField as ad, RadioGroupItem as ae, type RadioGroupItemProps as af, type RadioGroupProps as ag, RadioGroupRoot as ah, Select as ai, SelectContent as aj, SelectField as ak, SelectGroup as al, SelectItem as am, SelectLabel as an, type SelectOption as ao, type SelectProps as ap, SelectScrollDownButton as aq, SelectScrollUpButton as ar, SelectSeparator as as, SelectTrigger as at, type SelectTriggerProps as au, SelectValue as av, TextField as aw, Textarea as ax, TextareaField as ay, type TextareaProps 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, Checkbox as n, CheckboxField as o, type CheckboxProps as p, Combobox as q, reportInvalidSubmit as r, ComboboxField as s, type ComboboxOption as t, type ComboboxProps as u, DateField as v, DatePicker as w, type DatePickerProps as x, type DateRange as y, DateRangeField as z };