@pisell/materials 6.11.17 → 6.11.18

package/lib/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/lib/components/pisellRecordBoard/index.js

@@ -30,7 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var pisellRecordBoard_exports = {};
 __export(pisellRecordBoard_exports, {
   default: () => pisellRecordBoard_default,
-  useRecordBoardContext: () => import_useRecordBoardContext2.useRecordBoardContext
+  useRecordBoardContext: () => import_useRecordBoardContext2.useRecordBoardContext,
+  useRecordBoardShellBodyMeta: () => import_shellFrame2.useRecordBoardShellBodyMeta
 });
 module.exports = __toCommonJS(pisellRecordBoard_exports);
 var import_PisellRecordBoard = __toESM(require("./PisellRecordBoard"));
@@ -41,10 +42,12 @@ var import_Grid = __toESM(require("./layouts/GridLayout/Grid"));
 var import_CardList = __toESM(require("./layouts/CardLayout/CardList"));
 var import_useRecordBoardContext = require("./hooks/useRecordBoardContext");
 var import_useRecordBoardContext2 = require("./hooks/useRecordBoardContext");
+var import_shellFrame2 = require("./shellFrame");
 var PisellRecordBoard = import_PisellRecordBoard.default;
 PisellRecordBoard.ShellFrame = import_shellFrame.default;
 PisellRecordBoard.GridLayout = import_GridLayout.default;
 PisellRecordBoard.CardLayout = import_CardLayout.default;
+PisellRecordBoard.FloorMap = import_shellFrame.RecordBoardFloorMap;
 PisellRecordBoard.Search = import_shellFrame.RecordBoardSearch;
 PisellRecordBoard.ToolBar = import_shellFrame.RecordBoardToolBar;
 PisellRecordBoard.Pagination = import_shellFrame.RecordBoardPagination;
@@ -55,5 +58,6 @@ PisellRecordBoard.useRecordBoardContext = import_useRecordBoardContext.useRecord
 var pisellRecordBoard_default = PisellRecordBoard;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  useRecordBoardContext
+  useRecordBoardContext,
+  useRecordBoardShellBodyMeta
 });

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

@@ -41,7 +41,7 @@ var import_ColumnSettingPopover = __toESM(require("./ColumnSettingPopover"));
 var import_index = require("./index.less");
 var RecordBoardColumnSetting = () => {
   var _a, _b;
-  const ctx = (0, import_useRecordBoardContext.useRecordBoardContext)({ displayName: "columnSetting" });
+  const ctx = (0, import_useRecordBoardContext.useRecordBoardContext)();
   const gridColumns = (_b = (_a = ctx.childComponentProps) == null ? void 0 : _a.grid) == null ? void 0 : _b.columns;
   const columnVisibility = ctx.columnVisibility ?? {};
   const onColumnVisibilityChange = ctx.onColumnVisibilityChange;
@@ -61,7 +61,13 @@ var RecordBoardColumnSetting = () => {
         onColumnOrderChange
       }
     );
