@pisell/materials 1.0.1059 → 1.0.1062

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

@@ -1,7 +1,7 @@
 import React from 'react';
 import GridLayout from './layouts/GridLayout';
 import CardLayout from './layouts/CardLayout';
-import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch } from './shellFrame';
+import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, RecordBoardFloorMap } from './shellFrame';
 import RecordBoardGridView from './layouts/GridLayout/Grid';
 import RecordBoardCardList from './layouts/CardLayout/CardList';
 import { useRecordBoardContext } from './hooks/useRecordBoardContext';
@@ -14,6 +14,11 @@ interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
     GridLayout: typeof GridLayout;
     /** 卡片布局：仅内容区（卡片列表 + 分页），需配合 ShellFrame 使用 */
     CardLayout: typeof CardLayout;
+    /**
+     * 平面图槽位：仅在 ShellFrame 内声明，无 DOM； props 与 PisellFloorMapLayout 对齐。
+     * 与 GridLayout 同时存在时出现「表格 / 平面图」切换。
+     */
+    FloorMap: typeof RecordBoardFloorMap;
     /** 单独使用：搜索槽（PisellFind，绑定 searchParams.keyword / onSearch） */
     Search: typeof RecordBoardSearch;
     /** 单独使用：工具栏（PisellToolBar，含搜索/导出，可透传 topLeft/topRight 等） */
@@ -31,5 +36,5 @@ interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
 }
 declare const PisellRecordBoard: PisellRecordBoardType;
 export default PisellRecordBoard;
-export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, } from './types';
+export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, RecordBoardBodyView, RecordBoardFloorMapProps, RecordBoardToolBarProps, } from './types';
 export { useRecordBoardContext } from './hooks/useRecordBoardContext';

package/es/components/pisellRecordBoard/index.js

@@ -1,7 +1,7 @@
 import PisellRecordBoardComponent from "./PisellRecordBoard";
 import GridLayout from "./layouts/GridLayout";
 import CardLayout from "./layouts/CardLayout";
-import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch } from "./shellFrame";
+import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, RecordBoardFloorMap } from "./shellFrame";
 import RecordBoardGridView from "./layouts/GridLayout/Grid";
 import RecordBoardCardList from "./layouts/CardLayout/CardList";
 import { useRecordBoardContext } from "./hooks/useRecordBoardContext";
@@ -12,6 +12,7 @@ var PisellRecordBoard = PisellRecordBoardComponent;
 PisellRecordBoard.ShellFrame = RecordBoardShellFrame;
 PisellRecordBoard.GridLayout = GridLayout;
 PisellRecordBoard.CardLayout = CardLayout;
+PisellRecordBoard.FloorMap = RecordBoardFloorMap;
 PisellRecordBoard.Search = RecordBoardSearch;
 PisellRecordBoard.ToolBar = RecordBoardToolBar;
 PisellRecordBoard.Pagination = RecordBoardPagination;

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

@@ -12,9 +12,7 @@ import ColumnSettingPopover from "./ColumnSettingPopover";
 import "./index.less";
 var RecordBoardColumnSetting = function RecordBoardColumnSetting() {
   var _ctx$childComponentPr, _ctx$columnVisibility, _ctx$columnOrder;
-  var ctx = useRecordBoardContext({
-    displayName: 'columnSetting'
-  });
+  var ctx = useRecordBoardContext();
   var gridColumns = (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.grid) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.columns;
   var columnVisibility = (_ctx$columnVisibility = ctx.columnVisibility) !== null && _ctx$columnVisibility !== void 0 ? _ctx$columnVisibility : {};
   var onColumnVisibilityChange = ctx.onColumnVisibilityChange;

package/es/components/pisellRecordBoard/shellFrame/FloorMap.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps } from '../types';
+/**
+ * RecordBoard 平面图槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 将 PisellFloorMapLayout 所需 props 声明在树结构上；与 GridLayout 并存时出现「表格 / 平面图」切换。
+ *
+ * @example
+ * <PisellRecordBoard.ShellFrame>
+ *   <PisellRecordBoard.GridLayout />
+ *   <PisellRecordBoard.FloorMap floorMapConfig={...} dataSources={...} />
+ * </PisellRecordBoard.ShellFrame>
+ */
+declare const RecordBoardFloorMap: React.FC<RecordBoardFloorMapProps>;
+export default RecordBoardFloorMap;

package/es/components/pisellRecordBoard/shellFrame/FloorMap.js

