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

package/lib/form/typing.d.ts

@@ -1,6 +1,7 @@
 import type { ColProps, FormItemProps, RowProps } from 'antd';
 import type React from 'react';
-import type { ProFieldProps, ProFieldValueType, ProFormBaseGroupProps, ProSchema, SearchConvertKeyFn } from '../utils';
+import type { ProFieldProps, ProFormBaseGroupProps, ProSchema, SearchConvertKeyFn } from '../utils';
+import type { ProFieldValueType } from '../utils/typing';
 import type { ProFormInstance } from './BaseForm';
 import type { ProFormItemProps } from './components';
 import type { CaptFieldRef } from './components/Captcha';
@@ -143,3 +144,5 @@ export type ProFormFieldItemProps<T = Record<string, any>, K = any> = {
  * load remote data props
  */
 export type ProFormFieldRemoteProps = Pick<ProSchema, 'debounceTime' | 'request' | 'valueEnum' | 'params'>;
+export type { ProFieldBuiltinValueType, ProFieldSchemaLayoutValueType, ProFieldValueObjectType, ProFieldValueType, ProFieldValueTypeInput, } from '../utils/typing';
+export { PRO_FIELD_SCHEMA_LAYOUT_VALUE_TYPES } from '../utils/typing';

package/lib/form/typing.js

@@ -2,4 +2,11 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
+});
+Object.defineProperty(exports, "PRO_FIELD_SCHEMA_LAYOUT_VALUE_TYPES", {
+  enumerable: true,
+  get: function () {
+    return _typing.PRO_FIELD_SCHEMA_LAYOUT_VALUE_TYPES;
+  }
+});
+var _typing = require("../utils/typing");

package/lib/layout/assert/Logo.d.ts

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

package/lib/layout/components/AppsLogoComponents/AppsLogo.d.ts

@@ -1,5 +1,6 @@
+/// <reference types="react" />
 /**
  * 默认的应用列表的图标
  *
  */
-export declare const AppsLogo: () => import("react/jsx-runtime").JSX.Element;
+export declare const AppsLogo: () => import("react").JSX.Element;

package/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/layout/components/SettingDrawer/index.js

@@ -7,7 +7,6 @@ Object.defineProperty(exports, "__esModule", {
 exports.getFormatMessage = exports.SettingDrawer = void 0;
 var _icons = require("@ant-design/icons");
 var _util = require("@rc-component/util");
-var _useParams = require("@umijs/use-params");
 var _antd = require("antd");
 var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
@@ -173,7 +172,7 @@ const SettingDrawer = props => {
     });
   }, [onCollapseChangeCallback]);
   const [language, setLanguage] = (0, _react.useState)((0, _locales.getLanguage)());
-  const [urlParams, setUrlParams] = (0, _useParams.useUrlSearchParams)({}, {
+  const [urlParams, setUrlParams] = (0, _utils.useUrlSearchParams)({}, {
     disabled: disableUrlParams
   });
   const [settingState, setSettingStateInner] = (0, _util.useControlledState)(() => getParamsFromUrl(urlParams, propsSettings || propsDefaultSettings), propsSettings);

package/lib/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/lib/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/lib/list/Item.js

@@ -13,6 +13,7 @@ var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
 var _card = require("../card");
 var _provider = require("../provider");
+var _utils = require("../utils");
 var _ProListBase = require("./ProListBase");
 var _jsxRuntime = require("react/jsx-runtime");
 function renderExpandIcon({
@@ -45,7 +46,7 @@ function renderExpandIcon({
     children: icon
   });
 }
-function ProListItem(props) {
+function ProListItemInner(props) {
   const {
     getPrefixCls
   } = (0, _react.useContext)(_antd.ConfigProvider.ConfigContext);
@@ -97,13 +98,13 @@ function ProListItem(props) {
     expandedRowClassName
   } = expandableConfig || {};
   const [expanded, onExpandInner] = (0, _util.useControlledState)(!!propsExpand, propsExpand);
-  const onExpand = (0, _react.useCallback)(updater => {
+  const onExpand = (0, _utils.useRefFunction)(updater => {
     onExpandInner(prev => {
       const next = typeof updater === 'function' ? updater(prev) : updater;
       propsOnExpand?.(next);
       return next;
     });
-  }, [propsOnExpand]);
+  });
   const className = (0, _clsx.clsx)({
     [`${defaultClassName}-selected`]: !cardProps && selected,
     [`${defaultClassName}-type-${type}`]: !!type,
@@ -132,7 +133,7 @@ function ProListItem(props) {
     avatar: avatar,
     title: metaTitle,
     description: description && needExpanded && /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
-      className: (0, _clsx.clsx)(`${className}-description`, hashId),
+      className: (0, _clsx.clsx)(`${defaultClassName}-description`, hashId),
       children: description
     })
   }) : null;
@@ -240,4 +241,5 @@ function ProListItem(props) {
     })
   });
 }
+const ProListItem = /*#__PURE__*/(0, _react.memo)(ProListItemInner);
 var _default = exports.default = ProListItem;

package/lib/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/lib/list/ListView.js

@@ -11,6 +11,7 @@ var _antd = require("antd");
 var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
 var _provider = require("../provider");
+var _utils = require("../utils");
 var _useLazyKVMap = _interopRequireDefault(require("../utils/useLazyKVMap"));
 var _usePagination = _interopRequireDefault(require("../utils/usePagination"));
 var _useSelection = _interopRequireDefault(require("../utils/useSelection"));
