@pisell/materials 1.0.1048 → 1.0.1050

package/es/components/pisellMultipleSelect/PisellMultipleSelect.js

@@ -2,9 +2,9 @@ import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.108.0/hel
 import EditView_default from "./components/EditView.js";
 import DisabledView_default from "./components/DisabledView.js";
 import ReadOnlyView_default from "./components/ReadOnlyView.js";
-import { message } from "antd";
 import React, { forwardRef, useCallback, useImperativeHandle, useRef } from "react";
 import { useMultipleSelectState } from "@pisell/utils";
+import { message } from "antd";
 import "./PisellMultipleSelect.less";
 
 //#region src/components/pisellMultipleSelect/PisellMultipleSelect.tsx

package/es/components/pisellMultipleSelect/components/DisabledView.js

@@ -1,8 +1,8 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js";
+import React, { forwardRef, useMemo } from "react";
 import { Select } from "antd";
 import classNames from "classnames";
-import React, { forwardRef, useMemo } from "react";
 
 //#region src/components/pisellMultipleSelect/components/DisabledView.tsx
 /**

package/es/components/pisellMultipleSelect/components/EditView.js

@@ -1,10 +1,10 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js";
-import { Input, Select, Tooltip } from "antd";
-import classNames from "classnames";
 import React, { forwardRef, useCallback, useMemo, useRef, useState } from "react";
 import { useDebouncedSearch } from "@pisell/utils";
+import { Input, Select, Tooltip } from "antd";
 import { CheckOutlined, SearchOutlined } from "@ant-design/icons";
+import classNames from "classnames";
 
 //#region src/components/pisellMultipleSelect/components/EditView.tsx
 /**

package/es/components/pisellMultipleSelect/components/ReadOnlyView.js

@@ -1,8 +1,8 @@
 import { getDefaultTagColor } from "../../../utils/tagColor.js";
-import { Tag, Tooltip } from "antd";
-import classNames from "classnames";
 import React, { useMemo } from "react";
 import { calculateTagDisplay, findOptionsByValues } from "@pisell/utils";
+import { Tag, Tooltip } from "antd";
+import classNames from "classnames";
 
 //#region src/components/pisellMultipleSelect/components/ReadOnlyView.tsx
 /**

package/es/components/pisellNavigationMenu/PisellNavigationMenu.js

@@ -1,15 +1,15 @@
+import { getText } from "../../locales/index.js";
 import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import button_default from "../button/index.js";
 import icon_default from "../icon/index.js";
-import { getText } from "../../locales/index.js";
 import pisellTags_default from "../pisellTags/index.js";
 import pisellEmpty_default from "../pisellEmpty/index.js";
 import pisellDropSort_default from "../pisellDropSort/index.js";
 import { formatTree } from "./utils.js";
-import { Dropdown } from "antd";
-import classNames from "classnames";
 import React, { useCallback, useMemo } from "react";
 import { isFunction } from "@pisell/utils";
+import { Dropdown } from "antd";
+import classNames from "classnames";
 import "./PisellNavigationMenu.less";
 
 //#region src/components/pisellNavigationMenu/PisellNavigationMenu.tsx

package/es/components/pisellNumber/components/DisabledView.js

@@ -1,5 +1,5 @@
-import { InputNumber } from "antd";
 import React from "react";
+import { InputNumber } from "antd";
 
 //#region src/components/pisellNumber/components/DisabledView.tsx
 /**

package/es/components/pisellNumber/components/EditView.js

@@ -1,6 +1,6 @@
-import { InputNumber } from "antd";
 import React from "react";
 import { useNumberInputState } from "@pisell/utils";
+import { InputNumber } from "antd";
 
 //#region src/components/pisellNumber/components/EditView.tsx
 /**

package/es/components/pisellPercent/components/DisabledView.js

@@ -1,5 +1,5 @@
-import { InputNumber } from "antd";
 import React from "react";
+import { InputNumber } from "antd";
 
 //#region src/components/pisellPercent/components/DisabledView.tsx
 /**

package/es/components/pisellPercent/components/EditView.js

@@ -1,7 +1,7 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
-import { InputNumber, Slider } from "antd";
 import React from "react";
 import { useNumberInputState } from "@pisell/utils";
+import { InputNumber, Slider } from "antd";
 
 //#region src/components/pisellPercent/components/EditView.tsx
 /**

package/es/components/pisellPercent/components/ReadOnlyView.js

@@ -1,8 +1,8 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { convertToPercent } from "../utils/rangeConverter.js";
 import { formatPercent } from "../utils/percentFormatter.js";
-import { Progress } from "antd";
 import React from "react";
+import { Progress } from "antd";
 
 //#region src/components/pisellPercent/components/ReadOnlyView.tsx
 /**

package/es/components/pisellPercent/types.d.ts

@@ -1,7 +1,7 @@
 import { PisellNumberProps } from "../pisellNumber/types.js";
 import "../pisellNumber/index.js";
-import { ProgressProps, SliderSingleProps } from "antd";
 import "@pisell/utils";
+import { ProgressProps, SliderSingleProps } from "antd";
 
 //#region src/components/pisellPercent/types.d.ts
 /**

package/es/components/pisellPhone/components/EditView.js

@@ -1,8 +1,8 @@
 import { formatPhone } from "../utils/phoneFormatter.js";
 import { getCountryCodes, getMaxLength } from "../utils/countryCodeHelper.js";
-import { Input, Select, Space } from "antd";
 import React, { useMemo, useState } from "react";
 import { useTextInputState } from "@pisell/utils";
+import { Input, Select, Space } from "antd";
 
 //#region src/components/pisellPhone/components/EditView.tsx
 /**

package/es/components/pisellPhone/components/ReadOnlyView.js

@@ -1,7 +1,7 @@
 import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { formatPhone, maskPhone } from "../utils/phoneFormatter.js";
-import { Button, Space, Typography } from "antd";
 import React from "react";
+import { Button, Space, Typography } from "antd";
 import { PhoneOutlined } from "@ant-design/icons";
 
 //#region src/components/pisellPhone/components/ReadOnlyView.tsx

package/es/components/pisellQRScanner/index.js

@@ -1,10 +1,10 @@
+import { getText } from "../../locales/index.js";
 import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js";
 import iconfont_default from "../iconfont/index.js";
-import { getText } from "../../locales/index.js";
 import { _asyncToGenerator } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/asyncToGenerator.js";
-import { message } from "antd";
 import React, { useEffect, useRef } from "react";
+import { message } from "antd";
 import { createPortal } from "react-dom";
 import { BarcodeFormat, BrowserMultiFormatReader, NotFoundException } from "@zxing/library";
 import "./index.less";

package/es/components/pisellQrcode/index.js

@@ -1,8 +1,8 @@
-import pisellModal_default from "../pisellModal/index.js";
 import { getText } from "../../locales/index.js";
+import pisellModal_default from "../pisellModal/index.js";
+import React, { useEffect, useRef, useState } from "react";
 import { Button, Divider, QRCode } from "antd";
 import classNames from "classnames";
-import React, { useEffect, useRef, useState } from "react";
 import "./index.less";
 
 //#region src/components/pisellQrcode/index.tsx

package/es/components/pisellQuickFilter/index.d.ts

@@ -1,9 +1,9 @@
 import { FilterItemProps } from "../filter/types.js";
-import * as antd17 from "antd";
 import React from "react";
+import * as antd16 from "antd";
 
 //#region src/components/pisellQuickFilter/index.d.ts
-declare const pisellQuickFilter: React.ForwardRefExoticComponent<antd17.FormInstance<any> & {
+declare const pisellQuickFilter: React.ForwardRefExoticComponent<antd16.FormInstance<any> & {
   hasForm?: boolean | undefined;
   children?: React.ReactNode;
   formFiltersPrefix: string;

package/es/components/pisellQuickFilter/index.js

@@ -1,8 +1,8 @@
 import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js";
 import QuickFilter_default from "../filter/components/QuickFilter/index.js";
-import { Form } from "antd";
 import React, { forwardRef, useMemo } from "react";
+import { Form } from "antd";
 
 //#region src/components/pisellQuickFilter/index.tsx
 const _excluded = [

package/es/components/pisellRating/PisellRating.js

@@ -1,7 +1,7 @@
 import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
-import { Rate } from "antd";
 import React from "react";
 import { getDisplayState } from "@pisell/utils";
+import { Rate } from "antd";
 import "./PisellRating.less";
 
 //#region src/components/pisellRating/PisellRating.tsx

package/es/components/pisellRecordBoard/PisellRecordBoard.js

@@ -3,7 +3,7 @@ import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0
 import { RecordBoardProvider } from "./context/RecordBoardProvider.js";
 import { getRecordBoardColumnKey } from "./utils/recordBoardColumns.js";
 import React, { useCallback, useEffect, useMemo, useState } from "react";
-import { getColumnVisibilityFromLocal, saveColumnVisibilityToLocal } from "@pisell/utils";
+import { getColumnVisibilityFromLocal, getRecordBoardColumnSettingFromLocal, saveColumnVisibilityToLocal } from "@pisell/utils";
 
 //#region src/components/pisellRecordBoard/PisellRecordBoard.tsx
 const _excluded = [
@@ -21,7 +21,7 @@ const _excluded = [
 ];
 const defaultPagination = {
 	pageNumber: 1,
-	pageSize: 10
+	pageSize: 50
 };
 /**
 * 从打散 props 合并出 childComponentProps（供 context 使用）。
@@ -86,18 +86,36 @@ const PisellRecordBoard = (props) => {
 			defaultVis[k] = false;
 		});
 		if (typeof columnVisibilityStorageKey === "string" && columnVisibilityStorageKey) {
-			const saved = getColumnVisibilityFromLocal(columnVisibilityStorageKey);
-			if (saved && Object.keys(saved).length > 0) return _objectSpread2(_objectSpread2({}, defaultVis), saved);
+			if (typeof getRecordBoardColumnSettingFromLocal === "function") {
+				const saved = getRecordBoardColumnSettingFromLocal(columnVisibilityStorageKey);
+				if ((saved === null || saved === void 0 ? void 0 : saved.columnVisibility) && Object.keys(saved.columnVisibility).length > 0) return _objectSpread2(_objectSpread2({}, defaultVis), saved.columnVisibility);
+			} else if (typeof getColumnVisibilityFromLocal === "function") {
+				const savedVis = getColumnVisibilityFromLocal(columnVisibilityStorageKey);
+				if (savedVis && Object.keys(savedVis).length > 0) return _objectSpread2(_objectSpread2({}, defaultVis), savedVis);
+			}
 		}
 		return defaultVis;
 	});
+	const [internalColumnOrder, setInternalColumnOrder] = useState(() => {
+		if (typeof columnVisibilityStorageKey === "string" && columnVisibilityStorageKey && typeof getRecordBoardColumnSettingFromLocal === "function") {
+			var _saved$columnOrder;
+			const saved = getRecordBoardColumnSettingFromLocal(columnVisibilityStorageKey);
+			return (_saved$columnOrder = saved === null || saved === void 0 ? void 0 : saved.columnOrder) !== null && _saved$columnOrder !== void 0 ? _saved$columnOrder : null;
+		}
+		return null;
+	});
 	useEffect(() => {
 		if (typeof columnVisibilityStorageKey !== "string" || !columnVisibilityStorageKey) return;
 		saveColumnVisibilityToLocal({
 			componentId: columnVisibilityStorageKey,
-			columnVisibility: internalColumnVisibility
+			columnVisibility: internalColumnVisibility,
+			columnOrder: internalColumnOrder !== null && internalColumnOrder !== void 0 ? internalColumnOrder : void 0
 		});
-	}, [columnVisibilityStorageKey, internalColumnVisibility]);
+	}, [
+		columnVisibilityStorageKey,
+		internalColumnVisibility,
+		internalColumnOrder
+	]);
 	const onSelectionChangeInternal = useCallback((keys, rows) => {
 		setInternalSelectedKeys(keys);
 		setInternalSelectedRows(rows);
@@ -105,6 +123,9 @@ const PisellRecordBoard = (props) => {
 	const onColumnVisibilityChangeInternal = useCallback((visibility) => {
 		setInternalColumnVisibility((prev) => _objectSpread2(_objectSpread2({}, prev), visibility));
 	}, []);
+	const onColumnOrderChangeInternal = useCallback((columnKeys) => {
+		setInternalColumnOrder(columnKeys);
+	}, []);
 	const contextValue = useMemo(() => {
 		var _gridSelection$select;
 		const defaultCtx = getDefaultRecordBoardContext(layoutType, {
@@ -142,6 +163,8 @@ const PisellRecordBoard = (props) => {
 			onSelectionChange,
 			columnVisibility: internalColumnVisibility,
 			onColumnVisibilityChange: onColumnVisibilityChangeInternal,
+			columnOrder: internalColumnOrder,
+			onColumnOrderChange: onColumnOrderChangeInternal,
 			childComponentProps: mergedChildComponentProps !== null && mergedChildComponentProps !== void 0 ? mergedChildComponentProps : defaultCtx.childComponentProps,
 			fillHeight,
 			scrollAreaHeight,
@@ -164,6 +187,8 @@ const PisellRecordBoard = (props) => {
 		onSelectionChangeInternal,
 		internalColumnVisibility,
 		onColumnVisibilityChangeInternal,
+		internalColumnOrder,
+		onColumnOrderChangeInternal,
 		fillHeight,
 		scrollAreaHeight
 	]);

package/es/components/pisellRecordBoard/docs/PisellRecordBoard.$tab-dev.md

@@ -25,7 +25,7 @@ PisellRecordBoard 是记录看板容器，提供统一的 data、pagination、se
 - 受控 Context：value 注入 data、pagination、searchParams、onSearch、onReset、多选等
 - ShellFrame：ToolBar + BatchActionBar + Layout + Pagination
 - GridLayout / CardLayout：表格布局、卡片布局
-- 列驱动：processColumnsForGrid、deriveFilterFromColumns、deriveSortFromColumns
+- 列驱动：processColumnsForGrid、deriveFilterFromColumns、deriveSortFromColumns；同值列折叠：默认开启（grid.collapseUniformColumns 默认为 true，传 false 可关闭）；当前页某列全同值/全空则隐藏列并在表格上方展示总结区（computeUniformColumnSummary）
 
 ### 2.2 列配置
 
@@ -44,7 +44,7 @@ PisellRecordBoard 是记录看板容器，提供统一的 data、pagination、se
 
 ### 3.1 类型
 
-- **RecordBoardColumnType**：列配置，兼容 antd Table Column，扩展 type、fieldProps（含 options/getOptions）、filterable、filter、sortable、sort
+- **RecordBoardColumnType**：列配置，兼容 antd Table Column，扩展 type、fieldProps（含 options/getOptions）、filterable、filter、sortable、sort；当 grid.collapseUniformColumns 为 true 时支持 uniformCompare、collapseWhenUniform
 - **RecordBoardOptionItem**：选项格式 `{ label, value, color? }`，用于 options/getOptions；color 用于只读态 Tag
 - **RecordBoardGetOptions**：同步或异步返回选项列表，用于 fieldProps.getOptions、filter.getOptions
 - **RecordBoardColumnFilterConfig**：filter 配置，type 或 component（value/onChange）；type 为 single 时支持 options 或 getOptions
@@ -55,6 +55,7 @@ PisellRecordBoard 是记录看板容器，提供统一的 data、pagination、se
 
 - **processColumnsForGrid(columns)**：对带 type 的列注入 Pisell 只读 render（有 render 则用 render）；支持 getOptions 异步选项
 - **getRecordBoardColumnKey(column)**：获取列唯一 key，供列显示隐藏等使用
+- **computeUniformColumnSummary(data, columns)**：当 grid.collapseUniformColumns 为 true 时，根据当前页 data 计算「全列同值/全空」的列，返回 uniformHiddenColumnKeys 与 summaryItems，供 Grid 隐藏列并渲染总结区
 - **deriveFilterFromColumns(columns)**：返回 quickFilter、otherFilter，有 type 可由 filter 覆盖；支持 filter.getOptions
 - **deriveSortFromColumns(columns)**：返回 SortItemProps 数组，有 type 可由 sort 覆盖
 

package/es/components/pisellRecordBoard/docs/PisellRecordBoard.md

@@ -481,9 +481,27 @@ export default () => {
 };
 ```
 
+### 同值列折叠（grid.collapseUniformColumns）
+
+该功能**默认开启**。当 `grid.collapseUniformColumns` 不为 `false` 时，对**当前页**数据做检测：若某列在所有行上的值**全部相同**或**全部为空**，则该列从表格中隐藏，并在表格上方展示一行**总结区**，展示「列名 + 统一值」或「列名 + 空数据」。
+
+- **比较规则**：用于比较的值来自列 **uniformCompare**（若有）或 dataIndex。**uniformCompare** 为函数 `(value, record) => string | number | null | undefined`：传入当前格子的 value 与整行 record，返回用于比较的值；返回 string/number 时参与全等比较，返回 null/undefined 则该列不参与折叠。未配置 uniformCompare 时用 dataIndex 取值；仅当取值为 string/number 时才参与比较。
+- **列配置**：列上可设置 **uniformCompare**（类似 render 的 (value, record) 函数）、**collapseWhenUniform**（默认 `true`，为 `false` 时该列不参与折叠）。
+- **总结区展示**：优先使用列的 **render(value, record, index)** 渲染统一值/空占位；若列未配置 render，则直接展示原始值或「-」。
+- 总结区样式参考 Figma（灰底、列名 + Badge/空占位），仅当存在至少一项折叠列时渲染。
+- **关闭**：传 `grid={{ collapseUniformColumns: false }}` 即可关闭该功能。
+
+```tsx
+// 默认开启，无需配置；若需关闭：
+grid={{
+  columns,
+  collapseUniformColumns: false,
+}}
+```
+
 ### grid 透传 antd Table props
 
-`grid` 类型为 **RecordBoardGridProps**，在自有字段（columns、scroll、size、selectedKeys、selectedRows、onSelectionChange）基础上，与 antd **TableProps** 做交叉类型并省略由 context 或组件自管的项（dataSource、loading、pagination、columns、scroll、size、rowSelection），因此支持 Table 其余 props 透传，如 `onRow`、`onHeaderRow`、`expandable`、`rowClassName`、`summary` 等。
+`grid` 类型为 **RecordBoardGridProps**，在自有字段（columns、scroll、size、selectedKeys、selectedRows、onSelectionChange、collapseUniformColumns）基础上，与 antd **TableProps** 做交叉类型并省略由 context 或组件自管的项（dataSource、loading、pagination、columns、scroll、size、rowSelection），因此支持 Table 其余 props 透传，如 `onRow`、`onHeaderRow`、`expandable`、`rowClassName`、`summary` 等。
 
 ### 自定义表格行点击（grid.onRow.onClick）
 
@@ -559,7 +577,7 @@ export default function TableOnRowClickExample() {
 | rowKey   | string \| (record) => Key   | 行主键 |
 | layoutType | 'grid' \| 'card'          | 布局类型 |
 | data / loading / total / pagination / onPageChange / searchParams / onSearch / onReset | 各自类型 | 打散的数据与回调 |
-| grid / toolBar / search / paginationConfig / batchActionBar / cardList | 各自类型 | 打散的子组件配置。**grid** 类型为 RecordBoardGridProps（基于 TableProps 省略 dataSource/loading/pagination/columns/scroll/size/rowSelection），多选在 grid 内；支持 Table 透传：onRow、onHeaderRow、expandable、rowClassName、summary 等 |
+| grid / toolBar / search / paginationConfig / batchActionBar / cardList | 各自类型 | 打散的子组件配置。**grid** 类型为 RecordBoardGridProps（基于 TableProps 省略 dataSource/loading/pagination/columns/scroll/size/rowSelection），多选在 grid 内；支持 **collapseUniformColumns**（当前页某列全同值/全空时隐藏该列并在表格上方展示总结区）；支持 Table 透传：onRow、onHeaderRow、expandable、rowClassName、summary 等 |
 
 默认占满父容器高度（父容器需有高度，如 `height: 100vh` 或 `height: 100%`），内容区可滚动，分页器贴底。
 
@@ -590,6 +608,8 @@ export default function TableOnRowClickExample() {
 | filter     | RecordBoardColumnFilterConfig | 筛选配置（type 或 component）；type 为 single 时支持 `options` 或 `getOptions`                      |
 | sortable   | boolean                       | 是否参与排序                                                                                 |
 | sort       | { type?, getSortItems? }      | 排序配置                                                                                   |
+| uniformCompare | (value, record) => string \| number \| null \| undefined | 当 grid.collapseUniformColumns 为 true 时，用此函数从 (value, record) 得到用于比较的值；返回 string/number 参与全等比较，返回 null/undefined 则该列不参与折叠。未传则用 dataIndex 取值 |
+| collapseWhenUniform | boolean              | 当 grid.collapseUniformColumns 为 true 时，为 false 则该列即使全列同值/全空也不折叠；默认 true |
 
 - **选项类型**：`RecordBoardOptionItem` 为 `{ label, value, color? }`，只读态 Tag 可使用 `color`。`RecordBoardGetOptions`
   为同步或异步返回选项列表的函数类型。

package/es/components/pisellRecordBoard/layouts/GridLayout/Grid.d.ts

@@ -1,6 +1,6 @@
 import { RecordBoardContextValue } from "../../types.js";
-import { TableProps } from "antd";
 import React from "react";
+import { TableProps } from "antd";
 import "./Grid.less";
 
 //#region src/components/pisellRecordBoard/layouts/GridLayout/Grid.d.ts

package/es/components/pisellRecordBoard/layouts/GridLayout/Grid.js

@@ -1,9 +1,10 @@
+import { getText } from "../../../../locales/index.js";
 import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
 import { _objectWithoutProperties } from "../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js";
-import { getRecordBoardColumnKey, processColumnsForGrid } from "../../utils/recordBoardColumns.js";
+import { computeUniformColumnSummary, getRecordBoardColumnKey, processColumnsForGrid } from "../../utils/recordBoardColumns.js";
 import { useRecordBoardContext } from "../../hooks/useRecordBoardContext.js";
+import React, { useEffect, useMemo, useRef, useState } from "react";
 import { Table } from "antd";
-import React, { useMemo } from "react";
 import "./Grid.less";
 
 //#region src/components/pisellRecordBoard/layouts/GridLayout/Grid.tsx
@@ -45,18 +46,59 @@ const CONTEXT_ONLY_KEYS = [
 	"size",
 	"defaultHiddenColumnKeys",
 	"scrollAreaHeight",
-	"setScrollAreaHeight"
+	"setScrollAreaHeight",
+	"collapseUniformColumns",
+	"columnOrder",
+	"onColumnOrderChange"
 ];
 const RecordBoardGridView = (props) => {
-	var _ref2, _ctx$data, _ctx$data2;
+	var _ref2, _ctx$data2, _ctx$data3;
 	const ctx = useRecordBoardContext({ displayName: "grid" });
 	const { render, columns: columnsProp, rowKey: rowKeyProp, rowSelection: rowSelectionProp } = props, rest = _objectWithoutProperties(props, _excluded);
 	const rawColumns = (_ref2 = columnsProp !== null && columnsProp !== void 0 ? columnsProp : ctx.columns) !== null && _ref2 !== void 0 ? _ref2 : [];
 	const columnVisibility = ctx.columnVisibility;
-	const columns = useMemo(() => {
-		const list = rawColumns;
-		return processColumnsForGrid(columnVisibility == null ? list : list.filter((col) => columnVisibility[getRecordBoardColumnKey(col)] !== false));
-	}, [rawColumns, columnVisibility]);
+	const columnOrder = ctx.columnOrder;
+	const collapseUniformColumns = ctx.collapseUniformColumns !== false;
+	/** 同值列总结区高度，用于 autoCalc 时正确计算 scroll.y */
+	const summaryRef = useRef(null);
+	const [uniformSummaryHeight, setUniformSummaryHeight] = useState(0);
+	const { columns, uniformSummaryItems: summaryItems, processedColumnsForSummary } = useMemo(() => {
+		var _ctx$data;
+		let list = rawColumns;
+		if (Array.isArray(columnOrder) && columnOrder.length > 0) {
+			const keyToCol = new Map(list.map((c) => [getRecordBoardColumnKey(c), c]));
+			const ordered = [];
+			for (const key of columnOrder) {
+				const col = keyToCol.get(key);
+				if (col) ordered.push(col);
+			}
+			list.forEach((col) => {
+				const key = getRecordBoardColumnKey(col);
+				if (!columnOrder.includes(key)) ordered.push(col);
+			});
+			list = ordered;
+		}
+		const visibleByUser = columnVisibility == null ? list : list.filter((col) => columnVisibility[getRecordBoardColumnKey(col)] !== false);
+		const data = (_ctx$data = ctx.data) !== null && _ctx$data !== void 0 ? _ctx$data : [];
+		if (!(collapseUniformColumns && data.length > 5)) return {
+			columns: processColumnsForGrid(visibleByUser),
+			uniformSummaryItems: [],
+			processedColumnsForSummary: void 0
+		};
+		const processedAllVisible = processColumnsForGrid(visibleByUser);
+		const { uniformHiddenColumnKeys, summaryItems: items } = computeUniformColumnSummary(data, visibleByUser);
+		return {
+			columns: processedAllVisible.filter((col) => !uniformHiddenColumnKeys.includes(getRecordBoardColumnKey(col))),
+			uniformSummaryItems: items,
+			processedColumnsForSummary: items.length > 0 ? processedAllVisible : void 0
+		};
+	}, [
+		rawColumns,
+		columnVisibility,
+		columnOrder,
+		collapseUniformColumns,
+		ctx.data
+	]);
 	const tableRowKey = useMemo(() => {
 		var _ref3, _ctx$rowKey;
 		const key = (_ref3 = (_ctx$rowKey = ctx.rowKey) !== null && _ctx$rowKey !== void 0 ? _ctx$rowKey : rowKeyProp) !== null && _ref3 !== void 0 ? _ref3 : "id";
@@ -79,6 +121,24 @@ const RecordBoardGridView = (props) => {
 		ctx.onSelectionChange,
 		rowSelectionConfig
 	]);
+	/** 测量同值列总结区高度，供 autoCalc 时 scroll.y 减去该高度 */
+	useEffect(() => {
+		if (summaryItems.length === 0) {
+			setUniformSummaryHeight(0);
+			return;
+		}
+		const el = summaryRef.current;
+		if (!el) return;
+		const ro = new ResizeObserver((entries) => {
+			const entry = entries[0];
+			if (entry) setUniformSummaryHeight(entry.contentRect.height);
+		});
+		ro.observe(el);
+		return () => {
+			ro.disconnect();
+			setUniformSummaryHeight(0);
+		};
+	}, [summaryItems.length]);
 	const gridTableProps = useMemo(() => {
 		const picked = {};
 		Object.keys(ctx).forEach((k) => {
@@ -88,7 +148,7 @@ const RecordBoardGridView = (props) => {
 		return picked;
 	}, [ctx]);
 	if (typeof render === "function") return /* @__PURE__ */ React.createElement(React.Fragment, null, render(_objectSpread2(_objectSpread2({}, ctx), rest)));
-	const dataSource = (_ctx$data = ctx.data) !== null && _ctx$data !== void 0 ? _ctx$data : [];
+	const dataSource = (_ctx$data2 = ctx.data) !== null && _ctx$data2 !== void 0 ? _ctx$data2 : [];
 	const isEmpty = !Array.isArray(dataSource) || dataSource.length === 0;
 	const sumColumnWidths = useMemo(() => {
 		return columns.reduce((sum, col) => {
@@ -102,9 +162,11 @@ const RecordBoardGridView = (props) => {
 		const scrollX = isEmpty && scroll && typeof scroll.x !== "number" ? sumColumnWidths : scroll === null || scroll === void 0 ? void 0 : scroll.x;
 		if ((scroll === null || scroll === void 0 ? void 0 : scroll.autoCalc) && typeof ctx.scrollAreaHeight === "number") {
 			const wrapHeight = ctx.scrollAreaHeight;
+			const reservedHeight = 40 + uniformSummaryHeight;
+			console.log(wrapHeight, reservedHeight);
 			return {
 				x: scrollX !== null && scrollX !== void 0 ? scrollX : sumColumnWidths,
-				y: Math.max(wrapHeight - 40, 100),
+				y: Math.max(wrapHeight - reservedHeight, 100),
 				scrollToFirstRowOnChange: scroll.scrollToFirstRowOnChange
 			};
 		}
@@ -125,15 +187,27 @@ const RecordBoardGridView = (props) => {
 		ctx.pagination,
 		columns,
 		sumColumnWidths,
-		isEmpty
+		isEmpty,
+		uniformSummaryHeight
 	]);
 	return /* @__PURE__ */ React.createElement("div", {
 		"data-layout-slot": "grid",
 		className: "pisell-lowcode-record-board-grid"
-	}, /* @__PURE__ */ React.createElement(Table, _objectSpread2(_objectSpread2(_objectSpread2({}, rest), gridTableProps), {}, {
+	}, summaryItems.length > 0 && /* @__PURE__ */ React.createElement("div", {
+		ref: summaryRef,
+		className: "pisell-record-board-uniform-summary"
+	}, summaryItems.map((item) => {
+		var _item$record, _item$displayValue;
+		const processedCol = processedColumnsForSummary === null || processedColumnsForSummary === void 0 ? void 0 : processedColumnsForSummary.find((c) => getRecordBoardColumnKey(c) === item.columnKey);
+		const content = typeof (processedCol === null || processedCol === void 0 ? void 0 : processedCol.render) === "function" ? processedCol.render(item.cellValue, (_item$record = item.record) !== null && _item$record !== void 0 ? _item$record : {}, 0) : item.type === "empty" ? getText("record-board-uniform-summary-empty") : (_item$displayValue = item.displayValue) !== null && _item$displayValue !== void 0 ? _item$displayValue : getText("record-board-uniform-summary-same");
+		return /* @__PURE__ */ React.createElement("div", {
+			key: item.columnKey,
+			className: "pisell-record-board-uniform-summary-item"
+		}, /* @__PURE__ */ React.createElement("span", { className: "pisell-record-board-uniform-summary-label" }, item.title), /* @__PURE__ */ React.createElement("span", { className: "pisell-record-board-uniform-summary-value" }, content));
+	})), /* @__PURE__ */ React.createElement(Table, _objectSpread2(_objectSpread2(_objectSpread2({}, rest), gridTableProps), {}, {
 		scroll: tableScroll,
 		rowKey: tableRowKey,
-		dataSource: (_ctx$data2 = ctx.data) !== null && _ctx$data2 !== void 0 ? _ctx$data2 : [],
+		dataSource: (_ctx$data3 = ctx.data) !== null && _ctx$data3 !== void 0 ? _ctx$data3 : [],
 		loading: ctx.loading,
 		columns,
 		rowSelection,

package/es/components/pisellRecordBoard/layouts/GridLayout/Grid.less

@@ -7,6 +7,44 @@
   }
 }
 
+// 同值列折叠时的总结区样式（参考 Figma 12840-86869）
+.pisell-record-board-uniform-summary {
+  display: flex;
+  flex-wrap: nowrap;
+  align-items: center;
+  gap: 32px;
+  min-height: 44px;
+  padding: 12px 24px;
+  background: #f2f4f7;
+  border-bottom: 1px solid #eaecf0;
+  border-radius: 8px 8px 0 0;
+
+  .pisell-record-board-uniform-summary-item {
+    display: flex;
+    align-items: center;
+    gap: 4px;
+    flex-shrink: 0;
+  }
+
+  .pisell-record-board-uniform-summary-label {
+    font-family: inherit;
+    font-size: 12px;
+    font-weight: 500;
+    line-height: 18px;
+    color: #475467;
+    white-space: nowrap;
+  }
+
+  .pisell-record-board-uniform-summary-value {
+    font-family: inherit;
+    font-size: 12px;
+    font-weight: 500;
+    line-height: 18px;
+    color: #475467;
+    white-space: nowrap;
+  }
+}
+
 // 纯 CSS 占满高度：滚动发生在 .pisell-record-board-scroll-body，表头 sticky 固定；高度传到 table
 .pisell-record-board-scroll-body .pisell-lowcode-record-board-grid {
   height: 100%;

package/es/components/pisellRecordBoard/shellFrame/BatchActionBar/index.js

@@ -1,6 +1,6 @@
 import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js";
-import PisellBatchActionBar_default from "../../../pisellBatchActionBar/PisellBatchActionBar.js";
 import { useRecordBoardContext } from "../../hooks/useRecordBoardContext.js";
+import PisellBatchActionBar_default from "../../../pisellBatchActionBar/PisellBatchActionBar.js";
 import React, { useCallback, useMemo } from "react";
 
 //#region src/components/pisellRecordBoard/shellFrame/BatchActionBar/index.tsx