@unicom-cloud/ui 0.8.157 → 0.8.158

package/form/FormItem.js

@@ -1,35 +1,35 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
-import { isArray as e, isFunction as t, isPlainObject as n, isUndefined as r } from "../utils/is.js";
-import i from "../utils/className.js";
-import a from "../hooks/use-merge-props/index.js";
-import ee from "../config-provider/context.js";
-import { FormContext as o, FormItemContext as s, FormListContext as te } from "./context.js";
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
+import { isArray as e, isFunction as t, isObject as n, isPlainObject as r, isUndefined as i } from "../utils/is.js";
+import a from "../utils/className.js";
+import ee from "../hooks/use-merge-props/index.js";
+import te from "../config-provider/context.js";
+import { FormContext as o, FormItemContext as s, FormListContext as ne } from "./context.js";
 import c from "../utils/omit.js";
 import "../config-provider/index.js";
-import { PREFIX_FORM_ITEM as ne } from "./constant.js";
+import { PREFIX_FORM_ITEM as re } from "./constant.js";
 import { VALIDATE_STATUS as l } from "./interface.js";
-import { formatValidateMsg as re } from "./utils.js";
+import { formatValidateMsg as ie } from "./utils.js";
 import u from "./FormControl.js";
 import d from "../row-col/Col.js";
-import ie from "../row-col/index.js";
-import ae from "./FormItemLabel.js";
-import oe from "./FormItemTip.js";
-import f, { cloneElement as p, createElement as m, forwardRef as h, useContext as g, useEffect as se, useMemo as ce, useRef as le, useState as _ } from "react";
+import ae from "../row-col/index.js";
+import oe from "./FormItemLabel.js";
+import se from "./FormItemTip.js";
+import f, { cloneElement as p, createElement as m, forwardRef as h, useContext as g, useEffect as ce, useMemo as le, useRef as ue, useState as _ } from "react";
 import { jsx as v, jsxs as y } from "react/jsx-runtime";
 //#region components/pc/form/FormItem.tsx
