@pisell/materials 1.8.23 → 1.8.24

package/es/components/pisellFloorMapLayout/components/FloorMapToolbar.js

@@ -21,8 +21,11 @@ import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../t
 import { resolveDataBindingPolicy } from "../utils/floorMapElementKindUtils";
 import { FLOOR_MAP_PALETTE_DRAG_MIME } from "../utils/floorMapDropUtils";
 import { formatDataRecordOptionLabel } from "../utils/floorMapDataRecordLabel";
+import { locales } from '@pisell/utils';
 import "./FloorMapToolbar.less";
 var PREFIX = 'pisell-floor-map-layout';
+var I18N_TB = 'pisell-floor-map-layout.toolbar';
+var I18N_EP_DS = 'pisell-floor-map-layout.edit-panel.ph-data-source';
 var DEFAULT_PLACEMENT_SIZE = {
   width: 180,
   height: 120
@@ -115,7 +118,7 @@ export function FloorMapToolbar(props) {
     });
     return sorted.length ? sorted : [{
       id: '_uncat',
-      label: '图元',
+      label: locales.getText("".concat(I18N_TB, ".category-fallback")),
       order: 0
     }];
   }, [config.elementKindCategories]);
@@ -233,7 +236,7 @@ export function FloorMapToolbar(props) {
         e.dataTransfer.setData(FLOOR_MAP_PALETTE_DRAG_MIME, JSON.stringify(paletteDragPayload));
         e.dataTransfer.effectAllowed = 'copy';
       },
