refactor: 合并 master 至 consolidate-packages，调和 source 重构冲突

master 的 @antv/l7-source 渐进式重构(#2882)与本分支搬运(source→layers)冲突，逐类解决：

- layers/src/source 与 __tests__/source 完整采用 master 新结构
  (tile-source/、parser/ndi.ts、base-source.ts、create-source.ts 等)
- relative-coordinates 已由 master 上移至 @antv/l7-utils，保留 utils 版本
- maps 底图迁移：采用 master 的 BaseMap/MapboxBaseMap 新结构，
  @antv/l7-map 引用改 ../mapbase（map 包已并入 maps/src/mapbase）
- BaseLayer: @antv/l7-source → ../source，保留 master 的 processRelativeCoordinates
- 删除被合并包(source/component/map/renderer)残留，版本号同步 master 2.30.0-beta.0
- l7/layers/scene 顶部元数据冲突取 master 版本号；test-utils 保留 peerDependencies
- __tests__/source 测试相对路径同步调整(../src → ../../src/source)

构建验证：layers(271) / maps(88) / scene(66) / l7(UMD 1.4M < 1.7Mb) 全部通过

Author: lzxue

.changeset/fix-maps-bmap-tmap-types.md

@@ -0,0 +1,33 @@
+---
+'@antv/l7-maps': patch
+---
+
+fix(maps): 补全 BMap/TMap SDK 类型声明，修复 father dts 生成失败
+
+PR #2878 将 bmap/tmap 迁移到 BaseMap 后，maps 包全量 build 在
+father 的 declaration 生成阶段中断 (exit 1)，阻塞 fixed group
+整体发布。根因是第三方 SDK 类型缺失运行时存在、但 .d.ts 未声明的
+成员：
+
+- @types/bmapgl 的 BMapGL.Map 未声明 on/off/getMinZoom/getMaxZoom
+  (bmap/map.ts 直接 this.map.on(...)/getMinZoom() 调用报 TS2339/2551)
+- @map-component/tmap-types 的 TMap.Map 未声明 getContainer/panBy
+  (tmap/map.ts 7 处 getContainer + panBy 报 TS2339，连带
+  addEventListener 回调 e 隐式 any)
+
+修法 (补类型声明，非 as any 投机转换):
+
+- 新增 packages/maps/map-sdk-augmentation.d.ts (ambient，与现有
+  style.d.ts 同级，tsconfig 默认 include 覆盖):
+  通过 namespace 接口合并为 BMapGL.Map 补 on/off/getMinZoom/
+  getMaxZoom，为 TMap.Map 补 getContainer()/panBy([x,y])。
+  无运行时代码，仅声明增强。
+- bmap/map.ts: 补 public version: string = BMAP_VERSION 声明
+  (对齐 maplibre/map.ts、map/map.ts 惯例；此前只赋值未声明)
+- bmap/tmap map.ts: handleCameraChanged 中
+  this.cameraChangedCallback(...) 改 ?. 可选调用，与 BaseMap
+  updateView 一致 (cameraChangedCallback 为可选属性)
+
+验证: pnpm --filter @antv/l7-maps build 0 error (48 files)，
+pnpm 全量 build 通过 (fixed group 解除阻塞)，eslint 0 error。
+无运行时行为变更。

.changeset/fix-test-utils-redundant-peerdeps.md

@@ -0,0 +1,26 @@
+---
+'@antv/l7-test-utils': patch
+---
+
+fix(test-utils): 移除冗余 peerDependencies，修复 changeset 版本计算误判 major
+
+@antv/l7-test-utils 同时在 dependencies 与 peerDependencies 声明了
+@antv/l7-map / @antv/l7-maps / @antv/l7-scene (workspace:^)。
+peerDependencies 对内部兄弟包是语义错误 (test-utils 是开发工具,
+不应让消费者"提供"这些包), 且触发 changesets 的 peer-dependent
+major bump:
+
+- changesets 默认 onlyUpdatePeerDependentsWhenOutOfRange=false,
+  任一 peer (l7-maps/l7-scene) 获 non-patch (minor) release 时,
+  强制将 test-utils 提升为 major
+- fixed group ["@antv/l7","@antv/l7-*"] 随之把全组 (含 l7-source)
+  拉到 major → 2.30.0-beta.0 被错误算成 3.0.0-beta.0
+
+这阻塞了 source 重构 beta 发布 (5 minor + 14 patch changeset 却
+算出 major)。
+
+修法: 删除 peerDependencies (三包已在 dependencies, 行为等价且
+更正确)。已用 @changesets/get-release-plan 验证: 移除后全组正确
+算为 minor → 2.30.0-beta.0, 0 major。
+
+无运行时行为变更 (依赖关系不变, 仅声明位置纠正)。

.changeset/pre.json

@@ -0,0 +1,41 @@
+{
+  "mode": "pre",
+  "tag": "beta",
+  "initialVersions": {
+    "@antv/l7-component": "2.29.1",
+    "@antv/l7-core": "2.29.1",
+    "@antv/l7": "2.29.1",
+    "@antv/l7-layers": "2.29.1",
+    "@antv/l7-map": "2.29.1",
+    "@antv/l7-maps": "2.29.1",
+    "@antv/l7-renderer": "2.29.1",
+    "@antv/l7-scene": "2.29.1",
+    "@antv/l7-source": "2.29.1",
+    "@antv/l7-test-utils": "2.29.1",
+    "@antv/l7-three": "2.29.1",
+    "@antv/l7-utils": "2.29.1",
+    "@antv/l7-site": "2.21.4"
+  },
+  "changesets": [
+    "fix-maps-bmap-tmap-types",
+    "fix-test-utils-redundant-peerdeps",
+    "refactor-source-01",
+    "refactor-source-02",
+    "refactor-source-03",
+    "refactor-source-04",
+    "refactor-source-06",
+    "refactor-source-07",
+    "refactor-source-08",
+    "refactor-source-09",
+    "refactor-source-10",
+    "refactor-source-11",
+    "refactor-source-12",
+    "refactor-source-13",
+    "refactor-source-14",
+    "refactor-source-15",
+    "refactor-source-16",
+    "refactor-source-17",
+    "refactor-source-18",
+    "refactor-source-19"
+  ]
+}

.changeset/refactor-source-01.md

@@ -0,0 +1,15 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): dedupe interface types with @antv/l7-core via re-export
+
+将 source/interface.ts 中与 @antv/l7-core 重复的 7 个类型改为 re-export，
+单一来源收敛到 core。纯 type-only 变更，运行时无影响。
+
+- 重复类型：DataType / IDictionary / IFeatureKey / IJsonData / IJsonItem /
+  IParseDataItem / IParserData
+- 保留 source 专有类型原地定义（栅格波段运算、瓦片数据源等）
+- IRasterCfg 因 core 版本不完整暂保留，后续统一
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 0.1。

