tg-map-core 4.1.4 → 4.1.5

package/dist/src/map/map/overlay/info-window.d.ts

@@ -1,16 +1,19 @@
+import * as maptalks from 'maptalks';
 import type { Tg } from '../../event';
 import { AbstractEventTargetDelegate } from '../../event-target';
 import { LatLng } from '../../lat-lng';
-import type { Point } from '../../types';
+import { Point } from '../../types';
 import type { UnionInfoWindow } from '../../unions';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import './google-info.scss';
-import type { BaiduMarker, GoogleMarker, Marker } from './marker';
+import type { BaiduMarker, GoogleMarker, Marker, TalksMarker } from './marker';
 /**
  * ## InfoWindow的初始偏移, 不同实现
  * - baidu: 根据Icon的infoWindowAnchor选项, 确定相对Icon左上角的偏移
  * - google: 根据Marker的anchorPoint选项, 确定相对marker的position的偏移
+ * - talks: 默认定位到Icon的顶部
  *
  * 统一成: InfoWindow的底部中点对齐Marker的position, 需要多少偏移使用offset选项来设置
  */
@@ -109,3 +112,26 @@ export declare class GoogleInfoWindow extends InfoWindow {
     getPosition(): LatLng;
     setPosition(position: LatLng): void;
 }
+/**
+ * TODO: 2025/12/18 ipcjs 添加open/close事件
+ * @see TalksInfoBoxOverlay
+ */
+export declare class TalksInfoWindow extends InfoWindow {
+    inner: maptalks.ui.InfoWindow;
+    private map;
+    private state;
+    static create(this: TalksMap, options: InfoWindowOptions): TalksInfoWindow;
+    private marker;
+    private pendingShowAction;
+    private onVisibleChangeInCluster;
+    constructor(inner: maptalks.ui.InfoWindow, map: TalksMap, state: {
+        position?: LatLng;
+        offset: Point;
+    });
+    open(anchor?: TalksMarker): void;
+    private detachMarker;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    isOpen(): boolean;
+}

package/dist/src/map/map/overlay/label.d.ts

@@ -1,12 +1,15 @@
+import * as maptalks from 'maptalks';
+import { type Nullable } from 'tg-commons';
 import type { Tg } from '../../event';
 import { CoordType, LatLng } from '../../lat-lng';
 import { Point } from '../../types';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import { MapPane } from './element-overlay';
 import { type GoogleLabel } from './google-label';
 import type { BaiduUnionIcon } from './icon';
-import { BaiduOverlay, GoogleOverlay, Overlay } from './overlay';
+import { BaiduOverlay, GoogleOverlay, Overlay, TalksOverlay } from './overlay';
 export type BaiduLabel = BMap.Label & {
     __label__?: BaiduLabelOverlay;
 };