@@ -0,0 +1,15 @@
+/**
+ * RecordBoard 平面图槽位：仅在 PisellRecordBoard.ShellFrame 内使用，本身不渲染 DOM。
+ * 将 PisellFloorMapLayout 所需 props 声明在树结构上；与 GridLayout 并存时出现「表格 / 平面图」切换。
+ *
+ * @example
+ * <PisellRecordBoard.ShellFrame>
+ *   <PisellRecordBoard.GridLayout />
+ *   <PisellRecordBoard.FloorMap floorMapConfig={...} dataSources={...} />
+ * </PisellRecordBoard.ShellFrame>
+ */
+var RecordBoardFloorMap = function RecordBoardFloorMap() {
+  return null;
+};
+RecordBoardFloorMap.displayName = 'RecordBoard.FloorMap';
+export default RecordBoardFloorMap;

package/es/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.d.ts

@@ -0,0 +1,16 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps } from '../types';
+/**
+ * ShellFrame 解析子节点后的元信息，供 ToolBar 等判断是否需要「表格 / 平面图」Segmented。
+ * 未处于 ShellFrame.Provider 内时为 undefined（如单独挂载 ToolBar）。
+ */
+export interface RecordBoardShellBodyMeta {
+    /** 子组件 FloorMap props 与根级 floorMap 合并后的结果（子优先） */
+    effectiveFloorMapProps?: RecordBoardFloorMapProps;
+    /** ShellFrame 内是否存在 GridLayout / CardLayout 等非 FloorMap 子节点 */
+    hasGridContent: boolean;
+    /** 合并后是否存在可渲染的平面图配置 */
+    hasFloorMapSlot: boolean;
+}
+export declare const RecordBoardShellBodyMetaContext: React.Context<RecordBoardShellBodyMeta | undefined>;
+export declare function useRecordBoardShellBodyMeta(): RecordBoardShellBodyMeta | undefined;

package/es/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.js

@@ -0,0 +1,11 @@
+import React from 'react';
+
+/**
+ * ShellFrame 解析子节点后的元信息，供 ToolBar 等判断是否需要「表格 / 平面图」Segmented。
+ * 未处于 ShellFrame.Provider 内时为 undefined（如单独挂载 ToolBar）。
+ */
+
+export var RecordBoardShellBodyMetaContext = /*#__PURE__*/React.createContext(undefined);
+export function useRecordBoardShellBodyMeta() {
+  return React.useContext(RecordBoardShellBodyMetaContext);
+}

package/es/components/pisellRecordBoard/shellFrame/ToolBar/ToolBarFilter.less

@@ -1,3 +1,50 @@
+/**
+ * 表格 / 平面图切换：与中间搜索、右侧 Sort/Filter（50px）同高
+ * antd 与 pisell-lowcode 前缀并存时双写选择器
+ */
+.record-board-toolbar-body-view-segmented {
+  &.ant-segmented,
+  &.pisell-lowcode-segmented {
+    height: 50px;
+    min-height: 50px;
+    padding: 4px !important;
+    box-sizing: border-box !important;
+    display: inline-flex !important;
+    align-items: center;
+  }
+
+  .ant-segmented-group,
+  .pisell-lowcode-segmented-group {
+    flex: 1;
+    min-height: 0;
+    align-self: stretch;
+    display: flex;
+    align-items: center;
+  }
+
+  .ant-segmented-item,
+  .pisell-lowcode-segmented-item {
+    display: flex !important;
+    align-items: center !important;
+    justify-content: center !important;
+    flex: 1;
+    font-size: 16px !important;
+    font-weight: 500 !important;
+    padding: 0 16px !important;
+    box-sizing: border-box !important;
+  }
+
+  /** 文案垂直居中：去掉固定 line-height，避免在 antd 选项格内视觉上偏上 */
+
+  .ant-segmented-item-label,
+  .pisell-lowcode-segmented-item-label {
+    display: inline-flex !important;
+    align-items: center !important;
+    justify-content: center !important;
+    line-height: normal !important;
+  }
+}
+
 /** 左侧：div + flex 布局，下单时间快筛 + Find（占满剩余宽度）+ slots.topLeft */
 .record-board-toolbar-top-left {
   display: flex;

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

@@ -6,7 +6,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 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 React, { useCallback, useMemo } from 'react';
-import { Button, Space } from 'antd';
+import { Button, Space, Segmented } from 'antd';
 import SwitchVertical01 from '@pisell/icon/es/SwitchVertical01';
 import PisellToolBar from "../../../pisellGridPro/ToolBar";
 import { PisellFind } from "../../../pisellFind";
@@ -15,6 +15,7 @@ import Sort from "../../../sort";
 import ToolBarReset from "../ToolBarReset";
 import ToolBarQuickFilter from "../ToolBarQuickFilter";
 import RecordBoardColumnSetting from "../ColumnSetting";
+import { useRecordBoardShellBodyMeta } from "../ShellBodyMetaContext";
 import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
 import { locales as utilsLocales } from '@pisell/utils';
 import { getText } from "../../../../locales";
@@ -31,6 +32,16 @@ function getFilterButtonText() {
   var u = utilsLocales.getText(key);
   return u && u !== key ? u : getText(key) || getText('table-action-filter-button');
 }
+function getViewGridLabel() {
+  var key = 'pisell2.recordBoard.toolbar.viewGrid';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || 'Table';
+}
+function getViewFloorMapLabel() {
+  var key = 'pisell2.recordBoard.toolbar.viewFloorMap';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || 'Floor map';
+}
 import { deriveFilterFromColumns, deriveSortFromColumns } from "../../utils/recordBoardColumns";
 
 /** 默认搜索参数字段名，与 context.searchParams 对应 */
@@ -50,18 +61,26 @@ function getDefaultFilterValue() {
   };
 }
 
