@delightui/components 0.1.161 → 0.1.162-alpha.1

package/dist/esm/components/organisms/Form/Form.presenter.d.ts

@@ -0,0 +1,290 @@
+import { type FieldValues } from 'react-hook-form';
+import type { FormProps } from './Form.types';
+/**
+ * Presenter hook for Form component
+ * Handles RHF initialization and form state management
+ */
+declare const usePresenter: <TFormValues extends FieldValues = FieldValues>(props: FormProps<TFormValues>) => {
+    methods: import("react-hook-form").UseFormReturn<TFormValues, any, TFormValues>;
+    onFormSubmit: import("react").FormEventHandler<HTMLFormElement>;
+    autosave: boolean;
+    onSubmit: import("./Form.types").FormSubmitHandler<TFormValues> | undefined;
+    autosaveDelayMs: number;
+    variantProps: {
+        'component-variant': string;
+    };
+    className?: string | undefined;
+    children?: import("react").ReactNode | undefined;
+    role?: import("react").AriaRole | undefined;
+    onLoad?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onError?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    defaultChecked?: boolean | undefined;
+    defaultValue?: string | number | readonly string[] | undefined;
+    suppressContentEditableWarning?: boolean | undefined;
+    suppressHydrationWarning?: boolean | undefined;
+    accessKey?: string | undefined;
+    autoFocus?: boolean | undefined;
+    contentEditable?: (boolean | "true" | "false") | "inherit" | "plaintext-only" | undefined;
+    contextMenu?: string | undefined;
+    dir?: string | undefined;
+    draggable?: (boolean | "true" | "false") | undefined;
+    hidden?: boolean | undefined;
+    id?: string | undefined;
+    lang?: string | undefined;
+    nonce?: string | undefined;
+    slot?: string | undefined;
+    spellCheck?: (boolean | "true" | "false") | undefined;
+    style?: import("react").CSSProperties | undefined;
+    tabIndex?: number | undefined;
+    title?: string | undefined;
+    translate?: "yes" | "no" | undefined;
+    radioGroup?: string | undefined;
+    about?: string | undefined;
+    content?: string | undefined;
+    datatype?: string | undefined;
+    inlist?: any;
+    prefix?: string | undefined;
+    property?: string | undefined;
+    rel?: string | undefined;
+    resource?: string | undefined;
+    rev?: string | undefined;
+    typeof?: string | undefined;
+    vocab?: string | undefined;
+    autoCapitalize?: string | undefined;
+    autoCorrect?: string | undefined;
+    autoSave?: string | undefined;
+    color?: string | undefined;
+    itemProp?: string | undefined;
+    itemScope?: boolean | undefined;
+    itemType?: string | undefined;
+    itemID?: string | undefined;
+    itemRef?: string | undefined;
+    results?: number | undefined;
+    security?: string | undefined;
+    unselectable?: "on" | "off" | undefined;
+    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined;
+    is?: string | undefined;
+    "aria-activedescendant"?: string | undefined;
+    "aria-atomic"?: (boolean | "true" | "false") | undefined;
+    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined;
+    "aria-braillelabel"?: string | undefined;
+    "aria-brailleroledescription"?: string | undefined;
+    "aria-busy"?: (boolean | "true" | "false") | undefined;
+    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-colcount"?: number | undefined;
+    "aria-colindex"?: number | undefined;
+    "aria-colindextext"?: string | undefined;
+    "aria-colspan"?: number | undefined;
+    "aria-controls"?: string | undefined;
+    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
+    "aria-describedby"?: string | undefined;
+    "aria-description"?: string | undefined;
+    "aria-details"?: string | undefined;
+    "aria-disabled"?: (boolean | "true" | "false") | undefined;
+    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined;
+    "aria-errormessage"?: string | undefined;
+    "aria-expanded"?: (boolean | "true" | "false") | undefined;
+    "aria-flowto"?: string | undefined;
+    "aria-grabbed"?: (boolean | "true" | "false") | undefined;
+    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined;
+    "aria-hidden"?: (boolean | "true" | "false") | undefined;
+    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined;
+    "aria-keyshortcuts"?: string | undefined;
+    "aria-label"?: string | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-level"?: number | undefined;
+    "aria-live"?: "off" | "assertive" | "polite" | undefined;
+    "aria-modal"?: (boolean | "true" | "false") | undefined;
+    "aria-multiline"?: (boolean | "true" | "false") | undefined;
+    "aria-multiselectable"?: (boolean | "true" | "false") | undefined;
+    "aria-orientation"?: "horizontal" | "vertical" | undefined;
+    "aria-owns"?: string | undefined;
+    "aria-placeholder"?: string | undefined;
+    "aria-posinset"?: number | undefined;
+    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined;
+    "aria-readonly"?: (boolean | "true" | "false") | undefined;
+    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined;
+    "aria-required"?: (boolean | "true" | "false") | undefined;
+    "aria-roledescription"?: string | undefined;
+    "aria-rowcount"?: number | undefined;
+    "aria-rowindex"?: number | undefined;
+    "aria-rowindextext"?: string | undefined;
+    "aria-rowspan"?: number | undefined;
+    "aria-selected"?: (boolean | "true" | "false") | undefined;
+    "aria-setsize"?: number | undefined;
+    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined;
+    "aria-valuemax"?: number | undefined;
+    "aria-valuemin"?: number | undefined;
+    "aria-valuenow"?: number | undefined;
+    "aria-valuetext"?: string | undefined;
+    dangerouslySetInnerHTML?: {
+        __html: string | TrustedHTML;
+    } | undefined;
+    onCopy?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onCopyCapture?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onCut?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onCutCapture?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onPaste?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onPasteCapture?: import("react").ClipboardEventHandler<HTMLFormElement> | undefined;
+    onCompositionEnd?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onCompositionEndCapture?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onCompositionStart?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onCompositionStartCapture?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onCompositionUpdate?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onCompositionUpdateCapture?: import("react").CompositionEventHandler<HTMLFormElement> | undefined;
+    onFocus?: import("react").FocusEventHandler<HTMLFormElement> | undefined;
+    onFocusCapture?: import("react").FocusEventHandler<HTMLFormElement> | undefined;
+    onBlur?: import("react").FocusEventHandler<HTMLFormElement> | undefined;
+    onBlurCapture?: import("react").FocusEventHandler<HTMLFormElement> | undefined;
+    onChange?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onChangeCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onBeforeInput?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onBeforeInputCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onInput?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onInputCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onReset?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onResetCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onSubmitCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onInvalid?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onInvalidCapture?: import("react").FormEventHandler<HTMLFormElement> | undefined;
+    onLoadCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onErrorCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onKeyDown?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onKeyDownCapture?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onKeyPress?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onKeyPressCapture?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onKeyUp?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onKeyUpCapture?: import("react").KeyboardEventHandler<HTMLFormElement> | undefined;
+    onAbort?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onAbortCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onCanPlay?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onCanPlayCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onCanPlayThrough?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onCanPlayThroughCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onDurationChange?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onDurationChangeCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEmptied?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEmptiedCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEncrypted?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEncryptedCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEnded?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onEndedCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadedData?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadedDataCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadedMetadata?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadedMetadataCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadStart?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onLoadStartCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPause?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPauseCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPlay?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPlayCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPlaying?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onPlayingCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onProgress?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onProgressCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onRateChange?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onRateChangeCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onResize?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onResizeCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSeeked?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSeekedCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSeeking?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSeekingCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onStalled?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onStalledCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSuspend?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSuspendCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onTimeUpdate?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onTimeUpdateCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onVolumeChange?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onVolumeChangeCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onWaiting?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onWaitingCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onAuxClick?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onAuxClickCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onClick?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onClickCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onContextMenu?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onContextMenuCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onDoubleClick?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onDoubleClickCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onDrag?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragEnd?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragEndCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragEnter?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragEnterCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragExit?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragExitCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragLeave?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragLeaveCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragOver?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragOverCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragStart?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDragStartCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDrop?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onDropCapture?: import("react").DragEventHandler<HTMLFormElement> | undefined;
+    onMouseDown?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseDownCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseEnter?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseLeave?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseMove?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseMoveCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseOut?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseOutCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseOver?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseOverCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseUp?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onMouseUpCapture?: import("react").MouseEventHandler<HTMLFormElement> | undefined;
+    onSelect?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onSelectCapture?: import("react").ReactEventHandler<HTMLFormElement> | undefined;
+    onTouchCancel?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchCancelCapture?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchEnd?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchEndCapture?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchMove?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchMoveCapture?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchStart?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onTouchStartCapture?: import("react").TouchEventHandler<HTMLFormElement> | undefined;
+    onPointerDown?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerDownCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerMove?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerMoveCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerUp?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerUpCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerCancel?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerCancelCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerEnter?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerLeave?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerOver?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerOverCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerOut?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onPointerOutCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onGotPointerCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onGotPointerCaptureCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onLostPointerCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onLostPointerCaptureCapture?: import("react").PointerEventHandler<HTMLFormElement> | undefined;
+    onScroll?: import("react").UIEventHandler<HTMLFormElement> | undefined;
+    onScrollCapture?: import("react").UIEventHandler<HTMLFormElement> | undefined;
+    onWheel?: import("react").WheelEventHandler<HTMLFormElement> | undefined;
+    onWheelCapture?: import("react").WheelEventHandler<HTMLFormElement> | undefined;
+    onAnimationStart?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onAnimationStartCapture?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onAnimationEnd?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onAnimationEndCapture?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onAnimationIteration?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onAnimationIterationCapture?: import("react").AnimationEventHandler<HTMLFormElement> | undefined;
+    onTransitionEnd?: import("react").TransitionEventHandler<HTMLFormElement> | undefined;
+    onTransitionEndCapture?: import("react").TransitionEventHandler<HTMLFormElement> | undefined;
+    autoComplete?: string | undefined;
+    name?: string | undefined;
+    action?: string | undefined | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_FORM_ACTIONS[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_EXPERIMENTAL_FORM_ACTIONS];
+    target?: string | undefined;
+    acceptCharset?: string | undefined;
+    encType?: string | undefined;
+    method?: string | undefined;
+    noValidate?: boolean | undefined;
+    formRef?: React.Ref<HTMLFormElement>;
+};
+export default usePresenter;

