@juantroconisf/lib 11.0.1 → 11.1.0

package/README.md

@@ -343,24 +343,25 @@ return (
 );
 ```
 
-### Option 3: Inline handler with full type inference
+### Option 3: External handler with `FormSubmit`
 
-When the schema is defined inline inside `useForm`, extract the handler type from `ControlledForm`:
+When you need to define the submit handler outside the JSX, use the `FormSubmit` utility type:
 
 ```tsx
+import { useForm, FormSubmit } from "@juantroconisf/lib";
+
 const { ControlledForm } = useForm({
   email: string().required().default(""),
 });
 
-const handleSubmit: React.ComponentProps<typeof ControlledForm>["onSubmit"] = (
-  data,
-  event,
-) => {
+const handleSubmit: FormSubmit<typeof ControlledForm> = (data, event) => {
   // data.email is correctly typed as string — no schema re-declaration needed
   console.log(data.email);
 };
 ```
 
+`FormSubmit<typeof ControlledForm>` is a shorthand for `React.ComponentProps<typeof ControlledForm>["onSubmit"]`.
+
 ---
 
 ## API Reference

package/dist/index.d.mts

@@ -66,6 +66,19 @@ type FormSubmitHandler<O extends StateType> = (data: O, e: React.FormEvent) => v
  * This saves developers from manually mapping `InferType` back to `FormSubmitHandler` when extracting sumbits.
  */
 type InferSubmitHandler<S extends Record<string, ConfigType>> = (data: InferState<S>, e: React.FormEvent) => void;
+/**
+ * Shorthand to extract the `onSubmit` handler type from a `ControlledForm` component.
+ *
+ * @example
+ * ```tsx
+ * const { ControlledForm } = useForm({ email: string().required().default("") });
+ *
+ * const handleSubmit: FormSubmit<typeof ControlledForm> = (data, event) => {
+ *   console.log(data.email); // fully typed
+ * };
+ * ```
+ */
+type FormSubmit<C extends React.ComponentType<any>> = NonNullable<React.ComponentProps<C>["onSubmit"]>;
 interface FormResetOptions<O> {
     keepValues?: (keyof O)[];
 }
@@ -268,4 +281,4 @@ interface UseFormResponse<O extends StateType> {
 
 declare function useForm<S extends Record<string, ConfigType>>(schema: S, { arrayIdentifiers, onFormSubmit: onFormSubmitProp, resetOnSubmit, keepValues: keepValuesProp, }?: FormOptions<InferState<S>>): UseFormResponse<InferState<S>>;
 
-export { type BlurFunc, type ComponentInputProps, type ConfigType, type FieldMetadata, type FormOptions, type FormResetOptions, type FormSubmitHandler, type HelpersFunc, type InferState, type InferSubmitHandler, type ItemAutocompleteProps, type ItemInputProps, type ItemNumberInputProps, type ItemRadioGroupProps, type ItemSelectProps, type ItemToggleProps, type MetadataType, type NestedChangeProps, NextUIError, type OnMethods, type StateType, type UseFormResponse, type ValueChangeFunc, useForm };
+export { type BlurFunc, type ComponentInputProps, type ConfigType, type FieldMetadata, type FormOptions, type FormResetOptions, type FormSubmit, type FormSubmitHandler, type HelpersFunc, type InferState, type InferSubmitHandler, type ItemAutocompleteProps, type ItemInputProps, type ItemNumberInputProps, type ItemRadioGroupProps, type ItemSelectProps, type ItemToggleProps, type MetadataType, type NestedChangeProps, NextUIError, type OnMethods, type StateType, type UseFormResponse, type ValueChangeFunc, useForm };

package/dist/index.d.ts

@@ -66,6 +66,19 @@ type FormSubmitHandler<O extends StateType> = (data: O, e: React.FormEvent) => v
  * This saves developers from manually mapping `InferType` back to `FormSubmitHandler` when extracting sumbits.
  */
 type InferSubmitHandler<S extends Record<string, ConfigType>> = (data: InferState<S>, e: React.FormEvent) => void;
+/**
+ * Shorthand to extract the `onSubmit` handler type from a `ControlledForm` component.
+ *
+ * @example
+ * ```tsx
+ * const { ControlledForm } = useForm({ email: string().required().default("") });
+ *
+ * const handleSubmit: FormSubmit<typeof ControlledForm> = (data, event) => {
+ *   console.log(data.email); // fully typed
+ * };
+ * ```
+ */
+type FormSubmit<C extends React.ComponentType<any>> = NonNullable<React.ComponentProps<C>["onSubmit"]>;
 interface FormResetOptions<O> {
     keepValues?: (keyof O)[];
 }
@@ -268,4 +281,4 @@ interface UseFormResponse<O extends StateType> {
 
 declare function useForm<S extends Record<string, ConfigType>>(schema: S, { arrayIdentifiers, onFormSubmit: onFormSubmitProp, resetOnSubmit, keepValues: keepValuesProp, }?: FormOptions<InferState<S>>): UseFormResponse<InferState<S>>;
 
-export { type BlurFunc, type ComponentInputProps, type ConfigType, type FieldMetadata, type FormOptions, type FormResetOptions, type FormSubmitHandler, type HelpersFunc, type InferState, type InferSubmitHandler, type ItemAutocompleteProps, type ItemInputProps, type ItemNumberInputProps, type ItemRadioGroupProps, type ItemSelectProps, type ItemToggleProps, type MetadataType, type NestedChangeProps, NextUIError, type OnMethods, type StateType, type UseFormResponse, type ValueChangeFunc, useForm };
+export { type BlurFunc, type ComponentInputProps, type ConfigType, type FieldMetadata, type FormOptions, type FormResetOptions, type FormSubmit, type FormSubmitHandler, type HelpersFunc, type InferState, type InferSubmitHandler, type ItemAutocompleteProps, type ItemInputProps, type ItemNumberInputProps, type ItemRadioGroupProps, type ItemSelectProps, type ItemToggleProps, type MetadataType, type NestedChangeProps, NextUIError, type OnMethods, type StateType, type UseFormResponse, type ValueChangeFunc, useForm };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juantroconisf/lib",
-  "version": "11.0.1",
+  "version": "11.1.0",
   "description": "A form validation library for HeroUI.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",