@pisell/materials 1.0.1059 → 1.0.1062

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

@@ -0,0 +1,431 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellFloorMapLayout/hooks/useFloorMapEditState.ts
+var useFloorMapEditState_exports = {};
+__export(useFloorMapEditState_exports, {
+  useFloorMapEditState: () => useFloorMapEditState
+});
+module.exports = __toCommonJS(useFloorMapEditState_exports);
+var import_react = require("react");
+var import_antd = require("antd");
+var import_utils = require("@pisell/utils");
+var import_useEngineContext = __toESM(require("../../../hooks/useEngineContext"));
+var import_utils2 = require("../../translation/utils");
+var import_floorMapConfigMerge = require("../utils/floorMapConfigMerge");
+var import_floorMapStageDefaults = require("../utils/floorMapStageDefaults");
+var import_floorMapViewConfigDiff = require("../utils/floorMapViewConfigDiff");
+var import_floorMapElementKindUtils = require("../utils/floorMapElementKindUtils");
+var import_layoutMeasurements = require("../utils/layoutMeasurements");
+var import_floorMapCanvasDisplay = require("../utils/floorMapCanvasDisplay");
+var import_types = require("../types");
+var IMAGE_PLACE_DEFAULT = { width: 400, height: 240 };
+function newInstanceId() {
+  return `elm_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+function duplicateBinding(elements, binding, exceptInstanceId) {
+  return (elements ?? []).some(
+    (e) => {
+      var _a, _b;
+      return e.instanceId !== exceptInstanceId && ((_a = e.dataBinding) == null ? void 0 : _a.dataSourceKey) === binding.dataSourceKey && ((_b = e.dataBinding) == null ? void 0 : _b.recordId) === binding.recordId;
+    }
+  );
+}
+function useFloorMapEditState(params) {
+  var _a, _b;
+  const {
+    floorMapConfigProp,
+    isFloorMapView,
+    itemsProp,
+    cellSizeProp,
+    dataSources,
+    onSave,
+    onDataSourceRecordSave,
+    dataSourceFormColumns,
+    dataSourceRecordForm,
+    dataSourceLabels,
+    layoutPrefix,
+    contentOffsetRef,
+    showDataSourceRecordFormBlock
+  } = params;
+  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 [draftConfig, setDraftConfig] = (0, import_react.useState)(
+    null
+  );
+  const [currentCanvasId, setCurrentCanvasId] = (0, import_react.useState)(null);
+  const [selectedId, setSelectedId] = (0, import_react.useState)(null);
+  const [placeMode, setPlaceMode] = (0, import_react.useState)(null);
+  const [saving, setSaving] = (0, import_react.useState)(false);
+  const [savingRecord, setSavingRecord] = (0, import_react.useState)(false);
+  const config = isFloorMapView ? draftConfig ?? floorMapConfigProp : null;
+  const configRef = (0, import_react.useRef)(config);
+  configRef.current = config;
+  (0, import_react.useEffect)(() => {
+    if (!floorMapConfigProp) return;
+    const nextConfig = (0, import_floorMapViewConfigDiff.normalizeFloorMapViewConfigFromProp)(floorMapConfigProp);
+    setDraftConfig(nextConfig);
+    const enabled = nextConfig.canvases.filter((c) => c.enabled).sort((a, b) => a.order - b.order);
+    setCurrentCanvasId(
+      (prev) => {
+        var _a2;
+        return prev && enabled.some((c) => c.id === prev) ? prev : ((_a2 = enabled[0]) == null ? void 0 : _a2.id) ?? null;
+      }
+    );
+  }, [floorMapConfigProp]);
+  const isLayoutDirty = (0, import_react.useMemo)(() => {
+    if (!isFloorMapView || !draftConfig || !floorMapConfigProp) return false;
+    const baseline = (0, import_floorMapViewConfigDiff.normalizeFloorMapViewConfigFromProp)(floorMapConfigProp);
+    return !(0, import_floorMapViewConfigDiff.floorMapViewConfigsEqual)(draftConfig, baseline);
+  }, [isFloorMapView, draftConfig, floorMapConfigProp]);
+  const handleAddCanvas = (0, import_react.useCallback)(() => {
+    (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
+    const label = import_utils.locales.getText(
+      "pisell-floor-map-layout.canvas-tabs.default-new-canvas-name"
+    );
+    const defaultName = (0, import_utils2.createTranslationText)(
+      label,
+      true
+    );
+    const newId = `floor_${Date.now()}`;
+    const newCanvas = {
+      id: newId,
+      name: defaultName,
+      order: 0,
+      enabled: true
+    };
+    setDraftConfig((prev) => {
+      if (!prev) return prev;
+      const list = prev.canvases.filter((c) => c.enabled).sort((a, b) => a.order - b.order);
+      newCanvas.order = list.length > 0 ? Math.max(...list.map((c) => c.order)) + 1 : 0;
+      return { ...prev, canvases: [...prev.canvases, newCanvas] };
+    });
+    setCurrentCanvasId(newId);
+  }, [engineLocale]);
+  const handleRemoveCanvas = (0, import_react.useCallback)((canvasId) => {
+    setDraftConfig((prev) => {
+      if (!prev) return prev;
+      const nextCanvases = prev.canvases.filter((c) => c.id !== canvasId);
+      if (nextCanvases.length === 0) return prev;
+      return {
+        ...prev,
+        canvases: nextCanvases,
+        sceneElements: (prev.sceneElements ?? []).filter(
+          (e) => e.canvasId !== canvasId
+        )
+      };
+    });
+    setCurrentCanvasId((prev) => {
+      var _a2;
+      if (prev !== canvasId) return prev;
+      const cfg = configRef.current;
+      if (!cfg) return prev;
+      const enabled = cfg.canvases.filter((c) => c.id !== canvasId && c.enabled).sort((a, b) => a.order - b.order);
+      return ((_a2 = enabled[0]) == null ? void 0 : _a2.id) ?? null;
+    });
+  }, []);
+  const handleRenameCanvas = (0, import_react.useCallback)(
+    (canvasId, name) => {
+      if (typeof name === "string") {
+        const trimmed = name.trim();
+        if (!trimmed) return;
+        setDraftConfig((prev) => {
+          if (!prev) return prev;
+          return {
+            ...prev,
+            canvases: prev.canvases.map(
+              (c) => c.id === canvasId ? { ...c, name: trimmed, nameKey: void 0 } : c
+            )
+          };
+        });
+        return;
+      }
+      const hasAny = Object.values(name).some(
+        (s) => typeof s === "string" && s.trim()
+      );
+      if (!hasAny) return;
+      setDraftConfig((prev) => {
+        if (!prev) return prev;
+        return {
+          ...prev,
+          canvases: prev.canvases.map(
+            (c) => c.id === canvasId ? { ...c, name, nameKey: void 0 } : c
+          )
+        };
+      });
+    },
+    []
+  );
+  const mergedItems = (0, import_react.useMemo)(() => {
+    if (!isFloorMapView || !config || !currentCanvasId) return [];
+    return (0, import_floorMapConfigMerge.mergeCanvasItems)(
+      currentCanvasId,
+      config,
+      cellSizeProp ?? import_layoutMeasurements.DEFAULT_CELL_SIZE
+    );
+  }, [isFloorMapView, config, currentCanvasId, cellSizeProp]);
+  const items = isFloorMapView ? mergedItems : itemsProp;
+  const updateDraftSceneElement = (0, import_react.useCallback)(
+    (instanceId, patch) => {
+      setDraftConfig((prev) => {
+        if (!prev) return prev;
+        const current = (prev.sceneElements ?? []).find(
+          (e) => e.instanceId === instanceId
+        );
+        let normalized = { ...patch };
+        const unlocking = patch.layoutTransformLocked === false;
+        if ((current == null ? void 0 : current.layoutTransformLocked) && !unlocking) {
+          const {
+            x: _x,
+            y: _y,
+            zIndex: _z,
+            width: _w,
+            height: _h,
+            ...rest
+          } = normalized;
+          normalized = rest;
+        }
+        if (normalized.x !== void 0) normalized.x = Math.round(normalized.x);
+        if (normalized.y !== void 0) normalized.y = Math.round(normalized.y);
+        if (normalized.width !== void 0)
+          normalized.width = Math.round(normalized.width);
+        if (normalized.height !== void 0)
+          normalized.height = Math.round(normalized.height);
+        const list = (prev.sceneElements ?? []).map(
+          (e) => e.instanceId === instanceId ? { ...e, ...normalized } : e
+        );
+        return { ...prev, sceneElements: list };
+      });
+    },
+    []
+  );
+  const handleUpdateItem = (0, import_react.useCallback)(
+    (itemId, patch) => {
+      updateDraftSceneElement(itemId, patch);
+    },
+    [updateDraftSceneElement]
+  );
+  const placeOverlayClass = `${layoutPrefix}-place-overlay`;
+  const applyScenePlacementAtCoords = (0, import_react.useCallback)(
+    (contentX, contentY, scene) => {
+      var _a2;
+      if (!config || !currentCanvasId) return false;
+      const defaultPlacementWidth = 180;
+      const defaultPlacementHeight = 120;
+      const defaultDecoSize = 48;
+      const kindConfig = (0, import_floorMapElementKindUtils.getElementKindConfig)(config, scene.elementKind);
+      const policy = (0, import_floorMapElementKindUtils.resolveDataBindingPolicy)(kindConfig);
+      const allKeys = Object.keys(dataSources ?? {});
+      const allowedKeys = ((_a2 = kindConfig == null ? void 0 : kindConfig.allowedDataSourceKeys) == null ? void 0 : _a2.length) ? kindConfig.allowedDataSourceKeys.filter((k) => allKeys.includes(k)) : allKeys;
+      const pickKey = scene.dataSourceKey ?? allowedKeys[0] ?? allKeys[0];
+      let dataBinding;
+      if (policy !== "none" && pickKey) {
+        const dsList = (dataSources == null ? void 0 : dataSources[pickKey]) ?? [];
+        if (dsList.length === 0) {
+          dataBinding = {
+            dataSourceKey: pickKey,
+            recordId: `new_${Date.now()}`
+          };
+        } else if (!scene.recordId) {
+          if (policy === "required") {
+            import_antd.message.warning("请先在侧栏选择数据源与数据行，再落位");
+            return false;
+          }
+        } else {
+          const record = dsList.find((r) => r.id === scene.recordId);
+          if (!record) {
+            import_antd.message.error("所选记录不存在，请重新选择数据行");
+            return false;
+          }
+          const cand = {
+            dataSourceKey: pickKey,
+            recordId: scene.recordId
+          };
+          if (duplicateBinding(config.sceneElements, cand)) {
+            import_antd.message.warning("该数据记录已在平面图中绑定，请勿重复添加");
+            return false;
+          }
+          dataBinding = cand;
+        }
+      }
+      const isStage = scene.elementKind === import_types.FLOOR_MAP_STAGE_ELEMENT_KIND;
+      const isImage = scene.elementKind === import_types.FLOOR_MAP_IMAGE_ELEMENT_KIND;
+      const w = isImage ? IMAGE_PLACE_DEFAULT.width : isStage ? import_floorMapStageDefaults.STAGE_DECO_DEFAULT.width : defaultPlacementWidth;
+      const h = isImage ? IMAGE_PLACE_DEFAULT.height : isStage ? import_floorMapStageDefaults.STAGE_DECO_DEFAULT.height : defaultPlacementHeight;
+      const useDecoSize = policy === "none" && scene.elementKind !== import_types.FLOOR_MAP_STAGE_ELEMENT_KIND && !isImage;
+      const placementName = (() => {
+        var _a3, _b2;
+        if (isStage) return import_floorMapStageDefaults.STAGE_DECO_DEFAULT.name;
+        if (isImage) return "底图";
+        const db = dataBinding;
+        if (db && scene.recordId) {
+          const row = (_a3 = dataSources == null ? void 0 : dataSources[db.dataSourceKey]) == null ? void 0 : _a3.find(
+            (r) => r.id === db.recordId
+          );
+          return String((row == null ? void 0 : row.name) ?? db.recordId);
+        }
+        return ((_b2 = kindConfig == null ? void 0 : kindConfig.defaultPresentation) == null ? void 0 : _b2.title) ?? "";
+      })();
+      const newEl = {
+        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 ? void 0 : kindConfig.defaultShape,
+        dataBinding,
+        ...isImage ? { imageUrl: "" } : {}
+      };
+      setDraftConfig(
+        (prev) => prev ? { ...prev, sceneElements: [...prev.sceneElements ?? [], newEl] } : prev
+      );
+      return true;
+    },
+    [config, currentCanvasId, dataSources]
+  );
+  const handleCanvasPlaceClick = (0, import_react.useCallback)(
+    (e) => {
+      if (!placeMode || placeMode.type !== "scene" || !config || !currentCanvasId)
+        return;
+      const target = e.target;
+      if (!target.classList.contains(placeOverlayClass)) return;
+      const { x: ox, y: oy } = contentOffsetRef.current;
+      const contentX = Math.round(e.nativeEvent.offsetX - ox);
+      const contentY = Math.round(e.nativeEvent.offsetY - oy);
+      if (applyScenePlacementAtCoords(contentX, contentY, placeMode)) {
+        setPlaceMode(null);
+      }
+    },
+    [
+      placeMode,
+      config,
+      currentCanvasId,
+      applyScenePlacementAtCoords,
+      placeOverlayClass
+    ]
+  );
+  const placeSceneElementFromPaletteDrop = (0, import_react.useCallback)(
+    (contentX, contentY, scene) => {
+      if (applyScenePlacementAtCoords(contentX, contentY, scene)) {
+        setPlaceMode(null);
+      }
+    },
+    [applyScenePlacementAtCoords]
+  );
+  const handleSave = (0, import_react.useCallback)(() => {
+    if (!draftConfig || !onSave) return;
+    setSaving(true);
+    try {
+      onSave(draftConfig);
+    } finally {
+      setSaving(false);
+    }
+  }, [draftConfig, onSave]);
+  const handleEditPanelUpdate = (0, import_react.useCallback)(
+    (patch) => {
+      var _a2;
+      if (!selectedId) return;
+      const bindingPatch = patch.dataBinding;
+      if ((bindingPatch == null ? void 0 : bindingPatch.dataSourceKey) && (bindingPatch == null ? void 0 : bindingPatch.recordId)) {
+        const cand = bindingPatch;
+        if (duplicateBinding((_a2 = configRef.current) == null ? void 0 : _a2.sceneElements, cand, selectedId)) {
+          import_antd.message.warning("该数据记录已被其他图元绑定");
+          return;
+        }
+      }
+      updateDraftSceneElement(selectedId, patch);
+    },
+    [selectedId, updateDraftSceneElement]
+  );
+  const handleSaveRecord = (0, import_react.useCallback)(
+    (dataSourceKey, id, newData) => {
+      onDataSourceRecordSave == null ? void 0 : onDataSourceRecordSave(dataSourceKey, id, newData);
+      setSavingRecord(true);
+      setTimeout(() => setSavingRecord(false), 500);
+    },
+    [onDataSourceRecordSave]
+  );
+  const handleEditPanelDelete = (0, import_react.useCallback)(() => {
+    if (!selectedId) return;
+    setDraftConfig((prev) => {
+      if (!prev) return prev;
+      return {
+        ...prev,
+        sceneElements: (prev.sceneElements ?? []).filter(
+          (e) => e.instanceId !== selectedId
+        )
+      };
+    });
+    setSelectedId(null);
+  }, [selectedId]);
+  const selectedItem = selectedId ? mergedItems.find((m) => m.id === selectedId) : null;
+  const editPanelParams = selectedItem && config && selectedId ? {
+    itemId: selectedId,
+    sceneElement: selectedItem._sceneElement,
+    onUpdate: handleEditPanelUpdate,
+    onSaveRecord: onDataSourceRecordSave ? handleSaveRecord : void 0,
+    onClose: () => setSelectedId(null),
+    onDelete: config.canvasUi.canEdit ? handleEditPanelDelete : void 0,
+    recordFormColumns: dataSourceFormColumns,
+    dataSourceRecordForm,
+    dataSourceLabels,
+    layoutDraftDirty: isLayoutDirty,
+    showDataSourceRecordFormBlock
+  } : null;
+  return {
+    config,
+    currentCanvasId,
+    setCurrentCanvasId,
+    selectedId,
+    setSelectedId,
+    placeMode,
+    setPlaceMode,
+    mergedItems,
+    items,
+    saving,
+    savingRecord,
+    handleAddCanvas,
+    handleRemoveCanvas,
+    handleRenameCanvas,
+    handleUpdateItem,
+    handleCanvasPlaceClick,
+    handleSave,
+    placeSceneElementFromPaletteDrop,
+    editPanelParams,
+    placeOverlayClass,
+    isLayoutDirty
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useFloorMapEditState
+});

package/lib/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/lib/components/pisellFloorMapLayout/hooks/useFloorMapPaletteTouchDrag.js

@@ -0,0 +1,146 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellFloorMapLayout/hooks/useFloorMapPaletteTouchDrag.ts
+var useFloorMapPaletteTouchDrag_exports = {};
+__export(useFloorMapPaletteTouchDrag_exports, {
+  useFloorMapPaletteTouchDrag: () => useFloorMapPaletteTouchDrag
+});
+module.exports = __toCommonJS(useFloorMapPaletteTouchDrag_exports);
+var import_react = require("react");
+var import_floorMapDropUtils = require("../utils/floorMapDropUtils");
+var DRAG_THRESHOLD_PX = 8;
+var POINTER_MOVE_OPTS = {
+  capture: true,
+  passive: false
+};
+function useFloorMapPaletteTouchDrag(params) {
+  const {
+    enabled,
+    mapDropLayerRef,
+    contentWidth,
+    contentHeight,
+    contentOffsetRef,
+    setMapPaletteDragActive,
+    onDropInScene
+  } = params;
+  const metricsRef = (0, import_react.useRef)({ cw: contentWidth, ch: contentHeight });
+  metricsRef.current = { cw: contentWidth, ch: contentHeight };
+  const sessionRef = (0, import_react.useRef)(null);
+  const dragActivatedRef = (0, import_react.useRef)(false);
+  const suppressNextClickRef = (0, import_react.useRef)(false);
+  const removeListenersRef = (0, import_react.useRef)(null);
+  const cleanupWindowListeners = (0, import_react.useCallback)(() => {
+    var _a;
+    (_a = removeListenersRef.current) == null ? void 0 : _a.call(removeListenersRef);
+    removeListenersRef.current = null;
+  }, []);
+  (0, import_react.useEffect)(
+    () => () => {
+      cleanupWindowListeners();
+      sessionRef.current = null;
+      dragActivatedRef.current = false;
+      setMapPaletteDragActive(false);
+    },
+    [cleanupWindowListeners, setMapPaletteDragActive]
+  );
+  const handlePaletteCardPointerDown = (0, import_react.useCallback)(
+    (payload, e) => {
+      if (!enabled) return;
+      if (e.pointerType === "mouse") return;
+      if (e.button !== 0) return;
+      cleanupWindowListeners();
+      dragActivatedRef.current = false;
+      sessionRef.current = {
+        payload,
+        pointerId: e.pointerId,
+        startX: e.clientX,
+        startY: e.clientY
+      };
+      const onMove = (ev) => {
+        const s = sessionRef.current;
+        if (!s || ev.pointerId !== s.pointerId) return;
+        const dx = ev.clientX - s.startX;
+        const dy = ev.clientY - s.startY;
+        if (!dragActivatedRef.current && dx * dx + dy * dy >= DRAG_THRESHOLD_PX ** 2) {
+          dragActivatedRef.current = true;
+          setMapPaletteDragActive(true);
+        }
+        if (dragActivatedRef.current && ev.cancelable) {
+          ev.preventDefault();
+        }
+      };
+      const onUp = (ev) => {
+        const s = sessionRef.current;
+        if (!s || ev.pointerId !== s.pointerId) return;
+        cleanupWindowListeners();
+        sessionRef.current = null;
+        const wasDrag = dragActivatedRef.current;
+        dragActivatedRef.current = false;
+        setMapPaletteDragActive(false);
+        if (!wasDrag) return;
+        suppressNextClickRef.current = true;
+        const layer = mapDropLayerRef.current;
+        if (!layer) return;
+        const r = layer.getBoundingClientRect();
+        const { cw, ch } = metricsRef.current;
+        if (cw <= 0 || ch <= 0) return;
+        if (ev.clientX < r.left || ev.clientX > r.right || ev.clientY < r.top || ev.clientY > r.bottom) {
+          return;
+        }
+        const lx = (ev.clientX - r.left) / Math.max(r.width, 1) * cw;
+        const ly = (ev.clientY - r.top) / Math.max(r.height, 1) * ch;
+        const { x, y } = (0, import_floorMapDropUtils.sceneXYFromContentDropOffset)(
+          lx,
+          ly,
+          contentOffsetRef.current
+        );
+        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 = () => {
+        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
+    ]
+  );
+  const consumeToolbarClickIfTouchDrag = (0, import_react.useCallback)(() => {
+    if (!suppressNextClickRef.current) return false;
+    suppressNextClickRef.current = false;
+    return true;
+  }, []);
+  return {
+    handlePaletteCardPointerDown,
+    consumeToolbarClickIfTouchDrag
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useFloorMapPaletteTouchDrag
+});

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