@delightui/components 0.1.139 → 0.1.140

package/dist/cjs/components/organisms/Form/UseFormExample.d.ts

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

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

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

package/dist/cjs/components/organisms/Form/useForm.d.ts

@@ -0,0 +1,50 @@
+import type { FormContextValues, FormState } from './Form.types';
+/**
+ * Custom hook to access form context values.
+ * Provides direct access to all form state management functions and values.
+ *
+ * @throws {Error} If used outside of a Form component
+ * @returns {FormContextValues} Object containing form state and control functions
+ *
+ * @example
+ * ```tsx
+ * const MyCustomField = () => {
+ *   const {
+ *     formState,
+ *     formErrors,
+ *     updateFieldValue,
+ *     resetForm
+ *   } = useForm();
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={formState.myField || ''}
+ *         onChange={(e) => updateFieldValue('myField', e.target.value)}
+ *       />
+ *       {formErrors.myField && <span>{formErrors.myField}</span>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ */
+export declare const useForm: <T extends FormState = Partial<Record<string, import("./Form.types").FieldValue>>>() => FormContextValues<T>;
+/**
+ * Type-safe version of useForm that returns properly typed form context
+ *
+ * @example
+ * ```tsx
+ * interface MyFormData {
+ *   name: string;
+ *   email: string;
+ *   age: number;
+ * }
+ *
+ * const MyComponent = () => {
+ *   const form = useFormTyped<MyFormData>();
+ *   // form.formState is now typed as MyFormData
+ *   // form.formErrors is now typed as FormErrors<MyFormData>
+ * };
+ * ```
+ */
+export declare const useFormTyped: <T extends FormState>() => FormContextValues<T>;