@pisell/materials 1.8.54 → 1.8.55

package/es/components/buttonGroupPreview/index.js

@@ -1,9 +1,11 @@
 import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js";
+import { _objectWithoutProperties } from "../../_virtual/_@oxc-project_runtime@0.122.0/helpers/objectWithoutProperties.js";
 import Button$1 from "../button/index.js";
 import React, { forwardRef, memo, useMemo } from "react";
 import { Dropdown, Flex, Space } from "antd";
 import { MoreOutlined } from "@ant-design/icons";
 //#region src/components/buttonGroupPreview/index.tsx
+const _excluded = ["children"];
 /**
 *
 * @param param0 { buttonConfig, buttonGroupList }
@@ -12,7 +14,7 @@ import { MoreOutlined } from "@ant-design/icons";
 const updateSourceData = ({ buttonConfig, buttonGroupList }) => {
 	if (Object.keys(buttonConfig).length !== 0) return buttonGroupList.map((subArray) => {
 		return subArray.map((item) => {
-			if (buttonConfig.hasOwnProperty(item.id)) return buttonConfig[item.id];
+			if (item.id && Object.prototype.hasOwnProperty.call(buttonConfig, item.id)) return buttonConfig[item.id];
 			return item;
 		});
 	});
@@ -27,13 +29,15 @@ var buttonGroupPreview_default = memo(forwardRef((props, ref) => {
 		});
 	}, [buttonGroupList, buttonConfig]);
 	return /* @__PURE__ */ React.createElement(Flex, {
-		wrap: true,
+		wrap: "wrap",
 		vertical: true,
 		style: { marginBottom: 10 }
-	}, sourceDatas.map((item, index) => /* @__PURE__ */ React.createElement(Space, { key: index }, item.map((items, index) => {
+	}, sourceDatas.map((item, index) => React.createElement(Space, { key: index }, item.map((items, index) => {
 		const { isMore = false, id = "", menuData = [], buttonProps } = items;
 		const btnProps = _objectSpread2(_objectSpread2({}, buttonProps), props.updateButtonProps);
-		return isMore ? /* @__PURE__ */ React.createElement(Dropdown, { menu: { items: menuData } }, /* @__PURE__ */ React.createElement(Button$1, null, /* @__PURE__ */ React.createElement(MoreOutlined, null))) : /* @__PURE__ */ React.createElement(Button$1, _objectSpread2({ key: id }, btnProps));
+		const { children } = btnProps, dropdownButtonProps = _objectWithoutProperties(btnProps, _excluded);
+		const moreButtonChildren = children !== null && children !== void 0 ? children : dropdownButtonProps.icon ? null : /* @__PURE__ */ React.createElement(MoreOutlined, null);
+		return isMore ? /* @__PURE__ */ React.createElement(Dropdown, { menu: { items: menuData } }, /* @__PURE__ */ React.createElement(Button$1, _objectSpread2({ key: id }, dropdownButtonProps), moreButtonChildren)) : /* @__PURE__ */ React.createElement(Button$1, _objectSpread2({ key: id }, btnProps));
 	}))));
 }));
 //#endregion

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -2,7 +2,7 @@ import { _objectSpread2 } from "../../_virtual/_@oxc-project_runtime@0.122.0/hel
 import MapLayer from "./components/MapLayer.js";
 import ItemLayer from "./components/ItemLayer.js";
 import EditableItemLayer from "./components/EditableItemLayer.js";
-import { getElementKindConfig, getSceneElementRenderIssue } from "./utils/floorMapElementKindUtils.js";
+import { FLOOR_MAP_RESOURCE_PLACE_DEFAULT, getElementKindConfig, getSceneElementRenderIssue } from "./utils/floorMapElementKindUtils.js";
 import { isFloorMapPaletteDrag, parsePaletteDragPayload, sceneXYFromContentDropOffset } from "./utils/floorMapDropUtils.js";
 import { FLOOR_MAP_LAYOUT_CLASS_PREFIX, FLOOR_MAP_OVERVIEW_TAB_ID } from "./floorMapLayoutConstants.js";
 import FloorMapToolbar from "./components/FloorMapToolbar.js";
@@ -13,8 +13,13 @@ import FloorMapEditTopBar from "./components/FloorMapEditTopBar.js";
 import { mergeCanvasesForTabs } from "./utils/mergeCanvasesForTabs.js";
 import FloorMapOverview from "./components/FloorMapOverview.js";
 import FloorMapEditPanel from "./components/FloorMapEditPanel.js";
-import { ViewControlsWithZoom } from "./components/ViewControlsWithZoom.js";
 import { gapToPx } from "./utils/layoutMeasurements.js";
+import { FloorMapEdgeEditPanel } from "./components/FloorMapEdgeEditPanel.js";
+import { EdgeLayer } from "./components/EdgeLayer.js";
+import { NodePortMarkers } from "./components/NodePortMarkers.js";
+import { useFloorMapEdgeViewModel } from "./hooks/useFloorMapEdgeViewModel.js";
+import { useFloorMapEdgeEditing } from "./hooks/useFloorMapEdgeEditing.js";
+import { ViewControlsWithZoom } from "./components/ViewControlsWithZoom.js";
 import { useFloorMapEditState } from "./hooks/useFloorMapEditState.js";
 import { useFloorMapTransformMetrics } from "./hooks/useFloorMapTransformMetrics.js";
 import { renderFloorMapFallbackPlaceholder, renderFloorMapRenderError } from "./utils/floorMapFallbackRender.js";
