tg-map-vue3 3.0.1

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

@@ -0,0 +1,113 @@
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="googlemaps" />
+import type { GoogleLayer } from '../unions';
+import type { Point } from '../types';
+import { CoordType } from '../lat-lng';
+import { FastFindValues } from '../../utils/values';
+/**
+ * 内置地图的id
+ */
+export declare enum BuildInMapTypeId {
+    normal = "normal",
+    satellite = "satellite",
+    hybrid = "hybrid"
+}
+/**
+ * 包括不兼容的地图类型
+ * - 'terrain': google中为地形图, baidu中为三维图
+ * */
+export type BuildInMapTypeIdIncludeIncompatible = BuildInMapTypeId | 'terrain';
+/**
+ * ## 注意
+ * `asXxx()`多次调用时应返回同一个对象
+ */
+export interface MapType {
+    /** MapType的唯一标识符, 命名时推荐包含`-`, 防止和BuildInMapTypeId冲突 */
+    id: string;
+    getBaiduCoordType(): CoordType;
+    asBaiduMapType(): BaiduMapType;
+    getGoogleCoordType(): CoordType;
+    asGoogleMapType(): GoogleMapType;
+}
+export interface Layer {
+    asBaiduLayer(): BMap.TileLayer;
+    asGoogleLayer(): GoogleLayer;
+}
+/**
+ * 同时实现`MapType`和`Layer`的对象被称作`OverlayMapType`
+ * - 往google中添加`OverlayMapType`, 将被看作`MapType`
+ * - 往baidu中添加`OverlayMapType`, 将被看作`Layer`
+ * @see TgMap.addOverlayMapType
+ * @see TgMap.removeOverlayMapType
+ * @see ImageMapType
+ */
+export type OverlayMapType = MapType & Layer;
+export declare class BuildInMapType implements MapType {
+    id: BuildInMapTypeIdIncludeIncompatible;
+    private baidu;
+    private google;
+    private googleCoordType;
+    constructor(id: BuildInMapTypeIdIncludeIncompatible, baidu: () => BMap.MapType, // 需要延迟初始化, 故写成方法
+    google: () => google.maps.MapTypeId, // 同上
+    googleCoordType: CoordType);
+    getId(): BuildInMapTypeIdIncludeIncompatible;
+    getBaiduCoordType(): CoordType;
+    asBaiduMapType(): BaiduMapType;
+    getGoogleCoordType(): CoordType;
+    /** 内置地图的id和google的id是不一样的 */
+    getGoogleMapTypeId(): google.maps.MapTypeId;
+    asGoogleMapType(): GoogleMapType;
+}
+export type GoogleMapType = google.maps.MapType & {
+    /** 需要在创建实例时设置该值 */
+    __google_map_type__?: MapType;
+};
+export type BaiduMapType = BMap.MapType & {
+    /** 需要在创建实例时设置该值 */
+    __baidu_map_type__?: MapType;
+};
+export interface ImageMapTypeOptions {
+    readonly id: string;
+    /**
+     * @param tileCoord 统一成google的瓦片坐标, 原点在左上角
+     * @returns 返回值可以为空
+     */
+    getTileUrl: (tileCoord: Point, zoom: number) => string | null;
+    maxZoom: number;
+    minZoom?: number;
+    name: string;
+    describe?: string;
+}
+/**
+ * ImageMapType应该同时实现MapType和Layer接口
+ */
+export declare class ImageMapType implements OverlayMapType {
+    coordType: CoordType;
+    options: ImageMapTypeOptions;
+    private baiduLayerCached;
+    private baiduMapTypeCached;
+    private googleCached;
+    constructor(coordType: CoordType, options: ImageMapTypeOptions);
+    get id(): string;
+    getBaiduCoordType(): CoordType;
+    asBaiduMapType(): BaiduMapType;
+    asBaiduLayer(): BMap.TileLayer;
+    getGoogleCoordType(): CoordType;
+    asGoogleMapType(): GoogleMapType;
+    asGoogleLayer(): GoogleLayer;
+}
+/** 交通流量图层 */
+export declare class TrafficLayer implements Layer {
+    private baiduCache;
+    private googleCache;
+    asBaiduLayer(): BMap.TileLayer;
+    asGoogleLayer(): GoogleLayer;
+}
+export declare namespace MapType {
+    const NORMAL: BuildInMapType;
+    const SATELLITE: BuildInMapType;
+    const HYBRID: BuildInMapType;
+    const TERRAIN: BuildInMapType;
+    const BUILD_IN_MAP_TYPES: FastFindValues<BuildInMapType>;
+}

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

