@saas-ui/forms 3.0.0-alpha.9 → 3.0.0-next.0

package/CHANGELOG.md

@@ -1,98 +1,114 @@
 # @saas-ui/forms
 
-## 3.0.0-alpha.9
+## 3.0.0-next.0
 
-### Patch Changes
-
-- Updated dependencies [f0f5ab0]
-  - @saas-ui/react@3.0.0-alpha.9
-
-## 3.0.0-alpha.8
-
-### Patch Changes
-
-- Updated dependencies [64e680e]
-- Updated dependencies [64e680e]
-  - @saas-ui/react@3.0.0-alpha.8
-
-## 3.0.0-alpha.7
-
-### Patch Changes
-
-- Updated dependencies [8e760c5]
-  - @saas-ui/react@3.0.0-alpha.7
+### Major Changes
 
-## 3.0.0-alpha.6
+- 78e70fb: New useForm hook that returns typed form components
+- 550e5a6: Upgrade to Chakra v3
+- b51aff9: BREAKING: getBaseField should now return props and Component
 
 ### Minor Changes
 
 - 95c8652: Update to Chakra UI 3.2.1
+- 6459de4: Removed src exports and files from packages
 
 ### Patch Changes
 
-- Updated dependencies [95c8652]
-  - @saas-ui/react@3.0.0-alpha.6
-  - @saas-ui/core@3.0.0-alpha.4
-
-## 3.0.0-alpha.5
-
-### Patch Changes
-
+- 38082d4: Improved horizontal field styles
+- b51aff9: Improved prop handling of base field
+- cee2e9c: Removed chakra ui dependency of core package
+- 56b0623: Update with upstream changes
+- Updated dependencies [ba3b566]
 - Updated dependencies [e9fec88]
+- Updated dependencies [2285040]
+- Updated dependencies [64e680e]
+- Updated dependencies [53716c5]
+- Updated dependencies [5115e8f]
+- Updated dependencies [212a7e6]
+- Updated dependencies [38082d4]
+- Updated dependencies [8d8ffaa]
+- Updated dependencies [c680574]
+- Updated dependencies [c680574]
 - Updated dependencies [f62c3d6]
-  - @saas-ui/react@3.0.0-alpha.5
-
-## 3.0.0-alpha.4
-
-### Patch Changes
-
+- Updated dependencies [942e9a0]
+- Updated dependencies [f85d493]
+- Updated dependencies [8d8ffaa]
+- Updated dependencies [a2ef175]
+- Updated dependencies [eb02362]
+- Updated dependencies [53716c5]
+- Updated dependencies [205580d]
 - Updated dependencies [7808a76]
-  - @saas-ui/react@3.0.0-alpha.4
-
-## 3.0.0-alpha.3
-
-### Patch Changes
-
-- cee2e9c: Removed chakra ui dependency of core package
+- Updated dependencies [e7fe684]
+- Updated dependencies [f85d493]
+- Updated dependencies [c680574]
+- Updated dependencies [c680574]
+- Updated dependencies [b51aff9]
+- Updated dependencies [212a7e6]
+- Updated dependencies [550e5a6]
+- Updated dependencies [ce8c247]
+- Updated dependencies [19309d4]
+- Updated dependencies [ce8c247]
+- Updated dependencies [ce8c247]
+- Updated dependencies [c680574]
+- Updated dependencies [ba3b566]
+- Updated dependencies [95c8652]
+- Updated dependencies [6a8bf46]
+- Updated dependencies [eb02362]
+- Updated dependencies [ac2d80d]
+- Updated dependencies [0067207]
+- Updated dependencies [b51aff9]
 - Updated dependencies [cee2e9c]
-  - @saas-ui/core@3.0.0-alpha.3
-  - @saas-ui/react@3.0.0-alpha.3
-
-## 3.0.0-alpha.2
-
-### Minor Changes
-
-- 6459de4: Removed src exports and files from packages
-
-### Patch Changes
-
+- Updated dependencies [205580d]
+- Updated dependencies [ba3b566]
+- Updated dependencies [8e760c5]
+- Updated dependencies [56b0623]
+- Updated dependencies [6a8bf46]
+- Updated dependencies [15e093e]
+- Updated dependencies [8d8ffaa]
+- Updated dependencies [c680574]
+- Updated dependencies [8ac704a]
+- Updated dependencies [6f9f04d]
+- Updated dependencies [eb02362]
 - Updated dependencies [6459de4]
