gis-view-webgl2 0.1.7 → 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）。
 	 * 配了之后每个分组有自己的成员与拐点，拆分 / 合并的结果也会写在这里；
@@ -1690,6 +1702,12 @@ export interface GisViewChannelLinesResult {
 	groups?: GisViewChannelGroupInfo[]
 }
 
+/**
+ * 草稿遇到「两端已有通道」时的处理：block 不发新通道、按失败返回；newGroup 把这次新增的回线放进新分组；
+ * joinGroup 并进 groupId / groupIndex 指定的分组；auto 有新分组余量时优先新分组，否则并进可用分组
+ */
+export type GisViewChannelExistingMode = 'block' | 'newGroup' | 'joinGroup' | 'auto'
+
 /**
  * 新增方案：newChannel 新建一条通道，newGroup 在原通道里加一组（不带拐点），
  * joinGroup 把新回线并进原通道的某一组；上限（channelMaxGroups / channelGroupMaxLines）到了就不 enabled；
@@ -1740,6 +1758,14 @@ export interface GisViewChannelAddPlan {
 	to: GisViewChannelNodeDraft
 	/** 这一段加什么：'channel' 新建通道 / 回线（缺省），'line' 新建不挂通道的独立线路 */
 	kind: 'channel' | 'line'
+	/** 这一次草稿是否处在单一通道模式（已有通道时按 existingChannel 处理） */
+	singleChannel: boolean
+	/** 草稿对已有通道的处理策略；没有配置时为 null（沿用旧的分组方案表） */
+	existingChannel: GisViewChannelExistingMode | null
+	/** 最终推荐的分组（preferred 为 joinGroup 时）：group 读数已切到这一组 */
+	targetGroupId: string | number | null
+	/** 最终推荐分组的序号（从 0 起）；不落到分组时为 -1 */
+	targetGroupIndex: number
 	/** 这一次要加的回线数（余量按它算） */
 	count: number
 	/** 两个节点之间已有的通道 id（没有就是新建通道） */
