@pisell/materials 1.0.1059 → 1.0.1062

package/lib/components/pisellFloorMapLayout/locales.js

@@ -0,0 +1,206 @@
+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/locales.ts
+var locales_exports = {};
+__export(locales_exports, {
+  default: () => locales_default
+});
+module.exports = __toCommonJS(locales_exports);
+var locales_default = {
+  en: {
+    "pisell-floor-map-layout.loading": "Loading...",
+    "pisell-floor-map-layout.read-canvas-tabs.aria": "Switch floor plan canvas",
+    "pisell-floor-map-layout.edit-top-bar.aria": "Floor plan editor toolbar",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria": "Fullscreen",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title": "Fullscreen (top bar with save and fit bounds, etc.)",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria": "Exit fullscreen",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title": "Exit fullscreen",
+    "pisell-floor-map-layout.edit-top-bar.unsaved": "Unsaved",
+    "pisell-floor-map-layout.edit-top-bar.save": "Save",
+    "pisell-floor-map-layout.edit-top-bar.saving": "Saving…",
+    "pisell-floor-map-layout.canvas-tabs.empty": "No canvas",
+    "pisell-floor-map-layout.canvas-tabs.add": "+ Add floor",
+    "pisell-floor-map-layout.canvas-tabs.add-title": "Add floor",
+    "pisell-floor-map-layout.canvas-tabs.hint": "Click 「Add floor」 to create a canvas",
+    "pisell-floor-map-layout.canvas-tabs.rename-aria": "Rename",
+    "pisell-floor-map-layout.canvas-tabs.remove-aria": "Remove",
+    "pisell-floor-map-layout.canvas-tabs.rename-title": "Double-click to rename, or tap the pencil on touch screens",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-aria": "Rename canvas",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-title": "Rename",
+    "pisell-floor-map-layout.canvas-tabs.default-new-canvas-name": "New floor",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-title": "Rename canvas",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "OK",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "Cancel",
+    "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.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",
+    "pisell-floor-map-layout.edit-panel.label-x": "X",
+    "pisell-floor-map-layout.edit-panel.label-y": "Y",
+    "pisell-floor-map-layout.edit-panel.label-z": "Layer",
+    "pisell-floor-map-layout.edit-panel.label-width": "Width",
+    "pisell-floor-map-layout.edit-panel.label-height": "Height",
+    "pisell-floor-map-layout.edit-panel.label-name": "Name",
+    "pisell-floor-map-layout.edit-panel.label-name-stage": "Display name (on canvas)",
+    "pisell-floor-map-layout.edit-panel.ph-name-stage": "e.g. stage, DJ booth, dance floor",
+    "pisell-floor-map-layout.edit-panel.ph-name": "Element name",
+    "pisell-floor-map-layout.edit-panel.label-image-url": "Image URL",
+    "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.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.",
+    "pisell-floor-map-layout.edit-panel.label-data-source": "Data source",
+    "pisell-floor-map-layout.edit-panel.ph-data-source": "Select data source",
+    "pisell-floor-map-layout.edit-panel.label-pick-row": "Pick row",
+    "pisell-floor-map-layout.edit-panel.ph-pick-row": "Pick a row from the data table",
+    "pisell-floor-map-layout.edit-panel.ph-no-rows": "No available rows in this data source",
+    "pisell-floor-map-layout.edit-panel.hint-unbound": "Leave empty or clear when unbound; after binding you can edit record fields.",
+    "pisell-floor-map-layout.edit-panel.record-title": "Data record",
+    "pisell-floor-map-layout.edit-panel.pop-title": "Delete this element?",
+    "pisell-floor-map-layout.edit-panel.pop-desc": "It will be removed from the floor plan draft; click Save at the top to persist.",
+    "pisell-floor-map-layout.edit-panel.btn-delete": "Delete",
+    "pisell-floor-map-layout.edit-panel.btn-cancel": "Cancel",
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "Delete"
+  },
+  "zh-CN": {
+    "pisell-floor-map-layout.loading": "加载中…",
+    "pisell-floor-map-layout.read-canvas-tabs.aria": "切换平面图画布",
+    "pisell-floor-map-layout.edit-top-bar.aria": "平面图编辑顶栏",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria": "全屏",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title": "全屏（顶栏含保存与区域定位等）",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria": "退出全屏",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title": "退出全屏",
+    "pisell-floor-map-layout.edit-top-bar.unsaved": "未保存",
+    "pisell-floor-map-layout.edit-top-bar.save": "保存",
+    "pisell-floor-map-layout.edit-top-bar.saving": "保存中…",
+    "pisell-floor-map-layout.canvas-tabs.empty": "暂无画布",
+    "pisell-floor-map-layout.canvas-tabs.add": "+ 添加楼层",
+    "pisell-floor-map-layout.canvas-tabs.add-title": "添加楼层",
+    "pisell-floor-map-layout.canvas-tabs.hint": "请点击右侧「添加楼层」创建画布",
+    "pisell-floor-map-layout.canvas-tabs.rename-aria": "重命名",
+    "pisell-floor-map-layout.canvas-tabs.remove-aria": "删除",
+    "pisell-floor-map-layout.canvas-tabs.rename-title": "双击重命名；触屏请点击标签右侧铅笔图标",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-aria": "重命名画布",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-title": "重命名",
+    "pisell-floor-map-layout.canvas-tabs.default-new-canvas-name": "新楼层",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-title": "重命名画布",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "确定",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "取消",
+    "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.section-layout": "位置 · 层级 · 尺寸",
+    "pisell-floor-map-layout.edit-panel.lock-on": "已锁定：画布不可拖拽/缩放；点击解锁",
+    "pisell-floor-map-layout.edit-panel.lock-off": "锁定后画布不可拖拽与改尺寸",
+    "pisell-floor-map-layout.edit-panel.label-x": "X",
+    "pisell-floor-map-layout.edit-panel.label-y": "Y",
+    "pisell-floor-map-layout.edit-panel.label-z": "层级",
+    "pisell-floor-map-layout.edit-panel.label-width": "宽度",
+    "pisell-floor-map-layout.edit-panel.label-height": "高度",
+    "pisell-floor-map-layout.edit-panel.label-name": "名称",
+    "pisell-floor-map-layout.edit-panel.label-name-stage": "显示名称（画布上）",
+    "pisell-floor-map-layout.edit-panel.ph-name-stage": "如：舞台、DJ 台、舞池",
+    "pisell-floor-map-layout.edit-panel.ph-name": "图元名称",
+    "pisell-floor-map-layout.edit-panel.label-image-url": "图片地址（URL）",
+    "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.apply": "应用",
+    "pisell-floor-map-layout.edit-panel.data-binding": "数据绑定",
+    "pisell-floor-map-layout.edit-panel.data-binding-note": "修改数据源或绑定行会立即写入布局草稿；持久化请点击顶部「保存」。",
+    "pisell-floor-map-layout.edit-panel.label-data-source": "数据源",
+    "pisell-floor-map-layout.edit-panel.ph-data-source": "选择数据源",
+    "pisell-floor-map-layout.edit-panel.label-pick-row": "选择数据行",
+    "pisell-floor-map-layout.edit-panel.ph-pick-row": "绑定数据表中的一行",
+    "pisell-floor-map-layout.edit-panel.ph-no-rows": "当前数据源暂无可用行",
+    "pisell-floor-map-layout.edit-panel.hint-unbound": "未绑定行时可先留空或清除；绑定后可编辑「数据源记录」字段。",
+    "pisell-floor-map-layout.edit-panel.record-title": "数据源记录",
+    "pisell-floor-map-layout.edit-panel.pop-title": "确定删除该图元？",
+    "pisell-floor-map-layout.edit-panel.pop-desc": "将从当前平面图草稿中移除；删除后请点击顶部「保存」以持久化布局。",
+    "pisell-floor-map-layout.edit-panel.btn-delete": "删除",
+    "pisell-floor-map-layout.edit-panel.btn-cancel": "取消",
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "删除"
+  },
+  "zh-HK": {
+    "pisell-floor-map-layout.loading": "載入中…",
+    "pisell-floor-map-layout.read-canvas-tabs.aria": "切換平面圖畫布",
+    "pisell-floor-map-layout.edit-top-bar.aria": "平面圖編輯頂欄",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-aria": "全螢幕",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-enter-title": "全螢幕（頂欄含儲存與區域定位等）",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-aria": "退出全螢幕",
+    "pisell-floor-map-layout.edit-top-bar.fullscreen-exit-title": "退出全螢幕",
+    "pisell-floor-map-layout.edit-top-bar.unsaved": "未儲存",
+    "pisell-floor-map-layout.edit-top-bar.save": "儲存",
+    "pisell-floor-map-layout.edit-top-bar.saving": "儲存中…",
+    "pisell-floor-map-layout.canvas-tabs.empty": "暫無畫布",
+    "pisell-floor-map-layout.canvas-tabs.add": "+ 添加樓層",
+    "pisell-floor-map-layout.canvas-tabs.add-title": "添加樓層",
+    "pisell-floor-map-layout.canvas-tabs.hint": "請點擊右側「添加樓層」建立畫布",
+    "pisell-floor-map-layout.canvas-tabs.rename-aria": "重新命名",
+    "pisell-floor-map-layout.canvas-tabs.remove-aria": "刪除",
+    "pisell-floor-map-layout.canvas-tabs.rename-title": "雙擊重新命名；觸控請點標籤右側鉛筆圖標",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-aria": "重新命名畫布",
+    "pisell-floor-map-layout.canvas-tabs.rename-button-title": "重新命名",
+    "pisell-floor-map-layout.canvas-tabs.default-new-canvas-name": "新樓層",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-title": "重新命名畫布",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "確定",
+    "pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "取消",
+    "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.section-layout": "位置 · 層級 · 尺寸",
+    "pisell-floor-map-layout.edit-panel.lock-on": "已鎖定：畫布不可拖曳/縮放；點擊解鎖",
+    "pisell-floor-map-layout.edit-panel.lock-off": "鎖定後畫布不可拖曳與改尺寸",
+    "pisell-floor-map-layout.edit-panel.label-x": "X",
+    "pisell-floor-map-layout.edit-panel.label-y": "Y",
+    "pisell-floor-map-layout.edit-panel.label-z": "層級",
+    "pisell-floor-map-layout.edit-panel.label-width": "寬度",
+    "pisell-floor-map-layout.edit-panel.label-height": "高度",
+    "pisell-floor-map-layout.edit-panel.label-name": "名稱",
+    "pisell-floor-map-layout.edit-panel.label-name-stage": "顯示名稱（畫布上）",
+    "pisell-floor-map-layout.edit-panel.ph-name-stage": "如：舞台、DJ 台、舞池",
+    "pisell-floor-map-layout.edit-panel.ph-name": "圖元名稱",
+    "pisell-floor-map-layout.edit-panel.label-image-url": "圖片地址（URL）",
+    "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.apply": "套用",
+    "pisell-floor-map-layout.edit-panel.data-binding": "數據綁定",
+    "pisell-floor-map-layout.edit-panel.data-binding-note": "修改數據源或綁定行會立即寫入佈局草稿；持久化請點擊頂部「儲存」。",
+    "pisell-floor-map-layout.edit-panel.label-data-source": "數據源",
+    "pisell-floor-map-layout.edit-panel.ph-data-source": "選擇數據源",
+    "pisell-floor-map-layout.edit-panel.label-pick-row": "選擇數據行",
+    "pisell-floor-map-layout.edit-panel.ph-pick-row": "綁定數據表中的一行",
+    "pisell-floor-map-layout.edit-panel.ph-no-rows": "當前數據源暫無可用行",
+    "pisell-floor-map-layout.edit-panel.hint-unbound": "未綁定行時可先留空或清除；綁定後可編輯「數據源記錄」欄位。",
+    "pisell-floor-map-layout.edit-panel.record-title": "數據源記錄",
+    "pisell-floor-map-layout.edit-panel.pop-title": "確定刪除該圖元？",
+    "pisell-floor-map-layout.edit-panel.pop-desc": "將從當前平面圖草稿中移除；刪除後請點擊頂部「儲存」以持久化佈局。",
+    "pisell-floor-map-layout.edit-panel.btn-delete": "刪除",
+    "pisell-floor-map-layout.edit-panel.btn-cancel": "取消",
+    "pisell-floor-map-layout.edit-panel.btn-ok-delete": "刪除"
+  }
+};

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

