@dazhicheng/ui 1.5.174 → 1.5.175

package/dist/components/tt-form/src/form-render/array-register/utils.d.ts

@@ -7,6 +7,7 @@ export type ArrayItemResolvedState = {
     rules: FormSchema["rules"];
     formItemClass: FormSchema["formItemClass"];
     disabled: FormSchema["disabled"];
+    wrapperClass: FormSchema["wrapperClass"];
 };
 /**
  * 对齐 FormField: shouldDisabled = isDisabled || disabled || computedProps.disabled

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

@@ -26,6 +26,8 @@ export declare class GroupFormApi extends FormApi {
     readonly collapseStates: Record<string, boolean>;
     /** 当前被 ifShow 隐藏的分组 key 集合 */
     readonly hiddenGroupKeys: Set<string>;
+    /** 当前被 ifShow 隐藏的字段名集合 */
+    readonly hiddenFieldNames: Set<string>;
     /** 导航各分组的错误数量，validate 后自动更新 */
     readonly navErrorCounts: Record<string, number>;
     /** 共享错误缓存，validate 写入 → LazyFormField 挂载时读取恢复 */
@@ -132,20 +134,28 @@ export declare class GroupFormApi extends FormApi {
      */
     toggleCollapse(key: string): void;
     /**
-     * @description 设置分组的可见性状态，由 GroupSection 组件在 ifShow 求值后调用。
-     *   分组显示/隐藏会影响 {@link hiddenGroupKeys} 与校验错误是否计入导航/虚拟字段缓存；
+     * @description 设置容器的可见性状态，由 GroupSection 组件在 ifShow 求值后调用。
+     *   group 隐藏时额外维护 {@link hiddenGroupKeys} 供导航和渲染判断；
+     *   group / row 隐藏时都会清空其下字段值和校验，并把字段加入 {@link hiddenFieldNames}，使隐藏字段不参与校验。
      *   可见性变化后在下一帧调用 {@link syncNavErrorCountsFromForm}，使「先 validate 再隐藏再显示」时
      *   导航徽标、{@link errorCacheMap} 与表单项错误展示保持一致。
      * @param {string} key - 分组 key
      * @param {boolean} visible - 是否可见
+     * @param {string[]} [fieldNames] - 兼容旧内部调用的字段名列表，传入时按字段集合显隐处理
      */
-    setGroupVisible(key: string, visible: boolean): void;
+    setGroupVisible(key: string, visible: boolean, fieldNames?: string[]): void;
     /**
-     * @description 判断字段是否属于被 ifShow 隐藏的分组（含递归祖先分组）
+     * @description 设置字段集合的可见性状态，用于 row 容器隐藏时同步字段值、校验和错误缓存。
+     * @param {string[]} fieldNames - 字段名列表
+     * @param {boolean} visible - 是否可见
+     */
+    setFieldsVisible(fieldNames: string[], visible: boolean): void;
+    /**
+     * @description 判断字段是否属于被隐藏的字段集合
      * @param {string} fieldName - 字段名
-     * @returns {boolean} 是否属于隐藏分组
+     * @returns {boolean} 是否属于隐藏字段
      */
-    private _isFieldInHiddenGroup;
+    private _isFieldHidden;
     /**
      * @description 判断错误键是否命中字段（支持数组/对象嵌套键）
      * @param {string} errorKey - 错误键（如 a[0].b）
@@ -219,11 +229,11 @@ export declare class GroupFormApi extends FormApi {
      */
     private _scrollToFirstErrorGroup;
     /**
-     * @description 从校验结果中剔除属于隐藏分组的字段错误，并重新判定 valid 状态
+     * @description 从校验结果中剔除属于隐藏字段集合的错误，并重新判定 valid 状态
      * @param {object} result - 校验结果
      * @returns {object} 过滤后的校验结果
      */
-    private _stripHiddenGroupErrors;
+    private _stripHiddenFieldErrors;
     /**
      * @description 对单个字段值执行 rules 校验（纯数据，不挂载组件）。
      *   支持字符串规则（"required" / "selectRequired"）和 Zod schema。
@@ -287,10 +297,28 @@ export declare class GroupFormApi extends FormApi {
      */
     private _getGroupFieldNamesWithVisited;
     /**
-     * @description 清空分组下的所有字段值
-     * @param {string} key 分组 key
+     * @description 获取字段所属分组 key，支持数组/对象嵌套路径回溯到 schema 字段。
+     * @param {string} fieldName 字段名
+     * @returns {string | undefined} 所属分组 key
+     */
+    private _getFieldGroupKey;
+    /**
+     * @description 判断字段所属分组或祖先分组是否仍处于隐藏状态，用于避免字段显示时绕过仍隐藏的父级分组。
+     * @param {string} fieldName 字段名
+     * @returns {boolean} 是否存在隐藏的所属分组或祖先分组
+     */
+    private _hasHiddenGroup;
+    /**
+     * @description 设置字段隐藏状态
+     * @param {string[]} fieldNames 字段名列表
+     * @param {boolean} hidden 是否隐藏
+     */
+    private _setFieldsHidden;
+    /**
+     * @description 清空隐藏字段的值、校验状态和虚拟错误缓存，不注销 schema 仍存在的数组字段注册。
+     * @param {string[]} fieldNames 字段名列表
      */
-    private _clearGroupFieldValues;
+    private _clearHiddenFieldValues;
     /**
      * @description 卸载分组表单时恢复初始schema
      */

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

@@ -35,11 +35,26 @@ export interface RenderScheduler {
  */
 export declare function createRenderScheduler(batchSize?: number): RenderScheduler;
 export declare const RENDER_SCHEDULER_KEY: InjectionKey<RenderScheduler>;
+export type GroupVisibilityPayload = {
+    /** 可见性变化来源为分组 */
+    type: "group";
+    /** 分组 key */
+    key: string;
+    /** 是否可见 */
+    visible: boolean;
+} | {
+    /** 可见性变化来源为 row 容器 */
+    type: "row";
+    /** row 下需要同步隐藏状态的字段名 */
+    fieldNames: string[];
+    /** 是否可见 */
+    visible: boolean;
+};
 /**
  * 分组可见性回调注入 key，由 GroupForm.vue provide，GroupSection.vue inject。
- * 当分组的 ifShow 求值结果变化时，GroupSection 调用此回调通知 API 层同步隐藏状态。
+ * 当 group / row 的 ifShow 求值结果变化时，GroupSection 调用此回调通知 API 层同步隐藏状态。
  */
-export declare const GROUP_VISIBILITY_CALLBACK_KEY: InjectionKey<(key: string, visible: boolean) => void>;
+export declare const GROUP_VISIBILITY_CALLBACK_KEY: InjectionKey<(payload: GroupVisibilityPayload) => void>;
 /**
  * 当外部通过 formApi.setGroupVisible(key, false) 隐藏分组时，
  * GroupSection 读取此集合决定是否渲染，实现 API 驱动的分组显隐。

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

@@ -31,6 +31,12 @@ export declare function isSlotSchema(schema: GroupFormSchema): schema is FormSlo
  * @returns {string} 用于 :key 的字符串
  */
 export declare function getSchemaKey(schema: GroupFormSchema, idx: number): string;
+/**
+ * 获取字段列表中的有效字段名。
+ * @param {FormSchema[]} fields - 字段列表
+ * @returns {string[]} 字段名列表
+ */
+export declare function getFieldNames(fields: FormSchema[]): string[];
 /**
  * 递归展平分组 schema，提取所有字段 schema（忽略分组结构）
  * @param {GroupFormSchema[]} schemas - 分组 schema 数组，可包含分组与字段的混合结构