-/**
- * RecordBoard 下的工具栏：使用 PisellToolBar。
- * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
- * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
+/**
+ * RecordBoard 下的工具栏：使用 PisellToolBar。
+ * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
+ * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
  */
 var RecordBoardToolBar = function RecordBoardToolBar(props) {
-  var _ctx$childComponentPr, _ctx$childComponentPr2, _searchParams$DEFAULT, _ctx$childComponentPr3, _formFiltersPrefix, _size, _filterResetKey;
+  var _shellMeta$hasGridCon, _shellMeta$hasFloorMa, _shellMeta$effectiveF, _ctx$childComponentPr, _ctx$childComponentPr2, _searchParams$DEFAULT, _ctx$childComponentPr3, _formFiltersPrefix, _size, _filterResetKey;
   var ctx = useRecordBoardContext({
     displayName: 'toolBar'
   });
+  var shellMeta = useRecordBoardShellBodyMeta();
   var searchParams = ctx.searchParams,
-    onSearch = ctx.onSearch;
+    onSearch = ctx.onSearch,
+    bodyView = ctx.bodyView,
+    setBodyView = ctx.setBodyView;
+  /** ShellFrame 内解析：双视图（表格区 + FloorMap）才出现切换器；根级 floorMap 无子组件时仍兼容 */
+  var hasGridInShell = (_shellMeta$hasGridCon = shellMeta === null || shellMeta === void 0 ? void 0 : shellMeta.hasGridContent) !== null && _shellMeta$hasGridCon !== void 0 ? _shellMeta$hasGridCon : true;
+  var hasFloorInShell = (_shellMeta$hasFloorMa = shellMeta === null || shellMeta === void 0 ? void 0 : shellMeta.hasFloorMapSlot) !== null && _shellMeta$hasFloorMa !== void 0 ? _shellMeta$hasFloorMa : ctx.floorMapProps != null;
+  var floorForToggle = (_shellMeta$effectiveF = shellMeta === null || shellMeta === void 0 ? void 0 : shellMeta.effectiveFloorMapProps) !== null && _shellMeta$effectiveF !== void 0 ? _shellMeta$effectiveF : ctx.floorMapProps;
+  var showTableFloorToggle = hasGridInShell && hasFloorInShell && floorForToggle != null;
   var slots = (_ctx$childComponentPr = (_ctx$childComponentPr2 = ctx.childComponentProps) === null || _ctx$childComponentPr2 === void 0 ? void 0 : _ctx$childComponentPr2.toolBar) !== null && _ctx$childComponentPr !== void 0 ? _ctx$childComponentPr : {};
   var keyword = (_searchParams$DEFAULT = searchParams === null || searchParams === void 0 ? void 0 : searchParams[DEFAULT_SEARCH_FIELD]) !== null && _searchParams$DEFAULT !== void 0 ? _searchParams$DEFAULT : '';
   var handleSearch = useCallback(function (value) {
@@ -95,17 +114,45 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     var _ref;
     if (quickFilterConfig === false) return [];
     var fromConfig = _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null && Array.isArray(quickFilterConfig.filterList) ? quickFilterConfig.filterList : null;
-    return (_ref = fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter) !== null && _ref !== void 0 ? _ref : [];
-  }, [quickFilterConfig, derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter]);
+    var list = (_ref = fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter) !== null && _ref !== void 0 ? _ref : [];
+    var hideNames = _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null && Array.isArray(quickFilterConfig.hideFilterNamesOnFloorMap) ? quickFilterConfig.hideFilterNamesOnFloorMap : null;
+    if (bodyView === 'floorMap' && showTableFloorToggle && hideNames != null && hideNames.length > 0) {
+      var hideSet = new Set(hideNames.map(String));
+      list = list.filter(function (item) {
+        var _item$name;
+        var n = (_item$name = item.name) !== null && _item$name !== void 0 ? _item$name : item.key;
+        return n == null || !hideSet.has(String(n));
+      });
+    }
+    return list;
+  }, [quickFilterConfig, derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter, bodyView, showTableFloorToggle]);
   var showQuickFilterLeft = quickFilterList.length > 0;
   var quickFilterNode = showQuickFilterLeft ? /*#__PURE__*/React.createElement(ToolBarQuickFilter, {
     filterList: quickFilterList,
     formFiltersPrefix: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_formFiltersPrefix = quickFilterConfig.formFiltersPrefix) !== null && _formFiltersPrefix !== void 0 ? _formFiltersPrefix : '' : '',
     size: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_size = quickFilterConfig.size) !== null && _size !== void 0 ? _size : 'large' : 'large'
   }) : null;