-  - @saas-ui/react@3.0.0-alpha.2
-  - @saas-ui/core@3.0.0-alpha.2
-
-## 3.0.0-alpha.1
+- Updated dependencies [56b0623]
+- Updated dependencies [c51e12c]
+- Updated dependencies [0067207]
+- Updated dependencies [0f49a18]
+- Updated dependencies [8d8ffaa]
+- Updated dependencies [65fac53]
+- Updated dependencies [61ce1b5]
+- Updated dependencies [3a73bc8]
+- Updated dependencies [9d47676]
+- Updated dependencies [64e680e]
+- Updated dependencies [2285040]
+- Updated dependencies [ba3b566]
+- Updated dependencies [8d8ffaa]
+- Updated dependencies [f0f5ab0]
+- Updated dependencies [19309d4]
+- Updated dependencies [727b902]
+  - @saas-ui/react@3.0.0-next.0
+  - @saas-ui/core@3.0.0-next.0
 
-### Major Changes
+## 2.11.0
 
-- 550e5a6: Upgrade to Chakra v3
+### Minor Changes
 
-### Patch Changes
+- 091fd38: Exported additional types from `index.ts` to make them accessible for external use, improving type coverage and usability.
 
-- Updated dependencies [550e5a6]
-  - @saas-ui/react@3.0.0-alpha.1
-  - @saas-ui/core@3.0.0-alpha.1
+## 2.10.0
 
-## 3.0.0-alpha.0
+### Minor Changes
 
-### Major Changes
+- eb53116: Added support for ZodEffects schema to Form
 
-- v3 alpha release
+## 2.9.1
 
 ### Patch Changes
 
-- Updated dependencies
-  - @saas-ui/react@3.0.0-alpha.0
-  - @saas-ui/core@3.0.0-alpha.0
+- 862937a: Bump chakra version
+- Updated dependencies [862937a]
+  - @saas-ui/core@2.8.1
 
 ## 2.9.0
 

package/dist/index.d.mts

@@ -1,10 +1,10 @@
 import * as React$1 from 'react';
 import React__default, { ForwardRefRenderFunction, PropsWithoutRef } from 'react';
-import { RecipeProps, HTMLChakraProps, SimpleGridProps, InputProps, TextareaProps, SystemStyleObject, Field as Field$1, ButtonProps as ButtonProps$1 } from '@chakra-ui/react';
+import { SimpleGridProps, RecipeProps, InputProps, SystemStyleObject, TextareaProps, Field as Field$1, HTMLChakraProps, ButtonProps as ButtonProps$1 } from '@chakra-ui/react';
 import { MaybeRenderProp } from '@saas-ui/core/utils';
 import * as react_hook_form from 'react-hook-form';
