@pisell/materials 1.0.1059 → 1.0.1062

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

@@ -45,6 +45,7 @@ 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;

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

@@ -42,6 +42,7 @@ 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");
@@ -52,6 +53,16 @@ function getSortButtonText() {
   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 +75,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 +116,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 +141,21 @@ 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 topLeft = /* @__PURE__ */ import_react.default.createElement("div", { className: "record-board-toolbar-top-left" }, bodyViewToggle, 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];

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

@@ -30,6 +30,7 @@ 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,
@@ -40,13 +41,17 @@ __export(shellFrame_exports, {
 module.exports = __toCommonJS(shellFrame_exports);
 var import_react = __toESM(require("react"));
 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_ToolBarReset = __toESM(require("./ToolBarReset"));
 var import_ToolBarQuickFilter = __toESM(require("./ToolBarQuickFilter"));
+var import_FloorMap = __toESM(require("./FloorMap"));
+var import_ShellBodyMetaContext = require("./ShellBodyMetaContext");
 var FILL_HEIGHT_SCROLL_STYLE = {
   flex: 1,
   minHeight: 0,
@@ -93,19 +98,95 @@ 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",
+    {
+      style: {
+        flex: 1,
+        minHeight: 0,
+        display: "flex",
+        flexDirection: "column",
+        overflow: "hidden"
+      }
+    },
+    /* @__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 ?? {}
+        }
+      }
+    ))
+  ) : 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,
@@ -118,7 +199,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,6 +210,7 @@ var shellFrame_default = RecordBoardShellFrame;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   RecordBoardBatchActionBar,
+  RecordBoardFloorMap,
   RecordBoardPagination,
   RecordBoardSearch,
   RecordBoardToolBar,

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