@pisell/materials 1.8.18 → 1.8.20

package/es/components/pisellRecordBoard/context/RecordBoardContext.d.ts

@@ -0,0 +1,3 @@
+/// <reference types="react" />
+import type { RecordBoardContextValue } from '../types';
+export declare const RecordBoardContext: import("react").Context<RecordBoardContextValue | null>;

package/es/components/pisellRecordBoard/context/RecordBoardProvider.d.ts

@@ -0,0 +1,11 @@
+import React, { ReactNode } from 'react';
+import type { RecordBoardContextValue } from '../types';
+export interface RecordBoardProviderProps {
+    value: RecordBoardContextValue;
+    children: ReactNode;
+}
+/**
+ * 仅负责注入 RecordBoard 上下文。
+ * 实际的数据源、onSearch/onPageChange 由上层（如接 DataSourceContainer 或独立 fetch）提供。
+ */
+export declare const RecordBoardProvider: React.FC<RecordBoardProviderProps>;

package/es/components/pisellRecordBoard/hooks/useRecordBoardContext.d.ts

@@ -0,0 +1,16 @@
+import type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps } from '../types';
+export interface UseRecordBoardContextOptions {
+    /** 子组件 displayName，用于从 childComponentProps 中取对应 props */
+    displayName?: keyof RecordBoardChildComponentProps;
+    /** 上层传入的 childComponentProps（若 Context 未提供则从参数传入） */
+    childComponentProps?: RecordBoardChildComponentProps;
+}
+/**
+ * 消费 RecordBoard 上下文，供各 layout 内子组件（Search / ToolBar / Grid / CardList / Pagination）使用。
+ * 若传入 displayName，返回会合并 childComponentProps[displayName] 便于透传。
+ * 当 displayName 为 'grid' 时，返回类型包含 RecordBoardGridProps（columns、scroll、size）。
+ */
+export declare function useRecordBoardContext(options: UseRecordBoardContextOptions & {
+    displayName: 'grid';
+}): RecordBoardContextValue & RecordBoardGridProps;
+export declare function useRecordBoardContext(options?: UseRecordBoardContextOptions): RecordBoardContextValue;

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

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

package/es/components/pisellRecordBoard/index.js

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

package/es/components/pisellRecordBoard/layouts/CardLayout/CardList.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import type { RecordBoardContextValue } from '../../types';
+export interface RecordBoardCardListProps extends Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
+    className?: string;
+    style?: React.CSSProperties;
+    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
+}
+/**
+ * Card 布局下的数据视图：从 context 取 data / loading。
+ */
+declare const RecordBoardCardList: React.FC<RecordBoardCardListProps>;
+export default RecordBoardCardList;

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

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

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

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

package/es/components/pisellRecordBoard/shellFrame/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/Search/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+export interface RecordBoardSearchProps {
+    [key: string]: any;
+}
+/**
+ * RecordBoard 下的独立搜索槽：使用 PisellFind，绑定 context.searchParams.keyword 与 onSearch。
+ * 可通过 childComponentProps.search 透传 PisellFind 的 props。
+ */
+declare const RecordBoardSearch: React.FC<RecordBoardSearchProps>;
+export default RecordBoardSearch;

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

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

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

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

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

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

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

@@ -6,7 +6,7 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import React, { useCallback, useMemo } from 'react';
-import { Button, Space } from 'antd';
+import { Button, Space, Segmented } from 'antd';
 import SwitchVertical01 from '@pisell/icon/es/SwitchVertical01';
 import PisellToolBar from "../../../pisellGridPro/ToolBar";
 import { PisellFind } from "../../../pisellFind";
@@ -15,6 +15,7 @@ import Sort from "../../../sort";
 import ToolBarReset from "../ToolBarReset";
 import ToolBarQuickFilter from "../ToolBarQuickFilter";
 import RecordBoardColumnSetting from "../ColumnSetting";
+import { useRecordBoardShellBodyMeta } from "../ShellBodyMetaContext";
 import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
 import { locales as utilsLocales } from '@pisell/utils';
 import { getText } from "../../../../locales";