.changeset/refactor-source-02.md

@@ -0,0 +1,14 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): fix misspellings in private members (stage 0.2)
+
+私有方法/局部参数重命名，无对外 API 影响：
+
+- base-source.ts: excuteParser → executeParser (private)
+- base-source.ts: caculClusterExtent → calcClusterExtent (private)
+- factory.ts: registerTransform 参数 transFunction → transformFn
+  （改为 transformFn 而非 transformFunction，避免与已有类型别名同名遮蔽）
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 0.2。

.changeset/refactor-source-03.md

@@ -0,0 +1,15 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): add strict cfg interfaces for transforms (stage 0.3)
+
+为 5 个内置 transform（filter/map/join/grid/hexagon）新增严格 cfg interface，
+内部 narrow 到具体类型获得推导。运行时零变化，ITransform index signature
+保留作过渡兼容。
+
+- 新增 src/transform/types.ts: StatMethod + 6 个 cfg interface
+- filter/map/join/grid/hexagon: 内部 const cfg = option as IXxxCfg
+- cluster 已用 Partial<IClusterOptions>, 未动
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 0.3。

.changeset/refactor-source-04.md

@@ -0,0 +1,17 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): flatten parser/raster subdir and fix function names (stage 0.4)
+
+扁平化 parser/raster 子目录 + 修正复制粘贴遗留的函数名:
+
+- parser/raster/rgb.ts -> parser/rgb.ts, 函数名 rasterRgb -> rgb
+- parser/raster/ndi.ts -> parser/ndi.ts, 函数名 rasterRgb -> ndi
+- parser/rasterRgb.ts (注册名 rasterRgb) 保持不变, 功能与 rgb/ndi 各异
+- index.ts 更新 import 路径
+
+注: 三个 raster*Rgb parser 注册名/功能均不同, 非重复代码,
+本次仅命名/位置整理, 运行时无影响, 27/27 单测通过。
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 0.4。

.changeset/refactor-source-06.md

