@tmagic/form 1.8.0-beta.15 → 1.8.0-beta.16

package/dist/es/Form.vue_vue_type_script_setup_true_lang.js

@@ -145,6 +145,17 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 			}
 		});
 		/**
+		* formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+		*
+		* 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+		* 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+		*
+		* 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+		* `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+		* 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+		*/
+		const reservedStateKeys = new Set(Reflect.ownKeys(formState));
+		/**
 		* `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
 		* 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
 		*
@@ -179,7 +190,7 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 				return;
 			}
 			if (stale) return;
-			applyExtendState(formState, state);
+			applyExtendState(formState, state, reservedStateKeys);
 		});
 		provide("mForm", formState);
 		/**

package/dist/es/submitForm.js

@@ -54,7 +54,8 @@ var mountFormInstance = (options) => {
 						console.error("[MForm] extendState failed:", e);
 						return;
 					}
-					const apply = (state) => applyExtendState(form.formState, state);
+					const reservedStateKeys = new Set(Reflect.ownKeys(form.formState));
+					const apply = (state) => applyExtendState(form.formState, state, reservedStateKeys);
 					if (result && typeof result.then === "function") result.then(apply, (e) => console.error("[MForm] extendState failed:", e));
 					else apply(result);
 				}, {

package/dist/es/utils/form.js

@@ -211,15 +211,19 @@ var sortChange = (data, { prop, order }) => {
 * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
 *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
 *
-* 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
-* isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
-* 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
-* `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
-* 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+* 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+* 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+* config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+* post 等），命中这些 key 时统一跳过并告警。
+*
+* 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+* 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+* `TypeError: 'set' on proxy: trap returned falsish`。
 */