@@ -39,8 +44,8 @@ import "./PisellFloorMapLayout.less";
 * 负责：上下文与 props 合并、编辑态/阅读态分支、Transform 视口、图元层与工具栏联动。
 */
 function PisellFloorMapLayoutInner(props, ref) {
-	var _ref, _currentCanvas$mapLay2, _currentCanvas$mapLay3, _mapLayer$backgroundC, _engineCtx$engine, _mapLayer$boundingPad, _config$sceneElements;
-	const { className, style, items: itemsProp, renderItem, rowKey, renderItemByKind, getMergedItemWrapperStyle, mapLayer, cellSize: cellSizeProp, itemUnit = "cell", zoom = {}, pan = {}, controls = {}, enableHover = true, readModeSelectedItemId, onItemClick, onItemHover, onItemLeave, mode = "read", floorMapConfig: floorMapConfigProp, dataSources, onSave, onExitEdit, onDataSourceRecordSave, dataSourceLabels, dataSourceFormColumns, dataSourceRecordForm, loading, saveError, onElementRenderError, toolbarShowSave = true, floorMapFullscreenMode, appearanceMode = "light", showDataSourceRecordFormBlock, floorMapViewportOverlay, viewportOverlayPlacement = "top-start", viewportOverlayClassName, editTopBarPhoneLayout = false, canvasTabsBarTrailing, viewportDockToolButtons, viewportDockTrailing, viewportPersist = true, viewportPersistNamespace } = mergeFloorMapLayoutPropsFromContext(props, useFloorMapLayoutContext());
+	var _ref, _currentCanvas$mapLay2, _currentCanvas$mapLay3, _mapLayer$backgroundC, _engineCtx$engine, _mapLayer$boundingPad, _config$edges, _config$edges2, _config$sceneElements;
+	const { className, style, items: itemsProp, renderItem, rowKey, renderItemByKind, getMergedItemWrapperStyle, enableEdges = false, mapLayer, cellSize: cellSizeProp, itemUnit = "cell", zoom = {}, pan = {}, controls = {}, enableHover = true, readModeSelectedItemId, onItemClick, onItemHover, onItemLeave, mode = "read", floorMapConfig: floorMapConfigProp, dataSources, onSave, onExitEdit, onDataSourceRecordSave, dataSourceLabels, dataSourceFormColumns, dataSourceRecordForm, loading, saveError, onElementRenderError, toolbarShowSave = true, renderResourcePickerModal, paletteSidebarVisibleLimit, floorMapFullscreenMode, appearanceMode = "light", showDataSourceRecordFormBlock, floorMapViewportOverlay, viewportOverlayPlacement = "top-start", viewportOverlayClassName, editTopBarPhoneLayout = false, canvasTabsBarTrailing, viewportDockToolButtons, viewportDockTrailing, viewportPersist = true, viewportPersistNamespace } = mergeFloorMapLayoutPropsFromContext(props, useFloorMapLayoutContext());
 	const { token } = theme.useToken();
 	const isFloorMapView = Boolean(floorMapConfigProp);
 	const contentOffsetRef = useRef({
@@ -49,7 +54,8 @@ function PisellFloorMapLayoutInner(props, ref) {
 	});
 	const mapDropLayerRef = useRef(null);
 	const transformRef = useRef(null);
-	const { config, currentCanvasId, setCurrentCanvasId, selectedId, setSelectedId, placeMode, setPlaceMode, items, saving, savingRecord, handleAddCanvas, handleRemoveCanvas, handleRenameCanvas, handleUpdateItem, handleCanvasPlaceClick, handleSave, placeSceneElementFromPaletteDrop, editPanelParams, placeOverlayClass, isLayoutDirty, toggleDraftCanvasShowGrid, toggleSelectedLayoutLock, duplicateSelectedElement, deleteSelectedElement, undoDraft, redoDraft, canUndo, canRedo, discardDraft } = useFloorMapEditState({
+	const focusViewportOnBoundsRef = useRef(null);
+	const { config, currentCanvasId, setCurrentCanvasId, selectedId, setSelectedId, placeMode, setPlaceMode, items, saving, savingRecord, handleAddCanvas, handleRemoveCanvas, handleRenameCanvas, handleUpdateItem, handleCanvasPlaceClick, handleSave, placeSceneElementFromPaletteDrop, bulkPlacePaletteItems, editPanelParams, placeOverlayClass, isLayoutDirty, toggleDraftCanvasShowGrid, toggleSelectedLayoutLock, duplicateSelectedElement, deleteSelectedElement, undoDraft, redoDraft, canUndo, canRedo, discardDraft, commitDraft } = useFloorMapEditState({
 		floorMapConfigProp,
 		isFloorMapView,
 		itemsProp,
@@ -62,8 +68,10 @@ function PisellFloorMapLayoutInner(props, ref) {
 		dataSourceLabels,
 		layoutPrefix: FLOOR_MAP_LAYOUT_CLASS_PREFIX,
 		contentOffsetRef,
-		showDataSourceRecordFormBlock
+		showDataSourceRecordFormBlock,
+		focusViewportOnBoundsRef
 	});
+	const mapContentRef = useRef(null);
 	/**
 	* 当前选中的画布配置：用于提取当前画布级 mapLayer 显式配置。
 	*/
@@ -146,25 +154,26 @@ function PisellFloorMapLayoutInner(props, ref) {
 	const engineLocale = (engineCtx === null || engineCtx === void 0 || (_engineCtx$engine = engineCtx.engine) === null || _engineCtx$engine === void 0 || (_engineCtx$engine = _engineCtx$engine.props) === null || _engineCtx$engine === void 0 ? void 0 : _engineCtx$engine.locale) || "zh-CN";
 	const hasCanvasTabsBarTrailing = canvasTabsBarTrailing != null && canvasTabsBarTrailing !== false;
 	const enabledCanvasCount = useMemo(() => canvasesForTabsBase.filter((c) => c.enabled).length, [canvasesForTabsBase]);
-	/** 仅阅读态、启用画布 > 1 时，在 Tab 列表最前插入「All」伪 tab */
+	/** 仅阅读态、启用画布 > 1 时，在 Tab 列表末尾插入「Overview」伪 tab */
 	const showOverviewTab = isFloorMapView && mode === "read" && enabledCanvasCount > 1;
 	const overviewTabLabel = useMemo(() => {
 		initFloorMapLayoutLocales(engineLocale);
 		return locales.getText("pisell-floor-map-layout.canvas-tabs.overview");
 	}, [engineLocale]);
 	/**
-	* 给 CanvasTabs 渲染用的最终列表：阅读态多画布时在列表最前插入「All」伪 tab。
-	* order 取当前最小 order - 1，保证排序后位于第一个；其它字段留空。
+	* 给 CanvasTabs 渲染用的最终列表：阅读态多画布时在列表末尾插入「Overview」伪 tab。
+	* order 取当前最大 order + 1，保证排序后位于最后一个。
 	*/
 	const canvasesForTabs = useMemo(() => {
 		if (!showOverviewTab) return canvasesForTabsBase;
-		const minOrder = canvasesForTabsBase.reduce((min, c) => c.order < min ? c.order : min, Number.POSITIVE_INFINITY);
-		return [{
+		const maxOrder = canvasesForTabsBase.reduce((max, c) => c.order > max ? c.order : max, Number.NEGATIVE_INFINITY);
+		const overviewTab = {
 			id: FLOOR_MAP_OVERVIEW_TAB_ID,
 			name: overviewTabLabel,
-			order: Number.isFinite(minOrder) ? minOrder - 1 : -1,
+			order: Number.isFinite(maxOrder) ? maxOrder + 1 : 0,
 			enabled: true
-		}, ...canvasesForTabsBase];
+		};
+		return [...canvasesForTabsBase, overviewTab];
 	}, [
 		canvasesForTabsBase,
 		showOverviewTab,
@@ -257,7 +266,7 @@ function PisellFloorMapLayoutInner(props, ref) {
 			globalMapLayer: mapLayer,
 			cellSize,
 			itemUnit: effectiveItemUnit,
-			areaGap: 32
+			areaGap: 40
 		});
 	}, [
 		isFloorMapView,
@@ -305,7 +314,7 @@ function PisellFloorMapLayoutInner(props, ref) {
 			shape: "rect"
 		}];
 	}, [overviewLayout]);
-	const { containerRef, mapAreaRef, mapAreaSize, contentWidth, contentHeight, contentOffsetX, contentOffsetY, initialPositionX, initialPositionY, zoomConfig, scale, setScale, isFullscreen, toggleFullscreen, fitBounds, isAtFitBounds, notifyTransformed, persistCurrentViewport, attachTransformContext, isInteractingWithElement, setIsInteractingWithElement, viewportLocked, toggleViewportLocked } = useFloorMapTransformMetrics({
+	const { containerRef, mapAreaRef, mapAreaSize, contentWidth, contentHeight, contentOffsetX, contentOffsetY, initialPositionX, initialPositionY, zoomConfig, scale, setScale, isFullscreen, toggleFullscreen, fitBounds, focusContentBounds, isAtFitBounds, notifyTransformed, persistCurrentViewport, attachTransformContext, isInteractingWithElement, setIsInteractingWithElement, viewportLocked, toggleViewportLocked } = useFloorMapTransformMetrics({
 		items: isOverview && overviewLayout ? overviewMetricsItems : items,
 		cellSize,
 		itemGap: isOverview ? 0 : itemGap,
@@ -319,20 +328,81 @@ function PisellFloorMapLayoutInner(props, ref) {
 		frameResetKey: isFloorMapView ? transformWrapperKey : void 0,
 		viewportPersistKey
 	});
-	/** 手机：选中图元种类后一键落在当前视口中心（与点击画布落点坐标换算一致） */
-	const handlePlaceActiveAtViewportCenter = useCallback(() => {
-		if (!placeMode || placeMode.type !== "scene") return;
+	useEffect(() => {
+		focusViewportOnBoundsRef.current = (bounds) => {
+			requestAnimationFrame(() => {
+				requestAnimationFrame(() => {
+					focusContentBounds(bounds);
+				});
+			});
+		};
+		return () => {
+			focusViewportOnBoundsRef.current = null;
+		};
+	}, [focusContentBounds]);
+	/**
+	* 是否启用连线（edge）渲染与编辑能力。
+	* - 必须显式 `enableEdges={true}` 才打开；
+	* - pisell-reservation 等通用业务画布默认关闭，避免选中图元出现锚点圆点或拖出连线。
+	*/
+	const showEdgeLayer = enableEdges && isFloorMapView && !isOverview && config != null;
+	/** 连线层显隐（仅影响 EdgeLayer 绘制；编辑锚点仍随 `showEdgeLayer`） */
+	const [edgesLayerVisible, setEdgesLayerVisible] = useState(true);
+	const showEdgesOnCanvas = showEdgeLayer && edgesLayerVisible;
+	const toggleEdgesLayerVisible = useCallback(() => {
+		setEdgesLayerVisible((v) => !v);
+	}, []);
+	const readEdgeVm = useFloorMapEdgeViewModel({
+		edges: showEdgeLayer && mode === "read" ? (_config$edges = config === null || config === void 0 ? void 0 : config.edges) !== null && _config$edges !== void 0 ? _config$edges : [] : [],
+		items: showEdgeLayer ? items : [],
+		cellSize,
+		itemUnit: effectiveItemUnit,
+		itemGap
+	});
+	const edgeEdit = useFloorMapEdgeEditing({
+		enabled: showEdgeLayer && mode === "edit",
+		config,
+		items,
+		mergedItems: items,
+		cellSize,
+		itemUnit: effectiveItemUnit,
+		itemGap,
+		contentOffsetRef,
+		selectedId,
+		setSelectedId,
+		commitDraft,
+		mapContentRef,
+		scale
+	});
+	const edgeRoutes = mode === "edit" && showEdgeLayer ? edgeEdit.routes : readEdgeVm.routes;
+	const edgeRectsById = mode === "edit" && showEdgeLayer ? edgeEdit.rectsById : readEdgeVm.rectsById;
+	const displayEdges = mode === "edit" && showEdgeLayer ? edgeEdit.edges : (_config$edges2 = config === null || config === void 0 ? void 0 : config.edges) !== null && _config$edges2 !== void 0 ? _config$edges2 : [];
+	const getViewportCenterContentCoords = useCallback(() => {
 		const w = mapAreaSize.width;
 		const h = mapAreaSize.height;
-		if (w <= 0 || h <= 0) return;
+		if (w <= 0 || h <= 0) return null;
 		const { x: ox, y: oy } = contentOffsetRef.current;
-		placeSceneElementFromPaletteDrop(Math.round(w / 2 - ox), Math.round(h / 2 - oy), placeMode);
+		return {
+			x: Math.round(w / 2 - ox),
+			y: Math.round(h / 2 - oy)
+		};
+	}, [mapAreaSize.width, mapAreaSize.height]);
+	/** 手机：选中图元种类后一键落在当前视口中心（与点击画布落点坐标换算一致） */
+	const handlePlaceActiveAtViewportCenter = useCallback(() => {
+		if (!placeMode || placeMode.type !== "scene") return;
+		const center = getViewportCenterContentCoords();
+		if (!center) return;
+		placeSceneElementFromPaletteDrop(center.x, center.y, placeMode);
 	}, [
 		placeMode,
-		mapAreaSize.width,
-		mapAreaSize.height,
+		getViewportCenterContentCoords,
 		placeSceneElementFromPaletteDrop
 	]);
+	/** 侧栏「查看更多」：按数量批量落在画布右侧空白区（方阵网格 + gap） */
+	const handleBulkAddPaletteToCanvas = useCallback((items) => {
+		if (!items.length) return;
+		bulkPlacePaletteItems(items);
+	}, [bulkPlacePaletteItems]);
 	/** 编辑态全屏策略：toggle 全屏与编辑态强绑定；locked 始终全屏顶栏；disabled 无全屏 */
 	const fsMode = floorMapFullscreenMode !== null && floorMapFullscreenMode !== void 0 ? floorMapFullscreenMode : "toggle";
 	const useFullTopChrome = isFloorMapView && mode === "edit" && (fsMode === "locked" || fsMode === "toggle" && isFullscreen);
@@ -369,16 +439,18 @@ function PisellFloorMapLayoutInner(props, ref) {
 	* 并默认带出「视口锁定」按钮（与是否将视口保存到本地解耦；无持久化 key 时仅内存态，默认未锁定）。
 	*/
 	const viewControlsConfig = useMemo(() => {
-		var _controls$showFullscr, _controls$showViewpor;
+		var _controls$showFullscr, _controls$showViewpor, _controls$showEdgesTo;
 		if (!isFloorMapView) return controls;
 		return _objectSpread2(_objectSpread2({}, controls), {}, {
 			showFullscreen: (_controls$showFullscr = controls.showFullscreen) !== null && _controls$showFullscr !== void 0 ? _controls$showFullscr : Boolean(dockToggleFullscreen),
-			showViewportLock: (_controls$showViewpor = controls.showViewportLock) !== null && _controls$showViewpor !== void 0 ? _controls$showViewpor : true
+			showViewportLock: (_controls$showViewpor = controls.showViewportLock) !== null && _controls$showViewpor !== void 0 ? _controls$showViewpor : true,
+			showEdgesToggle: showEdgeLayer ? (_controls$showEdgesTo = controls.showEdgesToggle) !== null && _controls$showEdgesTo !== void 0 ? _controls$showEdgesTo : true : controls.showEdgesToggle
 		});
 	}, [
 		isFloorMapView,
 		controls,
-		dockToggleFullscreen
+		dockToggleFullscreen,
+		showEdgeLayer
 	]);
 	const topBarExtraActions = null;
 	/** 从侧栏/调色板拖入画布时，地图区高亮态（用于 dragleave/over 判定） */
@@ -544,8 +616,17 @@ function PisellFloorMapLayoutInner(props, ref) {
 			return (_transformRef$current3 = transformRef.current) === null || _transformRef$current3 === void 0 ? void 0 : _transformRef$current3.resetTransform();
 		},
 		fitBounds,
-		saveLayout: () => handleSave()
-	}), [fitBounds, handleSave]);
+		saveLayout: () => handleSave(),
+		applySceneSnapshot: (next) => {
+			if (mode !== "edit") return;
+			commitDraft(() => next);
+		}
+	}), [
+		fitBounds,
+		handleSave,
+		mode,
+		commitDraft
+	]);
 	const showSidebar = isFloorMapView && mode === "edit" && config && dataSources;
 	/** 右侧属性面板打开时给画布区留空，避免落点被挡在面板下 */
 	const editPanelVisible = isFloorMapView && mode === "edit" && Boolean(editPanelParams) && Boolean(config) && Boolean(dataSources);
@@ -684,8 +765,8 @@ function PisellFloorMapLayoutInner(props, ref) {
 		sceneElements: (_config$sceneElements = config.sceneElements) !== null && _config$sceneElements !== void 0 ? _config$sceneElements : [],
 		renderPreviewItem: (item) => effectiveRenderItem(item, 0),
 		placementPreviewSize: {
-			width: 180,
-			height: 120
+			width: FLOOR_MAP_RESOURCE_PLACE_DEFAULT.width,
+			height: FLOOR_MAP_RESOURCE_PLACE_DEFAULT.height
 		},
 		decorationPreviewSize: 48,
 		onSave: onSave && config.canvasUi.canEdit && !useFullTopChrome && toolbarShowSave !== false ? handleSave : void 0,
@@ -696,7 +777,16 @@ function PisellFloorMapLayoutInner(props, ref) {
 		consumeToolbarClickIfTouchDrag: paletteTouchDrag.consumeToolbarClickIfTouchDrag,
 		phoneLayout: editTopBarPhoneLayout,
 		defaultCollapsed: editTopBarPhoneLayout,
-		onRequestPlaceAtCanvasCenter: editTopBarPhoneLayout ? handlePlaceActiveAtViewportCenter : void 0
+		paletteSidebarVisibleLimit,
+		onRequestPlaceAtCanvasCenter: editTopBarPhoneLayout ? handlePlaceActiveAtViewportCenter : void 0,
+		onBulkAddPaletteToCanvas: handleBulkAddPaletteToCanvas,
+		onDirectPlacePaletteItem: (item) => bulkPlacePaletteItems([item]),
+		onResourcePickerConfirmPlace: (scene) => {
+			const center = getViewportCenterContentCoords();
+			if (!center) return false;
+			return placeSceneElementFromPaletteDrop(center.x, center.y, scene);
+		},
+		renderResourcePickerModal
 	}), /* @__PURE__ */ React.createElement("div", {
 		ref: mapAreaRef,
 		className: classNames(showSidebar && `pisell-floor-map-layout-map-area`, editTopBarPhoneLayout && showSidebar && `pisell-floor-map-layout-map-area--phone-fill`, editPanelVisible && !editTopBarPhoneLayout && `pisell-floor-map-layout-map-area--edit-panel-inset`),
@@ -766,7 +856,7 @@ function PisellFloorMapLayoutInner(props, ref) {
 		onPinchingStop: persistCurrentViewport,
 		onWheelStop: persistCurrentViewport
 	}), (ctx) => {
-		var _effectiveMapLayer$sn;
+		var _effectiveMapLayer$sn, _edgeEdit$drawing;
 		/**
 		* 不直接 transformRef.current = ctx：
 		* attachTransformContext 内部会比对 ctx 实例并在每次 wrapper 重挂载时
@@ -817,14 +907,37 @@ function PisellFloorMapLayoutInner(props, ref) {
 				getMergedItemWrapperStyle,
 				readModeSelectedItemId
 			})
-		) : /* @__PURE__ */ React.createElement(React.Fragment, null, /* @__PURE__ */ React.createElement(MapLayer, {
+		) : /* @__PURE__ */ React.createElement("div", {
+			ref: mapContentRef,
+			className: `${FLOOR_MAP_LAYOUT_CLASS_PREFIX}-map-content`,
+			style: {
+				position: "relative",
+				width: contentWidth,
+				height: contentHeight
+			}
+		}, /* @__PURE__ */ React.createElement(MapLayer, {
 			config: effectiveMapLayer,
 			contentWidth,
 			contentHeight,
 			cellSize,
 			preferCanvasGrid: true,
 			pointerEventsNone: isFloorMapView && mode === "edit"
-		}), isFloorMapView && mode === "edit" ? /* @__PURE__ */ React.createElement(EditableItemLayer, {
+		}), showEdgesOnCanvas ? /* @__PURE__ */ React.createElement(EdgeLayer, {
+			width: contentWidth,
+			height: contentHeight,
+			contentOffsetX,
+			contentOffsetY,
+			edges: displayEdges,
+			routes: edgeRoutes,
+			rectsById: edgeRectsById,
+			appearance: appearanceTokens,
+			mode,
+			selectedEdgeId: mode === "edit" ? edgeEdit.selectedEdgeId : null,
+			ghostPathD: mode === "edit" ? edgeEdit.ghostPathD : null,
+			onEdgeClick: mode === "edit" ? (edgeId) => edgeEdit.handleEdgeClick(edgeId) : void 0,
+			viewportScale: scale,
+			onSegmentDragStart: mode === "edit" ? edgeEdit.startDraggingSegment : void 0
+		}) : null, isFloorMapView && mode === "edit" ? /* @__PURE__ */ React.createElement(EditableItemLayer, {
 			items,
 			renderItem: effectiveRenderItem,
 			rowKey,
@@ -836,11 +949,24 @@ function PisellFloorMapLayoutInner(props, ref) {
 			contentOffsetX,
 			contentOffsetY,
 			selectedId,
-			onSelect: setSelectedId,
+			onSelect: edgeEdit.selectNode,
 			onUpdateItem: handleUpdateItem,
 			snapStep: (_effectiveMapLayer$sn = effectiveMapLayer === null || effectiveMapLayer === void 0 ? void 0 : effectiveMapLayer.snapStep) !== null && _effectiveMapLayer$sn !== void 0 ? _effectiveMapLayer$sn : 0,
 			scale,
 			onInteractionChange: setIsInteractingWithElement,
+			onLiveRectChange: (itemId, rect) => {
+				if (!itemId || !rect) {
+					edgeEdit.setPendingRectsById({});
+					return;
+				}
+				edgeEdit.setPendingRectsById({ [itemId]: {
+					left: rect.left,
+					top: rect.top,
+					width: rect.width,
+					height: rect.height
+				} });
+			},
+			alignGuideStroke: appearanceTokens.alignGuideStroke,
 			getMergedItemWrapperStyle,
 			editQuickBar
 		}) : /* @__PURE__ */ React.createElement(ItemLayer, {
@@ -863,7 +989,24 @@ function PisellFloorMapLayoutInner(props, ref) {
 			getMergedItemWrapperStyle,
 			onInteractionChange: setIsInteractingWithElement,
 			readModeSelectedItemId
-		}), isFloorMapView && mode === "edit" && (placeMode === null || placeMode === void 0 ? void 0 : placeMode.type) === "scene" && /* @__PURE__ */ React.createElement("div", {
+		}), isFloorMapView && mode === "edit" && showEdgeLayer && selectedId && edgeEdit.selectedNodeRect ? /* @__PURE__ */ React.createElement(NodePortMarkers, {
+			rect: edgeEdit.selectedNodeRect,
+			contentOffsetX,
+			contentOffsetY,
+			viewportScale: scale,
+			highlightAnchors: ((_edgeEdit$drawing = edgeEdit.drawing) === null || _edgeEdit$drawing === void 0 ? void 0 : _edgeEdit$drawing.fromInstanceId) === selectedId ? [edgeEdit.drawing.fromAnchor] : [],
+			onAnchorPointerDown: (anchor) => {
+				if (selectedId) edgeEdit.startDrawingFromAnchor(selectedId, anchor);
+			}
+		}) : null, isFloorMapView && mode === "edit" && showEdgeLayer && edgeEdit.drawing && edgeEdit.drawingTargetPreview ? /* @__PURE__ */ React.createElement(NodePortMarkers, {
+			className: `${FLOOR_MAP_LAYOUT_CLASS_PREFIX}-port-markers--draw-target`,
+			rect: edgeEdit.drawingTargetPreview.rect,
+			contentOffsetX,
+			contentOffsetY,
+			viewportScale: scale,
+			previewOnly: true,
+			highlightAnchors: [edgeEdit.drawingTargetPreview.anchor]
+		}) : null, isFloorMapView && mode === "edit" && (placeMode === null || placeMode === void 0 ? void 0 : placeMode.type) === "scene" && /* @__PURE__ */ React.createElement("div", {
 			className: placeOverlayClass,
 			style: {
 				width: contentWidth,
@@ -881,7 +1024,11 @@ function PisellFloorMapLayoutInner(props, ref) {
 				ev.preventDefault();
 				ev.stopPropagation();
 			},
-			onDrop: handlePaletteDropOnCanvas
+			onDrop: handlePaletteDropOnCanvas,
+			onClick: () => {
+				if ((placeMode === null || placeMode === void 0 ? void 0 : placeMode.type) === "scene") return;
+				edgeEdit.handleMapBackgroundClick();
+			}
 		}))), /* @__PURE__ */ React.createElement(ViewControlsWithZoom, {
 			config: viewControlsConfig,
 			scale,
@@ -891,6 +1038,8 @@ function PisellFloorMapLayoutInner(props, ref) {
 			toggleFullscreen: dockToggleFullscreen,
 			mapGridVisible: isOverview ? false : Boolean(effectiveMapLayer === null || effectiveMapLayer === void 0 ? void 0 : effectiveMapLayer.showGrid),
 			onToggleMapGrid: isFloorMapView && !isOverview ? toggleDraftCanvasShowGrid : void 0,
+			edgesLayerVisible,
+			onToggleEdgesLayer: showEdgeLayer ? toggleEdgesLayerVisible : void 0,
 			viewportLocked,
 			onToggleViewportLock: isFloorMapView ? toggleViewportLocked : void 0,
 			dockChrome: isFloorMapView,
@@ -902,21 +1051,22 @@ function PisellFloorMapLayoutInner(props, ref) {
 			dataSources,
 			currentCanvasId,
 			mode
-		}) : floorMapViewportOverlay) : null, isFloorMapView && mode === "edit" && editPanelParams && config && dataSources && !editTopBarPhoneLayout && /* @__PURE__ */ React.createElement("div", {
+		}) : floorMapViewportOverlay) : null, isFloorMapView && mode === "edit" && config && dataSources && !editTopBarPhoneLayout && (edgeEdit.selectedEdge || editPanelParams) && /* @__PURE__ */ React.createElement("div", {
 			className: classNames(`pisell-floor-map-layout-edit-panel-wrap`, mapAreaSize.height > 0 && `pisell-floor-map-layout-edit-panel-wrap-constrained`),
-			style: mapAreaSize.height > 0 ? {
-				height: mapAreaSize.height - 32,
-				maxHeight: mapAreaSize.height - 32,
-				overflow: "hidden",
-				top: 16,
-				transform: "none"
-			} : void 0
-		}, /* @__PURE__ */ React.createElement(FloorMapEditPanel, _objectSpread2(_objectSpread2({}, editPanelParams), {}, {
+			style: mapAreaSize.height > 0 ? { overflow: "hidden" } : void 0
+		}, edgeEdit.selectedEdge ? /* @__PURE__ */ React.createElement(FloorMapEdgeEditPanel, {
+			edge: edgeEdit.selectedEdge,
+			config,
+			onUpdate: (patch) => edgeEdit.updateEdge(edgeEdit.selectedEdge.id, patch),
+			onClose: () => edgeEdit.selectEdge(null),
+			onDelete: config.canvasUi.canEdit ? () => edgeEdit.deleteEdge(edgeEdit.selectedEdge.id) : void 0,
+			layoutDraftDirty: isLayoutDirty
+		}) : editPanelParams ? /* @__PURE__ */ React.createElement(FloorMapEditPanel, _objectSpread2(_objectSpread2({}, editPanelParams), {}, {
 			config,
 			dataSources,
 			savingRecord
-		}))));
-	})))), editTopBarPhoneLayout && editPanelParams && config && dataSources && /* @__PURE__ */ React.createElement(Drawer, {
+		})) : null));
+	})))), editTopBarPhoneLayout && config && dataSources && (edgeEdit.selectedEdge || editPanelParams) && /* @__PURE__ */ React.createElement(Drawer, {
 		placement: "right",
 		open: phoneEditDrawerOpen,
 		onClose: handlePhoneEditDrawerClose,
@@ -934,12 +1084,20 @@ function PisellFloorMapLayoutInner(props, ref) {
 			height: "100%"
 		} },
 		getContainer: typeof document !== "undefined" ? () => document.body : void 0
-	}, /* @__PURE__ */ React.createElement("div", { className: classNames(`pisell-floor-map-layout-edit-panel-wrap`, `pisell-floor-map-layout-edit-panel-wrap--phone-drawer`) }, /* @__PURE__ */ React.createElement(FloorMapEditPanel, _objectSpread2(_objectSpread2({}, editPanelParams), {}, {
+	}, /* @__PURE__ */ React.createElement("div", { className: classNames(`pisell-floor-map-layout-edit-panel-wrap`, `pisell-floor-map-layout-edit-panel-wrap--phone-drawer`) }, edgeEdit.selectedEdge ? /* @__PURE__ */ React.createElement(FloorMapEdgeEditPanel, {
+		edge: edgeEdit.selectedEdge,
+		config,
+		onUpdate: (patch) => edgeEdit.updateEdge(edgeEdit.selectedEdge.id, patch),
+		onClose: () => edgeEdit.selectEdge(null),
+		onDelete: config.canvasUi.canEdit ? () => edgeEdit.deleteEdge(edgeEdit.selectedEdge.id) : void 0,
+		layoutDraftDirty: isLayoutDirty,
+		className: `pisell-floor-map-layout-edit-panel--phone-drawer`
+	}) : editPanelParams ? /* @__PURE__ */ React.createElement(FloorMapEditPanel, _objectSpread2(_objectSpread2({}, editPanelParams), {}, {
 		config,
 		dataSources,
 		savingRecord,
 		className: `pisell-floor-map-layout-edit-panel--phone-drawer`
-	})))));
+	})) : null)));
 }
 /** 空间布局根组件：阅读/编辑、列表与平面图双模式，ref 见 {@link PisellFloorMapLayoutRef} */
 const PisellFloorMapLayout = React.forwardRef(PisellFloorMapLayoutInner);

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.less

