@ant-design/pro-components 3.1.12-0 → 3.1.13-0

package/es/layout/components/Help/index.d.ts

@@ -46,4 +46,4 @@ export type ProHelpContentPanelProps = {
 };
 export declare const ProHelp: <ValueTypeMap = {
     text: any;
-}>({ dataSource, valueTypeMap, onLoadContext, ...props }: ProHelpProps<ValueTypeMap>) => import("react/jsx-runtime").JSX.Element;
+}>({ dataSource, valueTypeMap, onLoadContext, ...props }: ProHelpProps<ValueTypeMap>) => React.JSX.Element;

package/es/layout/components/PageContainer/index.d.ts

@@ -79,5 +79,5 @@ declare const ProBreadcrumb: React.FC<BreadcrumbProps>;
 declare const PageContainer: React.FC<PageContainerProps>;
 declare const ProPageHeader: (props: PageContainerProps & {
     prefixedClassName: string;
-}) => import("react/jsx-runtime").JSX.Element | null;
+}) => React.JSX.Element | null;
 export { PageContainer, ProBreadcrumb, ProPageHeader };

package/es/layout/components/PageHeader/style/index.d.ts

@@ -7,7 +7,7 @@ export interface PageHeaderToken extends ProAliasToken {
     pageHeaderBgGhost: string;
     pageHeaderPaddingBreadCrumb: number;
     pageHeaderColorBack: string;
-    pageHeaderFontSizeHeaderTitle: number;
+    pageHeaderFontSizeHeaderTitle: number | string;
     pageHeaderFontSizeHeaderSubTitle: number;
     pageHeaderPaddingContentPadding: number;
 }

package/es/layout/components/SettingDrawer/LayoutChange.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { ProSettings } from '../../defaultSettings';
 import type { SettingItemProps } from './index';
