@pisell/materials 1.8.20 → 1.8.22

package/es/components/pisellPercent/utils/percentFormatter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 百分比格式化选项
+ */
+export interface PercentFormatOptions {
+    /** 是否显示百分号 */
+    showPercentSymbol: boolean;
+    /** 小数精度 */
+    precision: number;
+    /** 百分比范围 */
+    range: [number, number];
+}
+/**
+ * 格式化百分比数值
+ *
+ * @param value 数值
+ * @param options 格式化选项
+ * @returns 格式化后的百分比字符串
+ *
+ * @example
+ * formatPercent(85.5, { showPercentSymbol: true, precision: 1, range: [0, 100] })
+ * // 返回: '85.5%'
+ *
+ * @example
+ * formatPercent(0.855, { showPercentSymbol: true, precision: 1, range: [0, 1] })
+ * // 返回: '85.5%'
+ */
+export declare function formatPercent(value: number | null | undefined, options: PercentFormatOptions): string | null;

package/es/components/pisellPercent/utils/rangeConverter.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 百分比范围转换工具函数
+ */
+/**
+ * 将值转换为百分比（0-100）
+ *
+ * @param value 原始值
+ * @param range 值的范围
+ * @returns 转换后的百分比值（0-100）
+ *
+ * @example
+ * // [0, 100] 范围 - 直接返回
+ * convertToPercent(85.5, [0, 100])  // 返回: 85.5
+ *
+ * @example
+ * // [0, 1] 范围 - 乘以 100
+ * convertToPercent(0.855, [0, 1])  // 返回: 85.5
+ *
+ * @example
+ * // 自定义范围 - 按比例计算
+ * convertToPercent(855, [0, 1000])  // 返回: 85.5
+ */
+export declare function convertToPercent(value: number | null | undefined, range: [number, number]): number | null;
+/**
+ * 将百分比值转换回原始范围
+ *
+ * @param percent 百分比值（0-100）
+ * @param range 目标范围
+ * @returns 转换后的值
+ *
+ * @example
+ * convertFromPercent(85.5, [0, 100])  // 返回: 85.5
+ * convertFromPercent(85.5, [0, 1])    // 返回: 0.855
+ * convertFromPercent(85.5, [0, 1000]) // 返回: 855
+ */
+export declare function convertFromPercent(percent: number | null | undefined, range: [number, number]): number | null;

package/es/components/pisellPhone/utils/phoneFormatter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 电话号码格式化工具
+ */
+/**
+ * 中国大陆手机号格式化：138 0000 0000
+ */
+export declare function formatChinaMobile(phone: string): string;
+/**
+ * 美国/加拿大号码格式化：(555) 123-4567
+ */
+export declare function formatUSPhone(phone: string): string;
+/**
+ * 英国号码格式化：1234 567 8900
+ */
+export declare function formatUKPhone(phone: string): string;
+/**
+ * 根据国家码格式化电话号码
+ * @param phone 电话号码（纯数字）
+ * @param countryCode 国家码
+ * @returns 格式化后的电话号码
+ */
+export declare function formatPhone(phone: string, countryCode: string): string;
+/**
+ * 电话号码脱敏
+ * @param phone 电话号码
+ * @param pattern 脱敏模式
+ * @returns 脱敏后的号码
+ *
+ * @example
+ * maskPhone('13800000000', 'middle') // '138****0000'
+ * maskPhone('13800000000', 'last')   // '1380000****'
+ */
+export declare function maskPhone(phone: string, pattern?: 'middle' | 'last'): string;
+/**
+ * 检测号码类型（中国）
+ * @param phone 电话号码
+ * @returns 号码类型
+ */
+export declare function detectPhoneType(phone: string): 'mobile' | 'landline' | 'unknown';

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

@@ -0,0 +1,10 @@
+import React from 'react';
+import './index.less';
+interface PisellQrcodeProps {
+    size?: number;
+    platform?: 'pc' | 'h5' | 'ipad';
+    value: string;
+    className?: string;
+}
+declare const PisellQrcode: React.FC<PisellQrcodeProps>;
+export default PisellQrcode;

package/es/components/pisellRating/PisellRating.stories.d.ts