-import { FieldValues, FieldPath, UseFormReturn as UseFormReturn$1, UseFieldArrayReturn, UseFormProps, WatchObserver, SubmitHandler, SubmitErrorHandler, ResolverOptions, ResolverResult, RegisterOptions, FormProviderProps as FormProviderProps$1 } from 'react-hook-form';
-export { ArrayPath, BatchFieldArrayUpdate, BrowserNativeObject, ChangeHandler, Control, Controller, ControllerFieldState, ControllerProps, ControllerRenderProps, CriteriaMode, CustomElement, DeepMap, DeepPartial, DeepPartialSkipArrayKey, DeepRequired, DefaultValues, DelayCallback, EmptyObject, ErrorOption, EventType, ExtractObjects, FieldArray, FieldArrayMethodProps, FieldArrayPath, FieldArrayPathValue, FieldArrayWithId, Field as FieldDef, FieldElement, FieldError, FieldErrors, FieldErrorsImpl, FieldName, FieldNamesMarkedBoolean, FieldPath, FieldPathByValue, FieldPathValue, FieldPathValues, FieldRefs, FieldValue, FieldValues, FormProviderProps, FormState, FormStateProxy, FormStateSubjectRef, GetIsDirty, InternalFieldErrors, InternalFieldName, InternalNameSet, IsAny, IsFlatObject, KeepStateOptions, LiteralUnion, Message, Mode, MultipleFieldErrors, Names, NativeFieldValue, NestedValue, NonUndefined, Noop, Primitive, ReadFormState, Ref, RefCallBack, RegisterOptions, Resolver, ResolverError, ResolverOptions, ResolverResult, ResolverSuccess, SetFieldValue, SetValueConfig, Subjects, SubmitErrorHandler, SubmitHandler, TriggerConfig, UnpackNestedValue, UseControllerProps, UseControllerReturn, UseFieldArrayProps, UseFieldArrayReturn, UseFormClearErrors, UseFormGetValues, UseFormHandleSubmit, UseFormProps, UseFormRegister, UseFormRegisterReturn, UseFormReset, UseFormResetField, UseFormReturn, UseFormSetError, UseFormSetFocus, UseFormSetValue, UseFormStateProps, UseFormStateReturn, UseFormTrigger, UseFormUnregister, UseFormWatch, UseWatchProps, Validate, ValidateResult, ValidationMode, ValidationRule, ValidationValue, ValidationValueMessage, WatchInternal, WatchObserver, appendErrors, useController, useFieldArray, useForm, useFormState, useWatch } from 'react-hook-form';
+import { FieldValues, FieldPath, UseFormReturn as UseFormReturn$2, UseFieldArrayReturn, UseFormProps as UseFormProps$1, WatchObserver, SubmitHandler, SubmitErrorHandler, ResolverOptions, ResolverResult, RegisterOptions, useForm as useForm$1, DefaultValues, FormProviderProps as FormProviderProps$1 } from 'react-hook-form';
+export { ArrayPath, BatchFieldArrayUpdate, BrowserNativeObject, ChangeHandler, Control, Controller, ControllerFieldState, ControllerProps, ControllerRenderProps, CriteriaMode, CustomElement, DeepMap, DeepPartial, DeepPartialSkipArrayKey, DeepRequired, DefaultValues, DelayCallback, EmptyObject, ErrorOption, EventType, ExtractObjects, FieldArray, FieldArrayMethodProps, FieldArrayPath, FieldArrayPathValue, FieldArrayWithId, Field as FieldDef, FieldElement, FieldError, FieldErrors, FieldErrorsImpl, FieldName, FieldNamesMarkedBoolean, FieldPath, FieldPathByValue, FieldPathValue, FieldPathValues, FieldRefs, FieldValue, FieldValues, FormProviderProps, FormState, FormStateProxy, FormStateSubjectRef, GetIsDirty, InternalFieldErrors, InternalFieldName, InternalNameSet, IsAny, IsFlatObject, KeepStateOptions, LiteralUnion, Message, Mode, MultipleFieldErrors, Names, NativeFieldValue, NestedValue, NonUndefined, Noop, Primitive, ReadFormState, Ref, RefCallBack, RegisterOptions, Resolver, ResolverError, ResolverOptions, ResolverResult, ResolverSuccess, SetFieldValue, SetValueConfig, Subjects, SubmitErrorHandler, SubmitHandler, TriggerConfig, UnpackNestedValue, UseControllerProps, UseControllerReturn, UseFieldArrayProps, UseFieldArrayReturn, UseFormClearErrors, UseFormGetValues, UseFormHandleSubmit, UseFormRegister, UseFormRegisterReturn, UseFormReset, UseFormResetField, UseFormSetError, UseFormSetFocus, UseFormSetValue, UseFormStateProps, UseFormStateReturn, UseFormTrigger, UseFormUnregister, UseFormWatch, UseWatchProps, Validate, ValidateResult, ValidationMode, ValidationRule, ValidationValue, ValidationValueMessage, WatchInternal, WatchObserver, appendErrors, useController, useFieldArray, useFormState, useWatch } from 'react-hook-form';
 import { CheckboxProps } from '@saas-ui/react/checkbox';
 import { NumberInputProps } from '@saas-ui/react/number-input';
 import { PasswordInputProps } from '@saas-ui/react/password-input';
@@ -13,19 +13,21 @@ import { RadioGroupProps } from '@saas-ui/react/radio';
 import { Select } from '@saas-ui/react/select';
 import { SwitchProps } from '@saas-ui/react/switch';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UseStepperReturn } from '@saas-ui/core';
 import { ButtonProps } from '@saas-ui/react/button';
+import { z } from 'zod';
 
 interface FormLayoutOptions {
     columns?: SimpleGridProps['columns'];
     gap?: SimpleGridProps['gap'];
 }