@@ -0,0 +1,129 @@
+import type { CoordType, CoordTypeSupplier, LatLng, LatLngBounds } from '../lat-lng';
+import type { MarkerOverlay, MarkerOptions } from './overlay/marker';
+import type { Overlay } from './overlay/overlay';
+import type { UnionMap } from '../unions';
+import type { MarkerClustererOptions, MarkerClusterer } from './extra/marker-clusterer';
+import type { InfoWindowOverlay, InfoWindowOptions } from './overlay/info-window';
+import type { PolylineOptions, PolylineOverlay } from './overlay/polyline';
+import type { PolygonOptions, PolygonOverlay } from './overlay/polygon';
+import type { CircleOptions, CircleOverlay } from './overlay/circle';
+import type { Tg } from '../event';
+import type { AbstractEventTargetDelegate } from '../event-target';
+import type { CustomControl, AbstractControl } from './controls/control';
+import type { MapTypeControlOptions, MapTypeControl } from './controls/map-type.control';
+import type { ZoomControlOptions, ZoomControl } from './controls/zoom.control';
+import type { ScaleControlOptions } from './controls/scale.control';
+import type { GestureHandlingOptions, MapStyle } from './map-options';
+import type { BuildInMapTypeId, MapType, Layer, OverlayMapType } from './map-type';
+import type { Padding, Point } from '../types';
+import type { LabelOptions, LabelOverlay } from './overlay/label';
+import type { InfoBoxOptions, InfoBoxOverlay } from './overlay/info-box';
+import type { ElementOverlay } from './overlay/element-overlay';
+export type AbstractMapEventMap = {
+    click: Tg.MouseEvent;
+    dblclick: Tg.MouseEvent;
+    rightclick: Tg.MouseEvent;
+    dragstart: Tg.Event;
+    drag: Tg.Event;
+    dragend: Tg.Event;
+    /**
+     * ## 不同行为
+     * - baidu: 貌似不会触发
+     * - google: 正常触发
+     */
+    mouseover: Tg.Event;
+    mousemove: Tg.MouseEvent;
+    /** @see mouseover */
+    mouseout: Tg.Event;
+    tilesloaded: Tg.Event;
+    /**
+     * ## 不同实现
+     * - baidu: 同时监听movestart & moving & moveend & zoomend事件, 只要地图"移动"就会触发
+     * - google: 监听center_changed事件, 拖着地图移动时会不断触发, 松手后只触发一次, center的值直接变为地图停止时的最终值...
+     */
+    'center-changed': Tg.Event;
+    /**
+     * ## 不同实现
+     * - baidu: 监听zoomend事件
+     * - google: 监听zoom_changed事件
+     */
+    'zoom-changed': Tg.Event;
+    'map-type-changed': Tg.Event;
+};
+/** 抽象出来的Map类 */
+export declare abstract class AbstractMap implements CoordTypeSupplier, Tg.EventTarget {
+    element: HTMLElement;
+    private latestInfoWindow;
+    /** 使用{@link setEventTargetDelegate}初始化 */
+    private delegate;
+    constructor(element: HTMLElement);
+    abstract setGestureHandling(gestureHandling: GestureHandlingOptions): void;
+    abstract get innerMap(): UnionMap;
+    abstract get coordType(): CoordType;
+    protected setEventTargetDelegate(delegate: AbstractEventTargetDelegate): void;
+    /** 使用重载, 规范事件类型 */
+    addEventListener<K extends keyof AbstractMapEventMap>(type: K, listener: (event: AbstractMapEventMap[K]) => void): void;
+    addEventListener(type: string, listener: Tg.EventListener): void;
+    /** @see addEventListener */
+    removeEventListener<K extends keyof AbstractMapEventMap>(type: K, listener: (event: AbstractMapEventMap[K]) => void): void;
+    removeEventListener(type: string, listener: Tg.EventListener): void;
+    /** 最后一次显示的InfoWindow, 不保证当前它仍然是打开状态 */
+    getLatestInfoWindow(): InfoWindowOverlay | undefined;
+    /** 仅用于@tg/map内部使用, 外部不要调用 */
+    setLatestInfoWindowInternal(infoWindow: InfoWindowOverlay): void;
+    /** 地图容器内的坐标点到经纬度之间转换 */
+    abstract fromContainerPointToLatLng(point: Point): LatLng;
+    /** @see fromContainerPointToLatLng */
+    abstract fromLatLngToContainerPoint(latLng: LatLng): Point;
+    /**
+     * ## 不同行为
+     * - baidu: 禁用拖拽后, 依然可以滚轮缩放
+     * - google: 禁用拖拽后, 不能滚轮缩放
+     */
+    abstract setDraggable(draggable: boolean): void;
+    abstract setDefaultCursor(cursor: string): void;
+    abstract setDisableDoubleClickZoom(type: boolean): void;
+    abstract getCenter(): LatLng;
+    abstract setCenter(latlng: LatLng): void;
+    abstract setMinZoom(zoom: number): void;
+    abstract setMaxZoom(zoom: number): void;
+    abstract setMapStyle(mapStyle: MapStyle): void;
+    /** setMapType的便利版, 只能够用来设置内置地图类型 */
+    abstract setBuildInMapTypeId(id: BuildInMapTypeId): void;
+    abstract setMapType(mapType: MapType): void;
+    abstract getMapType(): MapType;
+    abstract addLayer(layer: Layer): void;
+    abstract removeLayer(layer: Layer): void;
+    addOverlayMapType(mapType: OverlayMapType): void;
+    removeOverlayMapType(mapType: OverlayMapType): void;
+    abstract panTo(position: LatLng): void;
+    abstract panBy(x: number, y: number): void;
+    abstract fitBounds(bounds: LatLngBounds, padding?: Padding): void;
+    abstract getBounds(): LatLngBounds;
+    abstract addElementOverlay(overlay: ElementOverlay): void;
+    abstract removeElementOverlay(overlay: ElementOverlay): void;
+    abstract addOverlay(overlay: Overlay): void;
+    abstract removeOverlay(overlay: Overlay): void;
+    abstract createMarker(options: MarkerOptions): MarkerOverlay;
+    abstract createMarkerClusterer(options: MarkerClustererOptions): MarkerClusterer;
+    abstract createInfoWindow(options: InfoWindowOptions): InfoWindowOverlay;
+    abstract createInfoBox(options: InfoBoxOptions): InfoBoxOverlay;
+    abstract createPolyline(options: PolylineOptions): PolylineOverlay;
+    abstract createPolygon(options: PolygonOptions): PolygonOverlay;
+    abstract createCircle(options: CircleOptions): CircleOverlay;
+    abstract createLabel(options: LabelOptions): LabelOverlay;
+    /**
+     * ## 不同行为
+     * - baidu: 添加的同一个方位的自定义Control会重叠在一起
+     * - google: 添加的同一个方位的自定义Control不会重叠, 会平铺开来
+     */
+    abstract addCustomControl(control: CustomControl): void;
+    abstract removeCustomControl(control: CustomControl): void;
+    abstract createMapTypeControl(options: MapTypeControlOptions): MapTypeControl;
+    abstract createZoomControl(options: ZoomControlOptions): ZoomControl;
+    abstract createScaleControl(options: ScaleControlOptions): ZoomControl;
+    addControl(control: AbstractControl): void;
+    removeControl(control: AbstractControl): void;
+    getZoom(): number;
+    setZoom(zoom: number): void;
+}

