@pisell/materials 1.8.24 → 1.8.25

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -17,7 +17,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
  */
 import React, { useMemo, useRef, useImperativeHandle, useCallback, useState, useEffect } from 'react';
 import classNames from 'classnames';
-import { FullscreenExitOutlined, FullscreenOutlined } from '@ant-design/icons';
+import { theme } from 'antd';
 import { TransformWrapper, TransformComponent } from 'react-zoom-pan-pinch';
 import MapLayer from "./components/MapLayer";
 import ItemLayer from "./components/ItemLayer";
@@ -85,7 +85,10 @@ function PisellFloorMapLayoutInner(props, ref) {
     floorMapFullscreenMode = p.floorMapFullscreenMode,
     showDataSourceRecordFormBlock = p.showDataSourceRecordFormBlock,
     floorMapViewportOverlay = p.floorMapViewportOverlay,
-    canvasTabsBarTrailing = p.canvasTabsBarTrailing;
+    canvasTabsBarTrailing = p.canvasTabsBarTrailing,
+    viewportDockTrailing = p.viewportDockTrailing;
+  var _theme$useToken = theme.useToken(),
+    token = _theme$useToken.token;
   var isFloorMapView = Boolean(floorMapConfigProp);
   var contentOffsetRef = useRef({
     x: 0,
@@ -128,7 +131,10 @@ function PisellFloorMapLayoutInner(props, ref) {
     editPanelParams = edit.editPanelParams,
     placeOverlayClass = edit.placeOverlayClass,
     isLayoutDirty = edit.isLayoutDirty,
-    toggleDraftCanvasShowGrid = edit.toggleDraftCanvasShowGrid;
+    toggleDraftCanvasShowGrid = edit.toggleDraftCanvasShowGrid,
+    toggleSelectedLayoutLock = edit.toggleSelectedLayoutLock,
+    duplicateSelectedElement = edit.duplicateSelectedElement,
+    deleteSelectedElement = edit.deleteSelectedElement;
   var effectiveMapLayer = useMemo(function () {
     var _canvas$mapLayer;
     if (!isFloorMapView || !config || !currentCanvasId) {
@@ -157,30 +163,56 @@ function PisellFloorMapLayoutInner(props, ref) {
   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 hasCanvasTabsBarTrailing = canvasTabsBarTrailing != null && canvasTabsBarTrailing !== false;
+  var enabledCanvasCount = useMemo(function () {
+    return canvasesForTabs.filter(function (c) {
+      return c.enabled;
+    }).length;
+  }, [canvasesForTabs]);
   var showReadModeCanvasTabsBar = useMemo(function () {
     if (!isFloorMapView || mode !== 'read' || !config) return false;
     if (hasCanvasTabsBarTrailing) return true;
-    return canvasesForTabs.filter(function (c) {
-      return c.enabled;
-    }).length > 1;
-  }, [isFloorMapView, mode, config, canvasesForTabs, hasCanvasTabsBarTrailing]);
+    return enabledCanvasCount > 1;
+  }, [isFloorMapView, mode, config, hasCanvasTabsBarTrailing, enabledCanvasCount]);
   var readCanvasTabsAriaLabel = useMemo(function () {
     initFloorMapLayoutLocales(engineLocale);
     return locales.getText('pisell-floor-map-layout.read-canvas-tabs.aria');
   }, [engineLocale]);
-  var readCanvasTabsFsLabels = useMemo(function () {
-    initFloorMapLayoutLocales(engineLocale);
-    return {
-      fsEnterAria: locales.getText('pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria'),
-      fsEnterTitle: locales.getText('pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title'),
-      fsExitAria: locales.getText('pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria'),
-      fsExitTitle: locales.getText('pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title')
-    };
-  }, [engineLocale]);
+
+  /** 编辑态始终保留顶栏 Tab（单画布也要能「添加画布」）；仅阅读态在单画布时可隐藏 Tab 行 */
+  var showEditCompactTopBar = isFloorMapView && mode === 'edit' && Boolean(config) && !useFullTopChrome;
   var loadingLabel = useMemo(function () {
     initFloorMapLayoutLocales(engineLocale);
     return locales.getText('pisell-floor-map-layout.loading');
   }, [engineLocale]);
+
+  /** 选中图元旁：锁定（与侧栏同字段）/ 复制 / 删除；锁定时不展开右侧属性面板 */
+  var editQuickBar = useMemo(function () {
+    if (!isFloorMapView || mode !== 'edit' || !(config !== null && config !== void 0 && config.canvasUi.canEdit) || !selectedId) {
+      return null;
+    }
+    initFloorMapLayoutLocales(engineLocale);
+    var row = items.find(function (i) {
+      return i.id === selectedId;
+    });
+    if (!(row !== null && row !== void 0 && row._sceneElement)) return null;
+    return {
+      labels: {
+        lock: locales.getText('pisell-floor-map-layout.edit-quick.lock'),
+        unlock: locales.getText('pisell-floor-map-layout.edit-quick.unlock'),
+        duplicate: locales.getText('pisell-floor-map-layout.edit-quick.duplicate'),
+        delete: locales.getText('pisell-floor-map-layout.edit-quick.delete'),
+        popTitle: locales.getText('pisell-floor-map-layout.edit-panel.pop-title'),
+        popDesc: locales.getText('pisell-floor-map-layout.edit-panel.pop-desc'),
+        cancel: locales.getText('pisell-floor-map-layout.edit-panel.btn-cancel'),
+        okDelete: locales.getText('pisell-floor-map-layout.edit-panel.btn-ok-delete'),
+        ariaToolbar: locales.getText('pisell-floor-map-layout.edit-quick.aria-toolbar')
+      },
+      isLocked: Boolean(row._sceneElement.layoutTransformLocked),
+      onToggleLock: toggleSelectedLayoutLock,
+      onDuplicate: duplicateSelectedElement,
+      onDelete: deleteSelectedElement
+    };
+  }, [isFloorMapView, mode, config === null || config === void 0 ? void 0 : config.canvasUi.canEdit, selectedId, items, engineLocale, toggleSelectedLayoutLock, duplicateSelectedElement, deleteSelectedElement]);
   var cellSize = cellSizeProp !== null && cellSizeProp !== void 0 ? cellSizeProp : DEFAULT_CELL_SIZE;
   var itemGap = useMemo(function () {
     return gapToPx(effectiveMapLayer === null || effectiveMapLayer === void 0 ? void 0 : effectiveMapLayer.gap);
@@ -221,15 +253,15 @@ function PisellFloorMapLayoutInner(props, ref) {
   /** 编辑态全屏策略：toggle 可切换；locked 始终全屏顶栏且不可在组件内退出；disabled 无全屏按钮 */
   var fsMode = floorMapFullscreenMode !== null && floorMapFullscreenMode !== void 0 ? floorMapFullscreenMode : 'toggle';
   var useFullTopChrome = isFloorMapView && mode === 'edit' && (fsMode === 'locked' || fsMode === 'toggle' && isFullscreen);
-  /** 仅 toggle 时向顶栏/控件传入，避免 locked/disabled 误显全屏按钮 */
-  var editToggleFullscreen = fsMode === 'toggle' ? toggleFullscreen : undefined;
-  var readToggleFullscreen = isFloorMapView && mode === 'read' && fsMode === 'toggle' ? toggleFullscreen : undefined;
+  /** toggle 时左下 Dock 展示全屏；locked/disabled 不传 API */
+  var dockToggleFullscreen = isFloorMapView && fsMode === 'toggle' ? toggleFullscreen : undefined;
   var viewControlsConfig = useMemo(function () {
-    if (!isFloorMapView || mode !== 'edit') return controls;
+    var _controls$showFullscr;
+    if (!isFloorMapView) return controls;
     return _objectSpread(_objectSpread({}, controls), {}, {
-      showFullscreen: false
+      showFullscreen: (_controls$showFullscr = controls.showFullscreen) !== null && _controls$showFullscr !== void 0 ? _controls$showFullscr : Boolean(dockToggleFullscreen)
     });
-  }, [isFloorMapView, mode, controls]);
+  }, [isFloorMapView, controls, dockToggleFullscreen]);
   var topBarExtraActions = null;
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
@@ -334,16 +366,19 @@ function PisellFloorMapLayoutInner(props, ref) {
     };
   }, [fitBounds, handleSave]);
   var showSidebar = isFloorMapView && mode === 'edit' && config && dataSources;
+
+  /** 右侧属性面板打开时给画布区留空，避免落点被挡在面板下 */
+  var editPanelVisible = isFloorMapView && mode === 'edit' && Boolean(editPanelParams) && Boolean(config) && Boolean(dataSources);
   return /*#__PURE__*/React.createElement("div", {
     ref: containerRef,
     className: classNames(PREFIX, className, _defineProperty(_defineProperty({}, "".concat(PREFIX, "-floor-map-view"), isFloorMapView), "".concat(PREFIX, "-mode-edit"), isFloorMapView && mode === 'edit')),
-    style: _objectSpread(_objectSpread({
+    style: _objectSpread(_objectSpread(_objectSpread({
       display: 'flex',
       flexDirection: 'column'
     }, isFloorMapView ? {
       minHeight: 0
-    } : {}), style)
-  }, isFloorMapView && mode === 'edit' && config && !useFullTopChrome && /*#__PURE__*/React.createElement(FloorMapEditTopBar, {
+    } : {}), isFloorMapView ? _defineProperty({}, '--fmap-primary', token.colorPrimary) : {}), style)
+  }, showEditCompactTopBar && !useFullTopChrome && /*#__PURE__*/React.createElement(FloorMapEditTopBar, {
     mode: "compact",
     config: config,
     canvases: canvasesForTabs,
@@ -356,8 +391,6 @@ function PisellFloorMapLayoutInner(props, ref) {
     onAddCanvas: handleAddCanvas,
     onRemoveCanvas: handleRemoveCanvas,
     onRenameCanvas: handleRenameCanvas,
-    toggleFullscreen: editToggleFullscreen,
-    isFullscreen: false,
     controls: controls,
     canvasTabsBarTrailing: canvasTabsBarTrailing
   }), isFloorMapView && mode === 'edit' && config && useFullTopChrome && /*#__PURE__*/React.createElement(FloorMapEditTopBar, {
@@ -377,7 +410,6 @@ function PisellFloorMapLayoutInner(props, ref) {
     saving: saving,
     saveError: saveError,
     layoutDirty: isLayoutDirty,
-    toggleFullscreen: editToggleFullscreen,
     isFullscreen: isFullscreen,
     controls: controls,
     extraActions: topBarExtraActions,
@@ -397,17 +429,9 @@ function PisellFloorMapLayoutInner(props, ref) {
     },
     canEdit: false,
     className: "".concat(PREFIX, "-edit-top-bar-canvas-tabs")
-  })), hasCanvasTabsBarTrailing || readToggleFullscreen ? /*#__PURE__*/React.createElement("div", {
+  })), hasCanvasTabsBarTrailing ? /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-edit-top-bar-actions")
-  }, canvasTabsBarTrailing, readToggleFullscreen ? /*#__PURE__*/React.createElement("button", {
-    type: "button",
-    className: classNames("".concat(PREFIX, "-edit-top-bar-btn"), "".concat(PREFIX, "-edit-top-bar-btn-ghost")),
-    onClick: function onClick() {
-      return readToggleFullscreen();
-    },
-    "aria-label": isFullscreen ? readCanvasTabsFsLabels.fsExitAria : readCanvasTabsFsLabels.fsEnterAria,
-    title: isFullscreen ? readCanvasTabsFsLabels.fsExitTitle : readCanvasTabsFsLabels.fsEnterTitle
-  }, isFullscreen ? /*#__PURE__*/React.createElement(FullscreenExitOutlined, null) : /*#__PURE__*/React.createElement(FullscreenOutlined, null)) : null) : null), loading && /*#__PURE__*/React.createElement("div", {
+  }, canvasTabsBarTrailing) : null), loading && /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-loading")
   }, /*#__PURE__*/React.createElement("span", null, loadingLabel)), saveError && !(isFloorMapView && mode === 'edit' && config) && /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-save-error")
@@ -434,7 +458,7 @@ function PisellFloorMapLayoutInner(props, ref) {
       height: 120
     },
     decorationPreviewSize: 48,
-    onSave: onSave && config.canvasUi.canEdit && (!useFullTopChrome && toolbarShowSave !== false || useFullTopChrome && isFullscreen) ? handleSave : undefined,
+    onSave: onSave && config.canvasUi.canEdit && !useFullTopChrome && toolbarShowSave !== false ? handleSave : undefined,
     saving: saving,
     saveError: saveError,
     layoutDirty: isLayoutDirty,
@@ -442,7 +466,7 @@ function PisellFloorMapLayoutInner(props, ref) {
     consumeToolbarClickIfTouchDrag: paletteTouchDrag.consumeToolbarClickIfTouchDrag
   }), /*#__PURE__*/React.createElement("div", {
     ref: mapAreaRef,
-    className: showSidebar ? "".concat(PREFIX, "-map-area") : undefined,
+    className: classNames(showSidebar && "".concat(PREFIX, "-map-area"), editPanelVisible && "".concat(PREFIX, "-map-area--edit-panel-inset")),
     style: {
       flex: 1,
       position: 'relative',
@@ -538,7 +562,8 @@ function PisellFloorMapLayoutInner(props, ref) {
       snapStep: (_effectiveMapLayer$sn = effectiveMapLayer === null || effectiveMapLayer === void 0 ? void 0 : effectiveMapLayer.snapStep) !== null && _effectiveMapLayer$sn !== void 0 ? _effectiveMapLayer$sn : 0,
       scale: scale,
       onInteractionChange: setIsInteractingWithElement,
-      getMergedItemWrapperStyle: getMergedItemWrapperStyle
+      getMergedItemWrapperStyle: getMergedItemWrapperStyle,
+      editQuickBar: editQuickBar
     }) : /*#__PURE__*/React.createElement(ItemLayer, {
       items: items,
       renderItem: effectiveRenderItem,
@@ -551,6 +576,7 @@ function PisellFloorMapLayoutInner(props, ref) {
       contentOffsetX: contentOffsetX,
       contentOffsetY: contentOffsetY,
       enableHover: enableHover,
+      itemHoverOutline: true,
       onItemClick: handleItemClick,
       onItemHover: onItemHover,
       onItemLeave: onItemLeave,
@@ -580,9 +606,12 @@ function PisellFloorMapLayoutInner(props, ref) {
       scale: scale,
       isFullscreen: isFullscreen,
       fitBounds: fitBounds,
-      toggleFullscreen: editToggleFullscreen,
+      toggleFullscreen: dockToggleFullscreen,
       mapGridVisible: Boolean(effectiveMapLayer === null || effectiveMapLayer === void 0 ? void 0 : effectiveMapLayer.showGrid),
-      onToggleMapGrid: isFloorMapView ? toggleDraftCanvasShowGrid : undefined
+      onToggleMapGrid: isFloorMapView ? toggleDraftCanvasShowGrid : undefined,
+      dockChrome: isFloorMapView,
+      dockExpandedTrailing: viewportDockTrailing,
+      autoCollapseDockMs: 10000
     }), isFloorMapView && floorMapViewportOverlay != null ? /*#__PURE__*/React.createElement("div", {
       className: "".concat(PREFIX, "-viewport-overlay")
     }, typeof floorMapViewportOverlay === 'function' ? floorMapViewportOverlay({

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.less

@@ -70,8 +70,10 @@
     &-active {
       pointer-events: auto;
       z-index: 100;
-      box-shadow: inset 0 0 0 2px #1677ff;
-      background: rgba(22, 119, 255, 0.06);
+      box-shadow: inset 0 0 0 2px var(--fmap-primary, #1677ff);
+      background: color-mix(in srgb,
+      var(--fmap-primary, #1677ff) 6%,
+      transparent);
     }
   }
 
@@ -89,4 +91,14 @@
       pointer-events: auto;
     }
   }
+
+  /** 编辑态：画布区域（含 Transform）为右侧 FloorMapEditPanel 预留宽度 */
+
+  &-map-area {
+    box-sizing: border-box;
+
+    &--edit-panel-inset {
+      padding-right: 336px;
+    }
+  }
 }

package/es/components/pisellFloorMapLayout/components/CanvasTabs.less

@@ -34,14 +34,14 @@
     }
 
     &-active {
-      color: #1677ff;
+      color: var(--fmap-primary, #1677ff);
       font-weight: 600;
       background: #fff;
       box-shadow: 0 1px 2px rgba(0, 0, 0, 0.06),
       0 0 0 1px rgba(0, 0, 0, 0.04);
 
       &:hover {
-        color: #1677ff;
+        color: var(--fmap-primary, #1677ff);
         background: #fff;
       }
     }
@@ -55,7 +55,7 @@
       color: rgba(0, 0, 0, 0.45);
 
       .pisell-floor-map-layout-canvas-tabs-tab-active & {
-        color: rgba(22, 119, 255, 0.85);
+        color: color-mix(in srgb, var(--fmap-primary, #1677ff) 85%, transparent);
       }
     }
 
@@ -68,14 +68,14 @@
       line-height: 1.4;
       color: #262626;
       background: #fff;
-      border: 1px solid #1677ff;
+      border: 1px solid var(--fmap-primary, #1677ff);
       border-radius: 6px;
       outline: none;
       box-sizing: border-box;
 
       &:focus {
-        border-color: #1677ff;
-        box-shadow: 0 0 0 2px rgba(22, 119, 255, 0.2);
+        border-color: var(--fmap-primary, #1677ff);
+        box-shadow: 0 0 0 2px color-mix(in srgb, var(--fmap-primary, #1677ff) 20%, transparent);
       }
     }
 
@@ -100,19 +100,19 @@
       -webkit-tap-highlight-color: transparent;
 
       &:hover {
-        color: #1677ff;
-        background: rgba(22, 119, 255, 0.08);
+        color: var(--fmap-primary, #1677ff);
+        background: color-mix(in srgb, var(--fmap-primary, #1677ff) 8%, transparent);
       }
 
       &:active {
-        background: rgba(22, 119, 255, 0.14);
+        background: color-mix(in srgb, var(--fmap-primary, #1677ff) 14%, transparent);
       }
 
       .pisell-floor-map-layout-canvas-tabs-tab-active & {
-        color: rgba(22, 119, 255, 0.85);
+        color: color-mix(in srgb, var(--fmap-primary, #1677ff) 85%, transparent);
 
         &:hover {
-          color: #1677ff;
+          color: var(--fmap-primary, #1677ff);
         }
       }
     }
@@ -161,9 +161,9 @@
     padding: 7px 12px;
     font-size: 13px;
     font-weight: 500;
-    color: #1677ff;
+    color: var(--fmap-primary, #1677ff);
     background: rgba(255, 255, 255, 0.7);
-    border: 1px dashed rgba(22, 119, 255, 0.35);
+    border: 1px dashed color-mix(in srgb, var(--fmap-primary, #1677ff) 35%, transparent);
     border-radius: 8px;
     cursor: pointer;
     transition: color 0.2s,

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

@@ -0,0 +1,46 @@
+/**
+ * EditableItemLayer - 编辑态图元层：拖拽、缩放、选中、吸附
+ */
+import React, { type CSSProperties } from 'react';
+import type { FloorMapItemBase, FloorMapMergedItem, FloorMapRenderOptions } from '../types';
+import { type FloorMapEditQuickActionLabels } from './FloorMapEditQuickActions';
+import './EditableItemLayer.less';
+export interface EditableItemLayerProps<T extends FloorMapItemBase = FloorMapMergedItem> {
+    items: T[];
+    renderItem: (item: T, index: number, options?: FloorMapRenderOptions) => React.ReactNode;
+    rowKey?: string | ((item: T, index: number) => string);
+    cellSize: number;
+    itemUnit?: 'cell' | 'pixel';
+    itemGap?: number;
+    contentWidth: number;
+    contentHeight: number;
+    /** 内容区 X/Y 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
+    contentOffsetX?: number;
+    contentOffsetY?: number;
+    selectedId: string | null;
+    onSelect: (id: string | null) => void;
+    onUpdateItem: (itemId: string, patch: Partial<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>) => void;
+    snapStep?: number;
+    /** 画布当前缩放，用于将屏幕位移转为内容位移 */
+    scale?: number;
+    /** 拖拽/缩放图元时通知父组件，用于禁用画布平移，避免松手时画布跟着动 */
+    onInteractionChange?: (active: boolean) => void;
+    /** 每项外层容器额外样式（与定位样式合并） */
+    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
+    className?: string;
+    /** 编辑态选中时图元旁快捷栏（上锁 / 复制 / 删除） */
+    editQuickBar?: {
+        labels: FloorMapEditQuickActionLabels;
+        isLocked: boolean;
+        onToggleLock: () => void;
+        onDuplicate: () => void;
+        onDelete: () => void;
+    } | null;
+}
+export declare function EditableItemLayer<T extends FloorMapItemBase>(props: EditableItemLayerProps<T>): JSX.Element;
+export default EditableItemLayer;

package/es/components/pisellFloorMapLayout/components/EditableItemLayer.js

@@ -24,10 +24,13 @@ function isSceneLayoutTransformLocked(item) {
   return Boolean((_item$_sceneElement = item._sceneElement) === null || _item$_sceneElement === void 0 ? void 0 : _item$_sceneElement.layoutTransformLocked);
 }
 import { snapRect } from "../utils/snap";
+import { FloorMapEditQuickActions } from "./FloorMapEditQuickActions";
 import "./EditableItemLayer.less";
 var PREFIX = 'pisell-floor-map-layout';
 var DRAG_THRESHOLD = 4;
 var RESIZE_HANDLE_SIZE = 8;
+/** 选中图元抬升到该层级，保证快捷栏与缩放点不被其它图元（任意 item.zIndex）遮住 */
+var SELECTED_ITEM_STACK_Z = 1000000;
 function getItemKey(item, index, rowKey) {
   var _rowKey;
   if (!rowKey) return item.id;
@@ -73,7 +76,8 @@ export function EditableItemLayer(props) {
     scale = _props$scale === void 0 ? 1 : _props$scale,
     onInteractionChange = props.onInteractionChange,
     getMergedItemWrapperStyle = props.getMergedItemWrapperStyle,
-    className = props.className;
+    className = props.className,
+    editQuickBar = props.editQuickBar;
   var contentRef = useRef(null);
   var liveRectRef = useRef(null);
   var _useState = useState(null),
@@ -170,8 +174,9 @@ export function EditableItemLayer(props) {
       startItemY: style.top
     });
   }, [items, getItemStyle, onInteractionChange]);
-  var handleCanvasClick = useCallback(function (e) {
-    if (e.target === e.currentTarget) onSelect(null);
+  var handleCanvasHitClick = useCallback(function (e) {
+    if (e.target !== e.currentTarget) return;
+    onSelect(null);
   }, [onSelect]);
   React.useEffect(function () {
     if (!interaction) return;
@@ -273,24 +278,27 @@ export function EditableItemLayer(props) {
       return ((_a$zIndex = a.zIndex) !== null && _a$zIndex !== void 0 ? _a$zIndex : 0) - ((_b$zIndex = b.zIndex) !== null && _b$zIndex !== void 0 ? _b$zIndex : 0);
     });
     return sorted.map(function (item, index) {
-      var _item$zIndex;
+      var _item$zIndex, _item$zIndex2;
       var key = getItemKey(item, index, rowKey);
       var merged = item;
       var style = getItemStyle(item, index);
       var shapeStyle = getShapeStyle(item.shape);
       var isSelected = selectedId === item.id;
+      var wrapperStyle = getMergedItemWrapperStyle === null || getMergedItemWrapperStyle === void 0 ? void 0 : getMergedItemWrapperStyle(item, index);
+      var baseZ = (wrapperStyle === null || wrapperStyle === void 0 ? void 0 : wrapperStyle.zIndex) !== undefined ? wrapperStyle.zIndex : (_item$zIndex = item.zIndex) !== null && _item$zIndex !== void 0 ? _item$zIndex : 0;
       return /*#__PURE__*/React.createElement("div", {
         key: key,
-        className: classNames("".concat(PREFIX, "-editable-item"), _defineProperty({}, "".concat(PREFIX, "-editable-item-selected"), isSelected)),
-        style: _objectSpread(_objectSpread({
+        className: classNames("".concat(PREFIX, "-editable-item"), _defineProperty(_defineProperty({}, "".concat(PREFIX, "-editable-item-selected"), isSelected), "".concat(PREFIX, "-editable-item-selected-lock"), isSelected && isSceneLayoutTransformLocked(merged))),
+        style: _objectSpread(_objectSpread(_objectSpread({
           position: 'absolute',
           left: style.left,
           top: style.top,
           width: style.width,
           height: style.height,
-          boxSizing: 'border-box',
-          zIndex: (_item$zIndex = item.zIndex) !== null && _item$zIndex !== void 0 ? _item$zIndex : 0
-        }, shapeStyle), getMergedItemWrapperStyle === null || getMergedItemWrapperStyle === void 0 ? void 0 : getMergedItemWrapperStyle(item, index)),
+          boxSizing: 'border-box'
+        }, shapeStyle), wrapperStyle), {}, {
+          zIndex: isSelected ? SELECTED_ITEM_STACK_Z + ((_item$zIndex2 = item.zIndex) !== null && _item$zIndex2 !== void 0 ? _item$zIndex2 : 0) : baseZ
+        }),
         onPointerDown: function onPointerDown(e) {
           return handlePointerDown(e, item, index);
         },
@@ -310,9 +318,20 @@ export function EditableItemLayer(props) {
             position: 'absolute'
           }
         });
-      })));
+      })), isSelected && editQuickBar ? /*#__PURE__*/React.createElement(FloorMapEditQuickActions, {
+        labels: editQuickBar.labels,
+        isLocked: editQuickBar.isLocked,
+        onToggleLock: editQuickBar.onToggleLock,
+        onDuplicate: editQuickBar.onDuplicate,
+        onDelete: editQuickBar.onDelete
+      }) : null);
     });
-  }, [items, renderItem, rowKey, getItemStyle, selectedId, handlePointerDown, handleItemClick, handleResizePointerDown, getMergedItemWrapperStyle]);
+  }, [items, renderItem, rowKey, getItemStyle, selectedId, handlePointerDown, handleItemClick, handleResizePointerDown, getMergedItemWrapperStyle, editQuickBar]);
+  var canvasHitLayer = /*#__PURE__*/React.createElement("div", {
+    className: "".concat(PREFIX, "-editable-canvas-hit"),
+    onClick: handleCanvasHitClick,
+    "aria-hidden": true
+  });
   return /*#__PURE__*/React.createElement("div", {
     ref: contentRef,
     className: classNames("".concat(PREFIX, "-editable-item-layer"), className),
@@ -324,8 +343,7 @@ export function EditableItemLayer(props) {
       height: contentHeight,
       minWidth: contentWidth,
       minHeight: contentHeight
-    },
-    onClick: handleCanvasClick
+    }
   }, contentOffsetX !== 0 || contentOffsetY !== 0 ? /*#__PURE__*/React.createElement("div", {
     style: {
       position: 'absolute',
@@ -334,8 +352,7 @@ export function EditableItemLayer(props) {
       width: contentWidth,
       height: contentHeight,
       transform: "translate(".concat(contentOffsetX, "px, ").concat(contentOffsetY, "px)")
-    },
-    onClick: handleCanvasClick
-  }, itemNodes) : itemNodes);
+    }
+  }, canvasHitLayer, itemNodes) : /*#__PURE__*/React.createElement(React.Fragment, null, canvasHitLayer, itemNodes));
 }
 export default EditableItemLayer;

package/es/components/pisellFloorMapLayout/components/EditableItemLayer.less

@@ -1,9 +1,21 @@
-/* 根节点不拦截事件，空白区域 mousedown 可透传到下层，让 react-zoom-pan-pinch 正常平移画布 */
+/* 根节点不拦截事件；空白处点击由 .editable-canvas-hit 承接（显式 pointer-events: auto），以免继承 none */
 .pisell-floor-map-layout-editable-item-layer {
   cursor: default;
   pointer-events: none;
 }
 
+/** 铺满内容区、叠在图元之下，用于点击空白取消选中；不参与拖拽图元 */
+.pisell-floor-map-layout-editable-canvas-hit {
+  position: absolute;
+  left: 0;
+  top: 0;
+  box-sizing: border-box;
+  width: 100%;
+  height: 100%;
+  z-index: 0;
+  pointer-events: auto;
+}
+
 .pisell-floor-map-layout-editable-item {
   cursor: move;
   outline: none;
@@ -12,14 +24,25 @@
   touch-action: none;
 
   &-selected {
-    box-shadow: 0 0 0 2px #1677ff;
-    z-index: 2;
+    /* 实际层级由 TSX 内联 zIndex（SELECTED_ITEM_STACK_Z + item.zIndex）控制 */
+    outline: 3px solid var(--fmap-primary, #1677ff);
+    outline-offset: 0;
+    box-shadow: 0 0 0 1px color-mix(in srgb, var(--fmap-primary, #1677ff) 25%, transparent);
+  }
+
+  /** 已锁定：选中描边改为警告色，与未锁定区分 */
+
+  &-selected-lock {
+    outline-color: #d48806;
+    box-shadow: 0 0 0 1px rgba(212, 136, 6, 0.28);
   }
 
   &-inner {
     width: 100%;
     height: 100%;
     pointer-events: none;
+    overflow: hidden;
+    border-radius: inherit;
   }
 }
 
@@ -27,7 +50,7 @@
   width: 10px;
   height: 10px;
   margin: -5px;
-  background: #1677ff;
+  background: var(--fmap-primary, #1677ff);
   border: 1px solid #fff;
   border-radius: 2px;
   cursor: nwse-resize;
@@ -87,3 +110,48 @@
     cursor: ew-resize;
   }
 }
+
+.pisell-floor-map-layout-edit-quick-actions {
+  position: absolute;
+  left: 50%;
+  top: 100%;
+  transform: translate(-50%, 10px);
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 10px 12px;
+  background: #fff;
+  border-radius: 12px;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.12);
+  border: 1px solid #e8eaed;
+  /* 高于同图元内缩放点 (3)，并贴近选中项栈顶，避免被内部子 stacking 盖住 */
+  z-index: 100000;
+  pointer-events: auto;
+  touch-action: manipulation;
+
+  &--locked {
+    border-color: rgba(212, 136, 6, 0.45);
+    background: #fffbf0;
+  }
+
+  /* 无边框、更大图标按钮（antd 类名在运行环境可能为 pisell-lowcode-*） */
+
+  .pisell-lowcode-btn,
+  .ant-btn {
+    width: 44px;
+    height: 44px;
+    min-width: 44px;
+    padding: 0;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    border: none !important;
+    box-shadow: none !important;
+    line-height: 1;
+
+    .pisell-lowcode-btn-icon,
+    .anticon {
+      font-size: 22px;
+    }
+  }
+}

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

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+export interface FloorMapEditQuickActionLabels {
+    lock: string;
+    unlock: string;
+    duplicate: string;
+    delete: string;
+    popTitle: string;
+    popDesc: string;
+    cancel: string;
+    okDelete: string;
+    ariaToolbar: string;
+}
+export interface FloorMapEditQuickActionsProps {
+    className?: string;
+    labels: FloorMapEditQuickActionLabels;
+    isLocked: boolean;
+    onToggleLock: () => void;
+    onDuplicate: () => void;
+    onDelete: () => void;
+}
+export declare function FloorMapEditQuickActions(props: FloorMapEditQuickActionsProps): JSX.Element;