+  var bodyViewToggle = showTableFloorToggle ? /*#__PURE__*/React.createElement(Segmented, {
+    className: "record-board-toolbar-body-view-segmented",
+    size: "large",
+    value: bodyView,
+    onChange: function onChange(v) {
+      return setBodyView(v);
+    },
+    options: [{
+      label: getViewGridLabel(),
+      value: 'grid'
+    }, {
+      label: getViewFloorMapLabel(),
+      value: 'floorMap'
+    }],
+    style: {
+      marginRight: 8
+    }
+  }) : null;
   var topLeft = /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-top-left"
-  }, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
+  }, bodyViewToggle, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-find-wrap"
   }, searchNode) : null, slots.topLeft);
   var sortConfig = slots.sort;

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

@@ -23,9 +23,9 @@ function getResetButtonText() {
 var FILTER_PARAMS_FIELD = 'filter';
 /** 排序在 searchParams 中的字段名，与 ToolBar 一致 */
 var SORT_PARAMS_FIELD = 'sort';
-/**
- * RecordBoard 工具栏重置按钮：清空筛选与排序并刷新表格。
- * 点击后以空 filter.values、清空 sort 调用 onSearch，并调用 onReset（若提供）。
+/**
+ * RecordBoard 工具栏重置按钮：清空筛选与排序并刷新表格。
+ * 点击后以空 filter.values、清空 sort 调用 onSearch，并调用 onReset（若提供）。
  */
 var ToolBarReset = function ToolBarReset(_ref) {
   var _ref$size = _ref.size,

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

@@ -5,17 +5,11 @@ import RecordBoardPagination from './Pagination';
 import RecordBoardSearch from './Search';
 import ToolBarReset from './ToolBarReset';
 import ToolBarQuickFilter from './ToolBarQuickFilter';
+import RecordBoardFloorMap from './FloorMap';
 /**
  * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
- * 提供工具栏、多选操作条、分页；与 Layout 同级，包裹在 Layout 外层。
- * 默认占满父容器高度，内容区可滚动，分页器固定在底部。
- *
- * 使用方式：
- * <PisellRecordBoard>
- *   <PisellRecordBoard.ShellFrame>
- *     <PisellRecordBoard.GridLayout />
- *   </PisellRecordBoard.ShellFrame>
- * </PisellRecordBoard>
+ * 解析子节点：**GridLayout / CardLayout 等** 与可选 **\<PisellRecordBoard.FloorMap /\>**；
+ * 仅表格侧、仅平面图侧、或双视图（出现 Segmented 切换）由子节点组合决定。根级 `floorMap` props 仍支持（如低代码透传），与 FloorMap 子组件 props 合并，**子组件优先**。
  */
 declare const RecordBoardShellFrame: React.FC<{
     children?: React.ReactNode;
@@ -23,4 +17,4 @@ declare const RecordBoardShellFrame: React.FC<{
     style?: React.CSSProperties;
 }>;
 export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, };
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };

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

@@ -1,18 +1,23 @@
 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 _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); }
