@pisell/materials 6.11.17 → 6.11.19

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

@@ -0,0 +1,126 @@
+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/utils/floorMapCanvasDisplay.ts
+var floorMapCanvasDisplay_exports = {};
+__export(floorMapCanvasDisplay_exports, {
+  getFloorMapCanvasDisplayName: () => getFloorMapCanvasDisplayName,
+  initFloorMapLayoutLocales: () => initFloorMapLayoutLocales,
+  pickFloorMapCanvasI18nString: () => pickFloorMapCanvasI18nString,
+  seedFloorMapCanvasNameI18n: () => seedFloorMapCanvasNameI18n
+});
+module.exports = __toCommonJS(floorMapCanvasDisplay_exports);
+var import_utils = require("@pisell/utils");
+var import_locales = __toESM(require("../locales"));
+var import_utils2 = require("../../translation/utils");
+function initFloorMapLayoutLocales(engineLocale) {
+  import_utils.locales.init(import_locales.default, engineLocale);
+}
+var I18N_LOCALE_ORDER = [
+  "en",
+  "zh-CN",
+  "zh-HK",
+  "ja",
+  "pt"
+];
+function localeKeysToTryForCanvasName(engineLocale) {
+  const out = [];
+  const push = (k) => {
+    if (!out.includes(k)) out.push(k);
+  };
+  push(engineLocale);
+  if (engineLocale === "en-US" || engineLocale === "en-GB") {
+    push("en");
+  }
+  if (engineLocale === "zh_CN" || engineLocale === "zh") {
+    push("zh-CN");
+  }
+  for (const k of I18N_LOCALE_ORDER) {
+    push(k);
+  }
+  return out;
+}
+function pickFloorMapCanvasI18nString(obj, engineLocale) {
+  for (const loc of localeKeysToTryForCanvasName(engineLocale)) {
+    const v = obj[loc];
+    if (typeof v === "string" && v.trim()) return v.trim();
+  }
+  for (const v of Object.values(obj)) {
+    if (typeof v === "string" && v.trim()) return v.trim();
+  }
+  return "";
+}
+function isCanvasNameI18nObject(n) {
+  if (!n || typeof n !== "object" || Array.isArray(n)) return false;
+  const o = n;
+  for (const k of I18N_LOCALE_ORDER) {
+    if (typeof o[k] === "string") return true;
+  }
+  return false;
+}
+function getFloorMapCanvasDisplayName(canvas, engineLocale) {
+  initFloorMapLayoutLocales(engineLocale);
+  const n = canvas.name;
+  if (isCanvasNameI18nObject(n)) {
+    const fromObj = pickFloorMapCanvasI18nString(n, engineLocale);
+    if (fromObj) return fromObj;
+  }
+  if (canvas.nameKey) {
+    const t = import_utils.locales.getText(canvas.nameKey);
+    if (t !== canvas.nameKey) return t;
+  }
+  if (typeof n === "string") return n;
+  if (n && typeof n === "object" && !Array.isArray(n)) {
+    return pickFloorMapCanvasI18nString(
+      n,
+      engineLocale
+    );
+  }
+  return "";
+}
+function seedFloorMapCanvasNameI18n(canvas, displayFallback) {
+  const n = canvas.name;
+  if (n && typeof n === "object") {
+    return {
+      en: n.en ?? "",
+      "zh-CN": n["zh-CN"] ?? "",
+      "zh-HK": n["zh-HK"] ?? "",
+      ja: n.ja ?? "",
+      pt: n.pt ?? ""
+    };
+  }
+  const s = typeof n === "string" && n.trim() ? n.trim() : displayFallback;
+  return (0, import_utils2.createTranslationText)(s, true);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getFloorMapCanvasDisplayName,
+  initFloorMapLayoutLocales,
+  pickFloorMapCanvasI18nString,
+  seedFloorMapCanvasNameI18n
+});

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

@@ -0,0 +1,8 @@
+/**
+ * 将当前画布的 sceneElements 合并为 Layout 使用的 FloorMapMergedItem[]
+ */
+import type { FloorMapViewConfig, FloorMapMergedItem } from '../types';
+/**
+ * 合并指定画布下的 sceneElements 为一份 items（用于 ItemLayer / EditableItemLayer）
+ */
+export declare function mergeCanvasItems(canvasId: string, config: Pick<FloorMapViewConfig, 'sceneElements' | 'elementKinds'>, defaultCellSize?: number): FloorMapMergedItem[];

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

