@pisell/materials 1.0.1059 → 1.0.1062

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

@@ -0,0 +1,438 @@
+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); }
+var _excluded = ["x", "y", "zIndex", "width", "height"];
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+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."); }
+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 _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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; }
+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; }
+/**
+ * 平面图编辑态：草稿配置、画布 Tab、选中、放置模式、落点、侧栏更新/删除/保存记录
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { message } from 'antd';
+import { locales } from '@pisell/utils';
+import useEngineContext from "../../../hooks/useEngineContext";
+import { createTranslationText } from "../../translation/utils";
+import { mergeCanvasItems } from "../utils/floorMapConfigMerge";
+import { STAGE_DECO_DEFAULT } from "../utils/floorMapStageDefaults";
+import { floorMapViewConfigsEqual, normalizeFloorMapViewConfigFromProp } from "../utils/floorMapViewConfigDiff";
+import { getElementKindConfig, resolveDataBindingPolicy } from "../utils/floorMapElementKindUtils";
+import { DEFAULT_CELL_SIZE } from "../utils/layoutMeasurements";
+import { initFloorMapLayoutLocales } from "../utils/floorMapCanvasDisplay";
+import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+var IMAGE_PLACE_DEFAULT = {
+  width: 400,
+  height: 240
+};
+function newInstanceId() {
+  return "elm_".concat(Date.now(), "_").concat(Math.random().toString(36).slice(2, 9));
+}
+function duplicateBinding(elements, binding, exceptInstanceId) {
+  return (elements !== null && elements !== void 0 ? elements : []).some(function (e) {
+    var _e$dataBinding, _e$dataBinding2;
+    return e.instanceId !== exceptInstanceId && ((_e$dataBinding = e.dataBinding) === null || _e$dataBinding === void 0 ? void 0 : _e$dataBinding.dataSourceKey) === binding.dataSourceKey && ((_e$dataBinding2 = e.dataBinding) === null || _e$dataBinding2 === void 0 ? void 0 : _e$dataBinding2.recordId) === binding.recordId;
+  });
+}
+export function useFloorMapEditState(params) {
+  var _engineCtx$engine;
+  var floorMapConfigProp = params.floorMapConfigProp,
+    isFloorMapView = params.isFloorMapView,
+    itemsProp = params.itemsProp,
+    cellSizeProp = params.cellSizeProp,
+    dataSources = params.dataSources,
+    onSave = params.onSave,
+    onDataSourceRecordSave = params.onDataSourceRecordSave,
+    dataSourceFormColumns = params.dataSourceFormColumns,
+    dataSourceRecordForm = params.dataSourceRecordForm,
+    dataSourceLabels = params.dataSourceLabels,
+    layoutPrefix = params.layoutPrefix,
+    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),
+    _useState2 = _slicedToArray(_useState, 2),
+    draftConfig = _useState2[0],
+    setDraftConfig = _useState2[1];
+  var _useState3 = useState(null),
+    _useState4 = _slicedToArray(_useState3, 2),
+    currentCanvasId = _useState4[0],
+    setCurrentCanvasId = _useState4[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    selectedId = _useState6[0],
+    setSelectedId = _useState6[1];
+  var _useState7 = useState(null),
+    _useState8 = _slicedToArray(_useState7, 2),
+    placeMode = _useState8[0],
+    setPlaceMode = _useState8[1];
+  var _useState9 = useState(false),
+    _useState10 = _slicedToArray(_useState9, 2),
+    saving = _useState10[0],
+    setSaving = _useState10[1];
+  var _useState11 = useState(false),
+    _useState12 = _slicedToArray(_useState11, 2),
+    savingRecord = _useState12[0],
+    setSavingRecord = _useState12[1];
+  var config = isFloorMapView ? draftConfig !== null && draftConfig !== void 0 ? draftConfig : floorMapConfigProp : null;
+  var configRef = useRef(config);
+  configRef.current = config;
+  useEffect(function () {
+    if (!floorMapConfigProp) return;
+    var nextConfig = normalizeFloorMapViewConfigFromProp(floorMapConfigProp);
+    setDraftConfig(nextConfig);
+    var enabled = nextConfig.canvases.filter(function (c) {
+      return c.enabled;
+    }).sort(function (a, b) {
+      return a.order - b.order;
+    });
+    setCurrentCanvasId(function (prev) {
+      var _enabled$0$id, _enabled$;
+      return prev && enabled.some(function (c) {
+        return c.id === prev;
+      }) ? prev : (_enabled$0$id = (_enabled$ = enabled[0]) === null || _enabled$ === void 0 ? void 0 : _enabled$.id) !== null && _enabled$0$id !== void 0 ? _enabled$0$id : null;
+    });
+  }, [floorMapConfigProp]);
+
+  /** 当前草稿与上游持久化 `floorMapConfig`（经同等规范化）是否不一致 */
+  var isLayoutDirty = useMemo(function () {
+    if (!isFloorMapView || !draftConfig || !floorMapConfigProp) return false;
+    var baseline = normalizeFloorMapViewConfigFromProp(floorMapConfigProp);
+    return !floorMapViewConfigsEqual(draftConfig, baseline);
+  }, [isFloorMapView, draftConfig, floorMapConfigProp]);
+  var handleAddCanvas = useCallback(function () {
+    initFloorMapLayoutLocales(engineLocale);
+    var label = locales.getText('pisell-floor-map-layout.canvas-tabs.default-new-canvas-name');
+    var defaultName = createTranslationText(label, true);
+    var newId = "floor_".concat(Date.now());
+    var newCanvas = {
+      id: newId,
+      name: defaultName,
+      order: 0,
+      enabled: true
+    };
+    setDraftConfig(function (prev) {
+      if (!prev) return prev;
+      var list = prev.canvases.filter(function (c) {
+        return c.enabled;
+      }).sort(function (a, b) {
+        return a.order - b.order;
+      });
+      newCanvas.order = list.length > 0 ? Math.max.apply(Math, _toConsumableArray(list.map(function (c) {
+        return c.order;
+      }))) + 1 : 0;
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        canvases: [].concat(_toConsumableArray(prev.canvases), [newCanvas])
+      });
+    });
+    setCurrentCanvasId(newId);
+  }, [engineLocale]);
+  var handleRemoveCanvas = useCallback(function (canvasId) {
+    setDraftConfig(function (prev) {
+      var _prev$sceneElements;
+      if (!prev) return prev;
+      var nextCanvases = prev.canvases.filter(function (c) {
+        return c.id !== canvasId;
+      });
+      if (nextCanvases.length === 0) return prev;
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        canvases: nextCanvases,
+        sceneElements: ((_prev$sceneElements = prev.sceneElements) !== null && _prev$sceneElements !== void 0 ? _prev$sceneElements : []).filter(function (e) {
+          return e.canvasId !== canvasId;
+        })
+      });
+    });
+    setCurrentCanvasId(function (prev) {
+      var _enabled$0$id2, _enabled$2;
+      if (prev !== canvasId) return prev;
+      var cfg = configRef.current;
+      if (!cfg) return prev;
+      var enabled = cfg.canvases.filter(function (c) {
+        return c.id !== canvasId && c.enabled;
+      }).sort(function (a, b) {
+        return a.order - b.order;
+      });
+      return (_enabled$0$id2 = (_enabled$2 = enabled[0]) === null || _enabled$2 === void 0 ? void 0 : _enabled$2.id) !== null && _enabled$0$id2 !== void 0 ? _enabled$0$id2 : null;
+    });
+  }, []);
+  var handleRenameCanvas = useCallback(function (canvasId, name) {
+    if (typeof name === 'string') {
+      var trimmed = name.trim();
+      if (!trimmed) return;
+      setDraftConfig(function (prev) {
+        if (!prev) return prev;
+        return _objectSpread(_objectSpread({}, prev), {}, {
+          canvases: prev.canvases.map(function (c) {
+            return c.id === canvasId ? _objectSpread(_objectSpread({}, c), {}, {
+              name: trimmed,
+              nameKey: undefined
+            }) : c;
+          })
+        });
+      });
+      return;
+    }
+    var hasAny = Object.values(name).some(function (s) {
+      return typeof s === 'string' && s.trim();
+    });
+    if (!hasAny) return;
+    setDraftConfig(function (prev) {
+      if (!prev) return prev;
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        canvases: prev.canvases.map(function (c) {
+          return c.id === canvasId ? _objectSpread(_objectSpread({}, c), {}, {
+            name: name,
+            nameKey: undefined
+          }) : c;
+        })
+      });
+    });
+  }, []);
+  var mergedItems = useMemo(function () {
+    if (!isFloorMapView || !config || !currentCanvasId) return [];
+    return mergeCanvasItems(currentCanvasId, config, cellSizeProp !== null && cellSizeProp !== void 0 ? cellSizeProp : DEFAULT_CELL_SIZE);
+  }, [isFloorMapView, config, currentCanvasId, cellSizeProp]);
+  var items = isFloorMapView ? mergedItems : itemsProp;
+  var updateDraftSceneElement = useCallback(function (instanceId, patch) {
+    setDraftConfig(function (prev) {
+      var _prev$sceneElements2, _prev$sceneElements3;
+      if (!prev) return prev;
+      var current = ((_prev$sceneElements2 = prev.sceneElements) !== null && _prev$sceneElements2 !== void 0 ? _prev$sceneElements2 : []).find(function (e) {
+        return e.instanceId === instanceId;
+      });
+      var normalized = _objectSpread({}, patch);
+      var unlocking = patch.layoutTransformLocked === false;
+      if (current !== null && current !== void 0 && current.layoutTransformLocked && !unlocking) {
+        var _normalized = normalized,
+          _x = _normalized.x,
+          _y = _normalized.y,
+          _z = _normalized.zIndex,
+          _w = _normalized.width,
+          _h = _normalized.height,
+          rest = _objectWithoutProperties(_normalized, _excluded);
+        normalized = rest;
+      }
+      if (normalized.x !== undefined) normalized.x = Math.round(normalized.x);
+      if (normalized.y !== undefined) normalized.y = Math.round(normalized.y);
+      if (normalized.width !== undefined) normalized.width = Math.round(normalized.width);
+      if (normalized.height !== undefined) normalized.height = Math.round(normalized.height);
+      var list = ((_prev$sceneElements3 = prev.sceneElements) !== null && _prev$sceneElements3 !== void 0 ? _prev$sceneElements3 : []).map(function (e) {
+        return e.instanceId === instanceId ? _objectSpread(_objectSpread({}, e), normalized) : e;
+      });
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        sceneElements: list
+      });
+    });
+  }, []);
+  var handleUpdateItem = useCallback(function (itemId, patch) {
+    updateDraftSceneElement(itemId, patch);
+  }, [updateDraftSceneElement]);
+  var placeOverlayClass = "".concat(layoutPrefix, "-place-overlay");
+
+  /**
+   * 在内容坐标系下按「新建图元」模式落一条 sceneElement（点击落点与侧栏拖拽共用）
+   * @returns 是否已成功写入草稿（校验失败时为 false）
+   */
+  var applyScenePlacementAtCoords = useCallback(function (contentX, contentY, scene) {
+    var _kindConfig$allowedDa, _ref, _scene$dataSourceKey;
+    if (!config || !currentCanvasId) return false;
+    var defaultPlacementWidth = 180;
+    var defaultPlacementHeight = 120;
+    var defaultDecoSize = 48;
+    var kindConfig = getElementKindConfig(config, scene.elementKind);
+    var policy = resolveDataBindingPolicy(kindConfig);
+    var allKeys = Object.keys(dataSources !== null && dataSources !== void 0 ? dataSources : {});
+    var allowedKeys = kindConfig !== null && kindConfig !== void 0 && (_kindConfig$allowedDa = kindConfig.allowedDataSourceKeys) !== null && _kindConfig$allowedDa !== void 0 && _kindConfig$allowedDa.length ? kindConfig.allowedDataSourceKeys.filter(function (k) {
+      return allKeys.includes(k);
+    }) : allKeys;
+    var pickKey = (_ref = (_scene$dataSourceKey = scene.dataSourceKey) !== null && _scene$dataSourceKey !== void 0 ? _scene$dataSourceKey : allowedKeys[0]) !== null && _ref !== void 0 ? _ref : allKeys[0];
+    var dataBinding;
+    if (policy !== 'none' && pickKey) {
+      var _dataSources$pickKey;
+      var dsList = (_dataSources$pickKey = dataSources === null || dataSources === void 0 ? void 0 : dataSources[pickKey]) !== null && _dataSources$pickKey !== void 0 ? _dataSources$pickKey : [];
+      if (dsList.length === 0) {
+        dataBinding = {
+          dataSourceKey: pickKey,
+          recordId: "new_".concat(Date.now())
+        };
+      } else if (!scene.recordId) {
+        if (policy === 'required') {
+          message.warning('请先在侧栏选择数据源与数据行，再落位');
+          return false;
+        }
+      } else {
+        var record = dsList.find(function (r) {
+          return r.id === scene.recordId;
+        });
+        if (!record) {
+          message.error('所选记录不存在，请重新选择数据行');
+          return false;
+        }
+        var cand = {
+          dataSourceKey: pickKey,
+          recordId: scene.recordId
+        };
+        if (duplicateBinding(config.sceneElements, cand)) {
+          message.warning('该数据记录已在平面图中绑定，请勿重复添加');
+          return false;
+        }
+        dataBinding = cand;
+      }
+    }
+    var isStage = scene.elementKind === FLOOR_MAP_STAGE_ELEMENT_KIND;
+    var isImage = scene.elementKind === FLOOR_MAP_IMAGE_ELEMENT_KIND;
+    var w = isImage ? IMAGE_PLACE_DEFAULT.width : isStage ? STAGE_DECO_DEFAULT.width : defaultPlacementWidth;
+    var h = isImage ? IMAGE_PLACE_DEFAULT.height : isStage ? STAGE_DECO_DEFAULT.height : defaultPlacementHeight;
+    var useDecoSize = policy === 'none' && scene.elementKind !== FLOOR_MAP_STAGE_ELEMENT_KIND && !isImage;
+    var placementName = function (_kindConfig$defaultPr, _kindConfig$defaultPr2) {
+      if (isStage) return STAGE_DECO_DEFAULT.name;
+      if (isImage) return '底图';
+      var db = dataBinding;
+      if (db && scene.recordId) {
+        var _dataSources$db$dataS, _row$name;
+        var row = dataSources === null || dataSources === void 0 || (_dataSources$db$dataS = dataSources[db.dataSourceKey]) === null || _dataSources$db$dataS === void 0 ? void 0 : _dataSources$db$dataS.find(function (r) {
+          return r.id === db.recordId;
+        });
+        return String((_row$name = row === null || row === void 0 ? void 0 : row.name) !== null && _row$name !== void 0 ? _row$name : db.recordId);
+      }
+      return (_kindConfig$defaultPr = kindConfig === null || kindConfig === void 0 || (_kindConfig$defaultPr2 = kindConfig.defaultPresentation) === null || _kindConfig$defaultPr2 === void 0 ? void 0 : _kindConfig$defaultPr2.title) !== null && _kindConfig$defaultPr !== void 0 ? _kindConfig$defaultPr : '';
+    }();
+    var newEl = _objectSpread({
+      instanceId: newInstanceId(),
+      canvasId: currentCanvasId,
+      x: contentX,
+      y: contentY,
+      name: placementName,
+      zIndex: isImage ? -5 : 0,
+      width: useDecoSize ? defaultDecoSize : w,
+      height: useDecoSize ? defaultDecoSize : h,
+      elementKind: scene.elementKind,
+      shape: isStage || isImage ? 'rect' : kindConfig === null || kindConfig === void 0 ? void 0 : kindConfig.defaultShape,
+      dataBinding: dataBinding
+    }, isImage ? {
+      imageUrl: ''
+    } : {});
+    setDraftConfig(function (prev) {
+      var _prev$sceneElements4;
+      return prev ? _objectSpread(_objectSpread({}, prev), {}, {
+        sceneElements: [].concat(_toConsumableArray((_prev$sceneElements4 = prev.sceneElements) !== null && _prev$sceneElements4 !== void 0 ? _prev$sceneElements4 : []), [newEl])
+      }) : prev;
+    });
+    return true;
+  }, [config, currentCanvasId, dataSources]);
+  var handleCanvasPlaceClick = useCallback(function (e) {
+    if (!placeMode || placeMode.type !== 'scene' || !config || !currentCanvasId) return;
+    var target = e.target;
+    if (!target.classList.contains(placeOverlayClass)) return;
+    var _contentOffsetRef$cur = contentOffsetRef.current,
+      ox = _contentOffsetRef$cur.x,
+      oy = _contentOffsetRef$cur.y;
+    var contentX = Math.round(e.nativeEvent.offsetX - ox);
+    var contentY = Math.round(e.nativeEvent.offsetY - oy);
+    if (applyScenePlacementAtCoords(contentX, contentY, placeMode)) {
+      setPlaceMode(null);
+    }
+  }, [placeMode, config, currentCanvasId, applyScenePlacementAtCoords, placeOverlayClass]);
+
+  /** 从左侧图元栏拖拽到画布落位（与点击落点规则一致） */
+  var placeSceneElementFromPaletteDrop = useCallback(function (contentX, contentY, scene) {
+    if (applyScenePlacementAtCoords(contentX, contentY, scene)) {
+      setPlaceMode(null);
+    }
+  }, [applyScenePlacementAtCoords]);
+  var handleSave = useCallback(function () {
+    if (!draftConfig || !onSave) return;
+    setSaving(true);
+    try {
+      onSave(draftConfig);
+    } finally {
+      setSaving(false);
+    }
+  }, [draftConfig, onSave]);
+  var handleEditPanelUpdate = useCallback(function (patch) {
+    if (!selectedId) return;
+    var bindingPatch = patch.dataBinding;
+    if (bindingPatch !== null && bindingPatch !== void 0 && bindingPatch.dataSourceKey && bindingPatch !== null && bindingPatch !== void 0 && bindingPatch.recordId) {
+      var _configRef$current;
+      var cand = bindingPatch;
+      if (duplicateBinding((_configRef$current = configRef.current) === null || _configRef$current === void 0 ? void 0 : _configRef$current.sceneElements, cand, selectedId)) {
+        message.warning('该数据记录已被其他图元绑定');
+        return;
+      }
+    }
+    updateDraftSceneElement(selectedId, patch);
+  }, [selectedId, updateDraftSceneElement]);
+  var handleSaveRecord = useCallback(function (dataSourceKey, id, newData) {
+    onDataSourceRecordSave === null || onDataSourceRecordSave === void 0 || onDataSourceRecordSave(dataSourceKey, id, newData);
+    setSavingRecord(true);
+    setTimeout(function () {
+      return setSavingRecord(false);
+    }, 500);
+  }, [onDataSourceRecordSave]);
+  var handleEditPanelDelete = useCallback(function () {
+    if (!selectedId) return;
+    setDraftConfig(function (prev) {
+      var _prev$sceneElements5;
+      if (!prev) return prev;
+      return _objectSpread(_objectSpread({}, prev), {}, {
+        sceneElements: ((_prev$sceneElements5 = prev.sceneElements) !== null && _prev$sceneElements5 !== void 0 ? _prev$sceneElements5 : []).filter(function (e) {
+          return e.instanceId !== selectedId;
+        })
+      });
+    });
+    setSelectedId(null);
+  }, [selectedId]);
+  var selectedItem = selectedId ? mergedItems.find(function (m) {
+    return m.id === selectedId;
+  }) : null;
+  var editPanelParams = selectedItem && config && selectedId ? {
+    itemId: selectedId,
+    sceneElement: selectedItem._sceneElement,
+    onUpdate: handleEditPanelUpdate,
+    onSaveRecord: onDataSourceRecordSave ? handleSaveRecord : undefined,
+    onClose: function onClose() {
+      return setSelectedId(null);
+    },
+    onDelete: config.canvasUi.canEdit ? handleEditPanelDelete : undefined,
+    recordFormColumns: dataSourceFormColumns,
+    dataSourceRecordForm: dataSourceRecordForm,
+    dataSourceLabels: dataSourceLabels,
+    layoutDraftDirty: isLayoutDirty,
+    showDataSourceRecordFormBlock: showDataSourceRecordFormBlock
+  } : null;
+  return {
+    config: config,
+    currentCanvasId: currentCanvasId,
+    setCurrentCanvasId: setCurrentCanvasId,
+    selectedId: selectedId,
+    setSelectedId: setSelectedId,
+    placeMode: placeMode,
+    setPlaceMode: setPlaceMode,
+    mergedItems: mergedItems,
+    items: items,
+    saving: saving,
+    savingRecord: savingRecord,
+    handleAddCanvas: handleAddCanvas,
+    handleRemoveCanvas: handleRemoveCanvas,
+    handleRenameCanvas: handleRenameCanvas,
+    handleUpdateItem: handleUpdateItem,
+    handleCanvasPlaceClick: handleCanvasPlaceClick,
+    handleSave: handleSave,
+    placeSceneElementFromPaletteDrop: placeSceneElementFromPaletteDrop,
+    editPanelParams: editPanelParams,
+    placeOverlayClass: placeOverlayClass,
+    isLayoutDirty: isLayoutDirty
+  };
+}

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

