@zat-design/sisyphus-react 4.5.5 → 4.5.6-beta.2

package/es/ProEditTable/utils/tools.d.ts

@@ -0,0 +1,133 @@
+import React, { Key } from 'react';
+import { FormInstance } from 'antd/es/form';
+import { NamePath } from 'antd/es/form/interface';
+/**
+ * 生成随机字符串
+ * @returns 随机字符串
+ */
+export declare const getRandom: () => string;
+/**
+ * 构建 AntD Table 的 rowKey 函数，支持字符串/函数两种形式，
+ * 当用户指定字段值无效时（新增行尚未填写业务 key），自动降级到内部 record.rowKey。
+ * @param rowKey 用户传入的 rowKey prop
+ * @returns AntD Table 可用的 rowKey 字符串或函数
+ */
+export declare const buildTableRowKey: (rowKey?: string | number | symbol | ((record: any) => any)) => ((record: any) => string);
+/**
+ * 表格行数据的浅比较：仅比较第一层字段引用/值，避免虚拟滚动时整行深比较开销。
+ * 行对象在本组件场景通常为扁平标量字段；同引用时由调用方另行处理。
+ */
+export declare const isRecordShallowEqual: (a: Record<string, any> | null | undefined, b: Record<string, any> | null | undefined) => boolean;
+/**
+ * 深层次对比两个对象且取出来差异值
+ * @param object 比较对象
+ * @param base 基准对象
+ * @returns 差异对象
+ */
+export declare const difference: <T extends Record<string, any>, U extends Record<string, any>>(object: T, base: U) => Record<string, any>;
+/**
+ * 数组字段循环校验，解决validateFields无法批量校验的问题
+ * @param validateKeys 校验键数组
+ * @param form 表单实例
+ * @param rowName 行名称路径
+ * @returns 校验结果Promise
+ */
+export declare const customValidate: (validateKeys: string[], form: FormInstance, rowName: NamePath) => Promise<any>;
+/**
+ * 拆解数组names
+ * @param names 名称数组
+ * @returns 拆解后的字符串
+ */
+export declare const splitNames: (names: any[]) => string;
+/**
+ * 把行内变更的子键映射回「所属列的字段标识」，并去重。
+ * - names 组合列：任一子键命中 → 该列合并名（splitNames(names)），与 Form.Item 注册名/dataIndex 对齐
+ * - 普通列：原键本身
+ *
+ * 用于行数据被联动改写（兄弟列 onFieldChange 回填）后，按真实字段名重校验与清理常驻报错，
+ * 修复 group 列旧报错不清的问题。
+ */
+export declare const resolveChangedFields: (changedKeys: string[], columns?: any[]) => string[];
+/**
+ * 把联动回填后的子键，重新组合并写回 names 组合列的合并字段（store）。
+ *
+ * 背景：names 组合列真正被校验的是合并字段（splitNames(names)，如 certType-certNo），
+ * 其值仅在渲染期由 getValueProps 从子键组合后写回 store。联动回填（兄弟列 onFieldChange）
+ * 只直接写入子键，不经过该字段的 normalize/渲染，导致合并字段 store 值未更新 →
+ * 按合并名校验时读到旧空值、红字不清。这里按当前行子键即时组合并写回，确保 validateFields 读到最新值。
+ */
+export declare const syncGroupCombinedValues: (form: FormInstance, rowPath: (string | number)[], changedKeys: string[], columns?: any[]) => void;
+/**
+ * 获取中间formItem的name
+ * @param name 名称路径
+ * @param virtualKey 虚拟键
+ * @returns 完整名称路径数组
+ */
+export declare const getNamePath: (name: NamePath, virtualKey?: string) => (string | number)[];
+/**
+ * 删除操作
+ * @param params 删除参数
+ */
+export declare const onDelete: ({ name, form, virtualKey, selectedRowKeys, }: {
+    name: NamePath;
+    form: FormInstance;
+    virtualKey?: string;
+    selectedRowKeys: Key[];
+}) => void;
+/**
+ * 获取最终的disabled, 两种模式【子级优先，全局优先】
+ * 全局优先：globalControl为true时，全局控制
+ * 子级优先：globalControl为false时，子级控制
+ * @param params 禁用参数
+ * @returns 是否禁用
+ */
+export declare const getDisabled: ({ globalControl, formDisabled, column, tabledDisabled, columnFieldProps, params, rowDisabled, }: {
+    globalControl: boolean;
+    formDisabled?: boolean | ((record: any) => boolean);
+    column: any;
+    tabledDisabled?: boolean;
+    columnFieldProps?: any;
+    params: any[];
+    rowDisabled?: any;
+}) => boolean;
+/**
+ * 表格自动滚动到报错位置
+ */
+export declare const handleScrollToError: () => void;
+/**
+ * 把「首个报错列的 cellKey」映射成它在表头 th 中的可见列索引。
+ * 列序 = [选择列?(hasSelection 时占位 1), ...用户列]；names 列的 cellKey 用 splitNames 结果。
+ * @returns 表头 th 下标；未命中返回 -1
+ */
+export declare const resolveErrorColumnIndex: (columns: any[], cellKey: string, hasSelection: boolean) => number;
+/**
+ * 虚拟表格：横向滚动定位到「首个报错列」。
+ *
+ * 背景：rc-table 虚拟表格对「列」也做了虚拟化（BodyGrid 仅渲染横向视口内的列），
+ * 保存校验失败时报错列可能根本未渲染进 body DOM，无法用单元格测量定位（旧实现据此失效）。
+ * 而表头（thead）不被列虚拟化——渲染全部列且为真实测量宽度，故改以表头为列宽来源：
+ * 累加报错列之前各列宽、减去 fixed-left 列宽（固定列悬浮，不占滚动偏移）得目标 scrollLeft。
+ *
+ * 注意：ref.nativeElement 仅为 body 滚动容器，表头在其外层 table-container 内，需向上查找。
+ */
+export declare const scrollVirtualToErrorColumn: (tableRef: React.MutableRefObject<any>, columns: any[], cellKey?: string | null) => void;
+/**
+ * 深copy一个对象，并过滤掉其中的React节点
+ * @param value 需要深拷贝的对象
+ * @returns 深拷贝后的对象，其中的React节点会被保留
+ */
+export declare function cloneDeepFilterNode<T>(value: T): T;
+/**
+ * 分页校验
+ */
+export declare const onPageCheck: ({ form, name, value, columns, setState, page, pagination, isView, disabled, }: {
+    form: any;
+    name: any;
+    value: any;
+    columns: any;
+    setState: any;
+    page: any;
+    pagination: any;
+    isView: any;
+    disabled: any;
+}) => Promise<void>;