-var ue = {
+var de = {
 	trigger: "onChange",
 	triggerPropName: "value"
 };
 function b(h, b) {
-	let { prefixCls: x, getPrefixCls: S } = g(ee), C = g(o), w = g(te), T = g(s), E = a(h, ue, {
-		hidden: w?.hidden,
-		readOnly: T?.readOnly ?? C?.readOnly
-	}), { noStyle: D, readOnly: O } = E, { label: k, extra: A, className: de, style: fe, validateStatus: j, hidden: pe, tooltip: me, requiredSymbol: he, colon: ge, rules: _e, required: ve, ...M } = E, N = "requiredSymbol" in E ? he : T?.requiredSymbol ?? C?.requiredSymbol, P = "colon" in E ? ge : T?.colon || C?.colon, F = "label" in E && !!k;
+	let { prefixCls: x, getPrefixCls: S } = g(te), C = g(o), fe = g(ne), w = g(s), T = ee(h, de, {
+		hidden: fe?.hidden,
+		readOnly: w?.readOnly ?? C?.readOnly
+	}), { noStyle: E, readOnly: D } = T, { label: O, extra: k, className: pe, style: me, validateStatus: A, hidden: he, tooltip: ge, requiredSymbol: _e, colon: ve, rules: j, required: M, ...N } = T, P = "requiredSymbol" in T ? _e : w?.requiredSymbol ?? C?.requiredSymbol, ye = "colon" in T ? ve : w?.colon || C?.colon, F = "label" in T && !!O;
 	function I() {
-		return "disabled" in E ? E.disabled : T?.disabled ?? C?.disabled;
+		return "disabled" in T ? T.disabled : w?.disabled ?? C?.disabled;
 	}
-	let [L, R] = _(null), [z, B] = _(null), V = le(!1), H = C?.prefixCls || S?.("form"), U = T?.prefixCls || S?.(ne), W = E.layout || T?.layout || C?.layout, ye = E.labelAlign || T?.labelAlign || C?.labelAlign, G = E.rowProps || T?.rowProps || C?.rowProps, K = E.labelCol || C?.labelCol, q = E.wrapperCol || C?.wrapperCol, J = !K, be = !q, xe = W === "horizontal", Se = ye === "left", Ce = n(D) && D.showErrorTip && T?.updateFormItem ? T.updateFormItem : (e, t = {}) => {
+	let [L, R] = _(null), [z, B] = _(null), V = ue(!1), H = C?.prefixCls || S?.("form"), U = w?.prefixCls || S?.(re), W = T.layout || w?.layout || C?.layout, be = T.labelAlign || w?.labelAlign || C?.labelAlign, G = T.rowProps || w?.rowProps || C?.rowProps, K = T.labelCol || C?.labelCol, q = T.wrapperCol || C?.wrapperCol, xe = !K, Se = !q, Ce = W === "horizontal", we = be === "left", Te = (e, t = {}) => {
 		if (V.current) return;
 		let { errors: n, warnings: r } = t || {};
 		R((t) => {
@@ -40,78 +40,76 @@ function b(h, b) {
 			return r?.length ? n[e] = r : delete n[e], n;
 		});
 	};
-	se(() => (V.current = !1, () => {
+	ce(() => (V.current = !1, () => {
 		V.current = !0, R(null), B(null);
 	}), []);
-	let we = {
+	let J = {
 		...C,
-		...E,
-		validateMessages: re(C?.validateMessages, { label: E.label }),
+		...T,
+		validateMessages: ie(C?.validateMessages, { label: T.label }),
 		prefixCls: U,
-		updateFormItem: Ce,
+		updateFormItem: n(E) && E.showErrorTip && w?.updateFormItem ? w.updateFormItem : Te,
 		disabled: I(),
-		readOnly: O
-	}, Y = L ? Object.values(L) : [], X = z ? Object.values(z).reduce((e, t) => e.concat(t), []) : [], Z = ce(() => {
-		if (j) return j;
+		readOnly: D
+	}, Y = L ? Object.values(L) : [], X = z ? Object.values(z).reduce((e, t) => e.concat(t), []) : [], Z = le(() => {
+		if (A) return A;
 		if (Y.length) return l.error;
 		if (X.length) return l.warning;
 	}, [
 		L,
 		z,
-		j
-	]), Q = !r(E.help) || X.length > 0;
-	function Te() {
-		let { field: i, children: a } = E;
+		A
+	]), Q = !i(T.help) || X.length > 0;
+	function Ee() {
+		let { field: n, children: a } = T;
 		if (t(a)) {
-			let { key: e, ...t } = E ?? {};
+			let { key: e, ...t } = T ?? {};
 			return /* @__PURE__ */ m(u, {
 				disabled: I(),
 				...t,
-				key: i || e,
-				_key: i || e
+				key: n || e
 			}, (...e) => a(...e));
 		}
 		if (e(a)) {
 			let e = f.Children.map(a, (e, t) => {
-				if (n(e)) {
-					let n = e.key || t, i = "disabled" in e.props, a = { key: n };
-					return r(I()) || i || (a.disabled = I()), p(e, a);
+				if (r(e)) {
+					let n = e.key || t, r = "disabled" in e.props, a = { key: n };
+					return i(I()) || r || (a.disabled = I()), p(e, a);
 				}
 				return e;
 			});
 			return /* @__PURE__ */ v(u, {
-				...E,
+				...T,
 				field: void 0,
 				children: e
-			});
+			}, n);
 		}
 		if (f.Children.count(a) == 1) {
-			if (i) {
-				let e = w?.getItemKey?.(i) || i;
+			if (n) {
+				let e = n;
 				return /* @__PURE__ */ m(u, {
 					disabled: I(),
-					...E,
-					key: e,
-					_key: e
+					...T,
+					key: e
 				}, a);
 			}
-			if (n(a)) {
+			if (r(a)) {
 				if (a.type?.isFormControl) return a;
-				let e = !("disabled" in a.props) && r(I()) ? null : { disabled: I() };
+				let e = !("disabled" in a.props) && i(I()) ? null : { disabled: I() };
 				return /* @__PURE__ */ v(u, {
-					...E,
+					...T,
 					field: void 0,
 					children: e ? p(a, e) : a
-				});
+				}, n);
 			}
 		}
 		return a;
 	}
-	let $ = Te();
-	return D || ($ = /* @__PURE__ */ y(ie, {
+	let $ = Ee();
+	return E || ($ = /* @__PURE__ */ y(ae, {
 		ref: b,
 		...G,
-		...c(M, [
+		...c(N, [
 			"children",
 			"prefixCls",
 			"store",
@@ -138,52 +136,52 @@ function b(h, b) {
 		]),
 		style: {
 			...G?.style,
-			...fe
+			...me
 		},
-		className: i(U, {
-			[`${U}-error`]: Q || !j && Z === l.error,
+		className: a(U, {
+			[`${U}-error`]: Q || !A && Z === l.error,
 			[`${U}-status-${Z}`]: Z,
 			[`${U}-has-help`]: Q,
-			[`${U}-hidden`]: pe,
-			[`${U}-has-feedback`]: Z && E.hasFeedback
-		}, `${U}-${W}`, `${U}-layout-${W}`, k ? `${U}-has-label` : `${U}-no-label`, G?.className, de),
-		div: !xe,
+			[`${U}-hidden`]: he,
+			[`${U}-has-feedback`]: Z && T.hasFeedback
+		}, `${U}-${W}`, `${U}-layout-${W}`, O ? `${U}-has-label` : `${U}-no-label`, G?.className, pe),
+		div: !Ce,
 		children: [F && /* @__PURE__ */ v(d, {
-			className: i(`${H}-label-item`, `${U}-label`, E.labelCol?.className, C?.labelCol?.className, Se && `${U}-label-left`, J && `${U}-label-flex`),
+			className: a(`${H}-label-item`, `${U}-label`, T.labelCol?.className, C?.labelCol?.className, we && `${U}-label-left`, xe && `${U}-label-flex`),
 			...K ?? { flex: 0 },
-			children: /* @__PURE__ */ v(ae, {
-				className: i(`${U}-label-label`),
-				tooltip: me,
-				htmlFor: E.field && C?.getFormElementId?.(E.field),
-				label: k,
+			children: /* @__PURE__ */ v(oe, {
+				className: a(`${U}-label-label`),
+				tooltip: ge,
+				htmlFor: T.field && C?.getFormElementId?.(T.field),
+				label: O,
 				prefix: U,
-				requiredSymbol: N,
-				required: ve,
-				rules: _e,
-				showColon: P,
-				readOnly: O
+				requiredSymbol: P,
+				required: M,
+				rules: j,
+				showColon: ye,
+				readOnly: D
 			})
 		}), /* @__PURE__ */ y(d, {
-			className: i(`${U}-wrapper`, { [`${U}-wrapper-flex`]: be }, F ? `${U}-wrapper-has-label` : `${U}-wrapper-no-label`),
+			className: a(`${U}-wrapper`, { [`${U}-wrapper-flex`]: Se }, F ? `${U}-wrapper-has-label` : `${U}-wrapper-no-label`),
 			...q || { flex: 1 },
 			children: [
 				$,
-				/* @__PURE__ */ v(oe, {
+				/* @__PURE__ */ v(se, {
 					prefixCls: H,
-					help: E.help,
+					help: T.help,
 					errors: Y,
 					warnings: X
 				}),
-				A && /* @__PURE__ */ v("div", {
+				k && /* @__PURE__ */ v("div", {
 					className: `${H}-extra`,
-					children: A
+					children: k
 				})
 			]
 		})]
 	})), $ = /* @__PURE__ */ v(o.Provider, {
-		value: D ? C : c(C, ["labelCol", "wrapperCol"]),
+		value: E ? C : c(C, ["labelCol", "wrapperCol"]),
 		children: /* @__PURE__ */ v(s.Provider, {
-			value: we,
+			value: J,
 			children: $
 		})
 	}), $;

package/form/FormItemLabel.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isPlainObject as e } from "../utils/is.js";
 import t from "../utils/className.js";
 import n from "../config-provider/context.js";
@@ -6,13 +6,13 @@ import "../config-provider/index.js";
 import r from "../tooltip/index.js";
 import { isRequiredRule as i } from "./utils.js";
 import a from "./FormLabelSymbol.js";
-import o, { isValidElement as s, useContext as c } from "react";
+import { Fragment as o, isValidElement as s, useContext as c } from "react";
 import { jsx as l } from "react/jsx-runtime";
 import u from "@unicom-cloud/icons/IconUiQuestionCircleFill";
 //#region components/pc/form/FormItemLabel.tsx
 function d(d) {
 	let { prefixCls: f, getPrefixCls: p } = c(n), { htmlFor: m, showColon: h, label: g, requiredSymbol: _, required: v, rules: y, prefix: b, tooltip: x, readOnly: S } = d, C = [];
-	if (g && C.push(/* @__PURE__ */ l(o.Fragment, { children: g }, "label")), x) {
+	if (g && C.push(/* @__PURE__ */ l(o, { children: g }, "label")), x) {
 		let t = {}, n = /* @__PURE__ */ l(u, {});
 		if (!e(x) || s(x)) t = { content: x };
 		else {
@@ -35,7 +35,7 @@ function d(d) {
 		}, "symbol");
 		n ? C.push(r) : C.unshift(r);
 	}
-	h && (h === !0 ? C.push(/* @__PURE__ */ l("span", { children: ":" }, "colon")) : C.push(/* @__PURE__ */ l(o.Fragment, { children: h }, "colon")));
+	h && (h === !0 ? C.push(/* @__PURE__ */ l("span", { children: ":" }, "colon")) : C.push(/* @__PURE__ */ l(o, { children: h }, "colon")));
 	let w;
 	return C.length && (w = /* @__PURE__ */ l("label", {
 		className: t(`${b}-label-element`, d.className),

package/form/FormItemTip.js

@@ -1,39 +1,39 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isUndefined as e } from "../utils/is.js";
 import t from "../utils/className.js";
-import { forwardRef as n, useImperativeHandle as r, useRef as i } from "react";
-import { UI_COMMON_PREFIX as a } from "@unicom-cloud/utils/constant/ui";
-import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
-import l from "@unicom-cloud/ui-common/transition/TransitionCSS";
+import { TransitionCSS as n } from "../transition/index.js";
+import { forwardRef as r, useImperativeHandle as i, useRef as a } from "react";
+import { UI_COMMON_PREFIX as o } from "@unicom-cloud/utils/constant/ui";
+import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";
 //#region components/pc/form/FormItemTip.tsx
-function u(n, u) {
-	let { prefixCls: d, help: f, errors: p, warnings: m } = n, h = p.map((e, t) => {
-		if (e) return /* @__PURE__ */ s("div", {
+function u(r, u) {
+	let { prefixCls: d, help: f, errors: p, warnings: m } = r, h = p.map((e, t) => {
+		if (e) return /* @__PURE__ */ c("div", {
 			role: "alert",
 			children: e.message
 		}, t);
-	}), g = m.map((e, t, n) => /* @__PURE__ */ s("div", {
+	}), g = m.map((e, t, n) => /* @__PURE__ */ c("div", {
 		role: "alert",
 		className: `${d}-message-help-warning`,
 		children: e
-	}, t)), _ = !e(f) || !!g.length, v = !!(_ || h.length), y = i(null);
-	return r(u, () => ({ getRootElement() {
+	}, t)), _ = !e(f) || !!g.length, v = !!(_ || h.length), y = a(null);
+	return i(u, () => ({ getRootElement() {
 		return y.current;
-	} })), v && /* @__PURE__ */ s(l, {
+	} })), v && /* @__PURE__ */ c(n, {
 		in: v,
 		appear: !0,
-		classNames: `${a}-animation-blink`,
+		classNames: `${o}-animation-blink`,
 		duration: 300,
 		unmountOnExit: !0,
 		refElement: y,
-		children: /* @__PURE__ */ s("div", {
+		children: /* @__PURE__ */ c("div", {
 			ref: y,
 			className: t(`${d}-message`, { [`${d}-message-help`]: _ }),
-			children: e(f) ? /* @__PURE__ */ c(o, { children: [h.length > 0 && h, g.length > 0 && g] }) : f
+			children: e(f) ? /* @__PURE__ */ l(s, { children: [h.length > 0 && h, g.length > 0 && g] }) : f
 		})
 	});
 }
-var d = n(u);
+var d = r(u);
 d.displayName = "FormItemTip";
 //#endregion
 export { d as default };

package/form/FormLabelSymbol.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import e from "../utils/className.js";
 import t from "../config-provider/context.js";
 import "../config-provider/index.js";

package/form/FormList.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isFunction as e, isUndefined as t } from "../utils/is.js";
 import { FormListContext as n } from "./context.js";
 import r from "../utils/warning.js";
@@ -17,11 +17,7 @@ function d(d) {
 	return /* @__PURE__ */ c(n.Provider, {
 		value: {
 			...d,
-			hidden: d.hidden,
-			getItemKey(e) {
-				let t = e?.replace?.(/\[|\]/g, ".")?.split?.("."), n = t?.indexOf?.(f), r = t[n + 1];
-				return `${f}_${_.indexOf(r)}_${t.slice(n + 2).join("_")}`;
-			}
+			hidden: d.hidden
 		},
 		children: /* @__PURE__ */ c(o, {
 			field: f,
@@ -46,7 +42,7 @@ function d(d) {
 						...l.slice(0, n),
 						e,
 						...l.slice(n)
-					]) : (_.push(c), u = [...l, e]), s(u, {
+					]) : (_.push(c), u = [...l, e]), s([...u], {
 						isFormList: !0,
 						ignore: t(e)
 					});
@@ -61,7 +57,7 @@ function d(d) {
 					let r = _[e];
 					_.splice(e, 1), _.splice(t, 0, r);
 					let a = n[e], o = [...n];
-					o.splice(e, 1), o.splice(t, 0, a), s(o, { isFormList: !0 });
+					o.splice(e, 1), o.splice(t, 0, a), s([...o], { isFormList: !0 });
 				}
 				let g;
 				return e(p) && (g = p(c.map((e, n, r) => {

package/form/FormProvider.js

@@ -1,26 +1,26 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { FormProviderContext as e } from "./context.js";
 import { useCallback as t, useRef as n } from "react";
 import { jsx as r } from "react/jsx-runtime";
 //#region components/pc/form/FormProvider.tsx
 function i(i) {
-	let a = n({}), o = t((e, t) => (e && (a.current[e] = t), () => {
-		delete a.current[e];
-	}), []), s = t((e, t) => {
-		i.onFormSubmit?.(e, t, { forms: a.current });
-	}, [i.onFormSubmit]), c = t((e, t) => {
-		i.onFormReset?.(e, t, { forms: a.current });
-	}, [i.onFormReset]), l = t((e, t) => {
-		i.onFormValuesChange?.(e, t, { forms: a.current });
+	let { children: a } = i, o = n({}), s = t((e, t) => (e && (o.current[e] = t), () => {
+		delete o.current[e];
+	}), []), c = t((e, t) => {
+		i.onFormSubmit?.(e, t, { forms: o.current });
+	}, [i.onFormSubmit]), l = t((e, t) => {
+		i.onFormReset?.(e, t, { forms: o.current });
+	}, [i.onFormReset]), u = t((e, t) => {
+		i.onFormValuesChange?.(e, t, { forms: o.current });
 	}, [i.onFormValuesChange]);
 	return /* @__PURE__ */ r(e.Provider, {
 		value: {
-			onFormValuesChange: l,
-			onFormSubmit: s,
-			onFormReset: c,
-			register: o
+			register: s,
+			onFormValuesChange: u,
+			onFormSubmit: c,
+			onFormReset: l
 		},
-		children: i.children
+		children: a
 	});
 }
 var a = i;

package/form/constant.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 //#region components/pc/form/constant.ts
 var e = "form", t = `${e}-item`;
 //#endregion

package/form/context.d.ts

@@ -10,6 +10,5 @@ export declare const FormProviderContext: Context<{
     onFormReset?: (id: string | undefined, values: any) => void;
 }>;
 export declare const FormListContext: Context<{
-    getItemKey?: (key: any) => string;
     hidden?: boolean;
 }>;

package/form/context.js

@@ -1,8 +1,8 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { NOOP as e } from "../utils/constant.js";
-import { PREFIX_CLS as t } from "../config-provider/context.js";
-import { createContext as n } from "react";
-var r = n({
+import { createContext as t } from "react";
+import { UI_PC_PREFIX as n } from "@unicom-cloud/utils/constant/ui";
+var r = t({
 	layout: "horizontal",
 	labelAlign: "right",
 	labelCol: {
@@ -15,7 +15,7 @@ var r = n({
 	},
 	requiredSymbol: !0,
 	getFormElementId() {
-		return `${t}-`;
+		return `${n}-`;
 	},
 	store: {
 		clearFields: e,
@@ -55,7 +55,7 @@ var r = n({
 			};
 		}
 	}
-}), i = n({}), a = n({}), o = n({});
+}), i = t({}), a = t({}), o = t({});
 //#endregion
 export { r as FormContext, i as FormItemContext, o as FormListContext, a as FormProviderContext };
 /* 独立思考，明辨是非 */

package/form/hook/useForm.js

@@ -1,55 +1,57 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
-import e from "../store.js";
-import { useEffect as t, useRef as n } from "react";
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
+import e from "../../utils/pick.js";
+import t from "../store.js";
+import { useEffect as n, useRef as r } from "react";
 //#region components/pc/form/hook/useForm.ts
-function r() {
-	let t = new e(), n = {
-		registerField: t.registerField,
-		registerWatcher: t.registerWatcher,
-		registerStateWatcher: t.registerStateWatcher,
-		registerFormWatcher: t.registerFormWatcher,
-		innerSetInitialValues: t.innerSetInitialValues,
-		innerSetInitialValue: t.innerSetInitialValue,
-		innerSetCallbacks: t.innerSetCallbacks,
-		innerSetFieldValue: t.innerSetFieldValue,
-		innerGetStore: t.innerGetStore,
-		innerGetStoreStatus: t.innerGetStoreStatus,
-		innerGetFieldValue: t.innerGetFieldValue,
-		innerGetRegisteredFields: t.innerGetRegisteredFields,
-		innerCollectFormState: t.innerCollectFormState,
-		innerClearStoreByFields: t.innerClearStoreByFields
-	};
-	return {
-		getFieldsValue: t.getFieldsValue,
-		getFieldValue: t.getFieldValue,
-		getFieldError: t.getFieldError,
-		getFieldsError: t.getFieldsError,
-		getTouchedFields: t.getTouchedFields,
-		getFields: t.getFields,
-		getInitialValues: t.getInitialValues,
-		setInitialValues: t.setInitialValues,
-		setInitialValue: t.setInitialValue,
-		setFieldValue: t.setFieldValue,
-		setFieldsValue: t.setFieldsValue,
-		setFields: t.setFields,
-		resetFields: t.resetFields,
-		clearFields: t.clearFields,
-		submit: t.submit,
-		validate: t.validate,
+function i() {
+	let n = new t(), r = e(n, [
+		"registerField",
+		"registerWatcher",
+		"registerStateWatcher",
+		"registerFormWatcher",
+		"innerSetInitialValues",
+		"innerSetInitialValue",
+		"innerSetCallbacks",
+		"innerSetFieldValue",
+		"innerGetStore",
+		"innerGetStoreStatus",
+		"innerGetFieldValue",
+		"innerGetRegisteredFields",
+		"innerCollectFormState",
+		"innerClearStoreByFields"
+	]), i = e(n, [
+		"getFieldsValue",
+		"getFieldValue",
+		"getFieldError",
+		"getFieldsError",
+		"getTouchedFields",
+		"getFields",
+		"getInitialValues",
+		"setInitialValues",
+		"setInitialValue",
+		"setFieldValue",
+		"setFieldsValue",
+		"setFields",
+		"resetFields",
+		"clearFields",
+		"submit",
+		"validate",
+		"getFieldsState"
+	]);
+	return Object.assign(i, {
 		scrollToField: () => {},
-		getFieldsState: t.getFieldsState,
-		getInnerMethods: () => n
-	};
+		getInnerMethods: () => r
+	});
 }
-function i(e) {
-	let i = n(e);
-	i.current || (e ? i.current = e : a());
+function a(e) {
+	let t = r(e);
+	t.current ||= e || a();
 	function a() {
-		let e = r();
-		return i.current = e, e;
+		let e = i();
+		return t.current = e, e;
 	}
-	return t(() => () => {}, []), [i.current, a];
+	return n(() => () => {}, []), [t.current, a];
 }
 //#endregion
-export { i as default, r as getFormInstance };
+export { a as default, i as getFormInstance };
 /* 独立思考，明辨是非 */

package/form/hook/useFormContext.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isFunction as e } from "../../utils/is.js";
 import t from "../../hooks/use-force-update/index.js";
 import { FormContext as n } from "../context.js";

package/form/hook/useFormState.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isEqualWith as e, isFunction as t } from "../../utils/is.js";
 import { FormContext as n } from "../context.js";
 import r from "../../utils/warning.js";

package/form/hook/useWatch.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { isArray as e, isFunction as t, isString as n } from "../../utils/is.js";
 import { FormContext as r } from "../context.js";
 import i from "../../utils/warning.js";

package/form/index.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import { FormContext as e, FormItemContext as t, FormListContext as n, FormProviderContext as r } from "./context.js";
 import { ValidateError as i } from "./utils.js";
 import a, { getFormInstance as o } from "./hook/useForm.js";

package/form/interface.d.ts

@@ -8,7 +8,7 @@ import Store from './store';
 export type IndexedObject = {
     [key: string]: unknown;
 };
-export type KeyType = string | number | symbol;
+export type KeyType = string | number;
 export type ComponentType = keyof JSX.IntrinsicElements | React.ComponentType<unknown>;
 export type FieldError<FieldValue = unknown> = {
     value?: FieldValue;
@@ -391,7 +391,6 @@ export interface FormItemSymbolProps {
 export interface FormControlProps<FormData = unknown, FieldValue = FormData[keyof FormData], FieldKey extends KeyType = keyof FormData> {
     /** 受控组件的唯一标示。 */
     field?: FieldKey;
-    _key?: FieldKey;
     initialValue?: FieldValue;
     dependencies?: FormItemProps['dependencies'];
     getValueFromEvent?: FormItemProps['getValueFromEvent'];
@@ -467,8 +466,8 @@ export type FormItemContextProps<FormData = unknown, FieldValue = FormData[keyof
     validateMessages?: FormProps['validateMessages'];
     schemaOptions?: SchemaOptions;
     updateFormItem?: (field: string, params: {
-        errors?: FieldError<FieldValue>;
-        warnings?: ReactNode[];
+        errors?: FieldError<FieldValue> | null;
+        warnings?: ReactNode[] | null;
     }) => void;
 };
 export type FormInstance<FormData = unknown, FieldValue = FormData[keyof FormData], FieldKey extends KeyType = keyof FormData> = Pick<Store<FormData, FieldValue, FieldKey>, 'getFieldsValue' | 'getFieldValue' | 'getFieldError' | 'getFieldsError' | 'getTouchedFields' | 'getFields' | 'getInitialValues' | 'setInitialValues' | 'setInitialValue' | 'setFieldValue' | 'setFieldsValue' | 'setFields' | 'resetFields' | 'clearFields' | 'submit' | 'validate' | 'getFieldsState'> & {

package/form/interface.js

@@ -1,4 +1,4 @@
-/* 潘启宝 2026-04-23 09:23:31 星期四 */
+/* 潘启宝 2026-05-08 09:13:14 星期五 */
 import "./store.js";
 import "react";
 import "react/jsx-runtime";