@@ -0,0 +1,21 @@
+import type { MutableRefObject, PointerEvent as ReactPointerEvent } from 'react';
+import type { FloorMapPaletteDragPayload } from '../utils/floorMapDropUtils';
+export interface UseFloorMapPaletteTouchDragParams {
+    enabled: boolean;
+    mapDropLayerRef: MutableRefObject<HTMLDivElement | null>;
+    contentWidth: number;
+    contentHeight: number;
+    contentOffsetRef: MutableRefObject<{
+        x: number;
+        y: number;
+    }>;
+    setMapPaletteDragActive: (v: boolean) => void;
+    onDropInScene: (payload: FloorMapPaletteDragPayload, sceneX: number, sceneY: number) => void;
+}
+export interface UseFloorMapPaletteTouchDragResult {
+    /** 挂在图元预览按钮上；mouse 不处理，交给 HTML5 DnD */
+    handlePaletteCardPointerDown: (payload: FloorMapPaletteDragPayload, e: ReactPointerEvent<HTMLElement>) => void;
+    /** 图元按钮 onClick 前检查：触摸拖放过则吞掉本次点击 */
+    consumeToolbarClickIfTouchDrag: () => boolean;
+}
+export declare function useFloorMapPaletteTouchDrag(params: UseFloorMapPaletteTouchDragParams): UseFloorMapPaletteTouchDragResult;

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