@@ -0,0 +1,66 @@
+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/utils/floorMapConfigMerge.ts
+var floorMapConfigMerge_exports = {};
+__export(floorMapConfigMerge_exports, {
+  mergeCanvasItems: () => mergeCanvasItems
+});
+module.exports = __toCommonJS(floorMapConfigMerge_exports);
+var import_types = require("../types");
+var import_floorMapElementKindUtils = require("./floorMapElementKindUtils");
+var DEFAULT_SIZE = 48;
+var IMAGE_KIND_DEFAULT_SIZE = { width: 400, height: 240 };
+function getDefaultSize(elementKind, elementKinds) {
+  if (!elementKind) return { width: DEFAULT_SIZE, height: DEFAULT_SIZE };
+  if (elementKind === import_types.FLOOR_MAP_IMAGE_ELEMENT_KIND) {
+    return { ...IMAGE_KIND_DEFAULT_SIZE };
+  }
+  const found = elementKinds.find((k) => k.value === elementKind);
+  if (!found) return { width: DEFAULT_SIZE, height: DEFAULT_SIZE };
+  return { width: DEFAULT_SIZE, height: DEFAULT_SIZE };
+}
+function mergeCanvasItems(canvasId, config, defaultCellSize = DEFAULT_SIZE) {
+  const { sceneElements = [], elementKinds = [] } = config;
+  const items = [];
+  const onCanvas = sceneElements.filter((el) => el.canvasId === canvasId);
+  for (const el of onCanvas) {
+    const size = getDefaultSize(el.elementKind, elementKinds);
+    const w = el.width ?? size.width ?? defaultCellSize;
+    const h = el.height ?? size.height ?? defaultCellSize;
+    const kindConfig = (0, import_floorMapElementKindUtils.getElementKindConfig)({ elementKinds }, el.elementKind);
+    items.push({
+      id: el.instanceId,
+      instanceId: el.instanceId,
+      x: el.x,
+      y: el.y,
+      width: w,
+      height: h,
+      name: el.name,
+      zIndex: el.zIndex,
+      shape: el.shape ?? (kindConfig == null ? void 0 : kindConfig.defaultShape),
+      elementKind: el.elementKind,
+      _sceneElement: el
+    });
+  }
+  return items;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mergeCanvasItems
+});

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

@@ -0,0 +1,8 @@
+/**
+ * 平面图数据行在下拉选项中的展示文案（侧栏「选择数据行」、工具栏多选记录）
+ * 仅展示名称侧一条：main_field（取 ## 前段）→ code → name；不再拼接 id、form_code、status。
+ */
+export declare function formatDataRecordOptionLabel(record: {
+    id: string;
+    [k: string]: unknown;
+}): string;

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

@@ -0,0 +1,38 @@
+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/utils/floorMapDataRecordLabel.ts
+var floorMapDataRecordLabel_exports = {};
+__export(floorMapDataRecordLabel_exports, {
+  formatDataRecordOptionLabel: () => formatDataRecordOptionLabel
+});
+module.exports = __toCommonJS(floorMapDataRecordLabel_exports);
+function formatDataRecordOptionLabel(record) {
+  const rawMain = record.main_field != null ? String(record.main_field) : "";
+  const mainField = rawMain ? (rawMain.split(" ## ")[0] ?? rawMain).trim() : "";
+  const code = record.code != null && String(record.code).trim() ? String(record.code).trim() : "";
+  const name = record.name != null ? String(record.name).trim() : "";
+  const idStr = String(record.id ?? "").trim();
+  const primary = mainField || code || name;
+  if (primary) return primary;
+  return idStr || "—";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatDataRecordOptionLabel
+});

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

@@ -0,0 +1,27 @@
+/**
+ * 平面图编辑态：侧栏图元拖拽到画布的 DataTransfer 与坐标
+ */
+/** 与 setData 一致，用于识别左侧图元栏发起的拖拽 */
+export declare const FLOOR_MAP_PALETTE_DRAG_MIME = "application/x-pisell-floor-map-element";
+export interface FloorMapPaletteDragPayload {
+    elementKind: string;
+    dataSourceKey?: string;
+    recordId?: string;
+    recordIds?: string[];
+}
+/**
+ * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移
+ */
+export declare function sceneXYFromContentDropOffset(offsetX: number, offsetY: number, contentOffset: {
+    x: number;
+    y: number;
+}): {
+    x: number;
+    y: number;
+};
+/** 是否为左侧图元栏拖拽（非本地文件 / 外链图片） */
+export declare function isFloorMapPaletteDrag(dt: DataTransfer | null): boolean;
+/**
+ * 解析侧栏拖拽 payload；非法时返回 null
+ */
+export declare function parsePaletteDragPayload(dt: DataTransfer): FloorMapPaletteDragPayload | null;

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