-var applyExtendState = (formState, state) => {
+var applyExtendState = (formState, state, reservedKeys) => {
 	if (!state) return;
 	for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+		if (reservedKeys?.has(key)) continue;
 		if (!("value" in descriptor)) {
 			descriptor.configurable = true;
 			Object.defineProperty(formState, key, descriptor);

package/dist/es/utils/typeMatch.js

@@ -89,7 +89,7 @@ var stringifyExampleValue = (value) => {
 	}
 	return String(value);
 };
-var MAX_SUGGESTION_OPTIONS = 5;
+var MAX_SUGGESTION_OPTIONS = 20;
 /**
 * 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
 * 可选值超过 MAX_SUGGESTION_OPTIONS 个时仅展示前若干个并以「等」省略。

package/dist/tmagic-form.umd.cjs

@@ -2816,7 +2816,7 @@
 		}
 		return String(value);
 	};
-	var MAX_SUGGESTION_OPTIONS = 5;
+	var MAX_SUGGESTION_OPTIONS = 20;
 	/**
 	* 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
 	* 可选值超过 MAX_SUGGESTION_OPTIONS 个时仅展示前若干个并以「等」省略。
@@ -3340,15 +3340,19 @@
 	* - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
 	*   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
 	*
-	* 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
-	* isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
-	* 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
-	* `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
-	* 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+	* 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+	* 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+	* config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+	* post 等），命中这些 key 时统一跳过并告警。
+	*
+	* 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+	* 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+	* `TypeError: 'set' on proxy: trap returned falsish`。
 	*/
-	var applyExtendState = (formState, state) => {
+	var applyExtendState = (formState, state, reservedKeys) => {
 		if (!state) return;
 		for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+			if (reservedKeys?.has(key)) continue;
 			if (!("value" in descriptor)) {
 				descriptor.configurable = true;
 				Object.defineProperty(formState, key, descriptor);
@@ -4167,6 +4171,17 @@
 				}
 			});
 			/**
+			* formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+			*
+			* 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+			* 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+			*
+			* 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+			* `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+			* 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+			*/
+			const reservedStateKeys = new Set(Reflect.ownKeys(formState));
+			/**
 			* `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
 			* 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
 			*
@@ -4201,7 +4216,7 @@
 					return;
 				}
 				if (stale) return;
-				applyExtendState(formState, state);
+				applyExtendState(formState, state, reservedStateKeys);
 			});
 			(0, vue.provide)("mForm", formState);
 			/**
@@ -4456,7 +4471,8 @@
 							console.error("[MForm] extendState failed:", e);
 							return;
 						}
-						const apply = (state) => applyExtendState(form.formState, state);
+						const reservedStateKeys = new Set(Reflect.ownKeys(form.formState));
+						const apply = (state) => applyExtendState(form.formState, state, reservedStateKeys);
 						if (result && typeof result.then === "function") result.then(apply, (e) => console.error("[MForm] extendState failed:", e));
 						else apply(result);
 					}, {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0-beta.15",
+  "version": "1.8.0-beta.16",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -52,9 +52,9 @@
   "peerDependencies": {
     "vue": "^3.5.40",
     "typescript": "^6.0.3",
-    "@tmagic/design": "1.8.0-beta.15",
-    "@tmagic/form-schema": "1.8.0-beta.15",
-    "@tmagic/utils": "1.8.0-beta.15"
+    "@tmagic/design": "1.8.0-beta.16",
+    "@tmagic/utils": "1.8.0-beta.16",
+    "@tmagic/form-schema": "1.8.0-beta.16"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/Form.vue

@@ -261,6 +261,18 @@ const formState: FormState = reactive<FormState>({
   },
 });
 
+/**
+ * formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+ *
+ * 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+ * 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+ *
+ * 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+ * `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+ * 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+ */
+const reservedStateKeys = new Set<string | symbol>(Reflect.ownKeys(formState));
+
 /**
  * `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
  * 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
@@ -299,7 +311,7 @@ watchEffect(async (onCleanup) => {
   }
   if (stale) return;
 
-  applyExtendState(formState, state);
+  applyExtendState(formState, state, reservedStateKeys);
 });
 
 provide('mForm', formState);

package/src/submitForm.ts

@@ -204,10 +204,14 @@ const mountFormInstance = <T>(options: MountFormInstanceOptions<T>): Promise<T>
                     console.error('[MForm] extendState failed:', e);
                     return;
                   }
+                  // formState 的内置 key 快照：在 extendState 合并前捕获，
+                  // 供 applyExtendState 禁止 extendState 覆盖这些已有字段（只能新增），
+                  // 与 Form.vue 中 reservedStateKeys 的语义保持一致。
+                  const reservedStateKeys = new Set<string | symbol>(Reflect.ownKeys(form.formState));
                   // 合并逻辑收口在 applyExtendState：props 派生的只读 getter 字段
                   // （keyProp 等）以普通字段形式返回时会被跳过并告警，避免 proxy set 抛错
                   const apply = (state: Record<string, any> | null | undefined) =>
-                    applyExtendState(form.formState, state);
+                    applyExtendState(form.formState, state, reservedStateKeys);
                   if (result && typeof result.then === 'function') {
                     result.then(apply, (e: any) => console.error('[MForm] extendState failed:', e));
                   } else {

package/src/utils/form.ts

@@ -449,16 +449,27 @@ export const sortChange = (data: any[], { prop, order }: SortProp) => {
  * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
  *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
  *
- * 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
- * isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
- * 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
- * `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
- * 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+ * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+ * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+ * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+ * post 等），命中这些 key 时统一跳过并告警。
+ *
+ * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+ * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`。
  */
-export const applyExtendState = (formState: FormState, state: Record<string, any> | null | undefined): void => {
+export const applyExtendState = (
+  formState: FormState,
+  state: Record<string, any> | null | undefined,
+  reservedKeys?: Set<string | symbol>,
+): void => {
   if (!state) return;
 
   for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+    if (reservedKeys?.has(key)) {
+      continue;
+    }
+
     if (!('value' in descriptor)) {
       descriptor.configurable = true;
       Object.defineProperty(formState, key, descriptor);

package/src/utils/typeMatch.ts

@@ -142,7 +142,7 @@ const stringifyExampleValue = (value: any): string => {
 };
 
 // 参考建议中最多展示的可选值个数，超出以「等」省略。
-const MAX_SUGGESTION_OPTIONS = 5;
+const MAX_SUGGESTION_OPTIONS = 20;
 
 /**
  * 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。

package/types/index.d.ts

@@ -290,13 +290,16 @@ declare const sortChange: (data: any[], {
  * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
  *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
  *
- * 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
- * isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
- * 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
- * `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
- * 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+ * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+ * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+ * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+ * post 等），命中这些 key 时统一跳过并告警。
+ *
+ * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+ * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`。
  */
-declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined) => void;
+declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined, reservedKeys?: Set<string | symbol>) => void;
 declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts