react-form-manage 1.0.8-beta.2 → 1.0.8-beta.21

package/CHANGELOG.md

@@ -2,13 +2,97 @@
 
 All notable changes to this project will be documented in this file.
 
-## [1.0.8-beta.2] - 2026-01-22
+## [1.0.8-beta.21] - 2026-02-02
+
+### Fixes
+- Patch: Minor adjustments in useFormItemControl
+
+## [1.0.8-beta.20] - 2026-02-02
+
+### Features
+- Trigger `initied` flag for onChange in `useFormItemControl` to properly mark form items as initialized
+
+## [1.0.8-beta.19] - 2026-02-02
+
+### Features
+- Trigger `initied` flag for onChange in `useFormItemControl` to properly mark form items as initialized
+
+## [1.0.8-beta.18] - 2026-02-01
+
+### Features
+- Avoid deep traversal into class instances/functions in path collection
+- `getAllNoneObjStringPath` now skips non-plain objects and functions, only traverses arrays and plain objects
+- Improves performance and prevents accidental property access on class instances
+
+## [1.0.8-beta.17] - 2026-02-01
+
+### Features
+
+- Add nested path onChange trigger: `setFieldValue` now triggers onChange for child paths when parent path has no listener
+- Support setting array values in FormList with automatic re-render of list items and value updates
+- Enhanced listener types with `type` field (normal/array) and `onArrayChange` callback support
+
+### Improvements
+
+- `useFormListControl` now tracks item values and handles cache properly
+- Improved `useFormItemControl` with cache path validation using `lodash.has`
+
+## [1.0.8-beta.16] - 2026-02-01
+
+### Fixes
+
+- Fix: Guard listener registration to prevent pushing incomplete listeners without name/formName
+- Fix: Guard cleanup execution - only cleanup listeners that actually exist in the store
+- Add formItemId to dependency array for proper listener re-registration in strict mode
+
+## [1.0.8-beta.15] - 2026-02-01
+
+### Features
+
+- Export `useFormStore` and types (`FormInstance`, `ListenerItem`, `CleanUpItem`) to public API
+- Allow advanced users to access and manipulate form state directly
+
+## [1.0.8-beta.13] - 2026-02-01
+
+### Refactoring
+
+- Combine separate Zustand stores (`useFormListeners`, `useFormCleanUp`) into single unified `useFormStore`
+- Implement slice-based store pattern for better code organization and maintainability
+- Update all internal imports to use unified store across hooks and components
+- Maintain backward compatibility with deprecated store aliases
+
+## [1.0.8-beta.12] - 2026-01-27
+
+### Features
+
+- Add slice-based store architecture using Zustand for better scalability
+- Refactor form state management with proper separation of concerns
+
+## [1.0.8-beta.3] - 2026-01-22
+
+## [1.0.8-beta.7] - 2026-01-24
+
+- Add control flag for FormItem to support rendering MUI uncontrolled components when initial value is undefined (control on init).
+- Fix: `onReset` did not restore listener state to init.
+- Fix: reset did not return Form submit state to `idle`.
+- Add `hidden` prop to allow hiding components while still assigning a value.
+
+Docs: Update usage notes for `FormItem` control-on-init flag and `hidden` prop.
+
+- Add `UseFormItemStateWatchReturn` type export for `useFormItemStateWatch` hook
 
 - Add isTouched field to FormItem for tracking user interaction state
 
+## [1.0.8-beta.10] - 2026-01-27
+
+- `useForm()` giờ có thể trả về form instance từ provider lân cận nếu không truyền `formName` (không còn bắt buộc truyền tên form khi đã wrap trong `Form`).
+- `FormList.add` khi không truyền `index` sẽ mặc định append vào cuối danh sách.
+- Docs: cập nhật hướng dẫn cho `useForm` và `FormList.add`.
+
 ## [1.0.8-beta.1] - 2026-01-22
 
 - Fix UseFormItemControlReturn errors type to properly export FormFieldError[]