@@ -31,6 +32,16 @@ function getFilterButtonText() {
   var u = utilsLocales.getText(key);
   return u && u !== key ? u : getText(key) || getText('table-action-filter-button');
 }
+function getViewGridLabel() {
+  var key = 'pisell2.recordBoard.toolbar.viewGrid';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || 'Table';
+}
+function getViewFloorMapLabel() {
+  var key = 'pisell2.recordBoard.toolbar.viewFloorMap';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || 'Floor map';
+}
 import { deriveFilterFromColumns, deriveSortFromColumns } from "../../utils/recordBoardColumns";
 
 /** 默认搜索参数字段名，与 context.searchParams 对应 */
@@ -56,12 +67,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 +114,45 @@ var RecordBoardToolBar = function RecordBoardToolBar(props) {
     var _ref;
     if (quickFilterConfig === false) return [];
     var fromConfig = _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null && Array.isArray(quickFilterConfig.filterList) ? quickFilterConfig.filterList : null;
-    return (_ref = fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter) !== null && _ref !== void 0 ? _ref : [];
-  }, [quickFilterConfig, derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter]);
+    var list = (_ref = fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter) !== null && _ref !== void 0 ? _ref : [];
+    var hideNames = _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null && Array.isArray(quickFilterConfig.hideFilterNamesOnFloorMap) ? quickFilterConfig.hideFilterNamesOnFloorMap : null;
+    if (bodyView === 'floorMap' && showTableFloorToggle && hideNames != null && hideNames.length > 0) {
+      var hideSet = new Set(hideNames.map(String));
+      list = list.filter(function (item) {
+        var _item$name;
+        var n = (_item$name = item.name) !== null && _item$name !== void 0 ? _item$name : item.key;
+        return n == null || !hideSet.has(String(n));
+      });
+    }
+    return list;
+  }, [quickFilterConfig, derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter, bodyView, showTableFloorToggle]);
   var showQuickFilterLeft = quickFilterList.length > 0;
   var quickFilterNode = showQuickFilterLeft ? /*#__PURE__*/React.createElement(ToolBarQuickFilter, {
     filterList: quickFilterList,
     formFiltersPrefix: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_formFiltersPrefix = quickFilterConfig.formFiltersPrefix) !== null && _formFiltersPrefix !== void 0 ? _formFiltersPrefix : '' : '',
     size: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_size = quickFilterConfig.size) !== null && _size !== void 0 ? _size : 'large' : 'large'
   }) : null;
+  var bodyViewToggle = showTableFloorToggle ? /*#__PURE__*/React.createElement(Segmented, {
+    className: "record-board-toolbar-body-view-segmented",
+    size: "large",
+    value: bodyView,
+    onChange: function onChange(v) {
+      return setBodyView(v);
+    },
+    options: [{
+      label: getViewGridLabel(),
+      value: 'grid'
+    }, {
+      label: getViewFloorMapLabel(),
+      value: 'floorMap'
+    }],
+    style: {
+      marginRight: 8
+    }
+  }) : null;
   var topLeft = /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-top-left"
-  }, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
+  }, bodyViewToggle, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
     className: "record-board-toolbar-find-wrap"
   }, searchNode) : null, slots.topLeft);
   var sortConfig = slots.sort;

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

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

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

