feat: add the registerEffect method to the FormStore and InternalFieldHooks interfaces, and implement the useEffectField hook to support the effect registration functionality.

Author: Ohh-889

primitives/filed-form /src/form-core/createStore.ts

@@ -1337,6 +1337,7 @@ class FormStore {
       getArrayFields: this.getArrayFields,
       getInitialValue: this.getInitialValue,
       registerComputed: this.registerComputed,
+      registerEffect: this.registerEffect,
       registerField: this.registerField,
       setCallbacks: this.setCallbacks,
       setFieldRules: this.setFieldRules,

primitives/filed-form /src/react/hooks/FieldContext.ts

@@ -130,6 +130,10 @@ export interface InternalFieldHooks<Values = any> {
     deps: AllPathsKeys<Values>[],
     compute: (get: (n: AllPathsKeys<Values>) => any, all: Values) => PathToDeepType<Values, T>
   ) => () => void;
+  registerEffect: (
+    deps: AllPathsKeys<Values>[],
+    effect: (get: (n: AllPathsKeys<Values>) => any, all: Values) => void
+  ) => () => void;
   registerField: (entity: FieldEntity) => () => void;
   setFieldRules: (name: AllPathsKeys<Values>, rules?: Rule[]) => void;
   setRules: (name: AllPathsKeys<Values>, rules?: Rule[]) => void;

primitives/filed-form /src/react/hooks/useFieldArray.ts

@@ -11,15 +11,15 @@ export type ArrayFieldItem = {
 };
 
 export function useArrayField<Values = any>(name: ArrayKeys<Values>, form?: FormInstance<Values>) {
-  const context = useFieldContext();
+  const contextForm = useFieldContext();
 
-  const fieldContext = form ?? context;
+  const formInstance = form ?? contextForm;
 
-  if (!fieldContext) {
+  if (!formInstance) {
     throw new Error('Can not find FormContext. Please make sure you wrap Field under Form or provide a form instance.');
   }
 
-  const { arrayOp } = fieldContext as unknown as InternalFormInstance<Values>;
+  const { arrayOp } = formInstance as unknown as InternalFormInstance<Values>;
 
   return arrayOp(name);
 }

primitives/filed-form /src/react/hooks/useFieldEffect.ts

@@ -0,0 +1,28 @@
+import { useEffect } from 'react';
+import type { AllPathsKeys } from 'skyroc-type-utils';
+
+import type { FormInstance, InternalFormInstance } from './FieldContext';
+import { useFieldContext } from './FieldContext';
+
+export function useEffectField<Values = any>(
+  deps: AllPathsKeys<Values>[],
+  effect: (get: (n: AllPathsKeys<Values>) => any, all: Values) => void,
+  form?: FormInstance<Values>
+) {
+  const contextForm = useFieldContext<Values>();
+
+  const formInstance = form ?? contextForm;
+
+  if (!formInstance) {
+    throw new Error('Can not find FormContext. Please make sure you wrap Field under Form or provide a form instance.');
+  }
+
+  const { getInternalHooks } = formInstance as unknown as InternalFormInstance<Values>;
+
+  const { registerEffect } = getInternalHooks();
+
+  useEffect(() => {
+    const unregister = registerEffect(deps, effect);
+    return unregister;
+  }, [deps]);
+}