package/dist/src/map/map/overlay/baidu-info-box.d.ts

@@ -0,0 +1,81 @@
+/// <reference types="baidumap-web-sdk" />
+import { Point } from '../../types';
+import type { BMarker } from './marker';
+export type BaiduInfoBox = InstanceType<ReturnType<typeof createBaiduInfoBoxClass>>;
+export declare function createBaiduInfoBox(content: HTMLElement, position?: BMap.Point, offset?: Point, zIndex?: number, maxWidth?: number, borderClass?: String): {
+    container: HTMLElement;
+    border: HTMLElement;
+    inner: HTMLElement;
+    map: BMap.Map | undefined;
+    marker: BMarker | undefined;
+    content: HTMLElement;
+    position: BMap.Point;
+    offset: Point;
+    /** @override */
+    initialize(map: BMap.Map): HTMLElement;
+    /** @override */
+    draw(): void;
+    open(map: BMap.Map, anchor?: BMarker | undefined): void;
+    attachMarker(marker: BMarker): void;
+    detachMarker(marker: BMarker): void;
+    close(): void;
+    isOpen(): boolean | undefined;
+    onMarkerPositionChanged(): void;
+    setZIndex(zIndex: number): void;
+    setMaxWidth(maxWidth: number): void;
+    setPosition(position: BMap.Point): void;
+    getPosition(): BMap.Point;
+    setOffset(offset: Point): void;
+    getOffset(): Point;
+    isVisible(): boolean;
+    show(): void;
+    hide(): void;
+    addEventListener(event: string, handler: BMap.Callback): void;
+    removeEventListener(event: string, handler: BMap.Callback): void;
+    dispatchEvent(event: {
+        type: string;
+    }): void;
+};
+/**
+ * baidu自带的InfoWindow有如下问题:
+ * 1. 窗体不可自定义, 默认的窗体有点丑
+ * 2. 一次只能显示一个
+ * 3. 和MarkerClusterer的配合并不好, 重建聚合时会使InfoWindow消失
+ */
+declare function createBaiduInfoBoxClass(): {
+    new (content: HTMLElement, position?: BMap.Point, offset?: Point, zIndex?: number, maxWidth?: number, borderClass?: String): {
+        container: HTMLElement;
+        border: HTMLElement;
+        inner: HTMLElement;
+        map: BMap.Map | undefined;
+        marker: BMarker | undefined;
+        content: HTMLElement;
+        position: BMap.Point;
+        offset: Point;
+        /** @override */
+        initialize(map: BMap.Map): HTMLElement;
+        /** @override */
+        draw(): void;
+        open(map: BMap.Map, anchor?: BMarker): void;
+        attachMarker(marker: BMarker): void;
+        detachMarker(marker: BMarker): void;
+        close(): void;
+        isOpen(): boolean | undefined;
+        onMarkerPositionChanged(): void;
+        setZIndex(zIndex: number): void;
+        setMaxWidth(maxWidth: number): void;
+        setPosition(position: BMap.Point): void;
+        getPosition(): BMap.Point;
+        setOffset(offset: Point): void;
+        getOffset(): Point;
+        isVisible(): boolean;
+        show(): void;
+        hide(): void;
+        addEventListener(event: string, handler: BMap.Callback): void;
+        removeEventListener(event: string, handler: BMap.Callback): void;
+        dispatchEvent(event: {
+            type: string;
+        }): void;
+    };
+};
+export {};

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