-      title: "\u70B9\u51FB\u540E\u753B\u5E03\u843D\u70B9\uFF0C\u6216\u62D6\u62FD\u5230\u753B\u5E03\u751F\u6210\u300C".concat(k.label, "\u300D")
+      title: locales.getText("".concat(I18N_TB, ".palette-card-title")).replace(/\{name\}/g, k.label)
     }, /*#__PURE__*/React.createElement("div", {
       className: "".concat(PREFIX, "-toolbar-preview-cell"),
       style: {
@@ -261,8 +264,8 @@ export function FloorMapToolbar(props) {
       className: "".concat(PREFIX, "-toolbar-record-pick")
     }, /*#__PURE__*/React.createElement("div", {
       className: "".concat(PREFIX, "-toolbar-record-pick-label")
-    }, "\u6570\u636E\u7ED1\u5B9A\uFF08\u53EF\u9009\uFF09"), /*#__PURE__*/React.createElement(Select, {
-      placeholder: "\u9009\u62E9\u6570\u636E\u6E90",
+    }, locales.getText("".concat(I18N_TB, ".data-binding-optional"))), /*#__PURE__*/React.createElement(Select, {
+      placeholder: locales.getText(I18N_EP_DS),
       allowClear: true,
       value: placeMode.type === 'scene' ? placeMode.dataSourceKey : undefined,
       options: allowedKeys.map(function (key) {
@@ -285,18 +288,18 @@ export function FloorMapToolbar(props) {
       if (!key) {
         return /*#__PURE__*/React.createElement("div", {
           className: "".concat(PREFIX, "-toolbar-record-pick-hint")
-        }, "\u9009\u62E9\u6570\u636E\u6E90\u540E\u53EF\u9009\u7ED1\u5B9A\u6570\u636E\u884C\uFF0C\u6216\u76F4\u63A5\u843D\u70B9\u5360\u4F4D\u3002");
+        }, locales.getText("".concat(I18N_TB, ".hint-after-select-ds")));
       }
       var unplaced = getUnplacedRecordsForKey(key, dataSources, sceneElements);
       if (unplaced.length === 0) {
         return /*#__PURE__*/React.createElement("div", {
           className: "".concat(PREFIX, "-toolbar-record-pick-hint")
-        }, "\u5F53\u524D\u6570\u636E\u6E90\u65E0\u672A\u7ED1\u5B9A\u8BB0\u5F55\uFF0C\u6216\u5217\u8868\u4E3A\u7A7A\uFF1B\u53EF\u76F4\u63A5\u5728\u753B\u5E03\u843D\u70B9\u5360\u4F4D\u3002");
+        }, locales.getText("".concat(I18N_TB, ".hint-no-unplaced-rows")));
       }
       var recordValue = mode !== null && mode !== void 0 && mode.recordIds && mode.recordIds.length > 0 ? mode.recordIds : mode !== null && mode !== void 0 && mode.recordId ? [mode.recordId] : undefined;
       return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(Select, {
         mode: "multiple",
-        placeholder: "\u9009\u62E9\u8981\u5C55\u793A\u7684\u8BB0\u5F55\uFF08\u53EF\u9009\uFF0C\u53EF\u591A\u9009\uFF09",
+        placeholder: locales.getText("".concat(I18N_TB, ".ph-select-records")),
         allowClear: true,
         maxTagCount: "responsive",
         value: recordValue,
@@ -316,18 +319,18 @@ export function FloorMapToolbar(props) {
         }
       }), /*#__PURE__*/React.createElement("div", {
         className: "".concat(PREFIX, "-toolbar-record-pick-hint")
-      }, "\u53EF\u9009\u591A\u6761\uFF0C\u5728\u753B\u5E03\u70B9\u51FB\u4E00\u6B21\u5C06\u6309\u9636\u68AF\u504F\u79FB\u843D\u591A\u6761\uFF1B\u7559\u7A7A\u5219\u5148\u5360\u4F4D\uFF0C\u7A0D\u540E\u5728\u4FA7\u680F\u7ED1\u5B9A\u3002"));
+      }, locales.getText("".concat(I18N_TB, ".hint-multi-drop"))));
     }()), allowedKeys.length === 0 && /*#__PURE__*/React.createElement("div", {
       className: "".concat(PREFIX, "-toolbar-record-hint")
-    }, "\u65E0\u53EF\u7528\u6570\u636E\u6E90"), /*#__PURE__*/React.createElement("button", {
+    }, locales.getText("".concat(I18N_TB, ".no-data-sources"))), /*#__PURE__*/React.createElement("button", {
       type: "button",
       className: "".concat(PREFIX, "-toolbar-btn cancel-inline"),
       onClick: cancelPlaceMode
-    }, "\u53D6\u6D88\u65B0\u5EFA")), isActive && policy === 'none' && /*#__PURE__*/React.createElement("button", {
+    }, locales.getText("".concat(I18N_TB, ".cancel-place")))), isActive && policy === 'none' && /*#__PURE__*/React.createElement("button", {
       type: "button",
       className: "".concat(PREFIX, "-toolbar-btn cancel-inline"),
       onClick: cancelPlaceMode
-    }, "\u53D6\u6D88\u65B0\u5EFA"));
+    }, locales.getText("".concat(I18N_TB, ".cancel-place"))));
   };
   return /*#__PURE__*/React.createElement("div", {
     className: classNames("".concat(PREFIX, "-toolbar"), "".concat(PREFIX, "-toolbar-sidebar"), className)
@@ -354,13 +357,13 @@ export function FloorMapToolbar(props) {
   }, layoutDirty ? /*#__PURE__*/React.createElement("span", {
     className: "".concat(PREFIX, "-toolbar-dirty-hint"),
     role: "status"
-  }, "\u5E03\u5C40\u5DF2\u4FEE\u6539\uFF0C\u8BF7\u70B9\u51FB\u300C\u4FDD\u5B58\u300D\u6301\u4E45\u5316\u3002") : null, saveError && /*#__PURE__*/React.createElement("span", {
+  }, locales.getText("".concat(I18N_TB, ".layout-dirty-hint"))) : null, saveError && /*#__PURE__*/React.createElement("span", {
     className: "".concat(PREFIX, "-toolbar-error")
   }, typeof saveError === 'string' ? saveError : saveError === null || saveError === void 0 ? void 0 : saveError.message), /*#__PURE__*/React.createElement("button", {
     type: "button",
     className: classNames("".concat(PREFIX, "-toolbar-btn"), 'primary', _defineProperty({}, "".concat(PREFIX, "-toolbar-save-dirty"), layoutDirty)),
     disabled: saving,
     onClick: onSave
-  }, saving ? '保存中...' : '保存')));
+  }, saving ? locales.getText("".concat(I18N_TB, ".saving")) : locales.getText("".concat(I18N_TB, ".save")))));
 }
 export default FloorMapToolbar;

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