+
 ## [1.0.7-beta.1] - 2026-01-22
 
 - Add `FormFieldError` type export for typed error handling
@@ -89,7 +173,3 @@ All notable changes to this project will be documented in this file.
 ## [1.0.5] - 2026-01-21
 
 - Export `Form` as a named export in addition to default to improve import ergonomics for consumers.
-
-
-
-

package/README.md

@@ -2,8 +2,6 @@
 
 Thư viện form nhẹ dành cho React — hỗ trợ form, field, list (array fields), và cơ chế listener để giảm re-render.
 
-Phiên bản này xuất phát từ mã nguồn JS. Typings (.d.ts) được cung cấp trong `src/types/components.d.ts`.
-
 ---
 
 ## Cài đặt
@@ -80,6 +78,8 @@ export default Example;
 
 Bạn có thể lấy instance form để gọi phương thức chương trình như `submit`, `resetFields`, `setFieldValue`…
 
+`useForm` ưu tiên lấy instance từ provider gần nhất nếu không truyền `formName`, giúp bạn không cần truyền tên form khi đã bọc trong `Form`.
+
 Ví dụ sử dụng hook attached trên `Form`:
 
 ```jsx
@@ -87,7 +87,7 @@ import React from "react";
 import Form from "react-form-manage";
 
 function CtrlExample() {
-  const [form] = Form.useForm("myForm"); // hoặc useForm('myForm')
+  const [form] = Form.useForm(); // hoặc Form.useForm('myForm') khi muốn chỉ định form khác
 
   return (
     <div>
@@ -156,6 +156,10 @@ Custom validator (async):
 
 `FormList` là render-prop component cung cấp `listFields` và các action `add`, `remove`, `move`.
 
+Ghi chú:
+
+- `add()` nếu không truyền `index` sẽ tự động append phần tử mới vào cuối danh sách.
+
 Ví dụ:
 
 ```jsx
@@ -192,7 +196,7 @@ Lưu ý: `FormList` quản lý các `key` nội bộ và push các mục cần c
 
 ## Hooks (tóm tắt)
 
-- `useForm(formNameOrFormInstance)` — trả về form instance đã đăng ký.
+- `useForm(formNameOrFormInstance?)` — nếu không truyền thì lấy instance từ `Form` provider gần nhất; nếu truyền `formName` thì chọn form tương ứng.
 - `useWatch(name, formNameOrFormInstance)` — subscribe giá trị field.
 - `useSubmitDataWatch` — watch dữ liệu submit cuối cùng.
 - `useFormStateWatch` — watch state của form (isInitied, submitState…).

package/dist/components/Form/FormCleanUp.js