@@ -0,0 +1,42 @@
+/// <reference types="baidumap-web-sdk" />
+/// <reference types="googlemaps" />
+import type { Tg } from '../../event';
+import type { Overlay } from './overlay';
+import { type Shape, type ShapeOptions, BaiduShape, GoogleShape } from './shape';
+import { LatLng } from '../../lat-lng';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+type CircleEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+};
+export interface CircleOptions extends ShapeOptions {
+    center: LatLng;
+    radius: number;
+}
+export interface Circle extends Tg.EventTargetTyped<Circle, CircleEventMap>, Shape {
+    setCenter(center: LatLng): void;
+    getCenter(): LatLng;
+    setRadius(radius: number): void;
+    getRadius(): number;
+}
+export type CircleOverlay = Circle & Overlay;
+export declare class BaiduCircle extends BaiduShape<BMap.Circle> implements Circle {
+    static create(this: BaiduMap, options: CircleOptions): BaiduCircle;
+    setCenter(center: LatLng): void;
+    getCenter(): LatLng;
+    setRadius(radius: number): void;
+    getRadius(): number;
+}
+export declare class GoogleCircle extends GoogleShape<google.maps.Circle> implements Circle {
+    static create(this: GoogleMap, options: CircleOptions): GoogleCircle;
+    setCenter(center: LatLng): void;
+    getCenter(): LatLng;
+    setRadius(radius: number): void;
+    getRadius(): number;
+}
+export {};

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

