@pisell/materials 1.8.24 → 1.8.26

package/lib/components/pisellDateTimeDisplay/utils/getRefreshInterval.d.ts

@@ -0,0 +1,18 @@
+import type { TimeFormatConfig } from '../types';
+/**
+ * 根据时间格式配置计算刷新间隔
+ * @param timeFormat 时间格式配置
+ * @returns 刷新间隔（毫秒）
+ *
+ * @description
+ * - 显示秒时：1000ms (1秒刷新一次)
+ * - 不显示秒时：60000ms (60秒刷新一次)
+ *
+ * @example
+ * getRefreshInterval({ showSeconds: true })
+ * // => 1000
+ *
+ * getRefreshInterval({ showSeconds: false })
+ * // => 60000
+ */
+export declare function getRefreshInterval(timeFormat?: TimeFormatConfig): number;

package/lib/components/pisellDraggable/components/Remove/Remove.d.ts

@@ -1,3 +1,3 @@
-/// <reference types="react" />
+import React from 'react';
 import { ActionProps } from '../Action';
-export declare function Remove(props: ActionProps): JSX.Element;
+export declare function Remove(props: ActionProps): React.JSX.Element;

package/lib/components/pisellDraggable/components/TreeItem/SortableTreeItem.d.ts

@@ -5,5 +5,5 @@ interface Props extends TreeItemProps {
     id: UniqueIdentifier;
     __designMode?: string;
 }
-declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => React.JSX.Element>;
 export default _default;

package/lib/components/pisellDraggable/index.d.ts

@@ -30,6 +30,6 @@ interface Props {
     /** 自定义拖拽判断函数，返回false时阻止拖拽 */
     canDrop?: (dragItem: FlattenedItem, dropTarget: FlattenedItem, parentId: UniqueIdentifier | null, parentNode: any) => boolean;
 }
-export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): JSX.Element;
-declare const Demo: (props: Props) => JSX.Element;
+export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): React.JSX.Element;
+declare const Demo: (props: Props) => React.JSX.Element;
 export default Demo;

package/lib/components/pisellDropSort/components/SortableItem/index.d.ts

@@ -22,5 +22,5 @@ interface SortableItemProps {
     /** 获取item样式 */
     getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
 }
-declare const SortableItem: (props: SortableItemProps) => JSX.Element;
+declare const SortableItem: (props: SortableItemProps) => React.JSX.Element;
 export default SortableItem;

package/lib/components/pisellEmail/constants/emailDomains.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 常用邮箱域名列表
+ * 用于域名自动补全功能
+ */
+export declare const COMMON_EMAIL_DOMAINS: string[];

package/lib/components/pisellEmail/constants/emailRegex.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 邮箱正则表达式常量
+ */
+/**
+ * 标准邮箱格式正则
+ * 覆盖99%的常见邮箱格式
+ */
+export declare const EMAIL_REGEX: RegExp;
+/**
+ * 严格邮箱格式正则（RFC 5322）
+ * 支持更复杂的邮箱格式，符合 RFC 5322 标准
+ */
+export declare const STRICT_EMAIL_REGEX: RegExp;

package/lib/components/pisellEmail/utils/domainSuggestions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 域名补全工具函数（框架占位符）
+ * TODO: 实现完整的补全逻辑
+ */
+/**
+ * 获取邮箱域名补全建议
+ * @param input 用户输入
+ * @param domains 域名列表
+ * @returns 补全建议列表
+ *
+ * @example
+ * getEmailSuggestions('user@g', COMMON_EMAIL_DOMAINS)
+ * // 返回: ['user@gmail.com']
+ */
+export declare function getEmailSuggestions(input: string, domains?: string[]): string[];

package/lib/components/pisellEmpty/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EmptyProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellEmptyProps extends EmptyProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /** 额外内容描述 */
+    extraDescription?: React.ReactNode;
+    /** 额外内容描述 */
+    icon?: React.ReactNode;
+    /** 自定义底部额外操作区域 */
+    footer?: React.ReactNode;
+    [key: string]: any;
+    /** 最大宽度 */
+    maxWidth?: number;
+}
+declare const PisellEmpty: (props: PisellEmptyProps) => React.JSX.Element;
+export default PisellEmpty;