@@ -0,0 +1,67 @@
+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/utils/floorMapDropUtils.ts
+var floorMapDropUtils_exports = {};
+__export(floorMapDropUtils_exports, {
+  FLOOR_MAP_PALETTE_DRAG_MIME: () => FLOOR_MAP_PALETTE_DRAG_MIME,
+  isFloorMapPaletteDrag: () => isFloorMapPaletteDrag,
+  parsePaletteDragPayload: () => parsePaletteDragPayload,
+  sceneXYFromContentDropOffset: () => sceneXYFromContentDropOffset
+});
+module.exports = __toCommonJS(floorMapDropUtils_exports);
+var FLOOR_MAP_PALETTE_DRAG_MIME = "application/x-pisell-floor-map-element";
+function sceneXYFromContentDropOffset(offsetX, offsetY, contentOffset) {
+  return {
+    x: Math.round(offsetX - contentOffset.x),
+    y: Math.round(offsetY - contentOffset.y)
+  };
+}
+function isFloorMapPaletteDrag(dt) {
+  if (!dt) return false;
+  return Array.from(dt.types ?? []).includes(FLOOR_MAP_PALETTE_DRAG_MIME);
+}
+function parsePaletteDragPayload(dt) {
+  try {
+    const raw = dt.getData(FLOOR_MAP_PALETTE_DRAG_MIME);
+    if (!raw) return null;
+    const o = JSON.parse(raw);
+    if (!o || typeof o !== "object") return null;
+    const rec = o;
+    const elementKind = rec.elementKind;
+    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;
+    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;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  FLOOR_MAP_PALETTE_DRAG_MIME,
+  isFloorMapPaletteDrag,
+  parsePaletteDragPayload,
+  sceneXYFromContentDropOffset
+});

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

@@ -0,0 +1,22 @@
+/**
+ * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
+ */
+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
+ */
+export declare function getSceneElementRenderIssue(element: FloorMapSceneElement, kind: FloorMapElementKindConfig | undefined, dataSources: FloorMapDataSources | undefined): string | null;

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

