@pisell/materials 6.11.8 → 6.11.10

package/es/components/pisellRecordBoard/context/RecordBoardContext.js

@@ -0,0 +1,2 @@
+import { createContext } from 'react';
+export var RecordBoardContext = /*#__PURE__*/createContext(null);

package/es/components/pisellRecordBoard/context/RecordBoardProvider.js

@@ -0,0 +1,13 @@
+import React from 'react';
+import { RecordBoardContext } from "./RecordBoardContext";
+/**
+ * 仅负责注入 RecordBoard 上下文。
+ * 实际的数据源、onSearch/onPageChange 由上层（如接 DataSourceContainer 或独立 fetch）提供。
+ */
+export var RecordBoardProvider = function RecordBoardProvider(_ref) {
+  var value = _ref.value,
+    children = _ref.children;
+  return /*#__PURE__*/React.createElement(RecordBoardContext.Provider, {
+    value: value
+  }, children);
+};

package/es/components/pisellRecordBoard/hooks/useRecordBoardContext.js

@@ -0,0 +1,29 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { useContext } from 'react';
+import { RecordBoardContext } from "../context/RecordBoardContext";
+
+/**
+ * 消费 RecordBoard 上下文，供各 layout 内子组件（Search / ToolBar / Grid / CardList / Pagination）使用。
+ * 若传入 displayName，返回会合并 childComponentProps[displayName] 便于透传。
+ * 当 displayName 为 'grid' 时，返回类型包含 RecordBoardGridProps（columns、scroll、size）。
+ */
+
+export function useRecordBoardContext() {
+  var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+  var ctx = useContext(RecordBoardContext);
+  if (!ctx) {
+    throw new Error('useRecordBoardContext 必须在 PisellRecordBoard（或 RecordBoardProvider）下使用');
+  }
+  var displayName = options.displayName,
+    childComponentProps = options.childComponentProps;
+  var mergedChildProps = childComponentProps !== null && childComponentProps !== void 0 ? childComponentProps : ctx.childComponentProps;
+  if (displayName && mergedChildProps !== null && mergedChildProps !== void 0 && mergedChildProps[displayName]) {
+    return _objectSpread(_objectSpread({}, ctx), mergedChildProps[displayName]);
+  }
+  return ctx;
+}

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import GridLayout from './layouts/GridLayout';
+import CardLayout from './layouts/CardLayout';
+import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch } from './shellFrame';
+import RecordBoardGridView from './layouts/GridLayout/Grid';
+import RecordBoardCardList from './layouts/CardLayout/CardList';
+import { useRecordBoardContext } from './hooks/useRecordBoardContext';
+import type { RecordBoardProps } from './types';
+/** RecordBoard 复合组件类型 */
+interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
+    /** Shell Frame：对 Layout 的扩展，提供 ToolBar + BatchActionBar + children（Layout） */
+    ShellFrame: typeof RecordBoardShellFrame;
+    /** Grid 布局：仅内容区（表格 + 分页），需配合 ShellFrame 使用 */
+    GridLayout: typeof GridLayout;
+    /** 卡片布局：仅内容区（卡片列表 + 分页），需配合 ShellFrame 使用 */
+    CardLayout: typeof CardLayout;
+    /** 单独使用：搜索槽（PisellFind，绑定 searchParams.keyword / onSearch） */
+    Search: typeof RecordBoardSearch;
+    /** 单独使用：工具栏（PisellToolBar，含搜索/导出，可透传 topLeft/topRight 等） */
+    ToolBar: typeof RecordBoardToolBar;
+    /** 单独使用：分页槽 */
+    Pagination: typeof RecordBoardPagination;
+    /** 单独使用：Grid 视图（表格） */
+    Grid: typeof RecordBoardGridView;
+    /** 单独使用：卡片列表视图 */
+    CardList: typeof RecordBoardCardList;
+    /** 多选操作栏（基于 PisellBatchActionBar，有选中项时展示） */
+    BatchActionBar: typeof RecordBoardBatchActionBar;
+    /** 消费 RecordBoard 上下文 */
+    useRecordBoardContext: typeof useRecordBoardContext;
+}
+declare const PisellRecordBoard: PisellRecordBoardType;
+export default PisellRecordBoard;
+export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, } from './types';
+export { useRecordBoardContext } from './hooks/useRecordBoardContext';

