react-form-manage 1.1.0-beta.4 → 1.1.0-beta.5

package/CHANGELOG.md

@@ -2,6 +2,30 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.1.0-beta.5] - 2026-03-09
+
+### Type Improvements
+
+- **Enhanced Submit Methods**: Updated `submit` and `submitAsync` method signatures
+  - Changed from `submit(values?: T)` to `submit(props?: SubmitProps<T>)`
+  - Changed from `submitAsync(values?: T)` to `submitAsync(props?: SubmitProps<T>)`
+  - Now supports external callback functions for better submit flow control
+
+### New Features
+
+- **SubmitProps Interface**: New interface for submit method parameters
+  - `externalFinishCallback`: Called when form validation succeeds with form values
+  - `externalRejectCallback`: Called when form validation fails with error fields
+  - `externalFinallyCallback`: Called after submit completes with complete result info
+  - All callbacks support both synchronous and asynchronous execution
+
+### Technical Details
+
+- `SubmitProps<T>` interface exported from formStore
+- Allows programmatic submit with custom callbacks without requiring Form component props
+- Better separation of concerns between form state and submit handlers
+- Enables more flexible submit workflows (e.g., submit via form instance methods)
+
 ## [1.1.0-beta.4] - 2026-03-04
 
 ### Performance & Code Quality

package/dist/test/TestMuiReRender/TestModalReRenderUI.d.ts

@@ -0,0 +1,3 @@
+type Props = {};
+declare function TestModalReRenderUI({}: Props): import("react/jsx-runtime").JSX.Element;
+export default TestModalReRenderUI;

package/dist/test/TestMuiReRender/TestModalReRenderUI.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Dialog, DialogContent } from "@mui/material";
+import { Button } from "antd";
+import { useToggle } from "minh-custom-hooks-release";
+import TestMuiReRenderForm from "./TestMuiReRenderForm";
+function TestModalReRenderUI({}) {
+  const { state, on, off } = useToggle();
+  return _jsxs("div", { children: [_jsx(Button, { onClick: on, children: "Open Modal" }), _jsx(Dialog, { open: state, onClose: off, children: _jsx(DialogContent, { children: _jsx(TestMuiReRenderForm, {}) }) })] });
+}
+var stdin_default = TestModalReRenderUI;
+export {
+  stdin_default as default
+};

package/dist/test/TestMuiReRender/TestMuiReRenderForm.d.ts

@@ -0,0 +1,3 @@
+type Props = {};
+declare function TestMuiReRenderForm({}: Props): import("react/jsx-runtime").JSX.Element;
+export default TestMuiReRenderForm;

package/dist/test/TestMuiReRender/TestMuiReRenderForm.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { TextField } from "@mui/material";
+import { useEffect } from "react";
+import Form from "../../providers/Form";
+function TestMuiReRenderForm({}) {
+  const [form, isMounted] = Form.useForm("testMuiReRender");
+  const name = Form.useWatch("name", form);
+  useEffect(() => {
+    if (isMounted) {
+      form.setFieldValue("name", "John Doe");
+    }
+  }, [isMounted]);
+  useEffect(() => {
+    if (name) {
+      setTimeout(() => {
+        form.setFieldValue("name2", "Hello " + name);
+      }, 1e3);
+    }
+  }, [name]);
+  return _jsxs(Form, { formName: "testMuiReRender", children: [_jsx(Form.Item, { controlAfterInit: true, initialValue: "", name: "name", children: _jsx(TextField, { label: "Name", disabled: true }) }), _jsx(Form.Item, { controlAfterInit: true, initialValue: "", name: "name2", children: _jsx(TextField, { label: "Greeting", disabled: true }) })] });
+}
+var stdin_default = TestMuiReRenderForm;
+export {
+  stdin_default as default
+};

package/dist/test/TestMuiReRender/index.d.ts

@@ -0,0 +1,3 @@
+type Props = {};
+declare function TestMuiReRender({}: Props): import("react/jsx-runtime").JSX.Element;
+export default TestMuiReRender;

package/dist/test/TestMuiReRender/index.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import TestModalReRenderUI from "./TestModalReRenderUI";
+function TestMuiReRender({}) {
+  return _jsx(TestModalReRenderUI, {});
+}
+var stdin_default = TestMuiReRender;
+export {
+  stdin_default as default
+};

package/dist/types/public.d.ts

@@ -1,6 +1,7 @@
 import type { SUBMIT_STATE } from "../constants/form";
 import { OnChangeOptions } from "../hooks/useFormItemControl";
 import { SetFieldValueOptions } from "../providers/Form";
