gis-view-webgl2 0.1.15 → 0.1.16

package/dist/index.d.ts

@@ -1557,6 +1557,12 @@ export interface GisViewLinePatch extends Partial<GisViewLine> {
 	channelId?: string | number
 }
 
+/**
+ * patchLines 里的一条：给定位（id / 下标 / `{ id }` / `{ index }`），其余字段与 updateLine 的补丁同一套
+ * （线路字段 + groupId / groupIndex / channelId 三个分组指令）。分组指令不会写进 lines。
+ */
+export type GisViewLineUpdateItemEntry = GisViewPointRef | (GisViewLinePatch & { id?: string | number; index?: number })
+
 /**
  * updateChannel 第三段的一条：`{ id | index, ...字段 }` —— 用 id / index 定位这条通道的成员回线
  * （id 优先、数字回落下标，与 updateLine 的 id 参数同一套解析），其余字段与 `GisViewLinePatch` 完全同一套写法
@@ -1568,6 +1574,35 @@ export type GisViewChannelLinePatch = GisViewLinePatch & {
 	index?: number
 }
 
+/**
+ * updateChannel 第二段 / patchChannels 每条通道补丁：通道自己的字段之外，还可以写单组补丁 `group`
+ * （按 id 找组、只合并写出来的字段；同时写 `groups` 时以整份声明为准）。
+ * 这里的 `groups` / `lineIds` 是通道声明：不会新建 / 删除顶层 `lines` 里的真实线路。
+ * 成员回线的逐条字段放在 updateChannel 第三段 / patchChannels 的 `linePatches`；
+ * 新建回线用 addChannelGroupLines / addLine(s)，挂入 / 摘出用 addChannelLines / removeChannelLines，
+ * 删除线路用 removeLine(s)，删除 / 合并分组用 removeChannelGroup / mergeChannelGroups。
+ */
+export interface GisViewChannelPatch extends Partial<GisViewChannel> {
+	/** 只改一组：认 id / groupId（也认 groupId 别名），找不到就新加一组；不写 id 就是第一组 */
+	group?: Partial<GisViewChannelGroup> & { groupId?: string | number }
+}
+
+/**
+ * patchChannels 的一条：给定位（id / 下标 / `{ id }` / `{ index }`），带不带自己的补丁都认。
+ * - 扁平写法：`{ id, name, groups, lineIds }`，`lineIds` 不带 `linePatches` 时是通道成员声明；
+ * - updateChannel 形状：`{ id, patch, linePatches, lineIds }`，此时 `lineIds` 是第四段整表对齐；
+ * - 扁平 + 成员：`{ id, name, linePatches, lineIds }`，顶层 `lineIds` 与 `linePatches` 配对时也按整表对齐解释。
+ * 需要同时给声明 lineIds 与成员补丁时，把声明写进 `patch.lineIds`（或公共第二段）。
+ */
+export type GisViewChannelUpdateItemEntry = GisViewPointRef | (GisViewChannelPatch & {
+	id?: string | number
+	index?: number
+	/** updateChannel 第二段（逐条形式）；与扁平字段同给时这里的字段优先 */
+	patch?: GisViewChannelPatch
+	/** updateChannel 第三段：这条通道的成员回线补丁 */
+	linePatches?: GisViewChannelLinePatch | GisViewChannelLinePatch[]
+})
+
 /** 通道偏移方式：tangent 走最外侧切点（按宽度均分），inset 从切点再向内收一段距离 */
 export type GisViewChannelOffsetMode = 'tangent' | 'inset'
 