@@ -0,0 +1,48 @@
+/**
+ * ItemLayer - 楼层图展示层
+ * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
+ */
+import React from 'react';
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+import type { CSSProperties } from 'react';
+import './ItemLayer.less';
+export interface ItemLayerProps<T extends FloorMapItemBase> {
+    /** 资源列表 */
+    items: T[];
+    /** 每项渲染函数 */
+    renderItem: (item: T, index: number) => React.ReactNode;
+    /** 每项 key */
+    rowKey?: string | ((item: T, index: number) => string);
+    /** 每格像素尺寸（cell 单位时用；pixel 单位时作为缺省宽高） */
+    cellSize: number;
+    /** item 坐标与尺寸单位：cell 格子数，pixel 像素 */
+    itemUnit?: FloorMapItemUnit;
+    /** item 之间的间距（像素），仅 cell 单位时生效 */
+    itemGap?: number;
+    /** 内容区总宽度（像素），由 items 推导或外部传入 */
+    contentWidth: number;
+    /** 内容区总高度（像素） */
+    contentHeight: number;
+    /** 内容区 X 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
+    contentOffsetX?: number;
+    /** 内容区 Y 偏移 */
+    contentOffsetY?: number;
+    /** 是否启用 hover 事件 */
+    enableHover?: boolean;
+    /** 点击回调 */
+    onItemClick?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** hover 进入 */
+    onItemHover?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** hover 离开 */
+    onItemLeave?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** 每项外层容器额外样式（与定位样式合并） */
+    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
+    /**
+     * 与编辑态一致：在含 `data-pisell-floor-room-scroll-surface` 的区域内按下时置 true，
+     * 用于禁用 Transform 画布平移，避免图元内纵向滑动拖动画布。
+     */
+    onInteractionChange?: (active: boolean) => void;
+    className?: string;
+}
+export declare function ItemLayer<T extends FloorMapItemBase>(props: ItemLayerProps<T>): JSX.Element;
+export default ItemLayer;

package/es/components/pisellFloorMapLayout/components/ItemLayer.js

@@ -14,10 +14,13 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  * ItemLayer - 楼层图展示层
  * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
  */
-import React, { useMemo } from 'react';
+import React, { useCallback, useEffect, useMemo } from 'react';
 import classNames from 'classnames';
 import "./ItemLayer.less";
 var PREFIX = 'pisell-floor-map-layout';
+
+/** 图元内可滚动区标记（如预约房间卡 body / multi-list），与 private-materials 约定一致 */
+var ROOM_SCROLL_SURFACE_SELECTOR = '[data-pisell-floor-room-scroll-surface]';
 function getItemKey(item, index, rowKey) {
   var _rowKey;
   if (!rowKey) return item.id;
@@ -67,7 +70,50 @@ export function ItemLayer(props) {
     onItemHover = props.onItemHover,
     onItemLeave = props.onItemLeave,
     getMergedItemWrapperStyle = props.getMergedItemWrapperStyle,
+    onInteractionChange = props.onInteractionChange,
     className = props.className;
+
+  /** 触控/指针在房间卡滚动区内按下时禁用画布 pan，松手恢复 */
+  var notifyRoomScrollSurfaceActive = useCallback(function () {
+    if (!onInteractionChange) return;
+    onInteractionChange(true);
+    var finish = function finish() {
+      onInteractionChange(false);
+    };
+    window.addEventListener('pointerup', finish, {
+      once: true
+    });
+    window.addEventListener('pointercancel', finish, {
+      once: true
+    });
+    window.addEventListener('touchend', finish, {
+      once: true,
+      passive: true
+    });
+    window.addEventListener('touchcancel', finish, {
+      once: true,
+      passive: true
+    });
+  }, [onInteractionChange]);
+  var handleItemPointerDownCapture = useCallback(function (e) {
+    var _el$closest;
+    if (!onInteractionChange || e.button !== 0) return;
+    var el = e.target;
+    if (!(el !== null && el !== void 0 && (_el$closest = el.closest) !== null && _el$closest !== void 0 && _el$closest.call(el, ROOM_SCROLL_SURFACE_SELECTOR))) return;
+    notifyRoomScrollSurfaceActive();
+  }, [onInteractionChange, notifyRoomScrollSurfaceActive]);
+  var handleItemTouchStartCapture = useCallback(function (e) {
+    var _el$closest2;
+    if (!onInteractionChange) return;
+    var el = e.target;
+    if (!(el !== null && el !== void 0 && (_el$closest2 = el.closest) !== null && _el$closest2 !== void 0 && _el$closest2.call(el, ROOM_SCROLL_SURFACE_SELECTOR))) return;
+    notifyRoomScrollSurfaceActive();
+  }, [onInteractionChange, notifyRoomScrollSurfaceActive]);
+  useEffect(function () {
+    return function () {
+      onInteractionChange === null || onInteractionChange === void 0 || onInteractionChange(false);
+    };
+  }, [onInteractionChange]);
   var itemNodes = useMemo(function () {
     var isPixel = itemUnit === 'pixel';
     var g = itemGap;
@@ -118,10 +164,12 @@ export function ItemLayer(props) {
         },
         onMouseLeave: function onMouseLeave(e) {
           return onItemLeave === null || onItemLeave === void 0 ? void 0 : onItemLeave(item, index, e);
-        }
+        },
+        onPointerDownCapture: handleItemPointerDownCapture,
+        onTouchStartCapture: handleItemTouchStartCapture
       }, renderItem(item, index));
     });