@@ -0,0 +1,53 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellRating } from './PisellRating';
+declare const meta: Meta<typeof PisellRating>;
+export default meta;
+declare type Story = StoryObj<typeof PisellRating>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 半星评分
+ */
+export declare const HalfStar: Story;
+/**
+ * 显示数值
+ */
+export declare const WithValue: Story;
+/**
+ * 显示评分人数
+ */
+export declare const WithCount: Story;
+/**
+ * 带评分描述
+ */
+export declare const WithTooltips: Story;
+/**
+ * 自定义星星数量
+ */
+export declare const CustomCount: Story;
+/**
+ * 自定义图标 - 爱心
+ */
+export declare const HeartIcon: Story;
+/**
+ * 自定义图标 - 笑脸
+ */
+export declare const SmileIcon: Story;
+/**
+ * 商品评分场景
+ */
+export declare const ProductReview: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;

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

@@ -0,0 +1,7 @@
+/**
+ * PisellRating 组件导出
+ */
+import PisellRating from './PisellRating';
+export { PisellRating };
+export type { PisellRatingProps } from './types';
+export type { DisplayState } from './types';

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

@@ -0,0 +1,124 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 从 @pisell/utils 重新导出公共类型
+ */
+export type { DisplayState } from '@pisell/utils';
+/**
+ * PisellRating 组件 Props 类型定义
+ *
+ * 基于 Ant Design Rate 组件，独立实现
+ */
+export interface PisellRatingProps {
+    /**
+     * 显示模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 当前评分值（受控）
+     */
+    value?: number;
+    /**
+     * 默认评分值（非受控）
+     */
+    defaultValue?: number;
+    /**
+     * 评分变更回调
+     */
+    onChange?: (value: number) => void;
+    /**
+     * 星星数量
+     * @default 5
+     */
+    count?: number;
+    /**
+     * 最大评分值（同 count，为了与 Number 系列保持一致）
+     * @default 5
+     */
+    max?: number;
+    /**
+     * 是否允许半星评分
+     * @default false
+     */
+    allowHalf?: boolean;
+    /**
+     * 是否允许清除评分
+     * @default true
+     */
+    allowClear?: boolean;
+    /**
+     * 自定义字符
+     * @default StarFilled
+     */
+    character?: ReactNode | ((props: {
+        index: number;
+        value: number;
+    }) => ReactNode);
+    /**
+     * 评分描述文本数组
+     * @example ['很差', '差', '一般', '好', '很好']
+     */
+    tooltips?: string[];
+    /**
+     * 是否显示数值文本
+     * @default false
+     */
+    showValue?: boolean;
+    /**
+     * 是否显示评分人数
+     * @default false
+     */
+    showCount?: boolean;
+    /**
+     * 评分人数
+     */
+    reviewCount?: number;
+    /**
+     * 星星尺寸（仅影响样式）
+     * @default 20
+     */
+    size?: number;
+    /**
+     * 星星颜色（已选中）
+     * @default '#fadb14'
+     */
+    color?: string;
+    /**
+     * 星星颜色（未选中）
+     * @default '#d9d9d9'
+     */
+    unselectedColor?: string;
+    /**
+     * 悬停评分值变化回调
+     */
+    onHoverChange?: (value: number) => void;
+    /**
+     * 聚焦回调
+     */
+    onFocus?: () => void;
+    /**
+     * 失焦回调
+     */
+    onBlur?: () => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * HTML id 属性
+     */
+    id?: string;
+}

package/es/components/pisellRecordBoard/PisellRecordBoard.js

@@ -1,4 +1,4 @@
-var _excluded = ["children", "layoutType", "rowKey", "data", "dataSources", "gridDataSourceKey", "loading", "total", "pagination", "onPageChange", "searchParams", "onSearch", "onReset", "floorMap", "floorMapLayoutContext", "defaultBodyView", "className", "style"];
+var _excluded = ["children", "layoutType", "rowKey", "data", "dataSources", "gridDataSourceKey", "loading", "total", "pagination", "onPageChange", "searchParams", "onSearch", "onReset", "floorMap", "floorMapLayoutContext", "defaultBodyView", "bodyViewStorageKey", "floorMapLayoutRef", "floorMapFooter", "className", "style"];
 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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -25,6 +25,16 @@ var defaultPagination = {
   pageNumber: 1,
   pageSize: 50
 };
