@dazhicheng/ui 1.5.160 → 1.5.162

package/dist/components/tt-form/src/form-render/FormArrayRegister.d.ts

@@ -2,7 +2,7 @@ import { PropType } from 'vue';
 import { Recordable } from '../../../../../../utils/src';
 import { FieldEntry } from '../types/forms';
 import { ArraySchemaContext, FormSchema } from '../types';
-type ArraySchemaProp = FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number, ctx?: ArraySchemaContext) => FormSchema[]);
+type ArraySchemaProp = FormSchema[] | ((entry: FieldEntry<Recordable>, currentIndex: number, ctx: ArraySchemaContext) => FormSchema[]);
 declare const FormArrayRegister: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
     fieldName: {
         type: PropType<string>;

package/dist/components/tt-form/src/formApi.d.ts

@@ -136,7 +136,7 @@ export declare class FormApi {
      * 子类（如分组表单）可覆盖以同步清理虚拟校验缓存等。
      * @param {string[]} removedFieldNames 已从 schema 中移除的字段名
      */
-    protected onRemovedSchemaFields(fieldNames: string[]): void;
+    onRemovedSchemaFields(fieldNames: string[]): void;
     /**
      * store 更新后对比前后 `schema` 的 fieldName 集合，对已从 schema 中移除的字段清空 vee-validate 值与错误，
      * 避免 `removeFields` / 删项后 `getValues` 仍带出旧字段。

package/dist/components/tt-form/src/group-form/groupFormApi.d.ts

@@ -81,10 +81,10 @@ export declare class GroupFormApi extends FormApi {
      */
     protected getFieldNamesForSetValuesFilter(): string[];
     /**
-     * @description schema 中移除字段后清空虚拟列表场景下缓存的校验错误，与 {@link FormApi} 中清空 vee 值保持一致。
+     * @description schema 中移除字段后清空 vee 值/错误，并同步清理虚拟列表 errorCacheMap
      * @param {string[]} removedFieldNames 已移除的 fieldName 列表
      */
-    protected onRemovedSchemaFields(removedFieldNames: string[]): void;
+    onRemovedSchemaFields(removedFieldNames: string[]): void;
     /**
      * @description 校验表单（含未挂载的虚拟字段），支持通过第二个参数控制是否滚动到第一个错误分组
      * @param {Partial<ValidationOptions>} [opts] - 原始 validate 选项
@@ -183,6 +183,19 @@ export declare class GroupFormApi extends FormApi {
      * formApi.removeFields(['v_phone', 'v_email']);
      */
     removeFields(fieldNames: string[]): void;
+    /**
+     * @description 清理已移除分组的运行时状态（隐藏集、折叠、导航徽标等）
+     * @param keysToRemove - 待移除的分组 key（含子分组）
+     */
+    private _purgeRemovedGroupState;
+    /**
+     * @description 按分组 key 移除分组及其子分组（从 groupSchema 树删除），并清空其下字段值与相关状态
+     * @param groupKey - 分组 key（单个或数组）
+     * @example
+     * formApi.removeGroups(['group1', 'group2']);
+     * formApi.removeGroups('group1');
+     */
+    removeGroups(groupKey: string[] | string): void;
     /**
      * @description 合并 vee-validate 实时 errors 与虚拟列表未挂载字段的 errorCacheMap，用于导航徽标与输入联动
      * @returns {Record<string, string>} 合并后的错误映射
@@ -238,6 +251,11 @@ export declare class GroupFormApi extends FormApi {
      * @description 清空所有缓存的错误并递增重置信号
      */
     private _clearAllCachedErrors;
+    /**
+     * @description 收集分组 key 及其所有子分组 key（去重）
+     * @param keys - 起始分组 key 列表
+     */
+    private _collectGroupKeysWithDescendants;
     /**
      * @description 递归构建各分组 key → 其直属字段名的映射
      * @param {GroupFormSchema[]} schemas - 分组 schema 数组
@@ -266,7 +284,7 @@ export declare class GroupFormApi extends FormApi {
      * @description 清空分组下的所有字段值
      * @param {string} key 分组 key
      */
-    clearGroupFieldValues(key: string): void;
+    private _clearGroupFieldValues;
     /**
      * @description 卸载分组表单时恢复初始schema
      */

package/dist/components/tt-form/src/group-form/utils.d.ts

@@ -107,6 +107,12 @@ export declare function insertFieldsByPosition(schemas: GroupFormSchema[], field
  * @example
  * removeFieldsFromGroup(schema, new Set(['phone_0', 'divider-contact-0']));
  */
+/**
+ * 从 groupSchema 树中移除指定分组（含其子树），按分组 `key` 匹配
+ * @param schemas - 分组 schema 树
+ * @param groupKeys - 要移除的分组 key 集合（应包含所有需删除的子分组 key）
+ */
+export declare function removeGroupsFromGroup(schemas: GroupFormSchema[], groupKeys: Set<string>): GroupFormSchema[];
 export declare function removeFieldsFromGroup(schemas: GroupFormSchema[], fieldNames: Set<string>): GroupFormSchema[];
 /**
  * 浅拷贝 groupSchema 树结构（只复制数组和分组/行的 children 引用，不深拷贝叶子节点）