@pisell/materials 1.0.1063 → 1.0.1065

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

@@ -45,6 +45,28 @@ 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 };
+var GRID_VIS_STORAGE_PREFIX = "pisell-floor-map-layout.grid-visible";
+function getGridVisStorageKey(canvasId) {
+  return `${GRID_VIS_STORAGE_PREFIX}:${canvasId}`;
+}
+function readStoredGridVisible(canvasId) {
+  try {
+    const raw = localStorage.getItem(getGridVisStorageKey(canvasId));
+    if (raw == null) return null;
+    if (raw === "1") return true;
+    if (raw === "0") return false;
+    return null;
+  } catch {
+    return null;
+  }
+}
+function writeStoredGridVisible(canvasId, visible) {
+  try {
+    localStorage.setItem(getGridVisStorageKey(canvasId), visible ? "1" : "0");
+  } catch {
+  }
+}
+var BATCH_PLACE_OFFSET = 16;
 function newInstanceId() {
   return `elm_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
 }
@@ -83,13 +105,26 @@ function useFloorMapEditState(params) {
   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 [savedBaselineConfig, setSavedBaselineConfig] = (0, import_react.useState)(null);
   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);
+    const baseConfig = (0, import_floorMapViewConfigDiff.normalizeFloorMapViewConfigFromProp)(floorMapConfigProp);
+    const nextConfig = {
+      ...baseConfig,
+      canvases: baseConfig.canvases.map((canvas) => {
+        const stored = readStoredGridVisible(canvas.id);
+        if (stored == null) return canvas;
+        return {
+          ...canvas,
+          mapLayer: { ...canvas.mapLayer ?? {}, showGrid: stored }
+        };
+      })
+    };
     setDraftConfig(nextConfig);
+    setSavedBaselineConfig(null);
     const enabled = nextConfig.canvases.filter((c) => c.enabled).sort((a, b) => a.order - b.order);
     setCurrentCanvasId(
       (prev) => {
@@ -100,9 +135,9 @@ function useFloorMapEditState(params) {
   }, [floorMapConfigProp]);
   const isLayoutDirty = (0, import_react.useMemo)(() => {
     if (!isFloorMapView || !draftConfig || !floorMapConfigProp) return false;
-    const baseline = (0, import_floorMapViewConfigDiff.normalizeFloorMapViewConfigFromProp)(floorMapConfigProp);
+    const baseline = savedBaselineConfig ?? (0, import_floorMapViewConfigDiff.normalizeFloorMapViewConfigFromProp)(floorMapConfigProp);
     return !(0, import_floorMapViewConfigDiff.floorMapViewConfigsEqual)(draftConfig, baseline);
-  }, [isFloorMapView, draftConfig, floorMapConfigProp]);
+  }, [isFloorMapView, draftConfig, floorMapConfigProp, savedBaselineConfig]);
   const handleAddCanvas = (0, import_react.useCallback)(() => {
     (0, import_floorMapCanvasDisplay.initFloorMapLayoutLocales)(engineLocale);
     const label = import_utils.locales.getText(
@@ -243,6 +278,26 @@ function useFloorMapEditState(params) {
       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];
+      const recordIdsToPlace = scene.recordIds && scene.recordIds.length > 0 ? scene.recordIds : scene.recordId ? [scene.recordId] : [];
+      const isStage = scene.elementKind === import_types.FLOOR_MAP_STAGE_ELEMENT_KIND;
+      const isImage = (0, import_floorMapElementKindUtils.isFloorMapImageElementKind)(scene.elementKind);
+      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 buildOneElement = (dataBinding2, x, y, name) => ({
+        instanceId: newInstanceId(),
+        canvasId: currentCanvasId,
+        x,
+        y,
+        name,
+        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: dataBinding2,
+        ...isImage ? { imageUrl: "" } : {}
+      });
       let dataBinding;
       if (policy !== "none" && pickKey) {
         const dsList = (dataSources == null ? void 0 : dataSources[pickKey]) ?? [];
@@ -251,60 +306,99 @@ function useFloorMapEditState(params) {
             dataSourceKey: pickKey,
             recordId: `new_${Date.now()}`
           };
-        } else if (!scene.recordId) {
+        } else if (recordIdsToPlace.length === 0) {
           if (policy === "required") {
             import_antd.message.warning("请先在侧栏选择数据源与数据行，再落位");
             return false;
           }
-        } else {
-          const record = dsList.find((r) => r.id === scene.recordId);
+        } else if (recordIdsToPlace.length === 1) {
+          const rid = recordIdsToPlace[0];
+          const record = dsList.find((r) => r.id === rid);
           if (!record) {
             import_antd.message.error("所选记录不存在，请重新选择数据行");
             return false;
           }
           const cand = {
             dataSourceKey: pickKey,
-            recordId: scene.recordId
+            recordId: rid
           };
           if (duplicateBinding(config.sceneElements, cand)) {
             import_antd.message.warning("该数据记录已在平面图中绑定，请勿重复添加");
             return false;
           }
           dataBinding = cand;
+        } else {
+          const newEls = [];
+          let skippedDup = 0;
+          let skippedMissing = 0;
+          let placeIndex = 0;
+          const seenInBatch = /* @__PURE__ */ new Set();
+          recordIdsToPlace.forEach((rid) => {
+            const record = dsList.find((r) => r.id === rid);
+            if (!record) {
+              skippedMissing += 1;
+              return;
+            }
+            const cand = {
+              dataSourceKey: pickKey,
+              recordId: rid
+            };
+            if (seenInBatch.has(rid) || duplicateBinding(config.sceneElements, cand)) {
+              skippedDup += 1;
+              return;
+            }
+            seenInBatch.add(rid);
+            const row = record;
+            const placementName2 = String((row == null ? void 0 : row.name) ?? rid);
+            newEls.push(
+              buildOneElement(
+                cand,
+                contentX + placeIndex * BATCH_PLACE_OFFSET,
+                contentY + placeIndex * BATCH_PLACE_OFFSET,
+                placementName2
+              )
+            );
+            placeIndex += 1;
+          });
+          if (skippedDup > 0) {
+            import_antd.message.warning(`已跳过 ${skippedDup} 条已在平面图中绑定的记录`);
+          }
+          if (skippedMissing > 0) {
+            import_antd.message.warning(`有 ${skippedMissing} 条记录不存在，已跳过`);
+          }
+          if (newEls.length === 0) {
+            import_antd.message.warning("没有可落位的记录");
+            return false;
+          }
+          setDraftConfig(
+            (prev) => prev ? {
+              ...prev,
+              sceneElements: [...prev.sceneElements ?? [], ...newEls]
+            } : prev
+          );
+          return true;
         }
       }
-      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 rid = recordIdsToPlace[0];
+        if (db && rid) {
           const row = (_a3 = dataSources == null ? void 0 : dataSources[db.dataSourceKey]) == null ? void 0 : _a3.find(
-            (r) => r.id === db.recordId
+            (r) => r.id === rid
           );
-          return String((row == null ? void 0 : row.name) ?? db.recordId);
+          return String((row == null ? void 0 : row.name) ?? rid);
         }
         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,
+      const newEl = buildOneElement(
         dataBinding,
-        ...isImage ? { imageUrl: "" } : {}
-      };
+        contentX,
+        contentY,
+        placementName
+      );
       setDraftConfig(
         (prev) => prev ? { ...prev, sceneElements: [...prev.sceneElements ?? [], newEl] } : prev
       );
@@ -346,10 +440,29 @@ function useFloorMapEditState(params) {
     setSaving(true);
     try {
       onSave(draftConfig);
+      setSavedBaselineConfig(draftConfig);
     } finally {
       setSaving(false);
     }
   }, [draftConfig, onSave]);
+  const toggleDraftCanvasShowGrid = (0, import_react.useCallback)(() => {
+    setDraftConfig((prev) => {
+      if (!prev || !currentCanvasId) return prev;
+      return {
+        ...prev,
+        canvases: prev.canvases.map((c) => {
+          var _a2;
+          if (c.id !== currentCanvasId) return c;
+          const nextShow = !Boolean((_a2 = c.mapLayer) == null ? void 0 : _a2.showGrid);
+          writeStoredGridVisible(currentCanvasId, nextShow);
+          return {
+            ...c,
+            mapLayer: { ...c.mapLayer, showGrid: nextShow }
+          };
+        })
+      };
+    });
+  }, [currentCanvasId]);
   const handleEditPanelUpdate = (0, import_react.useCallback)(
     (patch) => {
       var _a2;
@@ -422,7 +535,8 @@ function useFloorMapEditState(params) {
     placeSceneElementFromPaletteDrop,
     editPanelParams,
     placeOverlayClass,
-    isLayoutDirty
+    isLayoutDirty,
+    toggleDraftCanvasShowGrid
   };
 }
 // Annotate the CommonJS export names for ESM import in node:

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

@@ -56,7 +56,7 @@ export declare function useFloorMapTransformMetrics<T extends FloorMapItemBase>(
     setScale: import("react").Dispatch<import("react").SetStateAction<number>>;
     isFullscreen: boolean;
     toggleFullscreen: () => void;
-    fitBounds: () => void;
+    fitBounds: () => boolean;
     lastTransformRef: MutableRefObject<{
         x: number;
         y: number;

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

@@ -65,7 +65,7 @@ function useFloorMapTransformMetrics(params) {
     setMapAreaSize({ width: el.clientWidth, height: el.clientHeight });
     return () => ro.disconnect();
   }, []);
-  const autoFitOnMount = zoom.autoFitOnMount === true;
+  const autoFitOnMount = zoom.autoFitOnMount !== false;
   const zoomConfig = (0, import_react.useMemo)(
     () => ({
       initialScale: zoom.defaultScale ?? 1,
@@ -210,45 +210,112 @@ function useFloorMapTransformMetrics(params) {
   const fitBounds = (0, import_react.useCallback)(() => {
     const ctx = transformRef.current;
     const container = containerRef.current;
-    if (!ctx || !container) return;
+    if (!ctx || !container) return false;
     const wrapper = container.querySelector(".react-transform-wrapper");
-    if (!wrapper) return;
+    if (!wrapper) return false;
     const wrapperRect = wrapper.getBoundingClientRect();
-    const nextScale = Math.min(
+    if (wrapperRect.width <= 0 || wrapperRect.height <= 0) return false;
+    const pixelBox = isFloorMapView && effectiveItemUnit === "pixel" && items.length > 0 ? (0, import_layoutMeasurements.getPixelBoundingBox)(items, cellSize) : null;
+    if (pixelBox) {
+      const bw = Math.max(1, pixelBox.maxRight - pixelBox.minLeft);
+      const bh = Math.max(1, pixelBox.maxBottom - pixelBox.minTop);
+      const edgePx = 0;
+      const availW = Math.max(1, wrapperRect.width - 2 * edgePx);
+      const availH = Math.max(1, wrapperRect.height - 2 * edgePx);
+      const raw2 = Math.min(availW / bw, availH / bh);
+      const nextScale2 = Math.min(raw2, zoom.max ?? 2);
+      const ap = alignPadSingle ?? padSingle;
+      const bboxCx = ap + bw / 2;
+      const bboxCy = ap + bh / 2;
+      const x2 = wrapperRect.width / 2 - bboxCx * nextScale2;
+      const y2 = wrapperRect.height / 2 - bboxCy * nextScale2;
+      ctx.setTransform(x2, y2, nextScale2);
+      return true;
+    }
+    if (contentWidth <= 0 || contentHeight <= 0) return false;
+    const raw = Math.min(
       wrapperRect.width / contentWidth,
-      wrapperRect.height / contentHeight,
-      zoom.max ?? 2
+      wrapperRect.height / contentHeight
     );
+    const nextScale = Math.min(raw, zoom.max ?? 2);
     const padA = alignPadSingle ?? 0;
     const x = VIEWPORT_TOP_LEFT_MARGIN - padA * nextScale;
     const y = VIEWPORT_TOP_LEFT_MARGIN - padA * nextScale;
     ctx.setTransform(x, y, nextScale);
-  }, [contentWidth, contentHeight, zoom.max, transformRef, alignPadSingle]);
+    return true;
+  }, [
+    contentWidth,
+    contentHeight,
+    zoom.max,
+    transformRef,
+    alignPadSingle,
+    isFloorMapView,
+    effectiveItemUnit,
+    items,
+    cellSize,
+    padSingle
+  ]);
   const autoFitOnceRef = (0, import_react.useRef)({
     frame: "",
     done: false
   });
-  (0, import_react.useEffect)(() => {
-    if (!isFloorMapView || !autoFitOnMount || frameResetKey === void 0)
-      return;
+  const prevItemsCountForAutoFitRef = (0, import_react.useRef)(null);
+  (0, import_react.useLayoutEffect)(() => {
+    if (!isFloorMapView || !autoFitOnMount || frameResetKey === void 0) return;
     const frame = String(frameResetKey);
     if (autoFitOnceRef.current.frame !== frame) {
       autoFitOnceRef.current = { frame, done: false };
+      prevItemsCountForAutoFitRef.current = null;
+    }
+    const itemCount = items.length;
+    const prevN = prevItemsCountForAutoFitRef.current;
+    if (prevN !== null && prevN === 0 && itemCount > 0) {
+      autoFitOnceRef.current.done = false;
     }
+    prevItemsCountForAutoFitRef.current = itemCount;
     if (autoFitOnceRef.current.done) return;
+    if (effectiveItemUnit === "pixel" && itemCount === 0) {
+      return;
+    }
     if (contentWidth <= 0 || contentHeight <= 0) return;
     let cancelled = false;
     let raf = 0;
+    let attempts = 0;
+    const MAX_AUTO_FIT_ATTEMPTS = 160;
     const tick = () => {
       if (cancelled) return;
+      if (attempts >= MAX_AUTO_FIT_ATTEMPTS) return;
       const ctx = transformRef.current;
       const container = containerRef.current;
-      if (!ctx || !(container == null ? void 0 : container.querySelector(".react-transform-wrapper"))) {
+      const wrapper = container == null ? void 0 : container.querySelector(
+        ".react-transform-wrapper"
+      );
+      if (!ctx || !wrapper) {
+        attempts += 1;
         raf = requestAnimationFrame(tick);
         return;
       }
-      fitBounds();
-      autoFitOnceRef.current.done = true;
+      const rect = wrapper.getBoundingClientRect();
+      if (rect.width <= 0 || rect.height <= 0) {
+        attempts += 1;
+        raf = requestAnimationFrame(tick);
+        return;
+      }
+      raf = requestAnimationFrame(() => {
+        if (cancelled) return;
+        raf = requestAnimationFrame(() => {
+          if (cancelled) return;
+          const ok = fitBounds();
+          if (ok) {
+            autoFitOnceRef.current.done = true;
+            return;
+          }
+          attempts += 1;
+          if (attempts < MAX_AUTO_FIT_ATTEMPTS) {
+            raf = requestAnimationFrame(tick);
+          }
+        });
+      });
     };
     raf = requestAnimationFrame(tick);
     return () => {
@@ -259,8 +326,14 @@ function useFloorMapTransformMetrics(params) {
     isFloorMapView,
     autoFitOnMount,
     frameResetKey,
+    effectiveItemUnit,
+    items.length,
     contentWidth,
     contentHeight,
+    viewportSize.width,
+    viewportSize.height,
+    mapAreaSize.width,
+    mapAreaSize.height,
     fitBounds,
     transformRef
   ]);

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

@@ -5,6 +5,8 @@
 export { PisellFloorMapLayout } from './PisellFloorMapLayout';
 export type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapItemBase, FloorMapItemUnit, FloorMapLayerConfig, FloorMapZoomConfig, FloorMapPanConfig, FloorMapControlsConfig, FloorMapItemShape, FloorMapBackgroundType, FloorMapPanBoundary, FloorMapLayoutMode, FloorMapGridLayoutConfig, FloorMapCanvas, FloorMapCanvasNameI18n, FloorMapElement, FloorMapData, FloorMapViewConfig, FloorMapCanvasUiConfig, FloorMapSceneElement, FloorMapSceneElementDataBinding, FloorMapPlaceMode, FloorMapElementKindCategory, FloorMapElementDataBindingPolicy, FloorMapElementDefaultPresentation, FloorMapEdge, FloorMapElementKindConfig, FloorMapElementType, FloorMapTextSlot, FloorMapDataSources, FloorMapRenderOptions, FloorMapEditPanelParams, DataSourceFormColumn, FloorMapMergedItem, FloorMapRecordFormRenderContext, FloorMapDataSourceRecordFormContent, FloorMapFullscreenMode, FloorMapLayoutContextValue, } from './types';
 export { FLOOR_MAP_STAGE_ELEMENT_KIND, FLOOR_MAP_IMAGE_ELEMENT_KIND, } from './types';
+export { renderFloorMapFallbackPlaceholder } from './utils/floorMapFallbackRender';
+export { isFloorMapImageElementKind } from './utils/floorMapElementKindUtils';
 export { FloorMapLayoutProvider, useFloorMapLayoutContext, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT, } from './context/FloorMapLayoutContext';
 export type { FloorMapLayoutProviderProps } from './context/FloorMapLayoutContext';
 export { mergeFloorMapLayoutPropsFromContext } from './context/mergeFloorMapLayoutContext';

package/lib/components/pisellFloorMapLayout/index.js

@@ -28,14 +28,18 @@ __export(pisellFloorMapLayout_exports, {
   getFigmaTableCardFromMerged: () => import_FigmaTableCard.getFigmaTableCardFromMerged,
   getRenderItemByKindRoundTable: () => import_FigmaTableCard.getRenderItemByKindRoundTable,
   getRenderItemByKindTable: () => import_FigmaTableCard.getRenderItemByKindTable,
+  isFloorMapImageElementKind: () => import_floorMapElementKindUtils.isFloorMapImageElementKind,
   mergeFloorMapLayoutPropsFromContext: () => import_mergeFloorMapLayoutContext.mergeFloorMapLayoutPropsFromContext,
   renderFigmaStyleRoundTableCard: () => import_FigmaTableCard.renderFigmaStyleRoundTableCard,
   renderFigmaStyleTableCard: () => import_FigmaTableCard.renderFigmaStyleTableCard,
+  renderFloorMapFallbackPlaceholder: () => import_floorMapFallbackRender.renderFloorMapFallbackPlaceholder,
   useFloorMapLayoutContext: () => import_FloorMapLayoutContext.useFloorMapLayoutContext
 });
 module.exports = __toCommonJS(pisellFloorMapLayout_exports);
 var import_PisellFloorMapLayout = require("./PisellFloorMapLayout");
 var import_types = require("./types");
+var import_floorMapFallbackRender = require("./utils/floorMapFallbackRender");
+var import_floorMapElementKindUtils = require("./utils/floorMapElementKindUtils");
 var import_FloorMapLayoutContext = require("./context/FloorMapLayoutContext");
 var import_mergeFloorMapLayoutContext = require("./context/mergeFloorMapLayoutContext");
 var import_FloorMapImageElement = require("./components/FloorMapImageElement");
@@ -51,8 +55,10 @@ var import_FigmaTableCard = require("./components/FigmaTableCard");
   getFigmaTableCardFromMerged,
   getRenderItemByKindRoundTable,
   getRenderItemByKindTable,
+  isFloorMapImageElementKind,
   mergeFloorMapLayoutPropsFromContext,
   renderFigmaStyleRoundTableCard,
   renderFigmaStyleTableCard,
+  renderFloorMapFallbackPlaceholder,
   useFloorMapLayoutContext
 });

package/lib/components/pisellFloorMapLayout/locales.d.ts

@@ -46,6 +46,8 @@ declare const _default: {
         'pisell-floor-map-layout.edit-panel.extra-image-url': string;
         'pisell-floor-map-layout.edit-panel.ph-https': string;
         'pisell-floor-map-layout.edit-panel.label-canvas': string;
+        'pisell-floor-map-layout.edit-panel.label-element-kind': string;
+        'pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared': string;
         'pisell-floor-map-layout.edit-panel.apply': string;
         'pisell-floor-map-layout.edit-panel.data-binding': string;
         'pisell-floor-map-layout.edit-panel.data-binding-note': string;
@@ -106,6 +108,8 @@ declare const _default: {
         'pisell-floor-map-layout.edit-panel.extra-image-url': string;
         'pisell-floor-map-layout.edit-panel.ph-https': string;
         'pisell-floor-map-layout.edit-panel.label-canvas': string;
+        'pisell-floor-map-layout.edit-panel.label-element-kind': string;
+        'pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared': string;
         'pisell-floor-map-layout.edit-panel.apply': string;
         'pisell-floor-map-layout.edit-panel.data-binding': string;
         'pisell-floor-map-layout.edit-panel.data-binding-note': string;
@@ -166,6 +170,8 @@ declare const _default: {
         'pisell-floor-map-layout.edit-panel.extra-image-url': string;
         'pisell-floor-map-layout.edit-panel.ph-https': string;
         'pisell-floor-map-layout.edit-panel.label-canvas': string;
+        'pisell-floor-map-layout.edit-panel.label-element-kind': string;
+        'pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared': string;
         'pisell-floor-map-layout.edit-panel.apply': string;
         'pisell-floor-map-layout.edit-panel.data-binding': string;
         'pisell-floor-map-layout.edit-panel.data-binding-note': string;

package/lib/components/pisellFloorMapLayout/locales.js

@@ -50,7 +50,7 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.element-props": "Element",
     "pisell-floor-map-layout.edit-panel.close-aria": "Close",
     "pisell-floor-map-layout.edit-panel.hint-apply": "Position or size changed — click Apply to update the canvas.",
-    "pisell-floor-map-layout.edit-panel.hint-save": "Layout draft is not saved — click Save at the top.",
+    "pisell-floor-map-layout.edit-panel.hint-save": "Layout draft is not saved — click Done editing to save.",
     "pisell-floor-map-layout.edit-panel.section-layout": "Position · Layer · Size",
     "pisell-floor-map-layout.edit-panel.lock-on": "Locked: drag/resize disabled on canvas; click to unlock",
     "pisell-floor-map-layout.edit-panel.lock-off": "Lock to disable drag and resize on canvas",
@@ -67,6 +67,8 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.extra-image-url": "Use a network image URL; lower layer to place under tables.",
     "pisell-floor-map-layout.edit-panel.ph-https": "https://...",
     "pisell-floor-map-layout.edit-panel.label-canvas": "Canvas",
+    "pisell-floor-map-layout.edit-panel.label-element-kind": "Element type",
+    "pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "Data binding was cleared because it does not apply to the new type.",
     "pisell-floor-map-layout.edit-panel.apply": "Apply",
     "pisell-floor-map-layout.edit-panel.data-binding": "Data binding",
     "pisell-floor-map-layout.edit-panel.data-binding-note": "Changing data source or row writes to the layout draft; click Save at the top to persist.",
@@ -110,7 +112,7 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.element-props": "图元属性",
     "pisell-floor-map-layout.edit-panel.close-aria": "关闭",
     "pisell-floor-map-layout.edit-panel.hint-apply": "位置、尺寸等已修改，请点击「应用」同步到画布。",
-    "pisell-floor-map-layout.edit-panel.hint-save": "布局草稿未持久化，请点击顶部「保存」。",
+    "pisell-floor-map-layout.edit-panel.hint-save": "布局草稿未持久化，请点击「完成编辑」保存。",
     "pisell-floor-map-layout.edit-panel.section-layout": "位置 · 层级 · 尺寸",
     "pisell-floor-map-layout.edit-panel.lock-on": "已锁定：画布不可拖拽/缩放；点击解锁",
     "pisell-floor-map-layout.edit-panel.lock-off": "锁定后画布不可拖拽与改尺寸",
@@ -127,6 +129,8 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.extra-image-url": "可填网络图片地址；将层级调低可铺在桌位下方作底图。",
     "pisell-floor-map-layout.edit-panel.ph-https": "https://...",
     "pisell-floor-map-layout.edit-panel.label-canvas": "所属画布",
+    "pisell-floor-map-layout.edit-panel.label-element-kind": "图元类型",
+    "pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "新类型与原先绑定不兼容，已清除数据绑定。",
     "pisell-floor-map-layout.edit-panel.apply": "应用",
     "pisell-floor-map-layout.edit-panel.data-binding": "数据绑定",
     "pisell-floor-map-layout.edit-panel.data-binding-note": "修改数据源或绑定行会立即写入布局草稿；持久化请点击顶部「保存」。",
@@ -170,7 +174,7 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.element-props": "圖元屬性",
     "pisell-floor-map-layout.edit-panel.close-aria": "關閉",
     "pisell-floor-map-layout.edit-panel.hint-apply": "位置、尺寸等已修改，請點擊「套用」同步到畫布。",
-    "pisell-floor-map-layout.edit-panel.hint-save": "佈局草稿未持久化，請點擊頂部「儲存」。",
+    "pisell-floor-map-layout.edit-panel.hint-save": "佈局草稿未持久化，請點擊「完成編輯」儲存。",
     "pisell-floor-map-layout.edit-panel.section-layout": "位置 · 層級 · 尺寸",
     "pisell-floor-map-layout.edit-panel.lock-on": "已鎖定：畫布不可拖曳/縮放；點擊解鎖",
     "pisell-floor-map-layout.edit-panel.lock-off": "鎖定後畫布不可拖曳與改尺寸",
@@ -187,6 +191,8 @@ var locales_default = {
     "pisell-floor-map-layout.edit-panel.extra-image-url": "可填網絡圖片地址；將層級調低可鋪在桌位下方作底圖。",
     "pisell-floor-map-layout.edit-panel.ph-https": "https://...",
     "pisell-floor-map-layout.edit-panel.label-canvas": "所屬畫布",
+    "pisell-floor-map-layout.edit-panel.label-element-kind": "圖元類型",
+    "pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "新類型與原先綁定不相容，已清除數據綁定。",
     "pisell-floor-map-layout.edit-panel.apply": "套用",
     "pisell-floor-map-layout.edit-panel.data-binding": "數據綁定",
     "pisell-floor-map-layout.edit-panel.data-binding-note": "修改數據源或綁定行會立即寫入佈局草稿；持久化請點擊頂部「儲存」。",

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

@@ -82,8 +82,8 @@ export interface FloorMapZoomConfig {
     /** 缩放步进，默认 0.1 (10%) */
     step?: number;
     /**
-     * 为 true 时：挂载后每个画布（frameResetKey）自动执行一次 fitBounds，使图元落在视口内。
-     * 为 true 时跳过「首帧 defaultScale 左上对齐」，避免与 fit 闪动叠加。
+     * 为 false 时关闭；未传或其它值时默认开启（平面图像素模式且当前画布有图元时，每画布自动 fitBounds 一次，可视区域刚好容纳全部图元）。
+     * 开启时跳过「首帧 defaultScale 左上对齐」，避免与 fit 闪动叠加。
      */
     autoFitOnMount?: boolean;
 }
@@ -108,6 +108,10 @@ export interface FloorMapControlsConfig {
     showFitBounds?: boolean;
     /** 是否显示全屏按钮，默认 false */
     showFullscreen?: boolean;
+    /**
+     * 是否显示网格开关（写入当前画布 draft 的 mapLayer.showGrid），默认 false
+     */
+    showGridToggle?: boolean;
 }
 /**
  * 布局模式（规则网格 vs 完全自由坐标）
@@ -317,7 +321,10 @@ export declare type FloorMapPlaceMode = null | {
     type: 'scene';
     elementKind: string;
     dataSourceKey?: string;
+    /** 单选落一条；与 {@link recordIds} 二选一，多选时优先 {@link recordIds} */
     recordId?: string;
+    /** 多选后在画布一次落多条，按锚点阶梯偏移 */
+    recordIds?: string[];
 };
 /** 阅读态 renderItem 可选第三参数 */
 export interface FloorMapRenderOptions {

package/lib/components/pisellFloorMapLayout/utils/floorMapDropUtils.d.ts

@@ -7,6 +7,7 @@ export interface FloorMapPaletteDragPayload {
     elementKind: string;
     dataSourceKey?: string;
     recordId?: string;
+    recordIds?: string[];
 }
 /**
  * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移

package/lib/components/pisellFloorMapLayout/utils/floorMapDropUtils.js

@@ -47,7 +47,13 @@ function parsePaletteDragPayload(dt) {
     if (typeof elementKind !== "string" || !elementKind) return null;
     const dataSourceKey = typeof rec.dataSourceKey === "string" ? rec.dataSourceKey : void 0;
     const recordId = typeof rec.recordId === "string" ? rec.recordId : void 0;
-    return { elementKind, dataSourceKey, recordId };
+    let recordIds;
+    const rawIds = rec.recordIds;
+    if (Array.isArray(rawIds)) {
+      recordIds = rawIds.filter((x) => typeof x === "string" && x);
+      if (recordIds.length === 0) recordIds = void 0;
+    }
+    return { elementKind, dataSourceKey, recordId, recordIds };
   } catch {
     return null;
   }

package/lib/components/pisellFloorMapLayout/utils/floorMapElementKindUtils.d.ts

@@ -2,9 +2,20 @@
  * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
  */
 import type { FloorMapElementKindConfig, FloorMapViewConfig, FloorMapSceneElement, FloorMapDataSources, FloorMapElementDataBindingPolicy } from '../types';
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export declare function isFloorMapImageElementKind(kind: string | undefined): boolean;
 /** dataBindingPolicy 缺省视为 none */
 export declare function resolveDataBindingPolicy(kind: FloorMapElementKindConfig | undefined): FloorMapElementDataBindingPolicy;
 export declare function getElementKindConfig(config: Pick<FloorMapViewConfig, 'elementKinds'> | undefined, elementKind: string | undefined): FloorMapElementKindConfig | undefined;
+/**
+ * 与调色板分组一致：取与当前图元 **同一 categoryId**（含未填 categoryId 时落到首个分类）下的可切换种类，
+ * 排除舞台、底图。若仅有一种则编辑面板可不展示切换器。
+ */
+export declare function getSwappableElementKindsInSameCategory(config: FloorMapViewConfig, elementKind: string | undefined): FloorMapElementKindConfig[];
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 kind 时的草稿 patch（绑定不兼容则清空）
+ */
+export declare function patchSceneElementForKindSwitch(config: FloorMapViewConfig, element: FloorMapSceneElement, nextKindValue: string): Partial<FloorMapSceneElement>;
 /**
  * @returns 人类可读错误文案；无问题时返回 null
  */