@amineslab/ui 0.1.0-next.20260925131012 → 0.1.0

package/dist/label-Z97Pco2v.d.ts

@@ -0,0 +1,567 @@
+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;
+
+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> {
+    background?: FieldControlProps['background'];
+    variant?: FieldControlProps['variant'];
+    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;
+    background?: FieldControlProps['background'];
+    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>>;
+
+/** 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;
+    /** 팝오버/드로어가 닫힐 때(편집 완료) 호출. 소비측이 시작↔종료 정합성 보정 등에 쓴다. */
+    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;
+    /** 캘린더에 펼칠 개월 수. 기본 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>>;
+
+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>, 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 { type InvalidSubmitOptions as $, type FieldControlVariant as A, type ButtonIcon as B, type CheckboxFieldProps as C, type DateFieldProps as D, type FieldControlVariants as E, type FileInputProps as F, FieldLayout as G, type FileDropzoneVariant as H, type InputProps as I, type FileDropzoneVariants as J, type FileError as K, type LabelProps as L, type FileErrorReason as M, type NumberFieldProps as N, FileInput as O, type PasswordFieldProps as P, type FileItem as Q, type RadioGroupFieldProps as R, type SubmitGuardOptions as S, type TextFieldProps as T, FileUpload as U, FormLayoutField as V, type FormLayoutFieldProps as W, FormStack as X, Input as Y, InputFrame as Z, type InputSize as _, type ComboboxFieldProps as a, Label as a0, NumberField as a1, NumberInput as a2, type NumberInputProps as a3, PasswordField as a4, PasswordInput as a5, type PasswordInputProps as a6, PhoneField as a7, PhoneInput as a8, type PhoneInputProps as a9, TimeInput as aA, type TimeInputElement as aB, type TimeInputProps as aC, checkboxVariants as aD, fileDropAreaVariants as aE, fieldControlVariants as aF, fileDropzoneVariants as aG, fileInputVariants as aH, formatBytes as aI, getFileName as aJ, getFileSize as aK, getItemKey as aL, inputVariants as aM, isImageFile as aN, isPdfFile as aO, matchesAccept as aP, newLocalId as aQ, radioItemVariants as aR, selectTriggerVariants as aS, textareaVariants as aT, useSubmitGuard as aU, RadioGroup as aa, RadioGroupField as ab, RadioGroupItem as ac, type RadioGroupItemProps as ad, type RadioGroupProps as ae, RadioGroupRoot as af, Select as ag, SelectContent as ah, SelectField as ai, SelectGroup as aj, SelectItem as ak, SelectLabel as al, type SelectOption as am, type SelectProps as an, SelectScrollDownButton as ao, SelectScrollUpButton as ap, SelectSeparator as aq, SelectTrigger as ar, type SelectTriggerProps as as, SelectValue as at, TextField as au, Textarea as av, TextareaField as aw, type TextareaProps as ax, type TextareaResize as ay, TimeField 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 FieldControlProps as k, Checkbox as l, CheckboxField as m, type CheckboxProps as n, Combobox as o, ComboboxField as p, type ComboboxOption as q, reportInvalidSubmit as r, type ComboboxProps as s, DateField as t, DatePicker as u, type DatePickerProps as v, type DateRange as w, DateRangeField as x, DateRangePicker as y, type DateRangePickerProps as z };