@mapples/form 1.0.1

package/dist/hooks/useFormHistory.js

@@ -0,0 +1,57 @@
+import { useCallback, useContext, useEffect, useState } from 'react';
+import FormContext from '../context';
+/**
+ * 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
+ */
+const useFormHistory = () => {
+    const { form } = useContext(FormContext);
+    const [state, setState] = useState({ canPrev: false, canNext: false });
+    useEffect(() => {
+        const unsubscribe = form?.subscribeOnChange(() => {
+            setState({
+                canPrev: form?.canPrev() || false,
+                canNext: form?.canNext() || false,
+            });
+        });
+        return () => {
+            unsubscribe?.();
+        };
+    }, [form]);
+    const prev = useCallback(() => {
+        if (!form)
+            return false;
+        return form.prev();
+    }, [form]);
+    const next = useCallback(() => {
+        if (!form)
+            return false;
+        return form.next();
+    }, [form]);
+    return {
+        prev,
+        next,
+        canPrev: state.canPrev,
+        canNext: state.canNext,
+    };
+};
+export default useFormHistory;
+//# sourceMappingURL=useFormHistory.js.map

package/dist/hooks/useFormHistory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormHistory.js","sourceRoot":"","sources":["../../src/hooks/useFormHistory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAErE,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,cAAc,GAAG,GAAG,EAAE;IAC1B,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAEvE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,IAAI,EAAE,iBAAiB,CAAC,GAAG,EAAE;YAC/C,QAAQ,CAAC;gBACP,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,KAAK;gBACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,KAAK;aAClC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/hooks/useFormState.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hook to manage the entire form state with reactive values and control methods.
+ * This hook provides access to all form values and methods to update them.
+ *
+ * @template T - The type of the form data object
+ * @returns Object containing form values and control methods
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const { values, setValues, getValues } = useFormState<UserForm>();
+ *
+ *   const handleReset = () => {
+ *     setValues({ name: '', email: '' });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Current values: {JSON.stringify(values)}</p>
+ *       <button onClick={handleReset}>Reset Form</button>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormState: <T extends object>() => {
+    values: T | undefined;
+    setValues: (values: T) => void;
+    getValues: () => T | undefined;
+};
+export default useFormState;
+//# sourceMappingURL=useFormState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormState.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,QAAA,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM;;wBAezB,CAAC;qBAOkB,CAAC,GAAG,SAAS;CAQ5C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormState.js

@@ -0,0 +1,54 @@
+import { useCallback, useContext, useEffect, useState } from 'react';
+import FormContext from '../context';
+/**
+ * Hook to manage the entire form state with reactive values and control methods.
+ * This hook provides access to all form values and methods to update them.
+ *
+ * @template T - The type of the form data object
+ * @returns Object containing form values and control methods
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const { values, setValues, getValues } = useFormState<UserForm>();
+ *
+ *   const handleReset = () => {
+ *     setValues({ name: '', email: '' });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <p>Current values: {JSON.stringify(values)}</p>
+ *       <button onClick={handleReset}>Reset Form</button>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormState = () => {
+    const [values, setFormValues] = useState();
+    const { form } = useContext(FormContext);
+    useEffect(() => {
+        const unsubscribe = form?.subscribeOnChange((values) => {
+            setFormValues(values);
+        });
+        return () => {
+            unsubscribe?.();
+        };
+    }, [form]);
+    const setValues = useCallback((values) => {
+        form?.setValues(values);
+    }, [form]);
+    const getValues = useCallback(() => {
+        return form?.getValues();
+    }, [form]);
+    return {
+        values,
+        setValues,
+        getValues,
+    };
+};
+export default useFormState;
+//# sourceMappingURL=useFormState.js.map

package/dist/hooks/useFormState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.js","sourceRoot":"","sources":["../../src/hooks/useFormState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAErE,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,YAAY,GAAG,GAAqB,EAAE;IAC1C,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,QAAQ,EAAK,CAAC;IAE9C,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,IAAI,EAAE,iBAAiB,CAAI,CAAC,MAAM,EAAE,EAAE;YACxD,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,EAAE;YACV,WAAW,EAAE,EAAE,CAAC;QAClB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,MAAS,EAAE,EAAE;QACZ,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC,EACD,CAAC,IAAI,CAAC,CACP,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,OAAO,IAAI,EAAE,SAAS,EAAmB,CAAC;IAC5C,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEX,OAAO;QACL,MAAM;QACN,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormSubmit.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hook to access form submission state and submit function.
+ * This hook provides the current submission state and the submit function.
+ *
+ * @returns Object containing submission state and submit function
+ *
+ * @example
+ * ```tsx
+ * const SubmitButton = () => {
+ *   const { submitting, submitForm } = useFormSubmit();
+ *
+ *   return (
+ *     <button onClick={submitForm} disabled={submitting}>
+ *       {submitting ? 'Submitting...' : 'Submit'}
+ *     </button>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormSubmit: () => {
+    submitting: boolean;
+    submitForm: () => void;
+};
+export default useFormSubmit;
+//# sourceMappingURL=useFormSubmit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormSubmit.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormSubmit.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,QAAA,MAAM,aAAa;;;CAOlB,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/useFormSubmit.js

@@ -0,0 +1,31 @@
+import useFormContext from './useFormContext';
+/**
+ * Hook to access form submission state and submit function.
+ * This hook provides the current submission state and the submit function.
+ *
+ * @returns Object containing submission state and submit function
+ *
+ * @example
+ * ```tsx
+ * const SubmitButton = () => {
+ *   const { submitting, submitForm } = useFormSubmit();
+ *
+ *   return (
+ *     <button onClick={submitForm} disabled={submitting}>
+ *       {submitting ? 'Submitting...' : 'Submit'}
+ *     </button>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormSubmit = () => {
+    const { submitting, submitForm } = useFormContext();
+    return {
+        submitting,
+        submitForm,
+    };
+};
+export default useFormSubmit;
+//# sourceMappingURL=useFormSubmit.js.map

package/dist/hooks/useFormSubmit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormSubmit.js","sourceRoot":"","sources":["../../src/hooks/useFormSubmit.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,aAAa,GAAG,GAAG,EAAE;IACzB,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE,CAAC;IAEpD,OAAO;QACL,UAAU;QACV,UAAU;KACX,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/hooks/useFormValue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Hook to get a reactive value from the form state.
+ * This hook subscribes to value changes and returns the current value.
+ *
+ * @template T - The type of the value to retrieve
+ * @param fieldPath - Optional dot notation path to the field. If not provided, returns all form values
+ * @returns The current value at the specified path or all form values
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const userName = useFormValue<string>('user.name');
+ *   const allValues = useFormValue<UserForm>();
+ *
+ *   return (
+ *     <div>
+ *       <p>User name: {userName}</p>
+ *       <p>All values: {JSON.stringify(allValues)}</p>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+declare const useFormValue: <T>(fieldPath?: string) => T | undefined;
+export default useFormValue;
+//# sourceMappingURL=useFormValue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useFormValue.d.ts","sourceRoot":"","sources":["../../src/hooks/useFormValue.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,QAAA,MAAM,YAAY,GAAI,CAAC,EAAE,YAAY,MAAM,kBAkB1C,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/hooks/useFormValue.js

@@ -0,0 +1,43 @@
+import { useContext, useEffect, useState } from 'react';
+import FormContext from '../context';
+/**
+ * Hook to get a reactive value from the form state.
+ * This hook subscribes to value changes and returns the current value.
+ *
+ * @template T - The type of the value to retrieve
+ * @param fieldPath - Optional dot notation path to the field. If not provided, returns all form values
+ * @returns The current value at the specified path or all form values
+ *
+ * @example
+ * ```tsx
+ * const MyComponent = () => {
+ *   const userName = useFormValue<string>('user.name');
+ *   const allValues = useFormValue<UserForm>();
+ *
+ *   return (
+ *     <div>
+ *       <p>User name: {userName}</p>
+ *       <p>All values: {JSON.stringify(allValues)}</p>
+ *     </div>
+ *   );
+ * };
+ * ```
+ *
+ * @public
+ */
+const useFormValue = (fieldPath) => {
+    const { form } = useContext(FormContext);
+    const [value, setValue] = useState();
+    useEffect(() => {
+        setValue(form?.getValue(fieldPath));
+    }, [fieldPath, form]);
+    useEffect(() => {
+        const unsubscribe = form?.subscribeOnChange(setValue, fieldPath);
+        return () => {
+            unsubscribe?.();
+        };
+    }, [fieldPath, form]);
+    return value;
+};
+export default useFormValue;
+//# sourceMappingURL=useFormValue.js.map

package/dist/hooks/useFormValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormValue.js","sourceRoot":"","sources":["../../src/hooks/useFormValue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAExD,OAAO,WAAW,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,YAAY,GAAG,CAAI,SAAkB,EAAE,EAAE;IAC7C,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEzC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,EAAK,CAAC;IAExC,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtB,SAAS,CAAC,GAAG,EAAE;QACb,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,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IAEtB,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,45 @@
+import FormState from './state';
+/**
+ * @mapples/form - A comprehensive form management library for React and React Native
+ *
+ * This package provides a powerful and flexible form state management solution with:
+ * - Type-safe form handling with TypeScript support
+ * - Yup validation integration
+ * - Form history management (undo/redo functionality)
+ * - Reactive form state with subscription-based updates
+ * - Comprehensive hook-based API for form field management
+ * - Support for nested objects and arrays
+ * - Touch state tracking for better UX
+ *
+ * @example
+ * ```tsx
+ * import { Form, useFormField, useFormSubmit } from '@mapples/form';
+ * import * as yup from 'yup';
+ *
+ * const schema = yup.object({
+ *   name: yup.string().required('Name is required'),
+ *   email: yup.string().email().required('Email is required'),
+ * });
+ *
+ * const MyForm = () => (
+ *   <Form
+ *     initialValues={{ name: '', email: '' }}
+ *     validationSchema={schema}
+ *     onSubmit={async (values) => {
+ *       console.log('Form submitted:', values);
+ *     }}
+ *   >
+ *     <NameField />
+ *     <EmailField />
+ *     <SubmitButton />
+ *   </Form>
+ * );
+ * ```
+ *
+ * @public
+ */
+export * from './types';
+export * from './components';
+export * from './hooks';
+export { FormState };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,49 @@
+import FormState from './state';
+/**
+ * @mapples/form - A comprehensive form management library for React and React Native
+ *
+ * This package provides a powerful and flexible form state management solution with:
+ * - Type-safe form handling with TypeScript support
+ * - Yup validation integration
+ * - Form history management (undo/redo functionality)
+ * - Reactive form state with subscription-based updates
+ * - Comprehensive hook-based API for form field management
+ * - Support for nested objects and arrays
+ * - Touch state tracking for better UX
+ *
+ * @example
+ * ```tsx
+ * import { Form, useFormField, useFormSubmit } from '@mapples/form';
+ * import * as yup from 'yup';
+ *
+ * const schema = yup.object({
+ *   name: yup.string().required('Name is required'),
+ *   email: yup.string().email().required('Email is required'),
+ * });
+ *
+ * const MyForm = () => (
+ *   <Form
+ *     initialValues={{ name: '', email: '' }}
+ *     validationSchema={schema}
+ *     onSubmit={async (values) => {
+ *       console.log('Form submitted:', values);
+ *     }}
+ *   >
+ *     <NameField />
+ *     <EmailField />
+ *     <SubmitButton />
+ *   </Form>
+ * );
+ * ```
+ *
+ * @public
+ */
+// Export all types
+export * from './types';
+// Export all components
+export * from './components';
+// Export all hooks
+export * from './hooks';
+// Export FormState class for advanced usage
+export { FormState };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,SAAS,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,wBAAwB;AACxB,cAAc,cAAc,CAAC;AAE7B,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,CAAC"}

package/dist/state/index.d.ts

@@ -0,0 +1,128 @@
+import { ObjectSchema, ValidationError } from 'yup';
+import type { SubscriptionCallBack } from '../types';
+/**
+ * FormState manages the state of a form including values, validation, history, and subscriptions.
+ * It provides methods to get/set values, validate data, manage history for undo/redo functionality,
+ * and subscribe to value changes.
+ *
+ * @template T - The type of the form data object
+ * @public
+ */
+declare class FormState<T extends object> {
+    private values;
+    private validationSchema?;
+    private subscriptions;
+    private formHistorySubscriptions;
+    private errors;
+    private history;
+    private historyIndex;
+    private readonly historyItems;
+    private readonly historyItemThrottle;
+    private saveCounter;
+    private readonly filterHistoryKeys;
+    /**
+     * Creates a new FormState instance.
+     *
+     * @param initialValues - The initial values for the form
+     * @param validationSchema - Optional Yup validation schema
+     * @param historyItems - Number of history items to keep for undo/redo (0 to disable)
+     * @param historyItemThrottle - Throttle for saving history items (every Nth change)
+     * @param filterHistoryKeys - Array of field paths to exclude from history tracking
+     */
+    constructor(initialValues: T, validationSchema?: ObjectSchema<T>, historyItems?: number, historyItemThrottle?: number, filterHistoryKeys?: string[]);
+    /**
+     * Gets a deep copy of all form values.
+     *
+     * @returns A deep copy of the current form values
+     */
+    getValues(): T;
+    /**
+     * Sets validation errors for the form.
+     *
+     * @param errors - Validation errors organized by field path
+     */
+    setErrors(errors: Record<string, ValidationError[]>): void;
+    /**
+     * Gets the current validation errors.
+     *
+     * @returns Current validation errors or null if no errors
+     */
+    getErrors(): Record<string, ValidationError[]> | null;
+    /**
+     * Sets all form values and triggers subscriptions.
+     *
+     * @param values - New values to set for the form
+     */
+    setValues(values: T): void;
+    /**
+     * Sets a value at a specific path and triggers subscriptions.
+     *
+     * @template V - The type of value being set
+     * @param path - Dot notation path to the field (e.g., 'user.name')
+     * @param value - The value to set at the specified path
+     */
+    setValue<V>(path: string, value?: V): void;
+    /**
+     * Subscribes to form value changes.
+     *
+     * @template V - The type of value being subscribed to
+     * @param cb - Callback function to execute when values change
+     * @param path - Optional path to subscribe to a specific field
+     * @returns Unsubscribe function to remove the subscription
+     */
+    subscribeOnChange<V>(cb: SubscriptionCallBack<V>, path?: string): () => boolean;
+    /**
+     * Subscribes to form history changes (undo/redo operations).
+     *
+     * @param cb - Callback function to execute when history changes
+     * @returns Unsubscribe function to remove the subscription
+     */
+    subscribeOnHistoryChange(cb: () => void): () => boolean;
+    /**
+     * Gets a value at a specific path or all values if no path is provided.
+     *
+     * @template V - The type of value to return
+     * @param path - Optional dot notation path to the field
+     * @returns The value at the specified path or all form values
+     */
+    getValue<V>(path?: string): V;
+    /**
+     * Validates the form using the provided validation schema.
+     *
+     * @throws {Record<string, ValidationError[]>} Throws validation errors if validation fails
+     */
+    validate(): Promise<void>;
+    private saveToHistory;
+    /**
+     * Moves to the previous state in the form history (undo operation).
+     *
+     * @returns True if the operation was successful, false if no previous state exists
+     */
+    prev(): boolean;
+    /**
+     * Moves to the next state in the form history (redo operation).
+     *
+     * @returns True if the operation was successful, false if no next state exists
+     */
+    next(): boolean;
+    /**
+     * Checks if there is a previous state available for undo operation.
+     *
+     * @returns True if undo operation is possible
+     */
+    canPrev(): boolean;
+    /**
+     * Checks if there is a next state available for redo operation.
+     *
+     * @returns True if redo operation is possible
+     */
+    canNext(): boolean;
+    private notifySubscriptions;
+    private notifyHistorySubscriptions;
+    private remapValidationError;
+    private unsubscribeOnChange;
+    private unsubscribeOnHistoryChange;
+    private generateListenerId;
+}
+export default FormState;
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,KAAK,CAAC;AAEpD,OAAO,KAAK,EAEV,oBAAoB,EAErB,MAAM,UAAU,CAAC;AAElB;;;;;;;GAOG;AACH,cAAM,SAAS,CAAC,CAAC,SAAS,MAAM;IAC9B,OAAO,CAAC,MAAM,CAAI;IAElB,OAAO,CAAC,gBAAgB,CAAC,CAAkB;IAC3C,OAAO,CAAC,aAAa,CAA6C;IAClE,OAAO,CAAC,wBAAwB,CAAsC;IACtE,OAAO,CAAC,MAAM,CAAkD;IAEhE,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAW;IAE7C;;;;;;;;OAQG;gBAED,aAAa,EAAE,CAAC,EAChB,gBAAgB,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAClC,YAAY,GAAE,MAAU,EACxB,mBAAmB,GAAE,MAAU,EAC/B,iBAAiB,GAAE,MAAM,EAAO;IAclC;;;;OAIG;IACH,SAAS;IAIT;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAInD;;;;OAIG;IACH,SAAS;IAIT;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,CAAC;IAYnB;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;IAmBnC;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM;IAW/D;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,EAAE,MAAM,IAAI;IAQvC;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,CAAC;IAI7B;;;;OAIG;IACG,QAAQ;IAYd,OAAO,CAAC,aAAa;IA4BrB;;;;OAIG;IACH,IAAI;IASJ;;;;OAIG;IACH,IAAI;IASJ;;;;OAIG;IACH,OAAO;IAIP;;;;OAIG;IACH,OAAO;IAIP,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,0BAA0B;IAIlC,OAAO,CAAC,kBAAkB;CAM3B;AAED,eAAe,SAAS,CAAC"}