@@ -18,6 +21,7 @@ export type LabelEventMap = {
  */
 export interface LabelOptions {
     content: LabelContent;
+    /** label可以关联到marker上, 故可以不显式设置position */
     position?: LatLng;
     offset?: Point;
     /**
@@ -31,6 +35,7 @@ export interface LabelOptions {
      * ## 不同行为
      * - baidu: 不支持该属性
      * - google: 支持, 默认为{@link MapPane.overlayMouseTarget}
+     * - talks: 不支持
      */
     mapPane?: MapPane;
 }
@@ -60,7 +65,7 @@ export interface Label {
     getPosition(): LatLng;
     setPosition(position: LatLng): void;
     getOffset(): Point;
-    setOffset(offset: Point): void;
+    setOffset(offset: Nullable<Point>): void;
     setZIndex(zIndex: number): void;
 }
 export type LabelOverlay = Label & Overlay;
@@ -82,7 +87,7 @@ export declare class BaiduLabelOverlay extends BaiduOverlay<BaiduLabel> implemen
     getPosition(): LatLng;
     setPosition(position: LatLng): void;
     getOffset(): Point;
-    setOffset(offset: Point): void;
+    setOffset(offset: Nullable<Point>): void;
     setContent(content: LabelContent): void;
     /**
      * 关联新的Icon, 内部使用的方法
@@ -97,6 +102,16 @@ export declare class GoogleLabelOverlay extends GoogleOverlay<GoogleLabel> imple
     getPosition(): LatLng;
     setPosition(position: LatLng): void;
     getOffset(): Point;
-    setOffset(offset: Point): void;
+    setOffset(offset: Nullable<Point>): void;
+}
+export type TalksLabel = maptalks.ui.UIMarker;
+export declare class TalksLabelOverlay extends TalksOverlay<TalksLabel> implements Label {
+    static create(this: TalksMap, options: LabelOptions): TalksLabelOverlay;
+    setContent(content: LabelContent): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Nullable<Point>): void;
+    setZIndex(zIndex: number): void;
 }
 export {};

package/dist/src/map/map/overlay/marker-label.d.ts

@@ -1,3 +1,4 @@
+import type * as maptalks from 'maptalks';
 import './marker-label.scss';
 /**
  * 和Marker关联的标签
@@ -16,4 +17,10 @@ export interface MarkerLabel {
 export declare const MarkerLabel: {
     toBaidu: (label: MarkerLabel) => BMap.Label;
     toGoogle: (label: MarkerLabel) => google.maps.MarkerLabel;
+    toTalks: (label: MarkerLabel, options: Pick<maptalks.TextSymbol, "textDx" | "textDy">) => {
+        properties: {
+            label: string;
+        };
+        symbol: maptalks.TextSymbol;
+    };
 };

package/dist/src/map/map/overlay/marker.d.ts

@@ -1,14 +1,17 @@
+import * as maptalks from 'maptalks';
 import type { Nullable } from '../../../utils/mapped-types';
 import type { Tg } from '../../event';
 import { CoordType, LatLng } from '../../lat-lng';
-import type { UnionBaiduIcon, UnionGoogleIcon } from '../../unions';
+import { Point } from '../../types';
+import type { UnionBaiduIcon, UnionGoogleIcon, UnionTalksIcon } from '../../unions';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import type { BaiduInfoBox } from './baidu-info-box';
 import { UnionIcon } from './icon';
-import type { BaiduLabelOverlay, GoogleLabelOverlay, LabelOverlay } from './label';
+import type { BaiduLabelOverlay, GoogleLabelOverlay, LabelOverlay, TalksLabelOverlay } from './label';
 import { MarkerLabel } from './marker-label';
-import { BaiduOverlay, GoogleOverlay, Overlay, type OverlayOptions } from './overlay';
+import { BaiduOverlay, GoogleOverlay, Overlay, TalksOverlay, type OverlayOptions } from './overlay';
 export interface MarkerOptions extends OverlayOptions {
     position: LatLng;
     /**
@@ -20,6 +23,14 @@ export interface MarkerOptions extends OverlayOptions {
      * {@macro latlng_normalize}
      */
     normalizePositionForBaidu?: boolean;
+    /**
+     * hover时显示的文字
+     *
+     * ## 不同行为
+     * - baidu: 支持
+     * - google: 支持
+     * - talks: 不支持
+     */
     title?: string;
     /** @see MarkerLabel */
     label?: MarkerLabel;
@@ -66,8 +77,8 @@ export interface Marker extends Tg.EventTargetTyped<Marker, MarkerEventMap> {
     /** @see MarkerLabel */
     setLabel(label: MarkerLabel): void;
     setIcon(icon: UnionIcon): void;
-    /** 感觉并没有读取Icon的必要, 直接返回内部的Icon, 懒得写包装类_(:3」∠)_ */
-    getIcon(): Nullable<UnionGoogleIcon | UnionBaiduIcon>;
+    /** @deprecated 感觉并没有读取Icon的必要, 直接返回内部的Icon, 懒得写包装类_(:3」∠)_ */
+    getIcon(): Nullable<UnionGoogleIcon | UnionBaiduIcon | UnionTalksIcon>;
     /**
      * ## 不同行为
      * - baidu: 不支持设置clickable
@@ -142,3 +153,33 @@ export declare class GoogleMarker extends GoogleOverlay<google.maps.Marker> impl
     setLabel(label: MarkerLabel): void;
     attachLabelOverlay(label: GoogleLabelOverlay | undefined): void;
 }
+export declare class TalksMarker extends TalksOverlay<maptalks.Marker> implements Marker {
+    private state;
+    static create(this: TalksMap, options: MarkerOptions): TalksMarker;
+    private static createSymbolOptions;
+    private label;
+    private labelPositionListener;
+    private labelVisibleListener;
+    private labelMapChangedListener;
+    private labelVisibleChangeInCluster;
+    constructor(innerOverlay: maptalks.Marker, coordType: CoordType, map: TalksMap, state: Pick<MarkerOptions, 'icon' | 'label' | 'title'>);
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setLabel(label: MarkerLabel): void;
+    setIcon(icon: UnionIcon): void;
+    getIcon(): Nullable<UnionTalksIcon>;
+    setClickable(enable: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    /**
+     * maptalks.InfoWindow关联到Marker之后, InfoWindow会偏移到Marker的图标上方, 该方法返回这个偏移量
+     * @see https://github.com/maptalks/maptalks.js/blob/e204e3bafe5855f38399f7bca502460b1e0bb269/packages/maptalks/src/ui/InfoWindow.ts#L255
+     */
+    getInfoWindowOffset(): Point | undefined;
+    attachLabelOverlay(label: TalksLabelOverlay | undefined): void;
+}

package/dist/src/map/map/overlay/overlay.d.ts

@@ -1,10 +1,11 @@
 import type { Tg } from '../../event';
 import { type EventTargetDelegate } from '../../event-target';
 import type { CoordType } from '../../lat-lng';
-import type { UnionBaiduOverlay, UnionGoogleOverlay } from '../../unions';
+import type { UnionBaiduOverlay, UnionGoogleOverlay, UnionTalksOverlay } from '../../unions';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
 import type { BaseMap } from '../map';
+import type { TalksMap } from '../talks-map';
 export interface OverlayOptions {
     /** @default true */
     visible?: boolean;
@@ -44,3 +45,10 @@ export declare class BaiduOverlay<T extends UnionBaiduOverlay = UnionBaiduOverla
     /** 在创建BaiduOverlay时, 设置options.visible, 仅内部使用 */
     visibleOptionInternal(visible: boolean | undefined): this;
 }
+export declare class TalksOverlay<T extends UnionTalksOverlay = UnionTalksOverlay> extends Overlay<T> {
+    protected map: TalksMap;
+    constructor(innerOverlay: T, coordType: CoordType, map: TalksMap);
+    protected createDelegate(): EventTargetDelegate;
+    isVisible(): boolean;
+    setVisible(visible: boolean): void;
+}

package/dist/src/map/map/overlay/polygon.d.ts

@@ -1,11 +1,13 @@
+import * as maptalks from 'maptalks';
 import type { Tg } from '../../event';
 import { EventHubEventTargetDelegate } from '../../event-target';
 import { LatLng } from '../../lat-lng';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import type { Overlay } from './overlay';
 import { BaiduPolyShape } from './polyline';
-import { GoogleShape, type Shape, type ShapeOptions } from './shape';
+import { GoogleShape, TalksShape, type Shape, type ShapeOptions } from './shape';
 export type PolygonEventMap = {
     click: Tg.Event;
     dblclick: Tg.Event;
@@ -40,3 +42,8 @@ export declare class GooglePolygon extends GoogleShape<google.maps.Polygon> impl
     getPaths(): LatLng[][];
     setPaths(paths: LatLng[][]): void;
 }
+export declare class TalksPolygon extends TalksShape<maptalks.Polygon> implements Polygon {
+    static create(this: TalksMap, options: PolygonOptions): TalksPolygon;
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}

package/dist/src/map/map/overlay/polyline.d.ts

@@ -1,11 +1,13 @@
+import * as maptalks from 'maptalks';
 import type { Tg } from '../../event';
 import { EventHubEventTargetDelegate } from '../../event-target';
 import { LatLng } from '../../lat-lng';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import { IconSequence } from './icon';
 import type { Overlay } from './overlay';
-import { BaiduShape, GoogleShape, type NotFillableShape, type NotFillableShapeOptions } from './shape';
+import { BaiduShape, GoogleShape, TalksShape, type NotFillableShape, type NotFillableShapeOptions } from './shape';
 export type PolylineEventMap = {
     click: Tg.Event;
     dblclick: Tg.Event;
@@ -69,3 +71,8 @@ export declare class GooglePolyline extends GoogleShape<google.maps.Polyline> im
     getPath(): LatLng[];
     setPath(path: LatLng[]): void;
 }
+export declare class TalksPolyline extends TalksShape<maptalks.LineString> implements Polyline {
+    static create(this: TalksMap, options: PolylineOptions): TalksPolyline;
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}

package/dist/src/map/map/overlay/rectangle.d.ts

@@ -1,10 +1,12 @@
+import * as maptalks from 'maptalks';
 import type { Tg } from '../../event';
 import { CoordType, LatLngBounds } from '../../lat-lng';
 import type { BaiduMap } from '../baidu-map';
 import type { GoogleMap } from '../google-map';
+import type { TalksMap } from '../talks-map';
 import type { Overlay } from './overlay';
 import { BaiduPolyShape } from './polyline';
-import { GoogleShape, type Shape, type ShapeOptions } from './shape';
+import { GoogleShape, TalksShape, type Shape, type ShapeOptions } from './shape';
 export type RectangleEventMap = {
     click: Tg.Event;
     dblclick: Tg.Event;
@@ -48,3 +50,9 @@ export declare class GoogleRectangle extends GoogleShape<google.maps.Rectangle>
     getBounds(): LatLngBounds;
     setBounds(bounds: LatLngBounds): void;
 }
+export declare class TalksRectangle extends TalksShape<maptalks.Rectangle> implements Rectangle {
+    static create(this: TalksMap, options: RectangleOptions): TalksRectangle;
+    private static convertBoundsToRect;
+    getBounds(): LatLngBounds;
+    setBounds(bounds: LatLngBounds): void;
+}

package/dist/src/map/map/overlay/shape.d.ts

@@ -1,8 +1,8 @@
 import type { CoordType } from '../../lat-lng';
-import type { UnionBaiduShape, UnionGoogleShape } from '../../unions';
+import type { UnionBaiduShape, UnionGoogleShape, UnionTalksShape } from '../../unions';
 import type { BaiduMap } from '../baidu-map';
 import type { SymbolIcon } from './icon';
-import { BaiduOverlay, GoogleOverlay, type OverlayOptions } from './overlay';
+import { BaiduOverlay, GoogleOverlay, TalksOverlay, type OverlayOptions } from './overlay';
 export interface ShapeOptions extends OverlayOptions {
     clickable?: boolean;
     editable?: boolean;
@@ -74,3 +74,13 @@ export declare abstract class GoogleShape<T extends UnionGoogleShape> extends Go
     setFillOpacity(opacity: number): void;
     setZIndex(zIndex: number): void;
 }
+export declare abstract class TalksShape<T extends UnionTalksShape> extends TalksOverlay<T> implements Shape {
+    isEditable(): boolean;
+    setEditable(editable: boolean): void;
+    setStrokeColor(color: string): void;
+    setStrokeOpacity(opacity: number): void;
+    setStrokeWeight(weight: number): void;
+    setFillColor(color: string): void;
+    setFillOpacity(opacity: number): void;
+    setZIndex(zIndex: number): void;
+}

package/dist/src/map/map/talks-map.d.ts

@@ -1,42 +1,46 @@
 import type { Property } from 'csstype';
 import * as maptalks from 'maptalks';
 import 'maptalks/dist/maptalks.css';
-import { LatLng, type CoordType, type LatLngBounds } from '../lat-lng';
-import { type TalksBaseLayerId } from '../talks/talks-layers';
+import { type TalksBaseLayerId } from '../../utils/talks-layers';
+import { LatLng, LatLngBounds, type CoordType } from '../lat-lng';
 import type { Padding, Point } from '../types';
-import type { CustomControl } from './controls/control';
-import type { MapTypeControl, MapTypeControlOptions } from './controls/map-type.control';
+import { type CustomControl } from './controls/control';
+import { TalksMapTypeControl } from './controls/map-type.control';
 import { TalksScaleControl } from './controls/scale.control';
 import { TalksStreetViewControl } from './controls/street-view.control';
 import { TalksZoomControl } from './controls/zoom.control';
 import type { Autocomplete, AutocompleteOptions } from './extra/autocomplete';
 import type { Heatmap, HeatmapOptions } from './extra/heatmap';
 import type { MapUrls, MapUrlsOptions } from './extra/map-urls';
-import type { MarkerClusterer, MarkerClustererOptions } from './extra/marker-clusterer';
+import { type MarkerClusterer, type MarkerClustererOptions } from './extra/marker-clusterer';
 import type { PlacesService, PlacesServiceOptions } from './extra/places-service';
 import type { SearchBox, SearchBoxOptions } from './extra/search-box';
 import { BaseMap } from './map';
-import type { GestureHandlingOptions, MapOptions, MapStyle } from './map-options';
-import { BuildInMapTypeId, type Layer, type MapType } from './map-type';
-import type { CircleOptions, CircleOverlay } from './overlay/circle';
+import { GestureHandlingOptions, type MapOptions, type MapStyle } from './map-options';
+import { BuildInMapTypeId, MapType, type Layer } from './map-type';
+import { TalksCircle } from './overlay/circle';
 import type { ElementOverlay } from './overlay/element-overlay';
-import type { InfoBoxOptions, InfoBoxOverlay } from './overlay/info-box';
-import type { InfoWindowOptions, InfoWindowOverlay } from './overlay/info-window';
-import type { LabelOptions, LabelOverlay } from './overlay/label';
-import type { MarkerOptions, MarkerOverlay } from './overlay/marker';
-import type { Overlay } from './overlay/overlay';
-import type { PolygonOptions, PolygonOverlay } from './overlay/polygon';
-import type { PolylineOptions, PolylineOverlay } from './overlay/polyline';
-import type { RectangleOptions, RectangleOverlay } from './overlay/rectangle';
+import { TalksInfoBoxOverlay } from './overlay/info-box';
+import { TalksInfoWindow } from './overlay/info-window';
+import { TalksLabelOverlay } from './overlay/label';
+import { TalksMarker } from './overlay/marker';
+import type { TalksOverlay } from './overlay/overlay';
+import { TalksPolygon } from './overlay/polygon';
+import { TalksPolyline } from './overlay/polyline';
+import { TalksRectangle } from './overlay/rectangle';
 export declare class TalksMap extends BaseMap {
+    mapOptions: MapOptions;
     private map;
-    private currentBaseLayerId;
+    protected markerLayer: maptalks.VectorLayer;
+    protected overlayLayer: maptalks.VectorLayer;
     constructor(element: HTMLElement, mapOptions: MapOptions, baseLayoutIds: [normal: TalksBaseLayerId] | [normal: TalksBaseLayerId, satellite: TalksBaseLayerId] | [normal: TalksBaseLayerId, satellite: TalksBaseLayerId, hybrid: TalksBaseLayerId]);
-    setGestureHandling(gestureHandling: GestureHandlingOptions): void;
+    setGestureHandling(gestureHandling?: GestureHandlingOptions): void;
     get innerMap(): maptalks.Map;
     get coordType(): CoordType;
     fromContainerPointToLatLng(point: Point): LatLng;
     fromLatLngToContainerPoint(latLng: LatLng): Point;
+    setHideLogo(hideLogo: boolean): void;
+    setFractionalZoom(enabled: boolean): void;
     setDefaultCursor(cursor: Property.Cursor): void;
     setDraggable(draggable: boolean): void;
     setDoubleClickZoom(enable: boolean): void;
@@ -56,25 +60,25 @@ export declare class TalksMap extends BaseMap {
     getBounds(): LatLngBounds;
     addElementOverlay(overlay: ElementOverlay): void;
     removeElementOverlay(overlay: ElementOverlay): void;
-    addOverlay(overlay: Overlay): void;
-    removeOverlay(overlay: Overlay): void;
-    createMarker(options: MarkerOptions): MarkerOverlay;
+    addOverlay(overlay: TalksOverlay): void;
+    removeOverlay(overlay: TalksOverlay): void;
+    createMarker: typeof TalksMarker.create;
     createMarkerClusterer(options: MarkerClustererOptions): MarkerClusterer;
     createHeatmap(options: HeatmapOptions): Heatmap;
     createAutocomplete(options: AutocompleteOptions): Autocomplete;
     createSearchBox(options: SearchBoxOptions): SearchBox;
     createPlacesService(options: PlacesServiceOptions): PlacesService;
     createMapUrls(options: MapUrlsOptions): MapUrls;
-    createInfoWindow(options: InfoWindowOptions): InfoWindowOverlay;
-    createInfoBox(options: InfoBoxOptions): InfoBoxOverlay;
-    createPolyline(options: PolylineOptions): PolylineOverlay;
-    createPolygon(options: PolygonOptions): PolygonOverlay;
-    createRectangle(options: RectangleOptions): RectangleOverlay;
-    createCircle(options: CircleOptions): CircleOverlay;
-    createLabel(options: LabelOptions): LabelOverlay;
+    createInfoWindow: typeof TalksInfoWindow.create;
+    createInfoBox: typeof TalksInfoBoxOverlay.create;
+    createPolyline: typeof TalksPolyline.create;
+    createPolygon: typeof TalksPolygon.create;
+    createRectangle: typeof TalksRectangle.create;
+    createCircle: typeof TalksCircle.create;
+    createLabel: typeof TalksLabelOverlay.create;
     addCustomControl(control: CustomControl): void;
     removeCustomControl(control: CustomControl): void;
-    createMapTypeControl(options: MapTypeControlOptions): MapTypeControl;
+    createMapTypeControl: typeof TalksMapTypeControl.create;
     createZoomControl: typeof TalksZoomControl.create;
     createStreetViewControl: typeof TalksStreetViewControl.create;
     createScaleControl: typeof TalksScaleControl.create;

package/dist/src/map/map-config.d.ts

@@ -1,5 +1,6 @@
 import { HERE_SUPPORTED_VERSIONS } from '../utils/here-utils';
 import type { DeepPartial, EmptyObject } from '../utils/mapped-types';
+import type { TalksBaseLayerId } from '../utils/talks-layers';
 export interface MapConfig {
     key: string;
     version: string;
@@ -12,17 +13,25 @@ export interface TgMapConfig {
         /** @see https://developers.google.com/maps/documentation/javascript/libraries */
         libraries: ('drawing' | 'geometry' | 'journeySharing' | 'localContext' | 'marker' | 'places' | 'visualization')[];
     };
-    baidu: MapConfig & {
+    baidu: MapConfig & ({
         /** @see https://lbsyun.baidu.com/index.php?title=jspopular3.0/theupdatelog */
         version: '3.0';
-    };
+    } | {
+        type: 'webgl';
+        version: '1.0';
+    });
     here: MapConfig & {
         version: typeof HERE_SUPPORTED_VERSIONS[number];
     };
     baiduFree: EmptyObject;
+    googleFree: EmptyObject;
     yandex: EmptyObject;
     amap: EmptyObject;
     osm: EmptyObject;
+    talks: {
+        /** @default bing */
+        layerId?: TalksBaseLayerId | '';
+    };
 }
 export type PartialTgMapConfig = DeepPartial<TgMapConfig>;
 export declare function getTgMapConfig(): TgMapConfig;

package/dist/src/map/map-factory.d.ts

@@ -21,12 +21,16 @@ export declare enum TgMapType {
     here = "here",
     /** Baidu免费地图, 使用maptalks */
     baiduFree = "baiduFree",
+    /** Google免费地图, 使用maptalks */
+    googleFree = "googleFree",
     /** Yandex地图, 使用maptalks */
     yandex = "yandex",
     /** 高德地图, 使用maptalks */
     amap = "amap",
     /** 开源地图, 使用maptalks */
-    osm = "osm"
+    osm = "osm",
+    /** 使用maptalks, 实际使用的layerId, 可在外部设置, 方便测试 */
+    talks = "talks"
 }
 export declare namespace TgMapFactory {
     function createMap(type: TgMapType, $map: HTMLElement, mapOptions?: Partial<MapOptions>): BaseMap;

package/dist/src/map/unions.d.ts

@@ -7,14 +7,18 @@ import type { GoogleLabel } from './map/overlay/google-label';
 export type UnionMap = google.maps.Map | BMap.Map | H.Map | maptalks.Map;
 export type UnionBaiduIcon = BMap.Icon | BMap.Symbol;
 export type UnionGoogleIcon = google.maps.Icon | google.maps.Symbol | google.maps.UrlIcon;
-export type UnionInfoWindow = google.maps.InfoWindow | BMap.InfoWindow;
+export type UnionTalksIcon = maptalks.AnyMarkerSymbol | maptalks.AnyMarkerSymbol[];
+export type UnionInfoWindow = google.maps.InfoWindow | BMap.InfoWindow | maptalks.ui.InfoWindow;
 export type UnionAutocomplete = google.maps.places.Autocomplete | BMap.Autocomplete;
 export type UnionPlacesService = google.maps.places.PlacesService | BMap.LocalSearch;
 export type UnionGoogleOverlay = google.maps.Marker | google.maps.Polyline | google.maps.Polygon | google.maps.Circle | google.maps.Rectangle | GoogleLabel;
 export type UnionBaiduOverlay = BMap.Marker | BMap.Polyline | BMap.Polygon | BMap.Circle | BMap.Label | BaiduInfoBox;
+export type UnionTalksOverlay = maptalks.Geometry | maptalks.ui.UIMarker;
 export type UnionGoogleEventTarget = google.maps.MVCObject;
 export type UnionBaiduEventTarget = UnionBaiduOverlay | BMap.InfoWindow | BMap.Autocomplete | BMap.Map;
+export type UnionTalksEventTarget = maptalks.Eventable;
 export type UnionBaiduShape = BMap.Polyline | BMap.Polygon | BMap.Circle;
 export type UnionGoogleShape = google.maps.Polyline | google.maps.Polygon | google.maps.Circle | google.maps.Rectangle;
+export type UnionTalksShape = maptalks.LineString | maptalks.Polygon | maptalks.Circle | maptalks.Rectangle;
 export type UnionControl = BMap.Control | HTMLElement;
 export type GoogleLayer = google.maps.TrafficLayer | google.maps.TransitLayer | google.maps.KmlLayer | google.maps.BicyclingLayer;

package/dist/src/utils/arrays.d.ts

@@ -7,6 +7,14 @@ export declare namespace Arrays {
     function at<T>(arr: T[], index: number, value: T): void;
     /** 获取 指定位置的值 */
     function at<T>(arr: T[], index: number): T | undefined;
+    /**
+     * 取子数组, 对参数的范围几乎没有任何限制
+     *
+     * @param from   开始索引, 可以是负数
+     * @param length 取出多少个元素, 可以大于{@link arr}的长度
+     * @param step   步长, 可以是负数
+     */
+    function subarray<T>(arr: T[], from: number, length: number, step?: number): T[];
 }
 export declare namespace MVCArrays {
     function indexOf<T>(arr: google.maps.MVCArray<T>, item: T): number;

package/dist/src/utils/baidu-utils.d.ts

@@ -3,6 +3,23 @@
  * @see http://lbsyun.baidu.com/cms/jsapi/reference/jsapi_reference_3_0.html#a3b0
  */
 export declare function ensureBaiduV3(): void;
+/**
+ * Baidu地图GL版使用BaiduGL作为命名空间, V3版使用BMap作为命名空间
+ * 目前的代码基于V3版编写, 为了兼容GL版,将BaiduGL重命名成BMap
+ * 这种方式只是勉强能够让代码可以跑起来, 不要用于生产环境, 要完全支持GL版, 还是需要做彻底的升级
+ *
+ * @see https://lbsyun.baidu.com/index.php?title=jspopularGL
+ * @see https://mapopen-pub-jsapi.bj.bcebos.com/jsapi/reference/jsapi_webgl_1_0.html#a0b0
+ */
+export declare function adaptBaiduGLToV3(): void;
+export declare function isBaiduGL(): boolean;
+/**
+ * {@link BMapGL.SVGSymbol}对应{@link BMap.Symbol}, 该工具用于兼容V3版和GL版
+ */
+export declare const BMapSymbol: {
+    create: (path: string | BMap.SymbolShapeType, opts?: BMap.SymbolOptions) => BMap.Symbol;
+    is: (obj: any) => obj is BMap.Symbol;
+};
 /**
  * 尝试修复baidu内存占用会越来越大的问题
  *
@@ -17,6 +34,14 @@ export declare function ensureBaiduV3(): void;
  * 保证该方法能够执行成功
  */
 export declare function tryFixBaiduOutOfMemory(): void;
+/**
+ * 拦截Baidu地图, 前端JSONP的返回值, 移除"未完成商用授权"的提示
+ * - 需要尽可能早调用, 才能生效
+ * - 只起到隐藏提示作用, 地图瓦片依然会加载不出来...
+ *   - V3版大部分瓦片加载不出来
+ *   - GL版好一些, 虽然会报大量请求错误, 但似乎是因为它存在重试机制, 最终还是能够加载出来
+ */
+export declare function hideBaiduMapUnauthWarn(): void;
 export declare const BMapPoints: {
     /** {@link BMap.Point.equals} 无效, 故需要自己写一个 */
     equals(a: BMap.Point, b: BMap.Point): boolean;

package/dist/src/utils/objects.d.ts

@@ -7,7 +7,7 @@ export declare namespace Objects {
     };
     function toJsonSafely(value: any): string;
     /** 删除obj中纯对象上的值为undefined的属性 */
-    function deleteUndefinedPropertyOnPlainObjectDeeply(obj: any): void;
+    function deleteUndefinedPropertyOnPlainObjectDeeply<T = any>(_obj: T): T;
     /** 存在则返回, 不存在则新建 */
     function putIfAbsent<K extends keyof any, V>(obj: Record<K, V>, key: K, ifAbsent: () => Exclude<V, undefined>): Exclude<V, undefined>;
     /** @see Omit */
@@ -20,7 +20,7 @@ export declare namespace Objects {
      * @param keyPath `.`分隔的字段名 或 字段名数组
      * @returns 若字段不存在, 则返回`undefined`
      */
-    function get(obj: any, keyPath: string | string[]): any;
+    function get(obj: any, keyPath: string | readonly string[]): any;
     function del(obj: any, keyPath: string | string[]): any;
 }
 /** 用于替代Vue2中的filter, 直接交给模板使用 */

package/dist/src/{map/talks → utils}/talks-layers.d.ts

@@ -1,9 +1,9 @@
 import * as maptalks from 'maptalks';
-import { CoordType } from '../lat-lng';
-export declare const talksBaseLayerIds: readonly ["osm", "osm-simple", "google", "baidu", "amap", "tencent", "geoq", "tianditu", "yandex", "bing"];
+import { CoordType } from '../map/lat-lng';
+export declare const talksBaseLayerIds: readonly ["osm", "osm-simple", "google", "baidu", "baidu-detail", "amap", "tencent", "geoq", "tianditu", "yandex", "bing"];
 export type TalksBaseLayerId = typeof talksBaseLayerIds[number];
 export declare function talksBaseLayerIdToCoordType(layerId: TalksBaseLayerId): CoordType;
 export declare function createTalksBaseLayer(layerId: TalksBaseLayerId, { id, visible, }?: {
-    id?: "google" | "osm" | "osm-simple" | "baidu" | "amap" | "tencent" | "geoq" | "tianditu" | "yandex" | "bing" | undefined;
+    id?: "osm" | "osm-simple" | "google" | "baidu" | "baidu-detail" | "amap" | "tencent" | "geoq" | "tianditu" | "yandex" | "bing" | undefined;
     visible?: boolean | undefined;
 }): maptalks.TileLayer;

package/dist/src/utils/talks-utils.d.ts

@@ -0,0 +1,24 @@
+import * as maptalks from 'maptalks';
+export declare namespace Talks {
+    function setVisible(that: {
+        isVisible(): boolean;
+        show(): void;
+        hide(): void;
+    }, visible: boolean): void;
+    /**
+     * 临时的坐标对象
+     *
+     * maptalks的很多方法支持传入可选的out参数, 避免在方法内部新建对象,
+     * 如果调用方也只是临时使用这个对象(不向外传递), 由于JS是单线程的, 因此可以全局共享这个临时对象
+     * */
+    const tempCoordinate: maptalks.Coordinate;
+    /** @see tempCoordinate */
+    const tempPoint: maptalks.Point;
+    /** @see https://github.com/maptalks/maptalks.js/blob/f69bc41cb3cc48c456c71a62dc953bdc582a4146/packages/maptalks/src/geometry/Path.ts#L479 */
+    function extentFromCoordinates(coordinates: maptalks.Coordinate[], projection?: maptalks.Projection): maptalks.Extent;
+}
+export declare const TalksConst: {
+    /** maptalks的Polygon默认是没有填充色的, 这里统一指定一个填充色, 方便和Polyline区分 */
+    readonly FILL_COLOR_TG: "white";
+    readonly FILL_OPACITY_TG: 0.5;
+};

package/dist/src/utils/utils.d.ts

@@ -12,3 +12,8 @@ export declare function isEntryValueDef<K, V>(entry: [K, V]): entry is [K, NonNu
  * 创建一个异步初始化的单例, 保证只初始化成功一次
  */
 export declare function createAsyncSingleton<T>(creator: () => Promise<T>): () => Promise<T>;
+/**
+ * 简单版的去抖动函数
+ * @see https://lodash.com/docs/4.17.21#debounce
+ */
+export declare function debounce<T extends (...args: any[]) => void>(func: T, wait?: number): (...args: Parameters<T>) => void;