@pisell/materials 1.0.1060 → 1.0.1062

package/es/components/PisellLayouts/index.js

@@ -1,17 +1,17 @@
-/**
- * PisellLayouts 命名空间
- * 布局组件集合
- *
- * @example
- * import { PisellLayouts } from '@pisell/materials';
- *
- * <PisellLayouts.BasicGrid columns={3} gap={16}>
- *   {items.map(item => <Card key={item.id} {...item} />)}
- * </PisellLayouts.BasicGrid>
- *
- * <PisellLayouts.ScrollView direction="horizontal">
- *   <Content />
- * </PisellLayouts.ScrollView>
+/**
+ * PisellLayouts 命名空间
+ * 布局组件集合
+ *
+ * @example
+ * import { PisellLayouts } from '@pisell/materials';
+ *
+ * <PisellLayouts.BasicGrid columns={3} gap={16}>
+ *   {items.map(item => <Card key={item.id} {...item} />)}
+ * </PisellLayouts.BasicGrid>
+ *
+ * <PisellLayouts.ScrollView direction="horizontal">
+ *   <Content />
+ * </PisellLayouts.ScrollView>
  */
 
 import PisellBasicGrid from "../PisellBasicGrid";

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -81,7 +81,8 @@ function PisellFloorMapLayoutInner(props, ref) {
     onElementRenderError = p.onElementRenderError,
     _p$toolbarShowSave = p.toolbarShowSave,
     toolbarShowSave = _p$toolbarShowSave === void 0 ? true : _p$toolbarShowSave,
-    floorMapFullscreenMode = p.floorMapFullscreenMode;
+    floorMapFullscreenMode = p.floorMapFullscreenMode,
+    showDataSourceRecordFormBlock = p.showDataSourceRecordFormBlock;
   var isFloorMapView = Boolean(floorMapConfigProp);
   var contentOffsetRef = useRef({
     x: 0,
@@ -101,7 +102,8 @@ function PisellFloorMapLayoutInner(props, ref) {
     dataSourceRecordForm: dataSourceRecordForm,
     dataSourceLabels: dataSourceLabels,
     layoutPrefix: PREFIX,
-    contentOffsetRef: contentOffsetRef
+    contentOffsetRef: contentOffsetRef,
+    showDataSourceRecordFormBlock: showDataSourceRecordFormBlock
   });
   var config = edit.config,
     currentCanvasId = edit.currentCanvasId,
@@ -298,9 +300,12 @@ function PisellFloorMapLayoutInner(props, ref) {
         var _transformRef$current3;
         return (_transformRef$current3 = transformRef.current) === null || _transformRef$current3 === void 0 ? void 0 : _transformRef$current3.resetTransform();
       },
-      fitBounds: fitBounds
+      fitBounds: fitBounds,
+      saveLayout: function saveLayout() {
+        return handleSave();
+      }
     };
-  }, [fitBounds]);
+  }, [fitBounds, handleSave]);
   var showSidebar = isFloorMapView && mode === 'edit' && config && dataSources;
   return /*#__PURE__*/React.createElement("div", {
     ref: containerRef,

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.stories.js

@@ -49,11 +49,11 @@ var FIGMA = {
   legendAvailableSoon: '#FDA29B'
 };
 
-/**
- * PisellFloorMapLayout 楼层图布局
- *
- * 空间布局视图：在二维平面按坐标渲染资源（桌台/房间/工位等），
- * 支持缩放、平移、复位、区域定位，仅负责展示与交互。
+/**
+ * PisellFloorMapLayout 楼层图布局
+ *
+ * 空间布局视图：在二维平面按坐标渲染资源（桌台/房间/工位等），
+ * 支持缩放、平移、复位、区域定位，仅负责展示与交互。
  */
 var meta = {
   title: 'Data Display/PisellFloorMapLayout',
@@ -166,8 +166,8 @@ function renderSimpleItem(item) {
   }, item.id);
 }
 
-/**
- * 默认 - 纯色底 + 简单格子（格子单位，默认 item 间距 8px）
+/**
+ * 默认 - 纯色底 + 简单格子（格子单位，默认 item 间距 8px）
  */
 export var Default = {
   parameters: {
@@ -220,8 +220,8 @@ export var Default = {
   }
 };
 
-/**
- * 显示网格线（item 间距由 mapLayer.gap 控制）
+/**
+ * 显示网格线（item 间距由 mapLayer.gap 控制）
  */
 export var WithGrid = {
   args: {
@@ -246,8 +246,8 @@ export var WithGrid = {
   }
 };
 
-/**
- * 开启平移 - 可拖拽画布
+/**
+ * 开启平移 - 可拖拽画布
  */
 export var WithPan = {
   args: {
@@ -278,8 +278,8 @@ export var WithPan = {
   }
 };
 
-/**
- * 不同形状 - 矩形、圆形、三角形；含不同格子宽高（如 rect2 为 2x1）
+/**
+ * 不同形状 - 矩形、圆形、三角形；含不同格子宽高（如 rect2 为 2x1）
  */
 var shapeItems = [{
   id: 'rect',
@@ -326,8 +326,8 @@ export var WithShapes = {
   }
 };
 
-/**
- * 格子单位下不同宽高 - 每个 item 可设置 width/height（格子数）
+/**
+ * 格子单位下不同宽高 - 每个 item 可设置 width/height（格子数）
  */
 var variableSizeItems = [{
   id: '1x1',
@@ -389,8 +389,8 @@ export var WithVariableSizes = {
   }
 };
 
-/**
- * 像素单位 - x、y、width、height 均为像素，可任意位置与尺寸
+/**
+ * 像素单位 - x、y、width、height 均为像素，可任意位置与尺寸
  */
 var pixelItems = [{
   id: 'A',
@@ -451,8 +451,8 @@ export var PixelUnits = {
   }
 };
 
-/**
- * 点击与 Hover 事件
+/**
+ * 点击与 Hover 事件
  */
 export var WithEvents = {
   args: {
@@ -481,8 +481,8 @@ export var WithEvents = {
   }
 };
 
-/**
- * Ref 调用 - 外部按钮控制缩放/复位/区域定位
+/**
+ * Ref 调用 - 外部按钮控制缩放/复位/区域定位
  */
 export var WithRefControls = {
   render: function WithRefControlsRender() {
@@ -544,9 +544,9 @@ export var WithRefControls = {
   }
 };
 
-/**
- * Floor Map 视图 - 编辑态（多画布 Tab + 占位工具栏/编辑面板）
- * 传入 floorMapConfig + dataSources + mode='edit'，由组件内部合并 items
+/**
+ * Floor Map 视图 - 编辑态（多画布 Tab + 占位工具栏/编辑面板）
+ * 传入 floorMapConfig + dataSources + mode='edit'，由组件内部合并 items
  */
 var mockFloorMapConfig = {
   canvasUi: {
@@ -747,8 +747,8 @@ function SalesRecordInlineForm(props) {
   }, "\u4FDD\u5B58\uFF08\u81EA\u5B9A\u4E49\u8868\u5355\uFF09"));
 }
 
-/**
- * 平面图编辑态 + 自定义数据源记录表单（`dataSourceRecordForm.sales`）
+/**
+ * 平面图编辑态 + 自定义数据源记录表单（`dataSourceRecordForm.sales`）
  */
 export var FloorMapViewEditCustomRecordForm = {
   parameters: {
@@ -811,8 +811,8 @@ export var FloorMapViewEditCustomRecordForm = {
   }
 };
 
-/**
- * Floor Map 视图 - 阅读态（方桌同样用 Figma 样式）
+/**
+ * Floor Map 视图 - 阅读态（方桌同样用 Figma 样式）
  */
 export var FloorMapViewRead = {
   parameters: {
@@ -851,8 +851,8 @@ export var FloorMapViewRead = {
   }
 };
 
-/**
- * 自定义控制按钮显隐
+/**
+ * 自定义控制按钮显隐
  */
 export var ControlsHidden = {
   args: {
@@ -875,8 +875,8 @@ export var ControlsHidden = {
   }
 };
 
-/**
- * `FloorMapLayoutProvider` 注入 `floorMapConfig` / `dataSources`；Layout 仅传展示向 props
+/**
+ * `FloorMapLayoutProvider` 注入 `floorMapConfig` / `dataSources`；Layout 仅传展示向 props
  */
 export var FloorMapWithLayoutProvider = {
   parameters: {
@@ -1531,8 +1531,8 @@ function LegendItem14131(_ref5) {
   }), label);
 }
 
-/**
- * Figma 设计稿效果 - 餐厅桌台状态图（顶部 Tab + 图例参考 node 14131:6266，内容区不变）
+/**
+ * Figma 设计稿效果 - 餐厅桌台状态图（顶部 Tab + 图例参考 node 14131:6266，内容区不变）
  */
 export var FigmaDesign = {
   parameters: {

package/es/components/pisellFloorMapLayout/components/FloorMapEditPanel.js

@@ -48,6 +48,7 @@ export function FloorMapEditPanel(props) {
     _props$dataSourceLabe = props.dataSourceLabels,
     dataSourceLabels = _props$dataSourceLabe === void 0 ? {} : _props$dataSourceLabe,
     layoutDraftDirty = props.layoutDraftDirty,
+    showRecordFormProp = props.showDataSourceRecordFormBlock,
     className = props.className;
   var _Form$useForm = Form.useForm(),
     _Form$useForm2 = _slicedToArray(_Form$useForm, 1),
@@ -196,6 +197,7 @@ export function FloorMapEditPanel(props) {
   var showDataBindingSection = bindingPolicy !== 'none';
   /** 仅在实际绑定到某一行时展示「数据源记录」，避免仅选数据源、recordId 为空时误展示空表单 */
   var showDataSourceRecordBlock = hasBoundDataRecord && Boolean(binding) && (onSaveRecord != null || hasCustomRecordForm);
+  var showDataRecordEditorSection = showRecordFormProp !== false && showDataSourceRecordBlock && Boolean(binding);
   var recordFormContext = useMemo(function () {
     if (!binding) return null;
     return {
@@ -217,8 +219,59 @@ export function FloorMapEditPanel(props) {
       layoutTransformLocked: !sceneElement.layoutTransformLocked
     });
   };
+  var panelScrollRef = useRef(null);
+  var dragScrollRef = useRef({
+    active: false,
+    pointerId: -1,
+    startY: 0,
+    startScrollTop: 0
+  });
+  var isDragScrollSurface = useCallback(function (target) {
+    if (!(target instanceof Element)) return false;
+    return !target.closest('input,textarea,button,select,.ant-select,.ant-input,[contenteditable="true"]');
+  }, []);
+  var handlePanelPointerDown = useCallback(function (e) {
+    if (!isDragScrollSurface(e.target)) return;
+    var el = panelScrollRef.current;
+    if (!el || el.scrollHeight <= el.clientHeight) return;
+    el.setPointerCapture(e.pointerId);
+    dragScrollRef.current = {
+      active: true,
+      pointerId: e.pointerId,
+      startY: e.clientY,
+      startScrollTop: el.scrollTop
+    };
+  }, [isDragScrollSurface]);
+  var handlePanelPointerMove = useCallback(function (e) {
+    var d = dragScrollRef.current;
+    if (!d.active || e.pointerId !== d.pointerId) return;
+    var el = panelScrollRef.current;
+    if (!el) return;
+    el.scrollTop = d.startScrollTop + (d.startY - e.clientY);
+  }, []);
+  var endPanelDragScroll = useCallback(function (e) {
+    var d = dragScrollRef.current;
+    if (!d.active || e.pointerId !== d.pointerId) return;
+    dragScrollRef.current = {
+      active: false,
+      pointerId: -1,
+      startY: 0,
+      startScrollTop: 0
+    };
+    try {
+      var _panelScrollRef$curre;
+      (_panelScrollRef$curre = panelScrollRef.current) === null || _panelScrollRef$curre === void 0 || _panelScrollRef$curre.releasePointerCapture(e.pointerId);
+    } catch (_unused) {
+      /* ignore */
+    }
+  }, []);
   return /*#__PURE__*/React.createElement("div", {
-    className: classNames("".concat(PREFIX, "-edit-panel"), className)
+    ref: panelScrollRef,
+    className: classNames("".concat(PREFIX, "-edit-panel"), className),
+    onPointerDown: handlePanelPointerDown,
+    onPointerMove: handlePanelPointerMove,
+    onPointerUp: endPanelDragScroll,
+    onPointerCancel: endPanelDragScroll
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-edit-panel-header")
   }, /*#__PURE__*/React.createElement("span", null, ep.elementProps), /*#__PURE__*/React.createElement(Button, {
@@ -409,7 +462,7 @@ export function FloorMapEditPanel(props) {
     }
   }), !hasBoundDataRecord && /*#__PURE__*/React.createElement("p", {
     className: "".concat(PREFIX, "-edit-panel-record-bind-hint")
-  }, ep.hintUnbound))), showDataSourceRecordBlock && binding && /*#__PURE__*/React.createElement("div", {
+  }, ep.hintUnbound))), showDataRecordEditorSection && binding && /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-edit-panel-record")
   }, /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-edit-panel-record-title")

package/es/components/pisellFloorMapLayout/components/FloorMapEditPanel.less

@@ -7,6 +7,7 @@
   box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
   max-height: 80vh;
   overflow-y: auto;
+  touch-action: pan-y;
 
   &-header {
     display: flex;

package/es/components/pisellFloorMapLayout/components/ItemLayer.js

@@ -10,9 +10,9 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
-/**
- * ItemLayer - 楼层图展示层
- * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
+/**
+ * ItemLayer - 楼层图展示层
+ * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
  */
 import React, { useMemo } from 'react';
 import classNames from 'classnames';
@@ -25,8 +25,8 @@ function getItemKey(item, index, rowKey) {
   return rowKey(item, index);
 }
 
-/**
- * 根据形状返回 item 容器的 style（clip-path / border-radius）
+/**
+ * 根据形状返回 item 容器的 style（clip-path / border-radius）
  */
 function getShapeStyle() {
   var shape = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'rect';

package/es/components/pisellFloorMapLayout/context/mergeFloorMapLayoutContext.js

@@ -8,7 +8,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  * 将 `FloorMapLayoutContext` 与 Layout props 合并：各字段 props ?? ctx，props 显式值优先。
  */
 export function mergeFloorMapLayoutPropsFromContext(props, ctx) {
-  var _props$floorMapConfig, _props$dataSources, _props$onSave, _props$onDataSourceRe, _props$dataSourceLabe, _props$dataSourceForm, _props$dataSourceReco, _props$loading, _props$saveError, _props$onElementRende, _props$toolbarShowSav, _props$floorMapFullsc;
+  var _props$floorMapConfig, _props$dataSources, _props$onSave, _props$onDataSourceRe, _props$dataSourceLabe, _props$dataSourceForm, _props$dataSourceReco, _props$loading, _props$saveError, _props$onElementRende, _props$toolbarShowSav, _props$floorMapFullsc, _props$showDataSource;
   if (ctx == null) return props;
   return _objectSpread(_objectSpread({}, props), {}, {
     floorMapConfig: (_props$floorMapConfig = props.floorMapConfig) !== null && _props$floorMapConfig !== void 0 ? _props$floorMapConfig : ctx.floorMapConfig,
@@ -22,6 +22,7 @@ export function mergeFloorMapLayoutPropsFromContext(props, ctx) {
     saveError: (_props$saveError = props.saveError) !== null && _props$saveError !== void 0 ? _props$saveError : ctx.saveError,
     onElementRenderError: (_props$onElementRende = props.onElementRenderError) !== null && _props$onElementRende !== void 0 ? _props$onElementRende : ctx.onElementRenderError,
     toolbarShowSave: (_props$toolbarShowSav = props.toolbarShowSave) !== null && _props$toolbarShowSav !== void 0 ? _props$toolbarShowSav : ctx.toolbarShowSave,
-    floorMapFullscreenMode: (_props$floorMapFullsc = props.floorMapFullscreenMode) !== null && _props$floorMapFullsc !== void 0 ? _props$floorMapFullsc : ctx.floorMapFullscreenMode
+    floorMapFullscreenMode: (_props$floorMapFullsc = props.floorMapFullscreenMode) !== null && _props$floorMapFullsc !== void 0 ? _props$floorMapFullsc : ctx.floorMapFullscreenMode,
+    showDataSourceRecordFormBlock: (_props$showDataSource = props.showDataSourceRecordFormBlock) !== null && _props$showDataSource !== void 0 ? _props$showDataSource : ctx.showDataSourceRecordFormBlock
   });
 }

package/es/components/pisellFloorMapLayout/hooks/useFloorMapEditState.d.ts

@@ -16,6 +16,7 @@ export interface UseFloorMapEditStateParams<T extends FloorMapItemBase> {
         x: number;
         y: number;
     }>;
+    showDataSourceRecordFormBlock?: boolean;
 }
 export declare function useFloorMapEditState<T extends FloorMapItemBase>(params: UseFloorMapEditStateParams<T>): {
     config: FloorMapViewConfig | null;
@@ -54,6 +55,7 @@ export declare function useFloorMapEditState<T extends FloorMapItemBase>(params:
         dataSourceRecordForm: Record<string, FloorMapDataSourceRecordFormContent> | undefined;
         dataSourceLabels: Record<string, string> | undefined;
         layoutDraftDirty: boolean;
+        showDataSourceRecordFormBlock: boolean | undefined;
     } | null;
     placeOverlayClass: string;
     isLayoutDirty: boolean;

package/es/components/pisellFloorMapLayout/hooks/useFloorMapEditState.js

@@ -58,7 +58,8 @@ export function useFloorMapEditState(params) {
     dataSourceRecordForm = params.dataSourceRecordForm,
     dataSourceLabels = params.dataSourceLabels,
     layoutPrefix = params.layoutPrefix,
-    contentOffsetRef = params.contentOffsetRef;
+    contentOffsetRef = params.contentOffsetRef,
+    showDataSourceRecordFormBlock = params.showDataSourceRecordFormBlock;
   var engineCtx = useEngineContext();
   var engineLocale = (engineCtx === null || engineCtx === void 0 || (_engineCtx$engine = engineCtx.engine) === null || _engineCtx$engine === void 0 || (_engineCtx$engine = _engineCtx$engine.props) === null || _engineCtx$engine === void 0 ? void 0 : _engineCtx$engine.locale) || 'zh-CN';
   var _useState = useState(null),
@@ -408,7 +409,8 @@ export function useFloorMapEditState(params) {
     recordFormColumns: dataSourceFormColumns,
     dataSourceRecordForm: dataSourceRecordForm,
     dataSourceLabels: dataSourceLabels,
-    layoutDraftDirty: isLayoutDirty
+    layoutDraftDirty: isLayoutDirty,
+    showDataSourceRecordFormBlock: showDataSourceRecordFormBlock
   } : null;
   return {
     config: config,

package/es/components/pisellFloorMapLayout/hooks/useFloorMapTransformMetrics.js

@@ -89,6 +89,7 @@ export function useFloorMapTransformMetrics(params) {
       return ro.disconnect();
     };
   }, []);
+  var autoFitOnMount = zoom.autoFitOnMount === true;
   var zoomConfig = useMemo(function () {
     var _zoom$defaultScale, _zoom$min, _zoom$max, _zoom$step;
     return {
@@ -172,6 +173,10 @@ export function useFloorMapTransformMetrics(params) {
         done: false
       };
     }
+    if (autoFitOnMount) {
+      initialAlignRef.current.done = true;
+      return;
+    }
     if (alignPadSingle == null) {
       initialAlignRef.current.done = false;
       return;
@@ -194,7 +199,7 @@ export function useFloorMapTransformMetrics(params) {
       cancelled = true;
       cancelAnimationFrame(raf);
     };
-  }, [isFloorMapView, frameResetKey, alignPadSingle, initialPositionX, initialPositionY, zoomConfig.initialScale, transformRef]);
+  }, [isFloorMapView, frameResetKey, alignPadSingle, initialPositionX, initialPositionY, zoomConfig.initialScale, transformRef, autoFitOnMount]);
   useEffect(function () {
     var el = containerRef.current;
     if (!el) return;
@@ -231,6 +236,42 @@ export function useFloorMapTransformMetrics(params) {
     var y = VIEWPORT_TOP_LEFT_MARGIN - padA * nextScale;
     ctx.setTransform(x, y, nextScale);
   }, [contentWidth, contentHeight, zoom.max, transformRef, alignPadSingle]);
+
+  /** autoFitOnMount：每画布一次 fitBounds（在 TransformWrapper 就绪后） */
+  var autoFitOnceRef = useRef({
+    frame: '',
+    done: false
+  });
+  useEffect(function () {
+    if (!isFloorMapView || !autoFitOnMount || frameResetKey === undefined) return;
+    var frame = String(frameResetKey);
+    if (autoFitOnceRef.current.frame !== frame) {
+      autoFitOnceRef.current = {
+        frame: frame,
+        done: false
+      };
+    }
+    if (autoFitOnceRef.current.done) return;
+    if (contentWidth <= 0 || contentHeight <= 0) return;
+    var cancelled = false;
+    var raf = 0;
+    var tick = function tick() {
+      if (cancelled) return;
+      var ctx = transformRef.current;
+      var container = containerRef.current;
+      if (!ctx || !(container !== null && container !== void 0 && container.querySelector('.react-transform-wrapper'))) {
+        raf = requestAnimationFrame(tick);
+        return;
+      }
+      fitBounds();
+      autoFitOnceRef.current.done = true;
+    };
+    raf = requestAnimationFrame(tick);
+    return function () {
+      cancelled = true;
+      cancelAnimationFrame(raf);
+    };
+  }, [isFloorMapView, autoFitOnMount, frameResetKey, contentWidth, contentHeight, fitBounds, transformRef]);
   var lastTransformRef = useRef({
     x: 0,
     y: 0,

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

@@ -81,6 +81,11 @@ export interface FloorMapZoomConfig {
     max?: number;
     /** 缩放步进，默认 0.1 (10%) */
     step?: number;
+    /**
+     * 为 true 时：挂载后每个画布（frameResetKey）自动执行一次 fitBounds，使图元落在视口内。
+     * 为 true 时跳过「首帧 defaultScale 左上对齐」，避免与 fit 闪动叠加。
+     */
+    autoFitOnMount?: boolean;
 }
 /**
  * 平移配置
@@ -377,6 +382,11 @@ export interface FloorMapEditPanelParams {
      * 用于提示用户点击顶部「保存」持久化布局草稿。
      */
     layoutDraftDirty?: boolean;
+    /**
+     * 为 false 时不渲染「数据绑定」下方的数据源记录编辑表单（FloorMapDataForm / 自定义 record 表单）；
+     * 数据绑定选数据源与选行仍可展示。
+     */
+    showDataSourceRecordFormBlock?: boolean;
 }
 /**
  * 合并当前画布的 sceneElements 为 items（用于 Layout 渲染）
@@ -400,7 +410,7 @@ export declare type FloorMapFullscreenMode = 'toggle' | 'locked' | 'disabled';
  * 平面图 Layout 注入上下文：数据、保存、侧栏表单与状态等（不包含 renderItem/mapLayer 等展示向 props）。
  * 由 `FloorMapLayoutProvider` / RecordBoard `floorMapLayoutContext` 提供，与 `PisellFloorMapLayout` props 按 `??` 合并，props 优先。
  */
-export declare type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode'>>;
+export declare type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'showDataSourceRecordFormBlock'>>;
 /**
  * PisellFloorMapLayout 组件 Props
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
@@ -527,6 +537,10 @@ export interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMap
      * 是否在左侧工具栏底部显示「保存」（默认 true；非全屏时顶栏为 Tab+全屏，保存多在侧栏；全屏时保存仅在顶栏）
      */
     toolbarShowSave?: boolean;
+    /**
+     * 为 false 时隐藏侧栏「数据源记录」表单区（保留数据绑定选源/选行）。
+     */
+    showDataSourceRecordFormBlock?: boolean;
 }
 /**
  * PisellFloorMapLayout Ref 方法
@@ -541,4 +555,6 @@ export interface PisellFloorMapLayoutRef {
     reset: () => void;
     /** 区域定位：使所有 items 落在视口内 */
     fitBounds: () => void;
+    /** 提交当前布局草稿（与顶栏/侧栏「保存」一致） */
+    saveLayout: () => void;
 }

package/es/components/pisellHierarchicalSummaryList/hooks/useExpandedKeys.js

@@ -5,8 +5,8 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useCallback, useMemo, useState } from 'react';
-/**
- * 展开态管理（兼容受控/非受控）。
+/**
+ * 展开态管理（兼容受控/非受控）。
  */
 export function useExpandedKeys(options) {
   var expandedKeys = options.expandedKeys,

package/es/components/pisellHierarchicalSummaryList/index.js

@@ -1,5 +1,5 @@
-/**
- * PisellHierarchicalSummaryList 组件导出
+/**
+ * PisellHierarchicalSummaryList 组件导出
  */
 
 export { PisellHierarchicalSummaryList, PREFIX_CLS as HIERARCHICAL_SUMMARY_LIST_PREFIX_CLS } from "./PisellHierarchicalSummaryList";

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", "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,7 @@ function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
     floorMapProps: undefined,
     floorMapLayoutContext: undefined,
     defaultBodyView: undefined,
+    floorMapLayoutRef: undefined,
     dataSources: undefined,
     gridDataSourceKey: undefined
   };
@@ -104,6 +115,8 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     floorMapProp = props.floorMap,
     floorMapLayoutContextProp = props.floorMapLayoutContext,
     defaultBodyView = props.defaultBodyView,
+    bodyViewStorageKey = props.bodyViewStorageKey,
+    floorMapLayoutRef = props.floorMapLayoutRef,
     classNameProp = props.className,
     styleProp = props.style,
     rest = _objectWithoutProperties(props, _excluded);
@@ -134,11 +147,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 +300,10 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       setBodyView: setBodyView,
       floorMapProps: floorMapProp,
       floorMapLayoutContext: floorMapLayoutContextProp,
-      defaultBodyView: defaultBodyView
+      defaultBodyView: defaultBodyView,
+      floorMapLayoutRef: floorMapLayoutRef
     });
-  }, [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, bodyView, setBodyView]);
   var content = /*#__PURE__*/React.createElement(RecordBoardProvider, {
     value: contextValue
   }, children);