@pisell/materials 1.8.41 → 1.8.43

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

@@ -12,89 +12,107 @@ category: pro
 
 # Shell Frame 记录看板外壳
 
-Shell Frame 是 **PisellRecordBoard** 的外壳子组件，基于 `PisellShellFrame` 实现，提供「工具栏 + 多选操作栏 + 内容区 + 分页」的完整布局，与 **GridLayout** / **CardLayout** 搭配使用。
+Shell Frame 是 **PisellRecordBoard** 的外壳子组件，基于 `PisellShellFrame` 实现，提供「工具栏 + 多选操作栏 + 内容区 +
+分页」的完整布局，与 **GridLayout** / **CardLayout** 搭配使用。
 
 ## 组件介绍
 
 - **使用方式**：在 `PisellRecordBoard` 下使用 `PisellRecordBoard.ShellFrame` 包裹内容区（Layout），即可获得工具栏、多选操作栏和底部分页。
-- **数据与配置**：Shell Frame 内各子组件通过 **useRecordBoardContext** 消费容器的 `data`、`searchParams`、`onSearch`、`columnVisibility` 等；工具栏、分页、批量操作栏的展示与行为由 **grid** / **toolBar** / **pagination** / **batchActionBar** 等打散配置控制。
+- **数据与配置**：Shell Frame 内各子组件通过 **useRecordBoardContext** 消费容器的 `data`、`searchParams`、`onSearch`、
+  `columnVisibility` 等；工具栏、分页、批量操作栏的展示与行为由 **grid** / **toolBar** / **pagination** / **batchActionBar
+  ** 等打散配置控制。
 
 ## 结构示意
 
 ```
 ┌─────────────────────────────────────────────────────────────────┐
-│ ToolBar（左侧：QuickFilter + 搜索；右侧：列设置、排序、筛选、重置）   │
+│ ToolBar（最左可选：表格/平面图；左侧 QuickFilter + 搜索；右侧列设置、排序、筛选、重置） │
 ├─────────────────────────────────────────────────────────────────┤
 │ BatchActionBar（有选中项时展示：全选/反选/清空/删除 + 自定义 actions）│
 ├─────────────────────────────────────────────────────────────────┤
-│ children（通常为 GridLayout 或 CardLayout）                        │
+│ 主内容：children（GridLayout/CardLayout）或 PisellFloorMapLayout   │
 ├─────────────────────────────────────────────────────────────────┤
-│ Pagination（底部分页）                                            │
+│ Pagination（仅表格主内容时展示；平面图模式隐藏）                    │
 └─────────────────────────────────────────────────────────────────┘
 ```
 
