tg-map-core 0.0.1

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

@@ -0,0 +1,111 @@
+import type { Tg } from '../../event';
+import { AbstractEventTargetDelegate } from '../../event-target';
+import { LatLng } from '../../lat-lng';
+import type { Point } from '../../types';
+import type { UnionInfoWindow } from '../../unions';
+import type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import './google-info.scss';
+import type { BaiduMarker, GoogleMarker, Marker } from './marker';
+/**
+ * ## 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事件, 保证行为一致
+ */
+export 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;
+}

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

@@ -0,0 +1,102 @@
+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 { MapPane } from './element-overlay';
+import { type GoogleLabel } from './google-label';
+import type { BaiduUnionIcon } from './icon';
+import { BaiduOverlay, GoogleOverlay, Overlay } from './overlay';
+export type BaiduLabel = BMap.Label & {
+    __label__?: BaiduLabelOverlay;
+};
+export type LabelEventMap = {
+    click: Tg.Event;
+};
+/**
+ * 初始位置, 左上角对齐position
+ */
+export interface LabelOptions {
+    content: LabelContent;
+    position?: LatLng;
+    offset?: Point;
+    /**
+     * ## 不同行为
+     * 当将label添加到marker中时:
+     * - baidu: zIndex设置无效, Label的元素的z-index始终为80
+     * - google: 依然有效, 但貌似是由于marker元素的opacity:0;的原因, 调整成比marker小的zIndex后, 依然不能位于marker后方...
+     * */
+    zIndex?: number;
+    /**
+     * ## 不同行为
+     * - baidu: 不支持该属性
+     * - google: 支持, 默认为{@link MapPane.overlayMouseTarget}
+     */
+    mapPane?: MapPane;
+}
+/**
+ * ## 不同实现
+ * - baidu: 有Label类,
+ *    - 添加到地图上时, 默认左上角对齐position
+ *    - 添加到marker中时, 默认左上角对齐marker的icon的左上角
+ *    - 内容只能是string, string可以是html字符串
+ * - google: 没有Label类, 我们用OverlayView实现了一个GoogleLabel
+ *    - 添加到地图上时, 默认左上角对齐position
+ *    - 没有添加到marker中的功能
+ *    - 内容是HTMLElement
+ *
+ * 针对这些不同, 使用了如下方法使它们行为尽量一致:
+ * 1. {@link BaiduLabelOverlay.attachIcon}, 让BaiduLabelOverlay关联icon, 使其添加到地图上时也是左上角对齐position
+ * 2. {@link GoogleMarker.setLabel}, 让GoogleMarker关联GoogleLabel, 联动它们的显隐/位置, 使其支持添加到marker中
+ * 3. {@link BaiduLabelOverlay.setContentInternal}, 将HTMLElement转成string, 并让BaiduLabelOverlay监听HTMLElement的改变, 由于转换成了string, 故里面的事件监听是无效的, 只能使用{@link LabelEventMap}中的事件
+ *
+ * ## 后续
+ * 经过重新调研, baidu和google是有基本上一致行为的`label`API的, 我们将它抽象成了{@link MarkerLabel}, 对于显示少量文字的情况, 用它就够了
+ * 对于显示复杂布局的情况, 当前baidu的实现是通过html转string再转html, 效率可能有问题
+ * TODO: 考虑重构成类似google那种基于自定义Overlay的实现方式🤔️
+ */
+export interface Label {
+    setContent(content: LabelContent): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+    setZIndex(zIndex: number): void;
+}
+export type LabelOverlay = Label & Overlay;
+type LabelContent = string | HTMLElement;
+declare namespace LabelContent {
+    function toString(content: LabelContent): string;
+    function toElement(content: LabelContent): HTMLElement;
+}
+/** 内容只能是固定不变的 */
+export declare class BaiduLabelOverlay extends BaiduOverlay<BaiduLabel> implements Label {
+    static create(this: BaiduMap, options: LabelOptions): BaiduLabelOverlay;
+    private icon;
+    private iconAnchor;
+    private content;
+    private contentObserver;
+    constructor(innerOverlay: BaiduLabel, coordType: CoordType, map: BaiduMap, content: LabelContent);
+    private setContentInternal;
+    setZIndex(zIndex: number): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+    setContent(content: LabelContent): void;
+    /**
+     * 关联新的Icon, 内部使用的方法
+     * @description baidu中Label默认左上角对齐Icon的左上, 我们要将其转换为对齐marker的position
+     * */
+    attachIcon(icon: BaiduUnionIcon | undefined): void;
+}
+export declare class GoogleLabelOverlay extends GoogleOverlay<GoogleLabel> implements Label {
+    static create(this: GoogleMap, options: LabelOptions): GoogleLabelOverlay;
+    setZIndex(zIndex: number): void;
+    setContent(content: LabelContent): void;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    getOffset(): Point;
+    setOffset(offset: Point): void;
+}
+export {};

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

