gis-view-webgl2 0.1.13 → 0.1.15

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
@@ -3011,10 +3013,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 +3036,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 +3067,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 +3077,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 +3100,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 +3219,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 +3255,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 +3288,11 @@ export interface GisViewClusterLabel {
 	count: number
 	screen: [number, number]
 	radius: number
+	/** 已经解析过的数量文字字号 */
+	fontSize: number
+	textColor: string
+	/** false 时覆盖层不生成数量 DOM，读屏与导出一致 */
+	showCount: boolean
 }
 
 /**
@@ -3522,8 +3590,8 @@ export type GisViewPointerActionType =
 	| 'click'
 	| 'pan'
 	| 'copy'
-	| 'channelDraft'
-	| 'decorationDraft'
+	| 'channelDraft'
+	| 'decorationDraft'
 	| 'drag'
 	| 'pointer'
 
@@ -5274,6 +5342,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 +5394,8 @@ export interface GisViewDecorationDraftOptions {
 	size?: number
 	/** 填充 / 色调，缺省白色 */
 	color?: string
+	/** 提交后的装饰是否跟随所属要素选中色：SVG path 写 strokeColor，其余符号写 color；缺省 false */
+	followSelectColor?: boolean
 	/** 描边色，缺省透明 */
 	strokeColor?: string
 	/** 描边宽度（CSS 像素），缺省 0 */
