gis-view-webgl2 0.1.14 → 0.1.16

package/dist/index.d.ts

@@ -1303,6 +1303,8 @@ export interface GisViewPointDecoration {
 	size?: number
 	/** 填充 / 色调，缺省白色 */
 	color?: string
+	/** 所属节点被选中时是否改用其最终选中色：SVG path 写 strokeColor，其余符号写 color；缺省 false */
+	followSelectColor?: boolean
 	/** 描边色，缺省透明 */
 	strokeColor?: string
 	/** 描边宽度（CSS 像素），缺省 0 */
@@ -1352,9 +1354,9 @@ export interface GisViewPoint {
 	labels?: GisViewItemLabel | GisViewItemLabel[]
 	/** 这个点的悬浮提示内容：覆盖全局分类配置，false 表示这个点不显示提示 */
 	tooltip?: GisViewTooltipContent | false
-	/** 是否可点击（悬停、选中与点击事件），缺省沿用 options.clickable */
+	/** 是否可点击（悬停、选中与点击事件）：逐点关掉；悬停 / 选中的总闸是 features.hover / features.select */
 	clickable?: boolean
-	/** 是否可拖拽，缺省沿用 options.draggable */
+	/** 是否可拖拽：总闸是 features.drag，节点写 false 可在总闸打开时逐个关掉 */
 	draggable?: boolean
 	/** 是否允许复制（按住复制快捷键点击 / 接口复制）：false 时这个节点不出复制预览，缺省 true */
 	copyable?: boolean
@@ -1437,7 +1439,7 @@ export interface GisViewLine {
 	labels?: GisViewItemLabel | GisViewItemLabel[]
 	/** 这条线的悬浮提示内容：覆盖全局分类配置，false 表示这条线不显示提示 */
 	tooltip?: GisViewTooltipContent | false
-	/** 是否可点击（悬停、选中与点击事件），缺省沿用 options.clickable */
+	/** 是否可点击（悬停、选中与点击事件）：逐条关掉；悬停 / 选中的总闸是 features.hover / features.select */
 	clickable?: boolean
 	/** 悬停到这条线上时的光标：覆盖 options.cursorStyle.line / channel */
 	cursor?: GisViewCursorValue
@@ -1449,7 +1451,7 @@ export interface GisViewLine {
 	selectStyle?: GisViewLineStyle
 	/** Ctrl 点击累加多选时的样式，按字段覆盖线自身样式，缺省沿用 selectStyle 与 options.lineMultiSelectStyle */
 	multiSelectStyle?: GisViewLineStyle
-	/** 是否允许编辑拐点（Ctrl + 点击添加、拖动、删除），缺省沿用 options.waypointEditable */
+	/** 是否允许编辑拐点（Ctrl + 点击添加、拖动、删除）：逐条关掉；总闸是 features.waypoint */
 	waypointEditable?: boolean
 	/** 这条线的热力图：false 不参与（保持自身配色，也不会退回所属通道的值），true / 对象同上 */
 	heatmap?: GisViewHeatmapOverride
@@ -1489,7 +1491,7 @@ export interface GisViewCascadeHighlightOptions {
 	/** 普通单击是否触发 / 更新级联高亮，缺省 true；关闭后这次单击只走选中，并清掉旧级联 */
 	triggerOnClick?: boolean
 	/**
-	 * Ctrl / ⌘ 多选或 options.multiSelect 的累加点击是否触发级联高亮，缺省 true。
+	 * Ctrl / ⌘ 多选或 features.multiSelect 的累加点击是否触发级联高亮，缺省 true。
 	 * 关闭后多选只改变选中集，不改级联状态（并把旧级联收掉）
 	 */
 	triggerOnMultiSelect?: boolean
@@ -1555,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` 完全同一套写法
@@ -1566,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'
 
@@ -1592,6 +1629,8 @@ export interface GisViewChannelGroup {
 /**
  * 通道：多条回线并行敷设的走廊，所有回线共用一条骨架折线（中心线）。
  * 回线几何由骨架按偏移量推导，拐点也挂在骨架上：编辑任一回线的拐点都会同步整条通道。
+ * 通道声明只保存线路 id（`lineIds` / `groups[].lineIds`），真正的线路对象统一在顶层 `lines`；
+ * 组件不会读取或写入 `channel.lineData` —— 新增接口第二段的同名 `lineData` 只是入参。
  */
 export interface GisViewChannel {
 	/** 通道标识：同 id 的通道在数据刷新之间保留已编辑过的骨架 */
@@ -1906,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
@@ -1925,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[]
 }
@@ -2472,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
@@ -2570,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 / 成员 / 中间拐点；缺省整条通道一组） */
@@ -3011,10 +3089,13 @@ export interface GisViewResolvedGeoJson {
 	labels: GisViewResolvedBackgroundLabel[]
 	/** 实际落到画面上的旋转角（度，顺时针，已归一到 [-180, 180)） */
 	rotation: number
+	/** geoJsonStyle.bounds / rotation 实际使用的缩放、平移与旋转；没有改位置时为 null */
+	drawTransform: GisViewGeoDrawTransform | null
 	/** 缩放前的真实坐标范围（aspectScale 生效前）：相机、fitView 与经纬度换算用它 */
 	rawBounds: GisViewBounds | null
 	/** 这份底图实际使用的 aspectScale（默认 0.75） */
 	aspectScale: number
+	/** 最终画出来的轴对齐范围（含 aspectScale、geoJsonStyle.bounds 与 rotation） */
 	bounds: GisViewBounds | null
 	fills: number[]
 	fillBuckets: Array<{ color: [number, number, number, number]; first: number; count: number }>
@@ -3031,14 +3112,27 @@ export interface GisViewResolvedGeoJson {
 	shadow: { color: [number, number, number, number]; offsets: Array<[number, number]> } | null
 }
 
+/** 解析后 GeoJSON 的最终摆放参数：先按 aspectScale 生成源范围，再缩放 / 平移 / 旋转到画面 */
+export interface GisViewGeoDrawTransform {
+	scaleX: number
+	scaleY: number
+	offsetX: number
+	offsetY: number
+	/** 旋转中心（世界坐标） */
+	center: [number, number]
+	/** 顺时针角度（度） */
+	rotation: number
+}
+
 /** 经纬度 ↔ GeoJSON 画出来的世界坐标的换算（aspectScale 只压经度，围绕整体范围中心） */
 export interface GisViewGeoProjection {
 	/** 缩放前的真实经纬度范围 */
 	rawBounds: GisViewBounds
-	/** 画出来的世界范围（已应用 aspectScale） */
+	/** 最终画出来的世界范围（含 aspectScale、geoJsonStyle.bounds 与 rotation） */
 	bounds: GisViewBounds
 	aspectScale: number
 	center: [number, number]
+	/** 合成后的 x / y 基准比例（旋转后不再等价于单一轴对齐仿射，优先用 project / unproject） */
 	scaleX: number
 	scaleY: number
 	/** 经纬度 → 画出来的世界坐标（与底图完全对齐） */
@@ -3049,8 +3143,8 @@ export interface GisViewGeoProjection {
 
 /** 数据坐标 → GeoJSON 坐标的映射参数 */
 export interface GisViewGeoMapperOptions {
-	/** 'lngLat' 数据本身就是经纬度（完全贴合底图）/ 'fit' 等比铺进 geojson 范围 / 'scale'（默认）按比例与偏移 */
-	mode?: 'lngLat' | 'fit' | 'scale'
+	/** 'lngLat' 数据本身就是经纬度 / 'fit' 任意坐标系等比铺进 geojson 范围 / 'scale'（默认）经纬度基准上叠加比例与偏移 */
+	mode?: 'lngLat' | 'fit' | 'world' | 'scale'
 	/** 在基准变换之上再叠一层比例：节点与 geojson 的大小比例属性，绕 center（缺省 geojson 中心） */
 	scale?: number
 	scaleX?: number
@@ -3059,9 +3153,21 @@ export interface GisViewGeoMapperOptions {
 	offsetX?: number
 	offsetY?: number
 	center?: [number, number]
-	/** fit 模式的数据范围；不传就从 data 里算 */
+	/** fit 模式的数据范围；不传就从节点、线路几何、通道 / 分组路径与固定坐标装饰算 */
 	bounds?: GisViewBounds | null
-	data?: { points?: Array<{ x: number; y: number }>; lines?: Array<{ path?: Array<[number, number]> }> } | null
+	data?: {
+		points?: Array<{ x: number; y: number; decorations?: Array<{ at?: GisViewCoordinate }> }>
+		lines?: Array<{
+			path?: GisViewCoordinate[]
+			start?: GisViewCoordinate
+			end?: GisViewCoordinate
+			decorations?: Array<{ at?: GisViewCoordinate; position?: GisViewLineDecorationPosition }>
+		}>
+		channels?: Array<{
+			path?: GisViewCoordinate[]
+			groups?: Array<{ path?: GisViewCoordinate[]; waypointOffsets?: Record<string, GisViewCoordinate> }>
+		}>
+	} | null
 	/** fit 模式四周留白（占 geojson 短边比例，0 ~ 0.45） */
 	padding?: number
 	/** fit 模式铺进哪份范围：'drawn'（默认，画出来的范围）/ 'raw'（aspectScale 之前的真实范围） */
@@ -3070,9 +3176,13 @@ export interface GisViewGeoMapperOptions {
 	aspectScale?: number
 }
 
-/** 数据坐标 → GeoJSON 坐标的映射器：map / unmap 换单个点，mapPoint / mapLine / mapChannel 换一份数据 */
+/**
+ * 数据坐标 → GeoJSON 坐标的映射器：map / unmap 换单个点，mapPoint / mapLine / mapChannel 换一份数据。
+ * 坐标同时认 `[x, y]` 与 `{ x, y }`；mapLine / mapChannel 会换 path / start / end 与固定坐标装饰，
+ * mapChannel 还会换分组 path，并把 waypointOffsets 当向量映射（不叠平移）。
+ */
 export interface GisViewGeoMapper {
-	mode: 'lngLat' | 'fit' | 'scale'
+	mode: 'lngLat' | 'fit' | 'world' | 'scale'
 	projection: GisViewGeoProjection
 	pivot: [number, number]
 	scaleX: number
@@ -3185,6 +3295,24 @@ export interface GisViewPointClusterOptions {
 	minPoints?: number
 	/** 相机比例 / 基准比例超过它之后展开原始点；0（缺省）表示不设上限 */
 	maxZoom?: number
+	/** 聚合圆 / 图标的填充色，缺省 '#2970db'；SVG 图标的 currentColor 也取它 */
+	color?: string
+	/** 聚合圆描边色，缺省 '#ffffff'；形状图标用自己的 strokeColor 时以图标为准 */
+	strokeColor?: string
+	/** 聚合圆描边宽度（CSS 像素），缺省 2，夹在 0 ~ 20 */
+	strokeWidth?: number
+	/** 聚合圆 / 图标的整体不透明度，缺省 1，夹在 0 ~ 1 */
+	opacity?: number
+	/** 数量文字颜色，缺省 '#ffffff' */
+	textColor?: string
+	/** 数量文字字号（CSS 像素）；0（缺省）按聚合圆半径自动取 12 / 13 */
+	fontSize?: number
+	/** 聚合圆图标：内置 circle / square、SVG / 图片地址或自定义图元，缺省 'circle' */
+	symbol?: GisViewSymbolInput
+	/** 是否显示聚合数量文字，缺省 true；图标本身已经带数量时可以关掉 */
+	showCount?: boolean
+	/** 聚合圆整体尺寸倍数（含命中半径），缺省 1，夹在 0.25 ~ 4 */
+	sizeScale?: number
 }
 
 /** getPointCluster() 的读数：归一化之后的配置 + 当前缩放档是否仍在聚合。 */
@@ -3203,6 +3331,17 @@ export interface GisViewCluster {
 	screen: [number, number]
 	radius: number
 	bounds: GisViewBounds
+	/** 多成员聚合圆的样式读数；单成员组不带这些字段 */
+	color?: string
+	strokeColor?: string
+	strokeWidth?: number
+	opacity?: number
+	textColor?: string
+	/** 数量文字的实际字号（fontSize: 0 时是按半径算出来的 12 / 13） */
+	fontSize?: number
+	symbol?: GisViewSymbolInput
+	showCount?: boolean
+	sizeScale?: number
 }
 
 /** 多成员聚合圆的拾取结果：item 永远为 null，index 为 -1，不进入普通要素选中集。 */
@@ -3225,6 +3364,11 @@ export interface GisViewClusterLabel {
 	count: number
 	screen: [number, number]
 	radius: number
+	/** 已经解析过的数量文字字号 */
+	fontSize: number
+	textColor: string
+	/** false 时覆盖层不生成数量 DOM，读屏与导出一致 */
+	showCount: boolean
 }
 
 /**
@@ -3942,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 列出的字段取双方最高值、
  * 尺寸取双方最大、图标用保留端）：
@@ -3986,6 +4132,8 @@ export interface GisViewMergeResult {
 	mergedChannels: number
 	/** 端点改到目标节点的通道条数 */
 	channelsChanged: number
+	/** 决定撞在一起的两条通道怎么分组的策略（与 merge.channelGroups / 本次 options.channelGroups 同一口径） */
+	channelGroups: GisViewMergeChannelGroups
 	/** 与 confirm 阶段同一口径的影响读数；合并后需要按 id 查明细时也能直接用 */
 	impact: GisViewMergeImpact
 	/** 直接提交后端的完整变更集（删除来源节点、更新 / 删除线路与通道） */
@@ -4010,6 +4158,8 @@ export interface GisViewMergeFailure {
 	removedLines: number
 	removedChannels: number
 	mergedChannels: number
+	/** 这次调用采用的分组策略；失败载荷也带上，便于界面统一读同一字段 */
+	channelGroups: GisViewMergeChannelGroups
 	originalEvent: Event | null
 }
 
@@ -4037,6 +4187,8 @@ export interface GisViewMergeSelectedPayload {
 	removedChannels: number
 	mergedChannels: number
 	channelsChanged: number
+	/** 整批合并采用的通道分组策略（逐对 merge 结果里也各带一份） */
+	channelGroups: GisViewMergeChannelGroups
 	originalEvent: Event | null
 }
 
@@ -4071,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
@@ -4245,6 +4403,7 @@ export type GisViewDataChangeType =
 	| 'updatePoint'
 	| 'updateLine'
 	| 'updateChannel'
+	| 'updateChannels'
 	| 'pointDrag'
 	| 'copyPoint'
 	| 'copyPoints'
@@ -4264,6 +4423,7 @@ export type GisViewDataChangeType =
 	| 'removeSelected'
 	| 'removeLine'
 	| 'removeChannel'
+	| 'removeChannels'
 	| 'channelGroups'
 	/** 撤销 / 重做回放了一条历史记录（这是接口 undo() / redo() 与 Ctrl+Z / Ctrl+Shift+Z 发的那一条） */
 	| 'undo'
@@ -4297,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 同一份） */
@@ -4319,6 +4481,8 @@ export interface GisViewDataChangePayload {
 	/** 合并落地：与 onPointMerge 的 impact / changes 同一份（批量里逐条 mergePoints 也各带一份） */
 	impact?: GisViewMergeImpact
 	mergeChanges?: GisViewMergeChangeSet
+	/** 合并落地：本次采用的通道分组策略 */
+	channelGroups?: GisViewMergeChannelGroups
 	/** 拐点增删：第几段（pathIndex）、坐标与所属集合 */
 	pathIndex?: number
 	phase?: string
@@ -5274,6 +5438,8 @@ export interface GisViewLineDecoration {
 	size?: number
 	/** 填充 / 色调：填进符号的 color，'currentColor' 一类的写法取的就是它；默认白色 */
 	color?: string
+	/** 所属线路被选中时是否改用其最终选中色：SVG path 写 strokeColor，其余符号写 color；缺省 false */
+	followSelectColor?: boolean
 	/** 描边色：符号里的 stroke: 'currentStrokeColor' 取的是它（默认透明，也就是不描边） */
 	strokeColor?: string
 	/** 描边宽度（CSS 像素），默认 0 */
@@ -5324,6 +5490,8 @@ export interface GisViewDecorationDraftOptions {
 	size?: number
 	/** 填充 / 色调，缺省白色 */
 	color?: string
+	/** 提交后的装饰是否跟随所属要素选中色：SVG path 写 strokeColor，其余符号写 color；缺省 false */
+	followSelectColor?: boolean
 	/** 描边色，缺省透明 */
 	strokeColor?: string
 	/** 描边宽度（CSS 像素），缺省 0 */
@@ -5415,6 +5583,7 @@ export interface GisViewDecorationDraftPayload {
 	strokeWidth: number
 	opacity: number
 	parallel: boolean
+	followSelectColor: boolean
 	scope: GisViewDecorationDraftScope
 	maxDistance: number
 	maxPerLine: number
@@ -6114,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，
@@ -6135,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 =
 	/** 缺省：只选点中的这一条回线 */
@@ -6181,6 +6371,8 @@ export interface GisViewSelectInBoxOptions {
 /** resolvePointMerge / payload.confirm 的参数：保留哪一端，以及最终节点（可只给要改的字段） */
 export interface GisViewPointMergeConfirmOptions {
 	keep?: GisViewMergeKeep
+	/** 覆盖本次合并的通道分组策略；不传沿用 merge.channelGroups */
+	channelGroups?: GisViewMergeChannelGroups
 	item?: Partial<GisViewPoint> | null
 }
 
@@ -6431,6 +6623,10 @@ export type GisViewFeatureName =
 	| 'hover'
 	/** 点击选中（onClick 与 select / selectInBox 这些接口入口不受它限制） */
 	| 'select'
+	/** 不按修饰键的多选：普通点击累加 / 取反 */
+	| 'multiSelect'
+	/** 再次点击已选要素时取消选中 */
+	| 'toggleSelect'
 	/** 框选（默认 Shift + 拖动，随 shortcuts.boxSelect 改变） */
 	| 'boxSelect'
 	/** 拖动节点（含整组拖动） */
@@ -6460,13 +6656,21 @@ export type GisViewFeatureName =
 
 /**
  * 功能开关表：**缺省全关** —— 什么都不写时只剩画布与数据，所有交互都要手动打开。
- * **没写的开关跟随各自的详细配置**（`interactive` / `clickable` / `draggable` / `boxSelect` / `copy.enabled`…），
+ * 平移 / 缩放 / 悬停 / 选中 / 框选 / 多选 / 取反 / 拖拽 / 拐点只有这一个入口，没有顶层详细配置；
+ * 没写 = 关。copy / merge / remove 与标签 / 提示 / 鹰眼图仍跟随各自的详细配置，
  * 详细配置也没写时同样是关（标签 / 提示 / 鹰眼图这类「配了才有」：配了就等于手动打开）；
  * 写了 `true` 强制打开、写了 `false` 强制关闭（详细配置写 true 也没用）。
  * 开关只决定「组件做不做某个交互」，不改变数据与样式：关掉 drag 之后节点还在、还能选中，只是拖不动；
  * 关掉 label 之后标签图层不再产生 DOM，数据与样式一律不动。
  */
-export type GisViewFeatures = Partial<Record<GisViewFeatureName, boolean>>
+/**
+ * `features` 里允许使用的详细配置别名：`draggable` 映射到 `drag`，`waypointEditable` 映射到 `waypoint`，
+ * `interactive` 一次映射到 `pan` / `zoom` / `contextMenu`，`clickable` 一次映射到 `hover` / `select`。
+ * 同一个对象里同时写了别名与规范名时规范名优先；别名只用于输入，`getFeatures()` 不返回别名键。
+ */
+export type GisViewFeatureAliasName = 'draggable' | 'waypointEditable' | 'interactive' | 'clickable'
+
+export type GisViewFeatures = Partial<Record<GisViewFeatureName | GisViewFeatureAliasName, boolean>>
 
 /**
  * 开关的当前有效值：把「跟随详细配置」也解析成 true / false（getFeatures 与 onFeatureChange 给的就是这一份）。
@@ -6829,9 +7033,12 @@ export interface GisViewOptions {
 	 * 功能开关：预设名（'edit' / 'view' / 'static'）、开关表或布尔值 ——
 	 * **缺省全关**：什么都不写时只剩画布与数据，想要哪一项就手动打开哪一项。
 	 * 'edit' 全开、'view' 一次打开查看类（能平移缩放、能悬停选中看提示，改不动数据）、
-	 * 'static' 与缺省一致（全关）。没写的开关一律跟随各自的详细配置（interactive / clickable / draggable /
-	 * boxSelect / copy.enabled…），详细配置也没写就是关（标签 / 提示 / 鹰眼图「配了才有」，配了就等于打开）：
-	 * 想开哪一项就写哪一项 —— `features: { drag: true }`、`interactive: true`、`clickable: true`、`draggable: true` 或 `copy: {…}`。
+	 * 'static' 与缺省一致（全关）。交互权限**只有 features 一个入口**：拖拽 / 平移 / 缩放 / 悬停 /
+	 * 选中 / 框选 / 多选 / 取反 / 拐点都写在这里。旧的顶层 `draggable` / `interactive` / `clickable` /
+	 * `boxSelect` / `multiSelect` / `toggleSelect` / `waypointEditable` 已移除，传入会经 onWarning
+	 * 提示迁移并忽略；features 表内仍可用 `draggable` / `interactive` / `clickable` / `waypointEditable` 别名。
+	 * copy / merge / remove 与 label / tooltip / minimap 的详细配置仍负责参数与内容：
+	 * 写了 copy / merge / remove 等于打开对应能力，features 可再强制开关；标签 / 提示 / 鹰眼图「配了才有」。
 	 * 运行时用 setFeatures() 换一份，getFeatures() 读当前有效值（把「跟随详细配置」也解析成 true / false）。
 	 */
 	features?: GisViewFeaturesInput
@@ -7090,44 +7297,16 @@ export interface GisViewOptions {
 	 * 关掉之后交互 / 动画期与静止帧的画法完全一致（代价是十万级下慢 3 ~ 4 倍）。
 	 */
 	interactionNoMsaa?: boolean
-	/**
-	 * 查看类交互的「详细配置手动打开」写法：写 true 打开拖拽平移 / 滚轮缩放 / 右键回调
-	 * （等价 features 的 pan / zoom / contextMenu），不写就是关（缺省全关）。
-	 */
-	interactive?: boolean
-	/** 查看类交互的「详细配置手动打开」写法：写 true 打开悬停高亮与点击选中（等价 hover / select）；要素自身可用 clickable: false 逐个关掉 */
-	clickable?: boolean
 	/**
 	 * 光标：按状态与悬停目标分别配置，写法支持 CSS 关键字与自定义图片（url / 热点），
 	 * 还能配按住 Ctrl / ⌘ 时的另一套。不配时用 gis-view.css 里的 --gis-view-cursor-* 变量
 	 */
 	cursorStyle?: GisViewCursorStyle
-	/** 点是否可拖拽，单个点可用 draggable 覆盖；**缺省关**（全关口径），要拖就写 draggable: true 或 features: { drag: true } */
-	draggable?: boolean
 	/**
 	 * 拖动节点时线路是否实时跟随：默认 true（拖动过程中线路端点一路跟着走）。
 	 * 关掉之后拖动期间只移动节点本身，线路保持原样，停手（pointerup）时一次性更新到新位置。
 	 */
 	liveDrag?: boolean
-	/** 是否允许按住框选快捷键（见 shortcuts.boxSelect，默认 Shift）拖动鼠标框选节点；**缺省关**，要框选就写 boxSelect: true */
-	boxSelect?: boolean
-	/**
-	 * 多选开关（**缺省关**）：打开之后不用按修饰键，直接单击节点 / 线路就能取反累加选中
-	 * （与按住 shortcuts.multiSelect 点击同一套行为，命中时套用 multiSelectStyle）；
-	 * 关着时多选仍走框选（boxSelect）与按住多选快捷键（默认 Ctrl / ⌘）。
-	 */
-	multiSelect?: boolean
-	/**
-	 * 再次选中即取消（**缺省关**）：打开后，普通点击已在选中集里的要素会把它取消；
-	 * Ctrl / ⌘ 先选中、再普通点击同一要素也同样取消。单击 / 双击两种 selectTrigger 都适用，
-	 * 双击会按一次操作处理（第一下取反、第二下保持），不会因为双击的两下连点而反复切换。
-	 * 命中通道回线时按 channelSelectMode 决定取消单条回线 / 当前分组 / 整条通道，其他选中项保留；
-	 * 该组 / 通道只选中一部分、或点到组内另一条回线时，也按同一展开范围整体取消；
-	 * 该组 / 通道已经完整选中时，即使 channelSelectMode 为 line 也整组 / 整条取消。
-	 * 这条取消路径不受 selectionKinds 限制；取消生效时同一来源的点击级联也会一起收掉。
-	 * 与 multiSelect 同时打开时沿用 multiSelect 的累加取反口径；运行时走 updateOptions({ toggleSelect })。
-	 */
-	toggleSelect?: boolean
 	/**
 	 * 选中触发方式：缺省 'click'（单击选中）；写 'dblClick' 后第一次点击只派发 onClick，
 	 * 第二次（双击判定命中）才更新选中集，并同时派发 onClick 与 onDblClick。
@@ -7154,8 +7333,8 @@ export interface GisViewOptions {
 	 */
 	selectionBoxPersistent?: boolean
 	/**
-	 * 选中的要素是否画在所有要素之上（默认 true）：抬层的包括点击 / 拖动 / 待确认合并的节点，
-	 * 以及选中线路所在的整条通道 —— 选中了就一定看得见，与 zIndex 无关；
+	 * 选中的要素是否画在所有要素之上（默认 true）：抬层的包括点击 / 拖动 / 待确认合并的节点、
+	 * 选中线路所在的整条通道，以及它们的 decorations —— 选中了就一定看得见，与 zIndex 无关；
 	 * 关掉之后完全按 zIndex 与数据顺序绘制（十万级数据下抬层会让整份重排一次）
 	 */
 	selectionOnTop?: boolean
@@ -7187,11 +7366,6 @@ export interface GisViewOptions {
 	copy?: GisViewCopyOptions
 	/** 合并节点（**缺省关**：写了这份配置才算开）：把一个节点拖到另一个节点上（考虑碰撞）时怎么确认与怎么并 */
 	merge?: GisViewMergeOptions
-	/**
-	 * 是否允许编辑线路拐点：Ctrl + 点击添加、拖动移动、双击或 Delete 删除；**缺省关**，单条线可用 waypointEditable 覆盖。
-	 * `false`（以及 `features: { waypoint: false }`）会同时关闭新增、移动与删除；没有只关其中一项的细分开关
-	 */
-	waypointEditable?: boolean
 	/** 拐点显示时机：selected 只在线路被选中（或刚加过拐点）时显示，always 始终显示；默认 selected */
 	waypointVisibility?: 'selected' | 'always'
 	/** 拐点样式，缺省为小圆点 */
@@ -8112,8 +8286,12 @@ export interface GisViewSceneCluster {
 	fill: string
 	stroke: string
 	strokeWidth: number
+	opacity: number
 	textColor: string
 	fontSize: number
+	showCount: boolean
+	/** 配了非缺省图标时的屏幕坐标符号原语；缺省圆仍按 fill / stroke 画 */
+	icon?: GisViewSceneNode
 }
 
 export interface GisViewSceneSnapshot {
@@ -8133,7 +8311,10 @@ export interface GisViewSceneSnapshot {
 	points: GisViewSceneNode[]
 	clusters: GisViewSceneCluster[]
 	backgroundPoints: GisViewSceneNode[]
+	/** 普通装饰（未随所属要素抬层） */
 	decorations: GisViewSceneNode[]
+	/** 跟着选中线路 / 节点 / 选中线路端点抬层的装饰：画在 raisedLines 之后、raised 之前 */
+	raisedDecorations: GisViewSceneNode[]
 	waypoints: GisViewSceneNode[]
 	/** 选中 / 拖动中的节点（画在最上面） */
 	raised: GisViewSceneNode[]
@@ -8492,6 +8673,19 @@ export interface GisViewInstance {
 	createGeoMapper(options?: GisViewGeoMapperOptions): GisViewGeoMapper | null
 	/** 直接把一份点 / 线 / 通道数据映射到 GeoJSON 坐标上（复制，不改原数据）；没有 GeoJSON 底图时是 null */
 	mapDataToGeoJson<T extends { points?: GisViewPoint[]; lines?: GisViewLine[]; channels?: GisViewChannel[] }>(data: T, options?: GisViewGeoMapperOptions): T | null
+	/**
+	 * 把当前网架的世界坐标 x / y 转成 GeoJSON 经纬度：不传 data 时转换当前 points / lines / channels。
+	 * 使用此刻最终画出来的底图投影（含 aspectScale、背景编辑后的 bounds 与 rotation）；返回复制后的数据，原数据与视图都不变；
+	 * 没有 GeoJSON 底图时是 null。存档回灌用 mapLngLatToData()，不要跳过它直接把 x=经度 / y=纬度 的数据 updateData 回去。
+	 */
+	mapDataToLngLat<T extends { points?: GisViewPoint[]; lines?: GisViewLine[]; channels?: GisViewChannel[] } = { points: GisViewPoint[]; lines: GisViewLine[]; channels: GisViewChannel[] }>(data?: T, options?: GisViewGeoMapperOptions): T | null
+	/**
+	 * mapDataToLngLat() 的逆变换：把 x / y 存着经纬度的 points / lines / channels 按当前底图投影写回世界坐标。
+	 * 覆盖线路路径 / 端点、固定坐标装饰、通道分组路径与 waypointOffsets 向量；返回副本，不改传入数据。
+	 * 没有 GeoJSON 底图时为 null。典型用法：`updateData(view.mapLngLatToData(saved))`；
+	 * 底图 bounds / rotation 改过时，经纬度会按调用当时最终画出来的底图重新落位。
+	 */
+	mapLngLatToData<T extends { points?: GisViewPoint[]; lines?: GisViewLine[]; channels?: GisViewChannel[] }>(data: T, options?: GisViewGeoMapperOptions): T | null
 	pick(x: number, y: number): GisViewHitResult | null
 	/**
 	 * 按浏览器客户端坐标拾取（鼠标事件里的 clientX / clientY）：与指针事件载荷同一份读数，另加 target
@@ -8647,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 末尾。
@@ -8901,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
 	/**
@@ -8923,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: GisViewUpdateItemEntry<GisViewLine> | Array<GisViewUpdateItemEntry<GisViewLine>>, patch?: Partial<GisViewLine>): GisViewUpdateItemsOutcome<GisViewLine>
+	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) 已按去重收口删除
+	 */
+	patchChannels(entries: GisViewChannelUpdateItemEntry | GisViewChannelUpdateItemEntry[], patch?: GisViewChannelPatch, linePatches?: GisViewChannelLinePatch | GisViewChannelLinePatch[], lineIds?: string | number | Array<string | number>): GisViewUpdateItemsOutcome<GisViewChannel>
 	/**
 	 * 改某个通道的数据（分组、宽度、端点等）并重渲染（与整份换声明的 `updateData({ channels })` 一对）：
 	 * 成员表没变时只把成员回线换成新几何，成员表换了（改 lineIds）整份重解析。
@@ -8956,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
@@ -9311,9 +9534,9 @@ export interface GisViewEngineOptions {
 	networkOpacity?: number
 	/** 背景编辑模式（见 GisViewOptions.backgroundEditing）：true 时屏蔽网架指针与数据快捷键，仅保留滚轮缩放 */
 	backgroundEditing?: boolean
-	/** 写 true 打开拖拽平移 / 滚轮缩放 / 右键回调（= pan / zoom / contextMenu），**缺省关** */
+	/** 引擎内部总闸：组件层固定为 true，具体权限由 features 换算出的 pan / zoom / contextMenu 等字段决定 */
 	interactive?: boolean
-	/** 写 true 打开悬停拾取与点击选中（= hover / select），**缺省关** */
+	/** 引擎内部总闸：组件层固定为 true，具体权限由 features 换算出的 hover / select 等字段决定 */
 	clickable?: boolean
 	/**
 	 * 平移 / 缩放 / 悬停 / 选中 / 右键各自的开关（组件层的 features 就是按这几个字段下发的）：
@@ -9336,7 +9559,7 @@ export interface GisViewEngineOptions {
 	hoverThreshold?: number
 	/** 光标配置：逐键合并，只想改一个分类时只写那一项即可 */
 	cursorStyle?: GisViewCursorStyle
-	/** 点是否可拖拽，**缺省关**（组件层由 features.drag 与 options.draggable 一起算，写了 true 才开） */
+	/** 点是否可拖拽（引擎内部字段）：组件层由 features.drag 计算后下发，**缺省关** */
 	draggable?: boolean
 	/** 拖动节点时线路是否实时跟随，默认 true；false 表示停手后一次性更新线路 */
 	liveDrag?: boolean
@@ -9344,14 +9567,14 @@ export interface GisViewEngineOptions {
 	boxSelect?: boolean
 	/** 多选开关（**缺省关**）：打开后不用按修饰键，直接单击要素就取反累加（与按住 shortcuts.multiSelect 点击同一套行为） */
 	multiSelect?: boolean
-	/** 再次选中即取消（**缺省关**），语义见 GisViewOptions.toggleSelect */
+	/** 再次选中即取消（**缺省关**）：组件层由 features.toggleSelect 下发 */
 	toggleSelect?: boolean
 	/** 框选 / Ctrl 多选允许的要素类型，写法与缺省口径见 GisViewOptions.selectionKinds */
 	selectionKinds?: GisViewSelectionKindsInput
 	selectionBoxStyle?: GisViewSelectionBoxStyle | null
 	/** 框选后保留矩形，并允许拖动矩形平移框内选中节点；缺省 false */
 	selectionBoxPersistent?: boolean
-	/** 选中 / 拖动 / 待确认合并的节点与选中通道是否画在所有要素之上，默认 true */
+	/** 选中 / 拖动 / 待确认合并的节点、选中通道以及它们的 decorations 是否画在所有要素之上，默认 true */
 	selectionOnTop?: boolean
 	/**
 	 * 通道选中模式：点中通道里的一条回线时选中什么 —— 'line'（缺省）只选这一条、'group' 连它所在分组、
@@ -9372,7 +9595,7 @@ export interface GisViewEngineOptions {
 	copy?: GisViewCopyOptions
 	/** 合并节点的配置（**缺省关**：写了才算开）：开关、触发时机、像素容差、确认方式与数据合并规则 */
 	merge?: GisViewMergeOptions
-	/** 是否允许编辑拐点，**缺省关** */
+	/** 是否允许编辑拐点，**缺省关**：组件层由 features.waypoint 下发 */
 	waypointEditable?: boolean
 	waypointVisibility?: 'selected' | 'always'
 	waypointStyle?: GisViewPointStyle | null
@@ -9715,6 +9938,9 @@ export declare const createGisViewEngine: (canvas: HTMLCanvasElement, options?:
 /** 全部开关名（顺序与界面一致），界面按它列复选框 */
 export declare const FEATURE_NAMES: GisViewFeatureName[]
 
+/** 详细配置别名 -> 一个或多个规范开关；别名只在输入时展开，`getFeatures()` 不返回别名键 */
+export declare const FEATURE_ALIASES: Record<GisViewFeatureAliasName, GisViewFeatureName[]>
+
 /** 预设表：键是开关名、值是布尔；**没列出来的开关取 featureDefault**（全关；「配了才有」的那几项不给值） */
 export declare const FEATURE_PRESETS: Record<GisViewFeaturePreset, GisViewFeatures>