package/es/ProEditTable/utils/transform.d.ts

@@ -0,0 +1,13 @@
+import { DatePickerProps } from 'antd';
+declare const _default: {
+    RangePicker: () => import("@zat-design/utils/dist/esm/transforms/propTypes").Transform<any>;
+    DatePicker: (fieldProps?: {
+        format?: string;
+        picker?: DatePickerProps["picker"];
+    }) => {
+        normalize: (value: any, prevValue?: any, allValues?: any) => any;
+        getValueProps?: (value: import("rc-field-form/es/interface").StoreValue) => Record<string, unknown>;
+        shouldUpdate?: import("rc-field-form/es/Field").ShouldUpdate<any>;
+    };
+};
+export default _default;

package/es/ProEditTable/utils/useEditTableError.d.ts

@@ -0,0 +1,7 @@
+interface UseEditTableErrorProps {
+    containerNode: HTMLElement | null;
+    className: string;
+    isEnabled: boolean;
+}
+declare const useEditTableError: ({ containerNode, className, isEnabled, }: UseEditTableErrorProps) => [number];
+export default useEditTableError;

package/es/ProEditTable/utils/useShouldUpdateForTable.d.ts

@@ -0,0 +1,16 @@
+interface UseShouldUpdateForTableProps {
+    rowParams: any[];
+    column: any;
+    shouldUpdateDebounce: number;
+}
+interface Result {
+    isEditable: any;
+    required: any;
+    rules: any;
+    fieldProps: any;
+    desensitization: any;
+    valueType: any;
+    component: any;
+}
+declare const useShouldUpdateForTable: (props: UseShouldUpdateForTableProps) => Result;
+export default useShouldUpdateForTable;

package/es/ProEditTable/utils/validateAll.d.ts