@@ -0,0 +1,19 @@
+import './marker-label.scss';
+/**
+ * 和Marker关联的标签
+ *
+ * 与{@link Label}不同, 该类在google和baidu上都是使用Marker原生的label功能实现的, 更简单
+ * 当前baidu的{@link BaiduLabelOverlay}底层也是基于Marker的label, 故和该功能有冲突, 不能同时使用
+ */
+export interface MarkerLabel {
+    text: string;
+    className?: string;
+    color?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    fontFamily?: string;
+}
+export declare const MarkerLabel: {
+    toBaidu: (label: MarkerLabel) => BMap.Label;
+    toGoogle: (label: MarkerLabel) => google.maps.MarkerLabel;
+};

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

@@ -0,0 +1,144 @@
+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 type { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import type { BaiduInfoBox } from './baidu-info-box';
+import { UnionIcon } from './icon';
+import type { BaiduLabelOverlay, GoogleLabelOverlay, LabelOverlay } from './label';
+import { MarkerLabel } from './marker-label';
+import { BaiduOverlay, GoogleOverlay, Overlay, type OverlayOptions } from './overlay';
+export interface MarkerOptions extends OverlayOptions {
+    position: LatLng;
+    /**
+     * 执行{@link LatLng.toBaidu}时是否对经纬度进行标准化
+     *
+     * 因为{@link LatLng.toGoogle}内部是会自动标准化的, 并且LatLng绝大部分情况下是合法的,
+     * 所以添加这个参数, 只在使用者认为必要的时候, 执行标准化
+     *
+     * {@macro latlng_normalize}
+     */
+    normalizePositionForBaidu?: boolean;
+    title?: string;
+    /** @see MarkerLabel */
+    label?: MarkerLabel;
+    icon?: UnionIcon;
+    /** @default true */
+    clickable?: boolean;
+    /** @default false */
+    draggable?: boolean;
+    /**
+     * 拖拽时是否显示`x`
+     * @default true
+     * */
+    crossOnDrag?: boolean;
+    /**
+     * ## 不同行为
+     * - google: 有`cursor` 属性, 作用是hover时改变cursor
+     * - baidu: 有`draggingCursor`属性, 作用是拖动时改变cursor
+     * - maptalks: 同google
+     * @deprecated 不推荐使用
+     */
+    cursor?: string;
+    zIndex?: number;
+}
+/** 仅仅起到类型声明的作用... */
+export type MarkerEventMap = {
+    click: Tg.MouseEvent;
+    dblclick: Tg.MouseEvent;
+    /** @deprecated 使用`contextmenu`替代 */
+    rightclick: Tg.MouseEvent;
+    contextmenu: Tg.MouseEvent;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+    dragstart: Tg.MouseEvent;
+    drag: Tg.MouseEvent;
+    dragend: Tg.MouseEvent;
+};
+export interface Marker extends Tg.EventTargetTyped<Marker, MarkerEventMap> {
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    /** @see MarkerLabel */
+    setLabel(label: MarkerLabel): void;
+    setIcon(icon: UnionIcon): void;
+    /** 感觉并没有读取Icon的必要, 直接返回内部的Icon, 懒得写包装类_(:3」∠)_ */
+    getIcon(): Nullable<UnionGoogleIcon | UnionBaiduIcon>;
+    /**
+     * ## 不同行为
+     * - baidu: 不支持设置clickable
+     * - google: 支持
+     * @deprecated 不推荐使用
+     */
+    setClickable(enable: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    /**
+     * ## 不同行为
+     * - baidu: 调用该方法无效
+     * - google: 有效
+     */
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    attachLabelOverlay(label: LabelOverlay | undefined): void;
+}
+export type MarkerOverlay = Marker & Overlay;
+export type BMarker = BMap.Marker & {
+    __info_box__?: BaiduInfoBox;
+    __create_by_tg__?: boolean;
+};
+export declare class BaiduMarker extends BaiduOverlay<BMarker> implements Marker {
+    /** baidu的Marker不支持读/写clickable等属性, 故只能将创建临时的clickable保存在这个state中 */
+    private state;
+    static create(this: BaiduMap, options: MarkerOptions): BaiduMarker;
+    constructor(innerOverlay: BMap.Marker, coordType: CoordType, map: BaiduMap, 
+    /** baidu的Marker不支持读/写clickable等属性, 故只能将创建临时的clickable保存在这个state中 */
+    state: {
+        clickable: boolean;
+        draggable: boolean;
+        zIndex: number | undefined;
+        normalize?: boolean;
+    });
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setIcon(icon: UnionIcon): void;
+    getIcon(): UnionBaiduIcon;
+    setClickable(enable: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    setLabel(label: MarkerLabel): void;
+    _updateMarkerLabelOffset(): void;
+    attachLabelOverlay(label: BaiduLabelOverlay | undefined): void;
+    getLabelOverlay(): BaiduLabelOverlay | undefined;
+}
+export declare class GoogleMarker extends GoogleOverlay<google.maps.Marker> implements Marker {
+    static create(this: GoogleMap, options: MarkerOptions): GoogleMarker;
+    private label;
+    private labelPositionListener;
+    private labelVisibleListener;
+    private labelMapChangedListener;
+    getPosition(): LatLng;
+    setPosition(position: LatLng): void;
+    setTitle(title: string): void;
+    getTitle(): string;
+    setIcon(icon: UnionIcon): void;
+    getIcon(): Nullable<UnionGoogleIcon>;
+    setClickable(flag: boolean): void;
+    isClickable(): boolean;
+    setDraggable(enable: boolean): void;
+    isDraggable(): boolean;
+    setZIndex(zIndex?: number): void;
+    getZIndex(): number | undefined;
+    setLabel(label: MarkerLabel): void;
+    attachLabelOverlay(label: GoogleLabelOverlay | undefined): void;
+}

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

@@ -0,0 +1,46 @@
+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 { BaiduMap } from '../baidu-map';
+import type { GoogleMap } from '../google-map';
+import type { BaseMap } from '../map';
+export interface OverlayOptions {
+    /** @default true */
+    visible?: boolean;
+}
+export declare abstract class Overlay<T = unknown> implements Tg.EventTarget {
+    innerOverlay: T;
+    /** 用于保存Overlay内部点的坐标, 它的值有可能和map的不同 */
+    protected coordType: CoordType;
+    constructor(innerOverlay: T, 
+    /** 用于保存Overlay内部点的坐标, 它的值有可能和map的不同 */
+    coordType: CoordType);
+    protected abstract map: BaseMap;
+    protected abstract createDelegate(): EventTargetDelegate;
+    private _delegate;
+    private get delegate();
+    addEventListener(type: string, listener: Tg.EventListener): void;
+    removeEventListener(type: string, listener: Tg.EventListener): void;
+    remove(): void;
+    abstract isVisible(): boolean;
+    abstract setVisible(visible: boolean): void;
+}
+export declare class GoogleOverlay<T extends UnionGoogleOverlay = UnionGoogleOverlay> extends Overlay<T> {
+    protected map: GoogleMap;
+    constructor(innerOverlay: T, coordType: CoordType, map: GoogleMap);
+    protected createDelegate(): EventTargetDelegate;
+    isVisible(): boolean;
+    setVisible(visible: boolean): void;
+}
+export declare class BaiduOverlay<T extends UnionBaiduOverlay = UnionBaiduOverlay> extends Overlay<T> {
+    protected map: BaiduMap;
+    constructor(innerOverlay: T, coordType: CoordType, map: BaiduMap);
+    protected createDelegate(): EventTargetDelegate;
+    /** 仅限内部使用; 设为private时, 生成的d.ts文件中, 方法返回值会变成any, 故改成了public */
+    get overlay(): Required<Pick<UnionBaiduOverlay, "isVisible" | "show" | "hide">>;
+    isVisible(): boolean;
+    setVisible(visible: boolean): void;
+    /** 在创建BaiduOverlay时, 设置options.visible, 仅内部使用 */
+    visibleOptionInternal(visible: boolean | undefined): this;
+}

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

@@ -0,0 +1,42 @@
+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 { Overlay } from './overlay';
+import { BaiduPolyShape } from './polyline';
+import { GoogleShape, type Shape, type ShapeOptions } from './shape';
+export type PolygonEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+    /** @see PolylineEventMap `.path-edited` */
+    'paths-edited': Tg.Event;
+};
+export interface PolygonOptions extends ShapeOptions {
+    paths: LatLng[][];
+}
+export interface Polygon extends Tg.EventTargetTyped<Polygon, PolygonEventMap>, Shape {
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}
+export type PolygonOverlay = Polygon & Overlay;
+export declare class BaiduPolygon extends BaiduPolyShape<BMap.Polygon> implements Polygon {
+    static create(this: BaiduMap, options: PolygonOptions): BaiduPolygon;
+    protected pathEditedEventType: string;
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}
+export declare class GooglePolygon extends GoogleShape<google.maps.Polygon> implements Polygon {
+    static create(this: GoogleMap, options: PolygonOptions): GooglePolygon;
+    private pathChangedListeners;
+    private setupPathChangedListeners;
+    private clearPathChangedListeners;
+    private eventHubDelegate;
+    protected createDelegate(): EventHubEventTargetDelegate<"paths-edited">;
+    getPaths(): LatLng[][];
+    setPaths(paths: LatLng[][]): void;
+}

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

@@ -0,0 +1,71 @@
+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 { IconSequence } from './icon';
+import type { Overlay } from './overlay';
+import { BaiduShape, GoogleShape, type NotFillableShape, type NotFillableShapeOptions } from './shape';
+export type PolylineEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+    /**
+     * 在`editable`模式下编辑了path的事件
+     * 外部调用{@link Polyline#setPath}, 不触发该事件 (之所以这样设计, 是为了避免频繁的进行LatLng<=>地图点对象的相互转换)
+     *
+     * ## 原理
+     * 该事件的实现比较杂, 原始地图并没有等效的事件, 都是通过转换实现的
+     * - google: 通过监听path的`insert/remove/set_at`实现
+     * - baidu: 通过监听`lineupdate`事件, 然后判断path有没有被修改, 来实现的
+     */
+    'path-edited': Tg.Event;
+};
+export interface PolylineOptions extends NotFillableShapeOptions {
+    path: LatLng[];
+    /**
+     * ## 不同行为
+     * - google: 功能正常
+     * - baidu: 百度地图在移除Polyline时, icons不会被移除, 导致错乱, 这里通过复写{@link BaiduPolyline.remove}, 规避了该bug
+     */
+    icons?: IconSequence[];
+}
+export interface Polyline extends Tg.EventTargetTyped<Polyline, PolylineEventMap>, NotFillableShape {
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}
+export type PolylineOverlay = Polyline & Overlay;
+export declare abstract class BaiduPolyShape<T extends BMap.Polyline | BMap.Polygon> extends BaiduShape<T> {
+    /** 路径被编辑的事件名 */
+    protected abstract pathEditedEventType: string;
+    /** 修改路径, 仅内部使用 */
+    protected setPathInternal(path: BMap.Point[]): void;
+    private eventHubDelegate;
+    protected createDelegate(): EventHubEventTargetDelegate<string>;
+    private prevPath;
+    private isDoingSetPath;
+    private onLineUpdate;
+}
+export declare class BaiduPolyline extends BaiduPolyShape<BMap.Polyline> implements Polyline {
+    static create(this: BaiduMap, options: PolylineOptions): BaiduPolyline;
+    protected pathEditedEventType: string;
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+    remove(): void;
+}
+/**
+ * Google地图的网页版不支持Advanced Polyline(纹理/渐变等效果), 详见: https://issuetracker.google.com/issues/267845944
+ */
+export declare class GooglePolyline extends GoogleShape<google.maps.Polyline> implements Polyline {
+    static create(this: GoogleMap, options: PolylineOptions): GooglePolyline;
+    private pathChangedListeners;
+    private setupPathChangedListeners;
+    private clearPathChangedListeners;
+    private eventHubDelegate;
+    protected createDelegate(): EventHubEventTargetDelegate<"path-edited">;
+    getPath(): LatLng[];
+    setPath(path: LatLng[]): void;
+}

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

@@ -0,0 +1,50 @@
+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 { Overlay } from './overlay';
+import { BaiduPolyShape } from './polyline';
+import { GoogleShape, type Shape, type ShapeOptions } from './shape';
+export type RectangleEventMap = {
+    click: Tg.Event;
+    dblclick: Tg.Event;
+    mousedown: Tg.MouseEvent;
+    mouseup: Tg.MouseEvent;
+    mouseout: Tg.MouseEvent;
+    mouseover: Tg.MouseEvent;
+    /**
+     * - google: 监听[bounds_changed](https://developers.google.com/maps/documentation/javascript/shapes#editable_events)
+     * - baidu: 内部使用Polygon并监听`lineupdate`实现
+     */
+    'bounds-changed': Tg.Event;
+};
+export interface RectangleOptions extends ShapeOptions {
+    bounds: LatLngBounds;
+}
+export interface Rectangle extends Tg.EventTargetTyped<Rectangle, RectangleEventMap>, Shape {
+    getBounds(): LatLngBounds;
+    setBounds(bounds: LatLngBounds): void;
+}
+/**
+ * 矩形覆盖物
+ *
+ * - google: 有矩形
+ * - baidu: 没有矩形, 使用{@link BMap.Polygon}变相实现
+ */
+export type RectangleOverlay = Rectangle & Overlay;
+export declare class BaiduRectangle extends BaiduPolyShape<BMap.Polygon> implements Rectangle {
+    static create(this: BaiduMap, options: RectangleOptions): BaiduRectangle;
+    constructor(innerOverlay: BMap.Polygon, coordType: CoordType, map: BaiduMap, state: {
+        editable: boolean;
+    });
+    protected pathEditedEventType: string;
+    private isDoingUpdateRectangle;
+    private onBoundsChanged;
+    getBounds(): LatLngBounds;
+    setBounds(bounds: LatLngBounds): void;
+}
+export declare class GoogleRectangle extends GoogleShape<google.maps.Rectangle> implements Rectangle {
+    static create(this: GoogleMap, options: RectangleOptions): GoogleRectangle;
+    getBounds(): LatLngBounds;
+    setBounds(bounds: LatLngBounds): void;
+}

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

@@ -0,0 +1,76 @@
+import type { CoordType } from '../../lat-lng';
+import type { UnionBaiduShape, UnionGoogleShape } from '../../unions';
+import type { BaiduMap } from '../baidu-map';
+import type { SymbolIcon } from './icon';
+import { BaiduOverlay, GoogleOverlay, type OverlayOptions } from './overlay';
+export interface ShapeOptions extends OverlayOptions {
+    clickable?: boolean;
+    editable?: boolean;
+    strokeColor?: string;
+    strokeOpacity?: number;
+    /**
+     * ## 取值范围不同
+     * - google: 最大值约为32, 更大的值不影响线宽
+     * - baidu: 没有上限
+     */
+    strokeWeight?: number;
+    fillColor?: string;
+    fillOpacity?: number;
+    /**
+     * ## 不同实现
+     * - google: 支持, 但由于shape和marker所处的mapPan不同, 无法移动到marker上方
+     * - baidu: 不支持
+     * - maptalks: 为了兼容性, 参考google的效果来实现
+     */
+    zIndex?: number;
+}
+export interface Shape {
+    isEditable(): boolean;
+    setEditable(editable: boolean): void;
+    setStrokeColor(color: string): void;
+    setStrokeOpacity(opacity: number): void;
+    setStrokeWeight(weight: number): void;
+    /** Polyline 没有该方法 */
+    setFillColor(color: string): void;
+    /** @see setFillColor */
+    setFillOpacity(opacity: number): void;
+    /** baidu不支持 */
+    setZIndex(zIndex: number): void;
+}
+export type NotFillableShape = Omit<Shape, 'setFillColor' | 'setFillOpacity'>;
+export type NotFillableShapeOptions = Omit<ShapeOptions, 'fillColor' | 'fillOpacity'>;
+export declare abstract class BaiduShape<T extends UnionBaiduShape> extends BaiduOverlay<T> implements Shape {
+    protected state: {
+        editable: boolean;
+        symbolIcons?: SymbolIcon[];
+    };
+    /**
+     * baidu地图的透明度属性有如下问题:
+     * - 在透明度为0时, 无法隐藏掉颜色
+     * - 透明度为0.7和0.8时, 在maintain的发布模式下, polyline的线条会不可见 (原因未知, 在tg-map中无法复现)
+     * 故统一加个0.001, 规避这些问题...
+     */
+    static OPACITY_DELTA: number;
+    constructor(innerOverlay: T, coordType: CoordType, map: BaiduMap, state: {
+        editable: boolean;
+        symbolIcons?: SymbolIcon[];
+    });
+    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;
+}
+export declare abstract class GoogleShape<T extends UnionGoogleShape> extends GoogleOverlay<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;
+}