@pisell/materials 6.11.42 → 6.11.44

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

@@ -15,12 +15,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  */
 import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import { getContentSize, getPixelBoundingBox } from "../utils/layoutMeasurements";
-
-/** 平面图包围盒单侧默认外扩（像素）；过大会导致首屏大量空白 */
-var DEFAULT_BOUNDING_PADDING = 56;
-
-/** 视口内与首屏对齐时，图元束左上与容器边缘的留白 */
-var VIEWPORT_TOP_LEFT_MARGIN = 16;
+import { DEFAULT_BOUNDING_PADDING, FIT_BOUNDS_MATCH_POS_EPSILON, FIT_BOUNDS_MATCH_SCALE_EPSILON, VIEWPORT_PERSIST_DEBOUNCE_MS, VIEWPORT_TOP_LEFT_MARGIN, readPersistedViewport, readPersistedViewportLock, writePersistedViewport, writePersistedViewportLock } from "./floorMapViewportPersistence";
 
 /** react-zoom-pan-pinch TransformWrapper render 注入的上下文 */
 
@@ -35,7 +30,8 @@ export function useFloorMapTransformMetrics(params) {
     transformRef = params.transformRef,
     contentOffsetRef = params.contentOffsetRef,
     boundingPaddingProp = params.boundingPadding,
-    frameResetKey = params.frameResetKey;
+    frameResetKey = params.frameResetKey,
+    viewportPersistKey = params.viewportPersistKey;
   var padSingle = boundingPaddingProp !== null && boundingPaddingProp !== void 0 ? boundingPaddingProp : DEFAULT_BOUNDING_PADDING;
   var containerRef = useRef(null);
   var mapAreaRef = useRef(null);
@@ -109,6 +105,49 @@ export function useFloorMapTransformMetrics(params) {
     _useState8 = _slicedToArray(_useState7, 2),
     isFullscreen = _useState8[0],
     setIsFullscreen = _useState8[1];
+
+  /**
+   * 「适配视口」激活态：当前 transform 与最近一次 fitBounds 计算出的目标 transform 在容差内一致时为 true。
+   * 由 fitBounds 写入快照、notifyTransformed 比较；用户主动拖动/缩放后立即失活。
+   */
+  var lastFitSnapshotRef = useRef(null);
+  var _useState9 = useState(false),
+    _useState10 = _slicedToArray(_useState9, 2),
+    isAtFitBounds = _useState10[0],
+    setIsAtFitBounds = _useState10[1];
+
+  /**
+   * 视口锁定态：按 viewportPersistKey 维度持久化到 localStorage。
+   * - 切 / 挂载时按 key 读初始值；
+   * - 用户切换时立刻写回；
+   * - 锁定后 fitBounds / 程序化 zoom 入口与 PisellFloorMapLayout 透传到 TransformWrapper 的
+   *   panning/wheel/pinch.disabled 共同把所有视角写入路径关闭。
+   * 切 canvas（key 变化）时跟随新 key 重新初始化，互不影响。
+   */
+  var _useState11 = useState(function () {
+      return viewportPersistKey ? readPersistedViewportLock(viewportPersistKey) : false;
+    }),
+    _useState12 = _slicedToArray(_useState11, 2),
+    viewportLocked = _useState12[0],
+    setViewportLockedState = _useState12[1];
+  var viewportLockedRef = useRef(viewportLocked);
+  viewportLockedRef.current = viewportLocked;
+  useEffect(function () {
+    if (!viewportPersistKey) {
+      setViewportLockedState(false);
+      return;
+    }
+    setViewportLockedState(readPersistedViewportLock(viewportPersistKey));
+  }, [viewportPersistKey]);
+  var setViewportLocked = useCallback(function (next) {
+    setViewportLockedState(next);
+    var key = viewportPersistKey;
+    if (!key) return;
+    writePersistedViewportLock(key, next);
+  }, [viewportPersistKey]);
+  var toggleViewportLocked = useCallback(function () {
+    setViewportLocked(!viewportLockedRef.current);
+  }, [setViewportLocked]);
   var _useMemo = useMemo(function () {
       var fromItems = getContentSize(items, cellSize, itemGap, effectiveItemUnit);
       var pad = padSingle * 2;
@@ -203,32 +242,60 @@ export function useFloorMapTransformMetrics(params) {
       cancelAnimationFrame(raf);
     };
   }, [isFloorMapView, frameResetKey, alignPadSingle, initialPositionX, initialPositionY, zoomConfig.initialScale, transformRef, autoFitOnMount]);
+
+  /**
+   * 伪全屏：用 `position: fixed; inset: 0` 撑满视口，不调用浏览器 Fullscreen API。
+   * 与「资源墙大屏」一致的体验：避免浏览器全屏带来的右键菜单受限、第三方弹层被全屏元素隔绝等。
+   *
+   * 对应 className 与 body overflow 锁定见 PisellFloorMapLayout.less 中
+   * `.pisell-floor-map-layout--pseudo-fullscreen` 与 `body.pisell-floor-map-layout-fullscreen-host`。
+   *
+   * 注意：不再监听 ESC 退出全屏。平面图编辑态全屏与编辑模式强绑定（PisellFloorMapLayout 中 effect），
+   * 若 ESC 直接 setIsFullscreen(false) 会立刻被同步 effect 拉回 true，徒增闪烁。
+   * 退出全屏 = 退出编辑，由顶栏退出按钮承担。
+   */
   useEffect(function () {
-    var el = containerRef.current;
-    if (!el) return;
-    var onFullscreenChange = function onFullscreenChange() {
-      return setIsFullscreen(document.fullscreenElement === el);
+    if (!isFullscreen) return;
+    if (typeof document === 'undefined') return;
+    var bodyCls = 'pisell-floor-map-layout-fullscreen-host';
+    document.body.classList.add(bodyCls);
+    return function () {
+      document.body.classList.remove(bodyCls);
     };
-    document.addEventListener('fullscreenchange', onFullscreenChange);
+  }, [isFullscreen]);
+
+  /** 卸载兜底：组件被卸载时不要把 body 锁住的样式残留 */
+  useEffect(function () {
     return function () {
-      return document.removeEventListener('fullscreenchange', onFullscreenChange);
+      if (typeof document === 'undefined') return;
+      document.body.classList.remove('pisell-floor-map-layout-fullscreen-host');
     };
   }, []);
   var toggleFullscreen = useCallback(function () {
-    var el = containerRef.current;
-    if (!el) return;
-    if (document.fullscreenElement) {
-      var _document$exitFullscr, _document;
-      (_document$exitFullscr = (_document = document).exitFullscreen) === null || _document$exitFullscr === void 0 || _document$exitFullscr.call(_document);
-    } else {
-      var _el$requestFullscreen;
-      (_el$requestFullscreen = el.requestFullscreen) === null || _el$requestFullscreen === void 0 || _el$requestFullscreen.call(el);
-    }
+    setIsFullscreen(function (prev) {
+      return !prev;
+    });
   }, []);
 
+  /**
+   * 仅保留 fitBoundsRef 给手动 fitBounds 按钮用。
+   *
+   * 历史上这里有个 useEffect：进入伪全屏时自动 fitBounds 适配新视口。
+   * 但现在「编辑态自动全屏 + 视口持久化」的组合下，这会把用户上次保存的视角
+   * 覆盖成 fit 结果，导致每次进编辑都被强制全览，违背用户意图。
+   * 视口尺寸变化由 ResizeObserver 自然处理，transform 不变即「保留用户视角」。
+   */
+  var fitBoundsRef = useRef(null);
+
   /** @returns 是否已调用 setTransform（用于首屏 autoFit：避免空跑仍标记 done） */
   var fitBounds = useCallback(function () {
     var _zoom$max3;
+    /**
+     * 锁定态：拦截所有 fitBounds 触发路径（按钮 / autoFit useLayoutEffect / ref API），
+     * 让画布严格停留在用户锁定时的视角。返回 true 让 autoFit 调用方将 done 置位，
+     * 避免被无限重试占用 rAF。
+     */
+    if (viewportLockedRef.current) return true;
     var ctx = transformRef.current;
     var container = containerRef.current;
     if (!ctx || !container) return false;
@@ -257,6 +324,12 @@ export function useFloorMapTransformMetrics(params) {
       var _x = wrapperRect.width / 2 - bboxCx * _nextScale;
       var _y = wrapperRect.height / 2 - bboxCy * _nextScale;
       ctx.setTransform(_x, _y, _nextScale);
+      lastFitSnapshotRef.current = {
+        x: _x,
+        y: _y,
+        scale: _nextScale
+      };
+      setIsAtFitBounds(true);
       return true;
     }
     if (contentWidth <= 0 || contentHeight <= 0) return false;
@@ -267,9 +340,18 @@ export function useFloorMapTransformMetrics(params) {
     var x = VIEWPORT_TOP_LEFT_MARGIN - padA * nextScale;
     var y = VIEWPORT_TOP_LEFT_MARGIN - padA * nextScale;
     ctx.setTransform(x, y, nextScale);
+    lastFitSnapshotRef.current = {
+      x: x,
+      y: y,
+      scale: nextScale
+    };
+    setIsAtFitBounds(true);
     return true;
   }, [contentWidth, contentHeight, zoom.max, transformRef, alignPadSingle, isFloorMapView, effectiveItemUnit, items, cellSize, padSingle]);
 
+  /** 让"进入伪全屏后自动 fit"的 effect 能拿到最新的 fitBounds 实现 */
+  fitBoundsRef.current = fitBounds;
+
   /**
    * autoFitOnMount：每个画布在「有图元且 content 尺寸已按包围盒算好」后执行一次 fitBounds。
    * 避免首帧 items 仍为空时用占位尺寸 fit 完并标记 done，导致异步图元加载后不再适配。
@@ -279,6 +361,13 @@ export function useFloorMapTransformMetrics(params) {
     done: false
   });
   var prevItemsCountForAutoFitRef = useRef(null);
+  /**
+   * 记录「本 frame 的 transform 已由视口缓存接管」：
+   * 命中 localStorage 恢复或 restore effect 完成后写入当前 frame。
+   * 只要等于当前 frame，autoFit 所有分支（包括 items 从 0→N 的 reset done）一律放弃，
+   * 防止 items 异步加载后 autoFit 覆盖恢复值 → onTransformed 又把 fit 结果回写到 localStorage。
+   */
+  var cachedRestoredFrameRef = useRef('');
   /**
    * 首屏 auto fit：时序上易出现「Transform 未挂载 / wrapper 尺寸为 0 / 内容区尚未提交」，
    * 用 layoutEffect + 双 rAF 贴近浏览器布局完成时刻；仅 fitBounds 真正 setTransform 后才记 done；
@@ -293,10 +382,26 @@ export function useFloorMapTransformMetrics(params) {
         done: false
       };
       prevItemsCountForAutoFitRef.current = null;
+      /**
+       * 命中视口缓存：跳过本帧 autoFit，让恢复 effect 用缓存 transform 接管。
+       * 避免「先 autoFit 一次再被恢复覆盖」造成的视觉闪烁。
+       * 同步打上「缓存接管」标记，防止下面的「items 0→N reset done」再度启用 autoFit
+       * 覆盖恢复值并把 fit 结果通过 onTransformed 回写 localStorage。
+       */
+      if (viewportPersistKey && readPersistedViewport(viewportPersistKey)) {
+        autoFitOnceRef.current.done = true;
+        cachedRestoredFrameRef.current = frame;
+      } else if (cachedRestoredFrameRef.current !== frame) {
+        cachedRestoredFrameRef.current = '';
+      }
     }
     var itemCount = items.length;
     var prevN = prevItemsCountForAutoFitRef.current;
-    if (prevN !== null && prevN === 0 && itemCount > 0) {
+    /**
+     * 已由缓存接管本 frame 的 transform：items 异步加载完成后绝不重新启用 autoFit，
+     * 否则会把用户上次拖拽的位置覆盖成适配视口，且被 onTransformed 回写 localStorage。
+     */
+    if (prevN !== null && prevN === 0 && itemCount > 0 && cachedRestoredFrameRef.current !== frame) {
       autoFitOnceRef.current.done = false;
     }
     prevItemsCountForAutoFitRef.current = itemCount;
@@ -349,16 +454,16 @@ export function useFloorMapTransformMetrics(params) {
       cancelled = true;
       cancelAnimationFrame(raf);
     };
-  }, [isFloorMapView, autoFitOnMount, frameResetKey, effectiveItemUnit, items.length, contentWidth, contentHeight, viewportSize.width, viewportSize.height, mapAreaSize.width, mapAreaSize.height, fitBounds, transformRef]);
+  }, [isFloorMapView, autoFitOnMount, frameResetKey, effectiveItemUnit, items.length, contentWidth, contentHeight, viewportSize.width, viewportSize.height, mapAreaSize.width, mapAreaSize.height, fitBounds, transformRef, viewportPersistKey]);
   var lastTransformRef = useRef({
     x: 0,
     y: 0,
     scale: 1
   });