@@ -0,0 +1,89 @@
+import type { FormInstance } from 'antd';
+import type { NamePath } from 'antd/es/form/interface';
+/**
+ * 单元格规则装配 + 全量数据真实校验（脱离 DOM）。
+ *
+ * 背景：antd6 虚拟表格滚动时视口外的行会被卸载，其 Form.Item 字段未注册，
+ *       form.validateFields 无法覆盖；本模块用 form store 里的全量数据 + 真实规则
+ *       逐行逐列离屏校验，解决「统一校验」缺口，并产出可常驻的真实报错文案。
+ */
+interface BuildCellRulesParams {
+    column: any;
+    rowData: any;
+    index: number;
+    form: FormInstance;
+    name: (string | number)[];
+    config: any;
+}
+interface BuiltCellRule {
+    /** 单元格 Form.Item 的 namePath（用于定位/messageVariables） */
+    namePath: (string | number)[];
+    /** 列在行内的稳定标识（与 transformColumns 的 dataIndex/key 一致），用于错误存储归集 */
+    cellKey: string;
+    /** 待校验值（names 列为组合数组） */
+    value: any;
+    /** 真实规则集合 */
+    rules: any[];
+    /** 字段 label，供 ${label} 文案插值 */
+    label: string;
+}
+/**
+ * 为单行单列装配真实校验规则与取值。
+ * 当该单元格处于查看/禁用态、或无任何规则时返回 null（跳过校验）。
+ */
+export declare const buildCellRules: ({ column, rowData, index, form, name, config, }: BuildCellRulesParams) => BuiltCellRule | null;
+interface ValidateAllParams {
+    form: FormInstance;
+    name: NamePath;
+    columns: any[];
+    config: any;
+}
+export interface ValidateAllResult {
+    hasError: boolean;
+    /** rowKey -> { cellKey -> 错误文案数组 } */
+    errorMap: Record<string, Record<string, string[]>>;
+    /** 首个错误单元格的 namePath（用于滚动定位），无错误为 null */
+    firstErrorPath: (string | number)[] | null;
+    /** 首个错误行的 rowKey（用于横向滚动时定位错误行 DOM），无错误为 null */
+    firstErrorRowKey: string | null;
+    /** 首个错误列的 cellKey（names 列为 splitNames，普通列为列名），用于横向滚动定位列，无错误为 null */
+    firstErrorColumnKey: string | null;
+}
+/**
+ * 对 form store 中 name 路径下的全量数组数据，逐行逐列用真实规则校验（脱离 DOM）。
+ */
+export declare const validateAllRows: ({ form, name, columns, config, }: ValidateAllParams) => Promise<ValidateAllResult>;
+/**
+ * 外部错误存储：以 rowKey + cellKey 为键持久化真实报错文案。
+ * 它是「报错常驻」的真实来源——脱离 antd Field 实体生命周期，
+ * 行卸载后仍保留，重新挂载时回填显示。
+ */
+export interface ErrorStore {
+    /** 读取某单元格错误文案 */
+    get(rowKey: string | number, cellKey: string): string[] | undefined;
+    /** 读取整行错误 */
+    getRow(rowKey: string | number): Record<string, string[]> | undefined;
+    /** 全量替换（来自一次完整校验） */
+    setAll(errorMap: Record<string, Record<string, string[]>>): void;
+    /** 清理某单元格（用户修正后调用），整行清空时移除该行 */
+    clearCell(rowKey: string | number, cellKey: string): void;
+    /** 清空所有 */
+    clearAll(): void;
+    /** 是否为空 */
+    isEmpty(): boolean;
+}
+export declare const createErrorStore: () => ErrorStore;
+interface RunUnifiedParams extends ValidateAllParams {
+    errorStore: ErrorStore;
+}
+/**
+ * 统一校验入口：对全量数据跑真实规则，写入 errorStore，返回是否有错与首个错误行索引。
+ * 供隐藏聚合校验字段在 form.validateFields() 时调用，从而覆盖视口外未挂载的行。
+ */
+export declare const runUnifiedValidation: ({ form, name, columns, config, errorStore, }: RunUnifiedParams) => Promise<{
+    hasError: boolean;
+    firstErrorIndex: number | null;
+    firstErrorRowKey: string | null;
+    firstErrorColumnKey: string | null;
+}>;
+export {};