+function readBodyViewFromStorage(key, fallback) {
+  if (typeof window === 'undefined' || !key) return fallback;
+  try {
+    var raw = localStorage.getItem(key);
+    if (raw === 'grid' || raw === 'floorMap') return raw;
+  } catch (_unused) {
+    /* ignore quota / private mode */
+  }
+  return fallback;
+}
 
 /**
  * 从打散 props 合并出 childComponentProps（供 context 使用）。
@@ -75,6 +85,8 @@ function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
     floorMapProps: undefined,
     floorMapLayoutContext: undefined,
     defaultBodyView: undefined,
+    floorMapLayoutRef: undefined,
+    floorMapFooter: undefined,
     dataSources: undefined,
     gridDataSourceKey: undefined
   };
@@ -104,6 +116,9 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     floorMapProp = props.floorMap,
     floorMapLayoutContextProp = props.floorMapLayoutContext,
     defaultBodyView = props.defaultBodyView,
+    bodyViewStorageKey = props.bodyViewStorageKey,
+    floorMapLayoutRef = props.floorMapLayoutRef,
+    floorMapFooter = props.floorMapFooter,
     classNameProp = props.className,
     styleProp = props.style,
     rest = _objectWithoutProperties(props, _excluded);
@@ -134,11 +149,22 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     filterResetKey = _useState8[0],
     setFilterResetKey = _useState8[1];
   var _useState9 = useState(function () {
-      return defaultBodyView === 'floorMap' ? 'floorMap' : 'grid';
+      var fallback = defaultBodyView === 'floorMap' ? 'floorMap' : 'grid';
+      return readBodyViewFromStorage(bodyViewStorageKey, fallback);
     }),
     _useState10 = _slicedToArray(_useState9, 2),
     bodyView = _useState10[0],
-    setBodyView = _useState10[1];
+    setBodyViewState = _useState10[1];
+  var setBodyView = useCallback(function (v) {
+    setBodyViewState(v);
+    if (typeof window !== 'undefined' && bodyViewStorageKey) {
+      try {
+        localStorage.setItem(bodyViewStorageKey, v);
+      } catch (_unused2) {
+        /* ignore */
+      }
+    }
+  }, [bodyViewStorageKey]);
   var _useState11 = useState(function () {
       var _props$grid$defaultHi, _props$grid, _props$grid$columns, _props$grid2;
       var fromConfig = (_props$grid$defaultHi = (_props$grid = props.grid) === null || _props$grid === void 0 ? void 0 : _props$grid.defaultHiddenColumnKeys) !== null && _props$grid$defaultHi !== void 0 ? _props$grid$defaultHi : [];
@@ -276,9 +302,11 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       setBodyView: setBodyView,
       floorMapProps: floorMapProp,
       floorMapLayoutContext: floorMapLayoutContextProp,
-      defaultBodyView: defaultBodyView
+      defaultBodyView: defaultBodyView,
+      floorMapLayoutRef: floorMapLayoutRef,
+      floorMapFooter: floorMapFooter
     });
-  }, [layoutType, rowKeyProp, dataProp, dataSourcesProp, gridDataSourceKeyProp, loadingProp, totalProp, paginationProp, onPageChangeProp, searchParamsProp, onSearchProp, onResetProp, mergedChildComponentProps, internalSelectedKeys, internalSelectedRows, onSelectionChangeInternal, internalColumnVisibility, onColumnVisibilityChangeInternal, internalColumnOrder, onColumnOrderChangeInternal, fillHeight, scrollAreaHeight, filterResetKey, floorMapProp, floorMapLayoutContextProp, defaultBodyView, bodyView]);
+  }, [layoutType, rowKeyProp, dataProp, dataSourcesProp, gridDataSourceKeyProp, loadingProp, totalProp, paginationProp, onPageChangeProp, searchParamsProp, onSearchProp, onResetProp, mergedChildComponentProps, internalSelectedKeys, internalSelectedRows, onSelectionChangeInternal, internalColumnVisibility, onColumnVisibilityChangeInternal, internalColumnOrder, onColumnOrderChangeInternal, fillHeight, scrollAreaHeight, filterResetKey, floorMapProp, floorMapLayoutContextProp, defaultBodyView, floorMapLayoutRef, floorMapFooter, bodyView, setBodyView]);
   var content = /*#__PURE__*/React.createElement(RecordBoardProvider, {
     value: contextValue
   }, children);

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

