@amineslab/ui 0.1.0-next.20260925131012

package/dist/forms/react-hook-form.d.cts

@@ -0,0 +1,140 @@
+import * as React from 'react';
+import * as react_hook_form from 'react-hook-form';
+import { FieldValues, FieldPath, ControllerProps, Control, RegisterOptions, FieldPathValue } from 'react-hook-form';
+import { L as LabelProps, C as CheckboxFieldProps$1, a as ComboboxFieldProps$1, D as DateFieldProps$1, b as DateRangeFieldProps$1, F as FileInputProps, c as FileUploadProps, N as NumberFieldProps$1, P as PasswordFieldProps$1, d as PhoneFieldProps$1, R as RadioGroupFieldProps$1, S as SubmitGuardOptions, e as SelectFieldProps$1, T as TextFieldProps$1, f as TextareaFieldProps$1, g as TimeFieldProps$1, h as SubmitGuardSchema, i as SubmitGuard } from '../use-submit-guard--899Lr9k.cjs';
+export { j as firstInvalidMessage, r as reportInvalidSubmit } from '../use-submit-guard--899Lr9k.cjs';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+import '@radix-ui/react-checkbox';
+import '@radix-ui/react-radio-group';
+import '@radix-ui/react-select';
+
+type RegisterId = (registrationId: string, id: string | null) => void;
+
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => React.JSX.Element;
+declare const useFormField: () => {
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: react_hook_form.FieldError | undefined;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+    id: string;
+    descriptionPresent: boolean;
+    messagePresent: boolean;
+    setDescriptionPresent: (present: boolean) => void;
+    setMessagePresent: (present: boolean) => void;
+    descriptionIds: string[];
+    messageIds: string[];
+    registerDescription: RegisterId;
+    registerMessage: RegisterId;
+};
+declare const FormItem: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const FormLabel: React.ForwardRefExoticComponent<Omit<LabelProps & React.RefAttributes<HTMLLabelElement>, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+declare const FormControl: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement> & {
+    children?: React.ReactNode;
+} & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+declare const FormDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const FormMessage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+
+/** Optional integration. Importing this path requires react-hook-form in the consumer. */
+declare function ControlledField<TFieldValues extends FieldValues>({ ...props }: ControllerProps<TFieldValues, FieldPath<TFieldValues>>): React.JSX.Element;
+type Name<T extends FieldValues> = FieldPath<T>;
+type Value<T extends FieldValues, N extends Name<T>> = FieldPathValue<T, N>;
+type Rules<T extends FieldValues, N extends Name<T>> = RegisterOptions<T, N>;
+interface RhfFieldBase<T extends FieldValues, N extends Name<T>> {
+    name: N;
+    control?: Control<T>;
+    rules?: Rules<T, N>;
+    shouldUnregister?: boolean;
+    defaultValue?: Value<T, N>;
+    disabled?: boolean;
+    onAfterChange?: (value: unknown) => void;
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    required?: boolean;
+    containerClassName?: string;
+}
+type RhfManagedFieldProps<T extends FieldValues, Props> = RhfFieldBase<T, Name<T>> & Omit<Props, 'value' | 'onValueChange' | 'onAfterChange' | 'label' | 'description' | 'required' | 'containerClassName'>;
+interface RhfSubmitGuardOptions<T extends FieldValues> extends SubmitGuardOptions {
+    control?: Control<T>;
+}
+/** FormProvider 또는 명시한 control의 값을 구독해 framework-independent guard에 연결합니다. */
+declare function useRHFSubmitGuard<T extends FieldValues>(schema: SubmitGuardSchema, { control: explicitControl, ...options }?: RhfSubmitGuardOptions<T>): SubmitGuard;
+
+type TextFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TextFieldProps$1>;
+declare function TextField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TextFieldProps<T>): React.JSX.Element;
+declare namespace TextField {
+    var displayName: string;
+}
+type PasswordFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, PasswordFieldProps$1>;
+declare function PasswordField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: PasswordFieldProps<T>): React.JSX.Element;
+declare namespace PasswordField {
+    var displayName: string;
+}
+type TextareaFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TextareaFieldProps$1>;
+declare function TextareaField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TextareaFieldProps<T>): React.JSX.Element;
+declare namespace TextareaField {
+    var displayName: string;
+}
+type NumberFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, NumberFieldProps$1>;
+declare function NumberField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: NumberFieldProps<T>): React.JSX.Element;
+declare namespace NumberField {
+    var displayName: string;
+}
+type PhoneFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, PhoneFieldProps$1>;
+declare function PhoneField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: PhoneFieldProps<T>): React.JSX.Element;
+declare namespace PhoneField {
+    var displayName: string;
+}
+type CheckboxFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, CheckboxFieldProps$1>;
+declare function CheckboxField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: CheckboxFieldProps<T>): React.JSX.Element;
+declare namespace CheckboxField {
+    var displayName: string;
+}
+type RadioGroupFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, RadioGroupFieldProps$1>;
+declare function RadioGroupField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: RadioGroupFieldProps<T>): React.JSX.Element;
+declare namespace RadioGroupField {
+    var displayName: string;
+}
+type SelectFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, SelectFieldProps$1>;
+declare function SelectField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: SelectFieldProps<T>): React.JSX.Element;
+declare namespace SelectField {
+    var displayName: string;
+}
+type ComboboxFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, ComboboxFieldProps$1>;
+declare function ComboboxField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: ComboboxFieldProps<T>): React.JSX.Element;
+declare namespace ComboboxField {
+    var displayName: string;
+}
+type DateFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, DateFieldProps$1>;
+declare function DateField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: DateFieldProps<T>): React.JSX.Element;
+declare namespace DateField {
+    var displayName: string;
+}
+type TimeFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TimeFieldProps$1>;
+declare function TimeField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TimeFieldProps<T>): React.JSX.Element;
+declare namespace TimeField {
+    var displayName: string;
+}
+type DateRangeFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, DateRangeFieldProps$1>;
+declare function DateRangeField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: DateRangeFieldProps<T>): React.JSX.Element;
+declare namespace DateRangeField {
+    var displayName: string;
+}
+type FileInputFieldProps<T extends FieldValues = FieldValues> = RhfFieldBase<T, Name<T>> & Omit<FileInputProps, 'value' | 'onChange' | 'label' | 'disabled'>;
+declare function FileInputField<T extends FieldValues>({ control: explicitControl, defaultValue, disabled, containerClassName, description, label, required, name, onAfterChange, rules, shouldUnregister, ...props }: FileInputFieldProps<T>): React.JSX.Element;
+declare namespace FileInputField {
+    var displayName: string;
+}
+type FileUploadFieldProps<T extends FieldValues = FieldValues> = RhfFieldBase<T, Name<T>> & Omit<FileUploadProps, 'value' | 'onChange' | 'label' | 'disabled'>;
+declare function FileUploadField<T extends FieldValues>({ control: explicitControl, defaultValue, disabled, containerClassName, description, label, required, name, onAfterChange, rules, shouldUnregister, ...props }: FileUploadFieldProps<T>): React.JSX.Element;
+declare namespace FileUploadField {
+    var displayName: string;
+}
+
+export { CheckboxField, type CheckboxFieldProps, ComboboxField, type ComboboxFieldProps, ControlledField, DateField, type DateFieldProps, DateRangeField, type DateRangeFieldProps, FileInputField, type FileInputFieldProps, FileUploadField, type FileUploadFieldProps, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, NumberField, type NumberFieldProps, PasswordField, type PasswordFieldProps, PhoneField, type PhoneFieldProps, RadioGroupField, type RadioGroupFieldProps, type RhfSubmitGuardOptions, SelectField, type SelectFieldProps, TextField, type TextFieldProps, TextareaField, type TextareaFieldProps, TimeField, type TimeFieldProps, useFormField, useRHFSubmitGuard };