package/es/ProEnum/components/Group.d.ts

@@ -0,0 +1,10 @@
+import type { ProEnumType } from '../propsType';
+interface Props extends Pick<ProEnumType, 'id' | 'value' | 'onChange' | 'dataSource'> {
+    fieldValue: string;
+    fieldLabel: string;
+    disabled?: boolean;
+    allowClear?: boolean;
+    button?: boolean;
+}
+declare const Group: (props: Props) => import("react/jsx-runtime").JSX.Element;
+export default Group;

package/es/ProEnum/components/Tag.d.ts

@@ -0,0 +1,7 @@
+import type { ProEnumType } from '../propsType';
+interface Props extends Pick<ProEnumType, 'id' | 'value' | 'onChange' | 'dataSource'> {
+    fieldValue: string;
+    fieldLabel: string;
+}
+declare const ProEnumTag: (props: Props) => import("react/jsx-runtime").JSX.Element;
+export default ProEnumTag;

package/es/ProEnum/hooks/useEnum.d.ts

@@ -0,0 +1,29 @@
+import { DataOptionType } from '../propsType';
+/**
+ * input code output [DataOption[],getEnumLabel]
+ * @param code
+ * const [options,fn] = useEnum("code")
+ */
+declare function useEnum(code: string): [DataOptionType[], (val: string, showCodeName?: boolean) => string];
+/**
+ * input codes output { code1:DataOption[],code2:DataOption[] }
+ * @param codes
+ * const dicsMap = useEnum(["code1","code2"])
+ */
+declare function useEnum(codes: string[]): Record<string, DataOptionType[]>;
+/**
+ * input code、value output label
+ * @param code
+ * @param value
+ * @param compose 展示 value-label
+ */
+declare function useEnum(code: string, value?: string, compose?: boolean): [string, DataOptionType];
+/**
+ * input code、values array output [labels array, options array]
+ * @param code
+ * @param values 值数组
+ * @param compose 展示 value-label
+ * @returns [标签数组, 选项数组]
+ */
+declare function useEnum(code: string, values: (string | number)[], compose?: boolean): [string[], DataOptionType[]];
+export default useEnum;

package/es/ProEnum/hooks/useEnumRequest.d.ts

@@ -0,0 +1,4 @@
+import type { ProEnumConfigType } from '../propsType';
+import '../utils/eventCenter';
+declare const useEnumRequest: (props: ProEnumConfigType, dispatch: any) => import("ahooks/lib/useRequest/src/types").Result<any, any>;
+export default useEnumRequest;

package/es/ProEnum/hooks/useFrequentEnumRequest.d.ts

@@ -0,0 +1,14 @@
+import type { FrequentEnumConfig } from '../propsType';
+type StorageType = 'localStorage' | 'sessionStorage' | 'indexedDB';
+interface UseFrequentEnumRequestProps {
+    frequentEnums?: FrequentEnumConfig;
+    fieldNames: any;
+    clear: boolean;
+    storage: StorageType;
+    cacheKey: string;
+    dispatch: any;
+    dics: any;
+    dataSource: any;
+}
+declare const useFrequentEnumRequest: (props: UseFrequentEnumRequestProps, dispatch: any) => import("ahooks/lib/useRequest/src/types").Result<any, any>;
+export default useFrequentEnumRequest;

package/es/ProEnum/index.d.ts

@@ -0,0 +1,10 @@
+import useEnum from './hooks/useEnum';
+import getEnum from './utils/getEnum';
+import type { ProEnumType } from './propsType';
+declare const ProEnum: {
+    (props: ProEnumType): import("react/jsx-runtime").JSX.Element;
+    getEnumLabel: (code: string | string[], value: any, compose?: boolean, fieldNameLabel?: string, fieldNameValue?: string) => import("react/jsx-runtime").JSX.Element;
+    useEnum: typeof useEnum;
+    getEnum: typeof getEnum;
+};
+export default ProEnum;

package/es/ProEnum/index.js