@@ -0,0 +1,122 @@
+/**
+ * 触屏/笔：从左侧图元栏拖到画布的落点（HTML5 DragEvent + DataTransfer 在触摸上不可靠）
+ */
+import { useCallback, useEffect, useRef } from 'react';
+import { sceneXYFromContentDropOffset } from "../utils/floorMapDropUtils";
+var DRAG_THRESHOLD_PX = 8;
+var POINTER_MOVE_OPTS = {
+  capture: true,
+  passive: false
+};
+export function useFloorMapPaletteTouchDrag(params) {
+  var enabled = params.enabled,
+    mapDropLayerRef = params.mapDropLayerRef,
+    contentWidth = params.contentWidth,
+    contentHeight = params.contentHeight,
+    contentOffsetRef = params.contentOffsetRef,
+    setMapPaletteDragActive = params.setMapPaletteDragActive,
+    onDropInScene = params.onDropInScene;
+  var metricsRef = useRef({
+    cw: contentWidth,
+    ch: contentHeight
+  });
+  metricsRef.current = {
+    cw: contentWidth,
+    ch: contentHeight
+  };
+  var sessionRef = useRef(null);
+  var dragActivatedRef = useRef(false);
+  var suppressNextClickRef = useRef(false);
+  var removeListenersRef = useRef(null);
+  var cleanupWindowListeners = useCallback(function () {
+    var _removeListenersRef$c;
+    (_removeListenersRef$c = removeListenersRef.current) === null || _removeListenersRef$c === void 0 || _removeListenersRef$c.call(removeListenersRef);
+    removeListenersRef.current = null;
+  }, []);
+  useEffect(function () {
+    return function () {
+      cleanupWindowListeners();
+      sessionRef.current = null;
+      dragActivatedRef.current = false;
+      setMapPaletteDragActive(false);
+    };
+  }, [cleanupWindowListeners, setMapPaletteDragActive]);
+  var handlePaletteCardPointerDown = useCallback(function (payload, e) {
+    if (!enabled) return;
+    if (e.pointerType === 'mouse') return;
+    if (e.button !== 0) return;
+    cleanupWindowListeners();
+    dragActivatedRef.current = false;
+    sessionRef.current = {
+      payload: payload,
+      pointerId: e.pointerId,
+      startX: e.clientX,
+      startY: e.clientY
+    };
+    var onMove = function onMove(ev) {
+      var s = sessionRef.current;
+      if (!s || ev.pointerId !== s.pointerId) return;
+      var dx = ev.clientX - s.startX;
+      var dy = ev.clientY - s.startY;
+      if (!dragActivatedRef.current && dx * dx + dy * dy >= Math.pow(DRAG_THRESHOLD_PX, 2)) {
+        dragActivatedRef.current = true;
+        setMapPaletteDragActive(true);
+      }
+      if (dragActivatedRef.current && ev.cancelable) {
+        ev.preventDefault();
+      }
+    };
+    var onUp = function onUp(ev) {
+      var s = sessionRef.current;
+      if (!s || ev.pointerId !== s.pointerId) return;
+      cleanupWindowListeners();
+      sessionRef.current = null;
+      var wasDrag = dragActivatedRef.current;
+      dragActivatedRef.current = false;
+      setMapPaletteDragActive(false);
+      if (!wasDrag) return;
+      suppressNextClickRef.current = true;
+      var layer = mapDropLayerRef.current;
+      if (!layer) return;
+      var r = layer.getBoundingClientRect();
+      var _metricsRef$current = metricsRef.current,
+        cw = _metricsRef$current.cw,
+        ch = _metricsRef$current.ch;
+      if (cw <= 0 || ch <= 0) return;
+      if (ev.clientX < r.left || ev.clientX > r.right || ev.clientY < r.top || ev.clientY > r.bottom) {
+        return;
+      }
+      var lx = (ev.clientX - r.left) / Math.max(r.width, 1) * cw;
+      var ly = (ev.clientY - r.top) / Math.max(r.height, 1) * ch;
+      var _sceneXYFromContentDr = sceneXYFromContentDropOffset(lx, ly, contentOffsetRef.current),
+        x = _sceneXYFromContentDr.x,
+        y = _sceneXYFromContentDr.y;
+      onDropInScene(s.payload, x, y);
+    };
+    window.addEventListener('pointermove', onMove, POINTER_MOVE_OPTS);
+    window.addEventListener('pointerup', onUp, {
+      capture: true
+    });
+    window.addEventListener('pointercancel', onUp, {
+      capture: true
+    });
+    removeListenersRef.current = function () {
+      window.removeEventListener('pointermove', onMove, POINTER_MOVE_OPTS);
+      window.removeEventListener('pointerup', onUp, {
+        capture: true
+      });
+      window.removeEventListener('pointercancel', onUp, {
+        capture: true
+      });
+    };
+  }, [enabled, mapDropLayerRef, contentOffsetRef, setMapPaletteDragActive, onDropInScene, cleanupWindowListeners]);
+  var consumeToolbarClickIfTouchDrag = useCallback(function () {
+    if (!suppressNextClickRef.current) return false;
+    suppressNextClickRef.current = false;
+    return true;
+  }, []);
+  return {
+    handlePaletteCardPointerDown: handlePaletteCardPointerDown,
+    consumeToolbarClickIfTouchDrag: consumeToolbarClickIfTouchDrag
+  };
+}

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

