gis-view-webgl2 0.1.8 → 0.1.9

package/dist/index.d.ts

@@ -13,6 +13,14 @@ export interface GisViewCamera {
 	scale: number
 }
 
+/** 用户操作空闲回调 / idle 事件的载荷 */
+export interface GisViewIdlePayload {
+	/** 距离创建或上一次指针 / 滚轮 / 键盘操作的毫秒数 */
+	idleTime: number
+	/** 触发这次回调的 idleTimeout（毫秒） */
+	timeout: number
+}
+
 /** 直接飞相机时的目标：两项都可省略，没写的那一项沿用当前相机 */
 export interface GisViewCameraTarget {
 	center?: [number, number]
@@ -1118,6 +1126,8 @@ export interface GisViewPoint {
 	copyable?: boolean
 	/** 是否允许作为合并目标（把别的节点拖到它身上时弹确认框）：false 时不让合并到它，缺省 true */
 	mergeable?: boolean
+	/** 合并追溯信息：mergePoints 写入，splitPoint 省略 parts 时按它自动解除合并。业务数据请避开这个字段 */
+	mergeInfo?: GisViewMergeInfo | null
 	/** 悬停到这个点上时的光标：覆盖 options.cursorStyle.point，写法见 GisViewCursorValue */
 	cursor?: GisViewCursorValue
 	/** 按住 Ctrl（macOS 为 Cmd）悬停到这个点上时的光标：覆盖 options.cursorStyle.ctrl.point */
@@ -1359,6 +1369,8 @@ export interface GisViewChannel {
 	visible?: boolean
 	/** 通道内的线路 id，顺序即回线顺序（沿骨架左法线方向） */
 	lineIds: Array<string | number>
+	/** 合并追溯信息：通道被合并 / 改端点时由 mergePoints 写入，便于按原通道 id 和后端对账 */
+	mergeInfo?: GisViewMergeInfo | null
 	/**
 	 * 通道分组：缺省是「一个通道一组」（成员用 lineIds、拐点用 path）。
 	 * 配了之后每个分组有自己的成员与拐点，拆分 / 合并的结果也会写在这里；
@@ -1797,6 +1809,38 @@ export interface GisViewChannelBetween {
 	currentGroupId: string | number | null
 }
 
+/** getDirectConnections 的端点读数：节点 id、points 下标与数据里那一份 */
+export interface GisViewDirectConnectionNode {
+	id: string | number
+	index: number
+	item: GisViewPoint
+}
+
+/** getDirectConnections 命中的直接通道：两端都在传入的节点集合里 */
+export interface GisViewDirectChannelConnection {
+	type: 'channel'
+	from: GisViewDirectConnectionNode
+	to: GisViewDirectConnectionNode
+	channelId: string | number | null
+	channelIndex: number
+	/** 通道当前成员表（顶层 lineIds + 分组里的回线，按声明顺序去重） */
+	lineIds: Array<string | number>
+	item: GisViewChannel
+}
+
+/** getDirectConnections 命中的直接线路：两端由线路自己的 from / to 绑定 */
+export interface GisViewDirectLineConnection {
+	type: 'line'
+	from: GisViewDirectConnectionNode
+	to: GisViewDirectConnectionNode
+	lineId: string | number | null
+	lineIndex: number
+	item: GisViewLine
+}
+
+/** getDirectConnections 的一项：直接通道或直接线路（通道与成员回线可能同时命中） */
+export type GisViewDirectConnection = GisViewDirectChannelConnection | GisViewDirectLineConnection
+
 /** 新增通道草稿的配置：beginAddChannel 用 */
 export interface GisViewChannelDraftOptions {
 	/** 两个节点一选完就自动提交，不用再调 commitAddChannel */
@@ -3523,7 +3567,8 @@ export interface GisViewPointMergePayload {
 	/** 合并后保留谁：'target'（缺省，碰撞目标）或 'source'（当前拖动的来源节点）；确认时传 confirm({ keep }) */
 	keep: GisViewMergeKeep
 	/**
-	 * confirm 阶段的合并结果（按 keep 决定的保留端优先、另一端独有字段带过来、尺寸取双方最大、图标优先保留端）：
+ * confirm 阶段的合并结果（按 keep 决定的保留端业务字段优先、merge.maxKeys 列出的字段取双方最高值、
+ * 尺寸取双方最大、图标用保留端）：
 	 * 改它就是改合并结果；其余阶段为 null。confirm({ item }) 可以只给要改的字段，组件先算缺省结果再合并这份补丁
 	 */
 	item: GisViewPoint | null
@@ -3624,7 +3669,7 @@ export type GisViewMergeSelectedOutcome = GisViewMergeSelectedPayload
 
 /** mergeSelectedPoints 改写每一对最终节点时的上下文：merged / item 是缺省合并结果 */
 export interface GisViewMergeSelectedItemContext {
-	/** 缺省合并结果（目标优先、来源独有字段带过来） */
+/** 缺省合并结果（保留节点的业务字段优先，merge.maxKeys 列出的字段取双方最高值） */
 	item: GisViewPoint
 	/** item 的别名 */
 	merged: GisViewPoint
@@ -3684,6 +3729,11 @@ export interface GisViewSplitPointOptions {
 	 * 解除合并时推荐用它
 	 */
 	autoLines?: 'first' | 'alternate'
+	/**
+	 * 拆分 / 自动解除合并后是否选中结果节点：缺省 false（只移除来源节点的选中态，不动其它无关选中）；
+	 * true 时选中 parts 对应的全部节点
+	 */
+	select?: boolean
 }
 
 /** 拆分时没认出来的线路 / 通道引用 */
@@ -3738,6 +3788,10 @@ export interface GisViewSplitPointOutcome {
 	autoAssignedLines: number
 	/** 每一份最终接到哪些线路（含显式分配与自动分配） */
 	lineAssignments: GisViewSplitPointLineAssignment[]
+	/** 这次是否走了 mergeInfo 自动解除合并（省略 parts 且节点带合并记录时为 true） */
+	autoRestored: boolean
+	/** 自动解除时恢复的全部来源节点 id（手工拆分时为空数组） */
+	mergeSourceIds: Array<string | number | null>
 	changes: GisViewSplitPointChangeSet | null
 }
 
@@ -4195,6 +4249,18 @@ export interface GisViewItemLabel {
 	offset?: [number, number]
 	/** 内联样式（与配置里的 style 一层合并，改字号不会把底色清掉） */
 	style?: Record<string, string>
+	/** 标签层级：越大越靠上；不写时按所在层的最底层处理 */
+	zIndex?: number
+	/**
+	 * 是否跟随所属节点的 zIndex（节点标签；线路标签忽略这一项）。
+	 * 跟随之后，更高层的节点与标签可以盖住这条标签；显式 zIndex 优先。
+	 */
+	followNodeZIndex?: boolean
+	/**
+	 * 字号跟随地图缩放的指数：0（默认）保持屏幕像素不变，1 与地图同倍率放大 / 缩小，
+	 * 0.5 表示地图放大 4 倍时字号放大 2 倍。基数是标签样式里的 fontSize（缺省 12px）。
+	 */
+	zoomScale?: number
 	/** 线路标签是否与线路方向平行（点的标签忽略这一项） */
 	parallel?: boolean
 	/** 这一条是否参与避让：false 时即使全局开启 labelOptimize / avoidOverlap 也始终按候选落点画出；缺省跟随全局 */
@@ -4296,6 +4362,12 @@ export interface GisViewLabelOptions {
 	className?: string
 	/** 标签的内联样式 */
 	style?: Record<string, string>
+	/** 标签层级：越大越靠上；不写时是 0 */
+	zIndex?: number
+	/** 跟随节点样式链里的 zIndex（显式 zIndex 优先）；更高层的节点会把标签盖住 */
+	followNodeZIndex?: boolean
+	/** 字号跟随地图缩放的指数：0 固定屏幕字号（默认），1 与地图同倍率 */
+	zoomScale?: number
 }
 
 /** 线路标签内容函数的入参 */
@@ -4384,6 +4456,10 @@ export interface GisViewLineLabelOptions {
 	className?: string
 	/** 标签的内联样式 */
 	style?: Record<string, string>
+	/** 标签层级：越大越靠上；不写时是 0 */
+	zIndex?: number
+	/** 字号跟随地图缩放的指数：0 固定屏幕字号（默认），1 与地图同倍率 */
+	zoomScale?: number
 }
 
 /** 标签类别：节点标签 / 线路标签 */
@@ -4415,6 +4491,12 @@ export interface GisViewLabelState {
 	parallel: boolean | null
 	/** 改过的「整条不画」（removeLabel 对配置 / 数据里声明的那一条就是这么落的）；没改过是 null */
 	hidden: boolean | null
+	/** 改过的标签层级；没改过是 null */
+	zIndex: number | null
+	/** 改过的「跟随节点层级」；没改过是 null */
+	followNodeZIndex: boolean | null
+	/** 改过的字号缩放指数；没改过是 null */
+	zoomScale: number | null
 	/** 这一条是运行时加的（addLabel），不是配置 / 数据里声明的 */
 	added: boolean
 	/** 运行时加的标签的定义（addLabel 的入参），持久化回显时按它重建；不是运行时标签时为 null */
@@ -4441,6 +4523,12 @@ export interface GisViewLabelPatch {
 	parallel?: boolean | null
 	/** 整条不画（true 等于 visibility: 'hidden'）；写 null 回到默认 */
 	hidden?: boolean | null
+	/** 标签层级；写 null 回到默认 */
+	zIndex?: number | null
+	/** 是否跟随节点层级；写 null 回到默认 */
+	followNodeZIndex?: boolean | null
+	/** 字号跟随地图缩放的指数（0 = 固定屏幕字号）；写 null 回到默认 */
+	zoomScale?: number | null
 }
 
 /**
@@ -4460,6 +4548,12 @@ export interface GisViewLabelInfo {
 	className: string | null
 	/** 合并之后的逐条内联样式（配置 + 数据 + 运行时状态） */
 	style: Record<string, string> | null
+	/** 这一条当下生效的标签层级（显式 zIndex 或跟随节点得到的有效层） */
+	zIndex: number
+	/** 这一条是否跟随所属节点的 zIndex（线路标签忽略这一项） */
+	followNodeZIndex: boolean
+	/** 这一条当下生效的字号缩放指数（0 固定屏幕字号，1 与地图同倍率） */
+	zoomScale: number
 	/** 这一条是哪来的：'config' 配置里定义的 / 'data' 数据里写的 / 'runtime' 运行时加的 */
 	source: 'config' | 'data' | 'runtime'
 	/** 数据里写了同 id 的那一条覆盖 */
@@ -4621,6 +4715,12 @@ export interface GisViewLabelListItem {
 	/** 当下生效的偏移（像素）：运行时拖出来的优先，否则用声明里的；都没有是 [0, 0] */
 	offset: [number, number]
 	style: Record<string, string> | null
+	/** 当下生效的标签层级 */
+	zIndex: number
+	/** 是否跟随节点层级 */
+	followNodeZIndex: boolean
+	/** 当下生效的字号缩放指数 */
+	zoomScale: number
 	/** 线路标签：这一条是否与线路平行；节点标签恒为 false */
 	parallel: boolean
 	visibility: GisViewLabelVisibility
@@ -5498,6 +5598,40 @@ export interface GisViewLineStyleSnapshot {
 	zIndex: number
 }
 
+/** 合并追溯里的一条要素快照：恢复时优先按 id 找当前位置，没有 id 才参考原下标 */
+export interface GisViewMergeFeatureSnapshot<T> {
+	index: number
+	id: string | number | null
+	item: T
+}
+
+/**
+ * mergePoints 写在保留节点 / 受影响通道上的合并追溯信息。场站合并会在保留节点上保存
+ * 第一次合并前的保留节点、每个来源节点与受影响线路 / 通道的快照；同一个保留节点连续合并多个来源时，
+ * 来源与快照会累加。splitPoint(source) 不传 parts 时按这份信息自动解除合并。
+ * 该字段由组件维护，业务数据不要占用；序列化后随 points / channels 一起提交即可。
+ */
+export interface GisViewMergeInfo {
+	/** 追溯格式版本，目前为 1 */
+	version: 1
+	/** 保留节点的 id（通道上的同一字段表示合并到的目标节点） */
+	targetId: string | number | null
+	/** 第一次合并时保留节点在原数组里的下标 */
+	targetIndex?: number
+	/** 保留节点第一次合并前的快照（不含 mergeInfo 自身） */
+	targetPoint?: GisViewPoint | null
+	/** 合并进来的来源节点 id，按发生顺序 */
+	sourceIds?: Array<string | number | null>
+	/** 来源节点快照，按第一次合并时的原下标顺序恢复 */
+	points?: Array<GisViewMergeFeatureSnapshot<GisViewPoint>>
+	/** 受影响线路第一次合并前的快照；自动解除时按它恢复改绑、几何与删除的线路 */
+	lines?: Array<GisViewMergeFeatureSnapshot<GisViewLine>>
+	/** 受影响通道第一次合并前的快照；自动解除时按它恢复端点、分组与回线归属 */
+	channels?: Array<GisViewMergeFeatureSnapshot<GisViewChannel>>
+	/** 通道溯源：参与本次合并、被改端点或被并掉的原始通道 id */
+	originalIds?: Array<string | number | null>
+}
+
 /** 合并时给的上下文：merge.createItem 会拿到它 */
 export interface GisViewMergeContext {
 	sourceIndex: number
@@ -5546,9 +5680,16 @@ export interface GisViewMergeOptions {
 	 */
 	channelGroups?: 'keep' | 'merge'
 	/**
-	 * 自己决定合并之后的节点数据：缺省 `{ ...source, ...target }`（目标优先，来源独有的字段带过来），
-	 * 尺寸取双方 getPointStyle().size 的较大值（sizeScale 归 1）、图标优先目标节点（目标没有才用来源的）；
-	 * 坐标与 id 无论怎么配都取目标节点
+	 * 合并后取双方最高值的字段：只认列出来的键，缺省空表（不取任何最高值，全部保留目标节点字段）。
+	 * 例如 `['vn_kv', 'value']`；也接受 `'vn_kv,value'` 写法。字段两边都是有限数字时取 Math.max，
+	 * 只有一边有有效数字就用那一边，否则保持目标节点原值。createItem / options.item 自行接管结果时不参与
+	 */
+	maxKeys?: string[] | string
+	/**
+	 * 自己决定合并之后的节点数据：缺省以目标节点字段为底，`vn_kv` / `voltage` / `voltageKv` /
+	 * `voltage_level` / `voltageLevel` 等电压字段不再自动取最大值（要取就写 maxKeys），其余业务字段
+	 * （名称、图标类型等）全部保留目标节点的值；尺寸取双方 getPointStyle().size 的较大值（sizeScale 归 1）。
+	 * 坐标、id 与 mergeInfo 无论怎么配都取目标节点 / 由组件维护
 	 */
 	createItem?: (source: GisViewPoint, target: GisViewPoint, context: GisViewMergeContext) => GisViewPoint
 }
@@ -5573,12 +5714,15 @@ export type GisViewChannelWaypointDragMode =
 	| 'vertex'
 
 /**
- * 框选 / Ctrl 多选允许收哪几类要素：节点、独立线路、通道回线。
+ * 框选允许收哪几类要素：节点、独立线路、通道回线，以及线路 / 通道的端点口径。
  * 通道回线只归 channel 这一档管；通道之外的普通线路归 line，两者可以任意组合。
+ * `lineEndpoints` / `channelEndpoints` 要求线路 / 通道自己的两端节点都被框住才算命中，
+ * 只用于框选、`selectInBox` 与 `exportData({ scope: 'viewport' })`，不参与点击多选。
  */
-export type GisViewSelectionKind = 'point' | 'line' | 'channel'
+export type GisViewSelectionKind = 'point' | 'line' | 'channel' | 'lineEndpoints' | 'channelEndpoints'
 /**
  * selectionKinds 的写法：单类、类型数组、'all' / true（全开）或 false / null（全关）。
+ * 端点口径也认 line-endpoints / line_endpoints / channel-endpoints / channel_endpoints 这几种连字符写法。
  * 不写时保留旧行为：框选只收节点，Ctrl / 多选点击仍可收节点与线路（回线按 channelSelectMode 摊开）。
  */
 export type GisViewSelectionKindsInput = GisViewSelectionKind | GisViewSelectionKind[] | 'all' | true | false | null
@@ -6047,6 +6191,8 @@ export interface GisViewEventMap {
 	/** 视口尺寸 / 显示比例变化（画布按新尺寸重铺之后才发） */
 	viewport: GisViewViewport
 	cameraChange: GisViewCamera
+	/** 用户在这段时间内没有指针 / 滚轮 / 键盘操作（每个空闲段只发一次） */
+	idle: GisViewIdlePayload
 	cursor: GisViewCursorPayload
 	hover: GisViewHoverPayload
 	pointer: GisViewPointerState
@@ -6225,6 +6371,16 @@ export interface GisViewWebGLLayer {
  */
 export type GisViewSelectTrigger = 'click' | 'dblClick'
 
+/** 通道简略配置：分组回线数超过阈值时只显示一条代表线 */
+export interface GisViewChannelSimplifyOptions {
+	/** false 关闭；缺省对象即开启 */
+	enabled?: boolean
+	/** 分组回线数严格大于这个值时折叠，缺省 4 */
+	threshold?: number
+	/** 代表线的自定义样式（颜色、线宽、线型等）；只影响这一条代表线的展示，不改数据 */
+	style?: GisViewLineStyle
+}
+
 export interface GisViewOptions {
 	/**
 	 * 功能开关：预设名（'edit' / 'view' / 'static'）、开关表或布尔值 ——
@@ -6309,6 +6465,11 @@ export interface GisViewOptions {
 	channelMaxGroups?: number
 	/** 一个分组最多几条回线（0 表示不限）：新增通道时据此判断还能不能并进这一组 */
 	channelGroupMaxLines?: number
+	/**
+	 * 通道简略：true 用缺省阈值 4；对象可改 threshold 与代表线 style。
+	 * 某个分组超过阈值时只画一条代表线（没有 groups 的通道按一整组算），数据、分组读数与导出不变
+	 */
+	channelSimplify?: boolean | GisViewChannelSimplifyOptions
 	/** 新增通道草稿线的样式（跟随光标的那条预览线） */
 	channelDraftStyle?: GisViewChannelDraftStyle
 	/** WebGL 自定义层：内置内容之后按 order 绘制；运行时用 addWebGLLayer / updateWebGLLayer 等维护 */
@@ -6496,9 +6657,11 @@ export interface GisViewOptions {
 	selectTrigger?: GisViewSelectTrigger
 	/**
 	 * 框选 / Ctrl 多选允许收哪几类要素：'point' 节点、'line' 独立线路、'channel' 通道回线，
+	 * 另有 'lineEndpoints' / 'channelEndpoints' 只在框选时要求线路 / 通道两端节点都在框内；
 	 * 可写数组任意组合，'all' / true 全开，false / null 全关。
 	 * **不写时保留旧行为**：框选只收节点，Ctrl / 多选点击仍可收节点与线路；
 	 * 写了之后框选与 Ctrl / 多选点击统一按这一份过滤（普通单选与接口 select 不受限制）。
+	 * 两个端点口径只影响框选，不会因为写进同一份数组就让 Ctrl 点击去猜端点。
 	 * 运行时走 updateOptions({ selectionKinds })。
 	 */
 	selectionKinds?: GisViewSelectionKindsInput
@@ -6549,6 +6712,10 @@ export interface GisViewOptions {
 	fitPadding?: number
 	/** 首次有数据时自动适应视图，默认 true；配了 initialView 时以 initialView 为准 */
 	fitOnInit?: boolean
+	/** 首屏中心 [x, y] / { x, y }：initialView.center 的简写；显式给出非空 initialView 时以它为准 */
+	center?: GisViewCoordinate | null
+	/** 首屏绝对比例（像素 / 世界单位）：initialView.scale 的简写；显式给出非空 initialView 时以它为准 */
+	scale?: number | null
 	/**
 	 * 初始视图：首次有数据时相机落在哪里。不配就是「适应整个数据范围」。
 	 * 想一进来就看局部（不要一上来铺满整屏）就写 { center, zoom } 或 { scale }：
@@ -6565,6 +6732,11 @@ export interface GisViewOptions {
 	 * 读数不需要 60Hz，节流能省下每帧一次的回调与对象分配（拖拽时尤其明显）。
 	 */
 	statsInterval?: number
+	/**
+	 * 用户操作空闲阈值（毫秒）：根节点上这么久没有指针 / 滚轮 / 键盘活动就发一次 idle，
+	 * 每个空闲段只发一次；0 / 不写表示关闭。运行中用 getIdleTime() 读当前空闲时长。
+	 */
+	idleTimeout?: number
 	/**
 	 * onRender 的节流间隔（毫秒），默认 400；配 0 与 onStats 同拍
 	 * （再配上 statsInterval: 0 就是每帧一条）。
@@ -6675,6 +6847,8 @@ export interface GisViewOptions {
 	/** 分组变化：拆分 / 合并 / 挪线 / 新建组 / 整份声明换（updateChannel），action.type 说明这一笔是什么 */
 	onChannelGroupChange?: (payload: GisViewChannelGroupChangePayload) => void
 	onCameraChange?: (camera: GisViewCamera) => void
+	/** 用户操作空闲达到 idleTimeout 时回调一次；恢复操作后再次空闲会重新触发 */
+	onIdle?: (payload: GisViewIdlePayload) => void
 	/** 视口尺寸 / 显示比例变化：内置鹰眼图与覆盖层按它重排，自建面板也可以拿它跟着调整 */
 	onViewport?: (viewport: GisViewViewport) => void
 	onStats?: (stats: GisViewEngineStats) => void
@@ -7075,6 +7249,12 @@ export type GisViewExportScope = 'all' | 'viewport' | 'selection'
 export interface GisViewExportDataOptions extends GisViewExportFilterOptions {
 	/** 导出范围，缺省 'all'；selected / visible 之类的同义词在运行时也认 */
 	scope?: GisViewExportScope
+	/**
+	 * 只对 scope: 'viewport' 生效的类型过滤：写法与 options.selectionKinds 相同。
+	 * 不写时沿用视口导出的旧口径；写 'lineEndpoints' / 'channelEndpoints' 时，
+	 * 只有两端节点都落在视口世界矩形内的独立线路 / 通道才会导出（端点模式不会顺带导出节点）。
+	 */
+	selectionKinds?: GisViewSelectionKindsInput
 	/**
 	 * 要哪一套：'view'（缺省，节点 / 线路 / 通道 / 拐点分组四份，JS 风格的键名）/
 	 * 'new'（new.json 口径的整份：station_data + channel_data + 四至范围那几列）/
@@ -7453,6 +7633,8 @@ export interface GisViewSceneSnapshot {
 	regions: GisViewSceneRegion[]
 	/** 数据线路与节点装饰连接线（连接线也画在节点 / 装饰之前） */
 	lines: GisViewSceneLine[]
+	/** 抬层的选中线路：画在普通节点之后、抬层节点之前 */
+	raisedLines: GisViewSceneLine[]
 	points: GisViewSceneNode[]
 	clusters: GisViewSceneCluster[]
 	backgroundPoints: GisViewSceneNode[]
@@ -7689,11 +7871,21 @@ export interface GisViewInstance {
 	searchAsync(input: string | GisViewSearchOptions): Promise<GisViewSearchResult>
 	setCamera(camera: Partial<GisViewCamera>): GisViewInstance
 	getCamera(): GisViewCamera
+	/** 当前视图比例（像素 / 世界单位），与 getCamera().scale 同一份读数 */
+	getScale(): number
+	/** 直接设置视图比例；origin 是画布 CSS 像素锚点，缺省为视口中心 */
+	setScale(scale: number, origin?: [number, number]): GisViewInstance
+	/** 当前视图中心 [x, y]（返回副本，可直接改） */
+	getCenter(): [number, number]
+	/** 只移动视图中心、保持当前比例；返回 this 以便链式调用 */
+	setCenter(center: [number, number]): GisViewInstance
 	getBounds(): GisViewBounds
 	/** 缩放联动的基准比例（pointZoomScale / lineZoomScale 共用那一份）：缺省是首次适应视图时的 camera.scale */
 	getZoomBaseScale(): number
 	/** 重定缩放联动的基准比例：不传就取当下相机的比例（把现在这一屏当成「原样大小」），之后放大缩小都从它算倍数，返回 this */
 	setZoomBaseScale(scale?: number): GisViewInstance
+	/** 距离创建或上一次指针 / 滚轮 / 键盘操作的毫秒数；程序化 API 调用不重置它 */
+	getIdleTime(): number
 	/** 鹰眼图根节点（没配 minimap 时为 null）：拖动整张图 / 绑定自定义手势时拿它 */
 	getMinimapElement(): HTMLElement | null
 	/** 鹰眼图自身的倍数：1 是「刚好铺满小图」 */
@@ -7919,24 +8111,27 @@ export interface GisViewInstance {
 	getPointClipboard(): GisViewClipboardItem | null
 	/**
 	 * 把来源节点并进目标节点（接口调用）：来源 / 目标收 id、下标或 `{ id }` / `{ index }`。
-	 * 节点数据按 merge.createItem 合并（缺省目标优先、来源独有的字段带过来，尺寸取双方最大、图标优先目标），
+	 * 节点数据按 merge.createItem 合并（缺省以目标节点为底，merge.maxKeys 列出的字段取双方最高值，
+	 * 尺寸取双方最大、图标取目标），
 	 * 绑在来源上的线路改绑到目标，合并后自环 / 零长度的线路与两端相同的通道一起删掉，
 	 * 撞成同一条的通道按 merge.channelGroups 决定分组（缺省各自保留）；
+	 * 保留节点写完整 mergeInfo 快照，受影响通道写轻量 mergeInfo，供 splitPoint 自动解除合并；
 	 * options.item 可以给一份已经改好的合并结果（confirm 阶段改过 payload.item 之后就是它）；
 	 * 返回 `{ ok, item, linesChanged, removedLines, removedChannels, mergedChannels }`，
 	 * 并不了返回 ok: false 并另发一条 `phase: 'merge', ok: false` 的事件
 	 */
 	mergePoints(source: GisViewPointRef, target: GisViewPointRef, options?: { originalEvent?: Event | null; item?: GisViewPoint }): GisViewMergeOutcome
 	/**
-	 * 把一个节点拆成多份（mergePoints 的逆操作）：第一份复用原下标与 id，其余追加到 points 末尾。
+	 * 把一个节点拆成多份（mergePoints 的逆操作）：parts 省略 / null / [] 且节点带 mergeInfo 时自动解除合并，
+	 * 恢复全部来源节点与合并前的线路 / 通道；给 parts 时第一份复用原下标与 id，其余追加到 points 末尾。
 	 * 每份可直接写节点字段或放进 item；lines 显式分配线路，没写时默认跟第一份，
 	 * options.autoLines 为 'alternate' 时按「通道成组、独立线路单条」轮流分给负载最少的一份（解除合并推荐）。
 	 * channels / channelFrom / channelTo 分配受影响通道的端点。没显式分配的通道跟随它第一条被分配过的成员线路。
 	 * 拆分后自环 / 零长度线路与两端相同的通道删掉；整次调用只记一条历史、只发一条 `splitPoint` 数据变更。
 	 * 返回 `{ ok, items, indexes, pointIds, linesChanged, removedLines, channelsChanged, removedChannels,
-	 * autoLines, autoAssignedLines, lineAssignments, changes, skipped }`
+	 * autoLines, autoAssignedLines, lineAssignments, autoRestored, mergeSourceIds, changes, skipped }`
 	 */
-	splitPoint(source: GisViewPointRef, parts: GisViewSplitPointPart[], options?: GisViewSplitPointOptions): GisViewSplitPointOutcome
+	splitPoint(source: GisViewPointRef, parts?: GisViewSplitPointPart[] | null, options?: GisViewSplitPointOptions): GisViewSplitPointOutcome
 	/**
 	 * 框选 / 多选之后一步把选中的节点并到一个目标上（接口调用）：不指定 target 就自动挑「绑定线路最多」的那一个
 	 * （一样多取画得大的、再一样取下标小的）；来源默认是除目标之外的选中节点，也可以直接用 options.sources 给定，
@@ -8124,6 +8319,12 @@ export interface GisViewInstance {
 	 * 界面做「这两个点之间已经有通道 / 有几组」这类判断用它，不必去看新增方案表
 	 */
 	getChannelBetween(from: string | number, to: string | number): GisViewChannelBetween | null
+	/**
+	 * 一组节点之间的直接通道 / 线路：两端都必须真实存在且都在传入的 id 集合里，
+	 * 只认通道端点或线路 from / to 的直接绑定，不沿线路穿中间节点，也不返回集合外的边。
+	 * 通道按 channels 顺序、线路按 lines 顺序；一条都没命中时返回空数组。
+	 */
+	getDirectConnections(pointIds: string | number | Array<string | number>): GisViewDirectConnection[]
 	/**
 	 * 程序化新增一个通道：第一段是通道信息 `{ from, to, name, id, path, routing, channelProps }`，第二段是线路数据 ——
 	 * 每条按自己的 id 建进通道（id 自动成为 lineIds），第三段是可选的分组信息。只负责新建一个通道：
@@ -8511,6 +8712,8 @@ export interface GisViewEngineOptions {
 	channelMaxGroups?: number
 	/** 一个分组最多几条回线（0 表示不限）：新增通道时据此判断还能不能并进这一组 */
 	channelGroupMaxLines?: number
+	/** 通道简略：分组回线数超过阈值时只画一条代表线，见 GisViewChannelSimplifyOptions */
+	channelSimplify?: boolean | GisViewChannelSimplifyOptions
 	/** 新增通道草稿线的样式（跟随光标的那条预览线） */
 	channelDraftStyle?: GisViewChannelDraftStyle
 	/** WebGL 自定义层：与 GisViewOptions.webglLayers 同一份写法 */
@@ -8965,9 +9168,6 @@ export declare const FEATURE_NAMES: GisViewFeatureName[]
 /** 预设表：键是开关名、值是布尔；**没列出来的开关取 featureDefault**（全关；「配了才有」的那几项不给值） */
 export declare const FEATURE_PRESETS: Record<GisViewFeaturePreset, GisViewFeatures>
 
-/** 编辑类开关（会改数据的那几项）的名单：文档与面板按它分组；与查看类一样缺省全关，这一列只说明分类 */
-export declare const FEATURE_EDIT_NAMES: GisViewFeatureName[]
-
 /** 单个开关的缺省值：**全关**（false）；「配了才有」的那几项 undefined（跟随详细配置，配了就等于手动打开） */
 export declare const featureDefault: (name: GisViewFeatureName) => boolean | undefined