-  }, [gridColumns, columnVisibility, onColumnVisibilityChange, columnOrder, onColumnOrderChange]);
+  }, [
+    gridColumns,
+    columnVisibility,
+    onColumnVisibilityChange,
+    columnOrder,
+    onColumnOrderChange
+  ]);
   const hasHiddenColumns = (0, import_react.useMemo)(() => {
     if (!Array.isArray(gridColumns)) return false;
     return gridColumns.some(

package/lib/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/lib/components/pisellRecordBoard/shellFrame/FloorMap.js

@@ -0,0 +1,27 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellRecordBoard/shellFrame/FloorMap.tsx
+var FloorMap_exports = {};
+__export(FloorMap_exports, {
+  default: () => FloorMap_default
+});
+module.exports = __toCommonJS(FloorMap_exports);
+var RecordBoardFloorMap = () => null;
+RecordBoardFloorMap.displayName = "RecordBoard.FloorMap";
+var FloorMap_default = RecordBoardFloorMap;

package/lib/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/lib/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.js

@@ -0,0 +1,45 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellRecordBoard/shellFrame/ShellBodyMetaContext.tsx
+var ShellBodyMetaContext_exports = {};
+__export(ShellBodyMetaContext_exports, {
+  RecordBoardShellBodyMetaContext: () => RecordBoardShellBodyMetaContext,
+  useRecordBoardShellBodyMeta: () => useRecordBoardShellBodyMeta
+});
+module.exports = __toCommonJS(ShellBodyMetaContext_exports);
+var import_react = __toESM(require("react"));
+var RecordBoardShellBodyMetaContext = import_react.default.createContext(void 0);
+function useRecordBoardShellBodyMeta() {
+  return import_react.default.useContext(RecordBoardShellBodyMetaContext);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RecordBoardShellBodyMetaContext,
+  useRecordBoardShellBodyMeta
+});

package/lib/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/lib/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/lib/components/pisellRecordBoard/shellFrame/ToolBar/index.js

@@ -33,6 +33,7 @@ __export(ToolBar_exports, {
 });
 module.exports = __toCommonJS(ToolBar_exports);
 var import_react = __toESM(require("react"));
+var import_classnames = __toESM(require("classnames"));
 var import_antd = require("antd");
 var import_SwitchVertical01 = __toESM(require("@pisell/icon/es/SwitchVertical01"));
 var import_ToolBar = __toESM(require("../../../pisellGridPro/ToolBar"));
@@ -42,16 +43,28 @@ var import_sort = __toESM(require("../../../sort"));
 var import_ToolBarReset = __toESM(require("../ToolBarReset"));
 var import_ToolBarQuickFilter = __toESM(require("../ToolBarQuickFilter"));
 var import_ColumnSetting = __toESM(require("../ColumnSetting"));
+var import_ShellBodyMetaContext = require("../ShellBodyMetaContext");
 var import_useRecordBoardContext = require("../../hooks/useRecordBoardContext");
 var import_utils = require("@pisell/utils");
 var import_locales = require("../../../../locales");
 var import_ToolBarFilter = require("./ToolBarFilter.less");
+var import_recordBoardToolbar = require("./recordBoardToolbar.less");
 var import_recordBoardColumns = require("../../utils/recordBoardColumns");
 function getSortButtonText() {
   const key = "pisell2.recordBoard.toolbar.sort";
   const u = import_utils.locales.getText(key);
   return u && u !== key ? u : (0, import_locales.getText)(key) || (0, import_locales.getText)("sort-button-text");
 }
+function getViewGridLabel() {
+  const key = "pisell2.recordBoard.toolbar.viewGrid";
+  const u = import_utils.locales.getText(key);
+  return u && u !== key ? u : (0, import_locales.getText)(key) || "Table";
+}
+function getViewFloorMapLabel() {
+  const key = "pisell2.recordBoard.toolbar.viewFloorMap";
+  const u = import_utils.locales.getText(key);
+  return u && u !== key ? u : (0, import_locales.getText)(key) || "Floor map";
+}
 var DEFAULT_SEARCH_FIELD = "keyword";
 var FILTER_PARAMS_FIELD = "filter";
 var SORT_PARAMS_FIELD = "sort";
@@ -64,7 +77,12 @@ function getDefaultFilterValue() {
 var RecordBoardToolBar = (props) => {
   var _a, _b, _c;
   const ctx = (0, import_useRecordBoardContext.useRecordBoardContext)({ displayName: "toolBar" });
-  const { searchParams, onSearch } = ctx;
+  const shellMeta = (0, import_ShellBodyMetaContext.useRecordBoardShellBodyMeta)();
+  const { searchParams, onSearch, bodyView, setBodyView } = ctx;
+  const hasGridInShell = (shellMeta == null ? void 0 : shellMeta.hasGridContent) ?? true;
+  const hasFloorInShell = (shellMeta == null ? void 0 : shellMeta.hasFloorMapSlot) ?? ctx.floorMapProps != null;
+  const floorForToggle = (shellMeta == null ? void 0 : shellMeta.effectiveFloorMapProps) ?? ctx.floorMapProps;
+  const showTableFloorToggle = hasGridInShell && hasFloorInShell && floorForToggle != null;
   const slots = ((_a = ctx.childComponentProps) == null ? void 0 : _a.toolBar) ?? {};
   const keyword = (searchParams == null ? void 0 : searchParams[DEFAULT_SEARCH_FIELD]) ?? "";
   const handleSearch = (0, import_react.useCallback)(
@@ -100,8 +118,22 @@ var RecordBoardToolBar = (props) => {
   const quickFilterList = (0, import_react.useMemo)(() => {
     if (quickFilterConfig === false) return [];
     const fromConfig = typeof quickFilterConfig === "object" && quickFilterConfig !== null && Array.isArray(quickFilterConfig.filterList) ? quickFilterConfig.filterList : null;
-    return fromConfig ?? (derivedFilterFromColumns == null ? void 0 : derivedFilterFromColumns.quickFilter) ?? [];
-  }, [quickFilterConfig, derivedFilterFromColumns == null ? void 0 : derivedFilterFromColumns.quickFilter]);
+    let list = fromConfig ?? (derivedFilterFromColumns == null ? void 0 : derivedFilterFromColumns.quickFilter) ?? [];
+    const hideNames = typeof quickFilterConfig === "object" && quickFilterConfig !== null && Array.isArray(quickFilterConfig.hideFilterNamesOnFloorMap) ? quickFilterConfig.hideFilterNamesOnFloorMap : null;
+    if (bodyView === "floorMap" && showTableFloorToggle && hideNames != null && hideNames.length > 0) {
+      const hideSet = new Set(hideNames.map(String));
+      list = list.filter((item) => {
+        const n = item.name ?? item.key;
+        return n == null || !hideSet.has(String(n));
+      });
+    }
+    return list;
+  }, [
+    quickFilterConfig,
+    derivedFilterFromColumns == null ? void 0 : derivedFilterFromColumns.quickFilter,
+    bodyView,
+    showTableFloorToggle
+  ]);
   const showQuickFilterLeft = quickFilterList.length > 0;
   const quickFilterNode = showQuickFilterLeft ? /* @__PURE__ */ import_react.default.createElement(
     import_ToolBarQuickFilter.default,
@@ -111,7 +143,23 @@ var RecordBoardToolBar = (props) => {
       size: typeof quickFilterConfig === "object" && quickFilterConfig !== null ? quickFilterConfig.size ?? "large" : "large"
     }
   ) : null;
-  const topLeft = /* @__PURE__ */ import_react.default.createElement("div", { className: "record-board-toolbar-top-left" }, quickFilterNode, searchNode ? /* @__PURE__ */ import_react.default.createElement("div", { className: "record-board-toolbar-find-wrap" }, searchNode) : null, slots.topLeft);
+  const bodyViewToggle = showTableFloorToggle ? /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Segmented,
+    {
+      className: "record-board-toolbar-body-view-segmented",
+      size: "large",
+      value: bodyView,
+      onChange: (v) => setBodyView(v),
+      options: [
+        { label: getViewGridLabel(), value: "grid" },
+        { label: getViewFloorMapLabel(), value: "floorMap" }
+      ],
+      style: { marginRight: 8 }
+    }
+  ) : null;
+  const compactFloorMapToolbar = bodyView === "floorMap" && showTableFloorToggle;
+  const hideBodyViewToggleInToolbarRow = showTableFloorToggle && Boolean(slots.tabs) && bodyView === "floorMap";
+  const topLeft = compactFloorMapToolbar ? null : /* @__PURE__ */ import_react.default.createElement("div", { className: "record-board-toolbar-top-left" }, !hideBodyViewToggleInToolbarRow ? bodyViewToggle : null, quickFilterNode, searchNode ? /* @__PURE__ */ import_react.default.createElement("div", { className: "record-board-toolbar-find-wrap" }, searchNode) : null, slots.topLeft);
   const sortConfig = slots.sort;
   const hideSort = sortConfig === false;
   const sortValue = searchParams == null ? void 0 : searchParams[SORT_PARAMS_FIELD];
@@ -229,17 +277,21 @@ var RecordBoardToolBar = (props) => {
     }
   );
   const showColumnSetting = slots.columnSetting !== false && Array.isArray(gridColumns) && gridColumns.length > 0;
-  const topRight = /* @__PURE__ */ import_react.default.createElement(import_antd.Space, null, showColumnSetting ? /* @__PURE__ */ import_react.default.createElement(import_ColumnSetting.default, null) : null, sortNode, filterNode, /* @__PURE__ */ import_react.default.createElement(import_ToolBarReset.default, { size: "large" }), slots.topRight);
+  const topRight = compactFloorMapToolbar ? null : /* @__PURE__ */ import_react.default.createElement(import_antd.Space, null, showColumnSetting ? /* @__PURE__ */ import_react.default.createElement(import_ColumnSetting.default, null) : null, sortNode, filterNode, /* @__PURE__ */ import_react.default.createElement(import_ToolBarReset.default, { size: "large" }), slots.topRight);
   return /* @__PURE__ */ import_react.default.createElement(
     import_ToolBar.default,
     {
-      className: slots.className,
+      className: (0, import_classnames.default)(
+        bodyView === "floorMap" && "pisell-record-board-toolbar--floor-map",
+        bodyView === "grid" && "pisell-record-board-toolbar--grid",
+        slots.className
+      ),
       style: slots.style,
       tabs: slots.tabs,
       topLeft,
       topRight,
-      bottomLeft: slots.bottomLeft,
-      bottomRight: slots.bottomRight
+      bottomLeft: compactFloorMapToolbar ? null : slots.bottomLeft,
+      bottomRight: compactFloorMapToolbar ? null : slots.bottomRight
     }
   );
 };

package/lib/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/lib/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/lib/components/pisellRecordBoard/shellFrame/index.js

@@ -30,23 +30,32 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var shellFrame_exports = {};
 __export(shellFrame_exports, {
   RecordBoardBatchActionBar: () => import_BatchActionBar.default,
+  RecordBoardFloorMap: () => import_FloorMap.default,
   RecordBoardPagination: () => import_Pagination.default,
   RecordBoardSearch: () => import_Search.default,
   RecordBoardToolBar: () => import_ToolBar.default,
   ToolBarQuickFilter: () => import_ToolBarQuickFilter.default,
   ToolBarReset: () => import_ToolBarReset.default,
-  default: () => shellFrame_default
+  default: () => shellFrame_default,
+  useRecordBoardShellBodyMeta: () => import_ShellBodyMetaContext2.useRecordBoardShellBodyMeta
 });
 module.exports = __toCommonJS(shellFrame_exports);
 var import_react = __toESM(require("react"));
+var import_classnames = __toESM(require("classnames"));
 var import_pisellShellFrame = require("../../pisellShellFrame");
+var import_pisellFloorMapLayout = require("../../pisellFloorMapLayout");
 var import_useRecordBoardContext = require("../hooks/useRecordBoardContext");
+var import_partitionShellFrameChildren = require("../utils/partitionShellFrameChildren");
 var import_ToolBar = __toESM(require("./ToolBar"));
 var import_BatchActionBar = __toESM(require("./BatchActionBar"));
 var import_Pagination = __toESM(require("./Pagination"));
 var import_Search = __toESM(require("./Search"));
+var import_shellFrameFloorMap = require("./shellFrameFloorMap.less");
 var import_ToolBarReset = __toESM(require("./ToolBarReset"));
 var import_ToolBarQuickFilter = __toESM(require("./ToolBarQuickFilter"));
+var import_FloorMap = __toESM(require("./FloorMap"));
+var import_ShellBodyMetaContext = require("./ShellBodyMetaContext");
+var import_ShellBodyMetaContext2 = require("./ShellBodyMetaContext");
 var FILL_HEIGHT_SCROLL_STYLE = {
   flex: 1,
   minHeight: 0,
@@ -93,22 +102,103 @@ var FILL_HEIGHT_WRAPPER_STYLE = {
 };
 var RecordBoardShellFrame = ({ children, className, style }) => {
   var _a, _b, _c;
-  const ctx = (0, import_useRecordBoardContext.useRecordBoardContext)({ displayName: "RecordBoard.ShellFrame" });
+  const ctx = (0, import_useRecordBoardContext.useRecordBoardContext)();
   const fillHeight = (ctx == null ? void 0 : ctx.fillHeight) === true;
-  const bodyContent = fillHeight ? /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, /* @__PURE__ */ import_react.default.createElement(
+  const {
+    gridChildren,
+    floorMapPropsFromChild,
+    hasGridContent,
+    hasFloorMapChild
+  } = (0, import_react.useMemo)(() => (0, import_partitionShellFrameChildren.partitionShellFrameChildren)(children), [children]);
+  const effectiveFloorMapProps = (0, import_react.useMemo)(() => {
+    if (hasFloorMapChild) {
+      return {
+        ...ctx.floorMapProps ?? {},
+        ...floorMapPropsFromChild ?? {}
+      };
+    }
+    return ctx.floorMapProps;
+  }, [hasFloorMapChild, floorMapPropsFromChild, ctx.floorMapProps]);
+  const mergedFloorMapDataSources = (0, import_react.useMemo)(() => {
+    const root = ctx.dataSources;
+    const fromFloor = effectiveFloorMapProps == null ? void 0 : effectiveFloorMapProps.dataSources;
+    if (root == null && fromFloor == null) return void 0;
+    return { ...root ?? {}, ...fromFloor ?? {} };
+  }, [ctx.dataSources, effectiveFloorMapProps == null ? void 0 : effectiveFloorMapProps.dataSources]);
+  const hasFloorMapSlot = hasFloorMapChild || ctx.floorMapProps != null;
+  const shellBodyMeta = (0, import_react.useMemo)(
+    () => ({
+      effectiveFloorMapProps,
+      hasGridContent,
+      hasFloorMapSlot
+    }),
+    [effectiveFloorMapProps, hasGridContent, hasFloorMapSlot]
+  );
+  const showGrid = (0, import_react.useMemo)(() => {
+    if (!hasFloorMapSlot) return true;
+    if (!hasGridContent) return false;
+    return ctx.bodyView === "grid";
+  }, [hasFloorMapSlot, hasGridContent, ctx.bodyView]);
+  (0, import_react.useLayoutEffect)(() => {
+    if (!ctx.setBodyView) return;
+    if (hasFloorMapSlot && !hasGridContent) {
+      ctx.setBodyView("floorMap");
+      return;
+    }
+    if (hasGridContent && !hasFloorMapSlot) {
+      ctx.setBodyView("grid");
+    }
+  }, [hasFloorMapSlot, hasGridContent, ctx.setBodyView]);
+  const floorMapLayoutProviderValue = (0, import_react.useMemo)(
+    () => ctx.floorMapLayoutContext ?? import_pisellFloorMapLayout.EMPTY_FLOOR_MAP_LAYOUT_CONTEXT,
+    [ctx.floorMapLayoutContext]
+  );
+  const floorMapNode = effectiveFloorMapProps && !showGrid ? /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      className: "pisell-record-board-floor-map-viewport",
+      style: {
+        flex: 1,
+        minHeight: 0,
+        display: "flex",
+        flexDirection: "column",
+        overflow: "hidden",
+        position: "relative"
+      }
+    },
+    /* @__PURE__ */ import_react.default.createElement(import_pisellFloorMapLayout.FloorMapLayoutProvider, { value: floorMapLayoutProviderValue }, /* @__PURE__ */ import_react.default.createElement(
+      import_pisellFloorMapLayout.PisellFloorMapLayout,
+      {
+        ref: ctx.floorMapLayoutRef ?? void 0,
+        ...effectiveFloorMapProps,
+        ...mergedFloorMapDataSources !== void 0 ? { dataSources: mergedFloorMapDataSources } : {},
+        items: effectiveFloorMapProps.items ?? [],
+        renderItem: effectiveFloorMapProps.renderItem ?? (() => null),
+        style: {
+          flex: 1,
+          minHeight: 0,
+          ...effectiveFloorMapProps.style ?? {}
+        }
+      }
+    )),
+    ctx.floorMapFooter ? /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-record-board-floor-map-floating-slot" }, ctx.floorMapFooter) : null
+  ) : null;
+  const bodyContent = fillHeight ? /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, showGrid ? /* @__PURE__ */ import_react.default.createElement(
     ScrollAreaMeasurer,
     {
       onHeight: (ctx == null ? void 0 : ctx.setScrollAreaHeight) ?? (() => {
       }),
       autoCalc: (_c = (_b = (_a = ctx == null ? void 0 : ctx.childComponentProps) == null ? void 0 : _a.grid) == null ? void 0 : _b.scroll) == null ? void 0 : _c.autoCalc
     },
-    children
-  ), /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null)) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, children, /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null));
+    gridChildren
+  ) : floorMapNode, showGrid ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, showGrid ? gridChildren : floorMapNode, showGrid ? /* @__PURE__ */ import_react.default.createElement(import_Pagination.default, null) : null);
   const shellStyle = fillHeight && style ? { ...style, ...FILL_HEIGHT_WRAPPER_STYLE } : fillHeight ? FILL_HEIGHT_WRAPPER_STYLE : style;
