tg-map-core 4.1.8 → 4.2.1

package/dist/tg-map-core.mjs

@@ -1,5 +1,5 @@
 import * as maptalks from 'maptalks';
-import { noop, throwError, assert, lateinit, Arrays as Arrays$1, identical, throwUnsupported, delay, assertNever, Strings as Strings$1, StringEnums } from 'tg-commons';
+import { noop, throwError, assert, lateinit, Arrays as Arrays$1, identical, throwUnsupported, delay, assertNever, Strings as Strings$1, isTruthy } from 'tg-commons';
 import coordtransform from 'coordtransform';
 import deepmerge from 'deepmerge';
 import { ClusterLayer } from 'maptalks.markercluster';
@@ -1528,7 +1528,17 @@ class TalksEventTargetDelegate extends AbstractEventTargetDelegate {
     static EVENT_TYPE_MAP = typedRecord({
         'center-changed': 'movestart moving moveend zoomend',
         'zoom-changed': 'zoomend',
+        // https://maptalks.org/maptalks.js/api/1.x/Map.html#event:setbaselayer
+        'map-type-changed': 'setbaselayer',
     });
+    eventTypeMap;
+    /**
+     * @param eventTypeMap 额外的事件类型映射
+     */
+    constructor(inner, coordTypeSupplier, eventTypeMap) {
+        super(inner, coordTypeSupplier);
+        this.eventTypeMap = { ...TalksEventTargetDelegate.EVENT_TYPE_MAP, ...eventTypeMap };
+    }
     addEventListener(type, listener) {
         const key = generateEventKey(type, listener);
         if (this.eventMap.has(key)) {
@@ -1546,14 +1556,14 @@ class TalksEventTargetDelegate extends AbstractEventTargetDelegate {
             }
             listener.call(this.target, ev);
         };
-        this.inner.on(TalksEventTargetDelegate.EVENT_TYPE_MAP[type] ?? type, actualListener);
+        this.inner.on(this.eventTypeMap[type] ?? type, actualListener);
         this.eventMap.set(key, actualListener);
     }
     removeEventListener(type, listener) {
         const key = generateEventKey(type, listener);
         const actualListener = this.eventMap.get(key);
         if (actualListener) {
-            this.inner.off(TalksEventTargetDelegate.EVENT_TYPE_MAP[type] ?? type, actualListener);
+            this.inner.off(this.eventTypeMap[type] ?? type, actualListener);
             this.eventMap.delete(key);
         }
         else {
@@ -1724,6 +1734,19 @@ function hideBaiduMapUnauthWarn() {
         }
         return false;
     };
+    if (!isBaiduGL()) {
+        // 新的V3版也会直接从签名的`B_BUSINESS_INFO`中检测是否弹窗警告, 强制清空它可以规避检测(
+        Object.defineProperty(window, 'B_BUSINESS_INFO', {
+            configurable: true,
+            enumerable: true,
+            get: () => {
+                return undefined;
+            },
+            set: (v) => {
+                console.debug('B_BUSINESS_INFO', 'set', v);
+            },
+        });
+    }
     let originalBMap;
     let originalBMapVerifyCbk;
     Object.defineProperty(window, 'BMap', {
@@ -2160,13 +2183,17 @@ var BuildInMapTypeId;
 })(BuildInMapTypeId || (BuildInMapTypeId = {}));
 class BuildInMapType {
     id;
+    index;
     baidu;
     google;
     googleCoordType;
-    constructor(id, baidu, // 需要延迟初始化, 故写成方法
+    constructor(id, 
+    /** 在{@link MapType.BUILD_IN_MAP_TYPES.values}中的index */
+    index, baidu, // 需要延迟初始化, 故写成方法
     google, // 同上
     googleCoordType) {
         this.id = id;
+        this.index = index;
         this.baidu = baidu;
         this.google = google;
         this.googleCoordType = googleCoordType;
@@ -2276,10 +2303,10 @@ class TrafficLayer {
 }
 var MapType;
 (function (MapType) {
-    MapType.NORMAL = new BuildInMapType(BuildInMapTypeId.normal, () => BMAP_NORMAL_MAP, () => google.maps.MapTypeId.ROADMAP, CoordType.gcj02);
-    MapType.SATELLITE = new BuildInMapType(BuildInMapTypeId.satellite, () => BMAP_SATELLITE_MAP, () => google.maps.MapTypeId.SATELLITE, CoordType.wgs84);
-    MapType.HYBRID = new BuildInMapType(BuildInMapTypeId.hybrid, () => BMAP_HYBRID_MAP, () => google.maps.MapTypeId.HYBRID, CoordType.gcj02);
-    MapType.TERRAIN = new BuildInMapType('terrain', () => /* 三维 */ BMAP_PERSPECTIVE_MAP, () => /* 地形 */ google.maps.MapTypeId.TERRAIN, CoordType.wgs84);
+    MapType.NORMAL = new BuildInMapType(BuildInMapTypeId.normal, 0, () => BMAP_NORMAL_MAP, () => google.maps.MapTypeId.ROADMAP, CoordType.gcj02);
+    MapType.SATELLITE = new BuildInMapType(BuildInMapTypeId.satellite, 1, () => BMAP_SATELLITE_MAP, () => google.maps.MapTypeId.SATELLITE, CoordType.wgs84);
+    MapType.HYBRID = new BuildInMapType(BuildInMapTypeId.hybrid, 2, () => BMAP_HYBRID_MAP, () => google.maps.MapTypeId.HYBRID, CoordType.gcj02);
+    MapType.TERRAIN = new BuildInMapType('terrain', 3, () => /* 三维 */ BMAP_PERSPECTIVE_MAP, () => /* 地形 */ google.maps.MapTypeId.TERRAIN, CoordType.wgs84);
     MapType.BUILD_IN_MAP_TYPES = new FastFindValues([MapType.NORMAL, MapType.SATELLITE, MapType.HYBRID, MapType.TERRAIN]);
 })(MapType || (MapType = {}));
 
@@ -2292,6 +2319,10 @@ var MapTypeControlType;
 const MAP_TYPES_DEFAULT = [MapType.NORMAL, MapType.SATELLITE, MapType.HYBRID];
 class BaiduMapTypeControl extends BaiduControl {
     static create(options) {
+        if (isBaiduGL()) {
+            // GL版, 不存在MapTypeControl...故返回空
+            return new EmptyControl(true, options.position ?? ControlPosition.TOP_LEFT);
+        }
         const mapTypes = options.mapTypes ?? MAP_TYPES_DEFAULT;
         const type2baidu = {
             [MapTypeControlType.DEFAULT]: BMAP_MAPTYPE_CONTROL_HORIZONTAL,
@@ -2343,9 +2374,13 @@ class GoogleMapTypeControl extends GoogleControl {
         });
     }
 }
-class TalksMapTypeControl extends EmptyControl {
+class TalksMapTypeControl extends TalksControl {
     static create(options) {
-        return new TalksMapTypeControl(true, options.position ?? ControlPosition.TOP_LEFT);
+        const position = options.position ?? ControlPosition.TOP_LEFT;
+        const inner = new maptalks.control.LayerSwitcher({
+            position: ControlPositionConverter.getTalks().toValue(position),
+        });
+        return new TalksMapTypeControl(inner, position);
     }
 }
 
@@ -7293,7 +7328,7 @@ class TalksMarkerClusterer {
         this.inner = new ClusterLayer('cluster', options.markers?.map(it => it.innerOverlay), Objects.deleteUndefinedPropertyOnPlainObjectDeeply({
             ...ClusterIconStyle.toTalks(options.styles),
             // {@macro marker_clusterer_grid_size}
-            maxClusterRadius: options.gridSize ?? (map.currentBaseLayerId === 'baidu' || map.currentBaseLayerId === 'baidu-detail' ? 60 : 100),
+            maxClusterRadius: options.gridSize ?? (map.cachedBaseLayerId === 'baidu' || map.cachedBaseLayerId === 'baidu-detail' ? 60 : 100),
             maxClusterZoom: options.maxZoom,
             zIndex: options.zIndex,
         }));
@@ -7629,6 +7664,12 @@ class BaseMap {
     removeOverlayMapType(mapType) {
         this.removeLayer(mapType);
     }
+    addOverlay(overlay) {
+        overlay.addTo(this);
+    }
+    removeOverlay(overlay) {
+        overlay.remove();
+    }
     addControl(control) {
         control.addTo(this);
     }
@@ -7665,9 +7706,6 @@ class Overlay {
     removeEventListener(type, listener) {
         this.delegate.removeEventListener(type, listener);
     }
-    remove() {
-        this.map.removeOverlay(this);
-    }
 }
 class GoogleOverlay extends Overlay {
     map;
@@ -7678,6 +7716,13 @@ class GoogleOverlay extends Overlay {
     createDelegate() {
         return new GoogleEventTargetDelegate(this.innerOverlay, this.map);
     }
+    addTo(map) {
+        this.map = map;
+        this.innerOverlay.setMap(map.innerMap);
+    }
+    remove() {
+        this.innerOverlay.setMap(null);
+    }
     isVisible() {
         return this.innerOverlay.getVisible();
     }
@@ -7694,6 +7739,13 @@ class BaiduOverlay extends Overlay {
     createDelegate() {
         return new BaiduEventTargetDelegate(this.innerOverlay, this.map);
     }
+    addTo(map) {
+        this.map = map;
+        this.map.innerMap.addOverlay(this.innerOverlay);
+    }
+    remove() {
+        this.map.innerMap.removeOverlay(this.innerOverlay);
+    }
     /** 仅限内部使用; 设为private时, 生成的d.ts文件中, 方法返回值会变成any, 故改成了public */
     get overlay() {
         // 这几个属性被声明成可选的, 这里将其强转成必选
@@ -7803,11 +7855,43 @@ class GoogleShape extends GoogleOverlay {
     }
 }
 class TalksShape extends TalksOverlay {
+    addTo(map) {
+        this.map = map;
+        this.map.overlayLayer.addGeometry(this.innerOverlay);
+        // 添加到地图中之后, startEdit()才有效
+        if (this.isEditable() && !this.innerOverlay.isEditing()) {
+            this.innerOverlay.startEdit();
+        }
+    }
+    remove() {
+        this.map.overlayLayer.removeGeometry(this.innerOverlay);
+    }
+    /**
+     * ## 编辑状态的映射
+     * tg-map的editable, 直接表示是否处于编辑状态
+     * talks的editable, 只是标记overlay是否可以编辑(默认为true), 要进入编辑状态(isEditing), 还需要执行startEdit()
+     * 也就是说我们需要想办法把talks的四个状态, 映射为tg-map的两个状态
+     *
+     * 我们的做法是, 用editable保存isEditing期望的值, 保证editable为true时isEditing也会为true, 为false时isEditing也会为false
+     * 这样就可以和tg-map的editable的语义简单对应上了
+     *
+     * @see addTo
+     * @see setEditable
+     */
     isEditable() {
-        return this.innerOverlay.config().editable ?? true;
+        return this.innerOverlay.options.editable ?? false;
     }
     setEditable(editable) {
+        // 同步设置editable和isEditing
+        // TODO: 2026/01/23 ipcjs 切换编辑状态时, 控制台会报重复注册事件警告, 已提PR: https://github.com/maptalks/maptalks.js/pull/2796
         this.innerOverlay.config({ editable: editable });
+        const isEditing = this.innerOverlay.isEditing();
+        if (editable) {
+            !isEditing && this.innerOverlay.startEdit();
+        }
+        else {
+            isEditing && this.innerOverlay.endEdit();
+        }
     }
     setStrokeColor(color) {
         this.innerOverlay.updateSymbol({ lineColor: color });
@@ -7977,6 +8061,41 @@ class TalksCircle extends TalksShape {
         });
         return new TalksCircle(inner, coord, this);
     }
+    prevCenter;
+    prevRadius;
+    eventHubDelegate;
+    createDelegate() {
+        return (this.eventHubDelegate = new EventHubEventTargetDelegate(super.createDelegate(), {
+            types: ['radius-changed', 'center-changed'],
+            onListen: (type) => {
+                if (type === 'radius-changed') {
+                    this.prevRadius = this.innerOverlay.getRadius();
+                    this.innerOverlay.on('editrecord', this.onRadiusChanged);
+                }
+                else {
+                    this.prevCenter = this.innerOverlay.getCoordinates();
+                    this.innerOverlay.on('editrecord', this.onCenterChanged);
+                }
+            },
+            onCancel: (type) => {
+                this.innerOverlay.off('editrecord', type === 'radius-changed' ? this.onRadiusChanged : this.onCenterChanged);
+            },
+        }));
+    }
+    onRadiusChanged = () => {
+        const radius = this.innerOverlay.getRadius();
+        if (this.prevRadius !== radius) {
+            this.eventHubDelegate?.notify({ type: 'radius-changed', target: this });
+            this.prevRadius = radius;
+        }
+    };
+    onCenterChanged = () => {
+        const center = this.innerOverlay.getCoordinates();
+        if (this.prevCenter !== center && !this.prevCenter?.equals(center)) {
+            this.eventHubDelegate?.notify({ type: 'center-changed', target: this });
+            this.prevCenter = center;
+        }
+    };
     setCenter(center) {
         this.coordType = this.map.coordType;
         this.innerOverlay.setCoordinates(center.toTalks(this.coordType));
@@ -9121,6 +9240,13 @@ class TalksLabelOverlay extends TalksOverlay {
         });
         return new TalksLabelOverlay(label, coord, this);
     }
+    addTo(map) {
+        this.map = map;
+        this.innerOverlay.addTo(map.innerMap);
+    }
+    remove() {
+        this.innerOverlay.remove();
+    }
     setContent(content) {
         this.innerOverlay.setContent(content);
     }
@@ -9132,7 +9258,7 @@ class TalksLabelOverlay extends TalksOverlay {
         this.innerOverlay.setCoordinates(position.toTalks(this.coordType));
     }
     getOffset() {
-        const options = this.innerOverlay.config();
+        const options = this.innerOverlay.options;
         return { x: options.dx ?? 0, y: options.dy ?? 0 };
     }
     setOffset(offset) {
@@ -9639,6 +9765,13 @@ class TalksMarker extends TalksOverlay {
         super(innerOverlay, coordType, map);
         this.state = state;
     }
+    addTo(map) {
+        this.map = map;
+        this.map.markerLayer.addGeometry(this.innerOverlay);
+    }
+    remove() {
+        this.map.markerLayer.removeGeometry(this.innerOverlay);
+    }
     getPosition() {
         return LatLng.fromTalks(this.innerOverlay.getCoordinates(), this.coordType);
     }
@@ -9673,13 +9806,13 @@ class TalksMarker extends TalksOverlay {
         this.innerOverlay.config('interactive', enable);
     }
     isClickable() {
-        return this.innerOverlay.config().interactive ?? true;
+        return this.innerOverlay.options.interactive ?? true;
     }
     setDraggable(enable) {
         this.innerOverlay.config('draggable', enable);
     }
     isDraggable() {
-        return this.innerOverlay.config().draggable ?? false;
+        return this.innerOverlay.options.draggable ?? false;
     }
     setZIndex(zIndex) {
         this.innerOverlay.setZIndex(zIndex ?? 0);
@@ -9907,6 +10040,12 @@ class TalksPolyline extends TalksShape {
         });
         return new TalksPolyline(inner, coordType, this);
     }
+    createDelegate() {
+        return new TalksEventTargetDelegate(this.innerOverlay, this.map, {
+            // https://maptalks.org/maptalks.js/api/1.x/Geometry.html#event:editrecord
+            'path-edited': 'editrecord',
+        });
+    }
     getPath() {
         return this.innerOverlay.getCoordinates().map(it => LatLng.fromTalks(it, this.coordType));
     }
@@ -10025,6 +10164,12 @@ class TalksPolygon extends TalksShape {
         });
         return new TalksPolygon(inner, coord, this);
     }
+    createDelegate() {
+        return new TalksEventTargetDelegate(this.innerOverlay, this.map, {
+            // https://maptalks.org/maptalks.js/api/1.x/Geometry.html#event:editrecord
+            'paths-edited': 'editrecord',
+        });
+    }
     getPaths() {
         return this.innerOverlay.getCoordinates()
             .map(path => path.map(it => LatLng.fromTalks(it, this.coordType)));
@@ -10190,6 +10335,12 @@ class TalksRectangle extends TalksShape {
             height: computeDistanceBetween(nw, bounds.sw),
         };
     }
+    createDelegate() {
+        return new TalksEventTargetDelegate(this.innerOverlay, this.map, {
+            // https://maptalks.org/maptalks.js/api/1.x/Geometry.html#event:editrecord
+            'bounds-changed': 'editrecord',
+        });
+    }
     getBounds() {
         return LatLngBounds.fromTalks(this.innerOverlay.getExtent(), this.coordType);
     }
@@ -10392,12 +10543,6 @@ class BaiduMap extends BaseMap {
     removeElementOverlay(overlay) {
         this.map.removeOverlay(overlay.asBaidu());
     }
-    addOverlay(overlay) {
-        this.map.addOverlay(overlay.innerOverlay);
-    }
-    removeOverlay(overlay) {
-        this.map.removeOverlay(overlay.innerOverlay);
-    }
     addCustomControl(control) {
         if (!control.inner) {
             const BaiduControl = class extends BMap.Control {
@@ -10618,12 +10763,6 @@ class GoogleMap extends BaseMap {
     removeElementOverlay(overlay) {
         overlay.asGoogle().setMap(null);
     }
-    addOverlay(overlay) {
-        overlay.innerOverlay.setMap(this.map);
-    }
-    removeOverlay(overlay) {
-        overlay.innerOverlay.setMap(null);
-    }
     addCustomControl(control) {
         if (!control.inner) {
             control.inner = control.onCreateElement();
@@ -10772,12 +10911,6 @@ class HereMap extends BaseMap {
     removeElementOverlay(overlay) {
         throw new Error('Method not implemented.');
     }
-    addOverlay(overlay) {
-        throw new Error('Method not implemented.');
-    }
-    removeOverlay(overlay) {
-        throw new Error('Method not implemented.');
-    }
     createMarker(options) {
         throw new Error('Method not implemented.');
     }
@@ -10859,11 +10992,14 @@ const quadKey = (z, x, y) => {
 };
 const talksBaseLayerIds = [
     'osm',
-    'osm-simple',
+    'osm-light',
+    'osm-dark',
+    'osm-terrain',
     'google',
     'baidu',
     'baidu-detail',
     'amap',
+    'amap-terrain',
     'tencent',
     'geoq',
     'tianditu',
@@ -10875,7 +11011,8 @@ function talksBaseLayerIdToCoordType(layerId) {
         case 'baidu':
         case 'baidu-detail':
             return CoordType.bd09;
-        case 'osm-simple':
+        case 'osm-light':
+        case 'osm-dark':
         case 'osm':
         case 'yandex':
             return CoordType.wgs84;
@@ -10896,15 +11033,29 @@ function talksBaseLayerIdToCoordType(layerId) {
  * @see https://maptalks.org/examples/cn/tilelayer-projection/baidu/#tilelayer-projection_baidu
  */
 const TILE_LAYER_BAIDU_SCALER = 1;
-function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
+function createTalksBaseLayerImpl(layerId, { id = layerId, visible = true, } = {}) {
     switch (layerId) {
         case 'amap':
             return new maptalks.TileLayer(id, {
                 visible,
-                urlTemplate: 'http://webrd03.is.autonavi.com/appmaptile?style=8&x={x}&y={y}&z={z}&lang=zh_cn',
+                urlTemplate: 'http://webrd{s}.is.autonavi.com/appmaptile?style=8&x={x}&y={y}&z={z}&lang=zh_cn',
+                subdomains: ['01', '02', '03', '04'],
                 minZoom: 3,
                 maxZoom: 18,
                 attribution: '&copy; <a target="_blank" href="https://amap.com/">AMap</a>',
+                spatialReference: { projection: 'EPSG:3857' },
+            });
+        case 'amap-terrain':
+            // http://examples.maptalks.com/examples/cn/3d/terrain/load
+            return new maptalks.TileLayer(id, {
+                visible,
+                minZoom: 1,
+                // 深圳最大可以到18级, 一些偏远地带, 18级可能没有数据
+                maxZoom: 18,
+                urlTemplate: 'http://webst{s}.is.autonavi.com/appmaptile?style=6&x={x}&y={y}&z={z}',
+                subdomains: ['01', '02', '03', '04'],
+                attribution: '&copy; <a target="_blank" href="https://amap.com/">AMap</a>',
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'baidu':
             return new maptalks.TileLayer(id, {
@@ -10912,20 +11063,20 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 urlTemplate: `http://online{s}.map.bdimg.com/tile/?qt=vtile&x={x}&y={y}&z={z}&styles=pl&type=sate&scaler=${TILE_LAYER_BAIDU_SCALER}`,
                 subdomains: ['0', '1', '2', '3'],
                 spatialReference: {
-                    projection: 'baidu',
+                    projection: 'BAIDU',
                 },
                 minZoom: 3,
                 maxZoom: 20,
                 attribution: '&copy; <a target="_blank" href="http://map.baidu.com">Baidu</a>',
             });
         case 'baidu-detail':
-            // 参考: https://maptalks.org/examples/cn/tilelayer-projection/baidu/#tilelayer-projection_baidu
+            // https://maptalks.org/examples/cn/tilelayer-projection/baidu/#tilelayer-projection_baidu
             return new maptalks.TileLayer(id, {
                 visible,
                 urlTemplate: `https://gss{s}.bdstatic.com/8bo_dTSlRsgBo1vgoIiO_jowehsv/tile/?qt=tile&x={x}&y={y}&z={z}&styles=pl&scaler=${TILE_LAYER_BAIDU_SCALER}&udt=20170927`,
                 subdomains: ['0', '1', '2', '3'],
                 spatialReference: {
-                    projection: 'baidu',
+                    projection: 'BAIDU',
                 },
                 minZoom: 3,
                 maxZoom: 19,
@@ -10940,6 +11091,7 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 subdomains: ['0', '1', '2', '3'],
                 minZoom: 3,
                 maxZoom: 18,
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'google':
             return new maptalks.TileLayer(id, {
@@ -10947,6 +11099,7 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 urlTemplate: 'https://api.xiox.top/proxy/https://maps.google.com/maps/vt?lyrs=m&x={x}&y={y}&z={z}&hl=zh-CN',
                 subdomains: ['0', '1', '2', '3'],
                 attribution: '&copy; <a target="_blank" href="https://www.google.com/maps">Google</a>',
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'geoq':
             // 不知道是哪家的, 无法显示
@@ -10954,6 +11107,7 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 visible,
                 urlTemplate: 'https://map.geoq.cn/ArcGIS/rest/services/ChinaOnlineCommunity/MapServer/tile/{z}/{y}/{x}',
                 subdomains: ['0', '1', '2', '3'],
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'tianditu':
             // key已失效, 无法显示
@@ -10976,6 +11130,7 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 subdomains: ['1', '2', '3', '4'],
                 maxZoom: 21,
                 attribution: '&copy; <a target="_blank" href="https://yandex.com/maps/">Yandex</a>',
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'bing':
             return new maptalks.TileLayer(id, {
@@ -10984,49 +11139,97 @@ function createTalksBaseLayer(layerId, { id = layerId, visible = true, } = {}) {
                 subdomains: ['1', '2', '3'],
                 minZoom: 3,
                 maxZoom: 18,
+                spatialReference: { projection: 'EPSG:3857' },
             });
         case 'osm':
+            // https://operations.osmfoundation.org/policies/tiles/
             return new maptalks.TileLayer(id, {
                 visible,
                 urlTemplate: 'http://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png',
                 subdomains: ['a', 'b', 'c'],
                 attribution: '&copy; <a target="_blank" href="http://www.osm.org/copyright">OSM</a>',
+                spatialReference: { projection: 'EPSG:3857' },
             });
-        case 'osm-simple':
+        case 'osm-light':
+            // https://github.com/CartoDB/basemap-styles
             return new maptalks.TileLayer(id, {
                 visible,
                 urlTemplate: 'http://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
                 subdomains: ['a', 'b', 'c', 'd'],
                 attribution: '&copy; <a target="_blank" href="http://www.osm.org/copyright">OSM</a> contributors, &copy; <a target="_blank" href="https://carto.com/attributions">CARTO</a>',
+                spatialReference: { projection: 'EPSG:3857' },
+            });
+        case 'osm-dark':
+            // https://github.com/CartoDB/basemap-styles
+            return new maptalks.TileLayer(id, {
+                visible,
+                urlTemplate: 'http://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png',
+                subdomains: ['a', 'b', 'c', 'd'],
+                attribution: '&copy; <a target="_blank" href="http://www.osm.org/copyright">OSM</a> contributors, &copy; <a target="_blank" href="https://carto.com/attributions">CARTO</a>',
+                spatialReference: { projection: 'EPSG:3857' },
+            });
+        case 'osm-terrain':
+            // https://wiki.openstreetmap.org/wiki/OpenTopoMap#Usage
+            return new maptalks.TileLayer(id, {
+                visible,
+                urlTemplate: 'https://{s}.tile.opentopomap.org/{z}/{x}/{y}.png',
+                subdomains: ['a', 'b', 'c'],
+                attribution: '&copy; <a target="_blank" href="http://www.osm.org/copyright">OSM</a>',
+                spatialReference: { projection: 'EPSG:3857' },
             });
     }
 }
+const createTalksBaseLayer = process.env.NODE_ENV !== 'production'
+    ? (layerId, options) => {
+        const layer = createTalksBaseLayerImpl(layerId, options);
+        if (layer.options.visible == null || layer.options.spatialReference == null) {
+            console.warn('创建的baseLayer必须设置visible和spatialReference', layer.options);
+        }
+        return layer;
+    }
+    : createTalksBaseLayerImpl;
 
 const MAP_ATTRIBUTION_TG = { content: 'TG' };
 class TalksMap extends BaseMap {
     mapOptions;
+    baseLayoutIds;
     map;
+    attributionControl;
+    baseLayerGroup;
+    mapStyleTheme;
+    /**
+     * 由于通过{@link MapTypeControl}, maptalks可以在内部切换可见的baseLayer, 所以要获取实际当前的显示的baseLayer, 应该使用{@link getCurrentBaseLayer}
+     * 但为了方便快速的执行{@link coordType}, 因而增加了这个缓存的值
+     * @internal
+     * */
+    cachedBaseLayerId;
     /** @internal */
-    currentBaseLayerId;
     markerLayer;
+    /** @internal */
     overlayLayer;
-    constructor(element, mapOptions, baseLayoutIds) {
+    constructor(element, mapOptions, 
+    /**
+     * 最多8项, 前四项对应{@link MapType.BUILD_IN_MAP_TYPES}的四个值(普通、卫星、混合、地形)的亮色版, 后四项对应暗色版
+     * @see computeBaseLayerId
+     */
+    baseLayoutIds) {
         super(element);
         this.mapOptions = mapOptions;
-        // TODO: 2025/11/05 ipcjs 实现MapType机制
-        const buildInMapTypeIdIndex = StringEnums.values(BuildInMapTypeId).indexOf(mapOptions.buildInMapTypeId ?? BuildInMapTypeId.normal);
-        this.currentBaseLayerId = baseLayoutIds[buildInMapTypeIdIndex] ?? baseLayoutIds[0];
-        const baseLayers = baseLayoutIds.map(id => createTalksBaseLayer(id, { visible: id === this.currentBaseLayerId }));
-        const baseLayer = baseLayers.find(it => it.isVisible());
+        this.baseLayoutIds = baseLayoutIds;
+        this.mapStyleTheme = mapOptions.mapStyle?.talks?.theme ?? 'light';
+        this.cachedBaseLayerId = this.computeBaseLayerId(mapOptions.buildInMapTypeId, this.mapStyleTheme);
+        this.baseLayerGroup = new maptalks.GroupTileLayer('base', baseLayoutIds
+            .filter(isTruthy)
+            .map(id => createTalksBaseLayer(id, { visible: id === this.cachedBaseLayerId })));
         this.markerLayer = new maptalks.VectorLayer('markers');
         this.overlayLayer = new maptalks.VectorLayer('overlays');
+        const baseLayer = this.getCurrentBaseLayer();
         this.map = new maptalks.Map(element, {
-            attribution: mapOptions.hideLogo ? false : MAP_ATTRIBUTION_TG,
-            // TODO: 使用GroupTileLayer, Map无法正确读取到当前显示的Layer的attribution, 故暂时不使用它
-            // baseLayer: new maptalks.GroupTileLayer('base', baseLayers),
-            baseLayer: baseLayer,
+            // 默认的attribution不会显示GroupTileLayer的子layer的attribution, 故不显示, 使用自己的this.attributionControl来处理
+            attribution: false,
+            baseLayer: this.baseLayerGroup,
             // {@macro layer_baidu_spatial_reference}
-            spatialReference: baseLayer?.config().spatialReference,
+            spatialReference: baseLayer?.options.spatialReference,
             // 参考google, marker和其他overlay分属不同layer, 并且marker位于overlay上方
             layers: [
                 this.overlayLayer, this.markerLayer,
@@ -11035,11 +11238,60 @@ class TalksMap extends BaseMap {
             seamlessZoom: mapOptions.fractionalZoom ?? false,
             zoom: mapOptions.zoom,
             // 默认使用baseLayer的Zoom范围
-            minZoom: mapOptions.minZoom ?? baseLayer?.config().minZoom,
-            maxZoom: mapOptions.maxZoom ?? baseLayer?.config().maxZoom,
+            minZoom: mapOptions.minZoom ?? baseLayer?.options.minZoom,
+            maxZoom: mapOptions.maxZoom ?? baseLayer?.options.maxZoom,
         });
         this.setGestureHandling(mapOptions.gestureHandling);
         this.setEventTargetDelegate(new TalksEventTargetDelegate(this.map, this));
+        this.attributionControl = new maptalks.control.Attribution(MAP_ATTRIBUTION_TG);
+        this.map.addControl(this.attributionControl);
+        this.setHideLogo(mapOptions.hideLogo ?? false);
+        this.map.on('setbaselayer', this.onBaseLayerChanged);
+        this.onBaseLayerChanged();
+    }
+    getCurrentBaseLayer() {
+        return this.baseLayerGroup.layers.find(it => it.isVisible());
+    }
+    onBaseLayerChanged = () => {
+        const baseLayer = this.getCurrentBaseLayer();
+        if (!baseLayer)
+            return;
+        // 更新cacheBaseLayerId, attribution, spatialReference, 但并没有更新minZoom/maxZoom, 因为感觉必要性不大
+        this.cachedBaseLayerId = baseLayer.getId();
+        const layerAttribution = baseLayer.options.attribution;
+        this.attributionControl.setContent(MAP_ATTRIBUTION_TG.content + (layerAttribution ? ` - ${layerAttribution}` : ''));
+        if (this.map.getSpatialReference().options.projection !== baseLayer.getSpatialReference().options.projection) {
+            console.debug('setSpatialReference', this.map.getSpatialReference().options, '==>', baseLayer.getSpatialReference().options);
+            this.map.setSpatialReference(baseLayer.getSpatialReference().options);
+        }
+    };
+    computeBaseLayerId(buildInMapTypeId = BuildInMapTypeId.normal, theme = 'light') {
+        const mapType = MapType.BUILD_IN_MAP_TYPES.get(BuildInMapType.prototype.getId, buildInMapTypeId);
+        if (theme === 'dark') {
+            const darkOffset = MapType.BUILD_IN_MAP_TYPES.values.length;
+            // 遍历: 7, 6, 5, 4, 查找设置了值的暗色layerId
+            for (let i = Math.min((mapType.index + darkOffset), this.baseLayoutIds.length - 1); i >= darkOffset; i--) {
+                if (this.baseLayoutIds[i]) {
+                    return this.baseLayoutIds[i];
+                }
+            }
+        }
+        // 遍历: 3, 2, 1, 0, 查找设置了值的亮色layerId
+        for (let i = Math.min(mapType.index, this.baseLayoutIds.length - 1); i >= 0; i--) {
+            if (this.baseLayoutIds[i]) {
+                return this.baseLayoutIds[i];
+            }
+        }
+        return this.baseLayoutIds[0];
+    }
+    setBaseLayer(id, theme) {
+        this.mapStyleTheme = theme;
+        const baseLayerId = this.computeBaseLayerId(id, theme);
+        const currentBaseLayerId = this.getCurrentBaseLayer()?.getId();
+        if (currentBaseLayerId !== baseLayerId) {
+            this.baseLayerGroup.layers.forEach((layer) => Talks.setVisible(layer, layer.getId() === baseLayerId));
+            this.onBaseLayerChanged();
+        }
     }
     setGestureHandling(gestureHandling = GestureHandlingOptions.auto) {
         if (gestureHandling === GestureHandlingOptions.auto) {
@@ -11075,7 +11327,7 @@ class TalksMap extends BaseMap {
         return this.map;
     }
     get coordType() {
-        return talksBaseLayerIdToCoordType(this.currentBaseLayerId);
+        return talksBaseLayerIdToCoordType(this.cachedBaseLayerId);
     }
     fromContainerPointToLatLng(point) {
         const coordinate = this.map.containerPointToCoordinate(new maptalks.Point(point.x, point.y));
@@ -11086,7 +11338,7 @@ class TalksMap extends BaseMap {
         return point; // maptalks.Point符合Point接口, 可以直接返回
     }
     setHideLogo(hideLogo) {
-        this.map.config('attribution', hideLogo ? false : MAP_ATTRIBUTION_TG);
+        Talks.setVisible(this.attributionControl, !hideLogo);
     }
     setFractionalZoom(enabled) {
         this.map.config('seamlessZoom', enabled);
@@ -11113,16 +11365,31 @@ class TalksMap extends BaseMap {
         this.map.setMaxZoom(zoom);
     }
     setMapStyle(mapStyle) {
-        // TODO: 2026/01/05 ipcjs 下一版再实现该功能
+        if (mapStyle?.talks?.theme) {
+            const mapType = this.getMapType();
+            if (mapType instanceof BuildInMapType) {
+                this.setBaseLayer(mapType.id, mapStyle.talks.theme);
+            }
+            else {
+                console.log('自定义MapType不支持设置地图样式', mapType);
+            }
+        }
     }
     setBuildInMapTypeId(id) {
-        // TODO: 2026/01/05 ipcjs 下一版再实现该功能
+        this.setBaseLayer(id, this.mapStyleTheme);
     }
     setMapType(mapType) {
-        // TODO: 2026/01/05 ipcjs 下一版再实现该功能
+        if (mapType instanceof BuildInMapType) {
+            this.setBaseLayer(mapType.getId(), this.mapStyleTheme);
+        }
     }
     getMapType() {
-        // TODO: 2026/01/05 ipcjs 下一版再实现该功能
+        const currentBaseLayerId = this.getCurrentBaseLayer()?.getId();
+        const index = this.baseLayoutIds.findIndex(it => it === currentBaseLayerId);
+        if (index !== -1) {
+            return MapType.BUILD_IN_MAP_TYPES.values[index % MapType.BUILD_IN_MAP_TYPES.values.length];
+        }
+        // TODO: 2026/01/05 ipcjs 自定义MapType, 下一版再实现该功能
         return MapType.NORMAL;
     }
     addLayer(layer) {
@@ -11154,22 +11421,6 @@ class TalksMap extends BaseMap {
     removeElementOverlay(overlay) {
         // TODO: 2026/01/05 ipcjs 下一版再实现该功能
     }
-    addOverlay(overlay) {
-        if (overlay.innerOverlay instanceof maptalks.ui.UIComponent) {
-            overlay.innerOverlay.addTo(this.map);
-            return;
-        }
-        const layer = overlay instanceof TalksMarker ? this.markerLayer : this.overlayLayer;
-        layer.addGeometry(overlay.innerOverlay);
-    }
-    removeOverlay(overlay) {
-        if (overlay.innerOverlay instanceof maptalks.ui.UIComponent) {
-            overlay.innerOverlay.remove();
-            return;
-        }
-        const layer = overlay instanceof TalksMarker ? this.markerLayer : this.overlayLayer;
-        layer.removeGeometry(overlay.innerOverlay);
-    }
     createMarker = TalksMarker.create;
     createMarkerClusterer(options) {
         return new TalksMarkerClusterer(this, options);
@@ -11253,17 +11504,20 @@ var TgMapFactory;
             case TgMapType.here:
                 return new HereMap($map, options);
             case TgMapType.baiduFree:
-                return new TalksMap($map, options, ['baidu', 'osm']);
+                return new TalksMap($map, options, ['baidu', 'amap-terrain', undefined, undefined, 'osm-dark']);
             case TgMapType.googleFree:
-                return new TalksMap($map, options, ['google', 'osm']);
+                return new TalksMap($map, options, ['google', 'osm-terrain', undefined, undefined, 'osm-dark']);
             case TgMapType.amap:
-                return new TalksMap($map, options, ['amap']);
+                return new TalksMap($map, options, ['amap', 'amap-terrain', undefined, undefined, 'osm-dark']);
             case TgMapType.osm:
-                return new TalksMap($map, options, ['osm']);
+                return new TalksMap($map, options, ['osm-light', 'osm-terrain', undefined, undefined, 'osm-dark']);
             case TgMapType.yandex:
-                return new TalksMap($map, options, ['yandex']);
-            case TgMapType.talks:
-                return new TalksMap($map, options, [getTgMapConfig().talks.layerId || 'bing']);
+                return new TalksMap($map, options, ['yandex', undefined, undefined, undefined, 'osm-dark']);
+            case TgMapType.talks: {
+                const hasDefinedFirstElement = (array) => !!(array && array.length && array[0]);
+                const talks = getTgMapConfig().talks;
+                return new TalksMap($map, options, hasDefinedFirstElement(talks.layerIds) ? talks.layerIds : [talks.layerId || 'bing']);
+            }
             default:
                 assertNever(type);
         }