package/lib/components/pisellFilter/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { PisellFilterProps } from './type';
-declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
+declare const PisellFilter: (props: PisellFilterProps) => React.JSX.Element;
 export default PisellFilter;

package/lib/components/pisellFilter/type.d.ts

@@ -0,0 +1,7 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+/**
+ * 筛选弹层 + 快筛列表；内部通过 Form.useForm 托管表单，无需也不应把 antd FormInstance 并入 props。
+ */
+export declare type PisellFilterProps = FilterListProps & {
+    hasForm?: boolean;
+};

package/lib/components/pisellFloatingPanel/index.d.ts

@@ -13,5 +13,5 @@ export interface PisellFloatingPanelProps {
     style?: React.CSSProperties;
     retractIconStyle?: React.CSSProperties;
 }
-declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => JSX.Element;
+declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => React.JSX.Element;
 export default PisellFloatingPanel;

package/lib/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -35,7 +35,7 @@ __export(PisellFloorMapLayout_exports, {
 module.exports = __toCommonJS(PisellFloorMapLayout_exports);
 var import_react = __toESM(require("react"));
 var import_classnames = __toESM(require("classnames"));
-var import_icons = require("@ant-design/icons");
+var import_antd = require("antd");
 var import_react_zoom_pan_pinch = require("react-zoom-pan-pinch");
 var import_MapLayer = __toESM(require("./components/MapLayer"));
 var import_ItemLayer = __toESM(require("./components/ItemLayer"));
@@ -97,8 +97,10 @@ function PisellFloorMapLayoutInner(props, ref) {
     floorMapFullscreenMode,
     showDataSourceRecordFormBlock,
     floorMapViewportOverlay,
-    canvasTabsBarTrailing
+    canvasTabsBarTrailing,
+    viewportDockTrailing
   } = p;
+  const { token } = import_antd.theme.useToken();
   const isFloorMapView = Boolean(floorMapConfigProp);
   const contentOffsetRef = (0, import_react.useRef)({ x: 0, y: 0 });
   const mapDropLayerRef = (0, import_react.useRef)(null);
@@ -139,7 +141,10 @@ function PisellFloorMapLayoutInner(props, ref) {
     editPanelParams,
     placeOverlayClass,
     isLayoutDirty,
-    toggleDraftCanvasShowGrid
+    toggleDraftCanvasShowGrid,
+    toggleSelectedLayoutLock,
+    duplicateSelectedElement,
+    deleteSelectedElement
   } = edit;
   const effectiveMapLayer = (0, import_react.useMemo)(() => {
     if (!isFloorMapView || !config || !currentCanvasId) {
@@ -166,36 +171,75 @@ function PisellFloorMapLayoutInner(props, ref) {
   const engineCtx = (0, import_useEngineContext.default)();
   const engineLocale = ((_b = (_a = engineCtx == null ? void 0 : engineCtx.engine) == null ? void 0 : _a.props) == null ? void 0 : _b.locale) || "zh-CN";
   const hasCanvasTabsBarTrailing = canvasTabsBarTrailing != null && canvasTabsBarTrailing !== false;
+  const enabledCanvasCount = (0, import_react.useMemo)(
+    () => canvasesForTabs.filter((c) => c.enabled).length,
+    [canvasesForTabs]
+  );
   const showReadModeCanvasTabsBar = (0, import_react.useMemo)(() => {
     if (!isFloorMapView || mode !== "read" || !config) return false;
     if (hasCanvasTabsBarTrailing) return true;
-    return canvasesForTabs.filter((c) => c.enabled).length > 1;
-  }, [isFloorMapView, mode, config, canvasesForTabs, hasCanvasTabsBarTrailing]);
+    return enabledCanvasCount > 1;
+  }, [
+    isFloorMapView,
+    mode,
+    config,
+    hasCanvasTabsBarTrailing,
+    enabledCanvasCount
+  ]);
   const readCanvasTabsAriaLabel = (0, import_react.useMemo)(() => {
     (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
     return import_utils.locales.getText("pisell-floor-map-layout.read-canvas-tabs.aria");
   }, [engineLocale]);
-  const readCanvasTabsFsLabels = (0, import_react.useMemo)(() => {
-    (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
-    return {
-      fsEnterAria: import_utils.locales.getText(
-        "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria"
-      ),
-      fsEnterTitle: import_utils.locales.getText(
-        "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title"
-      ),
-      fsExitAria: import_utils.locales.getText(
-        "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria"
-      ),
-      fsExitTitle: import_utils.locales.getText(
-        "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title"
-      )
-    };
-  }, [engineLocale]);
+  const showEditCompactTopBar = isFloorMapView && mode === "edit" && Boolean(config) && !useFullTopChrome;
   const loadingLabel = (0, import_react.useMemo)(() => {
     (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
     return import_utils.locales.getText("pisell-floor-map-layout.loading");
   }, [engineLocale]);
+  const editQuickBar = (0, import_react.useMemo)(() => {
+    if (!isFloorMapView || mode !== "edit" || !(config == null ? void 0 : config.canvasUi.canEdit) || !selectedId) {
+      return null;
+    }
+    (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
+    const row = items.find((i) => i.id === selectedId);
+    if (!(row == null ? void 0 : row._sceneElement)) return null;
+    return {
+      labels: {
+        lock: import_utils.locales.getText("pisell-floor-map-layout.edit-quick.lock"),
+        unlock: import_utils.locales.getText("pisell-floor-map-layout.edit-quick.unlock"),
+        duplicate: import_utils.locales.getText(
+          "pisell-floor-map-layout.edit-quick.duplicate"
+        ),
+        delete: import_utils.locales.getText("pisell-floor-map-layout.edit-quick.delete"),
+        popTitle: import_utils.locales.getText(
+          "pisell-floor-map-layout.edit-panel.pop-title"
+        ),
+        popDesc: import_utils.locales.getText("pisell-floor-map-layout.edit-panel.pop-desc"),
+        cancel: import_utils.locales.getText(
+          "pisell-floor-map-layout.edit-panel.btn-cancel"
+        ),
+        okDelete: import_utils.locales.getText(
+          "pisell-floor-map-layout.edit-panel.btn-ok-delete"
+        ),
+        ariaToolbar: import_utils.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 ? void 0 : config.canvasUi.canEdit,
+    selectedId,
+    items,
+    engineLocale,
+    toggleSelectedLayoutLock,
+    duplicateSelectedElement,
+    deleteSelectedElement
+  ]);
   const cellSize = cellSizeProp ?? import_layoutMeasurements.DEFAULT_CELL_SIZE;
   const itemGap = (0, import_react.useMemo)(
     () => (0, import_layoutMeasurements.gapToPx)(effectiveMapLayer == null ? void 0 : effectiveMapLayer.gap),
@@ -237,15 +281,14 @@ function PisellFloorMapLayoutInner(props, ref) {
   } = metrics;
   const fsMode = floorMapFullscreenMode ?? "toggle";
   const useFullTopChrome = isFloorMapView && mode === "edit" && (fsMode === "locked" || fsMode === "toggle" && isFullscreen);
-  const editToggleFullscreen = fsMode === "toggle" ? toggleFullscreen : void 0;
-  const readToggleFullscreen = isFloorMapView && mode === "read" && fsMode === "toggle" ? toggleFullscreen : void 0;
+  const dockToggleFullscreen = isFloorMapView && fsMode === "toggle" ? toggleFullscreen : void 0;
   const viewControlsConfig = (0, import_react.useMemo)(() => {
-    if (!isFloorMapView || mode !== "edit") return controls;
+    if (!isFloorMapView) return controls;
     return {
       ...controls,
-      showFullscreen: false
+      showFullscreen: controls.showFullscreen ?? Boolean(dockToggleFullscreen)
     };
-  }, [isFloorMapView, mode, controls]);
+  }, [isFloorMapView, controls, dockToggleFullscreen]);
   const topBarExtraActions = null;
   const [mapPaletteDragActive, setMapPaletteDragActive] = (0, import_react.useState)(false);
   (0, import_react.useEffect)(() => {
@@ -373,6 +416,7 @@ function PisellFloorMapLayoutInner(props, ref) {
     [fitBounds, handleSave]
   );
   const showSidebar = isFloorMapView && mode === "edit" && config && dataSources;
+  const editPanelVisible = isFloorMapView && mode === "edit" && Boolean(editPanelParams) && Boolean(config) && Boolean(dataSources);
   return /* @__PURE__ */ import_react.default.createElement(
     "div",
     {
@@ -385,10 +429,13 @@ function PisellFloorMapLayoutInner(props, ref) {
         display: "flex",
         flexDirection: "column",
         ...isFloorMapView ? { minHeight: 0 } : {},
+        ...isFloorMapView ? {
+          ["--fmap-primary"]: token.colorPrimary
+        } : {},
         ...style
       }
     },
-    isFloorMapView && mode === "edit" && config && !useFullTopChrome && /* @__PURE__ */ import_react.default.createElement(
+    showEditCompactTopBar && !useFullTopChrome && /* @__PURE__ */ import_react.default.createElement(
       import_FloorMapEditTopBar.FloorMapEditTopBar,
       {
         mode: "compact",
@@ -403,8 +450,6 @@ function PisellFloorMapLayoutInner(props, ref) {
         onAddCanvas: handleAddCanvas,
         onRemoveCanvas: handleRemoveCanvas,
         onRenameCanvas: handleRenameCanvas,
-        toggleFullscreen: editToggleFullscreen,
-        isFullscreen: false,
         controls,
         canvasTabsBarTrailing
       }
@@ -428,7 +473,6 @@ function PisellFloorMapLayoutInner(props, ref) {
         saving,
         saveError,
         layoutDirty: isLayoutDirty,
-        toggleFullscreen: editToggleFullscreen,
         isFullscreen,
         controls,
         extraActions: topBarExtraActions,
@@ -455,20 +499,7 @@ function PisellFloorMapLayoutInner(props, ref) {
           className: `${PREFIX}-edit-top-bar-canvas-tabs`
         }
       )),
-      hasCanvasTabsBarTrailing || readToggleFullscreen ? /* @__PURE__ */ import_react.default.createElement("div", { className: `${PREFIX}-edit-top-bar-actions` }, canvasTabsBarTrailing, readToggleFullscreen ? /* @__PURE__ */ import_react.default.createElement(
-        "button",
-        {
-          type: "button",
-          className: (0, import_classnames.default)(
-            `${PREFIX}-edit-top-bar-btn`,
-            `${PREFIX}-edit-top-bar-btn-ghost`
-          ),
-          onClick: () => readToggleFullscreen(),
-          "aria-label": isFullscreen ? readCanvasTabsFsLabels.fsExitAria : readCanvasTabsFsLabels.fsEnterAria,
-          title: isFullscreen ? readCanvasTabsFsLabels.fsExitTitle : readCanvasTabsFsLabels.fsEnterTitle
-        },
-        isFullscreen ? /* @__PURE__ */ import_react.default.createElement(import_icons.FullscreenExitOutlined, null) : /* @__PURE__ */ import_react.default.createElement(import_icons.FullscreenOutlined, null)
-      ) : null) : null
+      hasCanvasTabsBarTrailing ? /* @__PURE__ */ import_react.default.createElement("div", { className: `${PREFIX}-edit-top-bar-actions` }, canvasTabsBarTrailing) : null
     ),
     loading && /* @__PURE__ */ import_react.default.createElement("div", { className: `${PREFIX}-loading` }, /* @__PURE__ */ import_react.default.createElement("span", null, loadingLabel)),
     saveError && !(isFloorMapView && mode === "edit" && config) && /* @__PURE__ */ import_react.default.createElement("div", { className: `${PREFIX}-save-error` }, typeof saveError === "string" ? saveError : saveError == null ? void 0 : saveError.message),
@@ -491,7 +522,7 @@ function PisellFloorMapLayoutInner(props, ref) {
           renderPreviewItem: (item) => effectiveRenderItem(item, 0),
           placementPreviewSize: { width: 180, height: 120 },
           decorationPreviewSize: 48,
-          onSave: onSave && config.canvasUi.canEdit && (!useFullTopChrome && toolbarShowSave !== false || useFullTopChrome && isFullscreen) ? handleSave : void 0,
+          onSave: onSave && config.canvasUi.canEdit && !useFullTopChrome && toolbarShowSave !== false ? handleSave : void 0,
           saving,
           saveError,
           layoutDirty: isLayoutDirty,
@@ -503,7 +534,10 @@ function PisellFloorMapLayoutInner(props, ref) {
         "div",
         {
           ref: mapAreaRef,
-          className: showSidebar ? `${PREFIX}-map-area` : void 0,
+          className: (0, import_classnames.default)(
+            showSidebar && `${PREFIX}-map-area`,
+            editPanelVisible && `${PREFIX}-map-area--edit-panel-inset`
+          ),
           style: {
             flex: 1,
             position: "relative",
@@ -542,6 +576,7 @@ function PisellFloorMapLayoutInner(props, ref) {
             initialPositionY,
             minScale: zoomConfig.minScale,
             maxScale: zoomConfig.maxScale,
+            limitToBounds: pan.boundary !== "none",
             ...{ step: zoomConfig.step },
             panning: {
               disabled: pan.enabled === false || isInteractingWithElement,
@@ -608,7 +643,8 @@ function PisellFloorMapLayoutInner(props, ref) {
                   snapStep: (effectiveMapLayer == null ? void 0 : effectiveMapLayer.snapStep) ?? 0,
                   scale,
                   onInteractionChange: setIsInteractingWithElement,
-                  getMergedItemWrapperStyle
+                  getMergedItemWrapperStyle,
+                  editQuickBar
                 }
               ) : /* @__PURE__ */ import_react.default.createElement(
                 import_ItemLayer.default,
@@ -624,6 +660,7 @@ function PisellFloorMapLayoutInner(props, ref) {
                   contentOffsetX,
                   contentOffsetY,
                   enableHover,
+                  itemHoverOutline: true,
                   onItemClick: handleItemClick,
                   onItemHover,
                   onItemLeave,
@@ -661,9 +698,12 @@ function PisellFloorMapLayoutInner(props, ref) {
                 scale,
                 isFullscreen,
                 fitBounds,
-                toggleFullscreen: editToggleFullscreen,
+                toggleFullscreen: dockToggleFullscreen,
                 mapGridVisible: Boolean(effectiveMapLayer == null ? void 0 : effectiveMapLayer.showGrid),
-                onToggleMapGrid: isFloorMapView ? toggleDraftCanvasShowGrid : void 0
+                onToggleMapGrid: isFloorMapView ? toggleDraftCanvasShowGrid : void 0,
+                dockChrome: isFloorMapView,
+                dockExpandedTrailing: viewportDockTrailing,
+                autoCollapseDockMs: 1e4
               }
             ), isFloorMapView && floorMapViewportOverlay != null ? /* @__PURE__ */ import_react.default.createElement("div", { className: `${PREFIX}-viewport-overlay` }, typeof floorMapViewportOverlay === "function" ? floorMapViewportOverlay({
               items,

package/lib/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/lib/components/pisellFloorMapLayout/components/CanvasTabs.d.ts

@@ -1,4 +1,9 @@
-/// <reference types="react" />
+/**
+ * CanvasTabs - 多画布 Tab，支持切换、动态添加、删除与重命名（编辑态）
+ * - 展示名：可选 `nameKey` + `locales.getText`，否则用 `name`（字符串或多语言对象）
+ * - 角标：可选 `tabBadge` 或由布局层注入合并后的数量
+ */
+import React from 'react';
 import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
 import './CanvasTabs.less';
 export interface CanvasTabsProps {
@@ -18,5 +23,5 @@ export interface CanvasTabsProps {
     onRenameCanvas?: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
     className?: string;
 }
-export declare function CanvasTabs(props: CanvasTabsProps): JSX.Element;
+export declare function CanvasTabs(props: CanvasTabsProps): React.JSX.Element;
 export default CanvasTabs;

package/lib/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/lib/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>): React.JSX.Element;
+export default EditableItemLayer;