@@ -0,0 +1,33 @@
+/// <reference types="googlemaps" />
+import { LatLng } from '../../lat-lng';
+import type { Point } from '../../types';
+import type { AbstractMap } from '../map';
+export declare enum MapPane {
+    map = "map",
+    overlay = "overlay",
+    overlayMouseTarget = "overlayMouseTarget",
+    float = "float"
+}
+export interface ElementOverlayOptions {
+    mapPane: MapPane;
+}
+export interface OverlayProjection {
+    fromLatLngToOverlayPoint(latLng: LatLng): Point;
+    fromOverlayPointToLatLng(point: Point): LatLng;
+}
+export declare abstract class ElementOverlay {
+    map: AbstractMap;
+    private baidu;
+    private google;
+    private projection;
+    protected element: HTMLElement;
+    private mapPane;
+    constructor(map: AbstractMap, options: ElementOverlayOptions);
+    create(): HTMLElement;
+    draw(): void;
+    protected abstract onCreate(): HTMLElement;
+    protected abstract onDraw(projection: OverlayProjection): void;
+    getProjection(): OverlayProjection | undefined;
+    asBaidu(): BMap.OverlayV3;
+    asGoogle(): google.maps.OverlayView;
+}

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

@@ -0,0 +1,74 @@
+/// <reference types="googlemaps" />
+import type { Point } from '../../types';
+import type { Nullable } from '../../../components';
+export type GoogleLabel = InstanceType<ReturnType<typeof createGoogleLabelClass>>;
+export declare function createGoogleLabel(element: HTMLElement, position: Nullable<google.maps.LatLng>, offset?: Point, zIndex?: number): {
+    container: HTMLElement;
+    position: Nullable<google.maps.LatLng>;
+    offset?: Point | undefined;
+    zIndex?: number | undefined;
+    setZIndex(zIndex: number): void;
+    setElement(element: HTMLElement): void;
+    /** @override */
+    onAdd(): void;
+    /** @override */
+    draw(): void;
+    /** @override */
+    onRemove(): void;
+    setPosition(position: Nullable<google.maps.LatLng>): void;
+    getPosition(): Nullable<google.maps.LatLng>;
+    setOffset(offset: Point): void;
+    getOffset(): Point | undefined;
+    getVisible(): boolean;
+    setVisible(visible: boolean): void;
+    getMap(): google.maps.Map | google.maps.StreetViewPanorama;
+    getPanes(): google.maps.MapPanes;
+    getProjection(): google.maps.MapCanvasProjection;
+    setMap(map: google.maps.Map | google.maps.StreetViewPanorama | null): void;
+    addListener(eventName: string, handler: (...args: any[]) => void): google.maps.MapsEventListener;
+    bindTo(key: string, target: google.maps.MVCObject, targetKey?: string | undefined, noNotify?: boolean | undefined): void;
+    changed(key: string): void;
+    get(key: string): any;
+    notify(key: string): void;
+    set(key: string, value: any): void;
+    setValues(values: any): void;
+    unbind(key: string): void;
+    unbindAll(): void;
+};
+/** 打开页面时 google.maps.OverlayView 并没有加载, 故需要将GoogleLabel类写到方法中去 */
+declare function createGoogleLabelClass(): {
+    new (element: HTMLElement, position: Nullable<google.maps.LatLng>, offset?: Point, zIndex?: number): {
+        container: HTMLElement;
+        position: Nullable<google.maps.LatLng>;
+        offset?: Point;
+        zIndex?: number;
+        setZIndex(zIndex: number): void;
+        setElement(element: HTMLElement): void;
+        /** @override */
+        onAdd(): void;
+        /** @override */
+        draw(): void;
+        /** @override */
+        onRemove(): void;
+        setPosition(position: Nullable<google.maps.LatLng>): void;
+        getPosition(): Nullable<google.maps.LatLng>;
+        setOffset(offset: Point): void;
+        getOffset(): Point | undefined;
+        getVisible(): boolean;
+        setVisible(visible: boolean): void;
+        getMap(): google.maps.Map | google.maps.StreetViewPanorama;
+        getPanes(): google.maps.MapPanes;
+        getProjection(): google.maps.MapCanvasProjection;
+        setMap(map: google.maps.Map | google.maps.StreetViewPanorama | null): void;
+        addListener(eventName: string, handler: (...args: any[]) => void): google.maps.MapsEventListener;
+        bindTo(key: string, target: google.maps.MVCObject, targetKey?: string | undefined, noNotify?: boolean | undefined): void;
+        changed(key: string): void;
+        get(key: string): any;
+        notify(key: string): void;
+        set(key: string, value: any): void;
+        setValues(values: any): void;
+        unbind(key: string): void;
+        unbindAll(): void;
+    };
+};
+export {};

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