package/dist/esm/components/organisms/Form/Form.types.d.ts

@@ -1,138 +1,31 @@
-import React from 'react';
-import type { FormHTMLAttributes, Ref } from 'react';
+import type { FormHTMLAttributes } from 'react';
+import type { FieldValues, UseFormProps } from 'react-hook-form';
+export type { FieldValue, FieldValidationFunction, AsyncFieldValidationFunction, } from '../../molecules/FormField/FormField.types';
 /**
- * Type representing the allowed values for form fields
+ * Form submission handler
  */
-export type FieldValue = string | number | Date | boolean | File | Array<string | number | Date | File>;
+export type FormSubmitHandler<TFormValues extends FieldValues = FieldValues> = (values: TFormValues) => void | Promise<void>;
 /**
- * Type representing the form values as a partial record of field names to field values
- * @example
- * ```typescript
- * const formState: FormState = {
- *   name: 'John Doe',
- *   age: 30,
- *   dob: new Date('1990-01-01')
- * };
- * ```
+ * Form component props
  */
-export type FormState<T extends FieldValue = FieldValue> = Partial<Record<string, T>>;
-/**
- * Type representing the form errors as a partial record of field names to error messages
- */
-export type FormErrors<T extends FormState = FormState> = Partial<Record<keyof T, string>>;
-/**
- * Type representing a validation function for a form field
- * It takes an error setter function and the field value (optional) and returns a boolean indicating if the value is valid
- * @example
- * ```typescript
- * const nameValidator: FieldValidationFunction = (setError, value) => {
- *   if (!value) {
- *     setError('Name is required');
- *     return false;
- *   }
- *   return true;
- * };
- * ```
- */
-export type FieldValidationFunction<T extends FieldValue = FieldValue> = (setError: (message: string) => void, value?: T) => boolean;
-/**
- * Type representing the required fields in a form
- * It's a partial record of field names to a boolean indicating if the field is required
- */
-export type RequiredFields<T extends FormState = FormState> = Partial<Record<keyof T, boolean>>;
-/**
- * Type representing the validation functions for each field in a form
- * It's a partial record of field names to validation functions (or undefined)
- * @example
- * ```typescript
- * const nameValidator: FieldValidationFunction = (setError, value) => {
- *   if (!value) {
- *     setError('Name is required');
- *     return false;
- *   }
- *   return true;
- * };
- * const fieldValidators: FieldValidators = {
- *   name: nameValidator,
- *   age: undefined,
- * };
- * ```
- */
-export type FieldValidators<T extends FormState = FormState> = Partial<Record<keyof T, FieldValidationFunction | undefined>>;
-/**
- * Type representing a function that handles form state changes
- * It takes the new form state and an error setter function and doesn't return anything
- * @example
- * ```typescript
- * const handleFormStateChange: FormStateChangeHandler = (state, setError) => {
- *   // Validate form state and set errors
- *   if (!state.name) {
- *     setError('name', 'Name is required');
- *   }
- * };
- * ```
- */
-export type FormStateChangeHandler<T extends FormState = FormState> = (state: T, setError: (field: keyof T, errorMessage: string) => void) => void;
-/**
- * Type representing a function that validates the entire form
- * It takes the form values and an error setter function and returns a boolean indicating if the form is valid
- * @example
- * ```typescript
- * const validateForm: FormValidator = (state, setError) => {
- *   let isValid = true;
- *   if (!state.name) {
- *     setError('name', 'Name is required');
- *     isValid = false;
- *   }
- *   if (!state.age || typeof state.age !== 'number') {
- *     setError('age', 'Age must be a number');
- *     isValid = false;
- *   }
- *   return isValid;
- * };
- * ```
- */
-export type FormValidator<T extends FormState = FormState> = (state: T, setError: (field: keyof T, errorMessage: string) => void) => boolean;
-/**
- * Type representing a function that handles form submission.
- * It takes updated form state and a function to set error messages for specific fields.
- *
- * @template T - The type of the form state, defaulting to `FormState`.
- *
- * @param {T} values - The updated form state values.
- * @param {(field: keyof T, errorMessage: string) => void} setError - A function to set error messages for specific fields.
- *
- * @example
- * ```typescript
- * const handleFormSubmit: FormSubmitHandler = (values, setError) => {
- *   // Submit form data
- *   console.log(values);
- * };
- * ```
- */
-export type FormSubmitHandler<T extends FormState = FormState> = (values: T, setError: (field: keyof T, errorMessage: string) => void) => void;
-export type FormProps = Omit<FormHTMLAttributes<HTMLFormElement>, 'onSubmit'> & {
-    formRef?: Ref<HTMLFormElement>;
-};
-export type FormContextValues<T extends FormState = FormState> = {
-    formRef?: Ref<HTMLFormElement>;
-    formState?: T;
-    updateFieldValue: (name: string, value: FieldValue) => void;
-    formErrors: FormErrors<T>;
-    updateFieldError: (name: keyof T, errorMessage: string) => void;
-    onFormSubmit: React.FormEventHandler<HTMLFormElement>;
-    updateFieldValidators: (name: keyof T, validate?: FieldValidationFunction) => void;
-    updateRequiredFields: (name: keyof T, required?: boolean) => void;
-    resetForm: () => void;
-};
-export type FormProviderProps<T extends FormState = FormState> = {
-    formRef?: Ref<HTMLFormElement>;
-    children?: React.ReactNode;
-    formState?: T;
-    onFormStateChange?: FormStateChangeHandler<T>;
-    formValidator?: FormValidator<T>;
-    onSubmit?: FormSubmitHandler<T>;
-    validateOnChange?: boolean;
+export type FormProps<TFormValues extends FieldValues = FieldValues> = Omit<FormHTMLAttributes<HTMLFormElement>, 'onSubmit' | 'ref'> & {
+    /** Initial form values (uncontrolled mode) */
+    defaultValues?: UseFormProps<TFormValues>['defaultValues'];
+    /** Form submission handler - receives typed form values */
+    onSubmit?: FormSubmitHandler<TFormValues>;
+    /** Enable autosave functionality */
     autosave?: boolean;
+    /** Autosave debounce delay in milliseconds */
     autosaveDelayMs?: number;
+    /** RHF validation mode */
+    mode?: UseFormProps<TFormValues>['mode'];
+    /** Additional RHF options */
+    formOptions?: Omit<UseFormProps<TFormValues>, 'defaultValues' | 'mode'>;
+    /** Ref to the form element */
+    formRef?: React.Ref<HTMLFormElement>;
 };
+/**
+ * @deprecated Use FormProps instead
+ * Legacy alias for backwards compatibility
+ */
+export type FormProviderProps<TFormValues extends FieldValues = FieldValues> = Omit<FormProps<TFormValues>, 'className' | 'style' | 'formRef'>;

package/dist/esm/components/organisms/Form/examples/DropzoneFormExample.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Placeholder for DropzoneFormExample
+ * This example needs to be updated to work with the new Form implementation
+ */
+declare const DropzoneFormExample: () => import("react/jsx-runtime").JSX.Element;
+export default DropzoneFormExample;

package/dist/esm/components/organisms/Form/examples/UpdatedFormExample.d.ts

@@ -0,0 +1,2 @@
+declare const UpdatedFormExample: () => import("react/jsx-runtime").JSX.Element;
+export default UpdatedFormExample;

package/dist/esm/components/organisms/Form/{UseFormExample.d.ts → examples/UseFormExample.d.ts}

@@ -1,5 +1,2 @@
-/**
- * Main example demonstrating the useForm hook
- */
 declare const UseFormExample: () => import("react/jsx-runtime").JSX.Element;
 export default UseFormExample;

package/dist/esm/components/organisms/Form/index.d.ts

@@ -1,5 +1,5 @@
-import type { FormProps, FormProviderProps, FormState } from './Form.types';
-declare const Form: <T extends FormState>(props: FormProviderProps<T> & FormProps) => import("react/jsx-runtime").JSX.Element;
+import Form from './Form';
 export default Form;
-export * from './Form.types';
-export { useForm, useFormTyped } from './useForm';
+export type { FormProps, FormSubmitHandler, FormProviderProps, } from './Form.types';
+export type { FieldValue } from './Form.types';
+export { useAutosave } from './useAutosave';

package/dist/esm/components/organisms/Form/useAutosave.d.ts

@@ -0,0 +1,10 @@
+import { type FieldValues } from 'react-hook-form';
+import type { FormSubmitHandler } from './Form.types';
+/**
+ * Hook to enable autosave functionality for forms
+ * Debounces changes and validates before submitting
+ *
+ * Note: Uses formState.isDirty to detect changes instead of watching all values
+ * for better performance
+ */
+export declare const useAutosave: <TFormValues extends FieldValues>(enabled: boolean, onSubmit: FormSubmitHandler<TFormValues> | undefined, delayMs?: number) => void;