-import React, { useRef, useEffect } from 'react';
+import React, { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { PisellShellFrame } from "../../pisellShellFrame";
+import { PisellFloorMapLayout, FloorMapLayoutProvider, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT } from "../../pisellFloorMapLayout";
 import { useRecordBoardContext } from "../hooks/useRecordBoardContext";
+import { partitionShellFrameChildren } from "../utils/partitionShellFrameChildren";
 import RecordBoardToolBar from "./ToolBar";
 import RecordBoardBatchActionBar from "./BatchActionBar";
 import RecordBoardPagination from "./Pagination";
 import RecordBoardSearch from "./Search";
 import ToolBarReset from "./ToolBarReset";
 import ToolBarQuickFilter from "./ToolBarQuickFilter";
+import RecordBoardFloorMap from "./FloorMap";
+import { RecordBoardShellBodyMetaContext } from "./ShellBodyMetaContext";
 
 /** fillHeight 时内容区可滚动、分页器贴底；默认表头 sticky；grid.scroll.autoCalc 时需测量高度供 scroll.y */
 var FILL_HEIGHT_SCROLL_STYLE = {
@@ -58,31 +63,108 @@ var FILL_HEIGHT_WRAPPER_STYLE = {
 
 /**
  * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
- * 提供工具栏、多选操作条、分页；与 Layout 同级，包裹在 Layout 外层。
- * 默认占满父容器高度，内容区可滚动，分页器固定在底部。
- *
- * 使用方式：
- * <PisellRecordBoard>
- *   <PisellRecordBoard.ShellFrame>
- *     <PisellRecordBoard.GridLayout />
- *   </PisellRecordBoard.ShellFrame>
- * </PisellRecordBoard>
+ * 解析子节点：**GridLayout / CardLayout 等** 与可选 **\<PisellRecordBoard.FloorMap /\>**；
+ * 仅表格侧、仅平面图侧、或双视图（出现 Segmented 切换）由子节点组合决定。根级 `floorMap` props 仍支持（如低代码透传），与 FloorMap 子组件 props 合并，**子组件优先**。
  */
 var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
-  var _ctx$setScrollAreaHei, _ctx$childComponentPr;
+  var _ctx$floorMapLayoutRe, _effectiveFloorMapPro, _effectiveFloorMapPro2, _effectiveFloorMapPro3, _ctx$setScrollAreaHei, _ctx$childComponentPr;
   var children = _ref2.children,
     className = _ref2.className,
     style = _ref2.style;
-  var ctx = useRecordBoardContext({
-    displayName: 'RecordBoard.ShellFrame'
-  });
+  var ctx = useRecordBoardContext();
   var fillHeight = (ctx === null || ctx === void 0 ? void 0 : ctx.fillHeight) === true;
-  var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
+  var _useMemo = useMemo(function () {
+      return partitionShellFrameChildren(children);
+    }, [children]),
+    gridChildren = _useMemo.gridChildren,
+    floorMapPropsFromChild = _useMemo.floorMapPropsFromChild,
+    hasGridContent = _useMemo.hasGridContent,
+    hasFloorMapChild = _useMemo.hasFloorMapChild;
+
+  /** 子组件 FloorMap 与根级 context.floorMapProps 合并，子 props 覆盖根级 */
+  var effectiveFloorMapProps = useMemo(function () {
+    if (hasFloorMapChild) {
+      var _ctx$floorMapProps;
+      return _objectSpread(_objectSpread({}, (_ctx$floorMapProps = ctx.floorMapProps) !== null && _ctx$floorMapProps !== void 0 ? _ctx$floorMapProps : {}), floorMapPropsFromChild !== null && floorMapPropsFromChild !== void 0 ? floorMapPropsFromChild : {});
+    }
+    return ctx.floorMapProps;
+  }, [hasFloorMapChild, floorMapPropsFromChild, ctx.floorMapProps]);
+
+  /**
+   * 平面图使用整份多 key：根级 Context.dataSources 与 FloorMap props 合并（后者覆盖同 key）。
+   * 表格分页切片只影响 ctx.data，不得缩短此对象。
+   */
+  var mergedFloorMapDataSources = useMemo(function () {
+    var root = ctx.dataSources;
+    var fromFloor = effectiveFloorMapProps === null || effectiveFloorMapProps === void 0 ? void 0 : effectiveFloorMapProps.dataSources;
+    if (root == null && fromFloor == null) return undefined;
+    return _objectSpread(_objectSpread({}, root !== null && root !== void 0 ? root : {}), fromFloor !== null && fromFloor !== void 0 ? fromFloor : {});
+  }, [ctx.dataSources, effectiveFloorMapProps === null || effectiveFloorMapProps === void 0 ? void 0 : effectiveFloorMapProps.dataSources]);
+  var hasFloorMapSlot = hasFloorMapChild || ctx.floorMapProps != null;
+  var shellBodyMeta = useMemo(function () {
+    return {
+      effectiveFloorMapProps: effectiveFloorMapProps,
+      hasGridContent: hasGridContent,
+      hasFloorMapSlot: hasFloorMapSlot
+    };
+  }, [effectiveFloorMapProps, hasGridContent, hasFloorMapSlot]);
+
+  /**
+   * 仅平面图：强制 floorMap 视图；仅表格：强制 grid；双视图：尊重 ctx.bodyView。
+   */
+  var showGrid = useMemo(function () {
+    if (!hasFloorMapSlot) return true;
+    if (!hasGridContent) return false;
+    return ctx.bodyView === 'grid';
+  }, [hasFloorMapSlot, hasGridContent, ctx.bodyView]);
+
+  /** 仅平面图 / 仅表格时同步 bodyView，避免切换组合后状态不一致 */
+  useLayoutEffect(function () {
+    if (!ctx.setBodyView) return;
+    if (hasFloorMapSlot && !hasGridContent) {
+      ctx.setBodyView('floorMap');
+      return;
+    }
+    if (hasGridContent && !hasFloorMapSlot) {
+      ctx.setBodyView('grid');
+    }
+  }, [hasFloorMapSlot, hasGridContent, ctx.setBodyView]);
+  var floorMapLayoutProviderValue = useMemo(function () {
+    var _ctx$floorMapLayoutCo;
+    return (_ctx$floorMapLayoutCo = ctx.floorMapLayoutContext) !== null && _ctx$floorMapLayoutCo !== void 0 ? _ctx$floorMapLayoutCo : EMPTY_FLOOR_MAP_LAYOUT_CONTEXT;
+  }, [ctx.floorMapLayoutContext]);
+  var floorMapNode = effectiveFloorMapProps && !showGrid ? /*#__PURE__*/React.createElement("div", {
+    style: {
+      flex: 1,
+      minHeight: 0,
+      display: 'flex',
+      flexDirection: 'column',
+      overflow: 'hidden'
+    }
+  }, /*#__PURE__*/React.createElement(FloorMapLayoutProvider, {
+    value: floorMapLayoutProviderValue
+  }, /*#__PURE__*/React.createElement(PisellFloorMapLayout, _extends({
+    ref: (_ctx$floorMapLayoutRe = ctx.floorMapLayoutRef) !== null && _ctx$floorMapLayoutRe !== void 0 ? _ctx$floorMapLayoutRe : undefined
+  }, effectiveFloorMapProps, mergedFloorMapDataSources !== undefined ? {
+    dataSources: mergedFloorMapDataSources
+  } : {}, {
+    items: (_effectiveFloorMapPro = effectiveFloorMapProps.items) !== null && _effectiveFloorMapPro !== void 0 ? _effectiveFloorMapPro : [],
+    renderItem: (_effectiveFloorMapPro2 = effectiveFloorMapProps.renderItem) !== null && _effectiveFloorMapPro2 !== void 0 ? _effectiveFloorMapPro2 : function () {
+      return null;
+    },
+    style: _objectSpread({
+      flex: 1,
+      minHeight: 0
+    }, (_effectiveFloorMapPro3 = effectiveFloorMapProps.style) !== null && _effectiveFloorMapPro3 !== void 0 ? _effectiveFloorMapPro3 : {})
+  })))) : null;
+  var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, showGrid ? /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
     onHeight: (_ctx$setScrollAreaHei = ctx === null || ctx === void 0 ? void 0 : ctx.setScrollAreaHeight) !== null && _ctx$setScrollAreaHei !== void 0 ? _ctx$setScrollAreaHei : function () {},
     autoCalc: ctx === null || ctx === void 0 || (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.grid) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.scroll) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.autoCalc
-  }, children), /*#__PURE__*/React.createElement(RecordBoardPagination, null)) : /*#__PURE__*/React.createElement(React.Fragment, null, children, /*#__PURE__*/React.createElement(RecordBoardPagination, null));
+  }, gridChildren) : floorMapNode, showGrid ? /*#__PURE__*/React.createElement(RecordBoardPagination, null) : null) : /*#__PURE__*/React.createElement(React.Fragment, null, showGrid ? gridChildren : floorMapNode, showGrid ? /*#__PURE__*/React.createElement(RecordBoardPagination, null) : null);
   var shellStyle = fillHeight && style ? _objectSpread(_objectSpread({}, style), FILL_HEIGHT_WRAPPER_STYLE) : fillHeight ? FILL_HEIGHT_WRAPPER_STYLE : style;