@@ -0,0 +1,142 @@
+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/utils/floorMapElementKindUtils.ts
+var floorMapElementKindUtils_exports = {};
+__export(floorMapElementKindUtils_exports, {
+  getElementKindConfig: () => getElementKindConfig,
+  getSceneElementRenderIssue: () => getSceneElementRenderIssue,
+  getSwappableElementKindsInSameCategory: () => getSwappableElementKindsInSameCategory,
+  isFloorMapImageElementKind: () => isFloorMapImageElementKind,
+  patchSceneElementForKindSwitch: () => patchSceneElementForKindSwitch,
+  resolveDataBindingPolicy: () => resolveDataBindingPolicy
+});
+module.exports = __toCommonJS(floorMapElementKindUtils_exports);
+var import_types = require("../types");
+var import_utils = require("@pisell/utils");
+var import_floorMapStageDefaults = require("./floorMapStageDefaults");
+function isFloorMapImageElementKind(kind) {
+  return kind === import_types.FLOOR_MAP_IMAGE_ELEMENT_KIND;
+}
+function resolveDataBindingPolicy(kind) {
+  return (kind == null ? void 0 : kind.dataBindingPolicy) ?? "none";
+}
+function getElementKindConfig(config, elementKind) {
+  var _a;
+  if (!elementKind || !((_a = config == null ? void 0 : config.elementKinds) == null ? void 0 : _a.length)) return void 0;
+  return config.elementKinds.find((k) => k.value === elementKind);
+}
+function getSwappableElementKindsInSameCategory(config, elementKind) {
+  var _a, _b;
+  if (!elementKind || !((_a = config.elementKinds) == null ? void 0 : _a.length)) return [];
+  const rawCats = config.elementKindCategories ?? [];
+  const sorted = [...rawCats].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
+  const fallbackId = ((_b = sorted[0]) == null ? void 0 : _b.id) ?? "_uncat";
+  const self = config.elementKinds.find((k) => k.value === elementKind);
+  if (!self) return [];
+  const cid = self.categoryId ?? fallbackId;
+  return config.elementKinds.filter((k) => {
+    if (k.showInPalette === false) return false;
+    if (k.value === import_types.FLOOR_MAP_STAGE_ELEMENT_KIND) return false;
+    if (k.value === import_types.FLOOR_MAP_IMAGE_ELEMENT_KIND) return false;
+    return (k.categoryId ?? fallbackId) === cid;
+  });
+}
+var DEFAULT_PLACE_W = 180;
+var DEFAULT_PLACE_H = 120;
+var IMAGE_PLACE_W = 400;
+var IMAGE_PLACE_H = 240;
+var DECO_SIZE = 48;
+function patchSceneElementForKindSwitch(config, element, nextKindValue) {
+  var _a, _b;
+  const nextCfg = getElementKindConfig(config, nextKindValue);
+  const nextPol = resolveDataBindingPolicy(nextCfg);
+  const binding = element.dataBinding;
+  const isNextImage = isFloorMapImageElementKind(nextKindValue);
+  const isNextStage = nextKindValue === import_types.FLOOR_MAP_STAGE_ELEMENT_KIND;
+  let clearBinding = false;
+  if (nextPol === "none") {
+    clearBinding = true;
+  } else if (binding && ((_a = nextCfg == null ? void 0 : nextCfg.allowedDataSourceKeys) == null ? void 0 : _a.length)) {
+    if (!nextCfg.allowedDataSourceKeys.includes(binding.dataSourceKey)) {
+      clearBinding = true;
+    }
+  }
+  const nextW = isNextImage ? IMAGE_PLACE_W : isNextStage ? import_floorMapStageDefaults.STAGE_DECO_DEFAULT.width : DEFAULT_PLACE_W;
+  const nextH = isNextImage ? IMAGE_PLACE_H : isNextStage ? import_floorMapStageDefaults.STAGE_DECO_DEFAULT.height : DEFAULT_PLACE_H;
+  const useDecoSize = nextPol === "none" && nextKindValue !== import_types.FLOOR_MAP_STAGE_ELEMENT_KIND && !isNextImage;
+  const width = useDecoSize ? Math.max(element.width ?? DECO_SIZE, DECO_SIZE) : Math.max(element.width ?? nextW, nextW);
+  const height = useDecoSize ? Math.max(element.height ?? DECO_SIZE, DECO_SIZE) : Math.max(element.height ?? nextH, nextH);
+  const patch = {
+    elementKind: nextKindValue,
+    shape: isNextStage || isNextImage ? "rect" : nextCfg == null ? void 0 : nextCfg.defaultShape,
+    width,
+    height,
+    name: ((_b = nextCfg == null ? void 0 : nextCfg.defaultPresentation) == null ? void 0 : _b.title) != null && String(nextCfg.defaultPresentation.title).trim() !== "" ? String(nextCfg.defaultPresentation.title) : element.name
+  };
+  if (clearBinding) {
+    patch.dataBinding = void 0;
+  }
+  if (isNextImage) {
+    patch.imageUrl = element.imageUrl ?? "";
+  } else {
+    patch.imageUrl = void 0;
+  }
+  return patch;
+}
+function getSceneElementRenderIssue(element, kind, dataSources) {
+  const policy = resolveDataBindingPolicy(kind);
+  const binding = element.dataBinding;
+  if (policy === "required" && !binding) {
+    return import_utils.locales.getText(
+      "pisell-floor-map-layout.binding-error.required-row"
+    );
+  }
+  if (!binding) return null;
+  const keys = kind == null ? void 0 : kind.allowedDataSourceKeys;
+  if ((keys == null ? void 0 : keys.length) && !keys.includes(binding.dataSourceKey)) {
+    return import_utils.locales.getText("pisell-floor-map-layout.binding-error.ds-not-allowed").replace(/\{key\}/g, binding.dataSourceKey);
+  }
+  const rows = dataSources == null ? void 0 : dataSources[binding.dataSourceKey];
+  const rid = binding.recordId != null ? String(binding.recordId).trim() : "";
+  if (rid === "" || rid.startsWith("new_")) {
+    return null;
+  }
+  const row = rows == null ? void 0 : rows.find((r) => r.id === rid);
+  if (!row) {
+    return null;
+  }
+  const expected = kind == null ? void 0 : kind.expectedRecordFields;
+  if (expected == null ? void 0 : expected.length) {
+    for (const f of expected) {
+      if (row[f] === void 0 || row[f] === null || row[f] === "") {
+        return import_utils.locales.getText("pisell-floor-map-layout.binding-error.missing-field").replace(/\{field\}/g, f);
+      }
+    }
+  }
+  return null;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getElementKindConfig,
+  getSceneElementRenderIssue,
+  getSwappableElementKindsInSameCategory,
+  isFloorMapImageElementKind,
+  patchSceneElementForKindSwitch,
+  resolveDataBindingPolicy
+});

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