@@ -1783,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 */
@@ -1799,8 +1857,21 @@ export interface GisViewChannelDraftOptions {
 	continuous?: boolean | 'chain'
 	/** 连续新增时是否接着上一段的终点画（等价于 continuous: 'chain'） */
 	chain?: boolean
-	/** 这一段加什么：'channel' 新建通道 / 回线（缺省），'line' 新建不挂通道的独立线路 */
-	kind?: 'channel' | 'line'
+	/**
+	 * 单一通道模式：true 时 beginAddChannel 默认在已有通道上 fail（等价于 existingChannel: 'block'）；
+	 * 没有已有通道时仍正常新建。beginAddLine 不把 singleChannel 当作挂通道开关，挂已有通道请写 existingChannel
+	 */
+	singleChannel?: boolean
+	/**
+	 * 两端已有通道时怎么办：block 失败、newGroup 新加一组、joinGroup 并进指定组、auto 新分组优先。
+	 * beginAddChannel 不写且 singleChannel 为 true 时按 block；beginAddLine 显式写 newGroup / joinGroup
+	 * 时可给已有通道加回线，不写则始终新建独立线路
+	 */
+	existingChannel?: GisViewChannelExistingMode
+	/** joinGroup 的目标分组 id；也认 groupIndex（从 0 起，二者都写按 groupId） */
+	groupId?: string | number
+	/** joinGroup 的目标分组序号（从 0 起） */
+	groupIndex?: number
 	/** 新建通道时一次加几回（缺省 1）：新通道 / 新分组 / 并入分组的余量都按它算 */
 	circuits?: number
 	/** 新线路名，缺省按两端节点生成 */
@@ -1812,8 +1883,8 @@ export interface GisViewChannelDraftOptions {
 	lineProps?: Partial<GisViewLine>
 	/** 逐条回线的属性：按下标一一对应（第几项就只管第几回），盖在同一条 lineProps 之上；与 createChannels 的 linePropsByMember 同名同义 */
 	linePropsByMember?: Array<Partial<GisViewLine> | undefined>
-	/** 第二段 lineItems（一条或一批）：与 linePropsByMember 同义，给了几条这一段就加几条（circuits 按它对齐）；每项也可以只写一个 id */
-	lineItems?: GisViewChannelLineItems
+	/** 第二段 lineData（一条或一批）：与 linePropsByMember 同义，给了几条这一段就加几条（circuits 按它对齐）；每项也可以只写一个 id */
+	lineData?: GisViewChannelLineData
 	/** 走线方式：'straight'（缺省，两端直连）/ 'orthogonal'（自动补一个先横后纵的 90° 拐点） */
 	routing?: 'straight' | 'orthogonal'
 	/** 中间拐点（不含两端）：给了就按它折线；routing 的自动拐点只在没给有效拐点时补 */
@@ -1856,6 +1927,13 @@ export interface GisViewChannelDraftPayload {
 	chain: boolean
 	/** 这一段加什么：'channel' 新建通道 / 回线，'line' 新建不挂通道的独立线路 */
 	kind: 'channel' | 'line'
+	/** 这一段是否开了单一通道模式 */
+	singleChannel: boolean
+	/** 这一段对已有通道的策略（没有配置时为 null） */
+	existingChannel: GisViewChannelExistingMode | null
+	/** 推荐落点的目标分组：preferred 为 joinGroup 时有值，否则为 null / -1 */
+	targetGroupId: string | number | null
+	targetGroupIndex: number
 	/** 这一次要加的回线数（kind 为 'channel' 时才有意义） */
 	circuits: number
 	/** 这是草稿里的第几次点击：1 拿到起点、2 拿到终点（线路结束）、0 表示不是点击 */
@@ -1876,8 +1954,8 @@ export interface GisViewChannelDraftPayload {
 	lineProps?: Partial<GisViewLine>
 	/** 逐条回线的属性（与 createChannels 同名同义）：按下标一一对应，没配为 null */
 	linePropsByMember?: Array<Partial<GisViewLine> | undefined> | null
-	/** 第二段 lineItems（一条或一批）：与 linePropsByMember 同一份写法，提交时一起交给 addChannel */
-	lineItems?: Array<Partial<GisViewLine> | undefined> | null
+	/** 第二段 lineData（一条或一批）：与 linePropsByMember 同一份写法，提交时一起交给 addChannel */
+	lineData?: Array<Partial<GisViewLine> | undefined> | null
 	channelProps?: Partial<GisViewChannel>
 	/** 这一次草稿实际生效的预览样式（全局配置 + 本次覆盖） */
 	style: GisViewChannelDraftStyle
@@ -2084,10 +2162,9 @@ export interface GisViewAddWaypointsResult {
 
 /** addChannelGroups 的一项：分组信息（id / path）外加这一组新建的线路数据 */
 export interface GisViewChannelAddGroupInput extends GisViewChannelAddGroup {
-	/** 这一组新建的线路数据（三个名字等价，写法同 addChannel 第二段） */
+	/** 这一组新建的线路数据（两个名字等价，写法同 addChannel 第二段） */
 	lineData?: GisViewChannelLineData
 	lines?: GisViewChannelLineData
-	lineItems?: GisViewChannelLineData
 }
 
 /** addChannelGroups 的返回：逐组结果、成功落地的回线 id 与新分组 id */
@@ -2188,63 +2265,33 @@ export interface GisViewChannelInView {
 	groupIds: Array<string | number>
 }
 
-/**
- * addChannel / addLine 的第二段（也是入参里的 lineItems）：一条或一批逐条回线属性，与 linePropsByMember 同义。
- * 每一项也可以只写一个 id（裸字符串 / 数字按 { id } 收），与 GisViewChannelLineData 同一份口径 ——
- * 从前这两条归一是分开的：旧写法只收对象，裸 id 被当没写（见 15.98）
- */
-export type GisViewChannelLineItems = GisViewChannelLineData
+/** 新增草稿提交时选择落点：显式方案，或 'auto' 使用草稿的推荐方案 */
+export type GisViewChannelAddResolution = 'auto' | 'newChannel' | 'newGroup' | 'joinGroup' | 'newLine' | {
+	type?: 'newChannel' | 'newGroup' | 'joinGroup' | 'newLine'
+	groupId?: string | number
+	groupIndex?: number
+	channelId?: string | number
+}
 
-/** 程序化新增通道 / 独立线路的入参：不用交互，按两个节点直接落到数据上 */
-export interface GisViewChannelAddInput {
+/** 程序化新增独立线路的入参：按两个节点生成线路，不挂通道 */
+export interface GisViewLineAddSpec {
 	from: string | number
 	to: string | number
-	/**
-	 * 缺省 / 'auto' 先新建通道、再加新分组、最后并入现有分组；也可以直接给 type 或 { groupId } / { groupIndex } 指定。
-	 * 只写 channelId 时按这条通道自己的推荐顺序挑（新分组 → 第一个能并的分组）。
-	 * kind 为 'line'（新增独立线路）时不走方案表，这一步忽略
-	 */
-	resolution?: 'auto' | 'newChannel' | 'newGroup' | 'joinGroup' | 'newLine' | { type?: 'newChannel' | 'newGroup' | 'joinGroup' | 'newLine'; groupId?: string | number; groupIndex?: number; channelId?: string | number }
-	/** 加通道还是加独立线路：'channel' 缺省，'line' 不挂通道（addLine 就是它的快捷写法） */
-	kind?: 'channel' | 'line'
-	/** 一次加几回（缺省 1）：新建通道 / 新分组 / 并入分组的余量都按它算 */
-	circuits?: number
-	/** 线路名，缺省按两端节点生成 */
+	/** 线路名，缺省按两端节点生成；一次多回时自动带序号 */
 	name?: string
-	/** 新回线 id（等价于 id）；一次加多回时按它加序号 */
-	lineId?: string | number
+	/** 第一条回线的 id 种子；一次多回时自动带序号，第二段每项也可以各写自己的 id */
 	id?: string | number
-	lineName?: string
-	/**
-	 * 新建通道时的通道 id；两个节点之间已经有通道时，它是「并进哪条通道」的筛选条件
-	 * （等价于 resolution 里只写 channelId，按这条通道自己的推荐顺序挑：新分组 → 第一个能并的分组）
-	 */
-	channelId?: string | number
-	channelName?: string
-	/**
-	 * 并进已有通道的哪一组（等价于 resolution: { type: 'joinGroup', groupId }）：
-	 * 与 groupIndex 二选一，都写按 groupId；两个节点之间还没有通道时忽略
-	 */
-	groupId?: string | number
-	/** 并进已有通道的第几组（从 0 起，与 groupId 二选一）：两个节点之间还没有通道时忽略 */
-	groupIndex?: number
+	/** 所有回线共用的业务字段（颜色 / 线宽 / 线型…） */
 	lineProps?: Partial<GisViewLine>
-	/** 逐条回线的属性：按下标一一对应（第几项就只管第几回），盖在同一条 lineProps 之上；与 createChannels 的 linePropsByMember 同名同义 */
-	linePropsByMember?: Array<Partial<GisViewLine> | undefined>
-	/**
-	 * 与回线一一对应的逐条属性（addChannel / addLine 的第二段也行）：一条或一批 —— 给了几条就建几条
-	 * （circuits 忽略），每一项盖在同一条 lineProps 与 linePropsByMember 对应项之上；
-	 * 每一项也可以只写一个 id（裸字符串 / 数字按 { id } 收）
-	 */
-	lineItems?: GisViewChannelLineItems
-	channelProps?: Partial<GisViewChannel>
-	/** 中间拐点（不含两端）：新建通道写进骨架，新建独立线路展开成完整 path；routing 为 orthogonal 时自动补拐点 */
+	/** 中间拐点；routing 为 orthogonal 时也可由它自动补拐点 */
 	path?: GisViewCoordinate[]
-	/** 走线方式：'straight'（缺省）/ 'orthogonal'（自动补一个先横后纵的 90° 拐点） */
+	/** 走线方式：'straight'（缺省）/ 'orthogonal' */
 	routing?: 'straight' | 'orthogonal'
+	/** 第二段的别名：线路数据，一条或一批 */
+	lineData?: GisViewChannelLineData
 }
 
-/** 第二段线路数据（新签名的 line_data / 旧写法的 lineItems 同一份）：对象里的 id 就是回线 id（没写的自动编号），裸字符串 / 数字等价于 { id } */
+/** 第二段线路数据（lineData）：对象里的 id 就是回线 id（没写的自动编号），裸字符串 / 数字等价于 { id } */
 export type GisViewChannelLineData = Partial<GisViewLine> | string | number | Array<Partial<GisViewLine> | string | number | undefined>
 
 /** 新签名 addChannel 第三段的一项：新通道的分组信息（id / 成员 / 中间拐点；缺省整条通道一组） */
@@ -2267,6 +2314,12 @@ export interface GisViewChannelAddSpec {
 	name?: string
 	/** 通道 id，缺省按两端节点拼 channel-<from>-<to> */
 	id?: string | number
+	/** 其余通道字段（宽度 / 偏移方式…） */
+	channelProps?: Partial<GisViewChannel>
+	/** 中间拐点（不含两端）：写进通道骨架；routing 为 orthogonal 时自动补拐点 */
+	path?: GisViewCoordinate[]
+	/** 走线方式：'straight'（缺省）/ 'orthogonal' */
+	routing?: 'straight' | 'orthogonal'
 	/** 第二段的别名（写在对象上时用它）：线路数组 line_data */
 	lineData?: GisViewChannelLineData
 	/** 第三段的别名（写在对象上时用它）：分组信息 */
@@ -2274,20 +2327,27 @@ export interface GisViewChannelAddSpec {
 }
 
 /**
- * commitAddChannel 的对象入参：可以写一份新通道 / 新线路，也可以放在 channel / line / lines 里逐段给。
- * - 直接通道对象必须带 lineIds：每个 id 生成一条新回线，groups 是分组声明；通道 id 不参与回线 id。
- * - 直接线路对象的业务字段透传到 lineProps；path 是中间拐点，首尾仍取 from / to。
- * - 容器里的 line 缺省是独立线路，lines / lineData / lineItems 才是成员回线表，且 lines 优先；
+ * commitAddChannel 的对象入参：通道 / 线路对象放在 channel / line / lines / lineData 里逐段给。
+ * - channel.lineIds 的每个 id 生成一条新回线，channel.groups 是分组声明；通道 id 不参与回线 id。
+ * - line 的业务字段透传到 lineProps；path 是中间拐点，首尾仍取 from / to。
+ * - line 缺省是独立线路，lines / lineData 才是成员回线表，且 lines 优先；
  *   空数组不覆盖草稿。channel.lineIds 只在没有成员回线表时当 id 种子。
  * - 对象里的端点、id、名称、路径、样式与分组优先于草稿；没写的字段仍沿用当前草稿。
- * - 容器顶层的 channel.lineProps 目前不参与合并；公共字段写顶层 lineProps，单条写 lines[i]。
+ * - 公共字段写顶层 lineProps，单条写 lines[i]。
  */
-export interface GisViewChannelAddCommitInput extends Partial<GisViewChannelAddInput> {
+export interface GisViewChannelAddCommitInput {
+	from?: string | number
+	to?: string | number
+	name?: string
+	/** 线路 id 种子（通道 id 写在 channel.id） */
+	id?: string | number
+	/** 这次提交选哪个落点；不写就用草稿的推荐方案 */
+	resolution?: GisViewChannelAddResolution
 	/** 本次新增的通道对象（lineIds 会作为新回线 id 种子；groups 作为分组声明） */
 	channel?: GisViewChannel
 	/** 本次新增的一条线路对象（写了它就按独立线路提交） */
 	line?: GisViewLine
-	/** 本次新增的回线对象 / 数据（一条或一批，与 lineData / lineItems 同义） */
+	/** 本次新增的回线对象 / 数据（一条或一批，与 lineData 同义） */
 	lines?: GisViewChannelLineData
 	/** lines 的别名（与 addChannel 的第二段同一个写法） */
 	lineData?: GisViewChannelLineData
@@ -2295,6 +2355,16 @@ export interface GisViewChannelAddCommitInput extends Partial<GisViewChannelAddI
 	channelGroups?: GisViewChannelAddGroup | GisViewChannelAddGroup[]
 	/** channelGroups 的别名（与 addChannel 的第三段同一个写法） */
 	group?: GisViewChannelAddGroup | GisViewChannelAddGroup[]
+	/** 所有新回线共用的业务字段 */
+	lineProps?: Partial<GisViewLine>
+	/** 逐条回线的业务字段：按下标覆盖 lineProps / lines[i] */
+	linePropsByMember?: Array<Partial<GisViewLine> | undefined>
+	/** 新通道的其余字段 */
+	channelProps?: Partial<GisViewChannel>
+	/** 中间拐点（不含两端） */
+	path?: GisViewCoordinate[]
+	/** 走线方式：'straight' / 'orthogonal' */
+	routing?: 'straight' | 'orthogonal'
 }
 
 /** 新增通道草稿端点示例点单端的样式：只写哪几项就覆盖哪几项 */
@@ -2775,11 +2845,6 @@ export interface GisViewClusterPickResult extends GisViewCluster {
 /** pick / pickAt / hover 可能拿到普通要素或聚合圆。 */
 export type GisViewHitResult = GisViewPickResult | GisViewClusterPickResult
 
-/** action.data 里的聚合读数：不带 action 自身，避免载荷循环引用。 */
-export interface GisViewClusterPointerData extends GisViewCluster {
-	type: 'cluster'
-}
-
 /** 聚合数量文字：覆盖层每帧只需要位置、半径与数量。 */
 export interface GisViewClusterLabel {
 	id: string
@@ -2788,12 +2853,12 @@ export interface GisViewClusterLabel {
 	radius: number
 }
 
-/** onClusterClick / clusterClick 的载荷：与点击载荷同一套指针字段，但不带普通要素的 item。 */
+/**
+ * onClusterClick / clusterClick 的载荷：与点击载荷同一套指针字段，但不带普通要素的 item。
+ * 鼠标键与修饰键读 `originalEvent`；选中集读数用 `getSelectionInfo()`。
+ */
 export type GisViewClusterClickPayload = GisViewClusterPickResult & {
-	button?: number
-	buttons?: number
 	originalEvent: Event
-	selection: GisViewSelectionInfo
 	action: GisViewPointerAction
 }
 
@@ -2825,18 +2890,22 @@ export interface GisViewSelectionChannelFields {
 	groupIndex?: number
 	group?: GisViewChannelGroupInfo & { groupIndex: number; lineCount: number; waypointCount: number }
 	groups?: Array<GisViewChannelGroupInfo & { groupIndex: number; lineCount: number; waypointCount: number }>
+	/** 本次选中集里属于这条通道的回线下标 / id；单通道与 channelContexts 的每项都会给 */
+	lineIndexes?: number[]
+	lineIds?: Array<string | number>
 	/** 选中集涉及多条通道时才有（按选中顺序）；单通道不创建这一份，直接读顶层平铺字段 */
 	channelContexts?: GisViewSelectionChannelContext[]
 }
 
 /** describeSelection 的返回值：要素读数 + 与选中载荷同一套通道上下文字段 */
 export interface GisViewDescribedSelection extends GisViewSelectionChannelFields {
+	/** 选中项；通道回线不重复挂通道字段，归属看外层的 lineIndexes / channelContexts */
 	items: GisViewPickResult[]
 }
 
 /** 选中事件载荷：点击选中为 0 / 1 个要素，Shift 框选为框内全部节点（随 shortcuts.boxSelect 改变） */
 export interface GisViewSelectPayload extends GisViewSelectionChannelFields {
-	/** 选中项；通道回线只带 channelId / channelIndex / groupId / groupIndex 标量归属，分组读数看顶层或 channelContexts */
+	/** 选中项；通道回线不重复挂 channelId / channelIndex / groupId / groups，归属看顶层 lineIndexes / channelContexts */
 	items: GisViewPickResult[]
 	/** 框选时的画布 CSS 像素矩形，点击选中为 null */
 	box: GisViewRect | null
@@ -2848,11 +2917,10 @@ export interface GisViewSelectPayload extends GisViewSelectionChannelFields {
 	mode?: 'single' | 'multi' | 'box'
 }
 
-/**
 /**
  * 选中集读数：ids（选中要素的 id，没有 id 的不进这里）/ count（要素条数）/
- * pointCount / lineCount / channelCount（各类型几个，通道回线按通道算一个）的**计数**版本。
- * onSelectChange、指针载荷里的 selection 与 getSelectionData() 的计数部分都是同一份口径。
+ * points / lines / channels（各类型几个，通道回线按通道算一个）的**计数**版本。
+ * onSelectChange、getSelectionInfo() 与 getSelectionData() 的计数部分都是同一份口径。
  */
 export interface GisViewSelectionInfo {
 	ids: Array<string | number>
@@ -2933,7 +3001,7 @@ export interface GisViewSelectionData {
 	lines: GisViewLine[]
 	/** 选中回线所属的通道（去重） */
 	channels: GisViewChannel[]
-	/** 与 getSelections() 同一份：带下标、坐标与通道上下文 */
+	/** 与 getSelections() 同一份：带下标与坐标，通道回线不重复挂通道字段 */
 	items: GisViewPickResult[]
 	pointIndexes: number[]
 	lineIndexes: number[]
@@ -2945,7 +3013,7 @@ export interface GisViewSelectionData {
  * 接口选中（select / clearSelection / selectInBox）也会发。
  */
 export interface GisViewSelectChangePayload extends GisViewSelectionInfo, GisViewSelectionChannelFields {
-	/** 与对应 onSelect 载荷共用同一批对象；通道回线不重复挂 group / groups */
+	/** 与对应 onSelect 载荷共用同一批对象；通道回线不重复挂 channelId / channelIndex / groupId / groups */
 	items: GisViewPickResult[]
 	/** 框选时的矩形，其余为 null */
 	box: GisViewRect | null
@@ -2955,7 +3023,7 @@ export interface GisViewSelectChangePayload extends GisViewSelectionInfo, GisVie
 	/**
 	 * 这一次操作的判读（与指针事件同一套写法）：type 细到 'select'（点中一个或接口选中）/
 	 * 'toggleSelect'（Ctrl 点击取反）/ 'boxSelect'（框选）/ 'clearSelection'（点空白、Esc 或接口清空）；
-	 * target 是 'selection'（作用在一批要素上）或 'empty'（清空成空集），data 就是这一批 items。
+	 * target 是 'selection'（作用在一批要素上）或 'empty'（清空成空集），这一批数据直接读载荷的 items。
 	 * 取反与清空这两条路不经过 onClick，要按操作分支的界面认这一个字段。
 	 */
 	action: GisViewPointerAction
@@ -2975,8 +3043,8 @@ export interface GisViewWaypointPayload {
 	phase: 'add' | 'select' | 'remove' | 'start' | 'move' | 'end'
 	/**
 	 * 这一次操作的判读：type 为 'addWaypoint' / 'removeWaypoint' / 'selectWaypoint' / 'dragWaypoint'，
-	 * target 为 'waypoint'，data 是「哪条线、第几个顶点、坐标、改完的那条线」那一份读数
-	 * （与载荷里的 lineIndex / pathIndex / coordinate / line 同一份，只是打包在一起）
+	 * target 为 'waypoint'。哪条线、第几个顶点、坐标与改完的那条线直接读载荷顶层的
+	 * lineIndex / pathIndex / coordinate / line。
 	 */
 	action?: GisViewPointerAction
 	lineIndex: number
@@ -3030,15 +3098,11 @@ export interface GisViewChannelGroupChangePayload {
 /**
  * 点击与双击事件载荷，点击空白处时载荷为 null。
  * selected 是点完之后的状态、wasSelected 是点之前的状态（Ctrl 点击是取反之前），
- * selection 是点完之后整个选中集的读数 —— 左键要自己接一套操作时看这三个就够。
+ * 选中集读数用 getSelectionInfo()，鼠标键与修饰键读 originalEvent。
  */
 export interface GisViewClickPayload extends GisViewPickResult {
-	/** 鼠标按键：0 左键、1 中键、2 右键（与指针载荷同一份口径，单击 / 双击都是从 pointerup 判出来的） */
-	button?: number
-	buttons?: number
+	/** 原始点击事件：button / buttons / 修饰键与 clientX / clientY 都从这里读 */
 	originalEvent: Event
-	/** 点完之后整个选中集的读数（ids / count / 各类型条数，通道回线按通道算一个） */
-	selection: GisViewSelectionInfo
 	/**
 	 * 这一次点击的判读：type 为 'select'（点中要素、选中已生效）或 'click'（没开选中时的普通点击），
 	 * 多选取反生效时是 'toggleSelect'；double 为 true 说明这一下是双击里的第二下。点空白处的载荷是 null，
@@ -3087,18 +3151,11 @@ export type GisViewPointerActionType =
 	| 'drag'
 	| 'pointer'
 
-/** 修饰键：与原生事件上的 ctrlKey / metaKey（⌘）/ shiftKey / altKey 一一对应 */
-export interface GisViewPointerModifiers {
-	ctrl: boolean
-	meta: boolean
-	shift: boolean
-	alt: boolean
-}
-
 /**
- * 一次指针操作的类型化判读：`action.type` 回答「这是什么操作」、`action.target` 回答「点在什么上面」、
- * `action.data` 回答「能拿到什么数据」。画布上的指针事件、拐点、标签、选中集共用这一套写法 ——
- * 使用方按 action.type / action.target 分支就够，不必自己按事件名分别记一套。
+ * 一次指针操作的类型化判读：`action.type` 回答「这是什么操作」、`action.target` 回答「点在什么上面」。
+ * 原始输入不在这里重复：鼠标键 / 修饰键 / clientX / clientY 读载荷的 `originalEvent`，
+ * 命中的数据读载荷自己的 `item`、`channelContext`、`items` 等字段。
+ * 画布上的指针事件、拐点、标签、选中集共用这一套写法。
  */
 export interface GisViewPointerAction {
 	type: GisViewPointerActionType
@@ -3108,18 +3165,6 @@ export interface GisViewPointerAction {
 	 * 点击 / 右键 / 选中集事件恒为 false，拐点拖动事件里 start 为 false、move / end 为 true。
 	 */
 	moved: boolean
-	/** 鼠标键名（left / middle / right），与载荷里的 button 数字一一对应；悬停没有按键，固定是 'none' */
-	button?: 'left' | 'middle' | 'right' | 'none' | string
-	/** 左键 / 右键两个布尔：判「是哪一只手」写 action.right 比比对字符串更直白（中键两个都是 false） */
-	left?: boolean
-	right?: boolean
-	modifiers?: GisViewPointerModifiers
-	/**
-	 * 按 target 直接取到的那一份数据：点 / 线是数据里那个对象（与 getData() 同一份引用）、
-	 * 通道回线是通道定义、选中集事件是这一批 items、拐点是「哪条线、第几个顶点、坐标、改完的线」，
-	 * 空白处是 null（拐点那一份见 GisViewWaypointPayload.action.data、标签那一份见 GisViewLabelActionData）。
-	 */
-	data?: GisViewPoint | GisViewLine | GisViewChannel | GisViewClusterPointerData | GisViewPickResult[] | GisViewWaypointActionData | GisViewLabelActionData | null
 	/** 只在 click 载荷里出现：true 说明这一下是双击里的第二下（单双击要分开做事的界面按它推迟一下） */
 	double?: boolean
 	/**
@@ -3133,20 +3178,6 @@ export interface GisViewPointerAction {
 	longPress?: boolean
 }
 
-/** 拐点事件 action.data 的那一份读数：哪条线、第几个顶点、坐标与改完的那条线（与载荷里的同名字段同一份） */
-export interface GisViewWaypointActionData {
-	lineIndex: number
-	pathIndex: number
-	coordinate: [number, number]
-	line: GisViewLine
-}
-
-/** 标签事件 action.data 的那一份读数：这一条标签的读数与它挂在哪条要素上（drag / click / 右键 / 双击都认） */
-export interface GisViewLabelActionData {
-	label: GisViewLabelInfo | null
-	parent: GisViewLabelParent | null
-}
-
 /**
  * 通用指针载荷：左键按下 / 抬起、右键都会发一条。
  * 命中的要素（点 / 线 / 通道回线）在 type / index / item 与通道字段里，没有命中时 type 为 null、hit 为 false；
@@ -3155,7 +3186,7 @@ export interface GisViewLabelActionData {
 export interface GisViewPointerPayload {
 	/**
 	 * 这一次操作的判读：按下时 type 是意图、松开时是刚做完的那件事、右键固定是 'contextMenu'；
-	 * target 说明点的是点 / 线 / 通道 / 空白，data 直接给到那一份数据（左键 / 右键都认这一份）
+	 * target 说明点的是点 / 线 / 通道 / 空白；命中的数据直接读载荷的 item / channel / channelContext 等字段。
 	 */
 	action: GisViewPointerAction
 	/** 命中的要素类型，空白处为 null；多成员聚合是 'cluster' */
@@ -3170,9 +3201,6 @@ export interface GisViewPointerPayload {
 	screen?: [number, number]
 	/** 命中的要素自身的世界坐标 */
 	coordinate?: [number, number]
-	/** 命中的是线路（含通道回线）时，线路在 lines 数组里的下标与 id；右键菜单按它找线路 */
-	lineIndex?: number
-	lineId?: string | number
 	/** 命中的是通道内的回线时，回线所属通道与分组 */
 	channelIndex?: number
 	channel?: GisViewChannel
@@ -3198,11 +3226,10 @@ export interface GisViewPointerPayload {
 	selected?: boolean
 	/** 见 selected：左键按下 / 右键这一路上两份是同一个值（点击载荷里才是「点之前 / 点之后」） */
 	wasSelected?: boolean
-	/** 这一刻整个选中集的读数（右键弹自己的面板时按它决定面板内容） */
-	selection?: GisViewSelectionInfo
-	/** 鼠标按键：0 左键、1 中键、2 右键 */
-	button: number
-	buttons: number
+	/*
+	 * 选中集读数用 getSelectionInfo()；鼠标键与修饰键用 originalEvent.button / buttons / ctrlKey /
+	 * metaKey / shiftKey / altKey。lineIndex 就是 index，线路 id 读 item.id 或 getLineChannel(index)。
+	 */
 	/** 光标处的世界坐标 */
 	world: [number, number]
 	/** 配了 GeoJSON 底图时，光标位置对应的真实经纬度（含 aspectScale 反算） */
@@ -3210,16 +3237,15 @@ export interface GisViewPointerPayload {
 	/** 光标处的画布 CSS 像素 */
 	x: number
 	y: number
-	clientX: number
-	clientY: number
+	/** 原始指针 / 鼠标事件：button / buttons / 修饰键 / clientX / clientY 都从这里读 */
 	originalEvent: PointerEvent | MouseEvent
 }
 
 /**
  * 悬停载荷（onHover 与 hoverAt 的读数，没有悬停到东西时是 null）：
  * 与指针载荷同一层 —— 命中的要素在 type / index / item 与通道字段里，光标位置在 x / y / world 里，
- * 另外带一份 action（type 恒为 'hover'、target 说明停在什么上面、button 恒为 'none'）。
- * 光标正好停在最近一次指针事件的位置上时，originalEvent / clientX / clientY 就是那一次事件（修饰键读得到）。
+ * 另外带一份 action（type 恒为 'hover'、target 说明停在什么上面）。
+ * 光标正好停在最近一次指针事件的位置上时，originalEvent 就是那一次事件（按键 / 修饰键 / 指针位置都读得到）。
  */
 export type GisViewHoverPayload = GisViewHitResult & {
 	/** 悬停读数一样有：有没有停在某个要素上（空白处是 null，不走这一份） */
@@ -3230,12 +3256,8 @@ export type GisViewHoverPayload = GisViewHitResult & {
 	y: number
 	/** 光标处的世界坐标 */
 	world: [number, number]
-	clientX?: number
-	clientY?: number
 	/** 光标就停在这一次指针事件的位置上时给出（程序化悬停 hoverAt 不带） */
 	originalEvent?: PointerEvent | MouseEvent | null
-	/** 此刻整个选中集的读数（与指针载荷里的 selection 同一份） */
-	selection?: GisViewSelectionInfo
 }
 export type GisViewCursorPayload = [number, number] | null
 
@@ -3286,8 +3308,6 @@ export interface GisViewPointCopyPayload {
 	index: number
 	/** 复制出来的节点：预览中就是含最新落点的那一份 */
 	item: GisViewPoint
-	/** item 的别名，与其它载荷的写法对齐 */
-	point: GisViewPoint
 	/** 来源节点；剪贴板这条的来源下标为 -1（快照还在） */
 	source: GisViewCopySource | null
 	/** 整组来源（clipboard 与多选复制时给全；普通 Alt 复制只有 source 一项） */
@@ -3308,8 +3328,6 @@ export interface GisViewPointCopyPayload {
 	/** 快照是否带上内部线路 / 通道 */
 	withLines?: boolean
 	withChannels?: boolean
-	/** 复制出来的节点当前落在的世界坐标 */
-	coordinate: [number, number] | null
 	/** 光标在画布内的 CSS 像素位置 */
 	screen: [number, number] | null
 	originalEvent: Event | null
@@ -3322,8 +3340,6 @@ export interface GisViewPointCopyPayload {
 	invalidated: boolean
 	/** 改复制节点的数据（字段级合并，坐标仍以预览落点为准），返回改完的节点 */
 	update(patch: Partial<GisViewPoint>): GisViewPoint | null
-	/** 等价于 update */
-	setItem(patch: Partial<GisViewPoint>): GisViewPoint | null
 	/** 取消这次复制：预览撤掉，数据不落地 */
 	cancel(): GisViewPointCopyPayload | null
 	/** 落地这次复制（interaction 结束后可以直接调） */
@@ -3411,13 +3427,11 @@ export interface GisViewBatchCopyPayload {
 	/** 屏幕像素偏移量 */
 	offsetScreen: [number, number]
 	anchor: [number, number]
-	coordinate: [number, number] | null
 	screen: [number, number] | null
 	originalEvent: Event | null
 	cancelled: boolean
 	invalidated: boolean
 	update(patch?: Partial<GisViewPoint>): GisViewPoint | null
-	setItem(patch?: Partial<GisViewPoint>): GisViewPoint | null
 	/** 撤销整批（等价于 revert） */
 	cancel(): GisViewBatchCopyPayload | null
 	/** 已经落地，原样返回这份载荷 */
@@ -3553,7 +3567,8 @@ export interface GisViewPointMergePayload {
 	/** 合并后保留谁：'target'（缺省，碰撞目标）或 'source'（当前拖动的来源节点）；确认时传 confirm({ keep }) */
 	keep: GisViewMergeKeep
 	/**
-	 * confirm 阶段的合并结果（按 keep 决定的保留端优先、另一端独有字段带过来、尺寸取双方最大、图标优先保留端）：
+ * confirm 阶段的合并结果（按 keep 决定的保留端业务字段优先、merge.maxKeys 列出的字段取双方最高值、
+ * 尺寸取双方最大、图标用保留端）：
 	 * 改它就是改合并结果；其余阶段为 null。confirm({ item }) 可以只给要改的字段，组件先算缺省结果再合并这份补丁
 	 */
 	item: GisViewPoint | null
@@ -3654,7 +3669,7 @@ export type GisViewMergeSelectedOutcome = GisViewMergeSelectedPayload
 
 /** mergeSelectedPoints 改写每一对最终节点时的上下文：merged / item 是缺省合并结果 */
 export interface GisViewMergeSelectedItemContext {
-	/** 缺省合并结果（目标优先、来源独有字段带过来） */
+/** 缺省合并结果（保留节点的业务字段优先，merge.maxKeys 列出的字段取双方最高值） */
 	item: GisViewPoint
 	/** item 的别名 */
 	merged: GisViewPoint
@@ -3708,6 +3723,17 @@ export interface GisViewSplitPointOptions {
 	keepSourceId?: boolean
 	/** 这一步历史的标签，缺省「拆分节点」 */
 	label?: string
+	/**
+	 * 没在 parts[].lines 里显式分配的线路怎么分：first 全跟第一份（缺省，兼容旧行为）；
+	 * alternate 按「通道成组、独立线路单条」为单位轮流给负载最少的一份 —— 同一条通道的成员不会被拆散，
+	 * 解除合并时推荐用它
+	 */
+	autoLines?: 'first' | 'alternate'
+	/**
+	 * 拆分 / 自动解除合并后是否选中结果节点：缺省 false（只移除来源节点的选中态，不动其它无关选中）；
+	 * true 时选中 parts 对应的全部节点
+	 */
+	select?: boolean
 }
 
 /** 拆分时没认出来的线路 / 通道引用 */
@@ -3730,6 +3756,15 @@ export interface GisViewSplitPointChangeSet {
 	removedChannels: GisViewChannel[]
 }
 
+/** splitPoint 自动 / 显式分配之后，每一份节点接到的线路读数 */
+export interface GisViewSplitPointLineAssignment {
+	/** 第几份（与 items / pointIds 同序） */
+	index: number
+	pointId: string | number
+	lineIds: Array<string | number>
+	lineCount: number
+}
+
 /** splitPoint 的返回：ok 为 false 时 reason 说明原因，其余数组为空、changes 为 null */
 export interface GisViewSplitPointOutcome {
 	ok: boolean
@@ -3747,6 +3782,16 @@ export interface GisViewSplitPointOutcome {
 	removedChannels: number
 	removedChannelIds: Array<string | number>
 	skipped: { lines: GisViewSplitPointSkip[]; channels: GisViewSplitPointSkip[] }
+	/** 这一次采用的自动分线口径 */
+	autoLines: 'first' | 'alternate'
+	/** 由 autoLines 自动分配（没有显式写 lines）的线路条数 */
+	autoAssignedLines: number
+	/** 每一份最终接到哪些线路（含显式分配与自动分配） */
+	lineAssignments: GisViewSplitPointLineAssignment[]
+	/** 这次是否走了 mergeInfo 自动解除合并（省略 parts 且节点带合并记录时为 true） */
+	autoRestored: boolean
+	/** 自动解除时恢复的全部来源节点 id（手工拆分时为空数组） */
+	mergeSourceIds: Array<string | number | null>
 	changes: GisViewSplitPointChangeSet | null
 }
 
@@ -4204,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 也始终按候选落点画出；缺省跟随全局 */
@@ -4305,6 +4362,12 @@ export interface GisViewLabelOptions {
 	className?: string
 	/** 标签的内联样式 */
 	style?: Record<string, string>
+	/** 标签层级：越大越靠上；不写时是 0 */
+	zIndex?: number
+	/** 跟随节点样式链里的 zIndex（显式 zIndex 优先）；更高层的节点会把标签盖住 */
+	followNodeZIndex?: boolean
+	/** 字号跟随地图缩放的指数：0 固定屏幕字号（默认），1 与地图同倍率 */
+	zoomScale?: number
 }
 
 /** 线路标签内容函数的入参 */
@@ -4393,6 +4456,10 @@ export interface GisViewLineLabelOptions {
 	className?: string
 	/** 标签的内联样式 */
 	style?: Record<string, string>
+	/** 标签层级：越大越靠上；不写时是 0 */
+	zIndex?: number
+	/** 字号跟随地图缩放的指数：0 固定屏幕字号（默认），1 与地图同倍率 */
+	zoomScale?: number
 }
 
 /** 标签类别：节点标签 / 线路标签 */
@@ -4424,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 */
@@ -4450,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
 }
 
 /**
@@ -4469,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 的那一条覆盖 */
@@ -4526,12 +4611,11 @@ export interface GisViewLabelDragPayload {
 	state?: GisViewLabelState | null
 	/** 这一条标签对应的要素在不在当前选中集里 */
 	selected: boolean
-	selection: GisViewSelectionInfo
 	/** 停手那一条带 true（说明这一路是拖过来而不是点选）；start / move 上没有这个字段 */
 	moved?: boolean
 	/** 触发起手 / 移动 / 停手的原始指针事件（宿主按它读修饰键与指针位置） */
 	originalEvent?: PointerEvent | MouseEvent | null
-	/** 这一次拖动的判读：type 为 'dragLabel'、target 为 'label'、data 是这一条标签 */
+	/** 这一次拖动的判读：type 为 'dragLabel'、target 为 'label'；标签与 parent 读载荷顶层 */
 	action?: GisViewPointerAction
 }
 
@@ -4551,15 +4635,14 @@ export interface GisViewLabelClickPayload {
 	/** 这一条当前的覆盖读数，没改过是 null */
 	state: GisViewLabelState | null
 	selected: boolean
-	selection: GisViewSelectionInfo
 	/** 触发这一下的原始指针事件（点选是 pointerup；拖动路径里「没挪动」那条也是 pointerup） */
 	originalEvent?: PointerEvent | MouseEvent | null
-	/** 这一次点选的判读：type 为 'selectLabel'、target 为 'label'、data 是这一条标签 */
+	/** 这一次点选的判读：type 为 'selectLabel'、target 为 'label'；标签与 parent 读载荷顶层 */
 	action?: GisViewPointerAction
 }
 
 /**
- * 标签上的右键 / 双击载荷：与 labelClick 同一份读数（label / parent），另带指针位置与原始 DOM 事件。
+ * 标签上的右键 / 双击载荷：与 labelClick 同一份读数（label / parent）；指针位置、按键与修饰键读 originalEvent。
  * `label.draggable` / `label.editable`（线路标签同一套开关）任开一个的标签都会发。
  */
 export interface GisViewLabelPointerPayload {
@@ -4576,15 +4659,11 @@ export interface GisViewLabelPointerPayload {
 	/** 这一条当前的覆盖读数，没改过是 null */
 	state: GisViewLabelState | null
 	offset: [number, number]
-	/** 指针在视口里的位置（右键菜单按它定位；双击时是双击那一下的位置） */
-	clientX: number
-	clientY: number
-	/** 原始 DOM 事件（contextmenu / dblclick）：要 preventDefault 或读别的字段时用它 */
+	/** 原始 DOM 事件（contextmenu / dblclick）：指针位置、按键、修饰键都从这里读 */
 	originalEvent: MouseEvent | null
 	/** 这一条标签对应的要素在不在当前选中集里 */
 	selected: boolean
-	selection: GisViewSelectionInfo
-	/** 这一次操作的判读：type 为 'contextMenu' / 'dblClick'、target 为 'label'、data 是这一条标签 */
+	/** 这一次操作的判读：type 为 'contextMenu' / 'dblClick'、target 为 'label'；标签与 parent 读载荷顶层 */
 	action?: GisViewPointerAction
 }
 
@@ -4636,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
@@ -5513,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
@@ -5561,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
 }
@@ -5588,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
@@ -6049,8 +6178,8 @@ export interface GisViewBatchOptions {
 /**
  * 全部可订阅事件（与 EVENT_NAMES 一致）：事件名与 options 里的回调一一对应（`dataChange` 就是 `onDataChange`），
  * 载荷也是同一份 —— 区别只在写法：`on` 可以挂多条、可以运行时订阅、返回的函数就是取消订阅。
- * 需要原样带回 DOM 事件的那三个（pointerDown / pointerUp / contextMenu）载荷是
- * `{ payload, event }`，与回调的两个参数一一对应。
+ * 指针类事件（pointerDown / pointerUp / contextMenu）与回调收到的是同一份直接载荷，
+ * 原始 DOM 事件看 payload.originalEvent。
  */
 export interface GisViewEventMap {
 	/** 初始化完成：拿到画布与 WebGL 上下文 */
@@ -6062,12 +6191,14 @@ export interface GisViewEventMap {
 	/** 视口尺寸 / 显示比例变化（画布按新尺寸重铺之后才发） */
 	viewport: GisViewViewport
 	cameraChange: GisViewCamera
+	/** 用户在这段时间内没有指针 / 滚轮 / 键盘操作（每个空闲段只发一次） */
+	idle: GisViewIdlePayload
 	cursor: GisViewCursorPayload
 	hover: GisViewHoverPayload
 	pointer: GisViewPointerState
-	pointerDown: { payload: GisViewPointerPayload; event: PointerEvent }
-	pointerUp: { payload: GisViewPointerPayload; event: PointerEvent }
-	contextMenu: { payload: GisViewPointerPayload; event: MouseEvent }
+	pointerDown: GisViewPointerPayload
+	pointerUp: GisViewPointerPayload
+	contextMenu: GisViewPointerPayload
 	click: GisViewClickPayload
 	/** 点中多成员聚合圆：不选中内部节点，普通 click 不会同时触发 */
 	clusterClick: GisViewClusterClickPayload
@@ -6240,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'）、开关表或布尔值 ——
@@ -6324,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 等维护 */
@@ -6511,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
@@ -6564,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 }：
@@ -6580,6 +6732,11 @@ export interface GisViewOptions {
 	 * 读数不需要 60Hz，节流能省下每帧一次的回调与对象分配（拖拽时尤其明显）。
 	 */
 	statsInterval?: number
+	/**
+	 * 用户操作空闲阈值（毫秒）：根节点上这么久没有指针 / 滚轮 / 键盘活动就发一次 idle，
+	 * 每个空闲段只发一次；0 / 不写表示关闭。运行中用 getIdleTime() 读当前空闲时长。
+	 */
+	idleTimeout?: number
 	/**
 	 * onRender 的节流间隔（毫秒），默认 400；配 0 与 onStats 同拍
 	 * （再配上 statsInterval: 0 就是每帧一条）。
@@ -6629,7 +6786,7 @@ export interface GisViewOptions {
 	/** 单击要素或空白处 */
 	onClick?: (payload: GisViewClickPayload | null) => void
 	/** 点中多成员聚合圆：载荷带 count / pointIds / bounds；不会同时触发 onClick，也不改选中集 */
-	onClusterClick?: (payload: GisViewClusterClickPayload, event: Event) => void
+	onClusterClick?: (payload: GisViewClusterClickPayload) => void
 	/** 双击要素或空白处 */
 	onDblClick?: (payload: GisViewClickPayload | null) => void
 	/** 点了一下标签（label.editable / lineLabel.editable 打开时）：载荷里是这一条标签的类型、下标与当前覆盖 */
@@ -6640,20 +6797,20 @@ export interface GisViewOptions {
 	onLabelChange?: (payload: GisViewLabelChangePayload) => void
 	/**
 	 * 在标签上按右键（label.draggable / label.editable 任开一个时）：载荷与 onLabelClick 同一份读数，
-	 * 另带 clientX / clientY（菜单按它定位）与原始 contextmenu 事件。系统菜单按 preventContextMenu 收
+	 * 指针位置、按键与修饰键读 originalEvent。系统菜单按 preventContextMenu 收
 	 */
 	onLabelContextMenu?: (payload: GisViewLabelPointerPayload) => void
 	/** 双击标签（开关同上）：载荷与 onLabelContextMenu 同一份（原始事件是 dblclick） */
 	onLabelDblClick?: (payload: GisViewLabelPointerPayload) => void
-	/** 左键 / 中键 / 右键按下：命中的要素、按钮与光标位置都在载荷里 */
-	onPointerDown?: (payload: GisViewPointerPayload, event: PointerEvent) => void
+	/** 左键 / 中键 / 右键按下：命中的要素与光标位置在载荷里，原生的键 / 修饰键读 payload.originalEvent */
+	onPointerDown?: (payload: GisViewPointerPayload) => void
 	/** 左键 / 中键 / 右键抬起：与 onPointerDown 成对 */
-	onPointerUp?: (payload: GisViewPointerPayload, event: PointerEvent) => void
+	onPointerUp?: (payload: GisViewPointerPayload) => void
 	/**
 	 * 右键：点、线、通道、空白都会发这一条。命中通道回线时 action.target 为 'channel'，
 	 * 载荷另带 channelContext；要自己弹菜单就在这里 preventDefault()。
 	 */
-	onContextMenu?: (payload: GisViewPointerPayload, event: MouseEvent) => void
+	onContextMenu?: (payload: GisViewPointerPayload) => void
 	/** 点击级联高亮变了：载荷与 getCascadeHighlight() 同一份，收掉时是 null */
 	onCascadeHighlight?: (payload: GisViewCascadeHighlightInfo | null) => void
 	onHover?: (payload: GisViewHoverPayload) => void
@@ -6664,7 +6821,7 @@ export interface GisViewOptions {
 	onPointDrag?: (payload: GisViewPointDragPayload) => void
 	/**
 	 * 复制节点：start / move / commit / end / cancel（复制到剪贴板时另有 clipboard）。
-	 * 在 commit 阶段可以 payload.cancel() 取消、payload.update() / setItem() 改数据，落地后 payload 里带 index 与最新 item
+	 * 在 commit 阶段可以 payload.cancel() 取消、payload.update() 改数据，落地后 payload 里带 index 与最新 item
 	 */
 	onPointCopy?: (payload: GisViewPointCopyPayload | GisViewBatchCopyPayload) => void
 	/**
@@ -6690,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
@@ -6840,8 +6999,6 @@ export interface GisViewFocusOptions {
 	scale?: number
 	/** 显式要求按目标范围适应视图；**缺省不缩放**，只把中心移到目标上 */
 	zoom?: boolean
-	/** 显式只居中、比例一点不动（与缺省行为一致，保留旧写法） */
-	center?: boolean
 	/** 按范围适应视图（zoom: true）时四周的留白（CSS 像素），缺省 40 */
 	padding?: number
 	/** 适应视图（zoom: true）时最多放大到多少比例：单个节点 / 一条直线没有面积，靠它决定要不要放大 */
@@ -7092,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 + 四至范围那几列）/
@@ -7470,6 +7633,8 @@ export interface GisViewSceneSnapshot {
 	regions: GisViewSceneRegion[]
 	/** 数据线路与节点装饰连接线（连接线也画在节点 / 装饰之前） */
 	lines: GisViewSceneLine[]
+	/** 抬层的选中线路：画在普通节点之后、抬层节点之前 */
+	raisedLines: GisViewSceneLine[]
 	points: GisViewSceneNode[]
 	clusters: GisViewSceneCluster[]
 	backgroundPoints: GisViewSceneNode[]
@@ -7679,8 +7844,8 @@ export interface GisViewInstance {
 	zoomToBounds(bounds: GisViewBounds, padding?: number): GisViewInstance
 	/**
 	 * 把视角移到目标上（见 GisViewFocusTargets）：一个或一批都行，一批时取整体包围盒 ——
-	 * 搜到三个节点就是这三个点之间的中心当屏幕中心。`{ center: true }` 只居中不改比例、
-	 * `{ scale }` 按给定比例居中、缺省按范围适应视图（`padding` / `maxZoom` 可调），
+	 * 搜到三个节点就是这三个点之间的中心当屏幕中心。缺省只居中、比例不变；`{ zoom: true }`
+	 * 按目标范围适应视图（`padding` / `maxZoom` 可调），`{ scale }` 按给定比例居中，
 	 * `{ select: true, mode }` 顺手把这些要素选上。认不出目标时什么都不做，返回实例便于链式调用。
 	 */
 	focusOn(target: GisViewFocusTargets, options?: GisViewFocusOptions): GisViewInstance
@@ -7706,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 是「刚好铺满小图」 */
@@ -7813,7 +7988,7 @@ export interface GisViewInstance {
 	 * 程序化悬停（参数就是鼠标事件里的 clientX / clientY）：让指针「停」到这个位置上 ——
 	 * 悬停高亮、光标与 onHover 都按它更新（外部列表 / 表格 hover 到某一行时联动高亮图上的要素）。
 	 * 不走悬停阈值，也不用先订阅一遍事件再把最近一次载荷记住；那儿没有命中要素时返回 null。
-	 * 返回的读数与 onHover 载荷同一份（action / selection / lngLat 都补齐了）。想撤掉用 clearHover()
+	 * 返回的读数与 onHover 载荷同一份（action / lngLat 都补齐了）。想撤掉用 clearHover()
 	 */
 	hoverAt(clientX: number, clientY: number): GisViewHoverPayload | null
 	/** 取消程序化悬停：清掉高亮与读数并补发一条 onHover(null)；没有悬停着的东西时什么都不做 */
@@ -7861,8 +8036,18 @@ export interface GisViewInstance {
 	 * onSelect 与 onSelectChange（cause: api）。
 	 */
 	deselect(refs?: GisViewSelectionRefs): GisViewInstance
-	/** 当前选中集的原始条目（`{ type, index, item, ... }`，与指针载荷同一份口径），不做整理、不读包围盒 */
+	/**
+	 * 当前选中集的原始条目（`{ type, index, item, ... }`），不做整理、不读包围盒。
+	 * 通道回线不带 channelId / channelIndex / groupId / groups；归属看选中事件的顶层
+	 * lineIndexes / channelContexts，或对单条线路调 getLineChannel()。
+	 */
 	getSelections(): GisViewPickResult[]
+	/**
+	 * 当前选中集的轻量计数：ids / count / points / lines / channels，与 onSelectChange 顶层的同名字段
+	 * 是同一份口径（通道回线按通道算一个）。指针 / 点击 / 悬停载荷不再重复挂 selection，需要这份读数时调它；
+	 * 结果按选中集引用缓存，十万级选中下也只是一次读取。要要素对象或包围盒时再用 getSelectionData()。
+	 */
+	getSelectionInfo(): GisViewSelectionInfo
 	/**
 	 * 这一个要素在不在当前选中集里：`isSelected('p-1')` 按 id 问、
 	 * `isSelected({ type: 'point', index: 3 })` 按下标问。
@@ -7873,7 +8058,7 @@ export interface GisViewInstance {
 	/**
 	 * 当前画布上选中的数据（一次取全）：ids / count 与各类型条数（通道回线按通道算一个）、
 	 * 要素本身 points / lines / channels 三个数组、下标清单 pointIndexes / lineIndexes、
-	 * items（与 getSelections() 同一份）与世界包围盒 bounds（空选中时 null）。
+	 * items（与 getSelections() 同一份，通道回线不重复挂通道字段）与世界包围盒 bounds（空选中时 null）。
 	 * 单击、Ctrl 多选、框选与接口选中（selectFeatures / selectInBox）都是同一份 state，不挑选中来源；
 	 * bounds 走一次 getElementBounds（十万级选中下约 5 ms），只想问「选了哪几个」用 getSelections() 更省
 	 */
@@ -7895,7 +8080,7 @@ export interface GisViewInstance {
 	commitPointCopy(): GisViewPointCopyPayload | null
 	/** 取消复制：预览撤掉，数据一直没动过 */
 	cancelPointCopy(): GisViewPointCopyPayload | null
-	/** 改预览节点的数据（等价于回调里的 payload.update / setItem），返回改完的节点 */
+	/** 改预览节点的数据（等价于回调里的 payload.update），返回改完的节点 */
 	updateCopyPoint(patch: Partial<GisViewPoint>): GisViewPoint | null
 	/** 当前复制状态：预览中 / 等选点；没有就返回 null */
 	getPointCopy(): GisViewPointCopyState | null
@@ -7926,22 +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 末尾。
-	 * 每份可直接写节点字段或放进 item；lines 分配线路（不写时连在原节点上的线路跟第一份），
+	 * 把一个节点拆成多份（mergePoints 的逆操作）：parts 省略 / null / [] 且节点带 mergeInfo 时自动解除合并，
+	 * 恢复全部来源节点与合并前的线路 / 通道；给 parts 时第一份复用原下标与 id，其余追加到 points 末尾。
+	 * 每份可直接写节点字段或放进 item；lines 显式分配线路，没写时默认跟第一份，
+	 * options.autoLines 为 'alternate' 时按「通道成组、独立线路单条」轮流分给负载最少的一份（解除合并推荐）。
 	 * channels / channelFrom / channelTo 分配受影响通道的端点。没显式分配的通道跟随它第一条被分配过的成员线路。
 	 * 拆分后自环 / 零长度线路与两端相同的通道删掉；整次调用只记一条历史、只发一条 `splitPoint` 数据变更。
-	 * 返回 `{ ok, items, indexes, pointIds, linesChanged, removedLines, channelsChanged, removedChannels, changes, skipped }`
+	 * 返回 `{ ok, items, indexes, pointIds, linesChanged, removedLines, channelsChanged, removedChannels,
+	 * 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 给定，
@@ -8073,10 +8263,18 @@ export interface GisViewInstance {
 	 * （phase: 'ready'，载荷里带两个节点、hasChannel / hasGroup / groups / channel 与可选方案）。
 	 * 它只负责这条可视化示例路径 —— 真正的落地必须用 addChannel（或 addChannelGroupLines /
 	 * joinChannelGroupLines / addLine），不在事件里落地就用 endAddChannel / cancelAddChannel 收掉假通道。
-	 * options.kind 为 'line' 时改成「新建独立线路」（不挂通道），options.circuits 决定一次加几回，
-	 * options.select 打开「点节点时让节点选中」，options.handoff 让 ready 之后草稿自动收掉
+	 * 新建独立线路请用 beginAddLine；options.circuits 决定一次加几回，
+	 * options.select 打开「点节点时让节点选中」，options.handoff 让 ready 之后草稿自动收掉。
+	 * options.singleChannel 打开单一通道模式；已有通道时 existingChannel 为 block / newGroup / joinGroup，
+	 * joinGroup 用 groupId / groupIndex 指名分组。没有已有通道时仍按新通道落地
 	 */
 	beginAddChannel(options?: GisViewChannelDraftOptions): GisViewInstance
+	/**
+	 * 进入「新增线路」草稿：拾取、预览、连续新增和 beginAddChannel 同一套，kind 恒为 line。
+	 * 不写 existingChannel 时只新建独立线路；写 newGroup / joinGroup 时，如果两端已有通道，就把这次
+	 * 新建的回线放进新分组或指定分组（joinGroup 用 groupId / groupIndex 指名）。
+	 */
+	beginAddLine(options?: GisViewChannelDraftOptions): GisViewInstance
 	/** 当前新增通道草稿：两个节点的信息与可选方案，没有草稿时为 null */
 	getAddChannelDraft(): GisViewChannelDraftPayload | null
 	/** 改当前草稿的预览样式（字段级合并，传 null 回到全局 channelDraftStyle）；没有草稿时什么也不做 */
@@ -8088,21 +8286,18 @@ export interface GisViewInstance {
 	/** 结束新增草稿并收掉视图上的示例假通道 / 线路（静默，不补 cancel）：提前结束不新建就用它 */
 	endAddChannel(): GisViewInstance
 	/**
-	 * 提交已 ready 的新增草稿（autoCommit 时由组件内部调用）。input 有五类写法：
+	 * 提交已 ready 的新增草稿（autoCommit 时由组件内部调用）。input 只有一类写法：
 	 * 1. 不传 / null：用草稿的 preferred；
-	 * 2. 旧 resolution：字符串，或只含 type / groupId / groupIndex / channelId 的对象；
-	 * 3. 直接线路对象：无 lineIds，且有 from / to / path / kind: 'line' / start / end 之一；
-	 * 4. 直接通道对象：lineIds 为数组，缺省按 newChannel 落地；
-	 * 5. 容器：{ channel, line, lines, lineData, lineItems, channelGroups, group, channelProps, lineProps, resolution, ... }。
+	 * 2. 对象：{ channel, line, lines, lineData, channelGroups, group, channelProps, lineProps, resolution, ... }。
 	 *
-	 * 字段优先级：from / to = 顶层 → channel → line → lineItems 中第一个对象项 → 草稿；
+	 * 字段优先级：from / to = 顶层 → channel → line → lines 中第一个对象项 → 草稿；
 	 * path = 顶层 → line → channel → 草稿；分组 = channelGroups → group → channel.groups；
-	 * 容器 lineProps = 草稿 → 顶层 → line.lineProps → lines[i]（不读 channel.lineProps）；
-	 * channelProps = 草稿 → channel 上的业务字段 → 顶层 channelProps。直接通道对象自己的 lineProps 会生效。
+	 * lineProps = 草稿 → 顶层 → line.lineProps → lines[i]；channelProps = 草稿 → channel 上的业务字段 → 顶层 channelProps。
 	 *
-	 * 直接通道默认新建；要并进已有通道 / 分组，用容器并显式写 resolution。
+	 * 要并进已有通道 / 分组，显式写 resolution；直接通道 / 线路对象不再接受，请放进 channel / line。
 	 * ready 里的方案对象带 enabled / count / lineIds 等读数，不能整条回传，只取
 	 * `{ type, groupId, groupIndex, channelId }` 子集。调用前草稿必须 ready，否则返回 ok: false 且不写数据。
+	 * options.select 为 true 时落地后选中这次新建的全部回线，缺省不动选中集。
 	 *
 	 * ```ts
 	 * view.commitAddChannel({
@@ -8113,8 +8308,8 @@ export interface GisViewInstance {
 	 * ```
 	 */
 	commitAddChannel(
-		input?: GisViewChannelAddInput['resolution'] | GisViewChannel | GisViewLine | GisViewChannelAddCommitInput,
-		options?: { auto?: boolean; continuous?: boolean; originalEvent?: Event | null }
+		input?: GisViewChannelAddCommitInput,
+		options?: { auto?: boolean; continuous?: boolean; originalEvent?: Event | null; select?: boolean }
 	): GisViewChannelAddResult
 	/** 两个节点之间的新增方案：新通道 / 新分组 / 并进某一组 / 无法添加（kind 为 'line' 时方案表是空的） */
 	getChannelAddOptions(from: string | number, to: string | number, count?: number, kind?: 'channel' | 'line'): GisViewChannelAddPlan | null
@@ -8125,55 +8320,56 @@ export interface GisViewInstance {
 	 */
 	getChannelBetween(from: string | number, to: string | number): GisViewChannelBetween | null
 	/**
-	 * 程序化新增一个通道（新签名）：第一段是通道信息 `{ from, to, name, id }`，第二段是线路数组 line_data ——
-	 * 每条按自己的 id 建进通道（id 自动成为 lineIds），第三段是可选的分组信息。只负责新建一个通道：
-	 * 两个节点之间已经有通道时整条失败（reason 指路 addChannelGroupLines / joinChannelGroupLines，
-	 * 结果里的 plan 带着 hasChannel / hasGroup / groups / channel）。第二段 / 第三段显式给了
-	 * （或对象上写 `lineData` / `group`）才走这条新路；只写 `{ from, to }` 的老调用照旧按方案表分流
+	 * 一组节点之间的直接通道 / 线路：两端都必须真实存在且都在传入的 id 集合里，
+	 * 只认通道端点或线路 from / to 的直接绑定，不沿线路穿中间节点，也不返回集合外的边。
+	 * 通道按 channels 顺序、线路按 lines 顺序；一条都没命中时返回空数组。
 	 */
-	addChannel(channel: GisViewChannelAddSpec, lineData?: GisViewChannelLineData, group?: GisViewChannelAddGroup | GisViewChannelAddGroup[]): GisViewChannelAddResult
+	getDirectConnections(pointIds: string | number | Array<string | number>): GisViewDirectConnection[]
 	/**
-	 * 新增通道 / 回线的旧写法（circuits / resolution / channelId / kind 那套）：与从前完全一致 ——
-	 * 按方案表挑新通道 / 新分组 / 并入某组，kind 为 'line' 时加独立线路，circuits 是一次几回，
-	 * lineItems 是「连同线路一起新建」的第二段（一条或一批逐条属性，给了几条就建几条；
-	 * 每项也可以只写一个 id —— 裸字符串 / 数字按 { id } 收，与第二段 line_data 同一份口径）
+	 * 程序化新增一个通道：第一段是通道信息 `{ from, to, name, id, path, routing, channelProps }`，第二段是线路数据 ——
+	 * 每条按自己的 id 建进通道（id 自动成为 lineIds），第三段是可选的分组信息。只负责新建一个通道：
+	 * 两个节点之间已经有通道时整条失败（reason 指路 addChannelGroupLines / joinChannelGroupLines，
+	 * 结果里的 plan 带着 hasChannel / hasGroup / groups / channel）。第二段不写时建一条自动编号回线；
+	 * options.select 为 true 时落地后选中新回线，options.emit: false 时不发数据变更。
 	 */
-	addChannel(input: GisViewChannelAddInput, lineItems?: GisViewChannelLineItems): GisViewChannelAddResult
+	addChannel(channel: GisViewChannelAddSpec, lineData?: GisViewChannelLineData, group?: GisViewChannelAddGroup | GisViewChannelAddGroup[], options?: { emit?: boolean; select?: boolean }): GisViewChannelAddResult
 	/**
 	 * 在已有通道里新加一组回线（原 addChannel 的 newGroup 那一支）：第二段是这次新建的线路数组 line_data，
 	 * 第三段可选 `{ id?, path? }` 给新分组的 id 与中间拐点（缺省 `${通道 id}::N`、不带拐点）
 	 */
-	addChannelGroupLines(channelId: string | number, lineData?: GisViewChannelLineData, group?: GisViewChannelAddGroup): GisViewChannelAddResult
+	addChannelGroupLines(channelId: string | number, lineData?: GisViewChannelLineData, group?: GisViewChannelAddGroup, options?: { emit?: boolean; select?: boolean }): GisViewChannelAddResult
 	/**
-	 * 在已有通道里一次新加多组回线：每一项 `{ id?, path?, lineData | lines | lineItems }`，
+	 * 在已有通道里一次新加多组回线：每一项 `{ id?, path?, lineData | lines }`，
 	 * 逐组落地但只记一步历史、只发一条 addChannelGroups 数据变更
 	 */
-	addChannelGroups(channelId: string | number, groups: GisViewChannelAddGroupInput | GisViewChannelAddGroupInput[], options?: { emit?: boolean; label?: string }): GisViewAddChannelGroupsResult
+	addChannelGroups(channelId: string | number, groups: GisViewChannelAddGroupInput | GisViewChannelAddGroupInput[], options?: { emit?: boolean; select?: boolean; label?: string }): GisViewAddChannelGroupsResult
 	/**
 	 * 把新回线并进已有通道的某一组（原 addChannel 的 joinGroup 那一支）：groupId 认分组 id，也认序号
 	 * （从 0 起、按声明顺序），不给就并进第一个还有余量的分组；第三段是这次新建的线路数组 line_data
 	 */
-	joinChannelGroupLines(channelId: string | number, groupId: string | number | undefined, lineData?: GisViewChannelLineData): GisViewChannelAddResult
+	joinChannelGroupLines(channelId: string | number, groupId: string | number | undefined, lineData?: GisViewChannelLineData, options?: { emit?: boolean; select?: boolean }): GisViewChannelAddResult
 	/**
-	 * 程序化新增一条独立线路（不挂通道）：等价于 addChannel({ ...input, kind: 'line' })，第二段线路数据同样认 ——
-	 * 每条可以只写一个 id（裸字符串 / 数字按 { id } 收）、写对象给逐条字段，也可以完全不给（按 from-to-序号自动编号）
+	 * 程序化新增独立线路（不挂通道）：第一段给 from / to / name / id / lineProps / path / routing，
+	 * 第二段是线路数据（一条或一批，可以只写 id），不写就建一条按 from-to-序号自动编号的线路。
+	 * 落地走追加式引擎路径；options.select 为 true 时选中新回线，options.emit: false 时不发数据变更。
 	 */
-	addLine(input: GisViewChannelAddInput, lineItems?: GisViewChannelLineItems): GisViewChannelAddResult
+	addLine(input: GisViewLineAddSpec, lineData?: GisViewChannelLineData, options?: { emit?: boolean; select?: boolean }): GisViewChannelAddResult
 	/**
-	 * 一次新增多条通道 / 独立线路（addChannel 的批量版，每条写法一致）：逐条落地，但只重排一次场景、
+	 * 一次新增多条通道（addChannel 的批量版，每条写法一致）：逐条落地，但只重排一次场景、
 	 * 只记一步历史、只发一条 `addChannels` 数据变更 —— 切场景时把接口里的通道一批批补进来用它。
-	 * `results` 与传入顺序一一对应，失败条目在自己的 reason 里说明原因；options.emit 传 false 时不发数据变更
+	 * `results` 与传入顺序一一对应，失败条目在自己的 reason 里说明原因；options.emit 传 false 时不发数据变更，
+	 * options.select 为 true 时最后一次性选中全部新回线
 	 */
-	addChannels(input: GisViewChannelAddInput | GisViewChannelAddInput[], options?: { emit?: boolean }): GisViewAddChannelsResult
+	addChannels(input: GisViewChannelAddSpec | GisViewChannelAddSpec[], options?: { emit?: boolean; select?: boolean }): GisViewAddChannelsResult
 	/**
 	 * 往数据末尾追加一个节点 / 一批节点 / 一批线路（批量导入、从别处拷过来、按坐标补几条）：
 	 * 老数据一个都不动，返回 `{ ok, count, indexes, items }`（单条时另有 index 与 item）。
 	 * 与 addChannel / addLine 的分工：那两条走「通道 / 草稿」那一套，这里是把现成的数据对象接在
-	 * points / lines 后面。options.emit 传 false 时不发数据变更
+	 * points / lines 后面。options.emit 传 false 时不发数据变更；options.select 为 true 时选中新要素
 	 */
-	addPoint(item: GisViewPoint, options?: { emit?: boolean }): GisViewAddPointResult
-	addPoints(items: GisViewPoint | GisViewPoint[], options?: { emit?: boolean }): GisViewAddItemsResult<GisViewPoint>
-	addLines(items: GisViewLine | GisViewLine[], options?: { emit?: boolean }): GisViewAddItemsResult<GisViewLine>
+	addPoint(item: GisViewPoint, options?: { emit?: boolean; select?: boolean }): GisViewAddPointResult
+	addPoints(items: GisViewPoint | GisViewPoint[], options?: { emit?: boolean; select?: boolean }): GisViewAddItemsResult<GisViewPoint>
+	addLines(items: GisViewLine | GisViewLine[], options?: { emit?: boolean; select?: boolean }): GisViewAddItemsResult<GisViewLine>
 	/** 移除一条线路（撤销刚落地的新增线路）：挂在通道上的回线会从通道声明里一起摘掉，通道空了整条删掉 */
 	removeLine(lineId: string | number): GisViewRemoveLineResult
 	/** 一次移除多条线路（传数组）：通道声明与分组跟着收拾，删空的通道整条走 */
@@ -8516,6 +8712,8 @@ export interface GisViewEngineOptions {
 	channelMaxGroups?: number
 	/** 一个分组最多几条回线（0 表示不限）：新增通道时据此判断还能不能并进这一组 */
 	channelGroupMaxLines?: number
+	/** 通道简略：分组回线数超过阈值时只画一条代表线，见 GisViewChannelSimplifyOptions */
+	channelSimplify?: boolean | GisViewChannelSimplifyOptions
 	/** 新增通道草稿线的样式（跟随光标的那条预览线） */
 	channelDraftStyle?: GisViewChannelDraftStyle
 	/** WebGL 自定义层：与 GisViewOptions.webglLayers 同一份写法 */
@@ -8659,16 +8857,16 @@ export interface GisViewEngineOptions {
 	onSelect?: (payload: GisViewSelectPayload | null, detail?: { mode?: 'single' | 'multi' | 'box'; originalEvent?: Event | null; defer?: boolean }) => void
 	onClick?: (payload: GisViewClickPayload | null) => void
 	/** 点中多成员聚合圆（引擎不选中成员，普通点击回调不会同时触发） */
-	onClusterClick?: (payload: GisViewClusterClickPayload, event: Event) => void
+	onClusterClick?: (payload: GisViewClusterClickPayload) => void
 	onDblClick?: (payload: GisViewClickPayload | null) => void
-	/** 左键 / 中键 / 右键按下与抬起：命中的要素、按钮与光标位置都在载荷里 */
-	onPointerDown?: (payload: GisViewPointerPayload, event: PointerEvent) => void
-	onPointerUp?: (payload: GisViewPointerPayload, event: PointerEvent) => void
+	/** 左键 / 中键 / 右键按下与抬起：命中的要素与光标位置在载荷里，原生的键 / 修饰键读 payload.originalEvent */
+	onPointerDown?: (payload: GisViewPointerPayload) => void
+	onPointerUp?: (payload: GisViewPointerPayload) => void
 	/**
 	 * 右键：点、线、通道、空白都会发这一条。命中通道回线时 action.target 为 'channel'，
 	 * 载荷另带 channelContext（几组 / 当前哪组 / 能做什么），不再有单独的通道路由。
 	 */
-	onContextMenu?: (payload: GisViewPointerPayload, event: MouseEvent) => void
+	onContextMenu?: (payload: GisViewPointerPayload) => void
 	/** 点击级联高亮变了：载荷与 getCascadeHighlight() 同一份，收掉时是 null */
 	onCascadeHighlight?: (payload: GisViewCascadeHighlightInfo | null) => void
 	onPointDrag?: (payload: GisViewPointDragPayload) => void
@@ -8705,8 +8903,8 @@ export interface GisViewEngine {
 	describeAll(selection: GisViewFeatureKey[]): GisViewPickResult[]
 	/** 批量还原并补通道上下文：单通道摊平 channelId / group / groups，多通道给 channelContexts */
 	describeSelection(selection: GisViewFeatureKey[], preferredGroupId?: string | number): GisViewDescribedSelection
-	/** 按画布 CSS 像素矩形框选，返回框内要素；第二段兼容旧的 Event 或 { selectionKinds, originalEvent } */
-	selectInBox(box: GisViewRect, options?: GisViewSelectInBoxOptions | Event | null): GisViewPickResult[]
+	/** 按画布 CSS 像素矩形框选，返回框内要素 */
+	selectInBox(box: GisViewRect, options?: GisViewSelectInBoxOptions): GisViewPickResult[]
 	/** 拐点增删改，insertIndex 缺省时按直线上离目标最近的线段插入 */
 	insertWaypoint(lineIndex: number, coordinate: GisViewCoordinate, insertIndex?: number): GisViewWaypointPayload | null
 	/** 删除指定线路上的拐点 */
@@ -8784,15 +8982,24 @@ export interface GisViewEngine {
 	beginChannelDraft(options?: GisViewChannelDraftOptions): GisViewChannelDraftPayload | null
 	/** 当前草稿：两个节点的信息与可选方案，没有草稿时为 null */
 	getChannelDraft(): GisViewChannelDraftPayload | null
-	/** 连续新增：一段落地之后原地重开一段草稿（chain 为 true 时以上一段终点当新起点，也可以换 kind / circuits） */
+	/** 连续新增：一段落地之后原地重开一段草稿（chain 为 true 时以上一段终点当新起点） */
 	restartChannelDraft(options?: {
 		chain?: boolean
-		kind?: 'channel' | 'line'
+		/** 重开上一段时也可以预指定起点（与 beginChannelDraft 的 from 同一份写法） */
+		from?: GisViewPointRef
+		singleChannel?: boolean
+		existingChannel?: GisViewChannelExistingMode
+		groupId?: string | number
+		groupIndex?: number
 		circuits?: number
+		/** 换这一段草稿的第二段线路数据；给了几条就按几条对齐 circuits */
+		lineData?: GisViewChannelLineData
 		/** 换这一段草稿的预览样式（字段级合并；null 回到全局 channelDraftStyle，不传就沿用） */
 		channelDraftStyle?: GisViewChannelDraftStyle | null
 		/** 换一份逐条回线的属性（不传就沿用这一段草稿原来的） */
 		linePropsByMember?: Array<Partial<GisViewLine> | undefined>
+		routing?: 'straight' | 'orthogonal'
+		path?: GisViewCoordinate[]
 		/** 换这一段草稿的交接模式（不传就沿用） */
 		handoff?: boolean
 		/** 换这一段草稿的「点节点时让节点选中」（不传就沿用） */
@@ -8961,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