-  var wrapper = /*#__PURE__*/React.createElement(PisellShellFrame, {
+  var wrapper = /*#__PURE__*/React.createElement(RecordBoardShellBodyMetaContext.Provider, {
+    value: shellBodyMeta
+  }, /*#__PURE__*/React.createElement(PisellShellFrame, {
     className: className,
     style: shellStyle,
     config: {
@@ -91,7 +173,7 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
     },
     toolbar: /*#__PURE__*/React.createElement(RecordBoardToolBar, null),
     batchActionBar: /*#__PURE__*/React.createElement(RecordBoardBatchActionBar, null)
-  }, bodyContent);
+  }, bodyContent));
   if (fillHeight) {
     return /*#__PURE__*/React.createElement("div", {
       style: FILL_HEIGHT_WRAPPER_STYLE
@@ -101,4 +183,4 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
 };
 RecordBoardShellFrame.displayName = 'RecordBoard.ShellFrame';
 export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter };
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };

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

@@ -1,4 +1,5 @@
-import type { ReactNode, Key, ComponentType } from 'react';
+import type { ReactNode, Key, ComponentType, Ref } from 'react';
+import type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapDataSources, FloorMapLayoutContextValue } from '../pisellFloorMapLayout/types';
 import type { TableProps } from 'antd';
 /**
  * 布局类型：一种 layout 对应一种「视图的集合」
@@ -120,11 +121,26 @@ export interface RecordBoardListResult {
     count?: number;
     total?: number;
 }
+/** ShellFrame 内容区：表格或平面图（与 GridLayout 同级切换） */
+export declare type RecordBoardBodyView = 'grid' | 'floorMap';
+/**
+ * 平面图槽位 props：与 PisellFloorMapLayout 对齐；items/renderItem 可省略（由 RecordBoard 默认 [] / () => null）。
+ */
+export declare type RecordBoardFloorMapProps = Partial<PisellFloorMapLayoutProps>;
 /**
  * RecordBoard 容器 Context 值
  * 与具体 layout 类型无关，所有 layout 共用同一套数据与操作
  */
 export interface RecordBoardContextValue {
+    /**
+     * 平面图多数据源字典（整份各 key，不参与表格分页切片）。
+     * ShellFrame 会与 FloorMap 子 props 中的 dataSources 合并后传入 PisellFloorMapLayout。
+     */
+    dataSources?: FloorMapDataSources;
+    /**
+     * 表格绑定 `dataSources` 的 key；仅当未传入根级 `data` 时，表格数据由 `dataSources[gridDataSourceKey]` 推导并做客户端分页切片。
+     */
+    gridDataSourceKey?: string;
     /** 当前列表数据 */
     data: any[];
     /** 加载态 */
@@ -174,6 +190,20 @@ export interface RecordBoardContextValue {
     filterResetKey?: number;
     /** 递增 filterResetKey，由 ToolBarReset 在重置时调用 */
     setFilterResetKey?: (fn: (prev: number) => number) => void;
+    /** 当前主内容区：表格或平面图；无平面图配置时一般为 grid（ShellFrame 内仅 FloorMap 时会改为 floorMap） */
+    bodyView: RecordBoardBodyView;
+    setBodyView: (v: RecordBoardBodyView) => void;
+    /** 根级传入的平面图 props（可选）；与 ShellFrame 内 FloorMap 子组件合并，子优先 */
+    floorMapProps?: RecordBoardFloorMapProps;
+    /**
+     * 平面图数据/保存等注入上下文（与 `FloorMapLayoutContextValue` 同形），由 Shell 内置 `FloorMapLayoutProvider` 注入 `PisellFloorMapLayout`；
+     * 与 `useRecordBoardContext()` 同源镜像，供 Toolbar 等读取。
+     */
+    floorMapLayoutContext?: FloorMapLayoutContextValue;
+    /** 双视图并存时首屏偏好（根 props，与 PisellRecordBoard.defaultBodyView 一致） */
+    defaultBodyView?: RecordBoardBodyView;
+    /** 挂到 ShellFrame 内 PisellFloorMapLayout，供外部 imperative 调用（如 saveLayout / fitBounds） */
+    floorMapLayoutRef?: Ref<PisellFloorMapLayoutRef | null>;
 }
 /**
  * 各 layout 下子组件的可选透传配置（类似 ChildComponentProps）
@@ -209,6 +239,7 @@ export interface RecordBoardToolBarProps {
      * 在 ToolBar 左侧展示内联快速筛选（替代 Filter 弹层内的 quickFilter）。
      * 为 true 时使用 columns 派生的 quickFilter 列表；为对象时可传 filterList、formFiltersPrefix、size 等。
      * 启用后建议对 filter 传 hiddenQuickFilter: true，弹层内仅保留高级筛选。
+     * hideFilterNamesOnFloorMap：仅当 Shell 内同时有表格+平面图且当前为平面图时，按筛选项 name（或 key）从内联快筛中移除，避免与顶栏日程重复（如预约 booking_time_start_between）。
      */
     quickFilter?: boolean | Record<string, any>;
     /** 列显示隐藏设置入口；默认 true（有 grid.columns 时显示）；false 时不渲染 */
@@ -280,9 +311,19 @@ export interface RecordBoardProps {
     rowKey?: string | ((record: any) => Key);
     /** 当前列表数据 */
     data?: any[];
+    /**
+     * 平面图多数据源；与 `FloorMap` / 根级 `floorMap` 的 dataSources 在 ShellFrame 内合并（后者覆盖同 key）。
+     * 表格默认仍用 `data`；若不传 `data` 且提供 `gridDataSourceKey`，则由本字段对应 key 推导表格行并客户端分页。
+     */
+    dataSources?: FloorMapDataSources;
+    /**
+     * 表格使用的 `dataSources` key（如 `'tables'`）；与 `floorMapConfig` 内 `dataSourceKey` 对齐。
+     * 仅在根级 **`data` 未传入**时生效。
+     */
+    gridDataSourceKey?: string;
     /** 加载态 */
     loading?: boolean;
-    /** 总数（用于分页） */
+    /** 总数（用于分页）；由 `dataSources` 推导表格时，未传则默认为该 key 对应数组长度 */
     total?: number;
     /** 分页状态 */
     pagination?: RecordBoardPaginationState;
@@ -310,6 +351,25 @@ export interface RecordBoardProps {
     cardList?: Record<string, any>;
     /** 是否启用分页（与 pagination 状态区分） */
     enablePagination?: boolean;
+    /**
+     * 平面图（可选，兼容低代码 / SalesGrid 等）：与 PisellFloorMapLayout 对齐。
+     * 推荐在 ShellFrame 内使用 PisellRecordBoard.FloorMap 声明；若同时传根级与本项，Shell 内子组件 props 优先合并。
+     */
+    floorMap?: RecordBoardFloorMapProps;
+    /**
+     * 平面图 Context 注入（`FloorMapLayoutContextValue`）：配置/保存/加载等；展示向 props 仍建议走 `floorMap`。
+     * Shell 在平面图节点内置 Provider，无需再包一层 `FloorMapLayoutProvider`。
+     */
+    floorMapLayoutContext?: FloorMapLayoutContextValue;
+    /**
+     * 表格与平面图并存时首屏子视图，默认 grid。
+     * 仅声明 FloorMap 而无 Grid/Card 内容时由 ShellFrame 固定为平面图，不出现切换器。
+     */
+    defaultBodyView?: RecordBoardBodyView;
+    /** 与 bodyView 同步持久化到 localStorage 的 key（双视图时生效） */
+    bodyViewStorageKey?: string;
+    /** 平面图 Layout 实例 ref，由 ShellFrame 注入 */
+    floorMapLayoutRef?: Ref<PisellFloorMapLayoutRef | null>;
     /** 其他 */
     [key: string]: any;
 }

package/es/components/pisellRecordBoard/utils/partitionShellFrameChildren.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { RecordBoardFloorMapProps } from '../types';
+/** 与 shellFrame/FloorMap 上定义的 displayName 一致，用于从 ShellFrame children 中识别平面图槽 */
+export declare const RECORD_BOARD_FLOOR_MAP_DISPLAY_NAME = "RecordBoard.FloorMap";
+/**
+ * 将 ShellFrame 的 children 拆成：供表格区渲染的子树 + 可选的 FloorMap 透传 props。
+ * 支持 Fragment 嵌套；多个 FloorMap 时以最后一个为准。
+ */
+export declare function partitionShellFrameChildren(children: React.ReactNode): {
+    gridChildren: React.ReactNode;
+    /** 是否出现 FloorMap 槽位节点（props 可为空，可与根级 floorMap 合并） */
+    hasFloorMapChild: boolean;
+    floorMapPropsFromChild?: RecordBoardFloorMapProps;
+    hasGridContent: boolean;
+};