@@ -38,3 +38,4 @@ declare const PisellRecordBoard: PisellRecordBoardType;
 export default PisellRecordBoard;
 export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, RecordBoardBodyView, RecordBoardFloorMapProps, RecordBoardToolBarProps, } from './types';
 export { useRecordBoardContext } from './hooks/useRecordBoardContext';
+export { useRecordBoardShellBodyMeta } from './shellFrame';

package/es/components/pisellRecordBoard/index.js

@@ -21,4 +21,5 @@ PisellRecordBoard.CardList = RecordBoardCardList;
 PisellRecordBoard.BatchActionBar = RecordBoardBatchActionBar;
 PisellRecordBoard.useRecordBoardContext = useRecordBoardContext;
 export default PisellRecordBoard;
-export { useRecordBoardContext } from "./hooks/useRecordBoardContext";
+export { useRecordBoardContext } from "./hooks/useRecordBoardContext";
+export { useRecordBoardShellBodyMeta } from "./shellFrame";

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

@@ -43,6 +43,20 @@
     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 */

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

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

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

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

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

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

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

@@ -3,6 +3,7 @@ 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';
@@ -18,3 +19,4 @@ declare const RecordBoardShellFrame: React.FC<{
 }>;
 export default RecordBoardShellFrame;
 export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };
+export { useRecordBoardShellBodyMeta } from './ShellBodyMetaContext';

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

@@ -6,6 +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, { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import classNames from 'classnames';
 import { PisellShellFrame } from "../../pisellShellFrame";
 import { PisellFloorMapLayout, FloorMapLayoutProvider, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT } from "../../pisellFloorMapLayout";
 import { useRecordBoardContext } from "../hooks/useRecordBoardContext";
@@ -14,6 +15,7 @@ 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";
@@ -67,7 +69,7 @@ var FILL_HEIGHT_WRAPPER_STYLE = {
  * 仅表格侧、仅平面图侧、或双视图（出现 Segmented 切换）由子节点组合决定。根级 `floorMap` props 仍支持（如低代码透传），与 FloorMap 子组件 props 合并，**子组件优先**。
  */
 var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
-  var _effectiveFloorMapPro, _effectiveFloorMapPro2, _effectiveFloorMapPro3, _ctx$setScrollAreaHei, _ctx$childComponentPr;
+  var _ctx$floorMapLayoutRe, _effectiveFloorMapPro, _effectiveFloorMapPro2, _effectiveFloorMapPro3, _ctx$setScrollAreaHei, _ctx$childComponentPr;
   var children = _ref2.children,
     className = _ref2.className,
     style = _ref2.style;
@@ -134,16 +136,20 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
     return (_ctx$floorMapLayoutCo = ctx.floorMapLayoutContext) !== null && _ctx$floorMapLayoutCo !== void 0 ? _ctx$floorMapLayoutCo : EMPTY_FLOOR_MAP_LAYOUT_CONTEXT;
   }, [ctx.floorMapLayoutContext]);
   var floorMapNode = effectiveFloorMapProps && !showGrid ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-record-board-floor-map-viewport",
     style: {
       flex: 1,
       minHeight: 0,
       display: 'flex',
       flexDirection: 'column',
-      overflow: 'hidden'
+      overflow: 'hidden',
+      position: 'relative'
     }
   }, /*#__PURE__*/React.createElement(FloorMapLayoutProvider, {
     value: floorMapLayoutProviderValue
-  }, /*#__PURE__*/React.createElement(PisellFloorMapLayout, _extends({}, effectiveFloorMapProps, mergedFloorMapDataSources !== undefined ? {
+  }, /*#__PURE__*/React.createElement(PisellFloorMapLayout, _extends({
+    ref: (_ctx$floorMapLayoutRe = ctx.floorMapLayoutRef) !== null && _ctx$floorMapLayoutRe !== void 0 ? _ctx$floorMapLayoutRe : undefined
+  }, effectiveFloorMapProps, mergedFloorMapDataSources !== undefined ? {
     dataSources: mergedFloorMapDataSources
   } : {}, {
     items: (_effectiveFloorMapPro = effectiveFloorMapProps.items) !== null && _effectiveFloorMapPro !== void 0 ? _effectiveFloorMapPro : [],
@@ -154,7 +160,9 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
       flex: 1,
       minHeight: 0
     }, (_effectiveFloorMapPro3 = effectiveFloorMapProps.style) !== null && _effectiveFloorMapPro3 !== void 0 ? _effectiveFloorMapPro3 : {})
-  })))) : null;
+  }))), ctx.floorMapFooter ? /*#__PURE__*/React.createElement("div", {
+    className: "pisell-record-board-floor-map-floating-slot"
+  }, ctx.floorMapFooter) : null) : null;
   var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, showGrid ? /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
     onHeight: (_ctx$setScrollAreaHei = ctx === null || ctx === void 0 ? void 0 : ctx.setScrollAreaHeight) !== null && _ctx$setScrollAreaHei !== void 0 ? _ctx$setScrollAreaHei : function () {},
     autoCalc: ctx === null || ctx === void 0 || (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.grid) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.scroll) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.autoCalc