@@ -32,6 +32,10 @@ export interface FloorMapItemBase {
     x: number;
     /** 坐标 y */
     y: number;
+    /** 显示名称，与 x/y 同级，所有图元可编辑 */
+    name?: string;
+    /** 层级，与 x/y 同级，所有图元可编辑；数值越大越靠前 */
+    zIndex?: number;
     /** 宽度（可选；cell 时为格子数，pixel 时为像素，缺省时 cell 为 1，pixel 为 cellSize） */
     width?: number;
     /** 高度（可选） */
@@ -59,6 +63,11 @@ export interface FloorMapLayerConfig {
     gap?: number | string;
     /** 坐标吸附间隔（逻辑单位），0 表示不吸附 */
     snapStep?: number;
+    /**
+     * 平面图像素模式：按图元包围盒外扩的单侧留白（像素），影响画布尺寸与初始对齐。
+     * 不传时默认约 56；若需更大拖拽边距可设大值（如 200）。
+     */
+    boundingPadding?: number;
 }
 /**
  * 缩放配置
@@ -72,6 +81,11 @@ export interface FloorMapZoomConfig {
     max?: number;
     /** 缩放步进，默认 0.1 (10%) */
     step?: number;
+    /**
+     * 为 true 时：挂载后每个画布（frameResetKey）自动执行一次 fitBounds，使图元落在视口内。
+     * 为 true 时跳过「首帧 defaultScale 左上对齐」，避免与 fit 闪动叠加。
+     */
+    autoFitOnMount?: boolean;
 }
 /**
  * 平移配置
@@ -106,6 +120,297 @@ export interface FloorMapGridLayoutConfig {
     /** 每行列数 */
     columns?: number;
 }