@@ -165,7 +165,7 @@ const ProEnum = props => {
     switch (type) {
       case 'ProSelect':
         return /*#__PURE__*/_jsx(ProSelect, {
-          ...enumProps,
+          ..._omit(enumProps, ['ref']),
           otherProps: otherProps,
           dataSource: list,
           fieldNames: {

package/es/ProEnum/propsType.d.ts

@@ -0,0 +1,320 @@
+import React, { ReactNode } from 'react';
+import { RadioProps, CheckboxProps, SegmentedProps } from 'antd';
+import { Service, Options } from 'ahooks/lib/useRequest/src/types';
+import type { ProFormOtherType } from '../ProForm/propsType';
+import type { PropSelectType } from '../ProSelect/propsType';
+/**
+ * @description 数据选项类型
+ */
+export interface DataOptionType {
+    /**
+     * @description 展示标签
+     * @default -
+     */
+    label?: string;
+    /**
+     * @description 选项值
+     * @default -
+     */
+    value?: string;
+    /**
+     * @description 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * @description 允许扩展字段
+     */
+    [key: string]: any;
+}
+/**
+ * @description 频繁变动的枚举配置
+ */
+export interface FrequentEnumConfig {
+    /**
+     * @description 需要替换的缓存枚举code列表
+     */
+    enums: string[];
+    /**
+     * @description 请求服务函数
+     */
+    service: Service<any, any>;
+    /**
+     * @description 请求选项配置
+     */
+    options?: Options<any, any>;
+    /**
+     * @description 对频繁枚举返回数据进行格式化（独立于全局transformResponse）
+     * @param data 后台返回的数据
+     * @returns 格式化后的枚举数据
+     * @default -
+     */
+    transformResponse?: (data: any) => Record<string, DataOptionType[]> | Promise<Record<string, DataOptionType[]>>;
+}
+/**
+ * @description ProEnum配置类型
+ */
+export interface ProEnumConfigType {
+    /**
+     * @description 是否枚举主入口
+     * @default false
+     */
+    main?: boolean;
+    /**
+     * @description 是否使用主入口枚举
+     * @default false
+     */
+    share?: boolean;
+    /**
+     * @description 是否开启调试 log
+     * @default false
+     */
+    debugger?: boolean;
+    /**
+     * @description 是否对数据进行清洗
+     * @default false
+     */
+    clear?: boolean;
+    /**
+     * @description 字段别名
+     * @default { label: 'label', value: 'value', children: 'children' }
+     */
+    fieldNames?: {
+        label?: string;
+        value?: string;
+        children?: string;
+        [key: string]: string | undefined;
+    };
+    /**
+     * @description 缓存的key、默认 zat-design-pro-component-cacheKey
+     * @default "zat-design-pro-component-cacheKey"
+     */
+    cacheKey: string;
+    /**
+     * @description 刷新请求、设置后每次进入都会重新请求
+     * @default false
+     */
+    requestRefresh: boolean;
+    /**
+     * @description 存储位置、不设置、默认读取 globalConfig 里面的
+     * @default "localStorage"
+     */
+    storage: 'localStorage' | 'sessionStorage' | 'indexedDB';
+    /**
+     * @description 默认静态枚举数据
+     * @default {}
+     */
+    dataSource: Record<string, DataOptionType[]>;
+    /**
+     * @description 对后台返回数据进行格式化
+     * @param data 后台返回的数据
+     * @returns 格式化后的枚举数据
+     * @default -
+     */
+    transformResponse?: (data: {
+        data: Record<string, DataOptionType[]>;
+    }) => Record<string, DataOptionType[]> | Promise<Record<string, DataOptionType[]>>;
+    /**
+     * @description 批量请求枚举接口
+     * @default -
+     */
+    useRequest?: {
+        /**
+         * @description 请求服务函数
+         */
+        service: Service<any, any>;
+        /**
+         * @description 请求选项配置
+         */
+        options?: Options<any, any> & {
+            /**
+             * @description 指定请求的枚举码
+             */
+            codes?: string[];
+            /**
+             * @description 忽略的枚举码
+             */
+            ignoreCodes?: string[];
+        };
+    };
+    /**
+     * @description 频繁变动的枚举配置
+     * @default -
+     */
+    frequentEnums?: FrequentEnumConfig;
+    /**
+     * @description 字典数据
+     * @default {}
+     */
+    dics: Record<string, DataOptionType[]>;
+}
+/**
+ * @description 枚举组件类型枚举
+ */
+type EnumComponentType = 'ProSelect' | 'Radio' | 'Checkbox' | 'Tag' | 'Group' | 'Segmented';
+/**
+ * @description ProEnum基础属性类型
+ */
+export interface ProEnumBaseType {
+    /**
+     * @description 组件展示类型、默认 ProSelect
+     * @default "ProSelect"
+     */
+    type?: EnumComponentType;
+    /**
+     * @description 用于自定义组件
+     * @default -
+     */
+    component?: ReactNode;
+    /**
+     * @description 用于提交 code
+     * @default -
+     */
+    code?: string | string[];
+    /**
+     * @description 字段别名
+     * @default -
+     */
+    fieldNames?: Record<string, string>;
+    /**
+     * @description 是否查看模式
+     * @default false
+     */
+    isView?: boolean;
+    /**
+     * @description 数据源
+     * @default -
+     */
+    dataSource?: DataOptionType[];
+    /**
+     * @description 当前值
+     * @default -
+     */
+    value: any;
+    /**
+     * @description 值变化回调
+     * @default -
+     */
+    onChange?: (value: any) => void;
+    /**
+     * @description 远程请求接口
+     * @default -
+     */
+    useRequest?: {
+        /**
+         * @description 请求服务函数
+         */
+        service: Service<any, any>;
+        /**
+         * @description 请求选项
+         */
+        options?: Options<any, any>;
+    };
+    /**
+     * @description 对后台返回数据进行格式化
+     * @param data 后台返回的数据
+     * @returns 格式化后的选项数据
+     * @default -
+     */
+    transformResponse?: (data: any) => DataOptionType[];
+    /**
+     * @description 是否合并数据
+     * @default false
+     */
+    merge?: boolean;
+    /**
+     * @description 查看模式下为空展示
+     * @default "-"
+     */
+    viewEmpty?: React.ReactNode;
+    /**
+     * @description 自定义选项渲染
+     * @default -
+     */
+    optionRender?: any;
+    /**
+     * @description 显示 code-value 形式
+     * @default false
+     */
+    showCodeName?: boolean;
+    /**
+     * @description 支持 {label:xx, value: xx} 形式
+     * @default false
+     */
+    labelInValue?: boolean;
+    /**
+     * @description 其他表单属性
+     * @default -
+     */
+    otherProps?: ProFormOtherType;
+    /**
+     * @description 是否允许清除
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * @description 组件ID
+     * @default -
+     */
+    id?: string;
+    /**
+     * @description 默认值
+     * @default -
+     */
+    defaultValue?: any;
+}
+/**
+ * @description ProSelect类型映射
+ */
+export type PropProSelectsMapType = {
+    /**
+     * @description 类型为ProSelect
+     * @default "ProSelect"
+     */
+    type?: 'ProSelect';
+} & PropSelectType;
+/**
+ * @description Radio类型映射
+ */
+export type PropRadioPropsMapType = {
+    /**
+     * @description 类型为Radio
+     * @default "Radio"
+     */
+    type?: 'Radio';
+} & RadioProps;
+/**
+ * @description Checkbox类型映射
+ */
+export type CheckboxPropsMapType = {
+    /**
+     * @description 类型为Checkbox
+     * @default "Checkbox"
+     */
+    type?: 'Checkbox';
+} & CheckboxProps;
+/**
+ * @description Tag类型映射
+ */
+export interface TagPropsMapType {
+    /**
+     * @description 类型为Tag或Group
+     * @default -
+     */
+    type?: 'Tag' | 'Group';
+}
+/**
+ * @description Segmented类型映射
+ */
+export type SegmentedPropsMapType = {
+    /**
+     * @description 类型为Segmented
+     * @default "Segmented"
+     */
+    type?: 'Segmented';
+} & Omit<SegmentedProps, 'options'>;
+/**
+ * @description ProEnum组件属性类型
+ */
+export type ProEnumType = Omit<ProEnumBaseType, 'type'> & (PropProSelectsMapType | PropRadioPropsMapType | CheckboxPropsMapType | TagPropsMapType | SegmentedPropsMapType);
+export {};

package/es/ProEnum/utils/eventCenter.d.ts

@@ -0,0 +1 @@
+export {};