gis-view-webgl2 0.1.13 → 0.1.15

package/docs/demos/shared/demoStyle.css

@@ -1,250 +1,250 @@
-/**
- * 几个功能演示共用的外观：浅色卡片 + 深色画布 + 右侧读数栏。
- * 类名统一 dv- 前缀，和 GisViewDemo.vue 里那套 demo-* 互不干扰
- * （综合示例保持原样，功能演示各自短小，共用这一份样式不必各写一遍）。
- */
-.dv-demo {
-	display: grid;
-	grid-template-columns: minmax(0, 1fr) clamp(272px, 23vw, 380px);
-	gap: 14px;
-	align-items: start;
-}
-
-.dv-stage {
-	position: relative;
-	height: clamp(460px, calc(100vh - 320px), 860px);
-	border: 1px solid #e2e9f2;
-	border-radius: 10px;
-	overflow: hidden;
-	background: #f7fafd;
-}
-
-.dv-canvas {
-	height: 100%;
-}
-
-/* 画布右上角的悬浮工具条：全屏 / 适合全部这类「不动数据」的操作 */
-.dv-toolbar {
-	position: absolute;
-	top: 10px;
-	right: 10px;
-	z-index: 3;
-	display: flex;
-	gap: 6px;
-	padding: 5px;
-	border-radius: 8px;
-	background: rgba(255, 255, 255, 0.86);
-	box-shadow: 0 4px 16px rgba(31, 62, 105, 0.14);
-	backdrop-filter: blur(6px);
-}
-
-.dv-toolbar button {
-	padding: 5px 10px;
-	font-size: 12px;
-}
-
-.dv-panel {
-	display: flex;
-	flex-direction: column;
-	gap: 10px;
-	max-height: clamp(460px, calc(100vh - 320px), 860px);
-	overflow: auto;
-	padding-right: 4px;
-}
-
-.dv-group {
-	padding: 12px;
-	border: 1px solid #e2e9f2;
-	border-radius: 10px;
-	background: #fff;
-	box-shadow: 0 8px 24px rgba(31, 62, 105, 0.05);
-}
-
-.dv-group > h3 {
-	display: flex;
-	align-items: center;
-	justify-content: space-between;
-	gap: 8px;
-	margin: 0 0 10px;
-	color: #17233d;
-	font-size: 14px;
-}
-
-.dv-row {
-	display: flex;
-	align-items: center;
-	flex-wrap: wrap;
-	gap: 8px;
-}
-
-.dv-row + .dv-row {
-	margin-top: 8px;
-}
-
-.dv-row label {
-	display: inline-flex;
-	align-items: center;
-	gap: 5px;
-	color: #526b8d;
-	font-size: 12px;
-	cursor: pointer;
-}
-
-.dv-row select {
-	padding: 4px 6px;
-	border: 1px solid #d6e0ec;
-	border-radius: 6px;
-	background: #fff;
-	color: #1f2a44;
-	font-size: 12px;
-}
-
-.dv-row input[type='range'] {
-	width: 118px;
-}
-
-.dv-button {
-	padding: 6px 10px;
-	border: 1px solid #cfdcec;
-	border-radius: 6px;
-	background: #f6f9fd;
-	color: #2f5e94;
-	font-size: 12px;
-	cursor: pointer;
-}
-
-.dv-button:hover {
-	background: #e9f1fb;
-}
-
-.dv-button--primary {
-	border-color: #3678bf;
-	background: #3678bf;
-	color: #fff;
-}
-
-.dv-button--primary:hover {
-	background: #28629e;
-}
-
-.dv-button--danger {
-	border-color: #e7bcbc;
-	background: #fdf4f4;
-	color: #b93b3b;
-}
-
-.dv-button:disabled {
-	opacity: 0.55;
-	cursor: not-allowed;
-}
-
-.dv-readout {
-	margin: 0;
-	padding: 8px 10px;
-	border-radius: 8px;
-	background: #f3f6fa;
-	color: #526b8d;
-	font-size: 12px;
-	line-height: 1.6;
-	word-break: break-all;
-}
-
-.dv-hint {
-	margin: 6px 0 0;
-	color: #8191a8;
-	font-size: 11px;
-	line-height: 1.6;
-}
-
-.dv-log {
-	max-height: 220px;
-	margin: 0;
-	padding: 0;
-	overflow: auto;
-	list-style: none;
-}
-
-.dv-log li {
-	padding: 5px 8px;
-	border-bottom: 1px dashed #e6edf6;
-	color: #526b8d;
-	font-size: 12px;
-	line-height: 1.5;
-}
-
-.dv-log li:last-child {
-	border-bottom: 0;
-}
-
-.dv-log strong {
-	color: #2f5e94;
-	font-weight: 600;
-}
-
-.dv-chips {
-	display: flex;
-	flex-wrap: wrap;
-	gap: 5px;
-}
-
-.dv-chip {
-	padding: 3px 8px;
-	border: 1px solid #d6e0ec;
-	border-radius: 999px;
-	background: #fff;
-	color: #526b8d;
-	font-size: 11px;
-	cursor: pointer;
-}
-
-.dv-chip--active {
-	border-color: #3678bf;
-	background: #eaf2fc;
-	color: #2f5e94;
-	font-weight: 600;
-}
-
-/* 标签右键菜单：贴在指针位置的自绘菜单（演示 labelContextMenu 的用法） */
-.dv-menu {
-	position: fixed;
-	z-index: 60;
-	min-width: 168px;
-	padding: 5px;
-	border: 1px solid #d6e0ec;
-	border-radius: 8px;
-	background: #fff;
-	box-shadow: 0 12px 32px rgba(31, 62, 105, 0.18);
-}
-
-.dv-menu button {
-	display: block;
-	width: 100%;
-	padding: 7px 10px;
-	border: 0;
-	border-radius: 6px;
-	background: transparent;
-	color: #1f2a44;
-	font-size: 12px;
-	text-align: left;
-	cursor: pointer;
-}
-
-.dv-menu button:hover {
-	background: #eef4fc;
-}
-
-.dv-menu__title {
-	padding: 6px 10px 4px;
-	color: #8191a8;
-	font-size: 11px;
-}
-
-@media (max-width: 1080px) {
-	.dv-demo {
-		grid-template-columns: minmax(0, 1fr);
-	}
-
-	.dv-panel {
-		max-height: none;
-	}
+/**
+ * 几个功能演示共用的外观：浅色卡片 + 深色画布 + 右侧读数栏。
+ * 类名统一 dv- 前缀，和 GisViewDemo.vue 里那套 demo-* 互不干扰
+ * （综合示例保持原样，功能演示各自短小，共用这一份样式不必各写一遍）。
+ */
+.dv-demo {
+	display: grid;
+	grid-template-columns: minmax(0, 1fr) clamp(272px, 23vw, 380px);
+	gap: 14px;
+	align-items: start;
+}
+
+.dv-stage {
+	position: relative;
+	height: clamp(460px, calc(100vh - 320px), 860px);
+	border: 1px solid #e2e9f2;
+	border-radius: 10px;
+	overflow: hidden;
+	background: #f7fafd;
+}
+
+.dv-canvas {
+	height: 100%;
+}
+
+/* 画布右上角的悬浮工具条：全屏 / 适合全部这类「不动数据」的操作 */
+.dv-toolbar {
+	position: absolute;
+	top: 10px;
+	right: 10px;
+	z-index: 3;
+	display: flex;
+	gap: 6px;
+	padding: 5px;
+	border-radius: 8px;
+	background: rgba(255, 255, 255, 0.86);
+	box-shadow: 0 4px 16px rgba(31, 62, 105, 0.14);
+	backdrop-filter: blur(6px);
+}
+
+.dv-toolbar button {
+	padding: 5px 10px;
+	font-size: 12px;
+}
+
+.dv-panel {
+	display: flex;
+	flex-direction: column;
+	gap: 10px;
+	max-height: clamp(460px, calc(100vh - 320px), 860px);
+	overflow: auto;
+	padding-right: 4px;
+}
+
+.dv-group {
+	padding: 12px;
+	border: 1px solid #e2e9f2;
+	border-radius: 10px;
+	background: #fff;
+	box-shadow: 0 8px 24px rgba(31, 62, 105, 0.05);
+}
+
+.dv-group > h3 {
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	gap: 8px;
+	margin: 0 0 10px;
+	color: #17233d;
+	font-size: 14px;
+}
+
+.dv-row {
+	display: flex;
+	align-items: center;
+	flex-wrap: wrap;
+	gap: 8px;
+}
+
+.dv-row + .dv-row {
+	margin-top: 8px;
+}
+
+.dv-row label {
+	display: inline-flex;
+	align-items: center;
+	gap: 5px;
+	color: #526b8d;
+	font-size: 12px;
+	cursor: pointer;
+}
+
+.dv-row select {
+	padding: 4px 6px;
+	border: 1px solid #d6e0ec;
+	border-radius: 6px;
+	background: #fff;
+	color: #1f2a44;
+	font-size: 12px;
+}
+
+.dv-row input[type='range'] {
+	width: 118px;
+}
+
+.dv-button {
+	padding: 6px 10px;
+	border: 1px solid #cfdcec;
+	border-radius: 6px;
+	background: #f6f9fd;
+	color: #2f5e94;
+	font-size: 12px;
+	cursor: pointer;
+}
+
+.dv-button:hover {
+	background: #e9f1fb;
+}
+
+.dv-button--primary {
+	border-color: #3678bf;
+	background: #3678bf;
+	color: #fff;
+}
+
+.dv-button--primary:hover {
+	background: #28629e;
+}
+
+.dv-button--danger {
+	border-color: #e7bcbc;
+	background: #fdf4f4;
+	color: #b93b3b;
+}
+
+.dv-button:disabled {
+	opacity: 0.55;
+	cursor: not-allowed;
+}
+
+.dv-readout {
+	margin: 0;
+	padding: 8px 10px;
+	border-radius: 8px;
+	background: #f3f6fa;
+	color: #526b8d;
+	font-size: 12px;
+	line-height: 1.6;
+	word-break: break-all;
+}
+
+.dv-hint {
+	margin: 6px 0 0;
+	color: #8191a8;
+	font-size: 11px;
+	line-height: 1.6;
+}
+
+.dv-log {
+	max-height: 220px;
+	margin: 0;
+	padding: 0;
+	overflow: auto;
+	list-style: none;
+}
+
+.dv-log li {
+	padding: 5px 8px;
+	border-bottom: 1px dashed #e6edf6;
+	color: #526b8d;
+	font-size: 12px;
+	line-height: 1.5;
+}
+
+.dv-log li:last-child {
+	border-bottom: 0;
+}
+
+.dv-log strong {
+	color: #2f5e94;
+	font-weight: 600;
+}
+
+.dv-chips {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 5px;
+}
+
+.dv-chip {
+	padding: 3px 8px;
+	border: 1px solid #d6e0ec;
+	border-radius: 999px;
+	background: #fff;
+	color: #526b8d;
+	font-size: 11px;
+	cursor: pointer;
+}
+
+.dv-chip--active {
+	border-color: #3678bf;
+	background: #eaf2fc;
+	color: #2f5e94;
+	font-weight: 600;
+}
+
+/* 标签右键菜单：贴在指针位置的自绘菜单（演示 labelContextMenu 的用法） */
+.dv-menu {
+	position: fixed;
+	z-index: 60;
+	min-width: 168px;
+	padding: 5px;
+	border: 1px solid #d6e0ec;
+	border-radius: 8px;
+	background: #fff;
+	box-shadow: 0 12px 32px rgba(31, 62, 105, 0.18);
+}
+
+.dv-menu button {
+	display: block;
+	width: 100%;
+	padding: 7px 10px;
+	border: 0;
+	border-radius: 6px;
+	background: transparent;
+	color: #1f2a44;
+	font-size: 12px;
+	text-align: left;
+	cursor: pointer;
+}
+
+.dv-menu button:hover {
+	background: #eef4fc;
+}
+
+.dv-menu__title {
+	padding: 6px 10px 4px;
+	color: #8191a8;
+	font-size: 11px;
+}
+
+@media (max-width: 1080px) {
+	.dv-demo {
+		grid-template-columns: minmax(0, 1fr);
+	}
+
+	.dv-panel {
+		max-height: none;
+	}
 }

package/docs/format/02-/350/212/202/347/202/271/344/270/216/347/272/277/350/267/257.md

@@ -14,7 +14,7 @@
 | `zIndex` | `number` | `0` | 绘制层级：大的盖在上面，同一个值算一层；不参与状态样式，悬停 / 选中不会把它抬层 |
 | `shadow` | `GisViewShadow` | 无（不画阴影） | 阴影：`{ color, blur, offsetX, offsetY }`，偏移与模糊都是 CSS 像素 |
 | `visible` | `boolean` | `true` | `false` 时这个节点不画（等价于被筛选隐藏，但数据还在）；被它锚定的通道与回线一起消失 |
-| `clickable` / `draggable` / `copyable` / `mergeable` | `boolean` | 前两个跟随 `options.clickable` / `options.draggable`（**`options.draggable` 缺省关**：不写它就没有节点可拖，逐条的 `draggable: true` 也得等这个总开关或者 `features.drag` 打开才生效）；`copyable` / `mergeable` 缺省 `true` | 逐条覆盖 `options` 上的同名开关 |
+| `clickable` / `draggable` / `copyable` / `mergeable` | `boolean` | `clickable` 缺省 `true`，实际悬停 / 选中仍要打开 `features.hover` / `features.select`；`draggable` 跟随 `features.drag`（**缺省关**，逐个节点的 `draggable: true` 也要先打开这个总开关）；`copyable` / `mergeable` 缺省 `true` | 逐条覆盖对应的权限（节点的 `draggable` 只影响该节点） |
 | `mergeInfo` | `GisViewMergeInfo \| null` | 无 | `mergePoints` / `mergeSelectedPoints` 写入的合并追溯（版本 `1`）：保留节点保存 `targetPoint`、`sourceIds`、来源 `points` 快照与受影响 `lines` / `channels` 快照；`splitPoint(source)` 省略 `parts` 时据此自动解除合并。可 JSON 序列化，随数据导出；保留字段，业务数据不要占用。字段详解见 [manual 07 的「合并追溯」](../manual/07-%E6%8C%87%E9%92%88%E4%B8%8E%E8%A6%81%E7%B4%A0%E7%BC%96%E8%BE%91.md#%E5%90%88%E5%B9%B6%E8%BF%BD%E6%BA%AFmergeinfo) |
 | `cursor` / `ctrlCursor` | `GisViewCursorValue` | 跟随 `options.cursorStyle.point` / `cursorStyle.ctrl.point` | 悬停这个点时的光标（按住 Ctrl / ⌘ 时用后者），写法见 GisView.md 的「光标」 |
 | `hoverStyle` / `selectStyle` / `multiSelectStyle` / `boxSelectStyle` | `GisViewPointStyle` | 分别跟随 `options.pointHoverStyle` / `pointSelectStyle` / `pointMultiSelectStyle` / `pointBoxSelectStyle`（后两个缺省回落到选中样式） | 逐条覆盖悬停 / 选中 / Ctrl 多选 / 框选样式，按字段覆盖自身样式 |
@@ -35,10 +35,10 @@
 | `color` / `width` / `opacity` / `join` | `string` / `number` | 无 / 无 / `1` / `'round'`（前三个回落到 `lineStyle` → `lineRules` → 内置默认） | 逐条外观：`join` 是拐角样式 `round`（默认，拐角与端点补圆点接头）/ `butt` |
 | `lineType` / `dash` / `dashOffset` | `string` / `GisViewLineDash` / `number` | `'solid'` / 无 / `0` | 线型：`solid` / `dashed` / `dotted` / `dashdot`（与别名），或自定义图案；`dashOffset` 是虚线相位（CSS 像素，可以为负）；认不出的字符串按实线画，`dash` 与 `lineType` 都写时以 `dash` 为准 |
 | `shadow` | `GisViewShadow` | 无（不画阴影） | 阴影 |
-| `visible` / `clickable` / `waypointEditable` | `boolean` | `true` / 跟随 `options.clickable` / 跟随 `options.waypointEditable` | 逐条覆盖开关：`visible: false` 不画；`waypointEditable: false` 时这条线不出拐点（`options.waypointEditable` **缺省关**，要在 options 里写 `waypointEditable: true` 或 `features: { waypoint: true }` 才有拐点编辑） |
+| `visible` / `clickable` / `waypointEditable` | `boolean` | `true` / `true`（实际命中仍要 `features.hover` / `features.select`）/ `true`（实际拐点编辑仍要 `features.waypoint`，**缺省关**） | 逐条覆盖权限：`visible: false` 不画；线路自身 `waypointEditable: false` 时这条线不出拐点（全局仍要打开 `features: { waypoint: true }`） |
 | `cursor` / `ctrlCursor` / `hoverStyle` / `selectStyle` / `multiSelectStyle` | 同节点 | 跟随对应的 `options`（`cursorStyle` / `lineHoverStyle` / `lineSelectStyle` / `lineMultiSelectStyle`） | 逐条覆盖光标与状态样式；通道回线的 `cursor` 以回线自身的为准 |
 | `labels` / `lineLabel` / `lineLabelPosition` / `lineLabelParallel` / `lineLabelOffset` / `lineLabelVisibility` | `GisViewItemLabel[]` / `GisViewLineLabelContent` / 位置 / `boolean` / `[number, number]` / 显隐 | `labels` / `lineLabel*` 都不写时跟随 `options.lineLabel`；`lineLabel: false` = 这条线不显示标签 | 线路标签：`labels` 是逐条清单（推荐，可多条），其余是旧式单条写法；`position` 认 0 ~ 1 比例、`'50%'`、`{ distance }`（世界单位） |
-| `decorations` | `GisViewLineDecoration[]` | 无（空数组 = 不画） | 沿线摆的图片 / SVG 标记（位置、锚点、平行、大小、颜色），见「标记 / 装饰」 |
+| `decorations` | `GisViewLineDecoration[]` | 无（空数组 = 不画） | 沿线摆的图片 / SVG 标记（位置、锚点、平行、大小、颜色；可选 `followSelectColor` 跟随线路选中色，SVG path 写描边，并随选中抬层），见「标记 / 装饰」 |
 | `tooltip` / `heatmap` | 同节点 | 跟随 `options.tooltip` / 不配 `options.heatmap` 就不参与 | 悬浮提示 / 热力图覆盖 |
 | `effect` | `GisViewLineEffectInput` | 跟随 `options.effects.line` | 这条线上的跑动图标：写法同节点，认 `symbol` / `size` / `color` / `strokeColor` / `strokeWidth` / `count` / `spaced` / `period` / `speed` / `offset` / `reverse` / `opacity` / `parallel` / `delay` / `shadow`；位置按**弧长**算（折线拐点连续、不抄近道），见 GisView.md 的「动画效果（effects）」 |
 | `direction` | `GisViewLineDirectionInput` | 跟随 `options.lineDirection` | 这条线上的静态方向箭头（不跑动）：写法同上面的 `effect`（`true` 用全局那一份、对象逐字段覆盖、`false` / `null` 关掉），位置按弧长摆、朝向跟着线路切向（起点 → 终点，`reverse` 指回上游），见 GisView.md 的「线路方向箭头（lineDirection）」 |

package/docs/format/03-/346/213/220/347/202/271/350/243/205/351/245/260/344/270/216/346/240/267/345/274/217.md

@@ -65,8 +65,11 @@ view.exportData({ format: 'test', parts: ['waypoint'] })
 | `parallel` | `boolean` | `false` | 符号是否跟着线路方向转（按锚点处的路径切向） |
 | `size` | `number` | `18` | 屏幕尺寸（CSS 像素）；跟着 `pointSizeScale` 与缩放档位走 |
 | `color` / `strokeColor` / `strokeWidth` | `string` / `string` / `number` | `'#ffffff'` / 透明 / `0` | 填充 / 描边色 / 描边宽（只在形状与 SVG 符号上有意义，位图不受影响） |
+| `followSelectColor` | `boolean` | `false` | 所属线路 / 节点被选中时是否改用其最终选中色：`symbol` 为 `{ type: 'svg', path }` 时写 `strokeColor`，其他符号写 `color`；取消选中后恢复装饰自身颜色 |
 | `opacity` / `shadow` | `number` / `GisViewShadow` | `1` / 无 | 透明度与阴影，与节点同一套 |
 
+装饰会随所属要素一起抬层：选中线路 / 通道回线的装饰排在抬层线路之后，选中节点与选中线路端点节点的装饰排在抬层节点之前；普通装饰留在普通层。`followSelectColor` 在 SVG path 上改描边、其他符号改填充 / 色调；`selectionOnTop: false` 只取消抬层、不改变变色规则。
+
 运行时读写：`getLineDecorations(id)`（副本）/ `setLineDecorations(id, list)`（整份换，空数组 = 全摘掉）/
 `addLineDecoration(id, decoration)`（追加，返回加进去的那一条）/ `updateLineDecoration(id, index, patch)`（只合并第 `index` 条）/
 `removeLineDecoration(id, index)`（摘掉某一条）。

package/docs/from0/01-/345/205/210/346/212/212/345/234/260/345/233/276/346/203/263/346/270/205/346/245/232.md

@@ -60,10 +60,10 @@ const unprojectPoint = (x, y) => [
 （绕整体范围中心压一压，纬度不动），否则按「1 度经度 = 1 度纬度」画出来的地图会被拉长。
 于是解析结果里有两份范围：
 
-- `rawBounds`：缩放前的真实经纬度范围 —— 相机落位、`fitView`、坐标反算用它；
-- `bounds`：缩放之后真正画出来的范围 —— 判断「数据在不在视野里」用它。
+- `rawBounds`：缩放前的真实经纬度范围 —— 相机落位与 `fitView` 的基准；
+- `bounds`：应用 `aspectScale`、`geoJsonStyle.bounds` 与 `rotation` 之后真正画出来的轴对齐范围 —— 判断「数据在不在视野里」用它。
 
-两者之间的换算在 `projection.js`（纯函数），`create.js` 把它挂成实例方法：
+解析结果另外用 `drawTransform` 记录最终的缩放、平移、中心与旋转角。这两层换算都在 `projection.js`（纯函数），`create.js` 把最终投影挂成实例方法：
 
 ```js
 const projection = view.getGeoProjection()   // 没有 GeoJSON 底图时是 null
@@ -79,7 +79,7 @@ view.getPointer()                            // { inside, screen, world, lngLat
 
 ```js
 const mapper = view.createGeoMapper({
-  mode: 'fit',   // 'lngLat' 数据就是经纬度（完全贴合）| 'fit' 等比铺进底图 | 'scale'（默认）按比例
+  mode: 'fit',   // 'lngLat' / 'scale' 以最终底图为基准 | 'fit' 任意坐标等比铺进底图
   scale: 1,      // 节点与 geojson 的大小比例：1 是各模式的基准，越大数据铺得越开
   padding: 0.08, // fit 模式四周留白（占底图短边比例）
   data: view.getData()
@@ -88,9 +88,10 @@ const data = view.getData()
 view.updateData(data.points.map(mapper.mapPoint), data.lines.map(mapper.mapLine))
 ```
 
-`mapPoint` / `mapLine` / `mapChannel` / `mapData` 都是「复制一份再换坐标」，原数据不动；通道两端
-锚的是节点 id，映射之后依旧对得上。节点尺寸与线宽仍然是 CSS 像素（`pointSizeScale` /
-`pointZoomScale` 照旧生效），所以「数据铺多大」与「节点画多大」是两件事，可以分开调。
+`mapPoint` / `mapLine` / `mapChannel` / `mapData` 都是「复制一份再换坐标」，原数据不动；坐标写成
+`[x, y]` 或 `{ x, y }` 都认，通道分组路径与固定坐标装饰也会一起换。通道两端锚的是节点 id，
+映射之后依旧对得上。节点尺寸与线宽仍然是 CSS 像素（`pointSizeScale` / `pointZoomScale` 照旧
+生效），所以「数据铺多大」与「节点画多大」是两件事，可以分开调。
 
 ### 0.4 文件职责
 

package/docs/index.html

@@ -1421,7 +1421,7 @@
 				{ file: 'manual/14-视图与筛选.md', title: '手册 14 · 视图与筛选', blurb: '筛选 / 搜索 / 视图与背景', parent: 'GisView.md' },
 				{ file: 'manual/15-导出与集成.md', title: '手册 15 · 导出与集成', blurb: '导出 / 插件 / 自建界面', parent: 'GisView.md' },
 				{ file: 'manual/16-实例方法总表.md', title: '手册 16 · 实例方法总表', blurb: '实例方法主表', parent: 'GisView.md' },
-{ file: 'manual/17-参数速查.md', title: '手册 17 · 参数速查', blurb: '283 个成员逐个列全', parent: 'GisView.md' },
+			{ file: 'manual/17-参数速查.md', title: '手册 17 · 参数速查', blurb: '285 个成员逐个列全', parent: 'GisView.md' },
 				{ file: 'manual/18-逐方法示例.md', title: '手册 18 · 逐方法示例', blurb: '每个成员一段示例', parent: 'GisView.md' },
 				{ file: 'manual/19-读数与拖拽预览.md', title: '手册 19 · 读数与拖拽预览', blurb: '读数 / 定位 / 落点预览', parent: 'GisView.md' },
 				{ file: 'manual/20-性能与大数据.md', title: '手册 20 · 性能与大数据', blurb: '大数据开关与实测', parent: 'GisView.md' },
@@ -1492,7 +1492,7 @@
 				{ file: '../src/gis-view/README.md', title: 'src/gis-view/README.md', blurb: '源码导读与逐轮实现记录' }
 			]
 			const PAGES = [
-{ href: 'api/index.html', title: 'API 速查（方法 + 示例）', blurb: '274 个实例成员 / 100 个 options，逐个带示例与复制' },
+			{ href: 'api/index.html', title: 'API 速查（方法 + 示例）', blurb: '285 个实例成员 / 100 个 options，逐个带示例与复制' },
 				{ href: 'playground/index.html', title: '调试演示页（粘代码就跑）', blurb: '左侧编辑、右侧真实实例 + GeoJSON 底图：内置示例与「这一份文档」的示例同在一个下拉，粘代码直接跑' },
 				{ href: 'guide/sample-document.html', title: 'sample-document.json 图解', blurb: '点数据看端点 / 拐点 / 分组骨架' },
 				{ href: 'steps/index.html', title: '从 0 手写分步 demo', blurb: '13 步，每步一个文件' },
@@ -2074,7 +2074,7 @@
 				{ badge: 'START', title: '第一次使用', desc: '引入、最小数据与首屏配置，先把图画出来。', meta: '01 快速开始 · 约 10 分钟', file: 'manual/01-快速开始.md' },
 				{ badge: 'BACKEND', title: '接后端与导出', desc: '编辑接口、导出回灌、插件与自建界面。', meta: '15 导出与集成', file: 'manual/15-导出与集成.md' },
 				{ badge: 'PERF', title: '十万级性能', desc: 'Worker 筛选 / 异步搜索、批量更新与质量档。', meta: '20 性能与大数据', file: 'manual/20-性能与大数据.md' },
-{ badge: 'API', title: '查方法与参数', desc: '实例方法、options 与可复制示例集中检索。', meta: 'API 速查 · 283 个成员', href: 'api/index.html', external: true }
+		{ badge: 'API', title: '查方法与参数', desc: '实例方法、options 与可复制示例集中检索。', meta: 'API 速查 · 285 个成员', href: 'api/index.html', external: true }
 			]
 			const renderReadingPaths = () => `<section class='doc-paths' aria-label='推荐阅读路径'>` +
 				`<div class='doc-paths__head'><strong>按任务选一条阅读路径</strong><span>第一次进来先看快速开始；带着明确目标时直接跳到对应章节。</span></div>` +

package/docs/internals/04-/347/233/270/346/234/272/345/235/220/346/240/207/344/270/216/345/203/217/347/264/240.md

@@ -42,12 +42,14 @@ pixelRatio   = clamp(min((配置的 pixelRatio ?? devicePixelRatio) * displaySca
 经纬度与 GeoJSON 的换算在 `projection.js`（纯函数，不依赖 DOM 与 WebGL）：
 
 ```js
-// 只压经度、绕整体 bbox 中心，与 ECharts 的 geo.aspectScale 同义
-project(lng, lat) = [centerX + (lng - centerX) * aspectScale, lat]
-unproject(x, y)   = [centerX + (x - centerX) / aspectScale, y]
+// 第一步：只压经度、绕整体 bbox 中心，与 ECharts 的 geo.aspectScale 同义
+base = [centerX + (lng - centerX) * aspectScale, lat]
+// 第二步：geoJsonStyle.bounds / rotation 的缩放、平移和绕目标中心旋转
+project(lng, lat) = rotate(base * drawScale + drawOffset)
+unproject(x, y)   = inverseAspect(inverseRotate((x, y) - drawOffset) / drawScale)
 ```
 
-`createGeoProjection(source)` 吃 `buildGeoJsonShapes` / `resolveGeoJson` 的结果（带 `rawBounds` 与 `aspectScale`）：`rawBounds` 是缩放前的真实范围，相机与 `fitView` 用它，`bounds` 是画出来的范围，两者之差就是投影要补的那一段。`createGeoMapper(source, options)` 在这之上给出三种数据搬运方式：`'lngLat'` 套同一个 `aspectScale`（数据本身就是经纬度时与底图严丝合缝）、`'fit'` 把任意坐标系的数据等比铺进底图范围（contain + `padding`，长宽比不变）、`'scale'`（默认）围绕底图中心按 `scale` / `scaleX` / `scaleY` 缩放再叠 `offsetX` / `offsetY`。指针侧 `create.js` 缓存一份投影（按解析出来的 GeoJSON 引用比对，指针事件这种高频路径不重复解析），`lngLatToWorld` / `worldToLngLat` / `lngLatToScreen` / `screenToLngLat` / `getPointer()` 与 `onPointer` 都走它。
+`createGeoProjection(source)` 吃 `buildGeoJsonShapes` / `resolveGeoJson` 的结果（带 `rawBounds`、`aspectScale` 与可选的 `drawTransform`）：`rawBounds` 是缩放前的真实范围，相机与 `fitView` 用它，`bounds` 是最终画出来的轴对齐范围。`resolveGeoJson()` 记录 `geoJsonStyle.bounds / rotation` 实际使用的缩放、平移、中心与角度，所以 `project` / `unproject` 不会再只算 `aspectScale`。`createGeoMapper(source, options)` 在这之上给出三种数据搬运方式：`'lngLat'` / `'scale'` 复用同一份最终投影（数据本身就是经纬度时与底图严丝合缝，后者再叠比例与偏移）、`'fit'` 把任意坐标系的数据等比铺进底图范围（contain + `padding`，长宽比不变）。映射坐标同时认 `[x, y]` 与 `{ x, y }`：`mapLine` / `mapChannel` 换 `path`、`start`、`end`，节点 / 线路的固定坐标装饰换 `at` 与坐标型 `position`，`mapChannel` 还换 `groups[].path`；`waypointOffsets` 是相对向量，用 `map(offset) - map([0, 0])` 换，不能套带平移的点映射。`boundsOfData` 从节点、线路几何、通道 / 分组路径与固定坐标装饰一起算 fit 范围。指针侧 `create.js` 缓存一份投影（按解析出来的 GeoJSON 引用比对，指针事件这种高频路径不重复解析），`lngLatToWorld` / `worldToLngLat` / `lngLatToScreen` / `screenToLngLat` / `getPointer()` 与 `onPointer` 都走它。
 
 ---
 

package/docs/internals/14-/350/203/214/346/231/257/345/261/202.md

@@ -4,8 +4,8 @@
 
 - **图片来源**：`background.js` 先把 `src` 归一成能解码的东西 —— URL / dataURL 交给 `Image`；传进来的 `<img>` / `<canvas>` / `<svg>` 元素直接用（SVG 元素走 `XMLSerializer` → dataURL）；只给 SVG 路径的 `d` 字符串时用 `getBBox()` 量外框、按 `pathStyle` 上色后包成一份 SVG。资产按 key 缓存，纹理与「原图元素」一起存：鹰眼图用 Canvas2D 直接 `drawImage`，不需要 WebGL 贴图。
 - **摆放**：`buildCornersQuad` 把四个角（左上 / 右上 / 右下 / 左下）变成 `[x, y, u, v] × 4`；`buildBackgroundQuad` 按 `bounds`（缺省用数据范围）与 `fit` 算 quad —— `contain` / `cover` / `stretch` / `center`（`center` 用 `size` 给世界单位下的原尺寸）。四边形直接喂 `imageProgram`。
-- **GeoJSON**：`geojson.js` 的 `buildGeoJsonShapes` 按 Feature 分组解析（每个区域保留原始环、包围盒与重心，区域中心取最大外环的面积重心），多边形走耳切三角化（带洞时先桥接再三角化），线进线路批次，点位要素按 `symbol` 走符号管线。`resolveGeoJson` 再把样式叠上去：整体色 → `regions`（按名字精确覆盖）→ `itemStyle(params)`（最后生效），输出三份形态 —— `regions`（小图与区域文字用）、`fillBuckets` / `strokeGroups` / `pointGroups`（WebGL 按颜色 / 线宽 / 半径成批画）、合并后的 `fills` / `strokes` / `points`（老调用方不用改）。
-- **aspectScale**：与 ECharts 的 `geo.aspectScale` 一致 —— 解析时坐标原样保留，解析完再围绕整体范围的 x 中心把经度乘一遍（只压经度、纬度不动）。`rawBounds` 存缩放前的真实范围，相机落位与 `fitView` 用它；`bounds` 是画出来的范围。
+- **GeoJSON**：`geojson.js` 的 `buildGeoJsonShapes` 按 Feature 分组解析（每个区域保留原始环、包围盒与重心，区域中心取最大外环的面积重心），多边形走三角剖分（带洞时先桥接再三角化），线进线路批次，点位要素按 `symbol` 走符号管线。环会先去掉闭合尾点、非法点与相邻重复点，避免重复铺描边和退化耳朵；凸环走 O(n) 扇形剖分，其余环用 prev / next 双链表做耳切并先用三角形包围盒剔除候选点，不再每个耳朵 `splice` 一次活动数组。`resolveGeoJson` 再把样式叠上去：整体色 → `regions`（按名字精确覆盖）→ `itemStyle(params)`（最后生效），输出三份形态 —— `regions`（小图与区域文字用）、`fillBuckets` / `strokeGroups` / `pointGroups`（WebGL 按颜色 / 线宽 / 半径成批画）、合并后的 `fills` / `strokes` / `points`（老调用方不用改）。
+- **aspectScale 与最终摆放**：与 ECharts 的 `geo.aspectScale` 一致 —— 解析时坐标原样保留，解析完再围绕整体范围的 x 中心把经度乘一遍（只压经度、纬度不动）。`rawBounds` 存缩放前的真实范围；`geoJsonStyle.bounds / rotation` 再把整份底图缩放到目标矩形并旋转，`bounds` 是最终画面的轴对齐范围，`drawTransform` 记录实际缩放 / 平移 / 中心 / 角度。`projection.js` 会把这层也合成进 `project` / `unproject`，所以经纬度、事件 `lngLat` 与数据映射都以屏幕上最终底图为准。
 - **区域文字**：解析出的世界坐标 + 字号 / 颜色交给覆盖层的背景标签层（`.gis-view__label-layer--geo`），`labelBoxes()` 把它算进导出图片，所以背景文字也进导出的图。
 - 图片与 GeoJSON 都在**世界坐标**里画，跟随相机平移缩放；背景重新解析（图片解码完成、GeoJSON 变化）会触发一次 `buildScene()`：背景里的线也进线路批次，因此要整份重排，`onBackgroundChange` 让鹰眼图跟着重画。
 - **内置编辑器**：`background-editor.js` 是可选的表现层，不在普通渲染路径里。第一次 `beginBackgroundEdit()` 才创建 DOM 覆盖层，从 `background.image.corners` 或 `geoJsonStyle.bounds + rotation` 反推中心 / 宽高 / 角度；拖动统一投影到背景局部坐标后计算，图片写回四角，GeoJSON 写回目标矩形与角度，其余背景字段保留。指针手势合并到动画帧，帧内用 `updateBackground()` 提交并以 `refresh({ reflow: false })` 重绘，覆盖层与 WebGL 底图同帧移动。`endBackgroundEdit()` 移除覆盖层并恢复进入前的 `backgroundEditing`，`destroy()` 同样清理。