-interface FormLayoutProps extends RecipeProps<'formLayout'>, FormLayoutOptions, Omit<HTMLChakraProps<'div'>, 'columns'> {
+interface FormLayoutProps extends RecipeProps<'suiFormLayout'>, SimpleGridProps {
 }
 /**
  * Create consistent field spacing and positioning.
  *
  * Renders form items in a `SimpleGrid`
- * @see https://chakra-ui.com/docs/layout/simple-grid
+ * @see https://chakra-ui.com/docs/components/simple-grid
  *
  * @see https://saas-ui.dev/docs/components/forms/form
  */
@@ -46,7 +48,10 @@ declare const TextareaField: React__default.FC<Omit<BaseFieldProps<react_hook_fo
 interface SwitchFieldProps extends SwitchProps {
     type: 'switch';
 }
-interface SelectFieldProps extends Omit<Select.RootProps<FieldOption>, 'collection'> {
+interface SelectFieldProps<Multiple extends boolean = boolean> extends Omit<Select.RootProps<FieldOption>, 'collection' | 'value' | 'multiple' | 'onChange' | 'onValueChange'> {
+    multiple?: Multiple;
+    value?: Multiple extends true ? Array<string> : string;
+    onChange?: (value: Multiple extends true ? Array<string> : string) => void;
     options: FieldOptions;
     placeholder?: string;
     triggerProps?: Select.TriggerProps;
@@ -80,7 +85,7 @@ declare const defaultFieldTypes: {
     checkbox: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof CheckboxFieldProps> & CheckboxFieldProps>;
     radio: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof RadioFieldProps> & RadioFieldProps>;
     password: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof PasswordInputProps> & PasswordInputProps>;
-    select: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof SelectFieldProps> & SelectFieldProps>;
+    select: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof SelectFieldProps<boolean>> & SelectFieldProps<boolean>>;
     switch: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof SwitchFieldProps> & SwitchFieldProps>;
     textarea: React__default.FC<Omit<BaseFieldProps<react_hook_form.FieldValues, string>, keyof TextareaFieldProps> & TextareaFieldProps>;
 };
@@ -92,8 +97,8 @@ interface DisplayIfProps<TFieldValues extends FieldValues = FieldValues, TName e
     defaultValue?: unknown;
     isDisabled?: boolean;
     isExact?: boolean;
-    condition?: (value: unknown, context: UseFormReturn$1<TFieldValues>) => boolean;
-    onToggle?: (conditionMatched: boolean, context: UseFormReturn$1<TFieldValues>) => void;
+    condition?: (value: unknown, context: UseFormReturn$2<TFieldValues>) => boolean;
+    onToggle?: (conditionMatched: boolean, context: UseFormReturn$2<TFieldValues>) => void;
 }
 /**
  * Conditionally render parts of a form.
@@ -101,7 +106,7 @@ interface DisplayIfProps<TFieldValues extends FieldValues = FieldValues, TName e
  * @see Docs https://saas-ui.dev/docs/components/forms/form
  */
 declare const DisplayIf: {
-    <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ children, name, defaultValue, isDisabled, isExact, condition, onToggle, }: DisplayIfProps<TFieldValues, TName>): React$1.ReactElement<any, string | React$1.JSXElementConstructor<any>> | null;
+    <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ children, name, defaultValue, isDisabled, isExact, condition, onToggle, }: DisplayIfProps<TFieldValues, TName>): React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | null;
     displayName: string;
 };
 
@@ -212,7 +217,7 @@ declare const useArrayFieldAddButton: () => {
     isDisabled: boolean;
 };
 