@@ -5415,6 +5487,7 @@ export interface GisViewDecorationDraftPayload {
 	strokeWidth: number
 	opacity: number
 	parallel: boolean
+	followSelectColor: boolean
 	scope: GisViewDecorationDraftScope
 	maxDistance: number
 	maxPerLine: number
@@ -6157,6 +6230,7 @@ export type GisViewChannelHiddenLineLayout = 'preserve' | 'center'
 /**
  * 框选允许收哪几类要素：节点、独立线路、通道回线，以及线路 / 通道的端点口径。
  * 通道回线只归 channel 这一档管；通道之外的普通线路归 line，两者可以任意组合。
+ * line / channel 按实际折线路径与选框逐线段相交判定，包围盒只用于候选粗筛。
  * `lineEndpoints` / `channelEndpoints` 要求线路 / 通道自己的两端节点都被框住才算命中，
  * 只用于框选、`selectInBox` 与 `exportData({ scope: 'viewport' })`，不参与点击多选。
  */
@@ -6430,6 +6504,10 @@ export type GisViewFeatureName =
 	| 'hover'
 	/** 点击选中（onClick 与 select / selectInBox 这些接口入口不受它限制） */
 	| 'select'
+	/** 不按修饰键的多选：普通点击累加 / 取反 */
+	| 'multiSelect'
+	/** 再次点击已选要素时取消选中 */
+	| 'toggleSelect'
 	/** 框选（默认 Shift + 拖动，随 shortcuts.boxSelect 改变） */
 	| 'boxSelect'
 	/** 拖动节点（含整组拖动） */
@@ -6459,13 +6537,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 给的就是这一份）。
@@ -6828,9 +6914,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
@@ -7089,44 +7178,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。
@@ -7136,6 +7197,7 @@ export interface GisViewOptions {
 	/**
 	 * 框选 / Ctrl 多选允许收哪几类要素：'point' 节点、'line' 独立线路、'channel' 通道回线，
 	 * 另有 'lineEndpoints' / 'channelEndpoints' 只在框选时要求线路 / 通道两端节点都在框内；
+	 * 框选线路 / 通道时按实际折线路径逐线段判定，不用包围盒冒充命中；
 	 * 可写数组任意组合，'all' / true 全开，false / null 全关。
 	 * **不写时保留旧行为**：框选只收节点，Ctrl / 多选点击仍可收节点与线路；
 	 * 写了之后框选与 Ctrl / 多选点击统一按这一份过滤（普通单选、toggleSelect 的取消与接口 select 不受限制）。
@@ -7152,8 +7214,8 @@ export interface GisViewOptions {
 	 */
 	selectionBoxPersistent?: boolean
 	/**
-	 * 选中的要素是否画在所有要素之上（默认 true）：抬层的包括点击 / 拖动 / 待确认合并的节点，
-	 * 以及选中线路所在的整条通道 —— 选中了就一定看得见，与 zIndex 无关；
+	 * 选中的要素是否画在所有要素之上（默认 true）：抬层的包括点击 / 拖动 / 待确认合并的节点、
+	 * 选中线路所在的整条通道，以及它们的 decorations —— 选中了就一定看得见，与 zIndex 无关；
 	 * 关掉之后完全按 zIndex 与数据顺序绘制（十万级数据下抬层会让整份重排一次）
 	 */
 	selectionOnTop?: boolean
@@ -7185,11 +7247,6 @@ export interface GisViewOptions {
 	copy?: GisViewCopyOptions
 	/** 合并节点（**缺省关**：写了这份配置才算开）：把一个节点拖到另一个节点上（考虑碰撞）时怎么确认与怎么并 */
 	merge?: GisViewMergeOptions
-	/**
-	 * 是否允许编辑线路拐点：Ctrl + 点击添加、拖动移动、双击或 Delete 删除；**缺省关**，单条线可用 waypointEditable 覆盖。
-	 * `false`（以及 `features: { waypoint: false }`）会同时关闭新增、移动与删除；没有只关其中一项的细分开关
-	 */
-	waypointEditable?: boolean
 	/** 拐点显示时机：selected 只在线路被选中（或刚加过拐点）时显示，always 始终显示；默认 selected */
 	waypointVisibility?: 'selected' | 'always'
 	/** 拐点样式，缺省为小圆点 */
@@ -8110,8 +8167,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 {
@@ -8131,7 +8192,10 @@ export interface GisViewSceneSnapshot {
 	points: GisViewSceneNode[]
 	clusters: GisViewSceneCluster[]
 	backgroundPoints: GisViewSceneNode[]
+	/** 普通装饰（未随所属要素抬层） */
 	decorations: GisViewSceneNode[]
+	/** 跟着选中线路 / 节点 / 选中线路端点抬层的装饰：画在 raisedLines 之后、raised 之前 */
+	raisedDecorations: GisViewSceneNode[]
 	waypoints: GisViewSceneNode[]
 	/** 选中 / 拖动中的节点（画在最上面） */
 	raised: GisViewSceneNode[]
@@ -8490,6 +8554,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
@@ -9309,9 +9386,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 就是按这几个字段下发的）：
@@ -9334,7 +9411,7 @@ export interface GisViewEngineOptions {
 	hoverThreshold?: number
 	/** 光标配置：逐键合并，只想改一个分类时只写那一项即可 */
 	cursorStyle?: GisViewCursorStyle
-	/** 点是否可拖拽，**缺省关**（组件层由 features.drag 与 options.draggable 一起算，写了 true 才开） */
+	/** 点是否可拖拽（引擎内部字段）：组件层由 features.drag 计算后下发，**缺省关** */
 	draggable?: boolean
 	/** 拖动节点时线路是否实时跟随，默认 true；false 表示停手后一次性更新线路 */
 	liveDrag?: boolean
@@ -9342,14 +9419,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' 连它所在分组、
@@ -9370,7 +9447,7 @@ export interface GisViewEngineOptions {
 	copy?: GisViewCopyOptions
 	/** 合并节点的配置（**缺省关**：写了才算开）：开关、触发时机、像素容差、确认方式与数据合并规则 */
 	merge?: GisViewMergeOptions
-	/** 是否允许编辑拐点，**缺省关** */
+	/** 是否允许编辑拐点，**缺省关**：组件层由 features.waypoint 下发 */
 	waypointEditable?: boolean
 	waypointVisibility?: 'selected' | 'always'
 	waypointStyle?: GisViewPointStyle | null
@@ -9713,6 +9790,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>