@pisell/materials 1.0.1048 → 1.0.1050

package/lib/components/pisellQRScanner/index.js

@@ -1,12 +1,12 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
+const require_index = require('../../locales/index.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
-const require_index = require('../iconfont/index.js');
-const require_index$1 = require('../../locales/index.js');
+const require_index$1 = require('../iconfont/index.js');
 const require_asyncToGenerator = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/asyncToGenerator.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 let react_dom = require("react-dom");
 let _zxing_library = require("@zxing/library");
 require("./index.less");
@@ -72,7 +72,7 @@ const PisellQRScanner = (_ref) => {
 			try {
 				const file = files[0];
 				if (!file.type.startsWith("image/")) {
-					antd.message.error(require_index$1.getText("qrscanner-error-upload-image"));
+					antd.message.error(require_index.getText("qrscanner-error-upload-image"));
 					return;
 				}
 				try {
@@ -81,7 +81,7 @@ const PisellQRScanner = (_ref) => {
 						var _ref2 = require_asyncToGenerator._asyncToGenerator(function* (e) {
 							if (!e.target || !e.target.result) {
 								antd.message.error({
-									content: require_index$1.getText("qrscanner-error-load-failed"),
+									content: require_index.getText("qrscanner-error-load-failed"),
 									key: "qrProcessing"
 								});
 								return;
@@ -381,7 +381,7 @@ const PisellQRScanner = (_ref) => {
 											handleScanClose();
 											setTimeout(() => {
 												antd.message.error({
-													content: require_index$1.getText("qrscanner-error-no-code"),
+													content: require_index.getText("qrscanner-error-no-code"),
 													duration: 3
 												});
 											}, 100);
@@ -392,7 +392,7 @@ const PisellQRScanner = (_ref) => {
 										handleScanClose();
 										setTimeout(() => {
 											antd.message.error({
-												content: require_index$1.getText("qrscanner-error-no-code"),
+												content: require_index.getText("qrscanner-error-no-code"),
 												duration: 3
 											});
 										}, 100);
@@ -403,7 +403,7 @@ const PisellQRScanner = (_ref) => {
 									handleScanClose();
 									setTimeout(() => {
 										antd.message.error({
-											content: require_index$1.getText("qrscanner-error-process-image"),
+											content: require_index.getText("qrscanner-error-process-image"),
 											duration: 3
 										});
 									}, 100);
@@ -412,7 +412,7 @@ const PisellQRScanner = (_ref) => {
 							img.onerror = () => {
 								antd.message.destroy("qrProcessing");
 								handleScanClose();
-								antd.message.error(require_index$1.getText("qrscanner-error-load-failed"));
+								antd.message.error(require_index.getText("qrscanner-error-load-failed"));
 							};
 							img.src = e.target.result.toString();
 						});
@@ -423,20 +423,20 @@ const PisellQRScanner = (_ref) => {
 					reader.onerror = () => {
 						antd.message.destroy("qrProcessing");
 						handleScanClose();
-						antd.message.error(require_index$1.getText("qrscanner-error-load-failed"));
+						antd.message.error(require_index.getText("qrscanner-error-load-failed"));
 					};
 					reader.readAsDataURL(file);
 				} catch (error) {
 					console.error("识别过程错误:", error);
 					antd.message.destroy("qrProcessing");
 					handleScanClose();
-					antd.message.error(require_index$1.getText("qrscanner-error-process-image"));
+					antd.message.error(require_index.getText("qrscanner-error-process-image"));
 				}
 			} catch (error) {
 				console.error("处理图片出错", error);
 				antd.message.destroy("qrProcessing");
 				handleScanClose();
-				antd.message.error(require_index$1.getText("qrscanner-error-process-image"));
+				antd.message.error(require_index.getText("qrscanner-error-process-image"));
 			} finally {
 				if (fileInputRef.current) fileInputRef.current.value = "";
 			}
@@ -498,7 +498,7 @@ const PisellQRScanner = (_ref) => {
 					handleScanClose();
 					setTimeout(() => {
 						antd.message.error({
-							content: require_index$1.getText("qrscanner-error-camera-init"),
+							content: require_index.getText("qrscanner-error-camera-init"),
 							duration: 3
 						});
 					}, 100);
@@ -558,7 +558,7 @@ const PisellQRScanner = (_ref) => {
 		autoPlay: true,
 		playsInline: true,
 		muted: true
-	})), /* @__PURE__ */ react.default.createElement(require_index.default, {
+	})), /* @__PURE__ */ react.default.createElement(require_index$1.default, {
 		type: "pisell2-arrow-left",
 		className: "scan-close-left",
 		style: {
@@ -578,7 +578,7 @@ const PisellQRScanner = (_ref) => {
 			cursor: "pointer"
 		},
 		onClick: handleScanClose
-	}), showUpload && /* @__PURE__ */ react.default.createElement(require_index.default, {
+	}), showUpload && /* @__PURE__ */ react.default.createElement(require_index$1.default, {
 		type: "pisell2-image-01",
 		className: "scan-upload",
 		style: {

package/lib/components/pisellQrcode/index.js

@@ -1,11 +1,11 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
-const require_index = require('../pisellModal/index.js');
-const require_index$1 = require('../../locales/index.js');
+const require_index = require('../../locales/index.js');
+const require_index$1 = require('../pisellModal/index.js');
+let react = require("react");
+react = require_rolldown_runtime.__toESM(react);
 let antd = require("antd");
 let classnames = require("classnames");
 classnames = require_rolldown_runtime.__toESM(classnames);
-let react = require("react");
-react = require_rolldown_runtime.__toESM(react);
 require("./index.less");
 
 //#region src/components/pisellQrcode/index.tsx
@@ -20,7 +20,7 @@ const PisellQrcode = (props) => {
 		if (open) {}
 	}, [open]);
 	const modalProps = {
-		title: require_index$1.getText("pisellQrcode-qrcode"),
+		title: require_index.getText("pisellQrcode-qrcode"),
 		platform,
 		onCancel: () => setOpen(false),
 		open,
@@ -36,14 +36,14 @@ const PisellQrcode = (props) => {
 		size,
 		value,
 		bordered: false
-	})), /* @__PURE__ */ react.default.createElement(require_index.default, modalProps, /* @__PURE__ */ react.default.createElement(antd.QRCode, {
+	})), /* @__PURE__ */ react.default.createElement(require_index$1.default, modalProps, /* @__PURE__ */ react.default.createElement(antd.QRCode, {
 		size: 200,
 		value,
 		style: { marginTop: 24 }
 	}), /* @__PURE__ */ react.default.createElement("p", { className: (0, classnames.default)("pisell-qrcode-modal-value") }, value), /* @__PURE__ */ react.default.createElement(antd.Divider, null), /* @__PURE__ */ react.default.createElement(antd.Button, {
 		onClick: () => setOpen(false),
 		className: (0, classnames.default)("pisell-qrcode-modal-button")
-	}, require_index$1.getText("pisellQrcode-done"))));
+	}, require_index.getText("pisellQrcode-done"))));
 };
 var pisellQrcode_default = PisellQrcode;
 

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

@@ -1,6 +1,6 @@
 import { FilterItemProps } from "../filter/types.js";
-import * as antd17 from "antd";
 import React from "react";
+import * as antd17 from "antd";
 
 //#region src/components/pisellQuickFilter/index.d.ts
 declare const pisellQuickFilter: React.ForwardRefExoticComponent<antd17.FormInstance<any> & {

package/lib/components/pisellQuickFilter/index.js

@@ -2,9 +2,9 @@ const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
 const require_index = require('../filter/components/QuickFilter/index.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 
 //#region src/components/pisellQuickFilter/index.tsx
 const _excluded = [

package/lib/components/pisellRating/PisellRating.js

@@ -1,9 +1,9 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
 let _pisell_utils = require("@pisell/utils");
+let antd = require("antd");
 require("./PisellRating.less");
 
 //#region src/components/pisellRating/PisellRating.tsx

package/lib/components/pisellRecordBoard/PisellRecordBoard.js

@@ -23,7 +23,7 @@ const _excluded = [
 ];
 const defaultPagination = {
 	pageNumber: 1,
-	pageSize: 10
+	pageSize: 50
 };
 /**
 * 从打散 props 合并出 childComponentProps（供 context 使用）。
@@ -88,18 +88,36 @@ const PisellRecordBoard = (props) => {
 			defaultVis[k] = false;
 		});
 		if (typeof columnVisibilityStorageKey === "string" && columnVisibilityStorageKey) {
-			const saved = (0, _pisell_utils.getColumnVisibilityFromLocal)(columnVisibilityStorageKey);
-			if (saved && Object.keys(saved).length > 0) return require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, defaultVis), saved);
+			if (typeof _pisell_utils.getRecordBoardColumnSettingFromLocal === "function") {
+				const saved = (0, _pisell_utils.getRecordBoardColumnSettingFromLocal)(columnVisibilityStorageKey);
+				if ((saved === null || saved === void 0 ? void 0 : saved.columnVisibility) && Object.keys(saved.columnVisibility).length > 0) return require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, defaultVis), saved.columnVisibility);
+			} else if (typeof _pisell_utils.getColumnVisibilityFromLocal === "function") {
+				const savedVis = (0, _pisell_utils.getColumnVisibilityFromLocal)(columnVisibilityStorageKey);
+				if (savedVis && Object.keys(savedVis).length > 0) return require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, defaultVis), savedVis);
+			}
 		}
 		return defaultVis;
 	});
+	const [internalColumnOrder, setInternalColumnOrder] = (0, react.useState)(() => {
+		if (typeof columnVisibilityStorageKey === "string" && columnVisibilityStorageKey && typeof _pisell_utils.getRecordBoardColumnSettingFromLocal === "function") {
+			var _saved$columnOrder;
+			const saved = (0, _pisell_utils.getRecordBoardColumnSettingFromLocal)(columnVisibilityStorageKey);
+			return (_saved$columnOrder = saved === null || saved === void 0 ? void 0 : saved.columnOrder) !== null && _saved$columnOrder !== void 0 ? _saved$columnOrder : null;
+		}
+		return null;
+	});
 	(0, react.useEffect)(() => {
 		if (typeof columnVisibilityStorageKey !== "string" || !columnVisibilityStorageKey) return;
 		(0, _pisell_utils.saveColumnVisibilityToLocal)({
 			componentId: columnVisibilityStorageKey,
-			columnVisibility: internalColumnVisibility
+			columnVisibility: internalColumnVisibility,
+			columnOrder: internalColumnOrder !== null && internalColumnOrder !== void 0 ? internalColumnOrder : void 0
 		});
-	}, [columnVisibilityStorageKey, internalColumnVisibility]);
+	}, [
+		columnVisibilityStorageKey,
+		internalColumnVisibility,
+		internalColumnOrder
+	]);
 	const onSelectionChangeInternal = (0, react.useCallback)((keys, rows) => {
 		setInternalSelectedKeys(keys);
 		setInternalSelectedRows(rows);
@@ -107,6 +125,9 @@ const PisellRecordBoard = (props) => {
 	const onColumnVisibilityChangeInternal = (0, react.useCallback)((visibility) => {
 		setInternalColumnVisibility((prev) => require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, prev), visibility));
 	}, []);
+	const onColumnOrderChangeInternal = (0, react.useCallback)((columnKeys) => {
+		setInternalColumnOrder(columnKeys);
+	}, []);
 	const contextValue = (0, react.useMemo)(() => {
 		var _gridSelection$select;
 		const defaultCtx = getDefaultRecordBoardContext(layoutType, {
@@ -144,6 +165,8 @@ const PisellRecordBoard = (props) => {
 			onSelectionChange,
 			columnVisibility: internalColumnVisibility,
 			onColumnVisibilityChange: onColumnVisibilityChangeInternal,
+			columnOrder: internalColumnOrder,
+			onColumnOrderChange: onColumnOrderChangeInternal,
 			childComponentProps: mergedChildComponentProps !== null && mergedChildComponentProps !== void 0 ? mergedChildComponentProps : defaultCtx.childComponentProps,
 			fillHeight,
 			scrollAreaHeight,
@@ -166,6 +189,8 @@ const PisellRecordBoard = (props) => {
 		onSelectionChangeInternal,
 		internalColumnVisibility,
 		onColumnVisibilityChangeInternal,
+		internalColumnOrder,
+		onColumnOrderChangeInternal,
 		fillHeight,
 		scrollAreaHeight
 	]);

package/lib/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/lib/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/lib/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/lib/components/pisellRecordBoard/layouts/GridLayout/Grid.js

@@ -1,11 +1,12 @@
 const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.js');
+const require_index = require('../../../../locales/index.js');
 const require_objectSpread2 = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
 const require_objectWithoutProperties = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectWithoutProperties.js');
 const require_recordBoardColumns = require('../../utils/recordBoardColumns.js');
 const require_useRecordBoardContext = require('../../hooks/useRecordBoardContext.js');
-let antd = require("antd");
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);
+let antd = require("antd");
 require("./Grid.less");
 
 //#region src/components/pisellRecordBoard/layouts/GridLayout/Grid.tsx
@@ -47,18 +48,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 = require_useRecordBoardContext.useRecordBoardContext({ displayName: "grid" });
 	const { render, columns: columnsProp, rowKey: rowKeyProp, rowSelection: rowSelectionProp } = props, rest = require_objectWithoutProperties._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 = (0, react.useMemo)(() => {
-		const list = rawColumns;
-		return require_recordBoardColumns.processColumnsForGrid(columnVisibility == null ? list : list.filter((col) => columnVisibility[require_recordBoardColumns.getRecordBoardColumnKey(col)] !== false));
-	}, [rawColumns, columnVisibility]);
+	const columnOrder = ctx.columnOrder;
+	const collapseUniformColumns = ctx.collapseUniformColumns !== false;
+	/** 同值列总结区高度，用于 autoCalc 时正确计算 scroll.y */
+	const summaryRef = (0, react.useRef)(null);
+	const [uniformSummaryHeight, setUniformSummaryHeight] = (0, react.useState)(0);
+	const { columns, uniformSummaryItems: summaryItems, processedColumnsForSummary } = (0, react.useMemo)(() => {
+		var _ctx$data;
+		let list = rawColumns;
+		if (Array.isArray(columnOrder) && columnOrder.length > 0) {
+			const keyToCol = new Map(list.map((c) => [require_recordBoardColumns.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 = require_recordBoardColumns.getRecordBoardColumnKey(col);
+				if (!columnOrder.includes(key)) ordered.push(col);
+			});
+			list = ordered;
+		}
+		const visibleByUser = columnVisibility == null ? list : list.filter((col) => columnVisibility[require_recordBoardColumns.getRecordBoardColumnKey(col)] !== false);
+		const data = (_ctx$data = ctx.data) !== null && _ctx$data !== void 0 ? _ctx$data : [];
+		if (!(collapseUniformColumns && data.length > 5)) return {
+			columns: require_recordBoardColumns.processColumnsForGrid(visibleByUser),
+			uniformSummaryItems: [],
+			processedColumnsForSummary: void 0
+		};
+		const processedAllVisible = require_recordBoardColumns.processColumnsForGrid(visibleByUser);
+		const { uniformHiddenColumnKeys, summaryItems: items } = require_recordBoardColumns.computeUniformColumnSummary(data, visibleByUser);
+		return {
+			columns: processedAllVisible.filter((col) => !uniformHiddenColumnKeys.includes(require_recordBoardColumns.getRecordBoardColumnKey(col))),
+			uniformSummaryItems: items,
+			processedColumnsForSummary: items.length > 0 ? processedAllVisible : void 0
+		};
+	}, [
+		rawColumns,
+		columnVisibility,
+		columnOrder,
+		collapseUniformColumns,
+		ctx.data
+	]);
 	const tableRowKey = (0, react.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";
@@ -81,6 +123,24 @@ const RecordBoardGridView = (props) => {
 		ctx.onSelectionChange,
 		rowSelectionConfig
 	]);
+	/** 测量同值列总结区高度，供 autoCalc 时 scroll.y 减去该高度 */
+	(0, react.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 = (0, react.useMemo)(() => {
 		const picked = {};
 		Object.keys(ctx).forEach((k) => {
@@ -90,7 +150,7 @@ const RecordBoardGridView = (props) => {
 		return picked;
 	}, [ctx]);
 	if (typeof render === "function") return /* @__PURE__ */ react.default.createElement(react.default.Fragment, null, render(require_objectSpread2._objectSpread2(require_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 = (0, react.useMemo)(() => {
 		return columns.reduce((sum, col) => {
@@ -104,9 +164,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
 			};
 		}
@@ -127,15 +189,27 @@ const RecordBoardGridView = (props) => {
 		ctx.pagination,
 		columns,
 		sumColumnWidths,
-		isEmpty
+		isEmpty,
+		uniformSummaryHeight
 	]);
 	return /* @__PURE__ */ react.default.createElement("div", {
 		"data-layout-slot": "grid",
 		className: "pisell-lowcode-record-board-grid"
-	}, /* @__PURE__ */ react.default.createElement(antd.Table, require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, rest), gridTableProps), {}, {
+	}, summaryItems.length > 0 && /* @__PURE__ */ react.default.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) => require_recordBoardColumns.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" ? require_index.getText("record-board-uniform-summary-empty") : (_item$displayValue = item.displayValue) !== null && _item$displayValue !== void 0 ? _item$displayValue : require_index.getText("record-board-uniform-summary-same");
+		return /* @__PURE__ */ react.default.createElement("div", {
+			key: item.columnKey,
+			className: "pisell-record-board-uniform-summary-item"
+		}, /* @__PURE__ */ react.default.createElement("span", { className: "pisell-record-board-uniform-summary-label" }, item.title), /* @__PURE__ */ react.default.createElement("span", { className: "pisell-record-board-uniform-summary-value" }, content));
+	})), /* @__PURE__ */ react.default.createElement(antd.Table, require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2(require_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/lib/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/lib/components/pisellRecordBoard/shellFrame/BatchActionBar/index.js

@@ -1,7 +1,7 @@
 const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.js');
 const require_objectSpread2 = require('../../../../_virtual/_@oxc-project_runtime@0.108.0/helpers/objectSpread2.js');
-const require_PisellBatchActionBar = require('../../../pisellBatchActionBar/PisellBatchActionBar.js');
 const require_useRecordBoardContext = require('../../hooks/useRecordBoardContext.js');
+const require_PisellBatchActionBar = require('../../../pisellBatchActionBar/PisellBatchActionBar.js');
 let react = require("react");
 react = require_rolldown_runtime.__toESM(react);