-export declare const renderLayoutSettingItem: (item: SettingItemProps) => import("react/jsx-runtime").JSX.Element;
+export declare const renderLayoutSettingItem: (item: SettingItemProps) => React.JSX.Element;
 declare const LayoutSetting: React.FC<{
     settings: Partial<ProSettings>;
     changeSetting: (key: string, value: any, hideLoading?: boolean) => void;

package/es/layout/components/SettingDrawer/icon/group.d.ts

@@ -1 +1,2 @@
-export declare function GroupIcon(): import("react/jsx-runtime").JSX.Element;
+/// <reference types="react" />
+export declare function GroupIcon(): import("react").JSX.Element;

package/es/layout/components/SettingDrawer/icon/sub.d.ts

@@ -1 +1,2 @@
-export declare function SubIcon(): import("react/jsx-runtime").JSX.Element;
+/// <reference types="react" />
+export declare function SubIcon(): import("react").JSX.Element;

package/es/layout/components/SettingDrawer/index.js

@@ -1,10 +1,9 @@
 import { CloseOutlined, CopyOutlined, NotificationOutlined, SettingOutlined } from '@ant-design/icons';
 import { omit, useControlledState } from '@rc-component/util';
-import { useUrlSearchParams } from '@umijs/use-params';
 import { Alert, Button, Divider, Drawer, List, Switch, message } from 'antd';
 import { clsx } from 'clsx';
 import React, { useCallback, useEffect, useRef, useState } from 'react';
-import { isBrowser, merge, useRefFunction } from "../../../utils";
+import { isBrowser, merge, useRefFunction, useUrlSearchParams } from "../../../utils";
 import { defaultSettings } from "../../defaultSettings";
 import { gLocaleObject, getLanguage } from "../../locales";
 import { genStringToTheme } from "../../utils/utils";

package/es/layout/components/SiderMenu/Arrow.d.ts

@@ -1,2 +1,3 @@
-declare function ArrowSvgIcon(): import("react/jsx-runtime").JSX.Element;
+/// <reference types="react" />
+declare function ArrowSvgIcon(): import("react").JSX.Element;
 export { ArrowSvgIcon };

package/es/list/Item.d.ts

@@ -15,7 +15,7 @@ export type RenderExpandIconProps<RecordType> = {
     record: RecordType;
     hashId: string;
 };
-export declare function renderExpandIcon<RecordType>({ prefixCls, expandIcon, onExpand, expanded, record, hashId, }: RenderExpandIconProps<RecordType>): import("react/jsx-runtime").JSX.Element;
+export declare function renderExpandIcon<RecordType>({ prefixCls, expandIcon, onExpand, expanded, record, hashId, }: RenderExpandIconProps<RecordType>): React.JSX.Element;
 export type ItemProps<RecordType> = {
     title?: React.ReactNode;
     subTitle?: React.ReactNode;
@@ -51,5 +51,6 @@ export type ItemProps<RecordType> = {
     itemHeaderRender?: ((item: RecordType, index: number, defaultDom: React.JSX.Element | null) => React.ReactNode) | false;
     itemTitleRender?: ((item: RecordType, index: number, defaultDom: React.JSX.Element | null) => React.ReactNode) | false;
 };
-declare function ProListItem<RecordType>(props: ItemProps<RecordType>): import("react/jsx-runtime").JSX.Element;
+declare function ProListItemInner<RecordType>(props: ItemProps<RecordType>): React.JSX.Element;
+declare const ProListItem: typeof ProListItemInner;
 export default ProListItem;

package/es/list/Item.js

@@ -2,9 +2,10 @@ import { RightOutlined } from '@ant-design/icons';
 import { useControlledState } from '@rc-component/util';
 import { ConfigProvider, Skeleton } from 'antd';
 import { clsx } from 'clsx';
-import React, { useCallback, useContext, useMemo } from 'react';
+import React, { memo, useContext, useMemo } from 'react';
 import { CheckCard } from "../card";
 import { ProProvider } from "../provider";
+import { useRefFunction } from "../utils";
 import { ProListItem as BaseListItem, ProListItemMeta as BaseListItemMeta } from "./ProListBase";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
@@ -39,7 +40,7 @@ export function renderExpandIcon({
     children: icon
   });
 }
-function ProListItem(props) {
+function ProListItemInner(props) {
   const {
     getPrefixCls
   } = useContext(ConfigProvider.ConfigContext);
@@ -91,13 +92,13 @@ function ProListItem(props) {
     expandedRowClassName
   } = expandableConfig || {};
   const [expanded, onExpandInner] = useControlledState(!!propsExpand, propsExpand);
-  const onExpand = useCallback(updater => {
+  const onExpand = useRefFunction(updater => {
     onExpandInner(prev => {
       const next = typeof updater === 'function' ? updater(prev) : updater;
       propsOnExpand?.(next);
       return next;
     });
-  }, [propsOnExpand]);
+  });
   const className = clsx({
     [`${defaultClassName}-selected`]: !cardProps && selected,
     [`${defaultClassName}-type-${type}`]: !!type,
@@ -126,7 +127,7 @@ function ProListItem(props) {
     avatar: avatar,
     title: metaTitle,
     description: description && needExpanded && /*#__PURE__*/_jsx("div", {
-      className: clsx(`${className}-description`, hashId),
+      className: clsx(`${defaultClassName}-description`, hashId),
       children: description
     })
   }) : null;
@@ -234,4 +235,5 @@ function ProListItem(props) {
     })
   });
 }
+const ProListItem = /*#__PURE__*/memo(ProListItemInner);
 export default ProListItem;

package/es/list/ListView.d.ts

@@ -8,10 +8,9 @@ import type { ActionType } from '../table';
 import type { GetComponentProps } from './index';
 import type { ItemProps } from './Item';
 import type { ListProps } from './ProListBase';
-type AntdListProps<RecordType> = Omit<ListProps<RecordType>, 'rowKey'>;
 /** 自定义列表项渲染，defaultDom 为 ProList 默认渲染的列表项元素 */
 export type ProListItemRender<RecordType> = (item: RecordType, index: number, defaultDom: React.ReactElement) => React.ReactNode;
-export type ListViewProps<RecordType> = Omit<AntdListProps<RecordType>, 'renderItem'> & Pick<TableProps<RecordType>, 'columns' | 'dataSource' | 'expandable' | 'pagination'> & {
+export type ListViewProps<RecordType> = Omit<ListProps<RecordType>, 'rowKey' | 'renderItem'> & Pick<TableProps<RecordType>, 'columns' | 'dataSource' | 'expandable' | 'pagination'> & {
     rowKey?: string | keyof RecordType | GetRowKey<RecordType>;
     rowSelection?: TableRowSelection<RecordType>;
     prefixCls?: string;
@@ -28,5 +27,5 @@ export type ListViewProps<RecordType> = Omit<AntdListProps<RecordType>, 'renderI
     pagination?: PaginationConfig;
     hashId?: string;
 };
-declare function ListView<RecordType extends AnyObject>(props: ListViewProps<RecordType>): import("react/jsx-runtime").JSX.Element;
+declare function ListView<RecordType extends AnyObject>(props: ListViewProps<RecordType>): React.JSX.Element;
 export default ListView;

package/es/list/ListView.js

@@ -3,6 +3,7 @@ import { ConfigProvider } from 'antd';
 import { clsx } from 'clsx';
 import React, { useContext } from 'react';
 import { ProProvider } from "../provider";
+import { useRefFunction } from "../utils";
 import useLazyKVMap from "../utils/useLazyKVMap";
 import usePagination from "../utils/usePagination";
 import useSelection from "../utils/useSelection";
@@ -47,6 +48,26 @@ function ListView(props) {
     return (record, index) => record[rowKey] || index;
   }, [rowKey]);
   const [getRecordByKey] = useLazyKVMap(dataSource, 'children', getRowKey);