package/es/components/pisellRecordBoard/index.js

@@ -0,0 +1,23 @@
+import PisellRecordBoardComponent from "./PisellRecordBoard";
+import GridLayout from "./layouts/GridLayout";
+import CardLayout from "./layouts/CardLayout";
+import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch } from "./shellFrame";
+import RecordBoardGridView from "./layouts/GridLayout/Grid";
+import RecordBoardCardList from "./layouts/CardLayout/CardList";
+import { useRecordBoardContext } from "./hooks/useRecordBoardContext";
+
+/** RecordBoard 复合组件类型 */
+
+var PisellRecordBoard = PisellRecordBoardComponent;
+PisellRecordBoard.ShellFrame = RecordBoardShellFrame;
+PisellRecordBoard.GridLayout = GridLayout;
+PisellRecordBoard.CardLayout = CardLayout;
+PisellRecordBoard.Search = RecordBoardSearch;
+PisellRecordBoard.ToolBar = RecordBoardToolBar;
+PisellRecordBoard.Pagination = RecordBoardPagination;
+PisellRecordBoard.Grid = RecordBoardGridView;
+PisellRecordBoard.CardList = RecordBoardCardList;
+PisellRecordBoard.BatchActionBar = RecordBoardBatchActionBar;
+PisellRecordBoard.useRecordBoardContext = useRecordBoardContext;
+export default PisellRecordBoard;
+export { useRecordBoardContext } from "./hooks/useRecordBoardContext";

package/es/components/pisellRecordBoard/layouts/CardLayout/CardList.js

@@ -0,0 +1,36 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+var _excluded = ["render"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React from 'react';
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+/**
+ * Card 布局下的数据视图：从 context 取 data / loading。
+ */
+var RecordBoardCardList = function RecordBoardCardList(props) {
+  var _ctx$data$length, _ctx$data;
+  var ctx = useRecordBoardContext({
+    displayName: 'cardList'
+  });
+  var render = props.render,
+    rest = _objectWithoutProperties(props, _excluded);
+  if (typeof render === 'function') {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, render(_objectSpread(_objectSpread({}, ctx), rest)));
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    "data-layout-slot": "cardList",
+    style: {
+      minHeight: 120
+    }
+  }, /*#__PURE__*/React.createElement("span", {
+    style: {
+      color: 'var(--color-text-tertiary, #999)'
+    }
+  }, "\u5361\u7247\u89C6\u56FE\uFF08", (_ctx$data$length = (_ctx$data = ctx.data) === null || _ctx$data === void 0 ? void 0 : _ctx$data.length) !== null && _ctx$data$length !== void 0 ? _ctx$data$length : 0, " \u6761\uFF0Cloading:", ' ', String(ctx.loading), "\uFF09"));
+};
+export default RecordBoardCardList;

package/es/components/pisellRecordBoard/layouts/CardLayout/index.js

@@ -0,0 +1,20 @@
+import React from 'react';
+import RecordBoardCardList from "./CardList";
+
+/**
+ * Card 布局：仅内容区 = 卡片列表（不含分页）。
+ * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
+ * <PisellRecordBoard.ShellFrame><PisellRecordBoard.CardLayout /></PisellRecordBoard.ShellFrame>
+ */
+var CardLayout = function CardLayout(_ref) {
+  var className = _ref.className,
+    style = _ref.style;
+  return /*#__PURE__*/React.createElement("div", {
+    className: className,
+    style: style,
+    "data-layout": "card"
+  }, /*#__PURE__*/React.createElement(RecordBoardCardList, null));
+};
+CardLayout.displayName = 'RecordBoard.CardLayout';
+export default CardLayout;
+export { RecordBoardCardList as CardLayoutCardList };

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

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { TableProps } from 'antd';
+import type { RecordBoardContextValue } from '../../types';
+import './Grid.less';
+export interface RecordBoardGridViewProps extends Omit<TableProps<any>, 'dataSource' | 'loading' | 'pagination'>, Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
+    /** 列配置，同 antd Table columns */
+    columns?: TableProps<any>['columns'];
+    className?: string;
+    style?: React.CSSProperties;
+    /** 自定义渲染，传入后不再使用内置 Table */
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+declare const RecordBoardGridView: React.FC<RecordBoardGridViewProps>;
+export default RecordBoardGridView;

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