+/** 图元类型：是否绑定业务资源 */
+export declare type FloorMapElementType = 'resource' | 'decoration';
+/**
+ * 画布名称多语言结构（与低代码 Translation 字段一致）
+ */
+export declare type FloorMapCanvasNameI18n = {
+    en: string;
+    'zh-CN': string;
+    'zh-HK': string;
+    ja: string;
+    pt: string;
+};
+/** 画布（对应一个 Tab，如 1楼、2楼） */
+export interface FloorMapCanvas {
+    id: string;
+    /**
+     * 展示名：纯字符串或各语言对象；对象时按引擎 locale 取字段，缺省回退 `en` 等。
+     */
+    name: string | FloorMapCanvasNameI18n;
+    /**
+     * 多语言文案 key（`locales.getText`）；配置后 Tab / 侧栏「所属画布」优先显示当前语言译名。
+     * 用户重命名后会清除 `nameKey`，以 `name` 为准。
+     */
+    nameKey?: string;
+    /**
+     * Tab 标签旁 (n) 数量；未配置时 `mergeCanvasesForTabs` 可按 `sceneElements` 数量推断（>0 才显示）。
+     */
+    tabBadge?: number;
+    order: number;
+    enabled: boolean;
+    background?: string;
+    categoryIds?: string[];
+    mapLayer?: FloorMapLayerConfig;
+}
+/** 文字槽位（编辑时在 SVG 上添加，阅读态通过参数传文案） */
+export interface FloorMapTextSlot {
+    id: string;
+    x: number;
+    y: number;
+    align?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    defaultText?: string;
+}
+/** 地图图元：资源或装饰，编辑与阅读共用（name/zIndex 继承自 FloorMapItemBase） */
+export interface FloorMapElement extends FloorMapItemBase {
+    canvasId: string;
+    type: FloorMapElementType;
+    elementKind?: string;
+    fillColor?: string;
+    strokeColor?: string;
+    resourceId?: string;
+    capacity?: number;
+    textSlots?: FloorMapTextSlot[];
+    points?: [number, number][];
+    svgPath?: string;
+    svgUrl?: string;
+    imageUrl?: string;
+    extensions?: Record<string, unknown>;
+}
+/** 单门店 Floor Map 数据（编辑/阅读共用） */
+export interface FloorMapData {
+    canvases: FloorMapCanvas[];
+    elements: FloorMapElement[];
+}
+/** 多数据源：key 为数据源标识，value 为该数据源下的记录列表 */
+export declare type FloorMapDataSources = Record<string, Array<{
+    id: string;
+    [k: string]: unknown;
+}>>;
+/**
+ * 画布图元与可选数据源行的绑定（无绑定时仅展示图元种类默认态）
+ */
+export interface FloorMapSceneElementDataBinding {
+    dataSourceKey: string;
+    recordId: string;
+}
+/**
+ * 画布上的单一图元实例（原 dataSourcePlacements + decorations 合并为同一结构）
+ */
+export interface FloorMapSceneElement {
+    /** 实例唯一 id，持久化主键 */
+    instanceId: string;
+    /** 所属画布 id */
+    canvasId: string;
+    x: number;
+    y: number;
+    name?: string;
+    zIndex?: number;
+    width?: number;
+    height?: number;
+    elementKind?: string;
+    scale?: number;
+    shape?: FloorMapItemShape;
+    fillColor?: string;
+    strokeColor?: string;
+    textSlots?: FloorMapTextSlot[];
+    points?: [number, number][];
+    svgPath?: string;
+    svgUrl?: string;
+    imageUrl?: string;
+    extensions?: Record<string, unknown>;
+    dataBinding?: FloorMapSceneElementDataBinding;
+    /**
+     * 为 true 时：侧栏锁定 X/Y/层级/宽高的编辑，且画布上不可拖拽、不可缩放控制点。
+     * 仍可改名称、图片地址等其它字段（如适用）。
+     */
+    layoutTransformLocked?: boolean;
+}
+/**
+ * 矩形区域类装饰（无数据源绑定），如画布上的「舞台/舞池」等。
+ * 在 `elementKinds` 中配置 `{ value: 'stage', label: '…', showInPalette: true }`，名称在编辑面板「显示名称」中修改。
+ */
+export declare const FLOOR_MAP_STAGE_ELEMENT_KIND = "stage";
+/**
+ * 图片图元：无数据源绑定，通过 `imageUrl` 展示位图；适合铺底图或与业务图元叠放（调 `zIndex`）。
+ */
+export declare const FLOOR_MAP_IMAGE_ELEMENT_KIND = "floorMapImage";
+/** 图元是否接受数据源及是否必填 */
+export declare type FloorMapElementDataBindingPolicy = 'none' | 'optional' | 'required';
+/** 图元种类所属分类（调色板分组） */
+export interface FloorMapElementKindCategory {
+    id: string;
+    label: string;
+    order?: number;
+}
+/** 无数据源行时的占位展示文案/扩展（与 defaultShape 等并列） */
+export interface FloorMapElementDefaultPresentation {
+    title?: string;
+    subtitle?: string;
+    extensions?: Record<string, unknown>;
+}
+/** 图元间连线（边） */
+export interface FloorMapEdge {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    sourceAnchor?: 'top' | 'right' | 'bottom' | 'left' | 'center';
+    targetAnchor?: 'top' | 'right' | 'bottom' | 'left' | 'center';
+}
+/** 图元种类配置（由后端或上层注入） */
+export interface FloorMapElementKindConfig {
+    value: string;
+    label: string;
+    /** 调色板分组，对应 {@link FloorMapViewConfig.elementKindCategories} 的 id */
+    categoryId?: string;
+    /**
+     * 是否接受数据源绑定：none 纯图元；optional 可先占位后绑定；required 在存在可选行时须先选行再落点（数据源为空时仍允许占位 recordId）
+     */
+    dataBindingPolicy?: FloorMapElementDataBindingPolicy;
+    /** 允许绑定的数据源 key，缺省表示不限制（在 policy 非 none 时生效） */
+    allowedDataSourceKeys?: string[];
+    /** 校验绑定行是否包含这些字段（有绑定且行存在时检查） */
+    expectedRecordFields?: string[];
+    defaultShape?: FloorMapItemShape;
+    defaultFillColor?: string;
+    defaultStrokeColor?: string;
+    showInPalette?: boolean;
+    defaultPoints?: [number, number][];
+    defaultSvgUrl?: string;
+    defaultSvgPath?: string;
+    defaultImageUrl?: string;
+    /** 无绑定或行缺失时的说明向展示 */
+    defaultPresentation?: FloorMapElementDefaultPresentation;
+}
+/**
+ * 画布/编辑器层能力：新建图元、布局与画布 Tab 的编辑权限
+ * @description 与 `canvases` 列表配合使用，统一挂在平面图配置的「画布 UI」下
+ */
+export interface FloorMapCanvasUiConfig {
+    /** 是否展示左侧调色板并从新建模式落点图元 */
+    canCreate: boolean;
+    /**
+     * 是否允许：画布 Tab 增删改名、选中图元侧栏、保存布局与数据源记录、画布内拖拽等
+     */
+    canEdit: boolean;
+}
+/** Floor Map 视图配置（仅平面图视图需要持久化） */
+export interface FloorMapViewConfig {
+    canvases: FloorMapCanvas[];
+    /** 画布编辑能力（原根级 canCreate / canEdit，现归并于此） */
+    canvasUi: FloorMapCanvasUiConfig;
+    /** 图元分类，供调色板分组 */
+    elementKindCategories?: FloorMapElementKindCategory[];
+    elementKinds: FloorMapElementKindConfig[];
+    /** 画布上的全部图元实例（合并原落位与装饰） */
+    sceneElements: FloorMapSceneElement[];
+    datasourceComponents?: Record<string, {
+        componentId?: string;
+        [k: string]: unknown;
+    }>;
+    edges?: FloorMapEdge[];
+}
+/** 编辑态：选中图元种类后的放置模式（点击画布落点） */
+export declare type FloorMapPlaceMode = null | {
+    type: 'scene';
+    elementKind: string;
+    dataSourceKey?: string;
+    recordId?: string;
+};
+/** 阅读态 renderItem 可选第三参数 */
+export interface FloorMapRenderOptions {
+    textSlotValues?: Record<string, string>;
+}
+/** 数据源记录表单列配置（用于编辑面板中的「数据源记录」区块） */
+export interface DataSourceFormColumn {
+    key: string;
+    label: string;
+    type?: 'string' | 'number' | 'select';
+    options?: Array<{
+        label: string;
+        value: string;
+    }>;
+}
+/**
+ * 自定义「数据源记录」表单（ReactNode 或 render prop）可用的上下文
+ * @description 与内置 {@link FloorMapDataForm} 数据源一致，便于复杂表单、多步校验、联动等
+ */
+export interface FloorMapRecordFormRenderContext {
+    /** 当前数据源 key */
+    dataSourceKey: string;
+    /** 当前绑定的记录 id */
+    recordId: string;
+    /** 当前行数据（来自 dataSources） */
+    record: Record<string, unknown>;
+    /** 全量数据源，只读引用 */
+    dataSources: FloorMapDataSources;
+    /** 当前画布图元实例（含坐标、绑定等） */
+    sceneElement: FloorMapSceneElement;
+    /** 当前平面图草稿配置 */
+    config: FloorMapViewConfig;
+    /** 与侧栏「保存记录」一致：写入单条记录；未配置 {@link PisellFloorMapLayoutProps.onDataSourceRecordSave} 时为 undefined */
+    onSaveRecord?: (newData: Record<string, unknown>) => void;
+    /** 内置表单保存中的 loading 同步字段，自定义表单可自行维护 loading */
+    savingRecord: boolean;
+}
+/**
+ * 按 dataSourceKey 替换「数据源记录」区块的表单内容：静态节点或通过 context 渲染
+ */
+export declare type FloorMapDataSourceRecordFormContent = ReactNode | ((ctx: FloorMapRecordFormRenderContext) => ReactNode);
+/** 选中图元后编辑面板参数 */
+export interface FloorMapEditPanelParams {
+    itemId: string;
+    sceneElement: FloorMapSceneElement;
+    onUpdate: (patch: Partial<FloorMapSceneElement>) => void;
+    onSaveRecord?: (dataSourceKey: string, id: string, newData: Record<string, unknown>) => void;
+    onClose: () => void;
+    /** 从草稿中移除当前选中的图元，并关闭面板（需用户再点「保存」持久化布局） */
+    onDelete?: () => void;
+    /** 按 dataSourceKey 配置记录表单列（标签、类型、选项），不传则自动列举 record 除 id 外字段 */
+    recordFormColumns?: Record<string, DataSourceFormColumn[]>;
+    /**
+     * 按 dataSourceKey 完全替换「数据源记录」内的表单区域（仍保留上方「选择数据行」等）
+     * 若某 key 存在且非空，则不再渲染该 key 下的 {@link FloorMapDataForm}（列配置仅作未自定义时的后备）
+     */
+    dataSourceRecordForm?: Record<string, FloorMapDataSourceRecordFormContent>;
+    /** 数据源 key → 展示名（侧栏「数据源」下拉与工具栏一致） */
+    dataSourceLabels?: Record<string, string>;
+    /**
+     * 布局草稿相对上游持久化配置已变更（拖拽、绑定、侧栏应用等均会写入草稿）；
+     * 用于提示用户点击顶部「保存」持久化布局草稿。
+     */
+    layoutDraftDirty?: boolean;
+    /**
+     * 为 false 时不渲染「数据绑定」下方的数据源记录编辑表单（FloorMapDataForm / 自定义 record 表单）；
+     * 数据绑定选数据源与选行仍可展示。
+     */
+    showDataSourceRecordFormBlock?: boolean;
+}
+/**
+ * 合并当前画布的 sceneElements 为 items（用于 Layout 渲染）
+ */
+export declare type FloorMapMergedItem = FloorMapItemBase & {
+    /** 与 {@link FloorMapSceneElement.instanceId} 一致 */
+    id: string;
+    instanceId: string;
+    _sceneElement: FloorMapSceneElement;
+    elementKind?: string;
+};
+/**
+ * 平面图编辑态全屏 UI 策略（`floorMapFullscreenMode`）
+ *
+ * - **toggle**（默认）：顶栏提供进入/退出全屏，与浏览器 Fullscreen API 联动
+ * - **locked**：始终使用全屏顶栏（Tab + 保存等），**不提供退出全屏**；适合外层遮罩铺满
+ * - **disabled**：**不提供全屏按钮**，仅小屏顶栏 + 侧栏保存
+ */
+export declare type FloorMapFullscreenMode = 'toggle' | 'locked' | 'disabled';
+/**
+ * 平面图 Layout 注入上下文：数据、保存、侧栏表单与状态等（不包含 renderItem/mapLayer 等展示向 props）。
+ * 由 `FloorMapLayoutProvider` / RecordBoard `floorMapLayoutContext` 提供，与 `PisellFloorMapLayout` props 按 `??` 合并，props 优先。
+ */
+export declare type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'showDataSourceRecordFormBlock'>>;
 /**
  * PisellFloorMapLayout 组件 Props
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
@@ -125,12 +430,23 @@ export interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMap
     items: T[];
     /**
      * 每个资源项的渲染函数；内容与样式由调用方完全控制
+     * 当使用 floorMapConfig 时可选传入第三参数 options（如 textSlotValues）
      */