@@ -1,13 +1,13 @@
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { useShallow } from "zustand/react/shallow";
-import { useFormCleanUp, useFormListeners, useFormStore } from "../../stores/formStore";
+import { useFormStore } from "../../stores/formStore";
 const FormCleanUp = () => {
-  const { cleanUpStack, clearCleanUpStack } = useFormCleanUp(useShallow((state) => ({
+  const { cleanUpStack, clearCleanUpStack } = useFormStore(useShallow((state) => ({
     cleanUpStack: state.cleanUpStack,
     clearCleanUpStack: state.clearCleanUpStack
   })));
-  const { revokeListener } = useFormListeners(useShallow((state) => ({
+  const { revokeListener } = useFormStore(useShallow((state) => ({
     revokeListener: state.revokeListener
   })));
   const { clearObjKeyItem, clearArrItem } = useFormStore(useShallow((state) => {

package/dist/components/Form/FormItem.d.ts

@@ -1,7 +1,7 @@
 import type { ReactElement } from "react";
 import type { ValidationRule } from "../../types/public";
 export interface FormItemProps {
-    children: ReactElement;
+    children: ReactElement<any>;
     name: string;
     formName?: string;
     initialValue?: any;
@@ -9,5 +9,7 @@ export interface FormItemProps {
     rules?: ValidationRule[];
     valuePropName?: string;
     getValueFromEvent?: (...args: any[]) => any;
+    controlAfterInit?: boolean;
+    hidden?: boolean;
 }
-export default function FormItem({ children, name, formName, initialValue, formItemId: externalFormItemId, rules, valuePropName, getValueFromEvent, }: FormItemProps): ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+export default function FormItem({ children, name, formName, initialValue, formItemId: externalFormItemId, rules, valuePropName, getValueFromEvent, controlAfterInit, hidden, }: FormItemProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Form/FormItem.js

@@ -1,10 +1,11 @@
-import { cloneElement, useRef, useState } from "react";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cloneElement, Fragment, useRef, useState } from "react";
 import { v4 } from "uuid";
 import useFormItemControl from "../../hooks/useFormItemControl";
-function FormItem({ children, name, formName, initialValue, formItemId: externalFormItemId, rules, valuePropName = "value", getValueFromEvent }) {
+function FormItem({ children, name, formName, initialValue, formItemId: externalFormItemId, rules, valuePropName = "value", getValueFromEvent, controlAfterInit = false, hidden }) {
   const elRef = useRef(null);
   const [formItemId] = useState(externalFormItemId != null ? externalFormItemId : v4());
-  const { value, onChange, errors, state, onFocus, isDirty, submitState, isTouched } = useFormItemControl({
+  const { value, onChange, errors, state, onFocus, isDirty, submitState, isTouched, isInitied } = useFormItemControl({
     formName,
     name,
     initialValue,
@@ -12,7 +13,8 @@ function FormItem({ children, name, formName, initialValue, formItemId: external
     rules,
     elementRef: elRef
   });
-  return cloneElement(children, {
+  return _jsx(Fragment, { children: !hidden && children ? cloneElement(children, {
+    name,
     // ref: inputRef,
     [valuePropName]: value,
     onChange: (...args) => {
@@ -40,7 +42,7 @@ function FormItem({ children, name, formName, initialValue, formItemId: external
     ref: elRef,
     submitState,
     isTouched
-  });
+  }) : null }, `control-after-init-${Boolean(controlAfterInit && isInitied) ? "1" : "0"}-${formItemId}`);
 }
 export {
   FormItem as default

package/dist/components/Form/FormList.d.ts

@@ -8,7 +8,7 @@ export interface FormListProps<T = any> {
         name: string;
         key: string;
     }>, operations: {
-        add: (index: number) => void;
+        add: (index?: number) => void;
         remove: (opts: {
             index?: number;
             key?: string;
@@ -20,5 +20,5 @@ export interface FormListProps<T = any> {
         }) => void;
     }) => React.ReactNode;
 }
-declare const FormList: <T = any>({ name, initialValues, form, formName, children }: FormListProps<T>) => import("react").ReactNode;
+declare const FormList: <T = any>({ name, initialValues, form, formName, children, }: FormListProps<T>) => import("react").ReactNode;
 export default FormList;

package/dist/components/Form/FormList.js

@@ -1,6 +1,6 @@
-import useTestRrenderListControl from "../../hooks/useFormListControl";
+import useFormListControl from "../../hooks/useFormListControl";
 const FormList = ({ name, initialValues, form, formName, children }) => {
-  const { listFields, ...actions } = useTestRrenderListControl({
+  const { listFields, ...actions } = useFormListControl({
     name,
     initialValues,
     form,

package/dist/hooks/useFormItemControl.d.ts

@@ -20,6 +20,7 @@ export interface UseFormItemControlReturn {
     isDirty?: boolean;
     isTouched?: boolean;
     submitState?: SubmitState;
+    isInitied?: boolean;
 }
 export default function useFormItemControl<T = any>({ formName, form, name, initialValue, formItemId, rules, elementRef, }: UseFormItemControlProps): UseFormItemControlReturn;
 export {};

package/dist/hooks/useFormItemControl.js

@@ -1,26 +1,34 @@
-import { get, isNil } from "lodash";
+import { get, has, isNil } from "lodash";
 import { useTaskEffect } from "minh-custom-hooks-release";
 import { useEffect, useMemo } from "react";
 import { useShallow } from "zustand/react/shallow";
 import { IS_ALPHABET_STRING_AND_NUMBER_REGEX, IS_EMAIL_REGEX, IS_NAME_REGEX, IS_NO_SPACE_ALPHABET_STRING_AND_NUMBER_REGEX, IS_NO_SPACE_ALPHABET_STRING_REGEX, IS_NOSPACE_STRING_AND_NUMBER_REGEX, IS_PASSWORD_REGEX, IS_POSITIVE_INTEGER_STRING_NUMBER_REGEX, IS_POSITIVE_STRING_NUMBER_REGEX, IS_STRING_AND_NUMBER_REGEX, IS_STRING_NUMBER_REGEX, IS_USERNAME_REGEX, IS_VIETNAMESE_PHONE_NUMBER_REGEX } from "../constants/validation";
 import { useFormContext } from "../providers/Form";
-import { useFormCleanUp, useFormListeners, useFormStore } from "../stores/formStore";
+import { useFormStore } from "../stores/formStore";
 const VALID_PREMITIVE_TYPE = ["string", "number", "undefined"];
 function useFormItemControl({ formName, form, name, initialValue, formItemId, rules, elementRef }) {
   const contextForm = useFormContext();
-  const { value, setData, getCacheData, getFormValues, getFormState, isStateInitied, submitState } = useFormStore(useShallow((state2) => {
+  const {
+    value,
+    setData,
+    getCacheData,
+    getFormValues,
+    // getFormState,
+    isStateInitied,
+    submitState
+  } = useFormStore(useShallow((state2) => {
     var _a, _b, _c, _d;
     return {
       value: get(state2.forms, `${formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName)}.${name}`),
       setData: state2.setData,
       getCacheData: state2.getCacheData,
       getFormValues: state2.getFormValues,
-      getFormState: state2.getFormState,
+      // getFormState: state.getFormState,
       isStateInitied: (_b = (_a = state2.formStates) == null ? void 0 : _a[formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName)]) == null ? void 0 : _b.isInitied,
       submitState: (_d = (_c = state2.formStates) == null ? void 0 : _c[formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName)]) == null ? void 0 : _d.submitState
     };
   }));
-  const { setCleanUpStack } = useFormCleanUp(useShallow((state2) => ({
+  const { setCleanUpStack } = useFormStore(useShallow((state2) => ({
     setCleanUpStack: state2.setCleanUpStack
   })));
   const { initValue: internalInitValue, setInitData, getInitData } = useFormStore(useShallow((state2) => {
@@ -30,7 +38,7 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
       getInitData: state2.getInitData
     };
   }));
-  const { listener, setListener } = useFormListeners(useShallow((state2) => {
+  const { listener, setListener } = useFormStore(useShallow((state2) => {
     return {
       listener: state2.listeners.find((l) => l.formItemId === formItemId),
       setListener: state2.setListener
@@ -38,7 +46,7 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
   }));
   const onInitData = (value2) => {
     setInitData(formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName), name, value2);
-    onChange(value2, { notTriggerDirty: true });
+    onChange(value2, { notTriggerDirty: true, initiedData: true });
   };
   const onFocus = () => {
     setListener({
@@ -60,14 +68,27 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
         isTouched: listener == null ? void 0 : listener.isTouched
       });
     }
+    if ((options == null ? void 0 : options.initiedData) === true) {
+      setListener({
+        formItemId,
+        isInitied: true
+      });
+    }
     setData(formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName), name, value2);
   };
   const onReset = (value2) => {
-    onChange(isNil(value2) ? getInitData(formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName), name) : value2);
+    setListener({
+      formItemId,
+      isDirty: false,
+      isTouched: false
+    });
+    onChange(isNil(value2) ? getInitData(formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName), name) : value2, { notTriggerDirty: true, initiedData: true });
   };
   const internalRules = useMemo(() => {
     return rules || [];
   }, [rules]);
+  useEffect(() => {
+  }, [value, listener]);
   const { data: errors, state } = useTaskEffect({
     async task() {
       const listErrors = [];
@@ -250,7 +271,8 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
       setListener({ formItemId, internalErrors: listErrors });
       return listErrors;
     },
-    deps: [internalRules, value],
+    deps: [internalRules, value, listener == null ? void 0 : listener.isInitied],
+    enabled: Boolean(listener == null ? void 0 : listener.isInitied),
     onError(err) {
     }
   });
@@ -262,8 +284,16 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
             onInitData(initialValue);
           }
         } else {
-          onChange(internalInitValue, { notTriggerDirty: true });
+          onChange(internalInitValue, {
+            notTriggerDirty: true,
+            initiedData: true
+          });
         }
+      } else {
+        onChange(value, {
+          notTriggerDirty: true,
+          initiedData: true
+        });
       }
       return;
     }
@@ -281,6 +311,14 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
         onReset
       });
     }
+    return () => {
+      if (listener) {
+        setCleanUpStack({
+          name: listener.name,
+          itemKey: listener.formItemId
+        });
+      }
+    };
   }, []);
   useEffect(() => {
     if (listener) {
@@ -297,21 +335,19 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
     const cacheData = getCacheData(formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName));
     if (cacheData) {
       const getNewDataFromCache = get(cacheData, name);
-      if (!getNewDataFromCache) {
-        onChange(initialValue);
+      const isIncludeDirectoryInCache = has(cacheData, name);
+      if (!isIncludeDirectoryInCache && isNil(getNewDataFromCache)) {
+        onChange(initialValue, {
+          notTriggerDirty: true,
+          initiedData: true
+        });
       } else
-        onChange(getNewDataFromCache);
+        onChange(getNewDataFromCache, {
+          notTriggerDirty: true,
+          initiedData: true
+        });
     }
   }, [name, formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName)]);
-  useEffect(() => {
-    return () => {
-      setCleanUpStack({
-        itemKey: formItemId
-      });
-    };
-  }, []);
-  useEffect(() => {
-  }, [submitState]);
   return {
     value,
     onChange,
@@ -320,7 +356,8 @@ function useFormItemControl({ formName, form, name, initialValue, formItemId, ru
     onFocus,
     isDirty: listener == null ? void 0 : listener.isDirty,
     isTouched: listener == null ? void 0 : listener.isTouched,
-    submitState
+    submitState,
+    isInitied: listener == null ? void 0 : listener.isInitied
   };
 }
 export {

package/dist/hooks/useFormListControl.d.ts

@@ -2,6 +2,7 @@ import type { FormInstance } from "../stores/formStore";
 type ListField = {
     name: string;
     key: string;
+    value?: any;
 };
 interface UseFormListControlProps {
     name?: string;
@@ -16,7 +17,7 @@ interface UseFormListControlReturn {
         fromKey?: string;
         to: number;
     }) => void;
-    add: (index: number) => void;
+    add: (index?: number) => void;
     remove: (opts: {
         index?: number;
         key?: string;

package/dist/hooks/useFormListControl.js

@@ -3,17 +3,22 @@ import { useEffect, useState } from "react";
 import { v4 } from "uuid";
 import { useShallow } from "zustand/react/shallow";
 import { useFormContext } from "../providers/Form";
-import { useFormCleanUp, useFormStore } from "../stores/formStore";
+import { useFormStore } from "../stores/formStore";
 function useFormListControl({ name, form, initialValues, formName }) {
+  const [formItemId] = useState(v4());
   const contextForm = useFormContext();
   const getFormValues = useFormStore((state) => state.getFormValues);
   const [listFormInitValues, setListFormInitValues] = useState(void 0);
-  const { clearCacheData, setCacheData } = useFormStore(useShallow((state) => ({
+  const { clearCacheData, setCacheData, setListener, getListener } = useFormStore(useShallow((state) => ({
+    // Cache
     cacheData: state.cacheData,
     clearCacheData: state.clearCacheData,
-    setCacheData: state.setCacheData
+    setCacheData: state.setCacheData,
+    // Listener
+    setListener: state.setListener,
+    getListener: state.getListener
   })));
-  const { setCleanUpStack } = useFormCleanUp(useShallow((state) => ({
+  const { setCleanUpStack } = useFormStore(useShallow((state) => ({
     setCleanUpStack: state.setCleanUpStack
   })));
   const { initValue: internalInitValue, formState } = useFormStore(useShallow((state) => {
@@ -37,7 +42,16 @@ function useFormListControl({ name, form, initialValues, formName }) {
         value: d
       };
     }).filter(Boolean);
-    const mapCurWithKey = cur.map((c) => mapPrevWithKey.find((m) => m.key === c.key) || c);
+    const mapCurWithKey = cur.map((c) => {
+      const find = mapPrevWithKey.find((m) => m.key === c.key);
+      if (find) {
+        return {
+          key: find.key,
+          value: isNil(c.value) ? find.value : c.value
+        };
+      }
+      return c;
+    });
     const getNewValueCache = mapCurWithKey.filter(Boolean).map((c) => c.value);
     const startRemoveIndex = formDataBeforeChange.length - getNewValueCache.length;
     if (startRemoveIndex > 0) {
@@ -55,11 +69,7 @@ function useFormListControl({ name, form, initialValues, formName }) {
   };
   const add = (index) => {
     setListFields((prev) => {
-      if (index > prev.length)
-        return prev;
-      if (index < 0)
-        return prev;
-      if (index === prev.length) {
+      if (isNil(index) || index === prev.length) {
         const newName = `${name}.${prev.length}`;
         const newKey = v4();
         const result2 = [
@@ -71,6 +81,10 @@ function useFormListControl({ name, form, initialValues, formName }) {
         ];
         return result2;
       }
+      if (index > prev.length)
+        return prev;
+      if (index < 0)
+        return prev;
       const clonePrev = [...prev];
       const result = clonePrev.reduce((prev2, cur, curIndex) => {
         const newKey = v4();
@@ -218,6 +232,42 @@ function useFormListControl({ name, form, initialValues, formName }) {
       clearCacheData();
     };
   }, [listFields]);
+  useEffect(() => {
+    if (!getListener(formItemId)) {
+      setListener({
+        formName: formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName),
+        name: name || "",
+        formItemId,
+        type: "array",
+        onArrayChange: (newArr) => {
+          setListFields((prev) => {
+            const result = newArr.map((_, i) => {
+              const itemName = `${name}.${i}`;
+              const existingItem = prev[i];
+              return {
+                key: existingItem ? existingItem.key : v4(),
+                name: itemName
+              };
+            });
+            handleCacheListField(prev, result.map((r, i) => {
+              return { ...r, value: newArr[i] };
+            }));
+            return result;
+          });
+        }
+      });
+    }
+    return () => {
+      if (getListener(formItemId)) {
+        setListener({
+          formName: formName || (form == null ? void 0 : form.formName) || (contextForm == null ? void 0 : contextForm.formName),
+          name: name || "",
+          formItemId,
+          onArrayChange: void 0
+        });
+      }
+    };
+  }, []);
   return { listFields, move, add, remove };
 }
 export {

package/dist/index.cjs.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import Form, { useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type ValidationRule, type FormFieldError, type SubmitState } from "./providers/Form";
 import { SUBMIT_STATE } from "./constants/form";
+import Form, { useForm, useFormStateWatch, useSubmitDataWatch, useWatch, type FormFieldError, type FormProps, type SubmitState, type UseFormItemStateWatchReturn, type ValidationRule } from "./providers/Form";
 import FormItem, { type FormItemProps } from "./components/Form/FormItem";
 import FormList, { type FormListProps } from "./components/Form/FormList";
-import Input from "./components/Input";
 import InputWrapper, { type InputWrapperProps } from "./components/Form/InputWrapper";
+import Input from "./components/Input";
 import useFormItemControl from "./hooks/useFormItemControl";
 import useFormListControl from "./hooks/useFormListControl";
-export { Form, FormItem, FormList, Input, InputWrapper, useFormItemControl, useFormListControl, useForm, useWatch, useSubmitDataWatch, useFormStateWatch, type FormProps, type FormItemProps, type FormListProps, type InputWrapperProps, type ValidationRule, type FormFieldError, type SubmitState, SUBMIT_STATE, };
+import { useFormStore, type CleanUpItem, type FormInstance, type ListenerItem } from "./stores/formStore";
+export { Form, FormItem, FormList, Input, InputWrapper, SUBMIT_STATE, useForm, useFormItemControl, useFormListControl, useFormStateWatch, useFormStore, useSubmitDataWatch, useWatch, type CleanUpItem, type FormFieldError, type FormInstance, type FormItemProps, type FormListProps, type FormProps, type InputWrapperProps, type ListenerItem, type SubmitState, type UseFormItemStateWatchReturn, type ValidationRule, };
 export default Form;

package/dist/index.esm.d.ts

@@ -0,0 +1 @@
+export * from "./index";

package/dist/index.js

@@ -1,11 +1,12 @@
-import Form, { useForm, useWatch, useSubmitDataWatch, useFormStateWatch } from "./providers/Form";
 import { SUBMIT_STATE } from "./constants/form";
+import Form, { useForm, useFormStateWatch, useSubmitDataWatch, useWatch } from "./providers/Form";
 import FormItem from "./components/Form/FormItem";
 import FormList from "./components/Form/FormList";
-import Input from "./components/Input";
 import InputWrapper from "./components/Form/InputWrapper";
+import Input from "./components/Input";
 import useFormItemControl from "./hooks/useFormItemControl";
 import useFormListControl from "./hooks/useFormListControl";
+import { useFormStore } from "./stores/formStore";
 var stdin_default = Form;
 export {
   Form,
@@ -19,6 +20,7 @@ export {
   useFormItemControl,
   useFormListControl,
   useFormStateWatch,
+  useFormStore,
   useSubmitDataWatch,
   useWatch
 };

package/dist/providers/Form.d.ts

@@ -1,6 +1,6 @@
 import type { ComponentType, FormHTMLAttributes, ReactNode } from "react";
-import type { PublicFormInstance } from "../types/public";
-export type { ValidationRule, FormFieldError, SubmitState } from "../types/public";
+import type { PublicFormInstance, UseFormItemStateWatchReturn } from "../types/public";
+export type { FormFieldError, SubmitState, UseFormItemStateWatchReturn, ValidationRule, } from "../types/public";
 export declare const FormContext: import("react").Context<any>;
 export interface FormProps<T = any> extends Omit<FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
     children: ReactNode;
@@ -21,6 +21,7 @@ declare namespace Form {
     var useWatch: typeof import("./Form").useWatch;
     var useSubmitDataWatch: typeof import("./Form").useSubmitDataWatch;
     var useFormStateWatch: <T = any>(formNameOrFormInstance?: string | PublicFormInstance<T>) => any;
+    var useFormItemStateWatch: <T = any>(nameOrFormItemId: string, formNameOrFormInstance?: string | PublicFormInstance<T>) => UseFormItemStateWatchReturn;
 }
 export default Form;
 export declare function useFormContext(): any;
@@ -32,3 +33,4 @@ export declare function useSubmitDataWatch<T = any>({ formNameOrFormInstance, tr
     mapFn?: (v: any, prev: any) => any;
 }): T | undefined;
 export declare const useFormStateWatch: <T = any>(formNameOrFormInstance?: string | PublicFormInstance<T>) => any;
+export declare const useFormItemStateWatch: <T = any>(nameOrFormItemId: string, formNameOrFormInstance?: string | PublicFormInstance<T>) => UseFormItemStateWatchReturn;