@@ -0,0 +1,137 @@
+var _excluded = ["render", "columns", "rowKey", "rowSelection"],
+  _excluded2 = ["autoCalc"];
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+import React, { useMemo } from 'react';
+import { Table } from 'antd';
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+import { processColumnsForGrid, getRecordBoardColumnKey } from "../../utils/recordBoardColumns";
+import "./Grid.less";
+function getRowKey(record, rowKey) {
+  var _ref, _record$id;
+  if (typeof rowKey === 'function') {
+    return rowKey(record);
+  }
+  if (typeof rowKey === 'string' && record != null && rowKey in record) {
+    return record[rowKey];
+  }
+  return (_ref = (_record$id = record === null || record === void 0 ? void 0 : record.id) !== null && _record$id !== void 0 ? _record$id : record === null || record === void 0 ? void 0 : record.key) !== null && _ref !== void 0 ? _ref : record;
+}
+
+/**
+ * Grid 布局下的数据视图：使用 antd Table，从 context 取 data / loading / 多选态。
+ */
+/** Context 中与 Table 无关的 key，透传 Table 时排除，避免覆盖或无效传递（含 grid 合并进的 columns/scroll 等） */
+var CONTEXT_ONLY_KEYS = ['data', 'loading', 'total', 'pagination', 'onPageChange', 'searchParams', 'onSearch', 'onReset', 'layoutType', 'selectedKeys', 'selectedRows', 'onSelectionChange', 'rowKey', 'childComponentProps', 'columnVisibility', 'onColumnVisibilityChange', 'columns', 'scroll', 'size', 'defaultHiddenColumnKeys', 'scrollAreaHeight', 'setScrollAreaHeight'];
+var RecordBoardGridView = function RecordBoardGridView(props) {
+  var _ref2, _ctx$data, _ctx$data2;
+  var ctx = useRecordBoardContext({
+    displayName: 'grid'
+  });
+  var render = props.render,
+    columnsProp = props.columns,
+    rowKeyProp = props.rowKey,
+    rowSelectionProp = props.rowSelection,
+    rest = _objectWithoutProperties(props, _excluded);
+
+  // columns 优先用 props，其次用 childComponentProps.grid 合并进 ctx 的 columns
+  var rawColumns = (_ref2 = columnsProp !== null && columnsProp !== void 0 ? columnsProp : ctx.columns) !== null && _ref2 !== void 0 ? _ref2 : [];
+  var columnVisibility = ctx.columnVisibility;
+  var columns = useMemo(function () {
+    var list = rawColumns;
+    var visible = columnVisibility == null ? list : list.filter(function (col) {
+      return columnVisibility[getRecordBoardColumnKey(col)] !== false;
+    });
+    return processColumnsForGrid(visible);
+  }, [rawColumns, columnVisibility]);
+  var tableRowKey = useMemo(function () {
+    var _ref3, _ctx$rowKey;
+    var key = (_ref3 = (_ctx$rowKey = ctx.rowKey) !== null && _ctx$rowKey !== void 0 ? _ctx$rowKey : rowKeyProp) !== null && _ref3 !== void 0 ? _ref3 : 'id';
+    return typeof key === 'function' ? key : function (record) {
+      return getRowKey(record, typeof key === 'string' ? key : String(key));
+    };
+  }, [ctx.rowKey, rowKeyProp]);
+  var rowSelectionConfig = rowSelectionProp !== null && rowSelectionProp !== void 0 ? rowSelectionProp : ctx.rowSelection;
+  var rowSelection = useMemo(function () {
+    if (rowSelectionConfig === false) return undefined;
+    var base = _typeof(rowSelectionConfig) === 'object' ? rowSelectionConfig : {};
+    return _objectSpread(_objectSpread({}, base), {}, {
+      selectedRowKeys: ctx.selectedKeys,
+      onChange: function onChange(selectedRowKeys, selectedRows) {
+        var _onChange, _ref4;
+        ctx.onSelectionChange(selectedRowKeys, selectedRows);
+        (_onChange = (_ref4 = base).onChange) === null || _onChange === void 0 || _onChange.call(_ref4, selectedRowKeys, selectedRows);
+      }
+    });
+  }, [ctx.selectedKeys, ctx.onSelectionChange, rowSelectionConfig]);
+
+  // grid 透传的 Table props（onRow、onHeaderRow、expandable、rowClassName、summary 等）从 ctx 取出并传给 Table
+  var gridTableProps = useMemo(function () {
+    var picked = {};
+    Object.keys(ctx).forEach(function (k) {
+      if (CONTEXT_ONLY_KEYS.includes(k)) return;
+      picked[k] = ctx[k];
+    });
+    return picked;
+  }, [ctx]);
+  if (typeof render === 'function') {
+    return /*#__PURE__*/React.createElement(React.Fragment, null, render(_objectSpread(_objectSpread({}, ctx), rest)));
+  }
+  var dataSource = (_ctx$data = ctx.data) !== null && _ctx$data !== void 0 ? _ctx$data : [];
+  var isEmpty = !Array.isArray(dataSource) || dataSource.length === 0;
+  var sumColumnWidths = useMemo(function () {
+    return columns.reduce(function (sum, col) {
+      var _col$width;
+      return sum + ((_col$width = col.width) !== null && _col$width !== void 0 ? _col$width : 250);
+    }, 0) || 2000;
+  }, [columns]);
+
+  // 与 materials Table useGenScroll 对齐：autoCalc 时根据 scrollAreaHeight 计算 scroll.y；无数据且 scroll.x 非数字时用列宽之和避免表头被压窄换行
+  var tableScroll = useMemo(function () {
+    var _rest$scroll;
+    var scroll = (_rest$scroll = rest.scroll) !== null && _rest$scroll !== void 0 ? _rest$scroll : ctx.scroll;
+    var scrollX = isEmpty && scroll && typeof scroll.x !== 'number' ? sumColumnWidths : scroll === null || scroll === void 0 ? void 0 : scroll.x;
+    if (scroll !== null && scroll !== void 0 && scroll.autoCalc && typeof ctx.scrollAreaHeight === 'number') {
+      var wrapHeight = ctx.scrollAreaHeight;
+      return {
+        x: scrollX !== null && scrollX !== void 0 ? scrollX : sumColumnWidths,
+        y: Math.max(wrapHeight - 40, 100),
+        scrollToFirstRowOnChange: scroll.scrollToFirstRowOnChange
+      };
+    }
+    if (scroll && _typeof(scroll) === 'object') {
+      var _ref5 = scroll,
+        _a = _ref5.autoCalc,
+        restScroll = _objectWithoutProperties(_ref5, _excluded2);
+      var resolved = Object.keys(restScroll).length ? restScroll : undefined;
+      if (resolved) {
+        var _ref6;
+        return _objectSpread(_objectSpread({}, resolved), {}, {
+          x: (_ref6 = scrollX !== null && scrollX !== void 0 ? scrollX : resolved.x) !== null && _ref6 !== void 0 ? _ref6 : sumColumnWidths
+        });
+      }
+      return resolved;
+    }
+    return scroll;
+  }, [rest.scroll, ctx.scroll, ctx.scrollAreaHeight, ctx.pagination, columns, sumColumnWidths, isEmpty]);
+  return /*#__PURE__*/React.createElement("div", {
+    "data-layout-slot": "grid",
+    className: "pisell-lowcode-record-board-grid"
+  }, /*#__PURE__*/React.createElement(Table, _extends({}, rest, gridTableProps, {
+    scroll: tableScroll,
+    rowKey: tableRowKey,
+    dataSource: (_ctx$data2 = ctx.data) !== null && _ctx$data2 !== void 0 ? _ctx$data2 : [],
+    loading: ctx.loading,
+    columns: columns,
+    rowSelection: rowSelection,
+    pagination: false
+  })));
+};
+export default RecordBoardGridView;

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