+  const listSlotColumns = React.useMemo(() => {
+    if (!columns?.length) return [];
+    const slots = [];
+    for (const column of columns) {
+      const {
+        listSlot
+      } = column;
+      if (listSlot && PRO_LIST_KEYS_MAP.has(listSlot)) {
+        slots.push(column);
+      }
+    }
+    return slots;
+  }, [columns]);
+  const gridCardStaticProps = React.useMemo(() => {
+    if (!rest.grid) return null;
+    return {
+      ...itemCardProps,
+      ...rest.grid
+    };
+  }, [itemCardProps, rest.grid]);
 
   // 合并分页配置，兼容 antd 的分页
   const [mergedPagination] = usePagination(dataSource.length, () => {}, pagination);
@@ -96,8 +117,8 @@ function ListView(props) {
     return [];
   });
   const mergedExpandedKeys = React.useMemo(() => new Set(expandedRowKeys || innerExpandedKeys || []), [expandedRowKeys, innerExpandedKeys]);
-  const onTriggerExpand = React.useCallback(record => {
-    const key = getRowKey(record, dataSource.indexOf(record));
+  const onTriggerExpand = useRefFunction((record, rowIndex) => {
+    const key = getRowKey(record, rowIndex);
     const hasKey = mergedExpandedKeys.has(key);
     const nextKeys = new Set(mergedExpandedKeys);
     if (hasKey) {
@@ -109,82 +130,73 @@ function ListView(props) {
     setInnerExpandedKeys(newExpandedKeys);
     onExpand?.(!hasKey, record);
     onExpandedRowsChange?.(newExpandedKeys);
-  }, [getRowKey, mergedExpandedKeys, dataSource, onExpand, onExpandedRowsChange]);
+  });
 
   /** 展开收起功能区域 end */
 
   /** 这个是 选择框的 render 方法 为了兼容 antd 的 table,用了同样的渲染逻辑 所以看起来有点奇怪 */
   const selectItemDom = selectItemRender([])[0];
+  const renderListItem = useRefFunction((item, index) => {
+    const listItemProps = {
+      className: typeof rowClassName === 'function' ? rowClassName(item, index) : rowClassName
+    };
+    listSlotColumns.forEach(column => {
+      const dataIndex = column.dataIndex || column.listSlot || column.key;
+      const rawData = Array.isArray(dataIndex) ? get(item, dataIndex) : item[dataIndex];
+      const data = column.render ? column.render(rawData, item, index) : rawData;
+      const propKey = column.listSlot === 'aside' ? 'extra' : column.listSlot;
+      if (data !== '-') listItemProps[propKey] = data;
+    });
+    const checkboxDom = selectItemDom?.render?.(item, item, index);
+    const {
+      isEditable,
+      recordKey
+    } = actionRef.current?.isEditable({
+      ...item,
+      index
+    }) || {};
+    const itemKey = getRowKey(item, index);
+    const isChecked = selectedKeySet.has(itemKey);
+    const cardProps = gridCardStaticProps ? {
+      ...gridCardStaticProps,
+      checked: isChecked,
+      onChange: /*#__PURE__*/React.isValidElement(checkboxDom) ? changeChecked => checkboxDom?.props?.onChange({
+        nativeEvent: {},
+        target: {
+          checked: changeChecked
+        },
+        changeChecked
+      }) : undefined
+    } : undefined;
+    const defaultDom = /*#__PURE__*/_jsx(ProListItem, {
+      cardProps: cardProps,
+      ...listItemProps,
+      recordKey: recordKey,
+      isEditable: isEditable || false,
+      expandable: expandableConfig,
+      expand: mergedExpandedKeys.has(itemKey),
+      onExpand: () => onTriggerExpand(item, index),
+      index: index,
+      record: item,
+      item: item,
+      itemTitleRender: itemTitleRender,
+      itemHeaderRender: itemHeaderRender,
+      rowSupportExpand: !rowExpandable || rowExpandable(item),
+      selected: selectedKeySet.has(itemKey),
+      checkbox: checkboxDom,
+      onRow: onRow,
+      onItem: onItem
+    }, recordKey);
+    return itemRender ? itemRender(item, index, defaultDom) : defaultDom;
+  });
   return /*#__PURE__*/_jsx(ProListContainer, {
     ...rest,
+    suppressContainerDataSlice: true,
     hashId: hashId,
     className: clsx(getPrefixCls('pro-list-container', customizePrefixCls), hashId, rest.className),
     dataSource: pageData,
     pagination: pagination && mergedPagination,
-    renderItem: (item, index) => {
-      const listItemProps = {
-        className: typeof rowClassName === 'function' ? rowClassName(item, index) : rowClassName
-      };
-      columns?.forEach(column => {
-        const {
-          listSlot
-        } = column;
-        if (!PRO_LIST_KEYS_MAP.has(listSlot)) {
-          return;
-        }
-        const dataIndex = column.dataIndex || listSlot || column.key;
-        const rawData = Array.isArray(dataIndex) ? get(item, dataIndex) : item[dataIndex];
-
-        // 调用protable的列配置渲染数据
-        const data = column.render ? column.render(rawData, item, index) : rawData;
-        // aside 是 extra 的新名称，映射到 Item 的 extra 属性
-        const propKey = column.listSlot === 'aside' ? 'extra' : column.listSlot;
-        if (data !== '-') listItemProps[propKey] = data;
-      });
-      const checkboxDom = selectItemDom?.render?.(item, item, index);
-      const {
-        isEditable,
-        recordKey
-      } = actionRef.current?.isEditable({
-        ...item,
-        index
-      }) || {};
-      const itemKey = getRowKey(item, index);
-      const isChecked = selectedKeySet.has(itemKey);
-      const cardProps = rest.grid ? {
-        ...itemCardProps,
-        ...rest.grid,
-        checked: isChecked,
-        onChange: /*#__PURE__*/React.isValidElement(checkboxDom) ? changeChecked => checkboxDom?.props?.onChange({
-          nativeEvent: {},
-          target: {
-            checked: changeChecked
-          },
-          changeChecked
-        }) : undefined
-      } : undefined;
-      const defaultDom = /*#__PURE__*/_jsx(ProListItem, {
-        cardProps: cardProps,
-        ...listItemProps,
-        recordKey: recordKey,
-        isEditable: isEditable || false,
-        expandable: expandableConfig,
-        expand: mergedExpandedKeys.has(itemKey),
-        onExpand: () => onTriggerExpand(item),
-        index: index,
-        record: item,
-        item: item,
-        itemTitleRender: itemTitleRender,
-        itemHeaderRender: itemHeaderRender,
-        rowSupportExpand: !rowExpandable || rowExpandable(item),
-        selected: selectedKeySet.has(itemKey),
-        checkbox: checkboxDom,
-        onRow: onRow,
-        onItem: onItem
-      }, recordKey);
-      const renderedContent = itemRender ? itemRender(item, index, defaultDom) : defaultDom;
-      return renderedContent;
-    }
+    renderItem: renderListItem
   });
 }
 export default ListView;

package/es/list/ProListBase.d.ts

@@ -42,6 +42,10 @@ export interface ListProps<T = any> {
     footer?: React.ReactNode;
     locale?: ListLocale;
     hashId?: string;
+    /**
+     * 为 true 时认为 dataSource 已由上游（ListView）按分页处理好，容器内不再二次 slice。
+     */
+    suppressContainerDataSlice?: boolean;
 }
 export declare const ProListContext: React.Context<{
     grid?: ListGridType | undefined;

package/es/list/ProListBase.js

@@ -142,6 +142,7 @@ const ProListContainerInner = /*#__PURE__*/React.forwardRef(function ProListCont
     renderItem,
     locale,
     hashId: propHashId,
+    suppressContainerDataSlice,
     ...rest
   } = props;
   const {
@@ -166,6 +167,9 @@ const ProListContainerInner = /*#__PURE__*/React.forwardRef(function ProListCont
     if (!pagination || !dataSource.length) {
       return dataSource;
     }
+    if (suppressContainerDataSlice) {
+      return dataSource;
+    }
     const pageSize = paginationProps.pageSize ?? 10;
     const total = paginationProps.total ?? 0;
     // 父组件已分页（如 ListView 传入 pageData）时不再二次 slice
@@ -174,7 +178,7 @@ const ProListContainerInner = /*#__PURE__*/React.forwardRef(function ProListCont
     }
     const start = (currentPage - 1) * pageSize;
     return dataSource.slice(start, start + pageSize);
-  }, [dataSource, pagination, currentPage, paginationProps.pageSize, paginationProps.total]);
+  }, [dataSource, pagination, currentPage, paginationProps.pageSize, paginationProps.total, suppressContainerDataSlice]);
   const renderInternalItem = (item, index) => {
     if (!renderItem) return null;
     const key = getRowKey(item, index, rowKey);
@@ -309,7 +313,7 @@ const ProListContainerInner = /*#__PURE__*/React.forwardRef(function ProListCont
   const contextValue = useMemo(() => ({
     grid,
     itemLayout
-  }), [JSON.stringify(grid), itemLayout]);
+  }), [itemLayout, grid?.gutter, grid?.column, grid?.xs, grid?.sm, grid?.md, grid?.lg, grid?.xl, grid?.xxl]);
   const classString = clsx(prefixCls, {
     [`${prefixCls}-vertical`]: itemLayout === 'vertical',
     [`${prefixCls}-${sizeCls}`]: sizeCls,

package/es/list/index.d.ts

@@ -1,11 +1,10 @@
 import React from 'react';
 import type { CheckCardProps } from '../card';
 import type { ProColumnType, ProTableProps } from '../table';
-import type { LabelTooltipType } from '../utils';
+import { type LabelTooltipType } from '../utils';
 import type { ItemProps } from './Item';
 import { type ProListItemRender } from './ListView';
 import type { ListProps } from './ProListBase';
-export type AntdListProps<RecordType> = Omit<ListProps<RecordType>, 'rowKey'>;
 export type ProListMeta<T> = Pick<ProColumnType<T>, 'dataIndex' | 'valueType' | 'render' | 'search' | 'title' | 'valueEnum' | 'editable' | 'fieldProps' | 'formItemProps' | 'formItemRender'> & {
     key?: React.Key;
 };
@@ -29,7 +28,7 @@ export type ProListMetas<T = any> = BaseProListMetas<T> & {
     [key in keyof T]?: IsAny<T> extends true ? ProListMetaAction<T> : ProListMeta<T>;
 };
 export type GetComponentProps<RecordType> = (record: RecordType, index: number) => React.HTMLAttributes<HTMLElement>;
-export type ProListProps<RecordType = any, Params = Record<string, any>, ValueType = 'text'> = Omit<ProTableProps<RecordType, Params, ValueType>, 'size' | 'footer'> & AntdListProps<RecordType> & {
+export type ProListProps<RecordType = any, Params = Record<string, any>, ValueType = 'text'> = Omit<ProTableProps<RecordType, Params, ValueType>, 'size' | 'footer'> & Omit<ListProps<RecordType>, 'rowKey'> & {
     tooltip?: LabelTooltipType | string;
     /**
      * @deprecated 推荐使用 columns + listSlot 的方式，与 ProTable 共用同一套 API
@@ -56,8 +55,8 @@ export type ProListProps<RecordType = any, Params = Record<string, any>, ValueTy
 export type Key = React.Key;
 export type TriggerEventHandler<RecordType> = (record: RecordType) => void;
 /** BaseProList 默认隐藏卡片、搜索和工具栏 */
-declare function BaseProList<RecordType extends Record<string, any>, U extends Record<string, any> = Record<string, any>>(props: ProListProps<RecordType, U>): import("react/jsx-runtime").JSX.Element;
-declare function ProList<RecordType extends Record<string, any>, U extends Record<string, any> = Record<string, any>>(props: ProListProps<RecordType, U>): import("react/jsx-runtime").JSX.Element;
+declare function BaseProList<RecordType extends Record<string, any>, U extends Record<string, any> = Record<string, any>>(props: ProListProps<RecordType, U>): React.JSX.Element;
+declare function ProList<RecordType extends Record<string, any>, U extends Record<string, any> = Record<string, any>>(props: ProListProps<RecordType, U>): React.JSX.Element;
 export type { ProListItemRender } from './ListView';
 export { BaseProList, ProList };
 export default ProList;

package/es/list/index.js

@@ -4,6 +4,7 @@ import { clsx } from 'clsx';
 import React, { useContext, useEffect, useImperativeHandle, useMemo, useRef } from 'react';
 import { ProConfigProvider } from "../provider";
 import ProTable from "../table";
+import { useRefFunction } from "../utils";
 import ListView from "./ListView";
 import { useStyle } from "./style/index";
 
@@ -109,6 +110,39 @@ function InternalProList(props) {
     [`${prefixCls}-no-split`]: !split,
     [`${prefixCls}-${variant}`]: variant
   });
+  const renderListTableView = useRefFunction(({
+    columns,
+    size,
+    pagination,
+    rowSelection,
+    dataSource,
+    loading
+  }) => /*#__PURE__*/_jsx(ListView, {
+    grid: grid,
+    itemCardProps: itemCardProps,
+    itemTitleRender: itemTitleRender,
+    prefixCls: props.prefixCls,
+    columns: columns,
+    itemRender: itemRender,
+    actionRef: actionRef,
+    dataSource: dataSource || [],
+    size: size,
+    footer: footer,
+    split: split,
+    variant: variant,
+    rowKey: rowKey,
+    expandable: expandable,
+    rowSelection: propRowSelection === false ? undefined : rowSelection,
+    pagination: pagination,
+    itemLayout: itemLayout,
+    loading: loading,
+    itemHeaderRender: itemHeaderRender,
+    onRow: onRow,
+    onItem: onItem,
+    rowClassName: rowClassName,
+    locale: locale,
+    hashId: hashId
+  }));
   return wrapSSR( /*#__PURE__*/_jsx(ProTable, {
     tooltip: tooltip,
     ...rest,
@@ -121,41 +155,7 @@ function InternalProList(props) {
     className: clsx(className, listClassName),
     columns: proTableColumns,
     rowKey: rowKey,
-    tableViewRender: ({
-      columns,
-      size,
-      pagination,
-      rowSelection,
-      dataSource,
-      loading
-    }) => {
-      return /*#__PURE__*/_jsx(ListView, {
-        grid: grid,
-        itemCardProps: itemCardProps,
-        itemTitleRender: itemTitleRender,
-        prefixCls: props.prefixCls,
-        columns: columns,
-        itemRender: itemRender,
-        actionRef: actionRef,
-        dataSource: dataSource || [],
-        size: size,
-        footer: footer,
-        split: split,
-        variant: variant,
-        rowKey: rowKey,
-        expandable: expandable,
-        rowSelection: propRowSelection === false ? undefined : rowSelection,
-        pagination: pagination,
-        itemLayout: itemLayout,
-        loading: loading,
-        itemHeaderRender: itemHeaderRender,
-        onRow: onRow,
-        onItem: onItem,
-        rowClassName: rowClassName,
-        locale: locale,
-        hashId: hashId
-      });
-    }
+    tableViewRender: renderListTableView
   }));
 }
 

package/es/provider/index.d.ts

@@ -8,9 +8,12 @@ export * from './useStyle';
 export { DeepPartial, ProTokenType };
 /**
  * 用于判断当前是否需要开启哈希（Hash）模式。
- * 首先也会判断当前是否处于测试环境中（通过 process.env.NODE_ENV === 'TEST' 判断），
- * 如果是，则返回 false。否则，直接返回 true 表示需要打开。
- * @returns
+ *
+ * 下列场景返回 `false`（关闭 hash，便于快照/调试）：
+ * - `process.env.NODE_ENV === 'test'`（单元测试快照稳定）
+ * - `process.env.NODE_ENV === 'development'`（本地开发时样式调试更直观）
+ *
+ * 其余环境（含生产、未设置 NODE_ENV）一律返回 `true`。
  */
 export declare const isNeedOpenHash: () => boolean;
 /**
@@ -91,6 +94,7 @@ export type ParamsType = Record<string, any>;
  */
 export type ConfigContextPropsType = {
     intl?: IntlType;
+    /** 自定义或覆盖 valueType → render；键可与内置 `ProFieldBuiltinValueType` 重叠，也可为任意字符串 */
     valueTypeMap?: Record<string, ProRenderFieldPropsType>;
     token: ProAliasToken;
     hashId?: string;
@@ -119,8 +123,6 @@ export declare const ProConfigProvider: React.FC<{
 /**
  * It returns the intl object from the context if it exists, otherwise it returns the intl object for
  * 获取国际化的方法
- * @param locale
- * @param localeMap
  * the current locale
  * @returns The return value of the function is the intl object.
  */