@mapples/form 1.0.1

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AACpD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AACtD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,gBAAgB,GACjB,CAAC"}

package/dist/hooks/useBindFormField.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Hook to bind a form field with optional fallback path synchronization.
+ * This hook is similar to useFormField but allows binding a field to a fallback path,
+ * useful for creating field aliases or synchronized fields.
+ *
+ * @template T - The type of the field value
+ * @param fieldPath - Primary dot notation path to the field
+ * @param fallBackPath - Optional fallback path to synchronize with
+ * @param fallbackValue - Default value to use if field is undefined
+ * @param subscribe - Whether to subscribe to real-time value changes (default: true)
+ * @returns Object containing field value, error state, and control methods
+ *
+ * @example
+ * ```tsx
+ * const NameField = () => {
+ *   const { value, error, setValue } = useBindFormField<string>(
+ *     'user.name',
+ *     'displayName', // Also update displayName when user.name changes
+ *     ''
+ *   );
+ *
+ *   return (
+ *     <input
+ *       value={value}
+ *       onChange={(e) => setValue(e.target.value)}
+ *     />
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useBindFormField: <T>(fieldPath: string, fallBackPath?: string, fallbackValue?: T, subscribe?: boolean) => {
+    value: T | undefined;
+    error: string | undefined;
+    errors: import("yup").ValidationError[] | undefined;
+    isTouched: boolean;
+    validate: () => void;
+    touch: (fieldName: string) => void;
+    setValue: (newValue: T) => void;
+};
+export default useBindFormField;
+//# sourceMappingURL=useBindFormField.d.ts.map

package/dist/hooks/useBindFormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBindFormField.d.ts","sourceRoot":"","sources":["../../src/hooks/useBindFormField.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,QAAA,MAAM,gBAAgB,GAAI,CAAC,EACzB,WAAW,MAAM,EACjB,eAAe,MAAM,EACrB,gBAAgB,CAAC,EACjB,YAAY,OAAO;;;;;;;yBAmDN,CAAC;CAqBf,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/hooks/useBindFormField.js

@@ -0,0 +1,93 @@
+import { useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { first } from 'lodash';
+import FormContext from '../context';
+/**
+ * Hook to bind a form field with optional fallback path synchronization.
+ * This hook is similar to useFormField but allows binding a field to a fallback path,
+ * useful for creating field aliases or synchronized fields.
+ *
+ * @template T - The type of the field value
+ * @param fieldPath - Primary dot notation path to the field
+ * @param fallBackPath - Optional fallback path to synchronize with
+ * @param fallbackValue - Default value to use if field is undefined
+ * @param subscribe - Whether to subscribe to real-time value changes (default: true)
+ * @returns Object containing field value, error state, and control methods
+ *
+ * @example
+ * ```tsx
+ * const NameField = () => {
+ *   const { value, error, setValue } = useBindFormField<string>(
+ *     'user.name',
+ *     'displayName', // Also update displayName when user.name changes
+ *     ''
+ *   );
+ *
+ *   return (
+ *     <input
+ *       value={value}
+ *       onChange={(e) => setValue(e.target.value)}
+ *     />
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useBindFormField = (fieldPath, fallBackPath, fallbackValue, subscribe) => {
+    const { form, touched, validationErrors, validate, touch } = useContext(FormContext);
+    const [value, setValue] = useState(fallbackValue);
+    const errors = validationErrors?.[fieldPath];
+    const error = useMemo(() => {
+        return first(errors)?.message;
+    }, [errors]);
+    const isTouched = useMemo(() => {
+        return !!touched[fieldPath];
+    }, [fieldPath, touched]);
+    useEffect(() => {
+        setValue(() => {
+            const value = form?.getValue(fieldPath) || fallbackValue;
+            if (fallBackPath) {
+                form?.setValue(fallBackPath, value);
+            }
+            return value;
+        });
+    }, [fallBackPath, fallbackValue, fieldPath, form]);
+    useEffect(() => {
+        if (!subscribe) {
+            const unsubscribe = form?.subscribeOnHistoryChange(() => {
+                const newValue = form?.getValue(fieldPath) || fallbackValue;
+                if (fallBackPath) {
+                    form?.setValue(fallBackPath, newValue);
+                }
+                setValue(newValue);
+            });
+            return () => {
+                unsubscribe?.();
+            };
+        }
+        const unsubscribe = form?.subscribeOnChange(setValue, fieldPath);
+        return () => {
+            unsubscribe?.();
+        };
+    }, [fallBackPath, fallbackValue, fieldPath, form, subscribe]);
+    const handleSetValue = useCallback((newValue) => {
+        form?.setValue(fieldPath, newValue);
+        if (!subscribe) {
+            setValue(newValue);
+            if (fallBackPath) {
+                form?.setValue(fallBackPath, newValue);
+            }
+        }
+    }, [fallBackPath, fieldPath, form, subscribe]);
+    return {
+        value,
+        error,
+        errors,
+        isTouched,
+        validate,
+        touch,
+        setValue: handleSetValue,
+    };
+};
+export default useBindFormField;
+//# sourceMappingURL=useBindFormField.js.map

package/dist/hooks/useBindFormField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBindFormField.js","sourceRoot":"","sources":["../../src/hooks/useBindFormField.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useFormArrayField.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Hook to manage array fields with specialized array manipulation methods.
+ * This hook provides methods to add, remove, and manipulate array items in a form field.
+ *
+ * @template T - The type of items in the array
+ * @param fieldPath - Dot notation path to the array field
+ * @param fallbackValue - Default array value to use if field is undefined
+ * @returns Object containing array value and manipulation methods
+ *
+ * @example
+ * ```tsx
+ * const TagsField = () => {
+ *   const { value, api } = useFormArrayField<string>('tags', []);
+ *
+ *   return (
+ *     <div>
+ *       {value.map((tag, index) => (
+ *         <div key={index}>
+ *           {tag}
+ *           <button onClick={() => api.remove(index)}>Remove</button>
+ *         </div>
+ *       ))}
+ *       <button onClick={() => api.push('New Tag')}>Add Tag</button>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormArrayField: <T>(fieldPath: string, fallbackValue?: T[]) => {
+    value: T[] | undefined;
+    api: {
+        push: (item: T) => void;
+        dropLeft: (count?: number) => void;
+        dropRight: (count?: number) => void;
+        remove: (index: number) => void;
+        paste: (item: T, index: number) => void;
+        toggle: (item: T) => void;
+    };
+};
+export default useFormArrayField;
+//# sourceMappingURL=useFormArrayField.d.ts.map

package/dist/hooks/useFormArrayField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormArrayField.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormArrayField.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,QAAA,MAAM,iBAAiB,GAAI,CAAC,EAAE,WAAW,MAAM,EAAE,gBAAgB,CAAC,EAAE;;;qBAazC,CAAC;2BAIK,MAAM;4BAIL,MAAM;wBAIV,MAAM;sBAQR,CAAC,SAAS,MAAM;uBAQf,CAAC;;CAoB7B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/hooks/useFormArrayField.js

@@ -0,0 +1,88 @@
+import { useContext, useEffect, useState } from 'react';
+import { cloneDeep, drop, dropRight, indexOf } from 'lodash';
+import FormContext from '../context';
+/**
+ * Hook to manage array fields with specialized array manipulation methods.
+ * This hook provides methods to add, remove, and manipulate array items in a form field.
+ *
+ * @template T - The type of items in the array
+ * @param fieldPath - Dot notation path to the array field
+ * @param fallbackValue - Default array value to use if field is undefined
+ * @returns Object containing array value and manipulation methods
+ *
+ * @example
+ * ```tsx
+ * const TagsField = () => {
+ *   const { value, api } = useFormArrayField<string>('tags', []);
+ *
+ *   return (
+ *     <div>
+ *       {value.map((tag, index) => (
+ *         <div key={index}>
+ *           {tag}
+ *           <button onClick={() => api.remove(index)}>Remove</button>
+ *         </div>
+ *       ))}
+ *       <button onClick={() => api.push('New Tag')}>Add Tag</button>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormArrayField = (fieldPath, fallbackValue) => {
+    const { form } = useContext(FormContext);
+    const [value, setValue] = useState();
+    useEffect(() => {
+        setValue(form?.getValue(fieldPath));
+    }, [fieldPath, form]);
+    useEffect(() => {
+        form?.setValue(fieldPath, value);
+    }, [fieldPath, form, value]);
+    const fieldPush = (item) => {
+        setValue((prev) => [...(prev || []), item]);
+    };
+    const fieldDropLeft = (count) => {
+        setValue((prev) => drop(cloneDeep(prev), count));
+    };
+    const fieldDropRight = (count) => {
+        setValue((prev) => dropRight(cloneDeep(prev), count));
+    };
+    const fieldRemove = (index) => {
+        setValue((prev) => {
+            const valueClone = cloneDeep(prev);
+            valueClone?.splice(index, 1);
+            return valueClone;
+        });
+    };
+    const fieldPaste = (item, index) => {
+        setValue((prev) => {
+            const valueClone = cloneDeep(prev);
+            valueClone?.splice(index, 0, item);
+            return valueClone;
+        });
+    };
+    const fieldToggle = (item) => {
+        const itemIndex = indexOf(value, item);
+        if (itemIndex < 0) {
+            fieldPush(item);
+        }
+        else {
+            fieldRemove(itemIndex);
+        }
+    };
+    return {
+        value: value || fallbackValue,
+        api: {
+            push: fieldPush,
+            dropLeft: fieldDropLeft,
+            dropRight: fieldDropRight,
+            remove: fieldRemove,
+            paste: fieldPaste,
+            toggle: fieldToggle,
+        },
+    };
+};
+export default useFormArrayField;
+//# sourceMappingURL=useFormArrayField.js.map

package/dist/hooks/useFormArrayField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormArrayField.js","sourceRoot":"","sources":["../../src/hooks/useFormArrayField.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useFormContext.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook to access the form context containing form state and methods.
+ * This hook provides access to the FormState instance, validation errors,
+ * submission state, and form control methods.
+ *
+ * @returns Form context object with form state and methods
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const { form, submitting, submitForm, validationErrors } = useFormContext();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={submitForm} disabled={submitting}>
+ *         {submitting ? 'Submitting...' : 'Submit'}
+ *       </button>
+ *       {validationErrors && <div>Validation errors occurred</div>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormContext: () => import("..").FormContextType<object>;
+export default useFormContext;
+//# sourceMappingURL=useFormContext.d.ts.map

package/dist/hooks/useFormContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormContext.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,QAAA,MAAM,cAAc,4CAEnB,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/hooks/useFormContext.js

@@ -0,0 +1,32 @@
+import { useContext } from 'react';
+import FormContext from '../context';
+/**
+ * Hook to access the form context containing form state and methods.
+ * This hook provides access to the FormState instance, validation errors,
+ * submission state, and form control methods.
+ *
+ * @returns Form context object with form state and methods
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const { form, submitting, submitForm, validationErrors } = useFormContext();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={submitForm} disabled={submitting}>
+ *         {submitting ? 'Submitting...' : 'Submit'}
+ *       </button>
+ *       {validationErrors && <div>Validation errors occurred</div>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormContext = () => {
+    return useContext(FormContext);
+};
+export default useFormContext;
+//# sourceMappingURL=useFormContext.js.map

package/dist/hooks/useFormContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormContext.js","sourceRoot":"","sources":["../../src/hooks/useFormContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/hooks/useFormField.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Hook to manage a single form field with value, validation, and touch state.
+ * This hook provides reactive access to a form field's value, errors, and touch state,
+ * along with methods to update the value and trigger validation.
+ *
+ * @template T - The type of the field value
+ * @param fieldPath - Dot notation path to the field (e.g., 'user.name')
+ * @param fallbackValue - Default value to use if field is undefined
+ * @param subscribe - Whether to subscribe to real-time value changes (default: true)
+ * @returns Object containing field value, error state, and control methods
+ *
+ * @example
+ * ```tsx
+ * const NameField = () => {
+ *   const { value, error, isTouched, setValue, touch } = useFormField<string>('name', '');
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         onBlur={() => touch('name')}
+ *       />
+ *       {isTouched && error && <span className="error">{error}</span>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormField: <T>(fieldPath: string, fallbackValue?: T, subscribe?: boolean) => {
+    value: T | undefined;
+    error: string | undefined;
+    errors: import("yup").ValidationError[] | undefined;
+    isTouched: boolean;
+    validate: () => void;
+    touch: (fieldName: string) => void;
+    setValue: (newValue: T) => void;
+};
+export default useFormField;
+//# sourceMappingURL=useFormField.d.ts.map

package/dist/hooks/useFormField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormField.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormField.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,QAAA,MAAM,YAAY,GAAI,CAAC,EACrB,WAAW,MAAM,EACjB,gBAAgB,CAAC,EACjB,YAAY,OAAO;;;;;;;yBAwCN,CAAC;CAkBf,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormField.js

@@ -0,0 +1,79 @@
+import { useCallback, useContext, useEffect, useMemo, useState } from 'react';
+import { first } from 'lodash';
+import FormContext from '../context';
+/**
+ * Hook to manage a single form field with value, validation, and touch state.
+ * This hook provides reactive access to a form field's value, errors, and touch state,
+ * along with methods to update the value and trigger validation.
+ *
+ * @template T - The type of the field value
+ * @param fieldPath - Dot notation path to the field (e.g., 'user.name')
+ * @param fallbackValue - Default value to use if field is undefined
+ * @param subscribe - Whether to subscribe to real-time value changes (default: true)
+ * @returns Object containing field value, error state, and control methods
+ *
+ * @example
+ * ```tsx
+ * const NameField = () => {
+ *   const { value, error, isTouched, setValue, touch } = useFormField<string>('name', '');
+ *
+ *   return (
+ *     <div>
+ *       <input
+ *         value={value}
+ *         onChange={(e) => setValue(e.target.value)}
+ *         onBlur={() => touch('name')}
+ *       />
+ *       {isTouched && error && <span className="error">{error}</span>}
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormField = (fieldPath, fallbackValue, subscribe) => {
+    const { form, touched, validationErrors, validate, touch } = useContext(FormContext);
+    const [value, setValue] = useState(fallbackValue);
+    const errors = validationErrors?.[fieldPath];
+    const error = useMemo(() => {
+        return first(errors)?.message;
+    }, [errors]);
+    const isTouched = useMemo(() => {
+        return !!touched[fieldPath];
+    }, [fieldPath, touched]);
+    useEffect(() => {
+        setValue(form?.getValue(fieldPath) || fallbackValue);
+    }, [fallbackValue, fieldPath, form]);
+    useEffect(() => {
+        if (!subscribe) {
+            const unsubscribe = form?.subscribeOnHistoryChange(() => {
+                setValue(form?.getValue(fieldPath) || fallbackValue);
+            });
+            return () => {
+                unsubscribe?.();
+            };
+        }
+        const unsubscribe = form?.subscribeOnChange(setValue, fieldPath);
+        return () => {
+            unsubscribe?.();
+        };
+    }, [fallbackValue, fieldPath, form, subscribe]);
+    const handleSetValue = useCallback((newValue) => {
+        form?.setValue(fieldPath, newValue);
+        if (!subscribe) {
+            setValue(newValue);
+        }
+    }, [fieldPath, form, subscribe]);
+    return {
+        value,
+        error,
+        errors,
+        isTouched,
+        validate,
+        touch,
+        setValue: handleSetValue,
+    };
+};
+export default useFormField;
+//# sourceMappingURL=useFormField.js.map

package/dist/hooks/useFormField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormField.js","sourceRoot":"","sources":["../../src/hooks/useFormField.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE9E,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,YAAY,GAAG,CACnB,SAAiB,EACjB,aAAiB,EACjB,SAAmB,EACnB,EAAE;IACF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,KAAK,EAAE,GACxD,UAAU,CAAC,WAAW,CAAC,CAAC;IAE1B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,aAAa,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC;IAE7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAChC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;QAC7B,OAAO,CAAC,CAAC,OAAO,CAAC,SAAiC,CAAC,CAAC;IACtD,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzB,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAI,SAAS,CAAC,IAAI,aAAa,CAAC,CAAC;IAC1D,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,WAAW,GAAG,IAAI,EAAE,wBAAwB,CAAC,GAAG,EAAE;gBACtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAI,SAAS,CAAC,IAAI,aAAa,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,WAAW,EAAE,EAAE,CAAC;YAClB,CAAC,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,EAAE,iBAAiB,CAAI,QAAQ,EAAE,SAAS,CAAC,CAAC;QAEpE,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhD,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,QAAW,EAAE,EAAE;QACd,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,EACD,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAC7B,CAAC;IAEF,OAAO;QACL,KAAK;QACL,KAAK;QACL,MAAM;QACN,SAAS;QACT,QAAQ;QACR,KAAK;QACL,QAAQ,EAAE,cAAc;KACzB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormFieldToggle.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Hook to manage boolean toggle fields.
+ * This hook provides a simple way to handle boolean fields with toggle functionality.
+ *
+ * @param fieldPath - Dot notation path to the boolean field
+ * @returns Object containing current value and toggle function
+ *
+ * @example
+ * ```tsx
+ * const ToggleField = () => {
+ *   const { value, toggleValue } = useFormFieldToggle('isActive');
+ *
+ *   return (
+ *     <label>
+ *       <input
+ *         type="checkbox"
+ *         checked={value}
+ *         onChange={toggleValue}
+ *       />
+ *       Active
+ *     </label>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormFieldToggle: (fieldPath: string) => {
+    value: boolean;
+    toggleValue: () => void;
+};
+export default useFormFieldToggle;
+//# sourceMappingURL=useFormFieldToggle.d.ts.map

package/dist/hooks/useFormFieldToggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFieldToggle.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormFieldToggle.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,kBAAkB,GAAI,WAAW,MAAM;;;CAqB5C,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useFormFieldToggle.js

@@ -0,0 +1,49 @@
+import { useContext, useEffect, useState } from 'react';
+import FormContext from '../context';
+/**
+ * Hook to manage boolean toggle fields.
+ * This hook provides a simple way to handle boolean fields with toggle functionality.
+ *
+ * @param fieldPath - Dot notation path to the boolean field
+ * @returns Object containing current value and toggle function
+ *
+ * @example
+ * ```tsx
+ * const ToggleField = () => {
+ *   const { value, toggleValue } = useFormFieldToggle('isActive');
+ *
+ *   return (
+ *     <label>
+ *       <input
+ *         type="checkbox"
+ *         checked={value}
+ *         onChange={toggleValue}
+ *       />
+ *       Active
+ *     </label>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormFieldToggle = (fieldPath) => {
+    const { form } = useContext(FormContext);
+    const [value, setValue] = useState(false);
+    useEffect(() => {
+        setValue(form?.getValue(fieldPath) || false);
+    }, [fieldPath, form]);
+    const handleToggleValue = () => {
+        setValue((prev) => {
+            const nextValue = !prev;
+            form?.setValue(fieldPath, nextValue);
+            return nextValue;
+        });
+    };
+    return {
+        value,
+        toggleValue: handleToggleValue,
+    };
+};
+export default useFormFieldToggle;
+//# sourceMappingURL=useFormFieldToggle.js.map

package/dist/hooks/useFormFieldToggle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFieldToggle.js","sourceRoot":"","sources":["../../src/hooks/useFormFieldToggle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,kBAAkB,GAAG,CAAC,SAAiB,EAAE,EAAE;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEzC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAU,SAAS,CAAC,IAAI,KAAK,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtB,MAAM,iBAAiB,GAAG,GAAG,EAAE;QAC7B,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE;YAChB,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC;YACxB,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACrC,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;IAEF,OAAO;QACL,KAAK;QACL,WAAW,EAAE,iBAAiB;KAC/B,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/hooks/useFormHistory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Hook to manage form history for undo/redo functionality.
+ * This hook provides methods to navigate through form history and check availability of undo/redo operations.
+ *
+ * @returns Object containing history navigation methods and state
+ *
+ * @example
+ * ```tsx
+ * const HistoryControls = () => {
+ *   const { prev, next, canPrev, canNext } = useFormHistory();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={prev} disabled={!canPrev}>Undo</button>
+ *       <button onClick={next} disabled={!canNext}>Redo</button>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormHistory: () => {
+    prev: () => boolean;
+    next: () => boolean;
+    canPrev: boolean;
+    canNext: boolean;
+};
+export default useFormHistory;
+//# sourceMappingURL=useFormHistory.d.ts.map

package/dist/hooks/useFormHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormHistory.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormHistory.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,QAAA,MAAM,cAAc;;;;;CAiCnB,CAAC;AAEF,eAAe,cAAc,CAAC"}