@@ -0,0 +1,62 @@
+// RecordBoard Grid 表格样式：默认单元格（表头+表体）padding 8px 16px
+// 项目内 ant 组件 prefixCls 为 pisell-lowcode，故表格类名为 .pisell-lowcode-table-*
+.pisell-lowcode-record-board-grid {
+  .pisell-lowcode-table-thead .pisell-lowcode-table-cell,
+  .pisell-lowcode-table-tbody .pisell-lowcode-table-cell {
+    padding: 8px 16px;
+  }
+}
+
+// 纯 CSS 占满高度：滚动发生在 .pisell-record-board-scroll-body，表头 sticky 固定；高度传到 table
+.pisell-record-board-scroll-body .pisell-lowcode-record-board-grid {
+  height: 100%;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+
+  .pisell-lowcode-table-thead .pisell-lowcode-table-cell {
+    position: sticky;
+    top: 0;
+    z-index: 1;
+    background: var(--ant-color-bg-container, #ffffff);
+  }
+
+  /*
+   * 根本原因：表头所有单元格统一用了 z-index: 1，横向滚动时后面的列（非固定列）与固定列同层叠，
+   * 非固定列会盖住固定列。解决：仅对「固定列」提高 z-index。
+   * antd/rc-table 会给所有 fixed 列（含多选列）的 th/td 加上 .*-table-cell-fix-left，
+   * 用该类选择器即可覆盖任意数量的固定列，无需按 nth-child 逐个写。
+   */
+
+  .pisell-lowcode-table-thead .pisell-lowcode-table-cell-fix-left {
+    z-index: 2 !important;
+    background: var(--ant-color-bg-container, #ffffff) !important;
+  }
+
+  // 让 antd Table 外层占满，使 scroll.y 生效且高度链不断
+  .pisell-lowcode-table-wrapper {
+    flex: 1;
+    min-height: 0;
+    display: flex;
+    flex-direction: column;
+  }
+
+  .pisell-lowcode-table-wrapper .pisell-lowcode-table {
+    flex: 1;
+    min-height: 0;
+    display: flex;
+    flex-direction: column;
+  }
+
+  .pisell-lowcode-table-wrapper .pisell-lowcode-table .pisell-lowcode-table-container {
+    flex: 1;
+    min-height: 0;
+    display: flex;
+    flex-direction: column;
+  }
+}
+
+// 行状态样式示例（如 grid.rowClassName 返回 'pisell-record-board-row-cancelled'）
+.pisell-record-board-row-cancelled {
+  background: #fff1f0;
+}

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

@@ -0,0 +1,13 @@
+import React from 'react';
+import RecordBoardGridView from './Grid';
+/**
+ * Grid 布局：仅内容区 = 表格（不含分页）。
+ * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
+ * <PisellRecordBoard.ShellFrame><PisellRecordBoard.GridLayout /></PisellRecordBoard.ShellFrame>
+ */
+declare const GridLayout: React.FC<{
+    className?: string;
+    style?: React.CSSProperties;
+}>;
+export default GridLayout;
+export { RecordBoardGridView as GridLayoutGrid };

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import RecordBoardGridView from "./Grid";
+
+/**
+ * Grid 布局：仅内容区 = 表格（不含分页）。
+ * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
+ * <PisellRecordBoard.ShellFrame><PisellRecordBoard.GridLayout /></PisellRecordBoard.ShellFrame>
+ */
+var GridLayout = function GridLayout(_ref) {
+  var className = _ref.className,
+    style = _ref.style;
+  return /*#__PURE__*/React.createElement("div", {
+    className: className,
+    style: style,
+    "data-layout": "grid"
+  }, /*#__PURE__*/React.createElement(RecordBoardGridView, null));
+};
+GridLayout.displayName = 'RecordBoard.GridLayout';
+export default GridLayout;
+export { RecordBoardGridView as GridLayoutGrid };

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

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellBatchActionBarProps } from '../../../pisellBatchActionBar';
+/**
+ * RecordBoard 下的多选操作栏：从 context 取选中态与数据，渲染 PisellBatchActionBar。
+ * 仅在有选中项时展示；全选/反选/清空基于当前页 data。
+ */
+declare const RecordBoardBatchActionBar: React.FC<Partial<PisellBatchActionBarProps>>;
+export default RecordBoardBatchActionBar;

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

@@ -0,0 +1,90 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+import React, { useMemo, useCallback } from 'react';
+import PisellBatchActionBar from "../../../pisellBatchActionBar";
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+function getRowKey(record, rowKey) {
+  var _ref, _record$id;
+  if (typeof rowKey === 'function') {
+    return rowKey(record);
+  }
+  if (typeof rowKey === 'string' && record != null && rowKey in record) {
+    return record[rowKey];
+  }
+  return (_ref = (_record$id = record === null || record === void 0 ? void 0 : record.id) !== null && _record$id !== void 0 ? _record$id : record === null || record === void 0 ? void 0 : record.key) !== null && _ref !== void 0 ? _ref : record;
+}
+
+/**
+ * RecordBoard 下的多选操作栏：从 context 取选中态与数据，渲染 PisellBatchActionBar。
+ * 仅在有选中项时展示；全选/反选/清空基于当前页 data。
+ */
+var RecordBoardBatchActionBar = function RecordBoardBatchActionBar(props) {
+  var _ctx$childComponentPr, _ctx$childComponentPr2;
+  var ctx = useRecordBoardContext({
+    displayName: 'batchActionBar'
+  });
+  var data = ctx.data,
+    total = ctx.total,
+    selectedKeys = ctx.selectedKeys,
+    selectedRows = ctx.selectedRows,
+    onSelectionChange = ctx.onSelectionChange,
+    rowKeyFromContext = ctx.rowKey;
+  var rowKey = rowKeyFromContext !== null && rowKeyFromContext !== void 0 ? rowKeyFromContext : 'id';
+  var currentPageKeys = useMemo(function () {
+    return data.map(function (record) {
+      return getRowKey(record, rowKey);
+    });
+  }, [data, rowKey]);
+  var currentPageTotal = data.length;
+  var onSelectAll = useCallback(function () {
+    onSelectionChange(currentPageKeys, data);
+  }, [currentPageKeys, data, onSelectionChange]);
+  var onClear = useCallback(function () {
+    onSelectionChange([], []);
+  }, [onSelectionChange]);
+  var onInvert = useCallback(function () {
+    var currentSet = new Set(currentPageKeys);
+    var selectedSet = new Set(selectedKeys);
+    var nextKeys = [];
+    var nextRows = [];
+    currentPageKeys.forEach(function (k, i) {
+      if (!selectedSet.has(k)) {
+        nextKeys.push(k);
+        nextRows.push(data[i]);
+      }
+    });
+    var restSelectedKeys = selectedKeys.filter(function (k) {
+      return !currentSet.has(k);
+    });
+    var restSelectedRows = selectedRows.filter(function (_, i) {
+      return !currentSet.has(selectedKeys[i]);
+    });
+    onSelectionChange([].concat(_toConsumableArray(restSelectedKeys), nextKeys), [].concat(_toConsumableArray(restSelectedRows), nextRows));
+  }, [currentPageKeys, data, selectedKeys, selectedRows, onSelectionChange]);
+  var barProps = _objectSpread(_objectSpread({
+    selectedKeys: selectedKeys,
+    selectedRows: selectedRows,
+    total: total,
+    currentPageTotal: currentPageTotal,
+    currentPageKeys: currentPageKeys,
+    onSelectAll: onSelectAll,
+    onClear: onClear,
+    onInvert: onInvert
+  }, (_ctx$childComponentPr = (_ctx$childComponentPr2 = ctx.childComponentProps) === null || _ctx$childComponentPr2 === void 0 ? void 0 : _ctx$childComponentPr2.batchActionBar) !== null && _ctx$childComponentPr !== void 0 ? _ctx$childComponentPr : {}), props);
+  if (selectedKeys.length === 0) {
+    return null;
+  }
+  return /*#__PURE__*/React.createElement(PisellBatchActionBar, barProps);
+};
+RecordBoardBatchActionBar.displayName = 'RecordBoard.BatchActionBar';
+export default RecordBoardBatchActionBar;

package/es/components/pisellRecordBoard/shellFrame/ColumnSetting/ColumnSettingPopover.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 列显示隐藏弹层内容（仅控制列展示显隐，不控制 filter/sort）。
+ * 参考 table Actions ColumnsSetting PopoverContent，去掉拖拽排序。
+ */
+import React from 'react';
+import type { RecordBoardColumnType } from '../../types';
+export interface ColumnSettingPopoverProps {
+    columns: RecordBoardColumnType[];
+    columnVisibility: Record<string, boolean>;
+    onColumnVisibilityChange: (visibility: Record<string, boolean>) => void;
+}
+declare const ColumnSettingPopover: React.FC<ColumnSettingPopoverProps>;
+export default ColumnSettingPopover;

package/es/components/pisellRecordBoard/shellFrame/ColumnSetting/ColumnSettingPopover.js

@@ -0,0 +1,59 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 列显示隐藏弹层内容（仅控制列展示显隐，不控制 filter/sort）。
+ * 参考 table Actions ColumnsSetting PopoverContent，去掉拖拽排序。
+ */
+
+import React from 'react';
+import classNames from 'classnames';
+import { EyeInvisibleOutlined, EyeOutlined } from '@ant-design/icons';
+import { getText } from "../../../../locales";
+import { getRecordBoardColumnKey } from "../../utils/recordBoardColumns";
+var prefix = 'pisell-lowcode-';
+function getColumnTitle(column) {
+  var title = column.title;
+  if (typeof title === 'string') return title;
+  return getRecordBoardColumnKey(column) || '';
+}
+var ColumnSettingPopover = function ColumnSettingPopover(_ref) {
+  var columns = _ref.columns,
+    columnVisibility = _ref.columnVisibility,
+    onColumnVisibilityChange = _ref.onColumnVisibilityChange;
+  var handleToggle = function handleToggle(colKey, isShow) {
+    onColumnVisibilityChange(_defineProperty({}, colKey, isShow));
+  };
+  return /*#__PURE__*/React.createElement("div", {
+    className: "".concat(prefix, "table-action-column-popover-content-wrap")
+  }, /*#__PURE__*/React.createElement("div", {
+    className: "".concat(prefix, "table-action-column-header")
+  }, /*#__PURE__*/React.createElement("span", {
+    className: "".concat(prefix, "table-action-column-header-title")
+  }, getText('table-action-column-title'))), /*#__PURE__*/React.createElement("div", {
+    className: "".concat(prefix, "table-action-column-content")
+  }, columns.map(function (col) {
+    var colKey = getRecordBoardColumnKey(col);
+    var isShow = columnVisibility[colKey] !== false;
+    return /*#__PURE__*/React.createElement("div", {
+      key: colKey,
+      className: "".concat(prefix, "table-action-column-drag-item"),
+      style: {
+        cursor: 'default'
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      className: "".concat(prefix, "table-action-column-drag-item-right")
+    }, /*#__PURE__*/React.createElement("span", {
+      className: classNames("".concat(prefix, "table-action-column-drag-item-right-text"), _defineProperty({}, "".concat(prefix, "table-action-column-drag-item-right-text-hidden"), !isShow))
+    }, getColumnTitle(col)), /*#__PURE__*/React.createElement("span", {
+      className: "".concat(prefix, "table-action-column-drag-item-right-icon-wrap"),
+      onClick: function onClick() {
+        return handleToggle(colKey, !isShow);
+      },
+      role: "button",
+      "aria-label": isShow ? 'hide' : 'show'
+    }, isShow ? /*#__PURE__*/React.createElement(EyeOutlined, null) : /*#__PURE__*/React.createElement(EyeInvisibleOutlined, null))));
+  })));
+};
+export default ColumnSettingPopover;

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

@@ -0,0 +1,8 @@
+/**
+ * RecordBoard 列显示隐藏设置（仅控制表格列展示，不控制 filter/sort）。
+ * 参考 table Actions ColumnsSetting，仅保留显隐切换，无拖拽排序。
+ */
+import React from 'react';
+import './index.less';
+declare const RecordBoardColumnSetting: React.FC;
+export default RecordBoardColumnSetting;