@@ -1594,6 +1629,8 @@ export interface GisViewChannelGroup {
 /**
  * 通道：多条回线并行敷设的走廊，所有回线共用一条骨架折线（中心线）。
  * 回线几何由骨架按偏移量推导，拐点也挂在骨架上：编辑任一回线的拐点都会同步整条通道。
+ * 通道声明只保存线路 id（`lineIds` / `groups[].lineIds`），真正的线路对象统一在顶层 `lines`；
+ * 组件不会读取或写入 `channel.lineData` —— 新增接口第二段的同名 `lineData` 只是入参。
  */
 export interface GisViewChannel {
 	/** 通道标识：同 id 的通道在数据刷新之间保留已编辑过的骨架 */
@@ -1908,14 +1945,17 @@ export interface GisViewChannelGroupAddResult {
 	skipped?: Array<string | number>
 }
 
-/** removeChannelGroup 的选项：把要删的那一组并进哪一组（缺省前一组，没有前一组就用后一组） */
+/** removeChannelGroup 的选项：缺省把要删的那一组并进相邻组；removeLines 为 true 时改为连组内回线一起删 */
 export interface GisViewChannelGroupRemoveOptions {
+	/** 合并目标组：缺省前一组，没有前一组就用后一组；removeLines 为 true 时忽略 */
 	targetGroupId?: string | number
+	/** true 时删除这一组下的真实回线数据，不再把成员并到相邻组；通道还有其它组时继续保留 */
+	removeLines?: boolean
 }
 
 /**
  * 删除一个分组的结果：ok 为 false 时 reason 说明原因（这条通道只有一组、找不到分组 / 目标组…）。
- * targetGroupId 是并进的那一组（并完只剩一组时是通道自己的 id）
+ * targetGroupId 是并进的那一组（并完只剩一组时是通道自己的 id）；removeLines 模式为 null
  */
 export interface GisViewChannelGroupRemoveResult {
 	ok: boolean
@@ -1927,6 +1967,12 @@ export interface GisViewChannelGroupRemoveResult {
 	targetGroupId?: string | number | null
 	/** 被并走的回线 id */
 	lineIds?: Array<string | number>
+	/** removeLines 模式真正从数据里删掉的回线 */
+	lines?: GisViewLine[]
+	/** 这次是否走了「连组内回线一起删」分支 */
+	removedLines?: boolean
+	/** 删完后这条通道一条成员都不剩，整条通道也一起删掉了 */
+	removedChannel?: boolean
 	/** 改完之后这条通道的分组现状（与 getChannelGroups 同一份） */
 	groups?: GisViewChannelGroupInfo[]
 }
@@ -2474,16 +2520,42 @@ export interface GisViewRemoveLineResult {
 	removedChannel?: boolean
 }
 
-/** removeChannel 的结果：lineIds / lines 是跟着通道一起消失的回线 */
+/** removeChannel 的结果：lineIds / lines 是跟着通道一起消失的回线；keepLines 时改为 keptLineIds 保留下来 */
 export interface GisViewRemoveChannelResult {
 	ok: boolean
 	reason?: string
 	channelId?: string | number
 	lineIds?: Array<string | number>
 	lines?: GisViewLine[]
+	/** keepLines 模式保留下来的原成员回线 id（数据仍在，之后按独立线路绘制） */
+	keptLineIds?: Array<string | number>
 	removedChannel?: boolean
 }
 
+/** removeChannels 的逐条结果：在单条 removeChannel 的读数上补原通道下标与被删通道对象 */
+export interface GisViewRemoveChannelsItemResult extends GisViewRemoveChannelResult {
+	index?: number
+	item?: GisViewChannel
+}
+
+/** removeChannels 的结果：results 与传入的有效通道一一对应，skipped 是认不出 / 重复的引用 */
+export interface GisViewRemoveChannelsResult {
+	ok: boolean
+	reason?: string
+	count: number
+	results: GisViewRemoveChannelsItemResult[]
+	channelIds: Array<string | number>
+	/** 删除前这些通道在 channels 数组里的下标 */
+	channelIndexes: number[]
+	lineIds: Array<string | number>
+	lines: GisViewLine[]
+	/** 本次一起消失的全部通道（含因成员回线被删而空掉的通道） */
+	removedChannels: GisViewChannel[]
+	/** keepLines 模式保留下来的原成员回线 id */
+	keptLineIds?: Array<string | number>
+	skipped: Array<{ ref?: unknown; reason: string }>
+}
+
 /** removeLines 的结果：entries 是每条被移除的线路（含下标与原属通道），lines / lineIds / indexes 是同一批的顺手读数 */
 export interface GisViewRemoveLinesResult {
 	ok: boolean
@@ -2572,7 +2644,11 @@ export interface GisViewLineAddSpec {
 	lineData?: GisViewChannelLineData
 }
 
-/** 第二段线路数据（lineData）：对象里的 id 就是回线 id（没写的自动编号），裸字符串 / 数字等价于 { id } */
+/**
+ * 第二段线路数据（lineData）：对象里的 id 就是回线 id（没写的自动编号），裸字符串 / 数字等价于 { id }。
+ * 只用于 addChannel / addLine / commitAddChannel 等新增入口；落地后线路进顶层 lines，通道只记 lineIds，
+ * 不会在 channel 上再保存一份 lineData。
+ */
 export type GisViewChannelLineData = Partial<GisViewLine> | string | number | Array<Partial<GisViewLine> | string | number | undefined>
 
 /** 新签名 addChannel 第三段的一项：新通道的分组信息（id / 成员 / 中间拐点；缺省整条通道一组） */
@@ -3590,8 +3666,8 @@ export type GisViewPointerActionType =
 	| 'click'
 	| 'pan'
 	| 'copy'
-	| 'channelDraft'
-	| 'decorationDraft'
+	| 'channelDraft'
+	| 'decorationDraft'
 	| 'drag'
 	| 'pointer'
 
@@ -4010,6 +4086,8 @@ export interface GisViewPointMergePayload {
 	impact: GisViewMergeImpact | null
 	/** 合并后保留谁：'target'（缺省，碰撞目标）或 'source'（当前拖动的来源节点）；确认时传 confirm({ keep }) */
 	keep: GisViewMergeKeep
+	/** 这一次合并采用的通道分组策略；confirm({ channelGroups }) / resolvePointMerge(true, { channelGroups }) 可覆盖全局配置 */
+	channelGroups: GisViewMergeChannelGroups
 	/**
  * confirm 阶段的合并结果（按 keep 决定的保留端业务字段优先、merge.maxKeys 列出的字段取双方最高值、
  * 尺寸取双方最大、图标用保留端）：
@@ -4054,6 +4132,8 @@ export interface GisViewMergeResult {
 	mergedChannels: number
 	/** 端点改到目标节点的通道条数 */
 	channelsChanged: number
+	/** 决定撞在一起的两条通道怎么分组的策略（与 merge.channelGroups / 本次 options.channelGroups 同一口径） */
+	channelGroups: GisViewMergeChannelGroups
 	/** 与 confirm 阶段同一口径的影响读数；合并后需要按 id 查明细时也能直接用 */
 	impact: GisViewMergeImpact
 	/** 直接提交后端的完整变更集（删除来源节点、更新 / 删除线路与通道） */
@@ -4078,6 +4158,8 @@ export interface GisViewMergeFailure {
 	removedLines: number
 	removedChannels: number
 	mergedChannels: number
+	/** 这次调用采用的分组策略；失败载荷也带上，便于界面统一读同一字段 */
+	channelGroups: GisViewMergeChannelGroups
 	originalEvent: Event | null
 }
 
@@ -4105,6 +4187,8 @@ export interface GisViewMergeSelectedPayload {
 	removedChannels: number
 	mergedChannels: number
 	channelsChanged: number
+	/** 整批合并采用的通道分组策略（逐对 merge 结果里也各带一份） */
+	channelGroups: GisViewMergeChannelGroups
 	originalEvent: Event | null
 }
 
@@ -4139,6 +4223,12 @@ export interface GisViewMergeSelectedOptions {
 	item?: Partial<GisViewPoint> | ((context: GisViewMergeSelectedItemContext) => Partial<GisViewPoint> | void)
 	/** true 时连 mergeable: false 的节点也并（默认跳过它们） */
 	force?: boolean
+	/**
+	 * 覆盖 merge.channelGroups：撞成同一条的通道里，被并来源的回线怎么进保留通道。
+	 * 'keep' 各自保留 / 'merge' 合成一组 / 'newGroup' 收成一个新组 / 'first' 并进第一组 /
+	 * { groupId } 并进指定组（找不到回落第一组）
+	 */
+	channelGroups?: GisViewMergeChannelGroups
 	/** 这一步历史的标签（默认「合并选中节点」） */
 	label?: string
 	originalEvent?: Event | null
@@ -4313,6 +4403,7 @@ export type GisViewDataChangeType =
 	| 'updatePoint'
 	| 'updateLine'
 	| 'updateChannel'
+	| 'updateChannels'
 	| 'pointDrag'
 	| 'copyPoint'
 	| 'copyPoints'
@@ -4332,6 +4423,7 @@ export type GisViewDataChangeType =
 	| 'removeSelected'
 	| 'removeLine'
 	| 'removeChannel'
+	| 'removeChannels'
 	| 'channelGroups'
 	/** 撤销 / 重做回放了一条历史记录（这是接口 undo() / redo() 与 Ctrl+Z / Ctrl+Shift+Z 发的那一条） */
 	| 'undo'
@@ -4365,7 +4457,9 @@ export interface GisViewDataChangePayload {
 	/** 动作对应的要素：更新的那一个、复制 / 合并出来的那一个、删掉的那一条线路或通道 */
 	item?: GisViewPoint | GisViewLine | GisViewChannel
 	/** 删掉 / 加上的那些要素（节点或线路） */
-	items?: Array<GisViewPoint | GisViewLine>
+	items?: Array<GisViewPoint | GisViewLine | GisViewChannel>
+	/** 批量更新的逐条定位结果（updateChannels / patchChannels 会带上认不出的引用） */
+	skipped?: unknown[]
 	/** 这次动到几个要素 */
 	count?: number
 	/** 拖拽结束：本次跟着改坐标的节点与线路（与 onPointDrag 的 points / lines 同一份） */
@@ -4387,6 +4481,8 @@ export interface GisViewDataChangePayload {
 	/** 合并落地：与 onPointMerge 的 impact / changes 同一份（批量里逐条 mergePoints 也各带一份） */
 	impact?: GisViewMergeImpact
 	mergeChanges?: GisViewMergeChangeSet
+	/** 合并落地：本次采用的通道分组策略 */
+	channelGroups?: GisViewMergeChannelGroups
 	/** 拐点增删：第几段（pathIndex）、坐标与所属集合 */
 	pathIndex?: number
 	phase?: string
@@ -6187,9 +6283,10 @@ export interface GisViewMergeOptions {
 	/**
 	 * 两个节点合到一块儿之后，它们之间的通道撞成同一条时怎么处理：
 	 * 'keep'（缺省）各自保留自己的分组（声明照旧，只是端点改到目标节点）；
-	 * 'merge' 合成一个分组（回线取并集）
+	 * 'merge' 合成一个分组（回线取并集）；'newGroup' 把被并通道的回线收成一个新组；
+	 * 'first' 并进保留通道第一组；{ groupId } 并进指定组（找不到回落第一组）
 	 */
-	channelGroups?: 'keep' | 'merge'
+	channelGroups?: GisViewMergeChannelGroups
 	/**
 	 * 合并后取双方最高值的字段：只认列出来的键，缺省空表（不取任何最高值，全部保留目标节点字段）。
 	 * 例如 `['vn_kv', 'value']`；也接受 `'vn_kv,value'` 写法。字段两边都是有限数字时取 Math.max，
@@ -6208,6 +6305,26 @@ export interface GisViewMergeOptions {
 /** 拖拽合并的触发时机：两个节点的屏幕半径相碰 / 拖动节点中心进入目标节点区域 */
 export type GisViewMergeTrigger = 'collision' | 'center'
 
+/**
+ * 两条通道合并时的分组策略：
+ * - 'keep'（缺省）各自保留原分组；
+ * - 'merge' 合成一个分组；
+ * - 'newGroup' 把被并通道的回线收成一个新分组，追加在保留通道后面；
+ * - 'first' 把被并通道的回线并进保留通道第一组；
+ * - { groupId } 并进保留通道指定 id 的那一组，找不到时回落第一组；{ groupId } 省略 id 等价于 'first'。
+ */
+export type GisViewMergeChannelGroups =
+	| 'keep'
+	| 'merge'
+	| 'newGroup'
+	| 'first'
+	| GisViewMergeChannelGroupTarget
+
+/** 合并分组指定目标组：groupId 省略 / 为空时并入保留通道第一组 */
+export interface GisViewMergeChannelGroupTarget {
+	groupId?: string | number
+}
+
 /** 通道选中模式：点中通道里的一条回线时选中什么 */
 export type GisViewChannelSelectMode =
 	/** 缺省：只选点中的这一条回线 */
@@ -6254,6 +6371,8 @@ export interface GisViewSelectInBoxOptions {
 /** resolvePointMerge / payload.confirm 的参数：保留哪一端，以及最终节点（可只给要改的字段） */
 export interface GisViewPointMergeConfirmOptions {
 	keep?: GisViewMergeKeep
+	/** 覆盖本次合并的通道分组策略；不传沿用 merge.channelGroups */
+	channelGroups?: GisViewMergeChannelGroups
 	item?: Partial<GisViewPoint> | null
 }
 
@@ -8722,7 +8841,12 @@ export interface GisViewInstance {
 	 * 返回 `{ 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(source: GisViewPointRef, target: GisViewPointRef, options?: {
+		originalEvent?: Event | null
+		item?: GisViewPoint
+		/** 覆盖 merge.channelGroups 的通道分组策略；不传沿用全局配置 */
+		channelGroups?: GisViewMergeChannelGroups
+	}): GisViewMergeOutcome
 	/**
 	 * 把一个节点拆成多份（mergePoints 的逆操作）：parts 省略 / null / [] 且节点带 mergeInfo 时自动解除合并，
 	 * 恢复全部来源节点与合并前的线路 / 通道；给 parts 时第一份复用原下标与 id，其余追加到 points 末尾。
@@ -8976,12 +9100,21 @@ export interface GisViewInstance {
 	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>
-	/** 移除一条线路（撤销刚落地的新增线路）：挂在通道上的回线会从通道声明里一起摘掉，通道空了整条删掉 */
+	/** 移除一条线路（撤销刚落地的新增线路）：挂在通道上的回线会从通道声明里一起摘掉；剩余成员按顶层 lineIds 与 groups 的并集判断，空了才整条删掉 */
 	removeLine(lineId: string | number): GisViewRemoveLineResult
-	/** 一次移除多条线路（传数组）：通道声明与分组跟着收拾，删空的通道整条走 */
+	/** 一次移除多条线路（传数组）：通道声明与分组跟着收拾；groups: [] 不会遮掉仍有成员的顶层 lineIds，删空的通道才整条走 */
 	removeLines(lineIds: string | number | Array<string | number>): GisViewRemoveLinesResult
-	/** 移除整条通道：它名下的回线一条条摘掉，通道声明与回线一起消失 */
-	removeChannel(channelId: string | number): GisViewRemoveChannelResult
+	/**
+	 * 移除整条通道：缺省连同成员回线一起删；options.keepLines 为 true 时只删通道声明，
+	 * 回线留在数据里成为独立线路，返回 keptLineIds 是保留下来的原成员引用
+	 */
+	removeChannel(channelId: string | number, options?: { keepLines?: boolean }): GisViewRemoveChannelResult
+	/**
+	 * 一次移除多条通道（removeChannel 的批量版）：成员回线合成一次 removeLines，整批只重排一次、
+	 * 只记一步历史、只发一条 `removeChannels` 数据变更。重复引用只处理一次，认不出的引用进 `skipped`；
+	 * options.keepLines 为 true 时只删通道声明、回线全部保留；options.emit 传 false 时只改数据不发通知
+	 */
+	removeChannels(channelIds: string | number | Array<string | number>, options?: { emit?: boolean; label?: string; keepLines?: boolean }): GisViewRemoveChannelsResult
 	/** 改某个节点的数据（坐标 / 样式 / 符号）并重渲染：绑在它身上的线路与以它为锚点的通道跟着重排 */
 	updatePoint(id: string | number, patch: Partial<GisViewPoint>): GisViewInstance
 	/**
@@ -8998,15 +9131,30 @@ export interface GisViewInstance {
 	 * （id / index 之外的字段就是这一条的补丁），或者 `patchPoints(['a', 'b'], { status: 1 })`
 	 * 把同一份补丁盖到一批节点上。认不出来的记进 skipped，不影响其余条目；
 	 * 返回 `{ ok, indexes, items, count, skipped }`，只记一条历史、只发一条 updatePoints 数据变更。
-	 * 与 `updateData({ points })` 的分工：那一条是整份替换节点数据，这里只动点到的这几条
+	 * 与 `updateData({ points })` 的分工：那一条是整份替换节点数据，这里只动点到的这几条。
+	 * 与 updatePoint 的分工是「一批 vs 一条」；旧的 updatePoints(points) 已按去重收口删除
 	 */
 	patchPoints(entries: GisViewUpdateItemEntry<GisViewPoint> | Array<GisViewUpdateItemEntry<GisViewPoint>>, patch?: Partial<GisViewPoint>): GisViewUpdateItemsOutcome<GisViewPoint>
 	/**
-	 * 批量给线路打补丁：与 patchPoints 同一套写法（`patchLines([{ id: 'l1', width: 4 }])` /
-	 * `patchLines(['l1', 'l2'], { color: '#f00' })`），返回 `{ ok, indexes, items, count, skipped }`，
-	 * 只记一条历史、只发一条 updateLines 数据变更
+	 * updateLine 的批量版：与 patchPoints 同一套写法（`patchLines([{ id: 'l1', width: 4 }])` /
+	 * `patchLines(['l1', 'l2'], { color: '#f00' })`），每条与公共补丁都支持 updateLine 的线路字段和
+	 * `groupId` / `groupIndex` / `channelId` 分组指令。分组指令不写进线路数据；只给分组指令的条目不发
+	 * updateLines，有数据字段时整批只发一条 updateLines。一次调用只记一条历史；
+	 * 整份替换用 `updateData({ lines })`，旧的 updateLines(lines) 已按去重收口删除
+	 */
+	patchLines(entries: GisViewLineUpdateItemEntry | GisViewLineUpdateItemEntry[], patch?: GisViewLinePatch): GisViewUpdateItemsOutcome<GisViewLine>
+	/**
+	 * updateChannel 的批量版：`patchChannels([{ id: 'c1', name: '甲' }, { index: 2, width: 8 }])`
+	 * 一次改几条，或者 `patchChannels(['c1', 'c2'], { visible: false })` 把同一份通道补丁盖到一批上。
+	 * 也支持 `patchChannels(entries, patch?, linePatches?, lineIds?)` 以及逐条
+	 * `{ id, patch, linePatches, lineIds }`，三段与 updateChannel 的第二 / 三 / 四段同义。
+	 * 声明整批只推一次引擎；成员补丁、补建 / 整表少了删在同一 batch 内收尾，历史只算一步，
+	 * 主变更是一条 `updateChannels`；改过分组 / 成员表的通道另发 `channelGroups` / `channelGroupChange` 明细。
+	 * 旧扁平写法的 `groups` / `lineIds` 仍是声明级增删；逐条 `lineIds` 与 `linePatches` 配对时是整表对齐。
+	 * 认不出的定位、空表 / 不成对的整表进 `skipped`，不影响其余条目。整份换声明用
+	 * `updateData({ channels })`，旧的 updateChannels(channels) 已按去重收口删除
 	 */
-	patchLines(entries: GisViewUpdateItemEntry<GisViewLine> | Array<GisViewUpdateItemEntry<GisViewLine>>, patch?: Partial<GisViewLine>): GisViewUpdateItemsOutcome<GisViewLine>
+	patchChannels(entries: GisViewChannelUpdateItemEntry | GisViewChannelUpdateItemEntry[], patch?: GisViewChannelPatch, linePatches?: GisViewChannelLinePatch | GisViewChannelLinePatch[], lineIds?: string | number | Array<string | number>): GisViewUpdateItemsOutcome<GisViewChannel>
 	/**
 	 * 改某个通道的数据（分组、宽度、端点等）并重渲染（与整份换声明的 `updateData({ channels })` 一对）：
 	 * 成员表没变时只把成员回线换成新几何，成员表换了（改 lineIds）整份重解析。
@@ -9031,7 +9179,7 @@ export interface GisViewInstance {
 	 * 什么都不做。只写 groups 缩小时回线留在数据里，被移出通道、又不在别的通道上的各报一句 warning；
 	 * 不属于这条通道的条目跳过并报一句 warning（同一个条目只提醒一次）
 	 */
-	updateChannel(id: string | number, patch: Partial<GisViewChannel>, linePatches?: GisViewChannelLinePatch | GisViewChannelLinePatch[], lineIds?: string | number | Array<string | number>): GisViewInstance
+	updateChannel(id: string | number, patch: GisViewChannelPatch, linePatches?: GisViewChannelLinePatch | GisViewChannelLinePatch[], lineIds?: string | number | Array<string | number>): GisViewInstance
 	/** 逐要素的复合改法：同时处理多种字段、通道分组或成员回线时用这些入口；单项字段直接用 updatePoint / updateLine / updateChannel */
 	/** 挪一个节点：`movePoint('n1', { x, y })` / `movePoint('n1', [x, y])` / `movePoint('n1', x, y)` 都认，绑定线路与锚定通道跟着重排 */
 	movePoint(id: string | number, coordinate: GisViewCoordinate): GisViewInstance