@@ -63,12 +63,35 @@ body.pisell-floor-map-layout-fullscreen-host {
     z-index: 5;
   }
 
+  /**
+   * 右侧编辑面板（图元 / 连线共用）：上下锚定，底部留出 ViewControls Dock，
+   * 避免面板白底盖住右下缩放等操作栏。
+   */
   &-edit-panel-wrap {
     position: absolute;
-    top: 50%;
+    top: 16px;
     right: 16px;
-    transform: translateY(-50%);
+    bottom: calc(16px + var(--fmap-viewport-dock-bottom-clearance, 78px));
+    transform: none;
     z-index: 10;
+    display: flex;
+    flex-direction: column;
+    align-items: stretch;
+    min-height: 0;
+    max-width: min(280px, calc(100% - 32px));
+
+    > .pisell-floor-map-layout-edit-panel,
+    > .pisell-floor-map-layout-edge-edit-panel {
+      flex: 1 1 auto;
+      min-height: 0;
+      max-height: 100%;
+      height: auto;
+      box-sizing: border-box;
+    }
+  }
+
+  &-edit-panel-wrap-constrained {
+    overflow: hidden;
   }
 
   &-edit-panel-wrap--phone-drawer {
@@ -136,6 +159,14 @@ body.pisell-floor-map-layout-fullscreen-host {
 
   /** 视口内悬浮层：不随 Transform 缩放平移，与 ViewControls 同级 */
 
+  /**
+   * 右下 ViewControls Dock（14px + 56px chrome + 8px 间距），供右侧编辑面板底部留白。
+   * 数值与 {@link FLOOR_MAP_VIEWPORT_DOCK_BOTTOM_CLEARANCE} 保持一致。
+   */
+  &-floor-map-view {
+    --fmap-viewport-dock-bottom-clearance: 78px;
+  }
+
   &-viewport-overlay {
     position: absolute;
     left: 12px;

package/es/components/pisellFloorMapLayout/appearance/floorMapAppearance.js

@@ -3,11 +3,59 @@ import { _objectSpread2 } from "../../../_virtual/_@oxc-project_runtime@0.122.0/
 const FLOOR_MAP_APPEARANCE_TOKENS = {
 	light: {
 		mode: "light",
-		fallbackCanvasBackgroundColor: "#F2F4F7"
+		fallbackCanvasBackgroundColor: "#F2F4F7",
+		edgeStatusStyles: {
+			online: {
+				stroke: "#12B76A",
+				dashed: false
+			},
+			offline: {
+				stroke: "#98A2B3",
+				dashed: true
+			},
+			warning: {
+				stroke: "#F79009",
+				dashed: false
+			},
+			unknown: {
+				stroke: "#667085",
+				dashed: false
+			}
+		},
+		edgeSelectedStroke: "#1570EF",
+		edgeGhostStroke: "#84CAFF",
+		edgePortLabelBackground: "#FFFFFF",
+		edgePortLabelText: "#344054",
+		edgePortLabelBorder: "#D0D5DD",
+		alignGuideStroke: "#1570EF"
 	},
 	dark: {
 		mode: "dark",
-		fallbackCanvasBackgroundColor: "#31353d"
+		fallbackCanvasBackgroundColor: "#31353d",
+		edgeStatusStyles: {
+			online: {
+				stroke: "#32D583",
+				dashed: false
+			},
+			offline: {
+				stroke: "#667085",
+				dashed: true
+			},
+			warning: {
+				stroke: "#FDB022",
+				dashed: false
+			},
+			unknown: {
+				stroke: "#98A2B3",
+				dashed: false
+			}
+		},
+		edgeSelectedStroke: "#53B1FD",
+		edgeGhostStroke: "#2E90FA",
+		edgePortLabelBackground: "#1D2939",
+		edgePortLabelText: "#F2F4F7",
+		edgePortLabelBorder: "#475467",
+		alignGuideStroke: "#53B1FD"
 	}
 };
 /**