-  var _useState9 = useState(false),
-    _useState10 = _slicedToArray(_useState9, 2),
-    isInteractingWithElement = _useState10[0],
-    setIsInteractingWithElement = _useState10[1];
+  var _useState13 = useState(false),
+    _useState14 = _slicedToArray(_useState13, 2),
+    isInteractingWithElement = _useState14[0],
+    setIsInteractingWithElement = _useState14[1];
   var prevInteractingRef = useRef(false);
   useEffect(function () {
     if (isInteractingWithElement) {
@@ -376,6 +481,210 @@ export function useFloorMapTransformMetrics(params) {
       return cancelAnimationFrame(raf);
     };
   }, [isInteractingWithElement, transformRef]);
+
+  /**
+   * 视口持久化：写入节流 + 切 canvas 时清掉 pending；
+   * persistKeyRef 保证 debounce 触发时仍然写到「触发时刻」对应的 key（避免 key 变化后被错位写入）。
+   */
+  var persistKeyRef = useRef(viewportPersistKey);
+  persistKeyRef.current = viewportPersistKey;
+  var persistTimerRef = useRef(null);
+  var flushPersistRef = useRef(null);
+  var schedulePersistViewport = useCallback(function (snapshot) {
+    var key = persistKeyRef.current;
+    if (!key) return;
+    if (persistTimerRef.current != null) {
+      clearTimeout(persistTimerRef.current);
+      persistTimerRef.current = null;
+    }
+    var targetKey = key;
+    var doWrite = function doWrite() {
+      persistTimerRef.current = null;
+      flushPersistRef.current = null;
+      writePersistedViewport(targetKey, snapshot);
+    };
+    flushPersistRef.current = doWrite;
+    persistTimerRef.current = setTimeout(doWrite, VIEWPORT_PERSIST_DEBOUNCE_MS);
+  }, []);
+
+  /**
+   * 由 onTransformed 回调统一上报当前 transform：
+   *   - 写 lastTransformRef（替代父组件直接赋值）
+   *   - 与最近一次 fitBounds 快照比较，更新激活态
+   *
+   * ❗注意：故意不在这里写 localStorage。
+   * react-zoom-pan-pinch 在挂载、`setTransform`、`fitBounds`、`resetTransform` 等程序化路径
+   * 也会触发 onTransformed（含挂载初始值 {x:16, y:16, scale:1}），若在此持久化，
+   * wrapper 重挂载时会用这份"初始值"覆盖 localStorage 里用户上次保存的视角。
+   * 持久化改由 onPanningStop / onPinchingStop / onZoomStop / onWheelStop 触发，
+   * 那些事件只在「用户真的拖完/缩放完」时才发生。
+   */
+  var notifyTransformed = useCallback(function (x, y, nextScale) {
+    lastTransformRef.current = {
+      x: x,
+      y: y,
+      scale: nextScale
+    };
+    var snap = lastFitSnapshotRef.current;
+    if (snap) {
+      var same = Math.abs(snap.x - x) < FIT_BOUNDS_MATCH_POS_EPSILON && Math.abs(snap.y - y) < FIT_BOUNDS_MATCH_POS_EPSILON && Math.abs(snap.scale - nextScale) < FIT_BOUNDS_MATCH_SCALE_EPSILON;
+      setIsAtFitBounds(function (prev) {
+        return prev === same ? prev : same;
+      });
+    } else {
+      setIsAtFitBounds(function (prev) {
+        return prev ? false : prev;
+      });
+    }
+  }, []);
+
+  /**
+   * 用户交互结束时（pan / zoom / pinch / wheel stop）调用：
+   * 以 lastTransformRef 当前值为快照写 localStorage（debounce 兜底高频 stop）。
+   * 程序化的 setTransform / fitBounds / 挂载初始化都不会调这里，避免污染缓存。
+   */
+  var persistCurrentViewport = useCallback(function () {
+    var snapshot = lastTransformRef.current;
+    schedulePersistViewport({
+      x: snapshot.x,
+      y: snapshot.y,
+      scale: snapshot.scale
+    });
+  }, [schedulePersistViewport]);
+
+  /** 让 restore 路径读到最新 frameResetKey，避免 closure 过期 */
+  var frameResetKeyRef = useRef(frameResetKey);
+  frameResetKeyRef.current = frameResetKey;
+  var viewportPersistKeyRef = useRef(viewportPersistKey);
+  viewportPersistKeyRef.current = viewportPersistKey;
+
+  /**
+   * 把缓存视角立即贴到画布上的统一入口（restore effect 与 attachTransformContext 共用）。
+   *
+   * 关键点：
+   * 1. setTransform 的 animationTime 必须传 0：
+   *    - react-zoom-pan-pinch 默认 200ms 缓动；
+   *    - 首屏若 namespace 异步、autoFit 抢先 setTransform(fit) 并仍在缓动中，
+   *      restore 这次 setTransform 会被库认为是「动画过程中无意义的同向 set」吃掉
+   *      或与原动画合成，最终视觉停在 fit 处；
+   *    - 传 0 等价于"立即落点"，强制覆盖任何在飞动画。
+   * 2. 命中后立刻把 cachedRestoredFrameRef / autoFit done / initialAlign done 都打上，
+   *    防止后续 effect 反向覆盖缓存值。
+   */
+  var applyPersistedViewport = useCallback(function (cached) {
+    var ctx = transformRef.current;
+    if (!ctx) return false;
+    ctx.setTransform(cached.x, cached.y, cached.scale, 0);
+    lastTransformRef.current = _objectSpread({}, cached);
+    lastFitSnapshotRef.current = null;
+    setIsAtFitBounds(false);
+    autoFitOnceRef.current.done = true;
+    initialAlignRef.current.done = true;
+    var currentFrame = frameResetKeyRef.current;
+    if (currentFrame !== undefined) {
+      cachedRestoredFrameRef.current = String(currentFrame);
+    }
+    return true;
+  }, [transformRef]);
+
+  /**
+   * 切换 viewportPersistKey 或 frameResetKey 时（含挂载、wrapper 重挂载）：
+   * 尝试从 localStorage 读取上次视角并恢复。命中缓存 → 阻止本帧 autoFitOnMount /
+   * 首次左上对齐覆盖。未命中保持原行为。
+   *
+   * ❗frameResetKey 必须在依赖里：
+   * `transformWrapperKey` 在远端配置（boundingPadding / defaultScale）回包后会变，
+   * 触发 TransformWrapper 卸载重挂载并以 `initialPositionX/Y/Scale` (≈16,16,1) 渲染。
+   * 仅依赖 viewportPersistKey 时此处不会重跑，画布会停在初始 transform，
+   * 用户上次保存的视角虽然在 localStorage 里却没"贴回"画布。
+   */
+  useEffect(function () {
+    if (!viewportPersistKey) return;
+    var cached = readPersistedViewport(viewportPersistKey);
+    if (!cached) return;
+    var cancelled = false;
+    var raf1 = 0;
+    var raf2 = 0;
+    var attempts = 0;
+    var MAX_ATTEMPTS = 60;
+    var tick = function tick() {
+      if (cancelled) return;
+      if (!applyPersistedViewport(cached)) {
+        if (attempts++ < MAX_ATTEMPTS) {
+          raf1 = requestAnimationFrame(tick);
+        }
+      }
+    };
+
+    /** 双 rAF：等 TransformWrapper 的 ctx 就绪后再写 */
+    raf1 = requestAnimationFrame(function () {
+      raf2 = requestAnimationFrame(tick);
+    });
+    return function () {
+      cancelled = true;
+      cancelAnimationFrame(raf1);
+      cancelAnimationFrame(raf2);
+    };
+  }, [viewportPersistKey, frameResetKey, applyPersistedViewport]);
+
+  /**
+   * PisellFloorMapLayout 在 TransformWrapper children render 中调用：
+   *   {(ctx) => { attachTransformContext(ctx); return <>...</> }}
+   *
+   * 用途：wrapper 首次挂载 / 重挂载时，立刻 schedule 一次 restore，
+   * 避免依赖 useEffect、namespace 异步、autoFit 抢先 setTransform 之间的复杂时序。
+   *
+   * ⚠️ 不要用「ctx 引用是否变化」做去重：
+   *   react-zoom-pan-pinch 在每次内部状态更新（缩放 / 平移过程中的 onTransformed）
+   *   都会让父组件重 render，children render 函数会再次被调用，部分版本下 ctx 是新对象引用。
+   *   一旦把它判成「新 ctx」再次 schedule restore，就会把用户刚做的缩放/平移
+   *   又覆盖回缓存，表现成「拖动可以，缩放回弹/缩放不动」。
+   *
+   * 改用 cachedRestoredFrameRef 做幂等：每个 frame（= TransformWrapper 的 key）
+   * 在生命周期内只 restore 一次。frame 真变化（wrapper 卸载重挂载）时，autoFit
+   * useLayoutEffect 的 reset 分支会清掉 / 重置该 ref，attach 自然能再次触发。
+   */
+  var attachTransformContext = useCallback(function (ctx) {
+    transformRef.current = ctx;
+    var key = viewportPersistKeyRef.current;
+    var currentFrame = frameResetKeyRef.current;
+    if (!key || currentFrame === undefined) return;
+    var frameStr = String(currentFrame);
+    /** 该 frame 已经 restore 过（attach 触发或 autoFit reset 分支命中均会标记） */
+    if (cachedRestoredFrameRef.current === frameStr) return;
+    var cached = readPersistedViewport(key);
+    if (!cached) return;
+    /**
+     * 立刻占座：避免本帧后续如果触发 attach 重入 / restore useEffect 同步跑
+     * 出现两条 setTransform 路径并发。applyPersistedViewport 内部还会再设一次
+     * （等于幂等）。
+     */
+    cachedRestoredFrameRef.current = frameStr;
+    /**
+     * 双 rAF 等 wrapper 内部 useEffect / 初始 onTransformed 走完，
+     * 否则可能被库的 init 回调把 transform 又重置回 initial。
+     */
+    requestAnimationFrame(function () {
+      requestAnimationFrame(function () {
+        /** 等待期间 frame 又变了（快速切画布）则交给新 frame 的 attach 处理 */
+        if (frameResetKeyRef.current !== currentFrame) return;
+        applyPersistedViewport(cached);
+      });
+    });
+  }, [transformRef, applyPersistedViewport]);
+
+  /** 卸载 / key 变化时把待写的视口立刻 flush，避免快速来回切丢失最后一次操作 */
+  useEffect(function () {
+    return function () {
+      var _flushPersistRef$curr;
+      if (persistTimerRef.current != null) {
+        clearTimeout(persistTimerRef.current);
+        persistTimerRef.current = null;
+      }
+      (_flushPersistRef$curr = flushPersistRef.current) === null || _flushPersistRef$curr === void 0 || _flushPersistRef$curr.call(flushPersistRef);
+      flushPersistRef.current = null;
+    };
+  }, [viewportPersistKey]);
   return {
     containerRef: containerRef,
     mapAreaRef: mapAreaRef,
@@ -393,8 +702,15 @@ export function useFloorMapTransformMetrics(params) {
     isFullscreen: isFullscreen,
     toggleFullscreen: toggleFullscreen,
     fitBounds: fitBounds,
+    isAtFitBounds: isAtFitBounds,
+    notifyTransformed: notifyTransformed,
+    persistCurrentViewport: persistCurrentViewport,
+    attachTransformContext: attachTransformContext,
     lastTransformRef: lastTransformRef,
     isInteractingWithElement: isInteractingWithElement,
-    setIsInteractingWithElement: setIsInteractingWithElement
+    setIsInteractingWithElement: setIsInteractingWithElement,
+    viewportLocked: viewportLocked,
+    setViewportLocked: setViewportLocked,
+    toggleViewportLocked: toggleViewportLocked
   };
 }

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

@@ -7,6 +7,7 @@ export type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapItemBa
 export { FLOOR_MAP_STAGE_ELEMENT_KIND, FLOOR_MAP_IMAGE_ELEMENT_KIND, } from './types';
 export { renderFloorMapFallbackPlaceholder } from './utils/floorMapFallbackRender';
 export { isFloorMapImageElementKind } from './utils/floorMapElementKindUtils';
+export { NAME_AS_TITLE_EXT_KEY, isElementNameAsTitleEnabled, buildNameAsTitleExtensionsPatch, resolveSceneElementDisplayTitle, } from './utils/floorMapElementNameAsTitle';
 export { findFloorMapRowByDataBinding, getFloorMapBindingPlaceholderReason, } from './utils/floorMapDataBindingUtils';
 export type { FloorMapDataSourceRow, FloorMapBindingPlaceholderReason, } from './utils/floorMapDataBindingUtils';
 export { createShopFloorPlanClient, SHOP_FLOOR_PLAN_DUPLICATE_CODE, } from './shopFloorPlan/shopFloorPlanClient';

package/es/components/pisellFloorMapLayout/index.js

@@ -6,6 +6,7 @@ export { PisellFloorMapLayout } from "./PisellFloorMapLayout";
 export { FLOOR_MAP_STAGE_ELEMENT_KIND, FLOOR_MAP_IMAGE_ELEMENT_KIND } from "./types";
 export { renderFloorMapFallbackPlaceholder } from "./utils/floorMapFallbackRender";
 export { isFloorMapImageElementKind } from "./utils/floorMapElementKindUtils";
+export { NAME_AS_TITLE_EXT_KEY, isElementNameAsTitleEnabled, buildNameAsTitleExtensionsPatch, resolveSceneElementDisplayTitle } from "./utils/floorMapElementNameAsTitle";
 export { findFloorMapRowByDataBinding, getFloorMapBindingPlaceholderReason } from "./utils/floorMapDataBindingUtils";
 export { createShopFloorPlanClient, SHOP_FLOOR_PLAN_DUPLICATE_CODE } from "./shopFloorPlan/shopFloorPlanClient";
 export { pickFloorPlanDetail, parseLayoutFieldToViewConfigPatch, mergeFloorPlanViewRemote, floorMapSavedConfigToRemotePatch, viewConfigToLayoutPayload, inferCanvasSizeFromScene, buildFloorPlanPutBody, isShopFloorPlanNotFoundResponse, isHttpNotFoundError, isFloorPlanDuplicateCodeError } from "./shopFloorPlan/shopFloorPlanPure";

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

@@ -12,6 +12,14 @@ declare const _default: {
     '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.edit-top-bar.undo': string;
+    'pisell-floor-map-layout.edit-top-bar.redo': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-edit': string;
+    'pisell-floor-map-layout.edit-top-bar.finish-edit': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-title': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-content': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel': 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;
@@ -41,6 +49,8 @@ declare const _default: {
     '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-name-as-title': string;
+    'pisell-floor-map-layout.edit-panel.tip-name-as-title': 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;
@@ -81,6 +91,8 @@ declare const _default: {
     '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.toolbar.collapse': string;
+    'pisell-floor-map-layout.toolbar.expand': 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;
@@ -91,6 +103,8 @@ declare const _default: {
     'pisell-floor-map-layout.view-controls.fullscreen-exit-aria': string;
     'pisell-floor-map-layout.view-controls.expand-tools-aria': string;
     'pisell-floor-map-layout.view-controls.collapse-tools-aria': string;
+    'pisell-floor-map-layout.view-controls.viewport-lock-aria': string;
+    'pisell-floor-map-layout.view-controls.viewport-unlock-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;
@@ -109,5 +123,11 @@ declare const _default: {
     '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;
+    'pisell-floor-map-layout.figma-card.status-available': string;
+    'pisell-floor-map-layout.figma-card.status-reserved': string;
+    'pisell-floor-map-layout.figma-card.status-waiting': string;
+    'pisell-floor-map-layout.figma-card.status-dining': string;
+    'pisell-floor-map-layout.figma-card.status-billed': string;
+    'pisell-floor-map-layout.figma-card.status-availableSoon': string;
 };
 export default _default;

package/es/components/pisellFloorMapLayout/locales-ja.js

@@ -12,6 +12,14 @@ export default {
   '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.edit-top-bar.undo': '元に戻す',
+  'pisell-floor-map-layout.edit-top-bar.redo': 'やり直す',
+  'pisell-floor-map-layout.edit-top-bar.cancel-edit': 'キャンセル',
+  'pisell-floor-map-layout.edit-top-bar.finish-edit': '完了',
+  'pisell-floor-map-layout.edit-top-bar.cancel-confirm-title': '未保存の変更',
+  'pisell-floor-map-layout.edit-top-bar.cancel-confirm-content': 'このページを離れると、保存していない変更は失われます。',
+  'pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok': '確定',
+  'pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel': 'キャンセル',
   'pisell-floor-map-layout.canvas-tabs.empty': 'キャンバスがありません',
   'pisell-floor-map-layout.canvas-tabs.add': '+ フロアを追加',
   'pisell-floor-map-layout.canvas-tabs.add-title': 'フロアを追加',
@@ -41,6 +49,8 @@ export default {
   '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-name-as-title': 'この名前をリソース名として使用',
+  'pisell-floor-map-layout.edit-panel.tip-name-as-title': '有効にするとキャンバス上のカードのタイトルがこの名前になり、紐付けたレコードのタイトルを上書きします。',
   'pisell-floor-map-layout.edit-panel.label-image-url': '画像 URL',
   'pisell-floor-map-layout.edit-panel.extra-image-url': 'ネットワーク上の画像 URL を指定。重なり順を下げるとテーブルの下に配置できます。',
   'pisell-floor-map-layout.edit-panel.ph-https': 'https://...',
@@ -81,6 +91,8 @@ export default {
   'pisell-floor-map-layout.toolbar.layout-dirty-hint': 'レイアウトが変更されました。「保存」で確定してください。',
   'pisell-floor-map-layout.toolbar.save': '保存',
   'pisell-floor-map-layout.toolbar.saving': '保存中…',
+  'pisell-floor-map-layout.toolbar.collapse': 'パネルを折りたたむ',
+  'pisell-floor-map-layout.toolbar.expand': 'パネルを展開',
   'pisell-floor-map-layout.view-controls.zoom-out-aria': '縮小',
   'pisell-floor-map-layout.view-controls.zoom-in-aria': '拡大',
   'pisell-floor-map-layout.view-controls.reset-aria': '表示をリセット',
@@ -91,6 +103,8 @@ export default {
   'pisell-floor-map-layout.view-controls.fullscreen-exit-aria': '全画面を終了',
   'pisell-floor-map-layout.view-controls.expand-tools-aria': 'その他の表示ツールを表示',
   'pisell-floor-map-layout.view-controls.collapse-tools-aria': 'その他の表示ツールを隠す',
+  'pisell-floor-map-layout.view-controls.viewport-lock-aria': 'ビューを固定（パン・ズームを無効化）',
+  'pisell-floor-map-layout.view-controls.viewport-unlock-aria': 'ビュー固定を解除',
   'pisell-floor-map-layout.image-element.default-name': '画像要素',
   'pisell-floor-map-layout.placement.fallback-image-name': '背景',
   'pisell-floor-map-layout.image-element.hint-no-url': 'サイドバーで画像 URL を入力。重なり順を下げるとテーブル下の背景にできます。',
@@ -108,5 +122,11 @@ export default {
   'pisell-floor-map-layout.figma-card.kind-square-table': 'テーブル',
   'pisell-floor-map-layout.figma-card.default-table': 'テーブル',
   'pisell-floor-map-layout.figma-card.capacity-seats': '着席 {n} 名',
-  'pisell-floor-map-layout.figma-card.guests-count': '{n} 名'
+  'pisell-floor-map-layout.figma-card.guests-count': '{n} 名',
+  'pisell-floor-map-layout.figma-card.status-available': '空席',
+  'pisell-floor-map-layout.figma-card.status-reserved': '予約済',
+  'pisell-floor-map-layout.figma-card.status-waiting': '待機中',
+  'pisell-floor-map-layout.figma-card.status-dining': '食事中',
+  'pisell-floor-map-layout.figma-card.status-billed': '会計済',
+  'pisell-floor-map-layout.figma-card.status-availableSoon': '間もなく'
 };

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

@@ -12,6 +12,14 @@ declare const _default: {
     '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.edit-top-bar.undo': string;
+    'pisell-floor-map-layout.edit-top-bar.redo': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-edit': string;
+    'pisell-floor-map-layout.edit-top-bar.finish-edit': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-title': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-content': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok': string;
+    'pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel': 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;
@@ -41,6 +49,8 @@ declare const _default: {
     '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-name-as-title': string;
+    'pisell-floor-map-layout.edit-panel.tip-name-as-title': 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;
@@ -81,6 +91,8 @@ declare const _default: {
     '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.toolbar.collapse': string;
+    'pisell-floor-map-layout.toolbar.expand': 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;
@@ -91,6 +103,8 @@ declare const _default: {
     'pisell-floor-map-layout.view-controls.fullscreen-exit-aria': string;
     'pisell-floor-map-layout.view-controls.expand-tools-aria': string;
     'pisell-floor-map-layout.view-controls.collapse-tools-aria': string;
+    'pisell-floor-map-layout.view-controls.viewport-lock-aria': string;
+    'pisell-floor-map-layout.view-controls.viewport-unlock-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;
@@ -109,5 +123,11 @@ declare const _default: {
     '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;
+    'pisell-floor-map-layout.figma-card.status-available': string;
+    'pisell-floor-map-layout.figma-card.status-reserved': string;
+    'pisell-floor-map-layout.figma-card.status-waiting': string;
+    'pisell-floor-map-layout.figma-card.status-dining': string;
+    'pisell-floor-map-layout.figma-card.status-billed': string;
+    'pisell-floor-map-layout.figma-card.status-availableSoon': string;
 };
 export default _default;