package/dist/forms/react-hook-form.d.ts

@@ -0,0 +1,140 @@
+import * as React from 'react';
+import * as react_hook_form from 'react-hook-form';
+import { FieldValues, FieldPath, ControllerProps, Control, RegisterOptions, FieldPathValue } from 'react-hook-form';
+import { L as LabelProps, C as CheckboxFieldProps$1, a as ComboboxFieldProps$1, D as DateFieldProps$1, b as DateRangeFieldProps$1, F as FileInputProps, c as FileUploadProps, N as NumberFieldProps$1, P as PasswordFieldProps$1, d as PhoneFieldProps$1, R as RadioGroupFieldProps$1, S as SubmitGuardOptions, e as SelectFieldProps$1, T as TextFieldProps$1, f as TextareaFieldProps$1, g as TimeFieldProps$1, h as SubmitGuardSchema, i as SubmitGuard } from '../use-submit-guard--899Lr9k.js';
+export { j as firstInvalidMessage, r as reportInvalidSubmit } from '../use-submit-guard--899Lr9k.js';
+import 'class-variance-authority/types';
+import 'class-variance-authority';
+import '@radix-ui/react-checkbox';
+import '@radix-ui/react-radio-group';
+import '@radix-ui/react-select';
+
+type RegisterId = (registrationId: string, id: string | null) => void;
+
+declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getErrors, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
+declare const FormField: <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>) => React.JSX.Element;
+declare const useFormField: () => {
+    invalid: boolean;
+    isDirty: boolean;
+    isTouched: boolean;
+    isValidating: boolean;
+    error?: react_hook_form.FieldError | undefined;
+    name: string;
+    formItemId: string;
+    formDescriptionId: string;
+    formMessageId: string;
+    id: string;
+    descriptionPresent: boolean;
+    messagePresent: boolean;
+    setDescriptionPresent: (present: boolean) => void;
+    setMessagePresent: (present: boolean) => void;
+    descriptionIds: string[];
+    messageIds: string[];
+    registerDescription: RegisterId;
+    registerMessage: RegisterId;
+};
+declare const FormItem: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+declare const FormLabel: React.ForwardRefExoticComponent<Omit<LabelProps & React.RefAttributes<HTMLLabelElement>, "ref"> & React.RefAttributes<HTMLLabelElement>>;
+declare const FormControl: React.ForwardRefExoticComponent<Omit<React.HTMLAttributes<HTMLElement> & {
+    children?: React.ReactNode;
+} & React.RefAttributes<HTMLElement>, "ref"> & React.RefAttributes<HTMLElement>>;
+declare const FormDescription: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+declare const FormMessage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>>;
+
+/** Optional integration. Importing this path requires react-hook-form in the consumer. */
+declare function ControlledField<TFieldValues extends FieldValues>({ ...props }: ControllerProps<TFieldValues, FieldPath<TFieldValues>>): React.JSX.Element;
+type Name<T extends FieldValues> = FieldPath<T>;
+type Value<T extends FieldValues, N extends Name<T>> = FieldPathValue<T, N>;
+type Rules<T extends FieldValues, N extends Name<T>> = RegisterOptions<T, N>;
+interface RhfFieldBase<T extends FieldValues, N extends Name<T>> {
+    name: N;
+    control?: Control<T>;
+    rules?: Rules<T, N>;
+    shouldUnregister?: boolean;
+    defaultValue?: Value<T, N>;
+    disabled?: boolean;
+    onAfterChange?: (value: unknown) => void;
+    label?: React.ReactNode;
+    description?: React.ReactNode;
+    required?: boolean;
+    containerClassName?: string;
+}
+type RhfManagedFieldProps<T extends FieldValues, Props> = RhfFieldBase<T, Name<T>> & Omit<Props, 'value' | 'onValueChange' | 'onAfterChange' | 'label' | 'description' | 'required' | 'containerClassName'>;
+interface RhfSubmitGuardOptions<T extends FieldValues> extends SubmitGuardOptions {
+    control?: Control<T>;
+}
+/** FormProvider 또는 명시한 control의 값을 구독해 framework-independent guard에 연결합니다. */
+declare function useRHFSubmitGuard<T extends FieldValues>(schema: SubmitGuardSchema, { control: explicitControl, ...options }?: RhfSubmitGuardOptions<T>): SubmitGuard;
+
+type TextFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TextFieldProps$1>;
+declare function TextField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TextFieldProps<T>): React.JSX.Element;
+declare namespace TextField {
+    var displayName: string;
+}
+type PasswordFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, PasswordFieldProps$1>;
+declare function PasswordField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: PasswordFieldProps<T>): React.JSX.Element;
+declare namespace PasswordField {
+    var displayName: string;
+}
+type TextareaFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TextareaFieldProps$1>;
+declare function TextareaField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TextareaFieldProps<T>): React.JSX.Element;
+declare namespace TextareaField {
+    var displayName: string;
+}
+type NumberFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, NumberFieldProps$1>;
+declare function NumberField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: NumberFieldProps<T>): React.JSX.Element;
+declare namespace NumberField {
+    var displayName: string;
+}
+type PhoneFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, PhoneFieldProps$1>;
+declare function PhoneField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: PhoneFieldProps<T>): React.JSX.Element;
+declare namespace PhoneField {
+    var displayName: string;
+}
+type CheckboxFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, CheckboxFieldProps$1>;
+declare function CheckboxField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: CheckboxFieldProps<T>): React.JSX.Element;
+declare namespace CheckboxField {
+    var displayName: string;
+}
+type RadioGroupFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, RadioGroupFieldProps$1>;
+declare function RadioGroupField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: RadioGroupFieldProps<T>): React.JSX.Element;
+declare namespace RadioGroupField {
+    var displayName: string;
+}
+type SelectFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, SelectFieldProps$1>;
+declare function SelectField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: SelectFieldProps<T>): React.JSX.Element;
+declare namespace SelectField {
+    var displayName: string;
+}
+type ComboboxFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, ComboboxFieldProps$1>;
+declare function ComboboxField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: ComboboxFieldProps<T>): React.JSX.Element;
+declare namespace ComboboxField {
+    var displayName: string;
+}
+type DateFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, DateFieldProps$1>;
+declare function DateField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: DateFieldProps<T>): React.JSX.Element;
+declare namespace DateField {
+    var displayName: string;
+}
+type TimeFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, TimeFieldProps$1>;
+declare function TimeField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: TimeFieldProps<T>): React.JSX.Element;
+declare namespace TimeField {
+    var displayName: string;
+}
+type DateRangeFieldProps<T extends FieldValues = FieldValues> = RhfManagedFieldProps<T, DateRangeFieldProps$1>;
+declare function DateRangeField<T extends FieldValues>({ control: explicitControl, defaultValue, description, disabled, label, name, onAfterChange, required, rules, shouldUnregister, containerClassName, ...props }: DateRangeFieldProps<T>): React.JSX.Element;
+declare namespace DateRangeField {
+    var displayName: string;
+}
+type FileInputFieldProps<T extends FieldValues = FieldValues> = RhfFieldBase<T, Name<T>> & Omit<FileInputProps, 'value' | 'onChange' | 'label' | 'disabled'>;
+declare function FileInputField<T extends FieldValues>({ control: explicitControl, defaultValue, disabled, containerClassName, description, label, required, name, onAfterChange, rules, shouldUnregister, ...props }: FileInputFieldProps<T>): React.JSX.Element;
+declare namespace FileInputField {
+    var displayName: string;
+}
+type FileUploadFieldProps<T extends FieldValues = FieldValues> = RhfFieldBase<T, Name<T>> & Omit<FileUploadProps, 'value' | 'onChange' | 'label' | 'disabled'>;
+declare function FileUploadField<T extends FieldValues>({ control: explicitControl, defaultValue, disabled, containerClassName, description, label, required, name, onAfterChange, rules, shouldUnregister, ...props }: FileUploadFieldProps<T>): React.JSX.Element;
+declare namespace FileUploadField {
+    var displayName: string;
+}
+
+export { CheckboxField, type CheckboxFieldProps, ComboboxField, type ComboboxFieldProps, ControlledField, DateField, type DateFieldProps, DateRangeField, type DateRangeFieldProps, FileInputField, type FileInputFieldProps, FileUploadField, type FileUploadFieldProps, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, NumberField, type NumberFieldProps, PasswordField, type PasswordFieldProps, PhoneField, type PhoneFieldProps, RadioGroupField, type RadioGroupFieldProps, type RhfSubmitGuardOptions, SelectField, type SelectFieldProps, TextField, type TextFieldProps, TextareaField, type TextareaFieldProps, TimeField, type TimeFieldProps, useFormField, useRHFSubmitGuard };