@@ -0,0 +1,67 @@
+import type { MutableRefObject } from 'react';
+import type { FloorMapItemBase, FloorMapItemUnit, FloorMapZoomConfig } from '../types';
+/** react-zoom-pan-pinch TransformWrapper render 注入的上下文 */
+export declare type FloorMapTransformContext = {
+    zoomIn: () => void;
+    zoomOut: () => void;
+    resetTransform: () => void;
+    setTransform: (x: number, y: number, scale: number) => void;
+} | null;
+export interface UseFloorMapTransformMetricsParams<T extends FloorMapItemBase> {
+    items: T[];
+    cellSize: number;
+    itemGap: number;
+    effectiveItemUnit: FloorMapItemUnit;
+    isFloorMapView: boolean;
+    mode: 'read' | 'edit';
+    zoom: FloorMapZoomConfig;
+    transformRef: MutableRefObject<FloorMapTransformContext>;
+    /** 由父组件创建并传入 useFloorMapEditState，本 hook 每帧写入内容区偏移 */
+    contentOffsetRef: MutableRefObject<{
+        x: number;
+        y: number;
+    }>;
+    /** 与 mapLayer.boundingPadding 一致；未传用 DEFAULT_BOUNDING_PADDING */
+    boundingPadding?: number;
+    /**
+     * 平面图：当前画布 id（或其它在切换画布时应重置平移/对齐会话的 key）。
+     * 不传则不跑「异步加载图元后的首次左上对齐」逻辑。
+     */
+    frameResetKey?: string;
+}
+export declare function useFloorMapTransformMetrics<T extends FloorMapItemBase>(params: UseFloorMapTransformMetricsParams<T>): {
+    containerRef: import("react").RefObject<HTMLDivElement>;
+    mapAreaRef: import("react").RefObject<HTMLDivElement>;
+    viewportSize: {
+        width: number;
+        height: number;
+    };
+    mapAreaSize: {
+        width: number;
+        height: number;
+    };
+    contentWidth: number;
+    contentHeight: number;
+    contentOffsetX: number;
+    contentOffsetY: number;
+    initialPositionX: number;
+    initialPositionY: number;
+    zoomConfig: {
+        initialScale: number;
+        minScale: number;
+        maxScale: number;
+        step: number;
+    };
+    scale: number;
+    setScale: import("react").Dispatch<import("react").SetStateAction<number>>;
+    isFullscreen: boolean;
+    toggleFullscreen: () => void;
+    fitBounds: () => void;
+    lastTransformRef: MutableRefObject<{
+        x: number;
+        y: number;
+        scale: number;
+    }>;
+    isInteractingWithElement: boolean;
+    setIsInteractingWithElement: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+};