@pisell/materials 6.11.17 → 6.11.19

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,6 @@ 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';
+export { useRecordBoardShellBodyMeta } from './shellFrame';

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;
@@ -20,4 +21,5 @@ PisellRecordBoard.CardList = RecordBoardCardList;
 PisellRecordBoard.BatchActionBar = RecordBoardBatchActionBar;
 PisellRecordBoard.useRecordBoardContext = useRecordBoardContext;
 export default PisellRecordBoard;
-export { useRecordBoardContext } from "./hooks/useRecordBoardContext";
+export { useRecordBoardContext } from "./hooks/useRecordBoardContext";
+export { useRecordBoardShellBodyMeta } from "./shellFrame";

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,64 @@
+/**
+ * 表格 / 平面图切换：与中间搜索、右侧 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;
+  }
+
+  /** 低代码：选中背景与 antd Button primary / 编辑平面图同源 */
+
+  .pisell-lowcode-segmented-item-selected {
+    background: var(--color-primary,
+    var(--ant-color-primary, #5d3f9f)) !important;
+    color: var(--ant-color-text-light-solid, #fff) !important;
+    font-weight: 600 !important;
+  }
+
+  .pisell-lowcode-segmented-thumb {
+    background: var(--color-primary,
+    var(--ant-color-primary, #5d3f9f)) !important;
+  }
+}
+
 /** 左侧：div + flex 布局，下单时间快筛 + Find（占满剩余宽度）+ slots.topLeft */
 .record-board-toolbar-top-left {
   display: flex;

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

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { RecordBoardToolBarProps as ToolBarPropsType } from '../../types';
 import './ToolBarFilter.less';
+import './recordBoardToolbar.less';
 /**
  * RecordBoard 下的工具栏：使用 PisellToolBar。
  * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。

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

@@ -6,7 +6,8 @@ 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 classNames from 'classnames';
+import { Button, Space, Segmented } from 'antd';
 import SwitchVertical01 from '@pisell/icon/es/SwitchVertical01';
 import PisellToolBar from "../../../pisellGridPro/ToolBar";
 import { PisellFind } from "../../../pisellFind";
@@ -15,10 +16,12 @@ 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";
 import "./ToolBarFilter.less";
+import "./recordBoardToolbar.less";
 
 /** 与 Quick Filter 同源：优先 utils，若 utils 返回 key（未命中）则用 materials 再回退 */
 function getSortButtonText() {
@@ -31,6 +34,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 对应 */
@@ -56,12 +69,20 @@ function getDefaultFilterValue() {
  * 可透传 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 +116,54 @@ 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 topLeft = /*#__PURE__*/React.createElement("div", {
+  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;
+
+  /** 平面图模式：第二行工具（搜索/筛选等）收起；切换器在业务方 tabs 内（如预约 ScheduleBand） */
+  var compactFloorMapToolbar = bodyView === 'floorMap' && showTableFloorToggle;
+
+  /**
+   * 仅平面图且 tabs 内含 ScheduleBand 时隐藏顶行切换器；表格视图 tabs 无 ScheduleBand，
+   * 切换器回到 Find 左侧（与 PisellReservation 表格态一致）。
+   */
+  var hideBodyViewToggleInToolbarRow = showTableFloorToggle && Boolean(slots.tabs) && bodyView === 'floorMap';
+  var topLeft = compactFloorMapToolbar ? null : /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-top-left"
-  }, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
+  }, !hideBodyViewToggleInToolbarRow ? bodyViewToggle : null, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-find-wrap"
   }, searchNode) : null, slots.topLeft);
   var sortConfig = slots.sort;
@@ -198,17 +256,17 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     placement: "bottomLeft"
   }, _typeof(filterConfig) === 'object' && filterConfig !== null ? filterConfig : {}));
   var showColumnSetting = slots.columnSetting !== false && Array.isArray(gridColumns) && gridColumns.length > 0;
-  var topRight = /*#__PURE__*/React.createElement(Space, null, showColumnSetting ? /*#__PURE__*/React.createElement(RecordBoardColumnSetting, null) : null, sortNode, filterNode, /*#__PURE__*/React.createElement(ToolBarReset, {
+  var topRight = compactFloorMapToolbar ? null : /*#__PURE__*/React.createElement(Space, null, showColumnSetting ? /*#__PURE__*/React.createElement(RecordBoardColumnSetting, null) : null, sortNode, filterNode, /*#__PURE__*/React.createElement(ToolBarReset, {
     size: "large"
   }), slots.topRight);
   return /*#__PURE__*/React.createElement(PisellToolBar, {
-    className: slots.className,
+    className: classNames(bodyView === 'floorMap' && 'pisell-record-board-toolbar--floor-map', bodyView === 'grid' && 'pisell-record-board-toolbar--grid', slots.className),
     style: slots.style,
     tabs: slots.tabs,
     topLeft: topLeft,
     topRight: topRight,
-    bottomLeft: slots.bottomLeft,
-    bottomRight: slots.bottomRight
+    bottomLeft: compactFloorMapToolbar ? null : slots.bottomLeft,
+    bottomRight: compactFloorMapToolbar ? null : slots.bottomRight
   });
 };
 RecordBoardToolBar.displayName = 'RecordBoard.ToolBar';

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

@@ -0,0 +1,23 @@
+/**
+ * 平面视图：工具栏常仅一行（ScheduleBand），去掉 GridPro 默认底内边距。
+ * 不用仅依赖 #body：Story/本地预览可能没有 id=body，低代码若再包一层 #body 会导致双前缀失效。
+ * !important：确保晚于 @pisellGridPro/ToolBar 中单类 .pisell-grid-pro-toolbar 的 padding-bottom。
+ */
+.pisell-grid-pro-toolbar.pisell-record-board-toolbar--floor-map {
+  padding-bottom: 0 !important;
+}
+
+#body .pisell-grid-pro-toolbar.pisell-record-board-toolbar--floor-map {
+  padding-bottom: 0 !important;
+}
+
+/* 表格态工具栏与内容对齐：左右留白 16；平面图态不加此内边距 */
+.pisell-grid-pro-toolbar.pisell-record-board-toolbar--grid {
+  padding-left: 16px;
+  padding-right: 16px;
+}
+
+#body .pisell-grid-pro-toolbar.pisell-record-board-toolbar--grid {
+  padding-left: 16px;
+  padding-right: 16px;
+}

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

@@ -3,19 +3,14 @@ import RecordBoardToolBar from './ToolBar';
 import RecordBoardBatchActionBar from './BatchActionBar';
 import RecordBoardPagination from './Pagination';
 import RecordBoardSearch from './Search';
+import './shellFrameFloorMap.less';
 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 +18,5 @@ 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 };