-  const wrapper = /* @__PURE__ */ import_react.default.createElement(
+  const wrapper = /* @__PURE__ */ import_react.default.createElement(import_ShellBodyMetaContext.RecordBoardShellBodyMetaContext.Provider, { value: shellBodyMeta }, /* @__PURE__ */ import_react.default.createElement(
     import_pisellShellFrame.PisellShellFrame,
     {
-      className,
+      className: (0, import_classnames.default)(className, {
+        "pisell-shell-frame--floor-map-view": !showGrid
+      }),
       style: shellStyle,
       config: {
         showToolbar: true,
@@ -118,7 +208,7 @@ var RecordBoardShellFrame = ({ children, className, style }) => {
       batchActionBar: /* @__PURE__ */ import_react.default.createElement(import_BatchActionBar.default, null)
     },
     bodyContent
-  );
+  ));
   if (fillHeight) {
     return /* @__PURE__ */ import_react.default.createElement("div", { style: FILL_HEIGHT_WRAPPER_STYLE }, wrapper);
   }
@@ -129,9 +219,11 @@ var shellFrame_default = RecordBoardShellFrame;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   RecordBoardBatchActionBar,
+  RecordBoardFloorMap,
   RecordBoardPagination,
   RecordBoardSearch,
   RecordBoardToolBar,
   ToolBarQuickFilter,
-  ToolBarReset
+  ToolBarReset,
+  useRecordBoardShellBodyMeta
 });

package/lib/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;
+  }
+}