gis-view-webgl2 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -1690,6 +1690,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 +1746,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（没有就是新建通道） */
@@ -1799,8 +1813,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 +1839,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 +1883,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 +1910,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 +2118,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 +2221,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 +2270,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 +2283,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 +2311,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 +2801,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 +2809,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 +2846,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 +2873,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 +2957,7 @@ export interface GisViewSelectionData {
 	lines: GisViewLine[]
 	/** 选中回线所属的通道（去重） */
 	channels: GisViewChannel[]
-	/** 与 getSelections() 同一份：带下标、坐标与通道上下文 */
+	/** 与 getSelections() 同一份：带下标与坐标，通道回线不重复挂通道字段 */
 	items: GisViewPickResult[]
 	pointIndexes: number[]
 	lineIndexes: number[]
@@ -2945,7 +2969,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 +2979,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 +2999,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 +3054,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 +3107,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 +3121,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 +3134,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 +3142,7 @@ export interface GisViewLabelActionData {
 export interface GisViewPointerPayload {
 	/**
 	 * 这一次操作的判读：按下时 type 是意图、松开时是刚做完的那件事、右键固定是 'contextMenu'；
-	 * target 说明点的是点 / 线 / 通道 / 空白，data 直接给到那一份数据（左键 / 右键都认这一份）
+	 * target 说明点的是点 / 线 / 通道 / 空白；命中的数据直接读载荷的 item / channel / channelContext 等字段。
 	 */
 	action: GisViewPointerAction
 	/** 命中的要素类型，空白处为 null；多成员聚合是 'cluster' */
@@ -3170,9 +3157,6 @@ export interface GisViewPointerPayload {
 	screen?: [number, number]
 	/** 命中的要素自身的世界坐标 */
 	coordinate?: [number, number]
-	/** 命中的是线路（含通道回线）时，线路在 lines 数组里的下标与 id；右键菜单按它找线路 */
-	lineIndex?: number
-	lineId?: string | number
 	/** 命中的是通道内的回线时，回线所属通道与分组 */
 	channelIndex?: number
 	channel?: GisViewChannel
@@ -3198,11 +3182,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 +3193,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 +3212,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 +3264,6 @@ export interface GisViewPointCopyPayload {
 	index: number
 	/** 复制出来的节点：预览中就是含最新落点的那一份 */
 	item: GisViewPoint
-	/** item 的别名，与其它载荷的写法对齐 */
-	point: GisViewPoint
 	/** 来源节点；剪贴板这条的来源下标为 -1（快照还在） */
 	source: GisViewCopySource | null
 	/** 整组来源（clipboard 与多选复制时给全；普通 Alt 复制只有 source 一项） */
@@ -3308,8 +3284,6 @@ export interface GisViewPointCopyPayload {
 	/** 快照是否带上内部线路 / 通道 */
 	withLines?: boolean
 	withChannels?: boolean
-	/** 复制出来的节点当前落在的世界坐标 */
-	coordinate: [number, number] | null
 	/** 光标在画布内的 CSS 像素位置 */
 	screen: [number, number] | null
 	originalEvent: Event | null
@@ -3322,8 +3296,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 +3383,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
 	/** 已经落地，原样返回这份载荷 */
@@ -3708,6 +3678,12 @@ export interface GisViewSplitPointOptions {
 	keepSourceId?: boolean
 	/** 这一步历史的标签，缺省「拆分节点」 */
 	label?: string
+	/**
+	 * 没在 parts[].lines 里显式分配的线路怎么分：first 全跟第一份（缺省，兼容旧行为）；
+	 * alternate 按「通道成组、独立线路单条」为单位轮流给负载最少的一份 —— 同一条通道的成员不会被拆散，
+	 * 解除合并时推荐用它
+	 */
+	autoLines?: 'first' | 'alternate'
 }
 
 /** 拆分时没认出来的线路 / 通道引用 */
@@ -3730,6 +3706,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 +3732,12 @@ export interface GisViewSplitPointOutcome {
 	removedChannels: number
 	removedChannelIds: Array<string | number>
 	skipped: { lines: GisViewSplitPointSkip[]; channels: GisViewSplitPointSkip[] }
+	/** 这一次采用的自动分线口径 */
+	autoLines: 'first' | 'alternate'
+	/** 由 autoLines 自动分配（没有显式写 lines）的线路条数 */
+	autoAssignedLines: number
+	/** 每一份最终接到哪些线路（含显式分配与自动分配） */
+	lineAssignments: GisViewSplitPointLineAssignment[]
 	changes: GisViewSplitPointChangeSet | null
 }
 
@@ -4526,12 +4517,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 +4541,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 +4565,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
 }
 
@@ -6049,8 +6034,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 上下文 */
@@ -6065,9 +6050,9 @@ export interface GisViewEventMap {
 	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
@@ -6629,7 +6614,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 +6625,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 +6649,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
 	/**
@@ -6840,8 +6825,6 @@ export interface GisViewFocusOptions {
 	scale?: number
 	/** 显式要求按目标范围适应视图；**缺省不缩放**，只把中心移到目标上 */
 	zoom?: boolean
-	/** 显式只居中、比例一点不动（与缺省行为一致，保留旧写法） */
-	center?: boolean
 	/** 按范围适应视图（zoom: true）时四周的留白（CSS 像素），缺省 40 */
 	padding?: number
 	/** 适应视图（zoom: true）时最多放大到多少比例：单个节点 / 一条直线没有面积，靠它决定要不要放大 */
@@ -7679,8 +7662,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
@@ -7813,7 +7796,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 +7844,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 +7866,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 +7888,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
@@ -7936,10 +7929,12 @@ export interface GisViewInstance {
 	mergePoints(source: GisViewPointRef, target: GisViewPointRef, options?: { originalEvent?: Event | null; item?: GisViewPoint }): GisViewMergeOutcome
 	/**
 	 * 把一个节点拆成多份（mergePoints 的逆操作）：第一份复用原下标与 id，其余追加到 points 末尾。
-	 * 每份可直接写节点字段或放进 item；lines 分配线路（不写时连在原节点上的线路跟第一份），
+	 * 每份可直接写节点字段或放进 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, changes, skipped }`
 	 */
 	splitPoint(source: GisViewPointRef, parts: GisViewSplitPointPart[], options?: GisViewSplitPointOptions): GisViewSplitPointOutcome
 	/**
@@ -8073,10 +8068,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 +8091,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 +8113,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 +8125,50 @@ export interface GisViewInstance {
 	 */
 	getChannelBetween(from: string | number, to: string | number): GisViewChannelBetween | null
 	/**
-	 * 程序化新增一个通道（新签名）：第一段是通道信息 `{ from, to, name, id }`，第二段是线路数组 line_data ——
+	 * 程序化新增一个通道：第一段是通道信息 `{ from, to, name, id, path, routing, channelProps }`，第二段是线路数据 ——
 	 * 每条按自己的 id 建进通道（id 自动成为 lineIds），第三段是可选的分组信息。只负责新建一个通道：
 	 * 两个节点之间已经有通道时整条失败（reason 指路 addChannelGroupLines / joinChannelGroupLines，
-	 * 结果里的 plan 带着 hasChannel / hasGroup / groups / channel）。第二段 / 第三段显式给了
-	 * （或对象上写 `lineData` / `group`）才走这条新路；只写 `{ from, to }` 的老调用照旧按方案表分流
-	 */
-	addChannel(channel: GisViewChannelAddSpec, lineData?: GisViewChannelLineData, group?: GisViewChannelAddGroup | GisViewChannelAddGroup[]): GisViewChannelAddResult
-	/**
-	 * 新增通道 / 回线的旧写法（circuits / resolution / channelId / kind 那套）：与从前完全一致 ——
-	 * 按方案表挑新通道 / 新分组 / 并入某组，kind 为 'line' 时加独立线路，circuits 是一次几回，
-	 * lineItems 是「连同线路一起新建」的第二段（一条或一批逐条属性，给了几条就建几条；
-	 * 每项也可以只写一个 id —— 裸字符串 / 数字按 { id } 收，与第二段 line_data 同一份口径）
+	 * 结果里的 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
 	/** 一次移除多条线路（传数组）：通道声明与分组跟着收拾，删空的通道整条走 */
@@ -8659,16 +8654,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 +8700,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 +8779,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
 		/** 换这一段草稿的「点节点时让节点选中」（不传就沿用） */