-  }, [items, renderItem, rowKey, cellSize, itemUnit, itemGap, enableHover, onItemClick, onItemHover, onItemLeave, getMergedItemWrapperStyle]);
+  }, [items, renderItem, rowKey, cellSize, itemUnit, itemGap, enableHover, onItemClick, onItemHover, onItemLeave, getMergedItemWrapperStyle, handleItemPointerDownCapture, handleItemTouchStartCapture]);
   return /*#__PURE__*/React.createElement("div", {
     className: classNames("".concat(PREFIX, "-item-layer"), className),
     style: {

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

@@ -0,0 +1,30 @@
+/// <reference types="react" />
+import type { FloorMapControlsConfig } from '../types';
+import './ViewControls.less';
+/** 从 react-zoom-pan-pinch 拿到的控制 API（由主组件传入） */
+export interface ViewControlsApi {
+    zoomIn: () => void;
+    zoomOut: () => void;
+    resetTransform: () => void;
+    /** 区域定位，可能由主组件基于 items 计算后封装 */
+    fitBounds?: () => void;
+    /** 切换全屏（requestFullscreen / exitFullscreen） */
+    toggleFullscreen?: () => void;
+}
+export interface ViewControlsProps {
+    /** 控制 API */
+    api: ViewControlsApi;
+    /** 显隐配置 */
+    config?: FloorMapControlsConfig;
+    /** 当前缩放比例（1 = 100%），用于 Stepper 展示 */
+    scale?: number;
+    /** 当前是否处于全屏 */
+    isFullscreen?: boolean;
+    className?: string;
+    /** 与 config.showGridToggle 联用：当前画布是否显示网格 */
+    mapGridVisible?: boolean;
+    /** 切换当前画布 draft 的 mapLayer.showGrid */
+    onToggleMapGrid?: () => void;
+}
+export declare function ViewControls(props: ViewControlsProps): JSX.Element;
+export default ViewControls;

package/es/components/pisellFloorMapLayout/components/ViewControls.js

@@ -8,8 +8,10 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import React from 'react';
 import classNames from 'classnames';
 import { MinusOutlined, PlusOutlined, FullscreenOutlined, FullscreenExitOutlined, BorderInnerOutlined } from '@ant-design/icons';
+import { locales } from '@pisell/utils';
 import "./ViewControls.less";
 var PREFIX = 'pisell-floor-map-layout';
+var I18N_VC = 'pisell-floor-map-layout.view-controls';
 
 /** 从 react-zoom-pan-pinch 拿到的控制 API（由主组件传入） */
 
@@ -42,7 +44,7 @@ export function ViewControls(props) {
     onClick: function onClick() {
       return api.zoomOut();
     },
-    "aria-label": "\u7F29\u5C0F"
+    "aria-label": locales.getText("".concat(I18N_VC, ".zoom-out-aria"))
   }, /*#__PURE__*/React.createElement(MinusOutlined, null)), /*#__PURE__*/React.createElement("span", {
     className: "".concat(PREFIX, "-view-controls-zoom-stepper-value")
   }, scalePercent, "%"), /*#__PURE__*/React.createElement("button", {
@@ -51,7 +53,7 @@ export function ViewControls(props) {
     onClick: function onClick() {
       return api.zoomIn();
     },
-    "aria-label": "\u653E\u5927"
+    "aria-label": locales.getText("".concat(I18N_VC, ".zoom-in-aria"))
   }, /*#__PURE__*/React.createElement(PlusOutlined, null))), showToolsCapsule && /*#__PURE__*/React.createElement("div", {
     className: "".concat(PREFIX, "-view-controls-tools-capsule")
   }, showReset && /*#__PURE__*/React.createElement("button", {
@@ -60,14 +62,14 @@ export function ViewControls(props) {
     onClick: function onClick() {
       return api.resetTransform();
     },
-    "aria-label": "\u590D\u4F4D"
+    "aria-label": locales.getText("".concat(I18N_VC, ".reset-aria"))
   }, "\u27F2"), showFitBounds && api.fitBounds && /*#__PURE__*/React.createElement("button", {
     type: "button",
     className: "".concat(PREFIX, "-view-controls-tool-btn"),
     onClick: function onClick() {
       return api.fitBounds();
     },
-    "aria-label": "\u533A\u57DF\u5B9A\u4F4D"
+    "aria-label": locales.getText("".concat(I18N_VC, ".fit-bounds-aria"))
   }, "\u229E"), showGridToggle && /*#__PURE__*/React.createElement("button", {
     type: "button",
     className: classNames("".concat(PREFIX, "-view-controls-tool-btn"), _defineProperty({}, "".concat(PREFIX, "-view-controls-tool-btn--active"), mapGridVisible)),
@@ -75,14 +77,14 @@ export function ViewControls(props) {
       return onToggleMapGrid();
     },
     "aria-pressed": mapGridVisible,
-    "aria-label": mapGridVisible ? '隐藏网格' : '显示网格'
+    "aria-label": locales.getText(mapGridVisible ? "".concat(I18N_VC, ".grid-hide-aria") : "".concat(I18N_VC, ".grid-show-aria"))
   }, /*#__PURE__*/React.createElement(BorderInnerOutlined, null)), showFullscreen && api.toggleFullscreen && /*#__PURE__*/React.createElement("button", {
     type: "button",
     className: "".concat(PREFIX, "-view-controls-tool-btn"),
     onClick: function onClick() {
       return api.toggleFullscreen();
     },
-    "aria-label": isFullscreen ? '退出全屏' : '全屏'
+    "aria-label": locales.getText(isFullscreen ? "".concat(I18N_VC, ".fullscreen-exit-aria") : "".concat(I18N_VC, ".fullscreen-aria"))
   }, isFullscreen ? /*#__PURE__*/React.createElement(FullscreenExitOutlined, null) : /*#__PURE__*/React.createElement(FullscreenOutlined, null))));
 }
 export default ViewControls;

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

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import type { FloorMapControlsConfig } from '../types';
+export interface ViewControlsWithZoomProps {
+    config?: FloorMapControlsConfig;
+    scale?: number;
+    isFullscreen?: boolean;
+    fitBounds: () => void;
+    /** 未传时不展示全屏按钮（如编辑态 floorMapFullscreenMode 为 disabled） */
+    toggleFullscreen?: () => void;
+    mapGridVisible?: boolean;
+    onToggleMapGrid?: () => void;
+}
+export declare function ViewControlsWithZoom(props: ViewControlsWithZoomProps): JSX.Element;

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

@@ -0,0 +1,21 @@
+/**
+ * 楼层图布局子组件导出
+ */
+export { MapLayer } from './MapLayer';
+export { ItemLayer } from './ItemLayer';
+export { ViewControls } from './ViewControls';
+export { ViewControlsWithZoom } from './ViewControlsWithZoom';
+export { CanvasTabs } from './CanvasTabs';
+export { EditableItemLayer } from './EditableItemLayer';
+export { FloorMapToolbar } from './FloorMapToolbar';
+export { FloorMapEditTopBar } from './FloorMapEditTopBar';
+export { FloorMapEditPanel } from './FloorMapEditPanel';
+export { FloorMapDataForm } from './FloorMapDataForm';
+export type { ViewControlsApi } from './ViewControls';
+export type { ViewControlsWithZoomProps } from './ViewControlsWithZoom';
+export type { CanvasTabsProps } from './CanvasTabs';
+export type { EditableItemLayerProps } from './EditableItemLayer';
+export type { FloorMapToolbarProps, PlaceMode } from './FloorMapToolbar';
+export type { FloorMapEditTopBarProps, FloorMapEditTopBarMode, } from './FloorMapEditTopBar';
+export type { FloorMapEditPanelProps } from './FloorMapEditPanel';
+export type { FloorMapDataFormProps } from './FloorMapDataForm';

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

@@ -0,0 +1,63 @@
+import type { MouseEvent, MutableRefObject } from 'react';
+import type { DataSourceFormColumn, FloorMapCanvasNameI18n, FloorMapDataSourceRecordFormContent, FloorMapDataSources, FloorMapItemBase, FloorMapMergedItem, FloorMapPlaceMode, FloorMapSceneElement, FloorMapViewConfig } from '../types';
+export interface UseFloorMapEditStateParams<T extends FloorMapItemBase> {
+    floorMapConfigProp: FloorMapViewConfig | undefined;
+    isFloorMapView: boolean;
+    itemsProp: T[];
+    cellSizeProp?: number;
+    dataSources: FloorMapDataSources | undefined;
+    onSave: ((config: FloorMapViewConfig) => void) | undefined;
+    onDataSourceRecordSave: ((dataSourceKey: string, id: string, newData: Record<string, unknown>) => void) | undefined;
+    dataSourceFormColumns: Record<string, DataSourceFormColumn[]> | undefined;
+    dataSourceRecordForm: Record<string, FloorMapDataSourceRecordFormContent> | undefined;
+    dataSourceLabels?: Record<string, string>;
+    layoutPrefix: string;
+    contentOffsetRef: MutableRefObject<{
+        x: number;
+        y: number;
+    }>;
+    showDataSourceRecordFormBlock?: boolean;
+}
+export declare function useFloorMapEditState<T extends FloorMapItemBase>(params: UseFloorMapEditStateParams<T>): {
+    config: FloorMapViewConfig | null;
+    currentCanvasId: string | null;
+    setCurrentCanvasId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    selectedId: string | null;
+    setSelectedId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
+    placeMode: FloorMapPlaceMode;
+    setPlaceMode: import("react").Dispatch<import("react").SetStateAction<FloorMapPlaceMode>>;
+    mergedItems: FloorMapMergedItem[];
+    items: T[];
+    saving: boolean;
+    savingRecord: boolean;
+    handleAddCanvas: () => void;
+    handleRemoveCanvas: (canvasId: string) => void;
+    handleRenameCanvas: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
+    handleUpdateItem: (itemId: string, patch: Partial<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>) => void;
+    handleCanvasPlaceClick: (e: MouseEvent<HTMLDivElement>) => void;
+    handleSave: () => void;
+    placeSceneElementFromPaletteDrop: (contentX: number, contentY: number, scene: Extract<FloorMapPlaceMode, {
+        type: 'scene';
+    }>) => void;
+    editPanelParams: {
+        itemId: string;
+        sceneElement: FloorMapSceneElement;
+        onUpdate: (patch: Partial<FloorMapSceneElement>) => void;
+        onSaveRecord: ((dataSourceKey: string, id: string, newData: Record<string, unknown>) => void) | undefined;
+        onClose: () => void;
+        onDelete: (() => void) | undefined;
+        recordFormColumns: Record<string, DataSourceFormColumn[]> | undefined;
+        dataSourceRecordForm: Record<string, FloorMapDataSourceRecordFormContent> | undefined;
+        dataSourceLabels: Record<string, string> | undefined;
+        layoutDraftDirty: boolean;
+        showDataSourceRecordFormBlock: boolean | undefined;
+    } | null;
+    placeOverlayClass: string;
+    isLayoutDirty: boolean;
+    toggleDraftCanvasShowGrid: () => void;
+};

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

@@ -36,6 +36,7 @@ var IMAGE_PLACE_DEFAULT = {
   width: 400,
   height: 240
 };
+var I18N_PLACEMENT_FALLBACK_IMAGE = 'pisell-floor-map-layout.placement.fallback-image-name';
 var GRID_VIS_STORAGE_PREFIX = 'pisell-floor-map-layout.grid-visible';
 function getGridVisStorageKey(canvasId) {
   return "".concat(GRID_VIS_STORAGE_PREFIX, ":").concat(canvasId);
@@ -411,7 +412,7 @@ export function useFloorMapEditState(params) {
     }
     var placementName = function (_kindConfig$defaultPr, _kindConfig$defaultPr2) {
       if (isStage) return STAGE_DECO_DEFAULT.name;
-      if (isImage) return '底图';
+      if (isImage) return locales.getText(I18N_PLACEMENT_FALLBACK_IMAGE);
       var db = dataBinding;
       var rid = recordIdsToPlace[0];
       if (db && rid) {

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

@@ -0,0 +1,15 @@
+/**
+ * PisellFloorMapLayout 组件入口
+ * 空间布局视图：在二维平面按坐标渲染资源，支持缩放/平移/复位；支持 floorMapConfig + mode 平面图视图
+ */
+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, FloorMapViewportOverlayRenderArgs, } 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';
+export { FloorMapImageElement } from './components/FloorMapImageElement';
+export { getFigmaTableCardFromMerged, renderFigmaStyleTableCard, renderFigmaStyleRoundTableCard, getRenderItemByKindTable, getRenderItemByKindRoundTable, } from './components/FigmaTableCard';
+export type { FigmaTableCardItem, FigmaTableStatus, } from './components/FigmaTableCard';

package/es/components/pisellFloorMapLayout/locales-ja.d.ts

@@ -0,0 +1,104 @@
+/**
+ * PisellFloorMapLayout — 日本語
+ */
+declare const _default: {
+    'pisell-floor-map-layout.loading': string;
+    'pisell-floor-map-layout.read-canvas-tabs.aria': string;
+    'pisell-floor-map-layout.edit-top-bar.aria': string;
+    'pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria': string;
+    'pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title': string;
+    'pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria': string;
+    'pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title': string;
+    'pisell-floor-map-layout.edit-top-bar.unsaved': string;
+    'pisell-floor-map-layout.edit-top-bar.save': string;
+    'pisell-floor-map-layout.edit-top-bar.saving': string;
+    'pisell-floor-map-layout.canvas-tabs.empty': string;
+    'pisell-floor-map-layout.canvas-tabs.add': string;
+    'pisell-floor-map-layout.canvas-tabs.add-title': string;
+    'pisell-floor-map-layout.canvas-tabs.hint': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-aria': string;
+    'pisell-floor-map-layout.canvas-tabs.remove-aria': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-title': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-button-aria': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-button-title': string;
+    'pisell-floor-map-layout.canvas-tabs.default-new-canvas-name': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-modal-title': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-modal-ok': string;
+    'pisell-floor-map-layout.canvas-tabs.rename-modal-cancel': string;
+    'pisell-floor-map-layout.edit-panel.element-props': string;
+    'pisell-floor-map-layout.edit-panel.close-aria': string;
+    'pisell-floor-map-layout.edit-panel.hint-apply': string;
+    'pisell-floor-map-layout.edit-panel.hint-save': string;
+    'pisell-floor-map-layout.edit-panel.section-layout': string;
+    'pisell-floor-map-layout.edit-panel.lock-on': string;
+    'pisell-floor-map-layout.edit-panel.lock-off': string;
+    'pisell-floor-map-layout.edit-panel.label-x': string;
+    'pisell-floor-map-layout.edit-panel.label-y': string;
+    'pisell-floor-map-layout.edit-panel.label-z': string;
+    'pisell-floor-map-layout.edit-panel.label-width': string;
+    'pisell-floor-map-layout.edit-panel.label-height': string;
+    'pisell-floor-map-layout.edit-panel.label-name': string;
+    'pisell-floor-map-layout.edit-panel.label-name-stage': string;
+    'pisell-floor-map-layout.edit-panel.ph-name-stage': string;
+    'pisell-floor-map-layout.edit-panel.ph-name': string;
+    'pisell-floor-map-layout.edit-panel.label-image-url': string;
+    '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;
+    'pisell-floor-map-layout.edit-panel.label-data-source': string;
+    'pisell-floor-map-layout.edit-panel.ph-data-source': string;
+    'pisell-floor-map-layout.edit-panel.label-pick-row': string;
+    'pisell-floor-map-layout.edit-panel.ph-pick-row': string;
+    'pisell-floor-map-layout.edit-panel.ph-no-rows': string;
+    'pisell-floor-map-layout.edit-panel.hint-unbound': string;
+    'pisell-floor-map-layout.edit-panel.record-title': string;
+    'pisell-floor-map-layout.edit-panel.pop-title': string;
+    'pisell-floor-map-layout.edit-panel.pop-desc': string;
+    'pisell-floor-map-layout.edit-panel.btn-delete': string;
+    'pisell-floor-map-layout.edit-panel.btn-cancel': string;
+    'pisell-floor-map-layout.edit-panel.btn-ok-delete': string;
+    'pisell-floor-map-layout.toolbar.category-fallback': string;
+    'pisell-floor-map-layout.toolbar.palette-card-title': string;
+    'pisell-floor-map-layout.toolbar.data-binding-optional': string;
+    'pisell-floor-map-layout.toolbar.hint-after-select-ds': string;
+    'pisell-floor-map-layout.toolbar.hint-no-unplaced-rows': string;
+    'pisell-floor-map-layout.toolbar.ph-select-records': string;
+    'pisell-floor-map-layout.toolbar.hint-multi-drop': string;
+    'pisell-floor-map-layout.toolbar.no-data-sources': string;
+    'pisell-floor-map-layout.toolbar.cancel-place': string;
+    'pisell-floor-map-layout.toolbar.layout-dirty-hint': string;
+    'pisell-floor-map-layout.toolbar.save': string;
+    'pisell-floor-map-layout.toolbar.saving': string;
+    'pisell-floor-map-layout.view-controls.zoom-out-aria': string;
+    'pisell-floor-map-layout.view-controls.zoom-in-aria': string;
+    'pisell-floor-map-layout.view-controls.reset-aria': string;
+    'pisell-floor-map-layout.view-controls.fit-bounds-aria': string;
+    'pisell-floor-map-layout.view-controls.grid-hide-aria': string;
+    'pisell-floor-map-layout.view-controls.grid-show-aria': string;
+    'pisell-floor-map-layout.view-controls.fullscreen-aria': string;
+    'pisell-floor-map-layout.view-controls.fullscreen-exit-aria': string;
+    'pisell-floor-map-layout.image-element.default-name': string;
+    'pisell-floor-map-layout.placement.fallback-image-name': string;
+    'pisell-floor-map-layout.image-element.hint-no-url': string;
+    'pisell-floor-map-layout.image-element.hint-load-fail': string;
+    'pisell-floor-map-layout.data-form.empty': string;
+    'pisell-floor-map-layout.data-form.save-record': string;
+    'pisell-floor-map-layout.binding-error.required-row': string;
+    'pisell-floor-map-layout.binding-error.ds-not-allowed': string;
+    'pisell-floor-map-layout.binding-error.missing-field': string;
+    'pisell-floor-map-layout.card-placeholder.hint-select-row': string;
+    'pisell-floor-map-layout.card-placeholder.hint-bind-datasource': string;
+    'pisell-floor-map-layout.card-placeholder.hint-new-slot': string;
+    'pisell-floor-map-layout.card-placeholder.hint-row-not-found': string;
+    'pisell-floor-map-layout.figma-card.kind-round-table': string;
+    'pisell-floor-map-layout.figma-card.kind-square-table': string;
+    'pisell-floor-map-layout.figma-card.default-table': string;
+    'pisell-floor-map-layout.figma-card.capacity-seats': string;
+    'pisell-floor-map-layout.figma-card.guests-count': string;
+};
+export default _default;