-    renderItem: (item: T, index: number) => ReactNode;
+    renderItem: (item: T, index: number, options?: FloorMapRenderOptions) => ReactNode;
     /**
      * 指定每项的唯一 key，默认使用 item.id
      */
     rowKey?: string | ((item: T, index: number) => string);
+    /**
+     * 按 elementKind 的渲染函数（key 为 kind value），优先于 renderItem
+     * 仅在使用 floorMapConfig 时生效
+     */
+    renderItemByKind?: Record<string, (item: T, index: number, options?: FloorMapRenderOptions) => ReactNode>;
+    /**
+     * 合并图元**外层定位容器**的额外样式（如列表/搜索筛选未命中时降低透明度）。
+     * 在宽高与定位样式之后展开合并，适合传 `opacity`；避免覆盖 `position/left/top/width/height` 除非有意为之。
+     */
+    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
     /**
      * 底层（地图层）配置：背景、网格、padding、gap、吸附
      */
@@ -182,6 +498,49 @@ export interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMap
      * 资源项鼠标离开
      */
     onItemLeave?: (item: T, index: number, event: ReactMouseEvent<HTMLElement>) => void;
+    /** 编辑态全屏按钮与顶栏形态，见 {@link FloorMapFullscreenMode} */
+    floorMapFullscreenMode?: FloorMapFullscreenMode;
+    /**
+     * 模式：read 仅展示，edit 可编辑；与 floorMapConfig 同时使用时生效
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 平面图视图配置；传入时由组件内部按当前画布合并 items，忽略外部传入的 items
+     */
+    floorMapConfig?: FloorMapViewConfig;
+    /**
+     * 多数据源；与 floorMapConfig 同时使用
+     */
+    dataSources?: FloorMapDataSources;
+    /** 保存平面图配置，由上层调接口持久化 */
+    onSave?: (config: FloorMapViewConfig) => void;
+    /** 保存单条数据源记录 */
+    onDataSourceRecordSave?: (dataSourceKey: string, id: string, newData: Record<string, unknown>) => void;
+    /** 数据源展示名，key 为 dataSourceKey */
+    dataSourceLabels?: Record<string, string>;
+    /** 按 dataSourceKey 配置编辑面板「数据源记录」表单列（标签、类型、选项） */
+    dataSourceFormColumns?: Record<string, DataSourceFormColumn[]>;
+    /**
+     * 按 dataSourceKey 自定义侧栏「数据源记录」表单：传入 ReactNode 或 `(ctx) => ReactNode`；
+     * 指定 key 后优先于 dataSourceFormColumns + 内置 FloorMapDataForm，用于复杂业务表单
+     */
+    dataSourceRecordForm?: Record<string, FloorMapDataSourceRecordFormContent>;
+    /** 编辑态 loading */
+    loading?: boolean;
+    /** 保存失败时的错误信息 */
+    saveError?: Error | string;
+    /**
+     * 单图元渲染抛出异常或内部校验失败时回调（如 renderItemByKind 抛错、绑定数据不合法）
+     */
+    onElementRenderError?: (element: FloorMapSceneElement, error: unknown) => void;
+    /**
+     * 是否在左侧工具栏底部显示「保存」（默认 true；非全屏时顶栏为 Tab+全屏，保存多在侧栏；全屏时保存仅在顶栏）
+     */
+    toolbarShowSave?: boolean;
+    /**
+     * 为 false 时隐藏侧栏「数据源记录」表单区（保留数据绑定选源/选行）。
+     */
+    showDataSourceRecordFormBlock?: boolean;
 }
 /**
  * PisellFloorMapLayout Ref 方法
@@ -196,4 +555,6 @@ export interface PisellFloorMapLayoutRef {
     reset: () => void;
     /** 区域定位：使所有 items 落在视口内 */
     fitBounds: () => void;