@@ -55,6 +56,26 @@ function ListView(props) {
     return (record, index) => record[rowKey] || index;
   }, [rowKey]);
   const [getRecordByKey] = (0, _useLazyKVMap.default)(dataSource, 'children', getRowKey);
+  const listSlotColumns = _react.default.useMemo(() => {
+    if (!columns?.length) return [];
+    const slots = [];
+    for (const column of columns) {
+      const {
+        listSlot
+      } = column;
+      if (listSlot && _constants.PRO_LIST_KEYS_MAP.has(listSlot)) {
+        slots.push(column);
+      }
+    }
+    return slots;
+  }, [columns]);
+  const gridCardStaticProps = _react.default.useMemo(() => {
+    if (!rest.grid) return null;
+    return {
+      ...itemCardProps,
+      ...rest.grid
+    };
+  }, [itemCardProps, rest.grid]);
 
   // 合并分页配置，兼容 antd 的分页
   const [mergedPagination] = (0, _usePagination.default)(dataSource.length, () => {}, pagination);
@@ -104,8 +125,8 @@ function ListView(props) {
     return [];
   });
   const mergedExpandedKeys = _react.default.useMemo(() => new Set(expandedRowKeys || innerExpandedKeys || []), [expandedRowKeys, innerExpandedKeys]);
-  const onTriggerExpand = _react.default.useCallback(record => {
-    const key = getRowKey(record, dataSource.indexOf(record));
+  const onTriggerExpand = (0, _utils.useRefFunction)((record, rowIndex) => {
+    const key = getRowKey(record, rowIndex);
     const hasKey = mergedExpandedKeys.has(key);
     const nextKeys = new Set(mergedExpandedKeys);
     if (hasKey) {
@@ -117,82 +138,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 = (0, _utils.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) ? (0, _util.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.default.isValidElement(checkboxDom) ? changeChecked => checkboxDom?.props?.onChange({
+        nativeEvent: {},
+        target: {
+          checked: changeChecked
+        },
+        changeChecked
+      }) : undefined
+    } : undefined;
+    const defaultDom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Item.default, {
+      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__*/(0, _jsxRuntime.jsx)(_ProListBase.ProListContainer, {
     ...rest,
+    suppressContainerDataSlice: true,
     hashId: hashId,
     className: (0, _clsx.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 (!_constants.PRO_LIST_KEYS_MAP.has(listSlot)) {
-          return;
-        }
-        const dataIndex = column.dataIndex || listSlot || column.key;
-        const rawData = Array.isArray(dataIndex) ? (0, _util.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.default.isValidElement(checkboxDom) ? changeChecked => checkboxDom?.props?.onChange({
-          nativeEvent: {},
-          target: {
-            checked: changeChecked
-          },
-          changeChecked
-        }) : undefined
-      } : undefined;
-      const defaultDom = /*#__PURE__*/(0, _jsxRuntime.jsx)(_Item.default, {
-        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
   });
 }
 var _default = exports.default = ListView;

package/lib/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/lib/list/ProListBase.js

@@ -150,6 +150,7 @@ const ProListContainerInner = /*#__PURE__*/_react.default.forwardRef(function Pr
     renderItem,
     locale,
     hashId: propHashId,
+    suppressContainerDataSlice,
     ...rest
   } = props;
   const {
@@ -174,6 +175,9 @@ const ProListContainerInner = /*#__PURE__*/_react.default.forwardRef(function Pr
     if (!pagination || !dataSource.length) {
       return dataSource;
     }
+    if (suppressContainerDataSlice) {
+      return dataSource;
+    }
     const pageSize = paginationProps.pageSize ?? 10;
     const total = paginationProps.total ?? 0;
     // 父组件已分页（如 ListView 传入 pageData）时不再二次 slice
@@ -182,7 +186,7 @@ const ProListContainerInner = /*#__PURE__*/_react.default.forwardRef(function Pr
     }
     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);
@@ -317,7 +321,7 @@ const ProListContainerInner = /*#__PURE__*/_react.default.forwardRef(function Pr
   const contextValue = (0, _react.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 = (0, _clsx.clsx)(prefixCls, {
     [`${prefixCls}-vertical`]: itemLayout === 'vertical',
     [`${prefixCls}-${sizeCls}`]: sizeCls,

package/lib/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/lib/list/index.js

@@ -14,6 +14,7 @@ var _clsx = require("clsx");
 var _react = _interopRequireWildcard(require("react"));
 var _provider = require("../provider");
 var _table = _interopRequireDefault(require("../table"));
+var _utils = require("../utils");
 var _ListView = _interopRequireDefault(require("./ListView"));
 var _index = require("./style/index");
 var _jsxRuntime = require("react/jsx-runtime");
@@ -119,6 +120,39 @@ function InternalProList(props) {
     [`${prefixCls}-no-split`]: !split,
     [`${prefixCls}-${variant}`]: variant
   });
+  const renderListTableView = (0, _utils.useRefFunction)(({
+    columns,
+    size,
+    pagination,
+    rowSelection,
+    dataSource,
+    loading
+  }) => /*#__PURE__*/(0, _jsxRuntime.jsx)(_ListView.default, {
+    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__*/(0, _jsxRuntime.jsx)(_table.default, {
     tooltip: tooltip,
     ...rest,
@@ -131,41 +165,7 @@ function InternalProList(props) {
     className: (0, _clsx.clsx)(className, listClassName),
     columns: proTableColumns,
     rowKey: rowKey,
-    tableViewRender: ({
-      columns,
-      size,
-      pagination,
-      rowSelection,
-      dataSource,
-      loading
-    }) => {
-      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ListView.default, {
-        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/lib/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.
  */