+export { useRecordBoardShellBodyMeta } from './ShellBodyMetaContext';

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

@@ -1,18 +1,25 @@
 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 classNames from 'classnames';
 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 "./shellFrameFloorMap.less";
 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,32 +65,115 @@ 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", {
+    className: "pisell-record-board-floor-map-viewport",
+    style: {
+      flex: 1,
+      minHeight: 0,
+      display: 'flex',
+      flexDirection: 'column',
+      overflow: 'hidden',
+      position: 'relative'
+    }
+  }, /*#__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 : {})
+  }))), ctx.floorMapFooter ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-record-board-floor-map-floating-slot"
+  }, ctx.floorMapFooter) : null) : 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, {
-    className: className,
+  var wrapper = /*#__PURE__*/React.createElement(RecordBoardShellBodyMetaContext.Provider, {
+    value: shellBodyMeta
+  }, /*#__PURE__*/React.createElement(PisellShellFrame, {
+    className: classNames(className, {
+      'pisell-shell-frame--floor-map-view': !showGrid
+    }),
     style: shellStyle,
     config: {
       showToolbar: true,
@@ -91,7 +181,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 +191,5 @@ 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 };
+export { useRecordBoardShellBodyMeta } from "./ShellBodyMetaContext";

package/es/components/pisellRecordBoard/shellFrame/shellFrameFloorMap.less

@@ -0,0 +1,25 @@
+/** 平面图区域：画布 + 悬浮层共用，便于底部按钮叠在画布上 */
+.pisell-record-board-floor-map-viewport {
+  box-sizing: border-box;
+}
+
+/**
+ * 画布内底部居中悬浮插槽（如「编辑平面图」）。
+ * 容器不接收指针事件，避免挡画布拖拽/缩放；子节点恢复可点。
+ */
+.pisell-record-board-floor-map-floating-slot {
+  position: absolute;
+  left: 0;
+  right: 0;
+  bottom: 20px;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  pointer-events: none;
+  /* 高于 PisellFloorMapLayout 内 ViewControls(20)，避免与左下角控件叠次序模糊 */
+  z-index: 25;
+
+  > * {
+    pointer-events: auto;
+  }
+}