+    /** 提交当前布局草稿（与顶栏/侧栏「保存」一致） */
+    saveLayout: () => void;
 }

package/lib/components/pisellFloorMapLayout/types.js

@@ -2,6 +2,10 @@ 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))
@@ -14,4 +18,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 // src/components/pisellFloorMapLayout/types.ts
 var types_exports = {};
+__export(types_exports, {
+  FLOOR_MAP_IMAGE_ELEMENT_KIND: () => FLOOR_MAP_IMAGE_ELEMENT_KIND,
+  FLOOR_MAP_STAGE_ELEMENT_KIND: () => FLOOR_MAP_STAGE_ELEMENT_KIND
+});
 module.exports = __toCommonJS(types_exports);
+var FLOOR_MAP_STAGE_ELEMENT_KIND = "stage";
+var FLOOR_MAP_IMAGE_ELEMENT_KIND = "floorMapImage";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FLOOR_MAP_IMAGE_ELEMENT_KIND,
+  FLOOR_MAP_STAGE_ELEMENT_KIND
+});

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

@@ -0,0 +1,20 @@
+import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
+/**
+ * 合并平面图 Tab 用多语言包（与业务侧 `locales.init` 可叠加）。
+ */
+export declare function initFloorMapLayoutLocales(engineLocale: string): void;
+/**
+ * 从多语言对象中取当前 locale 下展示字符串，缺省按 en → 其余首个非空。
+ */
+export declare function pickFloorMapCanvasI18nString(obj: FloorMapCanvasNameI18n, engineLocale: string): string;
+/**
+ * 画布在 Tab / 下拉中的展示名：
+ * 1. `name` 为多语言对象时 **优先** 按引擎 locale 取字段（与配置内嵌文案一致）；
+ * 2. 否则 `nameKey` + `locales.getText`（需业务侧已 init 对应语言包）；
+ * 3. 否则 `name` 字符串。
+ */
+export declare function getFloorMapCanvasDisplayName(canvas: FloorMapCanvas, engineLocale: string): string;
+/**
+ * 打开重命名弹层时的初始多语言值（与 Translation 表单一致）。
+ */
+export declare function seedFloorMapCanvasNameI18n(canvas: FloorMapCanvas, displayFallback: string): FloorMapCanvasNameI18n;