@@ -0,0 +1,16 @@
+/// <reference types="googlemaps" />
+/// <reference types="baidumap-web-sdk" />
+import type { Size, Point } from '../../types';
+/** 字面量形式, 使用起来会简单点, 目前没看出使用class形式的必要🤔 */
+export interface Icon {
+    readonly url: string;
+    readonly size: Size;
+    /** 图片的显示区域的原点在图片中的坐标, 默认为(0, 0) */
+    readonly origin?: Point;
+    /** 图片显示到地图上的锚点, 默认为图标的底部中点 */
+    readonly anchor?: Point;
+}
+export declare namespace Icon {
+    function toGoogle(icon: Icon): google.maps.Icon;
+    function toBaidu(icon: Icon): BMap.Icon;
+}

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

@@ -0,0 +1,58 @@
+import { BaiduOverlay } from './overlay';
+import { type BaiduInfoBox } from './baidu-info-box';
+import { LatLng, CoordType } from '../../lat-lng';
+import type { Point } from '../../types';
+import { InfoWindow } from './info-window';
+import type { GoogleMap } from '../google-map';
+import type { Marker, GoogleMarker, BaiduMarker } from './marker';
+import type { BaiduMap } from '../baidu-map';
+import type { Tg } from '../../event';
+export type InfoBoxEventMap = {
+    closeclick: Tg.Event;
+};
+/**
+ * 初始偏移量同{@link InfoWindow}, 底部中点对齐position
+ */
+export interface InfoBoxOptions {
+    content: HTMLElement;
+    position?: LatLng;
+    offset?: Point;
+    zIndex?: number;
+    maxWidth?: number;
+    borderClass?: string;
+}
+export interface InfoBox extends Tg.EventTarget {
+    open(anchor?: Marker): void;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setMaxWidth(maxWidth: number): void;
+    setZIndex(zIndex: number): void;
+}
+/** 虽然叫"Overlay", 但并没有继承Overlay... */
+export type InfoBoxOverlay = InfoBox & Tg.EventTargetTyped<InfoBox, InfoBoxEventMap>;
+export declare class BaiduInfoBoxOverlay extends BaiduOverlay<BaiduInfoBox> implements InfoBox {
+    private baiduMap;
+    static create(this: BaiduMap, options: InfoBoxOptions): BaiduInfoBoxOverlay;
+    constructor(innerOverlay: BaiduInfoBox, coordType: CoordType, baiduMap: BaiduMap);
+    open(anchor?: BaiduMarker): void;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setMaxWidth(maxWidth: number): void;
+    setZIndex(zIndex: number): void;
+}
+export declare class GoogleInfoBoxOverlay extends InfoWindow implements InfoBox {
+    inner: google.maps.InfoWindow;
+    private coordType;
+    private map;
+    static create(this: GoogleMap, options: InfoBoxOptions): GoogleInfoBoxOverlay;
+    constructor(inner: google.maps.InfoWindow, coordType: CoordType, map: GoogleMap);
+    open(anchor?: GoogleMarker | undefined): void;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    isOpen(): boolean;
+    setMaxWidth(maxWidth: number): void;
+    setZIndex(zIndex: number): void;
+}

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

