refactor(maps): migrate mapbox family (map/mapbox/maplibre/earth) to MapboxBaseMap

[lzxue]

背景

前期将非 Mapbox 适配器（amap-next / gmap / tdtmap，见 #2875）从废弃的 BaseMapService 迁移到 BaseMap。本 PR 推进 Mapbox 家族四个适配器（map / mapbox / maplibre / earth）的同类迁移，作为后续删除 BaseMapService 的中间铺路步骤。

改动

新增

• `packages/maps/src/lib/mapbox-base-map.ts`（~350 行）：抽出的 `MapboxBaseMap extends BaseMap<Map & T> implements IMapService<Map & T>` 中间基类，承载原先分散在 `BaseMapService` 中的 ~30 个 Mapbox 专用具体实现：
  • 事件代理：`on` / `off`（保留 handler→proxy 映射用于精确解绑）
  • 相机 getters/setters：`getZoom`/`setZoom`/`getCenter` 等
  • `setMapStatus`、坐标转换、容器 getters、`getMapStyle`、默认 `handleCameraChanged`（earth 自行覆盖）

四个适配器迁移

适配器	改动
`map/map.ts`	`extends BaseMapService` → `extends MapboxBaseMap`
`mapbox/map.ts`	`extends BaseMapService<Map & IMapboxInstance>` → `extends MapboxBaseMap<Map & IMapboxInstance>`
`maplibre/map.ts`	同上
`earth/map.ts`	`extends BaseMapService` → `extends MapboxBaseMap`（保留 `implements IEarthService`）

机械清理

• 适配器内 `$mapContainer` → `mapContainer`（统一基类命名）
• 删除三个适配器内冗余重写 `emit`/`once`/`getMapContainer`（基类已提供正确实现；子类的 `once(name, ...args)` 签名是 bug，正确应是 `once(name, handler)`，顺手清掉）
• 删除 `earth/map.ts` 冗余 `onCameraChanged`
• `earth/map.ts` 的 `cameraChangedCallback(this.viewport)` 改 optional chaining（基类该属性是可选的）

类型契约诚实化

不再依赖 `BaseMapService implements IMapService<Map & T>` 的 \"`Map & T` 万能交集\"——该交集本是为了掩盖 `bmap`/`tmap` 适配不完整。Mapbox 家族类型完整（`@types/mapbox-gl`/`@types/maplibre-gl` 齐全），迁移零类型风险。

铺路性质

本次完成后 `BaseMapService` 仍保留——`bmap`/`tmap` 仍依赖它（`@types` 不完整，迁移会暴露 TS2333，待后续决策）。这是后续完全删除 `BaseMapService` 的中间一步。

验证

• ✅ `tsc --noEmit -p packages/maps/tsconfig.json`：`packages/maps/src` 路径 0 错误（与 master 基线一致；master 基线 199 错误均为 pre-existing 的 `.glsl` 类型声明缺失与 `packages/map/` 单数目录问题）
• 🔄 CI 远端：lint / unit / size（pre-commit lint-staged 在本机因 pnpm install 注册中心供应链策略 451 错误未跑完）

不在本 PR 范围

• `bmap`/`tmap` 迁移（等 `@types`/类型放宽决策）
• 删除 `BaseMapService.ts`（前置条件全部满足后另起一个 PR）

[changeset-bot]

⚠️ No Changeset found

Latest commit: 1d6a87b

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 introduces a new shared base class, MapboxBaseMap, to consolidate common Mapbox API implementations and reduce duplication across several map services, which now inherit from this new base class. The review feedback identifies a copy-paste bug in setMapStatus where dragEnable is checked instead of rotateEnable, redundant type assertions and casts, potential type unsafety in exportMap when renderCanvas is undefined, and opportunities to further reduce code duplication by delegating cleanup logic to super.destroy().

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.