+import { SubmitProps } from "../stores/formStore";
 import type { GetConstantType } from "./util";
 export type FormValues<T = any> = T;
 export interface FormFieldError {
@@ -34,8 +35,8 @@ export interface ValidationRule<T = any, TValues = any> {
 export interface PublicFormInstance<T = any> {
     formName: string;
     resetFields: (values?: Partial<T>) => void;
-    submit: (values?: T) => void;
-    submitAsync: (values?: T) => Promise<void>;
+    submit: (props?: SubmitProps<T>) => void;
+    submitAsync: (props?: SubmitProps<T>) => Promise<void>;
     setFieldValue: (name: keyof T | (string & {}), value: any, options?: SetFieldValueOptions) => void;
     setFieldValues: (values: Partial<T>, options?: OnChangeOptions) => void;
     getFieldValue: (name: keyof T | (string & {})) => any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-form-manage",
-  "version": "1.1.0-beta.4",
+  "version": "1.1.0-beta.5",
   "description": "Lightweight React form management with list and listener support.",
   "license": "MIT",
   "type": "module",

package/src/App.tsx

@@ -1,7 +1,7 @@
 import Form from "./providers/Form";
 
 import { Form as AntdForm } from "antd";
-import SelfTestGetForm from "./test/SelfTestGetForm";
+import TestMuiReRender from "./test/TestMuiReRender";
 
 function TestFormWatch() {
   const watchValue = Form.useWatch("numericCode");
@@ -48,7 +48,9 @@ const App = () => {
 
       {/* <FormInstanceTestSuite /> */}
 
-      <SelfTestGetForm />
+      {/* <SelfTestGetForm /> */}
+
+      <TestMuiReRender />
     </div>
   );
 };

package/src/test/TestMuiReRender/TestModalReRenderUI.tsx

@@ -0,0 +1,22 @@
+import { Dialog, DialogContent } from "@mui/material";
+import { Button } from "antd";
+import { useToggle } from "minh-custom-hooks-release";
+import TestMuiReRenderForm from "./TestMuiReRenderForm";
+
+type Props = {};
+
+function TestModalReRenderUI({}: Props) {
+  const { state, on, off } = useToggle();
+  return (
+    <div>
+      <Button onClick={on}>Open Modal</Button>
+      <Dialog open={state} onClose={off}>
+        <DialogContent>
+          <TestMuiReRenderForm />
+        </DialogContent>
+      </Dialog>
+    </div>
+  );
+}
+
+export default TestModalReRenderUI;

package/src/test/TestMuiReRender/TestMuiReRenderForm.tsx

@@ -0,0 +1,37 @@
+import { TextField } from "@mui/material";
+import { useEffect } from "react";
+import Form from "../../providers/Form";
+
+type Props = {};
+
+function TestMuiReRenderForm({}: Props) {
+  const [form, isMounted] = Form.useForm("testMuiReRender");
+  const name = Form.useWatch("name", form);
+
+  useEffect(() => {
+    if (isMounted) {
+      form.setFieldValue("name", "John Doe");
+    }
+  }, [isMounted]);
+
+  useEffect(() => {
+    if (name) {
+      setTimeout(() => {
+        form.setFieldValue("name2", "Hello " + name);
+      }, 1000);
+    }
+  }, [name]);
+  return (
+    <Form formName="testMuiReRender">
+      <Form.Item controlAfterInit initialValue={""} name="name">
+        <TextField label="Name" disabled />
+      </Form.Item>
+
+      <Form.Item controlAfterInit initialValue={""} name="name2">
+        <TextField label="Greeting" disabled />
+      </Form.Item>
+    </Form>
+  );
+}
+
+export default TestMuiReRenderForm;

package/src/test/TestMuiReRender/index.tsx

@@ -0,0 +1,9 @@
+import TestModalReRenderUI from "./TestModalReRenderUI";
+
+type Props = {};
+
+function TestMuiReRender({}: Props) {
+  return <TestModalReRenderUI />;
+}
+
+export default TestMuiReRender;

package/src/types/public.ts

@@ -1,6 +1,7 @@
 import type { SUBMIT_STATE } from "../constants/form";
 import { OnChangeOptions } from "../hooks/useFormItemControl";
 import { SetFieldValueOptions } from "../providers/Form";
+import { SubmitProps } from "../stores/formStore";
 import type { GetConstantType } from "./util";
 
 export type FormValues<T = any> = T;
@@ -38,8 +39,8 @@ export interface ValidationRule<T = any, TValues = any> {
 export interface PublicFormInstance<T = any> {
   formName: string;
   resetFields: (values?: Partial<T>) => void;
-  submit: (values?: T) => void;
-  submitAsync: (values?: T) => Promise<void>;
+  submit: (props?: SubmitProps<T>) => void;
+  submitAsync: (props?: SubmitProps<T>) => Promise<void>;
   setFieldValue: (
     name: keyof T | (string & {}),
     value: any,