@pisell/materials 6.11.17 → 6.11.18

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

@@ -0,0 +1,155 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/**
+ * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
+ */
+
+import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { STAGE_DECO_DEFAULT } from "./floorMapStageDefaults";
+
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export function isFloorMapImageElementKind(kind) {
+  return kind === FLOOR_MAP_IMAGE_ELEMENT_KIND;
+}
+
+/** dataBindingPolicy 缺省视为 none */
+export function resolveDataBindingPolicy(kind) {
+  var _kind$dataBindingPoli;
+  return (_kind$dataBindingPoli = kind === null || kind === void 0 ? void 0 : kind.dataBindingPolicy) !== null && _kind$dataBindingPoli !== void 0 ? _kind$dataBindingPoli : 'none';
+}
+export function getElementKindConfig(config, elementKind) {
+  var _config$elementKinds;
+  if (!elementKind || !(config !== null && config !== void 0 && (_config$elementKinds = config.elementKinds) !== null && _config$elementKinds !== void 0 && _config$elementKinds.length)) return undefined;
+  return config.elementKinds.find(function (k) {
+    return k.value === elementKind;
+  });
+}
+
+/**
+ * 与调色板分组一致：取与当前图元 **同一 categoryId**（含未填 categoryId 时落到首个分类）下的可切换种类，
+ * 排除舞台、底图。若仅有一种则编辑面板可不展示切换器。
+ */
+export function getSwappableElementKindsInSameCategory(config, elementKind) {
+  var _config$elementKinds2, _config$elementKindCa, _sorted$0$id, _sorted$, _self$categoryId;
+  if (!elementKind || !((_config$elementKinds2 = config.elementKinds) !== null && _config$elementKinds2 !== void 0 && _config$elementKinds2.length)) return [];
+  var rawCats = (_config$elementKindCa = config.elementKindCategories) !== null && _config$elementKindCa !== void 0 ? _config$elementKindCa : [];
+  var sorted = _toConsumableArray(rawCats).sort(function (a, b) {
+    var _a$order, _b$order;
+    return ((_a$order = a.order) !== null && _a$order !== void 0 ? _a$order : 0) - ((_b$order = b.order) !== null && _b$order !== void 0 ? _b$order : 0);
+  });
+  var fallbackId = (_sorted$0$id = (_sorted$ = sorted[0]) === null || _sorted$ === void 0 ? void 0 : _sorted$.id) !== null && _sorted$0$id !== void 0 ? _sorted$0$id : '_uncat';
+  var self = config.elementKinds.find(function (k) {
+    return k.value === elementKind;
+  });
+  if (!self) return [];
+  var cid = (_self$categoryId = self.categoryId) !== null && _self$categoryId !== void 0 ? _self$categoryId : fallbackId;
+  return config.elementKinds.filter(function (k) {
+    var _k$categoryId;
+    if (k.showInPalette === false) return false;
+    if (k.value === FLOOR_MAP_STAGE_ELEMENT_KIND) return false;
+    if (k.value === FLOOR_MAP_IMAGE_ELEMENT_KIND) return false;
+    return ((_k$categoryId = k.categoryId) !== null && _k$categoryId !== void 0 ? _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;
+
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 kind 时的草稿 patch（绑定不兼容则清空）
+ */
+export function patchSceneElementForKindSwitch(config, element, nextKindValue) {
+  var _nextCfg$allowedDataS, _element$width, _element$width2, _element$height, _element$height2, _nextCfg$defaultPrese;
+  var nextCfg = getElementKindConfig(config, nextKindValue);
+  var nextPol = resolveDataBindingPolicy(nextCfg);
+  var binding = element.dataBinding;
+  var isNextImage = isFloorMapImageElementKind(nextKindValue);
+  var isNextStage = nextKindValue === FLOOR_MAP_STAGE_ELEMENT_KIND;
+  var clearBinding = false;
+  if (nextPol === 'none') {
+    clearBinding = true;
+  } else if (binding && nextCfg !== null && nextCfg !== void 0 && (_nextCfg$allowedDataS = nextCfg.allowedDataSourceKeys) !== null && _nextCfg$allowedDataS !== void 0 && _nextCfg$allowedDataS.length) {
+    if (!nextCfg.allowedDataSourceKeys.includes(binding.dataSourceKey)) {
+      clearBinding = true;
+    }
+  }
+  var nextW = isNextImage ? IMAGE_PLACE_W : isNextStage ? STAGE_DECO_DEFAULT.width : DEFAULT_PLACE_W;
+  var nextH = isNextImage ? IMAGE_PLACE_H : isNextStage ? STAGE_DECO_DEFAULT.height : DEFAULT_PLACE_H;
+  var useDecoSize = nextPol === 'none' && nextKindValue !== FLOOR_MAP_STAGE_ELEMENT_KIND && !isNextImage;
+  var width = useDecoSize ? Math.max((_element$width = element.width) !== null && _element$width !== void 0 ? _element$width : DECO_SIZE, DECO_SIZE) : Math.max((_element$width2 = element.width) !== null && _element$width2 !== void 0 ? _element$width2 : nextW, nextW);
+  var height = useDecoSize ? Math.max((_element$height = element.height) !== null && _element$height !== void 0 ? _element$height : DECO_SIZE, DECO_SIZE) : Math.max((_element$height2 = element.height) !== null && _element$height2 !== void 0 ? _element$height2 : nextH, nextH);
+  var patch = {
+    elementKind: nextKindValue,
+    shape: isNextStage || isNextImage ? 'rect' : nextCfg === null || nextCfg === void 0 ? void 0 : nextCfg.defaultShape,
+    width: width,
+    height: height,
+    name: (nextCfg === null || nextCfg === void 0 || (_nextCfg$defaultPrese = nextCfg.defaultPresentation) === null || _nextCfg$defaultPrese === void 0 ? void 0 : _nextCfg$defaultPrese.title) != null && String(nextCfg.defaultPresentation.title).trim() !== '' ? String(nextCfg.defaultPresentation.title) : element.name
+  };
+  if (clearBinding) {
+    patch.dataBinding = undefined;
+  }
+  if (isNextImage) {
+    var _element$imageUrl;
+    patch.imageUrl = (_element$imageUrl = element.imageUrl) !== null && _element$imageUrl !== void 0 ? _element$imageUrl : '';
+  } else {
+    patch.imageUrl = undefined;
+  }
+  return patch;
+}
+
+/**
+ * @returns 人类可读错误文案；无问题时返回 null
+ */
+export function getSceneElementRenderIssue(element, kind, dataSources) {
+  var policy = resolveDataBindingPolicy(kind);
+  var binding = element.dataBinding;
+  if (policy === 'required' && !binding) {
+    return '该图元须绑定数据源行';
+  }
+  if (!binding) return null;
+  var keys = kind === null || kind === void 0 ? void 0 : kind.allowedDataSourceKeys;
+  if (keys !== null && keys !== void 0 && keys.length && !keys.includes(binding.dataSourceKey)) {
+    return "\u6570\u636E\u6E90\u300C".concat(binding.dataSourceKey, "\u300D\u4E0D\u5728\u8BE5\u56FE\u5143\u5141\u8BB8\u5217\u8868\u5185");
+  }
+  var rows = dataSources === null || dataSources === void 0 ? void 0 : dataSources[binding.dataSourceKey];
+  var rid = binding.recordId != null ? String(binding.recordId).trim() : '';
+
+  /**
+   * 未选行、new_ 占位、或列表中已无该行：不在这里拦截，
+   * 交给 renderItemByKind（方桌/圆桌/蘸料等）使用统一的浅底虚线占位，避免只有红字无卡片感。
+   */
+  if (rid === '' || rid.startsWith('new_')) {
+    return null;
+  }
+  var row = rows === null || rows === void 0 ? void 0 : rows.find(function (r) {
+    return r.id === rid;
+  });
+  if (!row) {
+    return null;
+  }
+  var expected = kind === null || kind === void 0 ? void 0 : kind.expectedRecordFields;
+  if (expected !== null && expected !== void 0 && expected.length) {
+    var _iterator = _createForOfIteratorHelper(expected),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var f = _step.value;
+        if (row[f] === undefined || row[f] === null || row[f] === '') {
+          return "\u6570\u636E\u884C\u7F3A\u5C11\u5FC5\u586B\u5B57\u6BB5\uFF1A".concat(f);
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }
+  return null;
+}

package/es/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/es/components/pisellFloorMapLayout/utils/floorMapFallbackRender.js

@@ -0,0 +1,89 @@
+/**
+ * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
+ */
+import React from 'react';
+import { FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { isFloorMapImageElementKind } from "./floorMapElementKindUtils";
+import { FloorMapImageElement } from "../components/FloorMapImageElement";
+import { STAGE_DECO_DEFAULT } from "./floorMapStageDefaults";
+
+/**
+ * @returns 与 PisellFloorMapLayout 内联 fallback 一致的渲染函数（useCallback 由调用方包裹）
+ */
+/** 绑定校验失败或 renderItemByKind 抛错时的占位 */
+export function renderFloorMapRenderError(message) {
+  return /*#__PURE__*/React.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);
+}
+export function renderFloorMapFallbackPlaceholder(item) {
+  var kind = (item === null || item === void 0 ? void 0 : item.elementKind) || 'item';
+  var isCircle = (item === null || item === void 0 ? void 0 : item.shape) === 'circle';
+  var isStage = kind === FLOOR_MAP_STAGE_ELEMENT_KIND;
+  var nameText = (item === null || item === void 0 ? void 0 : item.name) != null ? String(item.name).trim() : '';
+  var fallbackLabel = nameText || kind;
+  if (isFloorMapImageElementKind(kind)) {
+    var _item$_sceneElement, _item$name, _item$_sceneElement2;
+    var url = (_item$_sceneElement = item._sceneElement) === null || _item$_sceneElement === void 0 ? void 0 : _item$_sceneElement.imageUrl;
+    return /*#__PURE__*/React.createElement(FloorMapImageElement, {
+      imageUrl: url,
+      name: (_item$name = item.name) !== null && _item$name !== void 0 ? _item$name : (_item$_sceneElement2 = item._sceneElement) === null || _item$_sceneElement2 === void 0 ? void 0 : _item$_sceneElement2.name
+    });
+  }
+  if (isStage) {
+    var display = nameText || STAGE_DECO_DEFAULT.name;
+    return /*#__PURE__*/React.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__*/React.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);
+}

package/es/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: "舞台";
+};

package/es/components/pisellFloorMapLayout/utils/floorMapStageDefaults.js

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

package/es/components/pisellFloorMapLayout/utils/floorMapViewConfigDiff.d.ts

@@ -0,0 +1,8 @@
+import type { FloorMapViewConfig } from '../types';
+/**
+ * 与 {@link useFloorMapEditState} 中 `useEffect` 逻辑一致：补全 `canvasUi`、空 `elementKinds` 时的默认调色板、`sceneElements`。
+ * 用于从上游 prop 得到「可与当前 draft 公平比较」的基准配置。
+ */
+export declare function normalizeFloorMapViewConfigFromProp(floorMapConfigProp: FloorMapViewConfig): FloorMapViewConfig;
+/** 判断当前编辑草稿是否与基准配置一致（数组顺序无关） */
+export declare function floorMapViewConfigsEqual(a: FloorMapViewConfig, b: FloorMapViewConfig): boolean;

package/es/components/pisellFloorMapLayout/utils/floorMapViewConfigDiff.js

@@ -0,0 +1,108 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 平面图 FloorMapViewConfig：与 props 同步时的规范化、以及草稿与持久化配置是否一致的比较
+ */
+import isEqual from 'lodash/isEqual';
+import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+/**
+ * 与 {@link useFloorMapEditState} 中 `useEffect` 逻辑一致：补全 `canvasUi`、空 `elementKinds` 时的默认调色板、`sceneElements`。
+ * 用于从上游 prop 得到「可与当前 draft 公平比较」的基准配置。
+ */
+export function normalizeFloorMapViewConfigFromProp(floorMapConfigProp) {
+  var _src$canCreate, _src$canEdit;
+  var src = floorMapConfigProp;
+  var base = src.canvasUi != null ? structuredClone(src) : structuredClone(_objectSpread(_objectSpread({}, src), {}, {
+    canvasUi: {
+      canCreate: (_src$canCreate = src.canCreate) !== null && _src$canCreate !== void 0 ? _src$canCreate : false,
+      canEdit: (_src$canEdit = src.canEdit) !== null && _src$canEdit !== void 0 ? _src$canEdit : false
+    }
+  }));
+  if (base.canvasUi.canCreate && (!base.elementKinds || base.elementKinds.length === 0)) {
+    base.elementKindCategories = [{
+      id: 'furniture',
+      label: '桌椅设施',
+      order: 0
+    }, {
+      id: 'decoration',
+      label: '装饰与区域',
+      order: 1
+    }];
+    base.elementKinds = [{
+      value: 'table',
+      label: '方桌',
+      categoryId: 'furniture',
+      dataBindingPolicy: 'optional',
+      allowedDataSourceKeys: ['sales'],
+      showInPalette: true
+    }, {
+      value: 'marker',
+      label: '标记',
+      categoryId: 'decoration',
+      dataBindingPolicy: 'none',
+      showInPalette: true
+    }, {
+      value: FLOOR_MAP_STAGE_ELEMENT_KIND,
+      label: '舞台/区域',
+      categoryId: 'decoration',
+      dataBindingPolicy: 'none',
+      showInPalette: true
+    }, {
+      value: FLOOR_MAP_IMAGE_ELEMENT_KIND,
+      label: '图片（底图）',
+      categoryId: 'decoration',
+      dataBindingPolicy: 'none',
+      showInPalette: true
+    }, {
+      value: 'icon',
+      label: '图标',
+      categoryId: 'decoration',
+      dataBindingPolicy: 'none',
+      defaultShape: 'circle',
+      showInPalette: true
+    }];
+  }
+  if (!base.sceneElements) base.sceneElements = [];
+  return base;
+}
+function sortStableForCompare(config) {
+  var _c$sceneElements, _c$elementKinds, _c$elementKindCategor, _c$edges;
+  var c = structuredClone(config);
+  c.canvases = _toConsumableArray(c.canvases).sort(function (a, b) {
+    return String(a.id).localeCompare(String(b.id));
+  });
+  c.sceneElements = _toConsumableArray((_c$sceneElements = c.sceneElements) !== null && _c$sceneElements !== void 0 ? _c$sceneElements : []).sort(function (a, b) {
+    return String(a.instanceId).localeCompare(String(b.instanceId));
+  });
+  if ((_c$elementKinds = c.elementKinds) !== null && _c$elementKinds !== void 0 && _c$elementKinds.length) {
+    c.elementKinds = _toConsumableArray(c.elementKinds).sort(function (a, b) {
+      return String(a.value).localeCompare(String(b.value));
+    });
+  }
+  if ((_c$elementKindCategor = c.elementKindCategories) !== null && _c$elementKindCategor !== void 0 && _c$elementKindCategor.length) {
+    c.elementKindCategories = _toConsumableArray(c.elementKindCategories).sort(function (a, b) {
+      return String(a.id).localeCompare(String(b.id));
+    });
+  }
+  if ((_c$edges = c.edges) !== null && _c$edges !== void 0 && _c$edges.length) {
+    c.edges = _toConsumableArray(c.edges).sort(function (a, b) {
+      return String(a.id).localeCompare(String(b.id));
+    });
+  }
+  return c;
+}
+
+/** 判断当前编辑草稿是否与基准配置一致（数组顺序无关） */
+export function floorMapViewConfigsEqual(a, b) {
+  return isEqual(sortStableForCompare(a), sortStableForCompare(b));
+}

package/es/components/pisellFloorMapLayout/utils/layoutMeasurements.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 平面图/布局内容区尺寸计算：格子与像素单位、gap 解析、包围盒
+ */
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+/** 默认每格像素 */
+export declare const DEFAULT_CELL_SIZE = 64;
+/** 默认 item 间距（像素） */
+export declare const DEFAULT_ITEM_GAP = 8;
+/**
+ * 将 mapLayer.gap 解析为像素数
+ */
+export declare function gapToPx(gap: number | string | undefined): number;
+/**
+ * 根据 items 计算内容区像素宽高
+ * - cell：按格子数 + cellSize + itemGap 计算
+ * - pixel：按 item 的 x/y/width/height 像素取边界（仅右/下边界，用于非 floor map 或兼容）
+ */
+export declare function getContentSize<T extends FloorMapItemBase>(items: T[], cellSize: number, itemGap: number, itemUnit: FloorMapItemUnit): {
+    contentWidth: number;
+    contentHeight: number;
+};
+/**
+ * pixel 模式下取 items 包围盒（含左/上），用于画布四周扩 padding 时的尺寸与偏移
+ */
+export declare function getPixelBoundingBox<T extends FloorMapItemBase>(items: T[], cellSize: number): {
+    minLeft: number;
+    minTop: number;
+    maxRight: number;
+    maxBottom: number;
+} | null;

package/es/components/pisellFloorMapLayout/utils/layoutMeasurements.js

@@ -0,0 +1,125 @@
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/**
+ * 平面图/布局内容区尺寸计算：格子与像素单位、gap 解析、包围盒
+ */
+
+/** 默认每格像素 */
+export var DEFAULT_CELL_SIZE = 64;
+
+/** 默认 item 间距（像素） */
+export var DEFAULT_ITEM_GAP = 8;
+
+/**
+ * 将 mapLayer.gap 解析为像素数
+ */
+export function gapToPx(gap) {
+  if (gap === undefined) return DEFAULT_ITEM_GAP;
+  if (typeof gap === 'number') return gap;
+  var match = String(gap).match(/^(\d+(?:\.\d+)?)\s*px?$/i);
+  return match ? Number(match[1]) : DEFAULT_ITEM_GAP;
+}
+
+/**
+ * 根据 items 计算内容区像素宽高
+ * - cell：按格子数 + cellSize + itemGap 计算
+ * - pixel：按 item 的 x/y/width/height 像素取边界（仅右/下边界，用于非 floor map 或兼容）
+ */
+export function getContentSize(items, cellSize, itemGap, itemUnit) {
+  if (!items.length) {
+    if (itemUnit === 'pixel') {
+      return {
+        contentWidth: cellSize * 4,
+        contentHeight: cellSize * 3
+      };
+    }
+    var _g = itemGap;
+    return {
+      contentWidth: 4 * (cellSize + _g) + _g,
+      contentHeight: 3 * (cellSize + _g) + _g
+    };
+  }
+  if (itemUnit === 'pixel') {
+    var maxRight = 0;
+    var maxBottom = 0;
+    var _iterator = _createForOfIteratorHelper(items),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var _item$width, _item$height;
+        var item = _step.value;
+        var w = (_item$width = item.width) !== null && _item$width !== void 0 ? _item$width : cellSize;
+        var h = (_item$height = item.height) !== null && _item$height !== void 0 ? _item$height : cellSize;
+        maxRight = Math.max(maxRight, item.x + w);
+        maxBottom = Math.max(maxBottom, item.y + h);
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+    return {
+      contentWidth: maxRight,
+      contentHeight: maxBottom
+    };
+  }
+  var maxX = 0;
+  var maxY = 0;
+  var _iterator2 = _createForOfIteratorHelper(items),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _item$width2, _item$height2;
+      var _item = _step2.value;
+      var _w = (_item$width2 = _item.width) !== null && _item$width2 !== void 0 ? _item$width2 : 1;
+      var _h = (_item$height2 = _item.height) !== null && _item$height2 !== void 0 ? _item$height2 : 1;
+      maxX = Math.max(maxX, _item.x + _w);
+      maxY = Math.max(maxY, _item.y + _h);
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  var g = itemGap;
+  return {
+    contentWidth: maxX * (cellSize + g) + g,
+    contentHeight: maxY * (cellSize + g) + g
+  };
+}
+
+/**
+ * pixel 模式下取 items 包围盒（含左/上），用于画布四周扩 padding 时的尺寸与偏移
+ */
+export function getPixelBoundingBox(items, cellSize) {
+  if (!items.length) return null;
+  var minLeft = Infinity;
+  var minTop = Infinity;
+  var maxRight = -Infinity;
+  var maxBottom = -Infinity;
+  var _iterator3 = _createForOfIteratorHelper(items),
+    _step3;
+  try {
+    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+      var _item$width3, _item$height3;
+      var item = _step3.value;
+      var w = (_item$width3 = item.width) !== null && _item$width3 !== void 0 ? _item$width3 : cellSize;
+      var h = (_item$height3 = item.height) !== null && _item$height3 !== void 0 ? _item$height3 : cellSize;
+      minLeft = Math.min(minLeft, item.x);
+      minTop = Math.min(minTop, item.y);
+      maxRight = Math.max(maxRight, item.x + w);
+      maxBottom = Math.max(maxBottom, item.y + h);
+    }
+  } catch (err) {
+    _iterator3.e(err);
+  } finally {
+    _iterator3.f();
+  }
+  return {
+    minLeft: minLeft,
+    minTop: minTop,
+    maxRight: maxRight,
+    maxBottom: maxBottom
+  };
+}

package/es/components/pisellFloorMapLayout/utils/mergeCanvasesForTabs.d.ts

@@ -0,0 +1,7 @@
+import type { FloorMapCanvas, FloorMapViewConfig } from '../types';
+/**
+ * 为画布 Tab 合并展示用字段：
+ * - `tabBadge` 若在配置中已给出则原样使用（含 0）；
+ * - 否则用当前 `sceneElements` 中属于该画布的数量，且仅在大于 0 时展示角标。
+ */
+export declare function mergeCanvasesForTabs(config: FloorMapViewConfig): FloorMapCanvas[];

package/es/components/pisellFloorMapLayout/utils/mergeCanvasesForTabs.js

@@ -0,0 +1,29 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/**
+ * 为画布 Tab 合并展示用字段：
+ * - `tabBadge` 若在配置中已给出则原样使用（含 0）；
+ * - 否则用当前 `sceneElements` 中属于该画布的数量，且仅在大于 0 时展示角标。
+ */
+export function mergeCanvasesForTabs(config) {
+  var _config$sceneElements;
+  var elements = (_config$sceneElements = config.sceneElements) !== null && _config$sceneElements !== void 0 ? _config$sceneElements : [];
+  return config.canvases.map(function (c) {
+    var autoCount = elements.filter(function (e) {
+      return e.canvasId === c.id;
+    }).length;
+    var tabBadge;
+    if (c.tabBadge !== undefined && c.tabBadge !== null) {
+      tabBadge = c.tabBadge;
+    } else if (autoCount > 0) {
+      tabBadge = autoCount;
+    }
+    return _objectSpread(_objectSpread({}, c), {}, {
+      tabBadge: tabBadge
+    });
+  });
+}

package/es/components/pisellFloorMapLayout/utils/snap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 吸附：将坐标或尺寸按 snapStep 取整；snapStep 为 0 不吸附
+ */
+export declare function snapValue(value: number, snapStep: number): number;
+export declare function snapRect(x: number, y: number, width: number, height: number, snapStep: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

package/es/components/pisellFloorMapLayout/utils/snap.js

@@ -0,0 +1,21 @@
+/**
+ * 吸附：将坐标或尺寸按 snapStep 取整；snapStep 为 0 不吸附
+ */
+export function snapValue(value, snapStep) {
+  if (!snapStep || snapStep <= 0) return value;
+  return Math.round(value / snapStep) * snapStep;
+}
+export function snapRect(x, y, width, height, snapStep) {
+  if (!snapStep || snapStep <= 0) return {
+    x: x,
+    y: y,
+    width: width,
+    height: height
+  };
+  return {
+    x: snapValue(x, snapStep),
+    y: snapValue(y, snapStep),
+    width: Math.max(snapStep, snapValue(width, snapStep)),
+    height: Math.max(snapStep, snapValue(height, snapStep))
+  };
+}

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { PisellHierarchicalSummaryListProps } from './types';
+import './PisellHierarchicalSummaryList.less';
+/** 根节点类名，供上层用同一 DOM 包裹列表与其它区块时使用 */
+export declare const PREFIX_CLS = "pisell-hierarchical-summary-list";
+export declare const PisellHierarchicalSummaryList: React.FC<PisellHierarchicalSummaryListProps>;