+### 平面图模式（`FloorMap` 子组件 / 根级 `floorMap`）
+
+当 ShellFrame 解析到 **平面图能力**（子节点含 **`PisellRecordBoard.FloorMap`** 和/或根级传入 **`floorMap`**）且当前 *
+*`bodyView === 'floorMap'`**（或仅平面图、无表格区子节点时固定为平面图）时：
+
+- 主内容区渲染 **PisellFloorMapLayout**，**不再**使用 `ScrollAreaMeasurer` 包裹（避免与画布滚动/缩放冲突）。
+- **底部分页不展示**；批量操作栏仍保留（若业务需要可再在 BatchActionBar 层做显隐）。
+- 切换回 **表格** 时恢复滚动测量与底部分页。
+- **仅平面图、无 Grid 子节点** 时，左侧 **QuickFilter** 仍可来自 **`grid.columns`**（列上 `filter.quickFilter`）或 *
+  *`toolBar.quickFilter.filterList`**
+  ；详见 [PisellRecordBoard - 仅平面图快筛](./PisellRecordBoard.md#仅平面图左侧快筛与搜索无-gridlayout)。
+
+详见 [PisellRecordBoard 使用文档](./PisellRecordBoard.md) 中的「平面图（Floor Map）」章节。
+
 ## 使用方式
 
 ```tsx
 import React from 'react';
-import { PisellRecordBoard } from '@pisell/materials';
+import {PisellRecordBoard} from '@pisell/materials';
 
-const list = [{ id: '1', name: '示例' }];
-const columns = [{ title: '名称', dataIndex: 'name', key: 'name' }];
+const list = [{id: '1', name: '示例'}];
+const columns = [{title: '名称', dataIndex: 'name', key: 'name'}];
 
-function Demo() {
-  return (
+export default () => (
     <PisellRecordBoard
-      rowKey="id"
-      data={list}
-      loading={false}
-      total={100}
-      pagination={{ pageNumber: 1, pageSize: 10 }}
-      onPageChange={() => {}}
-      searchParams={{}}
-      onSearch={() => {}}
-      grid={{ columns }}
+        rowKey="id"
+        data={list}
+        loading={false}
+        total={100}
+        pagination={{pageNumber: 1, pageSize: 10}}
+        onPageChange={() => {
+        }}
+        searchParams={{}}
+        onSearch={() => {
+        }}
+        grid={{columns}}
     >
-      <PisellRecordBoard.ShellFrame>
-        <PisellRecordBoard.GridLayout />
-      </PisellRecordBoard.ShellFrame>
+        <PisellRecordBoard.ShellFrame>
+            <PisellRecordBoard.GridLayout/>
+        </PisellRecordBoard.ShellFrame>
     </PisellRecordBoard>
-  );
-}
-export default Demo;
+);
 ```
 
 ## 子模块说明
 
-| 模块 | 说明 |
-|------|------|
-| **ToolBar** | 工具栏。左侧：QuickFilter（可选）+ PisellFind 搜索；右侧：列设置、Sort、PisellFilter、ToolBarReset、slots.topRight。筛选项与排序项可由 `grid.columns` 派生，或通过 `toolBar.filter` / `toolBar.sort` 覆盖。 |
-| **BatchActionBar** | 多选操作栏。有选中行时展示；全选/反选/清空基于当前页 data；删除与自定义操作通过 `batchActionBar.actions` 等配置。 |
-| **Pagination** | 底部分页。从 context 取 `pagination`、`total`、`onPageChange`；可透传 `childComponentProps.pagination`。样式类名：`record-board-shell-frame-pagination`。 |
-| **Search** | 独立搜索槽（非 ToolBar 内嵌）。绑定 `searchParams.keyword` 与 `onSearch`，可通过 `childComponentProps.search` 透传 PisellFind 的 props。 |
-| **ToolBarReset** | 重置按钮。清空筛选与排序（filter.values、sort），并调用 `onSearch` / `onReset`。 |
-| **ToolBarQuickFilter** | 左侧内联快速筛选。将 quickFilter 直接展示在 ToolBar 左侧；与 `searchParams.filter` 联动。启用时建议 Filter 弹层传 `hiddenQuickFilter: true`。 |
-| **ColumnSetting** | 列显示隐藏入口。有 `grid.columns` 且 `toolBar.columnSetting !== false` 时在 ToolBar 右侧展示；点击弹出列显隐勾选。 |
+| 模块                     | 说明                                                                                                                                                               |
+|------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **ToolBar**            | 工具栏。左侧：QuickFilter（可选）+ PisellFind 搜索；右侧：列设置、Sort、PisellFilter、ToolBarReset、slots.topRight。筛选项与排序项可由 `grid.columns` 派生，或通过 `toolBar.filter` / `toolBar.sort` 覆盖。 |
+| **BatchActionBar**     | 多选操作栏。有选中行时展示；全选/反选/清空基于当前页 data；删除与自定义操作通过 `batchActionBar.actions` 等配置。                                                                                        |
+| **Pagination**         | 底部分页。从 context 取 `pagination`、`total`、`onPageChange`；可透传 `childComponentProps.pagination`。样式类名：`record-board-shell-frame-pagination`。                            |
+| **Search**             | 独立搜索槽（非 ToolBar 内嵌）。绑定 `searchParams.keyword` 与 `onSearch`，可通过 `childComponentProps.search` 透传 PisellFind 的 props。                                               |
+| **ToolBarReset**       | 重置按钮。清空筛选与排序（filter.values、sort），并调用 `onSearch` / `onReset`。                                                                                                     |
+| **ToolBarQuickFilter** | 左侧内联快速筛选。将 quickFilter 直接展示在 ToolBar 左侧；与 `searchParams.filter` 联动。启用时建议 Filter 弹层传 `hiddenQuickFilter: true`。                                                   |
+| **ColumnSetting**      | 列显示隐藏入口。有 `grid.columns` 且 `toolBar.columnSetting !== false` 时在 ToolBar 右侧展示；点击弹出列显隐勾选。                                                                          |
 
 ## 配置入口（childComponentProps）
 
 Shell Frame 内各块通过 RecordBoard 打散传入的 **grid**、**toolBar**、**pagination**、**batchActionBar** 等生效，对应关系如下。
 
-| 配置键 | 作用范围 | 说明 |
-|--------|----------|------|
-| **grid** | 列、滚动、多选、列默认隐藏 | `columns`、`defaultHiddenColumnKeys`、列上 `hidden: true` 参与列显隐；ColumnSetting 据此展示列列表。 |
-| **toolBar** | ToolBar | `search`：true/对象/false，控制搜索展示与透传。`filter`：同上，控制筛选弹层。`sort`：同上，控制排序。`quickFilter`：true 或 `{ filterList, formFiltersPrefix, size }`。`columnSetting`：是否显示列设置入口，默认 true。`topLeft` / `topRight` / `bottomLeft` / `bottomRight` / `tabs`：插槽。 |
-| **pagination** | Pagination | 透传给底部分页组件（如 showSizeChanger、sizeOptions 等）。 |
-| **batchActionBar** | BatchActionBar | 与 PisellBatchActionBar 的 props 对齐：`actions`、`defaultActions`、`overflowThreshold`、`onDelete` 等。 |
+| 配置键                | 作用范围           | 说明                                                                                                                                                                                                                                     |
+|--------------------|----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **grid**           | 列、滚动、多选、列默认隐藏  | `columns`、`defaultHiddenColumnKeys`、列上 `hidden: true` 参与列显隐；ColumnSetting 据此展示列列表。                                                                                                                                                     |
+| **toolBar**        | ToolBar        | `search`：true/对象/false，控制搜索展示与透传。`filter`：同上，控制筛选弹层。`sort`：同上，控制排序。`quickFilter`：true 或 `{ filterList, formFiltersPrefix, size }`。`columnSetting`：是否显示列设置入口，默认 true。`topLeft` / `topRight` / `bottomLeft` / `bottomRight` / `tabs`：插槽。 |
+| **pagination**     | Pagination     | 透传给底部分页组件（如 showSizeChanger、sizeOptions 等）。                                                                                                                                                                                            |
+| **batchActionBar** | BatchActionBar | 与 PisellBatchActionBar 的 props 对齐：`actions`、`defaultActions`、`overflowThreshold`、`onDelete` 等。                                                                                                                                         |
 
 ## 搜索与筛选约定
 
 - **搜索**：默认绑定 `searchParams.keyword`，变更时调用 `onSearch({ ...searchParams, keyword: value })`。
-- **筛选**：绑定 `searchParams.filter`，结构为 `{ quickFilter, otherFilter, values }`；ToolBar 内右侧 Filter 弹层默认 `hiddenQuickFilter: true`，快筛全部在左侧 QuickFilter 展示。**筛选默认值**：在受控用法下，给传入的 `searchParams` 设置初始值，在 `filter.values` 里按 quickFilter 的 `name`/`key` 写好默认值即可（详见 [PisellRecordBoard - 筛选默认值](./PisellRecordBoard.md#筛选默认值quickfilter)）。
+- **筛选**：绑定 `searchParams.filter`，结构为 `{ quickFilter, otherFilter, values }`；ToolBar 内右侧 Filter 弹层默认
+  `hiddenQuickFilter: true`，快筛全部在左侧 QuickFilter 展示。**筛选默认值**：在受控用法下，给传入的 `searchParams` 设置初始值，在
+  `filter.values` 里按 quickFilter 的 `name`/`key`
+  写好默认值即可（详见 [PisellRecordBoard - 筛选默认值](./PisellRecordBoard.md#筛选默认值quickfilter)）。
 - **排序**：绑定 `searchParams.sort`，单值字符串；Sort 与 Filter 变更均通过 `onSearch` 写回 `searchParams`。
 
 ## 相关文档
 
-- [PisellRecordBoard](./PisellRecordBoard.md)
-- [架构说明](./architecture.md)
-- [列与筛选/排序绑定](./columns-filter-binding.md)
+- [PisellRecordBoard 使用文档](./PisellRecordBoard.md)
+- [PisellRecordBoard 开发文档](./PisellRecordBoard.$tab-dev.md)（ShellFrame 分支实现）

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

@@ -1,4 +1,4 @@
-import { RecordBoardBodyView, RecordBoardCalendarBookingLike, RecordBoardCalendarProps, RecordBoardCalendarResource, RecordBoardChildComponentProps, RecordBoardColumnFilterConfig, RecordBoardColumnType, RecordBoardContextValue, RecordBoardFieldType, RecordBoardFloorMapProps, RecordBoardGetOptions, RecordBoardGridProps, RecordBoardLayoutType, RecordBoardOptionItem, RecordBoardProps, RecordBoardToolBarProps } from "./types.js";
+import { DEFAULT_RESOURCE_WALL_LAYOUT_PERSIST, RecordBoardBlockedTimeMergedRange, RecordBoardBlockedTimePanelPayload, RecordBoardBodyView, RecordBoardBookingMoveDraft, RecordBoardCalendarBlockedTimePayload, RecordBoardCalendarBookingLike, RecordBoardCalendarBookingRenderArgs, RecordBoardCalendarDayOverlayBooking, RecordBoardCalendarProps, RecordBoardCalendarResource, RecordBoardCalendarResourceRenderArgs, RecordBoardCalendarSelectedFreeSlot, RecordBoardCalendarTimelineHeaderGroup, RecordBoardCalendarTimelineHeaderRenderContext, RecordBoardChildComponentProps, RecordBoardColumnFilterConfig, RecordBoardColumnType, RecordBoardContextValue, RecordBoardCreateBookingDayGroup, RecordBoardCreateBookingFromSelectionPayload, RecordBoardFieldType, RecordBoardFloorMapProps, RecordBoardGetOptions, RecordBoardGridProps, RecordBoardLayoutType, RecordBoardLayoutVariant, RecordBoardOptionItem, RecordBoardProps, RecordBoardResourceWallCardModel, RecordBoardResourceWallLayoutPersist, RecordBoardResourceWallProps, RecordBoardToolBarProps } from "./types.js";
 import { RecordBoardGridView } from "./layouts/GridLayout/Grid.js";
 import { GridLayout } from "./layouts/GridLayout/index.js";
 import { RecordBoardCardList } from "./layouts/CardLayout/CardList.js";
@@ -9,9 +9,12 @@ import { RecordBoardPagination } from "./shellFrame/Pagination/index.js";
 import { RecordBoardSearch } from "./shellFrame/Search/index.js";
 import { RecordBoardFloorMap } from "./shellFrame/FloorMap.js";
 import { RecordBoardCalendar } from "./shellFrame/Calendar/RecordBoardCalendar.js";
+import { RecordBoardResourceWall } from "./shellFrame/ResourceWall/RecordBoardResourceWall.js";
 import { useRecordBoardShellBodyMeta } from "./shellFrame/ShellBodyMetaContext.js";
 import { RecordBoardShellFrame } from "./shellFrame/index.js";
 import { useRecordBoardContext } from "./hooks/useRecordBoardContext.js";
+import { DEFAULT_RESOURCE_WALL_FILTER_FIELD_KEY } from "./shellFrame/ResourceWall/PisellRecordBoardResourceWallView.js";
+import { AdaptColumnsForPhoneLayoutOptions, RECORD_BOARD_PHONE_GRID_CLASS, adaptColumnsForPhoneLayout } from "./utils/recordBoardPhoneGrid.js";
 import React from "react";
 
 //#region src/components/pisellRecordBoard/index.d.ts
@@ -32,6 +35,10 @@ interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
    * 日历槽位：仅在 ShellFrame 内声明，无 DOM；与 GridLayout / FloorMap 并存时出现「表格 / 平面图 / 日历」切换。
    */
   Calendar: typeof RecordBoardCalendar;
+  /**
+   * 大屏资源墙槽位：仅在 ShellFrame 内声明，无 DOM；与其它主区并存时出现视图切换。
+   */
+  ResourceWall: typeof RecordBoardResourceWall;
   /** 单独使用：搜索槽（PisellFind，绑定 searchParams.keyword / onSearch） */
   Search: typeof RecordBoardSearch;
   /** 单独使用：工具栏（PisellToolBar，含搜索/导出，可透传 topLeft/topRight 等） */

package/es/components/pisellRecordBoard/index.js

@@ -1,16 +1,20 @@
 import PisellRecordBoard$1 from "./PisellRecordBoard.js";
 import { useRecordBoardContext } from "./hooks/useRecordBoardContext.js";
+import "./utils/recordBoardPhoneGrid.js";
 import RecordBoardGridView from "./layouts/GridLayout/Grid.js";
 import GridLayout from "./layouts/GridLayout/index.js";
 import RecordBoardCardList from "./layouts/CardLayout/CardList.js";
 import CardLayout from "./layouts/CardLayout/index.js";
 import RecordBoardFloorMap from "./shellFrame/FloorMap.js";
 import RecordBoardCalendar from "./shellFrame/Calendar/RecordBoardCalendar.js";
+import RecordBoardResourceWall from "./shellFrame/ResourceWall/RecordBoardResourceWall.js";
 import "./shellFrame/ShellBodyMetaContext.js";
 import RecordBoardToolBar from "./shellFrame/ToolBar/index.js";
 import RecordBoardBatchActionBar from "./shellFrame/BatchActionBar/index.js";
 import RecordBoardPagination from "./shellFrame/Pagination/index.js";
 import RecordBoardSearch from "./shellFrame/Search/index.js";
+import "./types.js";
+import "./shellFrame/ResourceWall/PisellRecordBoardResourceWallView.js";
 import RecordBoardShellFrame from "./shellFrame/index.js";
 //#region src/components/pisellRecordBoard/index.tsx
 const PisellRecordBoard = PisellRecordBoard$1;
@@ -19,6 +23,7 @@ PisellRecordBoard.GridLayout = GridLayout;
 PisellRecordBoard.CardLayout = CardLayout;
 PisellRecordBoard.FloorMap = RecordBoardFloorMap;
 PisellRecordBoard.Calendar = RecordBoardCalendar;
+PisellRecordBoard.ResourceWall = RecordBoardResourceWall;
 PisellRecordBoard.Search = RecordBoardSearch;
 PisellRecordBoard.ToolBar = RecordBoardToolBar;
 PisellRecordBoard.Pagination = RecordBoardPagination;

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

@@ -3,8 +3,10 @@ import { _objectSpread2 } from "../../../../_virtual/_@oxc-project_runtime@0.122
 import { _objectWithoutProperties } from "../../../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectWithoutProperties.js";
 import { computeUniformColumnSummary, getRecordBoardColumnKey, isTrivialUniformSummaryReactContent, processColumnsForGrid } from "../../utils/recordBoardColumns.js";
 import { useRecordBoardContext } from "../../hooks/useRecordBoardContext.js";
+import { resolveRecordBoardPhoneScrollX } from "../../utils/recordBoardPhoneGrid.js";
 import React, { useEffect, useMemo, useRef, useState } from "react";
-import { Table } from "antd";
+import { Spin, Table } from "antd";
+import classNames from "classnames";
 import "./Grid.less";
 //#region src/components/pisellRecordBoard/layouts/GridLayout/Grid.tsx
 const _excluded = [
@@ -12,7 +14,7 @@ const _excluded = [
 	"columns",
 	"rowKey",
 	"rowSelection"
-], _excluded2 = ["autoCalc"];
+], _excluded2 = ["autoCalc"], _excluded3 = ["onScroll"], _excluded4 = ["summary"];
 function getRowKey(record, rowKey) {
 	var _ref, _record$id;
 	if (typeof rowKey === "function") return rowKey(record);
@@ -48,16 +50,25 @@ const CONTEXT_ONLY_KEYS = [
 	"setScrollAreaHeight",
 	"collapseUniformColumns",
 	"columnOrder",
-	"onColumnOrderChange"
+	"onColumnOrderChange",
+	"gridInfiniteScroll",
+	"infiniteScroll",
+	"paginationRender",
+	"layoutVariant",
+	"phoneColumnWidthCaps",
+	"phoneColumnWidthRatioByKey",
+	"phoneColumnWidthRatio"
 ];
 const RecordBoardGridView = (props) => {
-	var _ref2, _ctx$data2, _ctx$data3;
+	var _ref2, _ctx$data2, _ctx$data4;
 	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 columnOrder = ctx.columnOrder;
 	const collapseUniformColumns = ctx.collapseUniformColumns !== false;
+	const isPhoneLayout = ctx.layoutVariant === "phone";
+	const gridClassName = typeof ctx.className === "string" ? ctx.className : void 0;
 	/** 同值列总结区高度，用于 autoCalc 时正确计算 scroll.y */
 	const summaryRef = useRef(null);
 	const [uniformSummaryHeight, setUniformSummaryHeight] = useState(0);
@@ -102,7 +113,8 @@ const RecordBoardGridView = (props) => {
 		columnVisibility,
 		columnOrder,
 		collapseUniformColumns,
-		ctx.data
+		ctx.data,
+		isPhoneLayout
 	]);
 	const tableRowKey = useMemo(() => {
 		var _ref3, _ctx$rowKey;
@@ -147,6 +159,7 @@ const RecordBoardGridView = (props) => {
 	const gridTableProps = useMemo(() => {
 		const picked = {};
 		Object.keys(ctx).forEach((k) => {
+			if (k === "onScroll") return;
 			if (CONTEXT_ONLY_KEYS.includes(k)) return;
 			picked[k] = ctx[k];
 		});
@@ -156,22 +169,31 @@ const RecordBoardGridView = (props) => {
 	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) => {
-			var _col$width;
-			return sum + ((_col$width = col.width) !== null && _col$width !== void 0 ? _col$width : 250);
-		}, 0) || 2e3;
-	}, [columns]);
+		const sum = columns.reduce((acc, col) => {
+			if (typeof col.width === "number" && Number.isFinite(col.width)) return acc + col.width;
+			return isPhoneLayout ? acc : acc + 250;
+		}, 0);
+		if (sum > 0) return sum;
+		return isPhoneLayout ? 0 : 2e3;
+	}, [columns, isPhoneLayout]);
+	const selectionColumnWidth = useMemo(() => {
+		if (!rowSelection || typeof rowSelection !== "object") return 0;
+		const w = rowSelection.columnWidth;
+		return typeof w === "number" && Number.isFinite(w) ? w : 48;
+	}, [rowSelection]);
+	const gridInfiniteScroll = ctx.gridInfiniteScroll === true;
 	const tableScroll = useMemo(() => {
 		var _rest$scroll;
 		const scroll = (_rest$scroll = rest.scroll) !== null && _rest$scroll !== void 0 ? _rest$scroll : ctx.scroll;
-		const scrollX = isEmpty && scroll && typeof scroll.x !== "number" ? sumColumnWidths : scroll === null || scroll === void 0 ? void 0 : scroll.x;
+		const rawScrollX = isEmpty && scroll && typeof scroll.x !== "number" ? sumColumnWidths : scroll === null || scroll === void 0 ? void 0 : scroll.x;
+		const scrollX = isPhoneLayout ? resolveRecordBoardPhoneScrollX(rawScrollX, sumColumnWidths, { selectionColumnWidth }) : rawScrollX;
 		if ((scroll === null || scroll === void 0 ? void 0 : scroll.autoCalc) && typeof ctx.scrollAreaHeight === "number") {
 			const wrapHeight = ctx.scrollAreaHeight;
 			const reservedHeight = 40 + uniformSummaryHeight + 24;
 			return {
 				x: scrollX !== null && scrollX !== void 0 ? scrollX : sumColumnWidths,
 				y: Math.max(wrapHeight - reservedHeight, 100),
-				scrollToFirstRowOnChange: scroll.scrollToFirstRowOnChange
+				scrollToFirstRowOnChange: gridInfiniteScroll ? false : scroll.scrollToFirstRowOnChange
 			};
 		}
 		if (scroll && typeof scroll === "object") {
@@ -179,7 +201,7 @@ const RecordBoardGridView = (props) => {
 			const resolved = Object.keys(restScroll).length ? restScroll : void 0;
 			if (resolved) {
 				var _ref5;
-				return _objectSpread2(_objectSpread2({}, resolved), {}, { x: (_ref5 = scrollX !== null && scrollX !== void 0 ? scrollX : resolved.x) !== null && _ref5 !== void 0 ? _ref5 : sumColumnWidths });
+				return _objectSpread2(_objectSpread2({}, resolved), {}, { x: (_ref5 = scrollX !== null && scrollX !== void 0 ? scrollX : resolved.x) !== null && _ref5 !== void 0 ? _ref5 : sumColumnWidths }, gridInfiniteScroll ? { scrollToFirstRowOnChange: false } : {});
 			}
 			return resolved;
 		}
@@ -192,11 +214,145 @@ const RecordBoardGridView = (props) => {
 		columns,
 		sumColumnWidths,
 		isEmpty,
-		uniformSummaryHeight
+		uniformSummaryHeight,
+		gridInfiniteScroll,
+		isPhoneLayout,
+		selectionColumnWidth
 	]);
+	/** 触底加载下一页：距底部约 48px 内触发，避免 loading 与重复 onPageChange */
+	const infiniteLoadLockRef = useRef(false);
+	/** 已触发 onPageChange、等待下一页数据：宿主可能不设 ctx.loading，需单独驱动表尾「加载中」 */
+	const [infiniteScrollFetching, setInfiniteScrollFetching] = useState(false);
+	useEffect(() => {
+		if (!ctx.loading) infiniteLoadLockRef.current = false;
+	}, [ctx.loading, dataSource.length]);
+	useEffect(() => {
+		setInfiniteScrollFetching(false);
+	}, [dataSource.length]);
+	/**
+	* 无限滚动：监听**实际发生滚动**的节点。
+	* - 有 `scroll.y` 时表体在内部滚动，类名在 ConfigProvider 下为 `.pisell-lowcode-table-body`（非 `.ant-table-body`）；
+	* - `scrollAreaHeight` 未就绪或仅 `autoCalc` 未算高时，整表在 Shell 的 `.pisell-record-board-scroll-body` 内滚，仅绑表体会漏事件（如 HUD 抽屉内嵌表）。
+	*/
+	const gridWrapRef = useRef(null);
+	const ctxRef = useRef(ctx);
+	ctxRef.current = ctx;
+	const restRef = useRef(rest);
+	restRef.current = rest;
+	const gridInfiniteRef = useRef(false);
+	gridInfiniteRef.current = gridInfiniteScroll;
+	useEffect(() => {
+		if (!gridInfiniteScroll) return;
+		const root = gridWrapRef.current;
+		if (!root) return;
+		const handler = (e) => {
+			var _r$onScroll, _onScroll2, _e$currentTarget, _c$data, _c$total;
+			const r = restRef.current;
+			const c = ctxRef.current;
+			const ev = e;
+			(_r$onScroll = r.onScroll) === null || _r$onScroll === void 0 || _r$onScroll.call(r, ev);
+			(_onScroll2 = c.onScroll) === null || _onScroll2 === void 0 || _onScroll2.call(c, ev);
+			if (!gridInfiniteRef.current) return;
+			if (c.loading || infiniteLoadLockRef.current) return;
+			const st = (_e$currentTarget = e.currentTarget) !== null && _e$currentTarget !== void 0 ? _e$currentTarget : e.target;
+			const dataLen = ((_c$data = c.data) !== null && _c$data !== void 0 ? _c$data : []).length;
+			const tot = (_c$total = c.total) !== null && _c$total !== void 0 ? _c$total : 0;
+			const { scrollTop, clientHeight, scrollHeight } = st;
+			const dist = scrollHeight - scrollTop - clientHeight;
+			if (dataLen >= tot) return;
+			if (dist > 48) return;
+			infiniteLoadLockRef.current = true;
+			setInfiniteScrollFetching(true);
+			c.onPageChange(c.pagination.pageNumber + 1, c.pagination.pageSize);
+		};
+		const listScrollTargets = (r) => {
+			const out = [];
+			const seen = /* @__PURE__ */ new Set();
+			const add = (el) => {
+				if (el && !seen.has(el)) {
+					seen.add(el);
+					out.push(el);
+				}
+			};
+			r.querySelectorAll(".ant-table-body, .pisell-lowcode-table-body").forEach((n) => add(n));
+			add(r.closest(".pisell-record-board-scroll-body"));
+			return out;
+		};
+		const cleanups = [];
+		const bind = () => {
+			cleanups.forEach((fn) => fn());
+			cleanups.length = 0;
+			listScrollTargets(root).forEach((el) => {
+				el.addEventListener("scroll", handler, { passive: true });
+				cleanups.push(() => el.removeEventListener("scroll", handler));
+			});
+		};
+		const t0 = window.setTimeout(() => bind(), 0);
+		const t1 = window.setTimeout(() => bind(), 120);
+		const t2 = window.setTimeout(() => bind(), 400);
+		return () => {
+			clearTimeout(t0);
+			clearTimeout(t1);
+			clearTimeout(t2);
+			cleanups.forEach((fn) => fn());
+		};
+	}, [
+		gridInfiniteScroll,
+		dataSource.length,
+		isEmpty,
+		ctx.scrollAreaHeight,
+		columns,
+		summaryItems.length
+	]);
+	const tableRest = useMemo(() => {
+		if (!gridInfiniteScroll) return rest;
+		const _ref6 = rest, { onScroll: _onScroll } = _ref6;
+		return _objectWithoutProperties(_ref6, _excluded3);
+	}, [gridInfiniteScroll, rest]);
+	const userGridSummary = gridTableProps.summary;
+	const infiniteSummaryColSpan = useMemo(() => {
+		return (Array.isArray(columns) ? columns.length : 1) + (rowSelection ? 1 : 0);
+	}, [columns, rowSelection]);
+	/** 无限滚动：在 Table.Summary 内展示状态（与宿主 summary 合并） */
+	const mergedTableSummary = useMemo(() => {
+		if (!gridInfiniteScroll) return userGridSummary;
+		return (pageData) => {
+			var _ctx$data3;
+			const userNode = typeof userGridSummary === "function" ? userGridSummary(pageData) : userGridSummary;
+			const len = ((_ctx$data3 = ctx.data) !== null && _ctx$data3 !== void 0 ? _ctx$data3 : []).length;
+			const tot = ctx.total;
+			const loadingMore = !!ctx.loading || infiniteScrollFetching;
+			const showBar = len > 0 || loadingMore;
+			if (!showBar && !userNode) return null;
+			const hasMore = tot == null || typeof tot !== "number" ? true : len < tot;
+			const allLoaded = typeof tot === "number" && tot > 0 && len > 0 && len >= tot;
+			let statusInner = null;
+			if (showBar) {
+				if (allLoaded) statusInner = /* @__PURE__ */ React.createElement("span", { className: "pisell-record-board-infinite-scroll-tip-done" }, getText("record-board-infinite-scroll-all-loaded"));
+				else if (hasMore && len > 0) statusInner = /* @__PURE__ */ React.createElement("span", { className: "pisell-record-board-infinite-scroll-tip-loading" }, /* @__PURE__ */ React.createElement(Spin, { size: "small" }), /* @__PURE__ */ React.createElement("span", null, getText("record-board-infinite-scroll-loading-more")));
+			}
+			const statusBlock = statusInner != null ? /* @__PURE__ */ React.createElement(Table.Summary, { fixed: "bottom" }, /* @__PURE__ */ React.createElement(Table.Summary.Row, { className: "pisell-record-board-infinite-scroll-summary-row" }, /* @__PURE__ */ React.createElement(Table.Summary.Cell, {
+				index: 0,
+				colSpan: infiniteSummaryColSpan,
+				align: "left"
+			}, /* @__PURE__ */ React.createElement("div", { className: "pisell-record-board-infinite-scroll-tip" }, statusInner)))) : null;
+			if (!userNode && !statusBlock) return null;
+			return /* @__PURE__ */ React.createElement(React.Fragment, null, userNode, statusBlock);
+		};
+	}, [
+		gridInfiniteScroll,
+		userGridSummary,
+		infiniteSummaryColSpan,
+		ctx.data,
+		ctx.total,
+		ctx.loading,
+		infiniteScrollFetching
+	]);
+	const _ref7 = gridTableProps, { summary: _userSummaryOmitted } = _ref7, gridTablePropsWithoutSummary = _objectWithoutProperties(_ref7, _excluded4);
 	return /* @__PURE__ */ React.createElement("div", {
+		ref: gridWrapRef,
 		"data-layout-slot": "grid",
-		className: "pisell-lowcode-record-board-grid"
+		className: classNames("pisell-lowcode-record-board-grid", isPhoneLayout && "pisell-record-board-grid--phone", gridClassName)
 	}, summaryItems.length > 0 && /* @__PURE__ */ React.createElement("div", {
 		ref: summaryRef,
 		className: "pisell-record-board-uniform-summary"
@@ -208,10 +364,11 @@ const RecordBoardGridView = (props) => {
 			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), {}, {
+	})), /* @__PURE__ */ React.createElement(Table, _objectSpread2(_objectSpread2(_objectSpread2({}, tableRest), gridTablePropsWithoutSummary), {}, {
+		summary: mergedTableSummary,
 		scroll: tableScroll,
 		rowKey: tableRowKey,
-		dataSource: (_ctx$data3 = ctx.data) !== null && _ctx$data3 !== void 0 ? _ctx$data3 : [],
+		dataSource: (_ctx$data4 = ctx.data) !== null && _ctx$data4 !== void 0 ? _ctx$data4 : [],
 		loading: ctx.loading,
 		columns,
 		rowSelection,

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

@@ -7,6 +7,54 @@
   }
 }
 
+/**
+ * `layoutVariant="phone"`：统一收窄表头/表体与无限滚动表尾单元格 padding（业务列样式可挂在 grid.className 下）。
+ */
+.pisell-lowcode-record-board-grid.pisell-record-board-grid--phone {
+  .pisell-lowcode-table-thead .pisell-lowcode-table-cell,
+  .pisell-lowcode-table-tbody .pisell-lowcode-table-cell,
+  .ant-table-thead .ant-table-cell,
+  .ant-table-tbody .ant-table-cell {
+    padding: 6px 6px !important;
+  }
+
+  .pisell-record-board-infinite-scroll-summary-row > .pisell-lowcode-table-cell,
+  .pisell-record-board-infinite-scroll-summary-row > .ant-table-cell {
+    padding: 6px 6px !important;
+  }
+
+  .pisell-record-board-uniform-summary {
+    flex-wrap: wrap;
+    align-items: flex-start;
+    gap: 8px 12px;
+    min-height: 36px;
+    padding: 8px 12px;
+
+    .pisell-record-board-uniform-summary-item {
+      flex-shrink: 1;
+      min-width: 0;
+      max-width: 100%;
+      flex-wrap: wrap;
+    }
+
+    .pisell-record-board-uniform-summary-label,
+    .pisell-record-board-uniform-summary-value {
+      white-space: normal;
+    }
+
+    /** 同值总结区 Tag：略小于桌面 14px pill，与手机行高对齐 */
+    .pisell-tags,
+    .ant-tag,
+    .pisell-lowcode-tag {
+      padding: 1px 8px;
+      font-size: 11px;
+      line-height: 16px;
+      border-radius: 10px;
+      gap: 4px;
+    }
+  }
+}
+
 // 同值列折叠时的总结区样式（参考 Figma 12840-86869）
 .pisell-record-board-uniform-summary {
   display: flex;
@@ -111,3 +159,34 @@
 .pisell-record-board-row-cancelled {
   background: #fff1f0;
 }
+
+// 无限滚动：表尾 Table.Summary 一行，文案靠左
+// 不再加 border-top：上方数据行已有 border-bottom，再画 top 会与 antd 格线叠成双线
+.pisell-record-board-infinite-scroll-summary-row > .pisell-lowcode-table-cell,
+.pisell-record-board-infinite-scroll-summary-row > .ant-table-cell {
+  background: var(--ant-color-bg-container, #ffffff) !important;
+  border-top: none !important;
+  text-align: left !important;
+  vertical-align: middle;
+  padding: 8px 12px !important;
+}
+
+.pisell-record-board-infinite-scroll-tip {
+  display: inline-flex;
+  align-items: center;
+  justify-content: flex-start;
+  gap: 8px;
+  font-size: 12px;
+  line-height: 18px;
+}
+
+.pisell-record-board-infinite-scroll-tip-loading {
+  display: inline-flex;
+  align-items: center;
+  gap: 8px;
+  color: #475467;
+}
+
+.pisell-record-board-infinite-scroll-tip-done {
+  color: #667085;
+}