refactor(maps): migrate bmap & tmap to BaseMap, delete BaseMapService

[lzxue]

背景

承接 #2875 (gmap/tdtmap 迁移) 与 #2877 (mapbox 四兄弟迁移到 MapboxBaseMap) 的基座改造收尾。BaseMapService 此前作为 BaseMap 的过渡兼容层被 @deprecated 标记, 仅剩 bmap / tmap 两个消费者。本 PR 将二者迁移完成后, 一次性删除 466 行历史死代码。

改动

bmap/map.ts

• extends BaseMapService<BMapGL.Map> → extends BaseMap<BMapGL.Map>
• 移除 // TODO: 基于抽象类 BaseMap 实现 注释
• $mapContainer → mapContainer (与基类统一命名, 3 处)
• 补全 BaseMap 声明为 abstract 的 3 个小方法:
  • getMapStyle() → '' (bmap 无 mapbox getStyle API, 用 setMapStyleV2 + currentStyle 跟踪)
  • setMaxZoom(max) / setMinZoom(min) → this.map.setMaxZoom?.(max) 可选调用兼容

tmap/map.ts

• extends BaseMapService<TMap.Map> → extends BaseMap<TMap.Map>
• 移除 TODO 注释; $mapContainer → mapContainer (2 处)
• 补全 4 个 abstract 方法:
  • getMapStyle() → ''
  • getMapStyleConfig() → MapTheme (新增 import { MapTheme } from '../utils/theme')
  • setMaxZoom / setMinZoom → (this.map as any).setMaxZoom?.(max) (TMap 无可靠 setter, no-op 安全)

删除

• packages/maps/src/utils/BaseMapService.ts (466 行 @deprecated)
• utils/index.ts 移除 BaseMapService 导出 (保留 BaseMapWrapper, 仍被各 wrapper 使用)

语义说明

• 迁移为机械替换 + 补 stub, 不改运行时行为。bmap/tmap 原本就 self-implement 几乎全部方法, 仅继承自 BaseMapService 的几个 stub 现显式落到子类, 行为一致。
• setMaxZoom/setMinZoom 在 BaseMapService 里是 @deprecated 空实现 (throw 'Method not implemented'), bmap 现实现为可选调用 map.setMaxZoom?.(max), 行为更合理且与 gmap/tdtmap 一致, 属微小增强而非破坏性变更。

验证

• tsc --noEmit -p packages/maps 仅 4 个本地 @types 全局错误 (baseline: tmap-types / amap-js-api / bmapgl / google.maps)
• packages/maps/src/{bmap,tmap,utils} 无新增 ts 错误
• prettier format-check 全绿 (organize-imports 未破坏任何在用 import)

收益

迁移后 basemap 类继承结构最终收敛为:

• BaseMap (抽象基类, ~240 行)
• MapboxBaseMap extends BaseMap (mapbox 中间基类, refactor(maps): migrate mapbox family (map/mapbox/maplibre/earth) to MapboxBaseMap #2877)
• 各具体 Service 直接 extends BaseMap / extends MapboxBaseMap

彻底移除 BaseMapService 历史包袱, 后续地图适配器只需面向 BaseMap 单一抽象。

[changeset-bot]

⚠️ No Changeset found

Latest commit: b3cacd0

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[gemini-code-assist]

Code Review

This pull request refactors the map services by removing the deprecated BaseMapService abstract class and migrating BMapService and TMapService to extend the new BaseMap class. It also implements missing methods such as setMaxZoom, setMinZoom, and getMapStyle in both services. The feedback suggests returning this.currentStyle instead of an empty string in BMapService.getMapStyle(), and using setOptions to correctly apply zoom limits in TMapService since Tencent Map does not support direct setMinZoom/setMaxZoom methods.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.