@@ -0,0 +1,112 @@
+/// <reference types="baidumap-web-sdk" />
+import type { Tg } from '../../event';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import { AbstractEventTargetDelegate } from '../../event-target';
+import type { UnionInfoWindow } from '../../unions';
+import type { Marker, BaiduMarker, GoogleMarker } from './marker';
+import { LatLng } from '../../lat-lng';
+import type { Point } from '../../types';
+/**
+ * ## InfoWindow的初始偏移, 不同实现
+ * - baidu: 根据Icon的infoWindowAnchor选项, 确定相对Icon左上角的偏移
+ * - google: 根据Marker的anchorPoint选项, 确定相对marker的position的偏移
+ *
+ * 统一成: InfoWindow的底部中点对齐Marker的position, 需要多少偏移使用offset选项来设置
+ */
+export interface InfoWindowOptions {
+    content: string | HTMLElement;
+    /** @default {LatLng.ZERO} */
+    position?: LatLng;
+    maxWidth?: number;
+    offset?: Point;
+    disableAutoPan?: boolean;
+}
+/**
+ * cSpell:words clickclose, statechange
+ * ## 打开/关闭InfoWindow的不同行为
+ * - google
+ *  0. 添加时, 默认不显示
+ *  1. close(), 不发送事件
+ *  2. 点击x, 发送`closeclick`事件
+ *  3. open(), 不发送事件
+ *  4. 可以同时打开多个InfoWindow
+ * - baidu:
+ *  0. 添加时, 默认不显示
+ *  1. close(), 发送`close`事件
+ *  2. 点击x, 先后发送`clickclose`, `close`事件
+ *  3. 点击地图的空白区域, 发送`close`事件
+ *  4. open(), 发送`open`事件
+ *  5. 同时只能打开一个, 之前的会自动关闭(发送`close`事件)
+ * - here(InfoBubble)
+ *  0. 添加时, 默认显示, 不发送事件
+ *  1. close(), 发送`statechange`事件
+ *  2. 点击x, 发送`statechange`事件
+ *  3. open(), 发送`statechange`事件
+ *  4. 可以同时打开多个InfoBubble
+ *
+ * 结论: 在baidu以外的地图上模拟open/close事件, 保证行为一致
+ */
+type InfoWindowEventMap = {
+    closeclick: Tg.Event;
+    /**
+     * ## 不同实现
+     * baidu: 原生支持open/close事件
+     * google: 通过拦截open()/close()/closeclick, 实现open/close事件
+     */
+    open: Tg.Event;
+    /** @see open */
+    close: Tg.Event;
+};
+/** 之所以需要这个type, 是为了将event的类型信息合并进去, 通过实现interface的方式似乎做不到这一点, 使用函数重载其实也可以做到 */
+export type InfoWindowOverlay = InfoWindow & Tg.EventTargetTyped<InfoWindow, InfoWindowEventMap>;
+/** 在@tg/map中 InfoWindow 不继承 Overlay... */
+export declare abstract class InfoWindow implements Tg.EventTarget {
+    private delegate;
+    constructor(delegate: AbstractEventTargetDelegate<UnionInfoWindow>);
+    addEventListener(type: string, listener: Tg.EventListener): void;
+    removeEventListener(type: string, listener: Tg.EventListener): void;
+    abstract inner: UnionInfoWindow;
+    /**
+     * 若anchor为空, 则添加到地图上
+     *
+     * ## 不同行为
+     * - baidu: 一定要anchor添加到地图上之后, 才能正常打开infoWindow
+     * - google: 没有上述限制
+     **/
+    abstract open(anchor?: Marker): void;
+    abstract close(): void;
+    abstract getPosition(): LatLng;
+    abstract setPosition(position: LatLng): void;
+    abstract isOpen(): boolean;
+}
+export declare class BaiduInfoWindow extends InfoWindow {
+    inner: BMap.InfoWindow;
+    private map;
+    private state;
+    static create(this: BaiduMap, options: InfoWindowOptions): BaiduInfoWindow;
+    constructor(inner: BMap.InfoWindow, map: BaiduMap, state: {
+        position?: LatLng;
+    });
+    isOpen(): boolean;
+    open(anchor?: BaiduMarker): void;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+}
+export declare class GoogleInfoWindow extends InfoWindow {
+    inner: google.maps.InfoWindow;
+    private map;
+    static create(this: GoogleMap, options: InfoWindowOptions): GoogleInfoWindow;
+    private eventHub;
+    private isOpened;
+    constructor(inner: google.maps.InfoWindow, map: GoogleMap);
+    isOpen(): boolean;
+    addEventListener<K extends keyof InfoWindowEventMap>(type: K, listener: (event: InfoWindowEventMap[K]) => void): void;
+    removeEventListener<K extends keyof InfoWindowEventMap>(type: K, listener: (event: InfoWindowEventMap[K]) => void): void;
+    open(anchor?: GoogleMarker): void;
+    close(): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+}
+export {};