@@ -0,0 +1,11 @@
+/**
+ * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
+ */
+import React from 'react';
+import type { FloorMapMergedItem } from '../types';
+/**
+ * @returns 与 PisellFloorMapLayout 内联 fallback 一致的渲染函数（useCallback 由调用方包裹）
+ */
+/** 绑定校验失败或 renderItemByKind 抛错时的占位 */
+export declare function renderFloorMapRenderError(message: string): React.ReactNode;
+export declare function renderFloorMapFallbackPlaceholder(item: FloorMapMergedItem): React.ReactNode;

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

@@ -0,0 +1,136 @@
+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/utils/floorMapFallbackRender.tsx
+var floorMapFallbackRender_exports = {};
+__export(floorMapFallbackRender_exports, {
+  renderFloorMapFallbackPlaceholder: () => renderFloorMapFallbackPlaceholder,
+  renderFloorMapRenderError: () => renderFloorMapRenderError
+});
+module.exports = __toCommonJS(floorMapFallbackRender_exports);
+var import_react = __toESM(require("react"));
+var import_types = require("../types");
+var import_floorMapElementKindUtils = require("./floorMapElementKindUtils");
+var import_FloorMapImageElement = require("../components/FloorMapImageElement");
+var import_floorMapStageDefaults = require("./floorMapStageDefaults");
+function renderFloorMapRenderError(message) {
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      style: {
+        padding: 8,
+        fontSize: 12,
+        color: "#cf1322",
+        background: "#fff2f0",
+        border: "1px solid #ffccc7",
+        borderRadius: 4,
+        height: "100%",
+        boxSizing: "border-box",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        textAlign: "center",
+        wordBreak: "break-word"
+      }
+    },
+    message
+  );
+}
+function renderFloorMapFallbackPlaceholder(item) {
+  var _a, _b;
+  const kind = (item == null ? void 0 : item.elementKind) || "item";
+  const isCircle = (item == null ? void 0 : item.shape) === "circle";
+  const isStage = kind === import_types.FLOOR_MAP_STAGE_ELEMENT_KIND;
+  const nameText = (item == null ? void 0 : item.name) != null ? String(item.name).trim() : "";
+  const fallbackLabel = nameText || kind;
+  if ((0, import_floorMapElementKindUtils.isFloorMapImageElementKind)(kind)) {
+    const url = (_a = item._sceneElement) == null ? void 0 : _a.imageUrl;
+    return /* @__PURE__ */ import_react.default.createElement(
+      import_FloorMapImageElement.FloorMapImageElement,
+      {
+        imageUrl: url,
+        name: item.name ?? ((_b = item._sceneElement) == null ? void 0 : _b.name)
+      }
+    );
+  }
+  if (isStage) {
+    const display = nameText || import_floorMapStageDefaults.STAGE_DECO_DEFAULT.name;
+    return /* @__PURE__ */ import_react.default.createElement(
+      "div",
+      {
+        style: {
+          width: "100%",
+          height: "100%",
+          boxSizing: "border-box",
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "center",
+          padding: 8,
+          background: "linear-gradient(180deg, #fafafa 0%, #ececec 100%)",
+          border: "2px dashed #595959",
+          borderRadius: 8,
+          fontSize: 15,
+          fontWeight: 600,
+          color: "#262626",
+          textAlign: "center",
+          wordBreak: "break-word",
+          lineHeight: 1.35,
+          overflow: "hidden"
+        }
+      },
+      display
+    );
+  }
+  return /* @__PURE__ */ import_react.default.createElement(
+    "div",
+    {
+      style: {
+        width: "100%",
+        height: "100%",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        background: "#f0f0f0",
+        border: "1px solid #d9d9d9",
+        borderRadius: isCircle ? "50%" : 4,
+        fontSize: 12,
+        color: "#666",
+        overflow: "hidden",
+        padding: 4,
+        textAlign: "center",
+        wordBreak: "break-word"
+      }
+    },
+    fallbackLabel
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  renderFloorMapFallbackPlaceholder,
+  renderFloorMapRenderError
+});

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

@@ -0,0 +1,8 @@
+/**
+ * 舞台/区域类装饰：落点默认尺寸与默认显示名（与 FLOOR_MAP_STAGE_ELEMENT_KIND 配套）
+ */
+export declare const STAGE_DECO_DEFAULT: {
+    readonly width: 320;
+    readonly height: 120;
+    readonly name: "舞台";
+};