@@ -1,18 +1,23 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-import React, { useRef, useEffect } from 'react';
+import React, { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { PisellShellFrame } from "../../pisellShellFrame";
+import { PisellFloorMapLayout, FloorMapLayoutProvider, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT } from "../../pisellFloorMapLayout";
 import { useRecordBoardContext } from "../hooks/useRecordBoardContext";
+import { partitionShellFrameChildren } from "../utils/partitionShellFrameChildren";
 import RecordBoardToolBar from "./ToolBar";
 import RecordBoardBatchActionBar from "./BatchActionBar";
 import RecordBoardPagination from "./Pagination";
 import RecordBoardSearch from "./Search";
 import ToolBarReset from "./ToolBarReset";
 import ToolBarQuickFilter from "./ToolBarQuickFilter";
+import RecordBoardFloorMap from "./FloorMap";
+import { RecordBoardShellBodyMetaContext } from "./ShellBodyMetaContext";
 
 /** fillHeight 时内容区可滚动、分页器贴底；默认表头 sticky；grid.scroll.autoCalc 时需测量高度供 scroll.y */
 var FILL_HEIGHT_SCROLL_STYLE = {
@@ -58,31 +63,106 @@ 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 _effectiveFloorMapPro, _effectiveFloorMapPro2, _effectiveFloorMapPro3, _ctx$setScrollAreaHei, _ctx$childComponentPr;
   var children = _ref2.children,
     className = _ref2.className,
     style = _ref2.style;
-  var ctx = useRecordBoardContext({
-    displayName: 'RecordBoard.ShellFrame'
-  });
+  var ctx = useRecordBoardContext();
   var fillHeight = (ctx === null || ctx === void 0 ? void 0 : ctx.fillHeight) === true;
-  var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
+  var _useMemo = useMemo(function () {
+      return partitionShellFrameChildren(children);
+    }, [children]),
+    gridChildren = _useMemo.gridChildren,
+    floorMapPropsFromChild = _useMemo.floorMapPropsFromChild,
+    hasGridContent = _useMemo.hasGridContent,
+    hasFloorMapChild = _useMemo.hasFloorMapChild;
+
+  /** 子组件 FloorMap 与根级 context.floorMapProps 合并，子 props 覆盖根级 */
+  var effectiveFloorMapProps = useMemo(function () {
+    if (hasFloorMapChild) {
+      var _ctx$floorMapProps;
+      return _objectSpread(_objectSpread({}, (_ctx$floorMapProps = ctx.floorMapProps) !== null && _ctx$floorMapProps !== void 0 ? _ctx$floorMapProps : {}), floorMapPropsFromChild !== null && floorMapPropsFromChild !== void 0 ? floorMapPropsFromChild : {});
+    }
+    return ctx.floorMapProps;
+  }, [hasFloorMapChild, floorMapPropsFromChild, ctx.floorMapProps]);
+
+  /**
+   * 平面图使用整份多 key：根级 Context.dataSources 与 FloorMap props 合并（后者覆盖同 key）。
+   * 表格分页切片只影响 ctx.data，不得缩短此对象。
+   */
+  var mergedFloorMapDataSources = useMemo(function () {
+    var root = ctx.dataSources;
+    var fromFloor = effectiveFloorMapProps === null || effectiveFloorMapProps === void 0 ? void 0 : effectiveFloorMapProps.dataSources;
+    if (root == null && fromFloor == null) return undefined;
+    return _objectSpread(_objectSpread({}, root !== null && root !== void 0 ? root : {}), fromFloor !== null && fromFloor !== void 0 ? fromFloor : {});
+  }, [ctx.dataSources, effectiveFloorMapProps === null || effectiveFloorMapProps === void 0 ? void 0 : effectiveFloorMapProps.dataSources]);
+  var hasFloorMapSlot = hasFloorMapChild || ctx.floorMapProps != null;
+  var shellBodyMeta = useMemo(function () {
+    return {
+      effectiveFloorMapProps: effectiveFloorMapProps,
+      hasGridContent: hasGridContent,
+      hasFloorMapSlot: hasFloorMapSlot
+    };
+  }, [effectiveFloorMapProps, hasGridContent, hasFloorMapSlot]);
+
+  /**
+   * 仅平面图：强制 floorMap 视图；仅表格：强制 grid；双视图：尊重 ctx.bodyView。
+   */
+  var showGrid = useMemo(function () {
+    if (!hasFloorMapSlot) return true;
+    if (!hasGridContent) return false;
+    return ctx.bodyView === 'grid';
+  }, [hasFloorMapSlot, hasGridContent, ctx.bodyView]);
+
+  /** 仅平面图 / 仅表格时同步 bodyView，避免切换组合后状态不一致 */
+  useLayoutEffect(function () {
+    if (!ctx.setBodyView) return;
+    if (hasFloorMapSlot && !hasGridContent) {
+      ctx.setBodyView('floorMap');
+      return;
+    }
+    if (hasGridContent && !hasFloorMapSlot) {
+      ctx.setBodyView('grid');
+    }
+  }, [hasFloorMapSlot, hasGridContent, ctx.setBodyView]);
+  var floorMapLayoutProviderValue = useMemo(function () {
+    var _ctx$floorMapLayoutCo;
+    return (_ctx$floorMapLayoutCo = ctx.floorMapLayoutContext) !== null && _ctx$floorMapLayoutCo !== void 0 ? _ctx$floorMapLayoutCo : EMPTY_FLOOR_MAP_LAYOUT_CONTEXT;
+  }, [ctx.floorMapLayoutContext]);
+  var floorMapNode = effectiveFloorMapProps && !showGrid ? /*#__PURE__*/React.createElement("div", {
+    style: {
+      flex: 1,
+      minHeight: 0,
+      display: 'flex',
+      flexDirection: 'column',
+      overflow: 'hidden'
+    }
+  }, /*#__PURE__*/React.createElement(FloorMapLayoutProvider, {
+    value: floorMapLayoutProviderValue
+  }, /*#__PURE__*/React.createElement(PisellFloorMapLayout, _extends({}, effectiveFloorMapProps, mergedFloorMapDataSources !== undefined ? {
+    dataSources: mergedFloorMapDataSources
+  } : {}, {
+    items: (_effectiveFloorMapPro = effectiveFloorMapProps.items) !== null && _effectiveFloorMapPro !== void 0 ? _effectiveFloorMapPro : [],
+    renderItem: (_effectiveFloorMapPro2 = effectiveFloorMapProps.renderItem) !== null && _effectiveFloorMapPro2 !== void 0 ? _effectiveFloorMapPro2 : function () {
+      return null;
+    },
+    style: _objectSpread({
+      flex: 1,
+      minHeight: 0
+    }, (_effectiveFloorMapPro3 = effectiveFloorMapProps.style) !== null && _effectiveFloorMapPro3 !== void 0 ? _effectiveFloorMapPro3 : {})
+  })))) : null;
+  var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, showGrid ? /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
     onHeight: (_ctx$setScrollAreaHei = ctx === null || ctx === void 0 ? void 0 : ctx.setScrollAreaHeight) !== null && _ctx$setScrollAreaHei !== void 0 ? _ctx$setScrollAreaHei : function () {},
     autoCalc: ctx === null || ctx === void 0 || (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.grid) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.scroll) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.autoCalc
-  }, children), /*#__PURE__*/React.createElement(RecordBoardPagination, null)) : /*#__PURE__*/React.createElement(React.Fragment, null, children, /*#__PURE__*/React.createElement(RecordBoardPagination, null));
+  }, gridChildren) : floorMapNode, showGrid ? /*#__PURE__*/React.createElement(RecordBoardPagination, null) : null) : /*#__PURE__*/React.createElement(React.Fragment, null, showGrid ? gridChildren : floorMapNode, showGrid ? /*#__PURE__*/React.createElement(RecordBoardPagination, null) : null);
   var shellStyle = fillHeight && style ? _objectSpread(_objectSpread({}, style), FILL_HEIGHT_WRAPPER_STYLE) : fillHeight ? FILL_HEIGHT_WRAPPER_STYLE : style;
-  var wrapper = /*#__PURE__*/React.createElement(PisellShellFrame, {
+  var wrapper = /*#__PURE__*/React.createElement(RecordBoardShellBodyMetaContext.Provider, {
+    value: shellBodyMeta
+  }, /*#__PURE__*/React.createElement(PisellShellFrame, {
     className: className,
     style: shellStyle,
     config: {
@@ -91,7 +171,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 +181,4 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
 };
 RecordBoardShellFrame.displayName = 'RecordBoard.ShellFrame';
 export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter };
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };