@pisell/materials 1.8.20 → 1.8.21

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

@@ -37,6 +37,15 @@ var import_utils = require("@pisell/utils");
 var import_RecordBoardProvider = require("./context/RecordBoardProvider");
 var import_recordBoardColumns = require("./utils/recordBoardColumns");
 var defaultPagination = { pageNumber: 1, pageSize: 50 };
+function readBodyViewFromStorage(key, fallback) {
+  if (typeof window === "undefined" || !key) return fallback;
+  try {
+    const raw = localStorage.getItem(key);
+    if (raw === "grid" || raw === "floorMap") return raw;
+  } catch {
+  }
+  return fallback;
+}
 function mergeChildComponentProps(props) {
   const hasAny = props.grid != null || props.toolBar != null || props.search != null || props.paginationConfig != null || props.batchActionBar != null || props.cardList != null;
   if (!hasAny) return void 0;
@@ -82,6 +91,8 @@ function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
     floorMapProps: void 0,
     floorMapLayoutContext: void 0,
     defaultBodyView: void 0,
+    floorMapLayoutRef: void 0,
+    floorMapFooter: void 0,
     dataSources: void 0,
     gridDataSourceKey: void 0
   };
@@ -104,6 +115,9 @@ var PisellRecordBoard = (props) => {
     floorMap: floorMapProp,
     floorMapLayoutContext: floorMapLayoutContextProp,
     defaultBodyView,
+    bodyViewStorageKey,
+    floorMapLayoutRef,
+    floorMapFooter,
     className: classNameProp,
     style: styleProp,
     ...rest
@@ -127,8 +141,21 @@ var PisellRecordBoard = (props) => {
   const [internalSelectedRows, setInternalSelectedRows] = (0, import_react.useState)([]);
   const [scrollAreaHeight, setScrollAreaHeight] = (0, import_react.useState)(null);
   const [filterResetKey, setFilterResetKey] = (0, import_react.useState)(0);
-  const [bodyView, setBodyView] = (0, import_react.useState)(
-    () => defaultBodyView === "floorMap" ? "floorMap" : "grid"
+  const [bodyView, setBodyViewState] = (0, import_react.useState)(() => {
+    const fallback = defaultBodyView === "floorMap" ? "floorMap" : "grid";
+    return readBodyViewFromStorage(bodyViewStorageKey, fallback);
+  });
+  const setBodyView = (0, import_react.useCallback)(
+    (v) => {
+      setBodyViewState(v);
+      if (typeof window !== "undefined" && bodyViewStorageKey) {
+        try {
+          localStorage.setItem(bodyViewStorageKey, v);
+        } catch {
+        }
+      }
+    },
+    [bodyViewStorageKey]
   );
   const [internalColumnVisibility, setInternalColumnVisibility] = (0, import_react.useState)(() => {
     var _a, _b;
@@ -259,7 +286,9 @@ var PisellRecordBoard = (props) => {
       setBodyView,
       floorMapProps: floorMapProp,
       floorMapLayoutContext: floorMapLayoutContextProp,
-      defaultBodyView
+      defaultBodyView,
+      floorMapLayoutRef,
+      floorMapFooter
     };
   }, [
     layoutType,
@@ -288,7 +317,10 @@ var PisellRecordBoard = (props) => {
     floorMapProp,
     floorMapLayoutContextProp,
     defaultBodyView,
-    bodyView
+    floorMapLayoutRef,
+    floorMapFooter,
+    bodyView,
+    setBodyView
   ]);
   const content = /* @__PURE__ */ import_react.default.createElement(import_RecordBoardProvider.RecordBoardProvider, { value: contextValue }, children);
   return /* @__PURE__ */ import_react.default.createElement(

package/lib/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/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,6 +42,7 @@ 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;
@@ -56,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/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/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"));
@@ -47,6 +48,7 @@ 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";
@@ -155,7 +157,9 @@ var RecordBoardToolBar = (props) => {
       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 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];
@@ -273,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,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/lib/components/pisellRecordBoard/shellFrame/index.js

@@ -36,10 +36,12 @@ __export(shellFrame_exports, {
   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");
@@ -48,10 +50,12 @@ 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,
@@ -152,17 +156,20 @@ var RecordBoardShellFrame = ({ children, className, style }) => {
   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"
+        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 ?? [],
@@ -173,7 +180,8 @@ var RecordBoardShellFrame = ({ children, className, style }) => {
           ...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,
@@ -188,7 +196,9 @@ var RecordBoardShellFrame = ({ children, className, style }) => {
   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,
@@ -214,5 +224,6 @@ var shellFrame_default = RecordBoardShellFrame;
   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;
+  }
+}

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