@@ -163,7 +171,9 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
   var wrapper = /*#__PURE__*/React.createElement(RecordBoardShellBodyMetaContext.Provider, {
     value: shellBodyMeta
   }, /*#__PURE__*/React.createElement(PisellShellFrame, {
-    className: className,
+    className: classNames(className, {
+      'pisell-shell-frame--floor-map-view': !showGrid
+    }),
     style: shellStyle,
     config: {
       showToolbar: true,
@@ -181,4 +191,5 @@ var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
 };
 RecordBoardShellFrame.displayName = 'RecordBoard.ShellFrame';
 export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, RecordBoardFloorMap };
+export { useRecordBoardShellBodyMeta } from "./ShellBodyMetaContext";

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

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

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

@@ -1,5 +1,5 @@
-import type { ReactNode, Key, ComponentType } from 'react';
-import type { PisellFloorMapLayoutProps, FloorMapDataSources, FloorMapLayoutContextValue } from '../pisellFloorMapLayout/types';
+import type { ReactNode, Key, ComponentType, Ref } from 'react';
+import type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapDataSources, FloorMapLayoutContextValue } from '../pisellFloorMapLayout/types';
 import type { TableProps } from 'antd';
 /**
  * 布局类型：一种 layout 对应一种「视图的集合」
@@ -202,6 +202,12 @@ export interface RecordBoardContextValue {
     floorMapLayoutContext?: FloorMapLayoutContextValue;
     /** 双视图并存时首屏偏好（根 props，与 PisellRecordBoard.defaultBodyView 一致） */
     defaultBodyView?: RecordBoardBodyView;
+    /** 挂到 ShellFrame 内 PisellFloorMapLayout，供外部 imperative 调用（如 saveLayout / fitBounds） */
+    floorMapLayoutRef?: Ref<PisellFloorMapLayoutRef | null>;
+    /**
+     * 平面图视图下叠在画布内的底部居中悬浮区（如「编辑平面图」），不单独占一行 footer。
+     */
+    floorMapFooter?: ReactNode;
 }
 /**
  * 各 layout 下子组件的可选透传配置（类似 ChildComponentProps）
@@ -364,6 +370,12 @@ export interface RecordBoardProps {
      * 仅声明 FloorMap 而无 Grid/Card 内容时由 ShellFrame 固定为平面图，不出现切换器。
      */
     defaultBodyView?: RecordBoardBodyView;
+    /** 与 bodyView 同步持久化到 localStorage 的 key（双视图时生效） */
+    bodyViewStorageKey?: string;
+    /** 平面图 Layout 实例 ref，由 ShellFrame 注入 */
+    floorMapLayoutRef?: Ref<PisellFloorMapLayoutRef | null>;
+    /** 平面图画布内底部悬浮插槽（如编辑入口），注入 Context 供 ShellFrame 渲染 */
+    floorMapFooter?: ReactNode;
     /** 其他 */
     [key: string]: any;
 }