-interface FormRenderContext<TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TFieldTypes = FieldProps<TFieldValues>> extends UseFormReturn$1<TFieldValues, TContext> {
+interface FormRenderContext<TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TFieldTypes = FieldProps<TFieldValues>> extends UseFormReturn$2<TFieldValues, TContext> {
     Field: React__default.FC<TFieldTypes & React__default.RefAttributes<FocusableElement>>;
     DisplayIf: React__default.FC<DisplayIfProps<TFieldValues>>;
     ArrayField: React__default.FC<ArrayFieldProps<TFieldValues> & React__default.RefAttributes<UseArrayFieldReturn>>;
@@ -238,7 +243,7 @@ interface FormOptions<TSchema = unknown, TFieldValues extends FieldValues = Fiel
     /**
      * The Hook Form state ref.
      */
-    formRef?: React__default.Ref<UseFormReturn$1<TFieldValues, TContext>>;
+    formRef?: React__default.Ref<UseFormReturn$2<TFieldValues, TContext>>;
     /**
      * The form children, can be a render prop or a ReactNode.
      */
@@ -252,7 +257,7 @@ interface FormOptions<TSchema = unknown, TFieldValues extends FieldValues = Fiel
      */
     fields?: DefaultFieldOverrides;
 }
-interface FormProps<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TExtraFieldProps extends object = object, TFieldTypes = FieldProps<TFieldValues, TExtraFieldProps>> extends UseFormProps<TFieldValues, TContext>, Omit<HTMLChakraProps<'form'>, 'children' | 'onChange' | 'onSubmit' | 'onError'>, FormOptions<TSchema, TFieldValues, TContext, TExtraFieldProps, TFieldTypes> {
+interface FormProps$1<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TExtraFieldProps extends object = object, TFieldTypes = FieldProps<TFieldValues, TExtraFieldProps>> extends UseFormProps$1<TFieldValues, TContext>, Omit<HTMLChakraProps<'form'>, 'children' | 'onChange' | 'onSubmit' | 'onError'>, FormOptions<TSchema, TFieldValues, TContext, TExtraFieldProps, TFieldTypes> {
 }
 /**
  * The wrapper component provides context, state, and focus management.
@@ -260,12 +265,63 @@ interface FormProps<TSchema = unknown, TFieldValues extends FieldValues = FieldV
  * @see Docs https://saas-ui.dev/docs/components/forms/form
  */
 declare const Form$1: FormComponent;
-type FormComponent = (<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TExtraFieldProps extends object = object, TFieldTypes = FieldProps<TFieldValues>>(props: FormProps<TSchema, TFieldValues, TContext, TExtraFieldProps, TFieldTypes> & {
+type FormComponent = (<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TExtraFieldProps extends object = object, TFieldTypes = FieldProps<TFieldValues>>(props: FormProps$1<TSchema, TFieldValues, TContext, TExtraFieldProps, TFieldTypes> & {
     ref?: React__default.ForwardedRef<HTMLFormElement>;
 }) => React__default.ReactElement) & {
     displayName?: string;
 };
-type GetResolver = <TFieldValues extends FieldValues, TContext extends object>(schema: unknown) => (values: TFieldValues, context: TContext | undefined, options: ResolverOptions<TFieldValues>) => Promise<ResolverResult<TFieldValues>>;
+type GetResolver = <TFieldValues extends FieldValues, TContext extends object>(schema: unknown) => (values: TFieldValues, context: TContext | undefined, options: ResolverOptions<TFieldValues>) => ResolverResult<TFieldValues> | Promise<ResolverResult<TFieldValues>>;
+
+type FormStepSubmitHandler<TFieldValues extends FieldValues = FieldValues> = (data: TFieldValues, stepper: UseStepperReturn) => Promise<void>;
+type StepName<T extends {
+    [k: number]: {
+        readonly name: string;
+    };
+}> = T[number]['name'];
+interface StepFormRenderContext<TSteps extends StepsOptions<any> = StepsOptions<any>, TFieldValues extends FieldValues = FieldValues, TContext extends object = object, TFieldTypes = FieldProps<TFieldValues>> extends UseStepFormReturn<TFieldValues> {
+    Field: React$1.FC<TFieldTypes & React$1.RefAttributes<FocusableElement>>;
+    FormStep: React$1.FC<FormStepProps<StepName<TSteps>>>;
+    DisplayIf: React$1.FC<DisplayIfProps<TFieldValues>>;
+    ArrayField: React$1.FC<ArrayFieldProps<TFieldValues> & React$1.RefAttributes<UseArrayFieldReturn>>;
+    ObjectField: React$1.FC<ObjectFieldProps<TFieldValues>>;
+}
+interface UseStepFormReturn<TFieldValues extends FieldValues = FieldValues> extends UseStepperReturn {
+    getFormProps(): {
+        onSubmit: SubmitHandler<TFieldValues>;
+        schema?: any;
+        resolver?: any;
+    };
+    updateStep(step: any): void;
+    steps: Record<string, any>;
+}
+
+type StepsOptions<TSchema, TName extends string = string> = {
+    /**
+     * The step name
+     */
+    name: TName;
+    /**
+     * Schema
+     */
+    schema?: TSchema;
+}[];
+interface FormStepOptions<TName extends string = string> {
+    /**
+     * The step name
+     */
+    name: TName;
+    /**
+     * Schema
+     */
+    schema?: any;
+    /**
+     * Hook Form Resolver
+     */
+    resolver?: any;
+}
+interface FormStepProps<TName extends string = string> extends FormStepOptions<TName>, Omit<HTMLChakraProps<'div'>, 'onSubmit'> {
+    onSubmit?: FormStepSubmitHandler;
+}
 
 interface SubmitButtonProps extends ButtonProps {
     /**
@@ -336,8 +392,14 @@ interface BaseFieldProps<TFieldValues extends FieldValues = FieldValues, TName e
     children?: React.ReactNode;
 }
 type GetBaseField<TProps extends object = object> = () => {
-    extraProps: string[];
-    BaseField: React.FC<Omit<BaseFieldProps, 'name'> & {
+    /**
+     * Extra props to pass to the component
+     */
+    props: Array<Extract<keyof TProps, string>>;
+    /**
+     * The component to render
+     */
+    Component: React.FC<Omit<BaseFieldProps, 'name'> & {
         name: string;
         children: React.ReactNode;
     } & TProps>;
@@ -368,12 +430,13 @@ type FieldOverrides<FieldDefs, TFieldValues extends FieldValues = FieldValues, T
         type?: 'array';
     } & Omit<ArrayFieldProps<TFieldValues>, 'name' | 'children'>);
 };
-type WithFields<TFormProps extends FormProps<any, any, any, any, any>, FieldDefs, ExtraOverrides = object> = TFormProps extends FormProps<infer _TSchema, infer TFieldValues, infer TContext, infer TExtraFieldProps> ? Omit<TFormProps, 'children' | 'fields'> & {
+type WithFields<TFormProps extends FormProps$1<any, any, any, any, any>, FieldDefs, ExtraOverrides = object> = TFormProps extends FormProps$1<infer _TSchema, infer TFieldValues, infer TContext, infer TExtraFieldProps> ? Omit<TFormProps, 'children' | 'fields'> & {
     children?: FormChildren<FieldDefs, TFieldValues, TContext, TExtraFieldProps>;
     fields?: FieldOverrides<FieldDefs, TFieldValues> & {
         submit?: SubmitButtonProps;
     } & ExtraOverrides;
 } : never;
+type StepFormChildren<FieldDefs, TSteps extends StepsOptions<any> = StepsOptions<any>, TFieldValues extends FieldValues = FieldValues, TContext extends object = object> = MaybeRenderProp<StepFormRenderContext<TSteps, TFieldValues, TContext, MergeFieldProps<FieldDefs extends never ? DefaultFields : ShallowMerge<DefaultFields, FieldDefs>, TFieldValues>>>;
 
 interface ArrayFieldButtonProps extends ButtonProps$1 {
 }
@@ -483,7 +546,7 @@ interface CreateFormProps<FieldDefs, TGetBaseField extends GetBaseField = GetBas
     fields?: FieldDefs extends Record<string, React__default.FC<any>> ? FieldDefs : never;
     getBaseField?: TGetBaseField;
 }
-type FormType<FieldDefs, ExtraProps = object, ExtraFieldProps extends object = object, ExtraOverrides = object> = (<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object>(props: WithFields<FormProps<TSchema, TFieldValues, TContext, ExtraFieldProps>, FieldDefs, ExtraOverrides> & {
+type FormType<FieldDefs, ExtraProps = object, ExtraFieldProps extends object = object, ExtraOverrides = object> = (<TSchema = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object>(props: WithFields<FormProps$1<TSchema, TFieldValues, TContext, ExtraFieldProps>, FieldDefs, ExtraOverrides> & {
     ref?: React__default.ForwardedRef<HTMLFormElement>;
 } & ExtraProps) => React__default.ReactElement) & {
     displayName?: string;
@@ -491,6 +554,30 @@ type FormType<FieldDefs, ExtraProps = object, ExtraFieldProps extends object = o
 };
 declare function createForm<FieldDefs, TGetBaseField extends GetBaseField<any> = GetBaseField<any>>({ resolver, fieldResolver, fields, getBaseField, }?: CreateFormProps<FieldDefs, TGetBaseField>): FormType<FieldDefs, object, TGetBaseField extends GetBaseField<infer ExtraFieldProps extends object> ? ExtraFieldProps : object, object>;
 
+interface UseFormProps<TFieldValues extends FieldValues, TContext extends object> extends UseFormProps$1<TFieldValues, TContext> {
+}
+interface UseFormReturn$1<TFieldValues extends FieldValues, TContext extends object> extends UseFormReturn$2<TFieldValues, TContext> {
+    Form: React.FC<Omit<FormProps<TFieldValues, TContext>, 'form'>>;
+    Field: React.FC<FieldProps<TFieldValues>>;
+    DisplayIf: React.FC<DisplayIfProps<TFieldValues>>;
+    ArrayField: React.FC<ArrayFieldProps<TFieldValues> & React.RefAttributes<UseArrayFieldReturn>>;
+    ObjectField: React.FC<ObjectFieldProps<TFieldValues>>;
+}
+declare function useForm<TFieldValues extends FieldValues, TContext extends object>(props?: UseFormProps<TFieldValues, TContext>): UseFormReturn$1<TFieldValues, TContext>;
+interface FormProps<TFieldValues extends FieldValues = FieldValues, TContext extends object = object> extends HTMLChakraProps<'form'> {
+    children: React.ReactNode;
+    form: ReturnType<typeof useForm$1<TFieldValues, TContext>>;
+    onSubmit: (data: any) => void;
+    onError?: (errors: any) => void;
+}
+interface UseZodFormProps<TSchema extends z.AnyZodObject | z.ZodEffects<z.AnyZodObject> = z.AnyZodObject, TFieldValues extends InferObjectSchema<TSchema> = InferObjectSchema<TSchema>, TContext extends object = object> extends Omit<UseFormProps$1<TFieldValues, TContext>, 'defaultValues'> {
+    schema: TSchema;
+    defaultValues?: DefaultValues<InferObjectSchema<TSchema>> | AsyncDefaultValues<InferObjectSchema<TSchema>>;
+}
+declare function useZodForm<TSchema extends z.AnyZodObject | z.ZodEffects<z.AnyZodObject> = z.AnyZodObject, TFieldValues extends InferObjectSchema<TSchema> = InferObjectSchema<TSchema>, TContext extends object = object>(props: UseZodFormProps<TSchema, TFieldValues, TContext>): UseFormReturn$1<InferObjectSchema<TSchema>, TContext>;
+type InferObjectSchema<T extends z.ZodTypeAny | z.ZodEffects<z.ZodTypeAny>> = T extends z.ZodEffects<infer TSchema> ? z.infer<TSchema> : z.infer<T>;
+type AsyncDefaultValues<TFieldValues> = (payload?: unknown) => Promise<TFieldValues>;
+
 interface DisplayFieldProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> extends Omit<Field$1.RootProps, 'type' | 'onChange' | 'defaultValue'> {
     name: TName | ArrayFieldPath<TName>;
     label?: string;
@@ -529,9 +616,9 @@ interface FieldsProps<TSchema = any> {
 }
 declare const AutoFields: React$1.FC<FieldsProps>;
 
-interface FieldsContextValue {
-    fields: Record<string, React__default.FC<any>>;
-    getBaseField?: GetBaseField<any>;
+interface FieldsContextValue<TFields = any, TBaseFieldProps extends object = object> {
+    fields: Record<string, React__default.FC<TFields>>;
+    getBaseField?: GetBaseField<TBaseFieldProps>;
 }
 declare const FieldsProvider: React__default.FC<{
     value: FieldsContextValue;
@@ -578,20 +665,24 @@ interface WatchFieldProps<Value = unknown, TFieldValues extends FieldValues = Fi
     isExact?: boolean;
     children: (value: Value, form: UseFormReturn<TFieldValues, TContext>) => React.ReactElement | void;
 }
-declare const WatchField: <Value = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object>(props: WatchFieldProps<Value, TFieldValues, TContext>) => React$1.ReactElement<any, string | React$1.JSXElementConstructor<any>> | null;
+declare const WatchField: <Value = unknown, TFieldValues extends FieldValues = FieldValues, TContext extends object = object>(props: WatchFieldProps<Value, TFieldValues, TContext>) => React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | null;
 
 declare const useBaseField: (props: BaseFieldProps) => {
-    controlProps: Pick<BaseFieldProps<react_hook_form.FieldValues, string>, never>;
+    rootProps: Omit<BaseFieldProps<react_hook_form.FieldValues, string>, "name" | "label" | "hideLabel" | "help" | "rules" | "type" | "placeholder" | "children">;
     error: any;
     touched: any;
     name: string;
     label?: string | undefined;
     hideLabel?: boolean | undefined;
     help?: string | undefined;
+    rules?: Omit<react_hook_form.RegisterOptions<react_hook_form.FieldValues, string>, "disabled" | "setValueAs" | "valueAsNumber" | "valueAsDate"> | undefined;
+    type?: string | undefined;
+    placeholder?: string | undefined;
+    children?: React$1.ReactNode;
 };
 /**
  * The default BaseField component
- * Composes the Chakra UI FormControl component, with FormLabel, FormHelperText and FormErrorMessage.
+ * Composes the Chakra UI Field component, with Label, HelperText and ErrorText.
  */
 declare const BaseField: React$1.FC<BaseFieldProps>;
 
@@ -625,4 +716,4 @@ declare const createField: <TType = unknown, TProps extends object = object>(com
  */
 declare const Form: FormType<unknown, object, any, object>;
 
-export { ArrayField, ArrayFieldAddButton, type ArrayFieldButtonProps, ArrayFieldContainer, type ArrayFieldContainerProps, type ArrayFieldOptions, type ArrayFieldProps, ArrayFieldProvider, ArrayFieldRemoveButton, ArrayFieldRow, ArrayFieldRowContainer, ArrayFieldRowFields, type ArrayFieldRowFieldsProps, ArrayFieldRowProvider, ArrayFieldRows, type ArrayFieldRowsProps, AutoFields, BaseField, type BaseFieldProps, Form$1 as BaseForm, type CreateFieldOptions, type CreateFormProps, type DefaultFieldOverrides, type DefaultFields, DisplayField, type DisplayFieldProps, DisplayIf, type DisplayIfProps, Field, type FieldOptions, type FieldProps, type FieldResolver, type FieldRules, type FieldsProps, FieldsProvider, Form, type FormComponent, FormLayout, type FormLayoutProps, FormLegend, type FormProps, FormProvider, type FormRenderContext, type FormType, FormValue, type GetBaseField, type GetFieldResolver, InputField, type InputFieldProps, ObjectField, type ObjectFieldProps, type ObjectSchema, SubmitButton, type SubmitButtonProps, TextareaField, type TextareaFieldProps, type UseArrayFieldReturn, type UseArrayFieldRowProps, type UseArrayFieldRowReturn, WatchField, type WatchFieldProps, type WithFields, createField, createForm, defaultFieldTypes, objectFieldResolver, useArrayField, useArrayFieldAddButton, useArrayFieldContext, useArrayFieldRemoveButton, useArrayFieldRow, useArrayFieldRowContext, useBaseField, useField, useFormContext };
+export { ArrayField, ArrayFieldAddButton, type ArrayFieldButtonProps, ArrayFieldContainer, type ArrayFieldContainerProps, type ArrayFieldOptions, type ArrayFieldPath, type ArrayFieldProps, ArrayFieldProvider, ArrayFieldRemoveButton, ArrayFieldRow, ArrayFieldRowContainer, ArrayFieldRowFields, type ArrayFieldRowFieldsProps, ArrayFieldRowProvider, ArrayFieldRows, type ArrayFieldRowsProps, AutoFields, BaseField, type BaseFieldProps, Form$1 as BaseForm, type CreateFieldOptions, type CreateFormProps, type DefaultFieldOverrides, type DefaultFields, DisplayField, type DisplayFieldProps, DisplayIf, type DisplayIfProps, Field, type FieldOption, type FieldOptions, type FieldOverrides, type FieldProps, type FieldResolver, type FieldRules, type FieldsProps, FieldsProvider, Form, type FormChildren, type FormComponent, FormLayout, type FormLayoutProps, FormLegend, type FormProps$1 as FormProps, FormProvider, type FormRenderContext, type FormType, FormValue, type GetBaseField, type GetFieldResolver, InputField, type InputFieldProps, type MergeFieldProps, ObjectField, type ObjectFieldProps, type ObjectSchema, type ShallowMerge, type StepFormChildren, SubmitButton, type SubmitButtonProps, TextareaField, type TextareaFieldProps, type UseArrayFieldReturn, type UseArrayFieldRowProps, type UseArrayFieldRowReturn, type UseFormProps, type UseFormReturn$1 as UseFormReturn, type UseZodFormProps, type ValueOf, WatchField, type WatchFieldProps, type WithFields, createField, createForm, defaultFieldTypes, objectFieldResolver, useArrayField, useArrayFieldAddButton, useArrayFieldContext, useArrayFieldRemoveButton, useArrayFieldRow, useArrayFieldRowContext, useBaseField, useField, useForm, useFormContext, useZodForm };