@@ -0,0 +1,29 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): rename source/ to tile-source/ and rename classes (stage 0.6)
+
+重命名 `src/source/` 目录为 `src/tile-source/`（实为「瓦片数据源」)，
+两个同名 `VectorSource` class 拆分为语义清晰的名字，对外 API 完全兼容：
+
+- `git mv` 保留历史:
+  - source/vector.ts -> tile-source/mvt.ts, class VectorSource -> MVTSource
+  - source/geojsonvt.ts -> tile-source/geojsonvt.ts, class VectorSource -> GeoJSONVTTileSource
+  - source/index.ts -> tile-source/index.ts (重写为兼容别名导出)
+- `git rm source/baseSource.ts`（抽象类死代码, 无继承者）
+- tile-source/index.ts: 导出 MVTSource / GeoJSONVTTileSource，
+  保留 `VectorSource` 作 @deprecated 兼容别名 (= MVTSource)
+- src/index.ts: export * from './tile-source/index'
+- 3 个 parser (mvt/geojsonvt/jsonTile) 更新 import 路径与 new 的类名
+
+兼容性:
+
+- layers 包 `import type { VectorSource } from '@antv/l7-source'`
+  (packages/layers/src/tile/tile/VectorTile.ts) 经兼容别名仍可用, 零改动
+- VectorSource 正式移除留待阶段 7 (届时同步 layers 改用 MVTSource)
+
+验证: source tsc 0 错(基线 31 不变)、layers tsc 229 pre-existing 无新增、
+prettier 通过、jest 27/27 通过。
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 0.6。

.changeset/refactor-source-07.md

@@ -0,0 +1,35 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): extract ClusterManager delegate from base-source (stage 1.1)
+
+从 base-source.ts God Class 抽出 cluster 状态机到独立 ClusterManager
+delegate，对外 API 完全等价（ISource 接口不动）。
+
+- 新增 src/cluster-manager.ts (138 行): 封装 Supercluster 索引 +
+  clusterOptions + init/updateData/getClusters/getClustersLeaves/calcExtent
+- base-source.ts (358 -> 314 行, -44):
+  - cluster/clusterOptions 字段 -> accessor 透明转发 delegate
+  - 删除 clusterIndex 字段，getClusters*/updateClusterData 改转发
+  - initCluster/calcClusterExtent 删除，processData 改调
+    clusterManager.init
+  - destroy 改调 clusterManager.destroy
+
+设计要点:
+
+- 构造期 new ClusterManager 注入 extent/invalidExtent getter 闭包，
+  delegate 不拥有 extent 状态 (留待阶段 1.4 抽 Bounds)
+- updateClusterData 拆成 delegate.updateData 返回 IParserData +
+  Source 转发赋值并 executeTrans，delegate 与 transform 链解耦
+- 未启用 cluster 时 getClusters/updateClusterData 仍抛 TypeError
+  (index 为 null)，与原行为一致，不加额外 guard
+
+兼容性: layers 包 source.cluster / source.clusterOptions.zoom /
+source.updateClusterData() 零改动继续可用。
+
+验证: source tsc 0 错 (基线 31 不变)，layers tsc 229 pre-existing
+无新增，eslint/prettier 通过，jest 27/27 通过 (source.spec.ts 的
+cluster case 覆盖 updateClusterData 路径)。
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 1.1。

.changeset/refactor-source-08.md

@@ -0,0 +1,32 @@
+---
+'@antv/l7-source': patch
+---
+
+refactor(source): extract TilesetAdapter delegate from base-source (stage 1.2)
+
+从 base-source.ts 抽出瓦片管理职责到独立 TilesetAdapter delegate，
+对外 API 完全等价（ISource 接口不动）。
+
+- 新增 src/tileset-adapter.ts (88 行): 封装 TilesetManager 实例的
+  创建/更新/销毁 + 7 个 reload/getTile 转发方法
+- base-source.ts (314 -> 306, -8):
+  - tileset/isTile 字段 -> getter 转发 adapter.manager/.isTile
+  - 删除 initTileset(), executeParser 改调 tilesetAdapter.init
+  - 7 个 reload*/getTile* 方法实现体改为转发 adapter
+  - destroy 改调 tilesetAdapter.destroy
+
+关键设计: adapter.manager 必须 public —— layers/tile/core/BaseLayer.ts
+直接读 source.tileset as TilesetManager 后自由操作实例 (update/on/
+destroy/tiles.filter/currentTiles)。getter 转发 adapter.manager
+让 layers 拿到同一个 TilesetManager 实例, 行为完全等价。
+
+tileset/isTile 从字段改 getter only: ISource 接口字段契约由 getter
+满足；Source 内部不再写 this.tileset/this.isTile (改调 adapter.init)。
+isTile 不主动重置, 与原 initTileset 行为一致。reloadTilebyId 沿用
+原小写 b 拼写避免破坏接口。
+
+验证: source tsc 0 错 (基线 31 不变), layers tsc 229 pre-existing
+无新增, eslint/prettier 通过, source jest 27/27 通过, source+layers
+jest 81 passed/1 skipped/0 failed (瓦片图层运行时路径覆盖)。
+
+详见 docs/refactoring/source/PROGRESS.md 阶段 1.2。