cmap-core 0.0.9 → 0.2.0

package/dist/index.es.d.ts

@@ -1,15 +1,20 @@
 import { BBox } from 'rbush';
+import { ColorSpecification } from 'mapbox-gl';
+import { DataDrivenPropertyValueSpecification } from 'mapbox-gl';
 import { default as default_2 } from 'rbush';
 import { default as default_3 } from 'eventemitter3';
 import { Feature } from 'geojson';
 import type * as GeoJSON_2 from 'geojson';
 import { LayerSpecification } from 'mapbox-gl';
+import { LineString } from 'geojson';
 import { LngLat } from 'mapbox-gl';
 import { Map as Map_2 } from 'mapbox-gl';
+import { MapEventType } from 'mapbox-gl';
 import { MapMouseEvent } from 'mapbox-gl';
 import { MapOptions } from 'mapbox-gl';
 import { MultiLineString } from 'geojson';
-import { Point } from 'mapbox-gl';
+import { Point as Point_2 } from 'mapbox-gl';
+import { Polygon } from 'geojson';
 import { Source } from 'mapbox-gl';
 import { SourceSpecification } from 'mapbox-gl';
 
@@ -37,24 +42,41 @@ export declare class AisShip extends BaseShip<IAisShipOptions> {
     unfocus(): void;
     icon(): GeoJSON_2.Feature<GeoJSON_2.Point, IAisShipOptions>;
     real(): GeoJSON_2.Feature<GeoJSON_2.Polygon, IAisShipOptions> | GeoJSON_2.Feature<GeoJSON_2.Point, IAisShipOptions>;
+    headingLine(): GeoJSON_2.Feature<GeoJSON_2.LineString | null, {
+        meta: 'directionLine';
+        'line-color': string;
+    }>;
     render(): void;
     label(): HTMLElement;
-    offset(): Point;
+    offset(): Point_2;
 }
 
 declare interface AllAnchor {
+    center: BBox;
+    top: BBox;
+    bottom: BBox;
+    left: BBox;
+    right: BBox;
     'top-left': BBox;
     'top-right': BBox;
     'bottom-left': BBox;
     'bottom-right': BBox;
 }
 
-declare type Anchor = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+declare type Anchor = 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 
 declare const ARROW_ICON = "<svg t=\"1769503360247\" class=\"icon\" viewBox=\"0 0 1024 1024\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" p-id=\"24046\" width=\"64\" height=\"64\"><path d=\"M509.093 894.223l-447.093-761.539 452.861 219.23099999 447.139-222.13799999z\" p-id=\"24047\" fill=\"#d81e06\"></path></svg>";
 
 declare const ARROW_ICON_NAME = "track-arrow";
 
+export declare class ArrowLine extends Line<IArrowLineOptions> {
+    constructor(map: Map_2, options: IArrowLineOptions);
+    onAdd(): void;
+    createVertex(id: string, index: number, position: LngLat): PointInstance;
+    private getIconName;
+    private getRotate;
+}
+
 export declare abstract class BaseShip<T extends IBaseShipOptions> extends Module {
     options: T;
     readonly SOURCE: string;
@@ -64,6 +86,7 @@ export declare abstract class BaseShip<T extends IBaseShipOptions> extends Modul
     protected constructor(map: Map_2, options: T);
     destroy(): void;
     get isFocus(): boolean;
+    get isHover(): boolean;
     abstract onAdd(): void;
     abstract onRemove(): void;
     abstract get id(): IBaseShipOptions['id'];
@@ -84,9 +107,13 @@ export declare abstract class BaseShip<T extends IBaseShipOptions> extends Modul
     abstract unfocus(): void;
     abstract icon(): GeoJSON_2.Feature<GeoJSON_2.Point, T>;
     abstract real(): GeoJSON_2.Feature<GeoJSON_2.Polygon, T> | GeoJSON_2.Feature<GeoJSON_2.Point, T>;
+    abstract headingLine(): GeoJSON_2.Feature<GeoJSON_2.LineString | null, {
+        meta: 'directionLine';
+        'line-color': string;
+    }>;
     abstract render(): void;
     abstract label(): HTMLElement;
-    abstract offset(): Point;
+    abstract offset(): Point_2;
     setState(states: Record<string, unknown>): void;
     getState(): Record<string, unknown> | null | undefined;
     isSelf(e: MapMouseEvent): boolean;
@@ -128,6 +155,22 @@ declare interface CacheOptions {
 
 declare type CacheType = 'sessionstorage' | 'localstorage';
 
+declare interface CalcOffsetParams {
+    iconHeight: number;
+    iconScale?: number;
+    iconAnchor?: IconAnchor;
+    textSize?: number;
+    gap?: number;
+}
+
+declare interface CirclePointStyle {
+    'circle-stroke-width'?: number;
+    'circle-stroke-color'?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    'circle-radius'?: number;
+    'circle-color'?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    'text-color'?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+}
+
 export declare class CMap extends default_3 {
     readonly map: Map_2;
     private readonly options;
@@ -199,6 +242,11 @@ export declare class CollisionItem {
  */
 declare interface CollisionItemOptions {
     id: string | number;
+    center: BBox;
+    top: BBox;
+    bottom: BBox;
+    left: BBox;
+    right: BBox;
     'top-left': BBox;
     'top-right': BBox;
     'bottom-left': BBox;
@@ -215,24 +263,109 @@ export declare class Context {
     readonly register: ResourceRegister;
     readonly iconManage: IconManager;
     readonly focus: Focus;
+    readonly eventManager: EventManager;
     constructor(options: IContextOptions);
     destroy(): void;
 }
 
+declare const DEFAULT_CIRCLE_COLOR = "#fff";
+
+declare const DEFAULT_CIRCLE_RADIUS = 10;
+
+declare const DEFAULT_CIRCLE_STROKE_COLOR = "#f00";
+
+declare const DEFAULT_CIRCLE_STROKE_WIDTH = 2;
+
+declare const DEFAULT_FILL_COLOR = "#009dff";
+
+declare const DEFAULT_FILL_OPACITY = 0.3;
+
+declare const DEFAULT_ICON_ANCHOR = "bottom";
+
+declare const DEFAULT_ICON_SIZE = 1;
+
+declare const DEFAULT_LINE_COLOR = "#f00";
+
+declare const DEFAULT_LINE_WIDTH = 3;
+
+declare const DEFAULT_TEXT_COLOR = "#333";
+
+declare const DEFAULT_TEXT_COLOR_2 = "#333";
+
+declare const DEFAULT_TEXT_SIZE = 12;
+
+declare const DEFAULT_TEXT_SIZE_2 = 16;
+
+declare const DEFAULT_TEXT_SIZE_3 = 12;
+
+declare const DOTTED_LINE_LAYER: LayerSpecification;
+
+declare const DOTTED_LINE_LAYER_NAME = "mapbox-gl-plot-dotted-line-layer";
+
 declare const END_ICON = "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"74\" height=\"74\" viewBox=\"0 0 74 74\" fill=\"none\"><circle cx=\"37\" cy=\"37\" r=\"32\" stroke=\"rgba(172, 51, 193, 1)\" stroke-width=\"10\"      fill=\"#AC33C1\" ></circle><path d=\"M45.6 33.64C49.28 36.12 55.28 38.24 55.28 38.24L54 41.8C50.48 40.32 47.78 38.88 47.78 38.88C45.08 37.44 42.92 35.8 42.92 35.8C38.76 38.84 32.04 41.6 32.04 41.6L30.4 38.4C36.28 36.2 40.24 33.56 40.24 33.56C38.2 31.6 36.12 28.8 36.12 28.8C34.56 30.92 32.68 32.88 32.68 32.88L30.72 30.36C32.88 28.08 35.08 24.52 35.08 24.52C37.28 20.96 38.4 18 38.4 18L41.64 18.92C41.2 19.96 40.24 22.04 40.24 22.04L52.04 22.04L52.04 25.48C50.56 27.96 49.02 29.96 49.02 29.96C47.48 31.96 45.6 33.64 45.6 33.64ZM20.76 33.44C19.96 33.48 19 33.76 19 33.76L18.2 30.24C18.72 30.04 18.98 29.82 18.98 29.82C19.24 29.6 19.56 29.2 19.56 29.2C20.44 28 22.06 24.68 22.06 24.68C23.68 21.36 24.92 18.2 24.92 18.2L28.04 19.4C26.8 22.28 25.24 25.4 25.24 25.4C23.68 28.52 22.6 30.04 22.6 30.04C25.92 29.56 26.76 29.44 26.76 29.44C28.16 26.68 29.28 24.16 29.28 24.16L32.16 25.52C30.52 28.92 28.16 33.22 28.16 33.22C25.8 37.52 24.4 39.48 24.4 39.48L27.36 38.76L29.76 38.16L29.84 41.68C29.28 41.72 26.86 42.2 26.86 42.2C24.44 42.68 22.52 43.08 22.52 43.08C21.96 43.2 20.84 43.52 20.84 43.52L19.92 43.76L19.08 40.12C19.96 39.76 20.34 39.48 20.34 39.48C20.72 39.2 21.2 38.64 21.2 38.64C22.84 36.6 24.92 32.84 24.92 32.84C22.24 33.28 20.76 33.44 20.76 33.44ZM38.08 25.92C40.2 29.2 42.88 31.52 42.88 31.52C45.56 29.16 48.12 25.4 48.12 25.4L38.4 25.4L38.08 25.92ZM37.6 39.4L40.8 40.4L49.4 43.08L48.12 46.52C45.76 45.68 42.22 44.5 42.22 44.5C38.68 43.32 36.64 42.76 36.64 42.76L37.6 39.4ZM18 49.08C18.68 48.96 21.08 48.4 21.08 48.4C23.48 47.84 25.2 47.44 25.2 47.44C30.76 46.2 31.08 46.12 31.08 46.12L31.28 49.6C30.12 49.8 22.24 51.6 22.24 51.6C18.8 52.44 18.48 52.48 18.48 52.48L18 49.08ZM34.4 46.48C37.24 47.24 42.46 48.82 42.46 48.82C47.68 50.4 51.12 51.52 51.12 51.52L49.92 55.04C46.44 53.8 41.38 52.2 41.38 52.2C36.32 50.6 33.44 49.84 33.44 49.84L34.4 46.48Z\"   fill=\"#FFFFFF\" ></path></svg>";
 
 declare const END_ICON_NAME = "track-end";
 
+/**
+ * ✅ [新增] 定义通用的事件回调类型
+ * 替代原生的 Function 类型
+ * 这里定义为接收一个参数（事件对象），没有返回值
+ */
+declare type EventHandler = (e: any) => void;
+
+export declare class EventManager {
+    private map;
+    private listeners;
+    private activeLayerListeners;
+    private currentHoverIdByLayer;
+    constructor(map: Map_2);
+    /**
+     * 注册事件监听
+     * @param id 实例/Feature 的 ID
+     * @param layerId Mapbox 图层 ID
+     * @param eventType 事件类型 (click, mouseenter, contextmenu 等)
+     * @param callback 回调函数
+     */
+    on(id: string | number, layerId: string, eventType: MapEventType, callback: EventHandler): void;
+    /**
+     * 移除事件监听
+     * @param id 实例 ID
+     * @param eventType (可选) 事件类型，不传则移除该 ID 所有事件
+     * @param callback (可选) 指定回调，不传则移除该类型所有回调
+     */
+    off(id: string | number, eventType?: MapEventType, callback?: EventHandler): void;
+    /**
+     * 确保 Mapbox 底层对该图层的该事件进行了监听
+     */
+    private ensureMapListener;
+    /**
+     * 核心分发逻辑
+     */
+    private dispatch;
+    /**
+     * 销毁管理器
+     * 必须在地图销毁前调用，防止内存泄漏
+     */
+    destroy(): void;
+}
+
+declare interface EventMessage<T> {
+    originEvent: MapMouseEvent;
+    instance: T;
+}
+
 declare abstract class EventState extends Module {
-    private status;
+    status: EventStatus;
     static ON: EventStatus;
     static OFF: EventStatus;
     protected constructor(map: Map_2);
     abstract onAdd(): void;
     abstract onRemove(): void;
     switch(): EventStatus;
-    abstract on(): void;
-    abstract off(): void;
+    changeStatus(): void;
+    message<T>(e: MapMouseEvent, instance: T): EventMessage<T>;
+    abstract enabled(): void;
+    abstract disabled(): void;
 }
 
 declare enum EventStatus {
@@ -240,6 +373,118 @@ declare enum EventStatus {
     OFF = "Off"
 }
 
+export declare class Fill<T extends IFillOptions = IFillOptions> extends Poi<T, GeoJSON_2.Polygon | null> {
+    static NAME: PlotType;
+    readonly LAYER: string;
+    title: IconPoint | null;
+    line: Line | null;
+    protected residentEvent: FillResidentEvent;
+    protected updateEvent: FillUpdateEvent;
+    protected createEvent: FillCreateEvent;
+    constructor(map: Map_2, options: T);
+    get center(): LngLat | null;
+    get geometry(): Polygon | null;
+    getFeature(): Feature<Polygon | null>;
+    get id(): string;
+    move(position: LngLat): void;
+    createLine(): void;
+    removeLine(): void;
+    onAdd(): void;
+    onRemove(): void;
+    remove(): void;
+    show(): void;
+    hide(): void;
+    render(): void;
+    start(): void;
+    stop(): void;
+    unedit(): void;
+    edit(): void;
+    focus(): void;
+    unfocus(): void;
+    select(): void;
+    unselect(): void;
+    update(options: T): void;
+}
+
+declare const FILL_CLOSED_LINE_LAYER: LayerSpecification;
+
+declare const FILL_CLOSED_LINE_LAYER_NAME = "mapbox-gl-plot-closed-line-layer";
+
+declare const FILL_LAYER: LayerSpecification;
+
+declare const FILL_LAYER_NAME = "mapbox-gl-plot-fill-layer";
+
+declare abstract class FillBaseEvent extends EventState {
+    protected fill: Fill;
+    protected constructor(map: Map_2, fill: Fill);
+    abstract onAdd(): void;
+    abstract onRemove(): void;
+    abstract enabled(): void;
+    abstract disabled(): void;
+}
+
+declare class FillCreateEvent extends FillBaseEvent {
+    private count;
+    private drawPoint;
+    private onClick;
+    private onMousemove;
+    private onContextmenu;
+    private stop;
+    constructor(map: Map_2, fill: Fill);
+    setDrawLngLat(position: LngLat | null): void;
+    getDrawLngLat(): LngLat | null;
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare class FillResidentEvent extends FillBaseEvent {
+    constructor(map: Map_2, fill: Fill);
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare interface FillStyle {
+    'fill-color'?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    'fill-opacity'?: DataDrivenPropertyValueSpecification<number>;
+}
+
+declare class FillUpdateEvent extends FillBaseEvent {
+    protected dragStartLngLat: LngLat | null;
+    private onLineUpdate;
+    private onLineMidUpdate;
+    private onLineMidDoneUpdate;
+    private onFillMousedown;
+    private onMousemove;
+    private onMouseup;
+    private onFillMouseenter;
+    private onFillMouseLeave;
+    constructor(map: Map_2, fill: Fill);
+    setDragLngLat(position: LngLat | null): void;
+    getDragLngLat(): LngLat | null;
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+export declare namespace FillVars {
+    export {
+        NAME,
+        Z_INDEX,
+        FILL_LAYER_NAME,
+        FILL_CLOSED_LINE_LAYER_NAME,
+        DEFAULT_FILL_COLOR,
+        DEFAULT_FILL_OPACITY,
+        FILL_LAYER,
+        FILL_CLOSED_LINE_LAYER,
+        LAYER_LIST
+    }
+}
+
 declare class Focus extends default_3 {
     private readonly map;
     focusItems: FocusItem[];
@@ -283,11 +528,19 @@ declare interface FocusItem {
     options?: IFocusOptions;
 }
 
+declare const GAP_PX = 5;
+
+declare const GAP_PX_2 = 5;
+
 declare interface IAisShipOptions extends IBaseShipOptions {
     outLine?: boolean;
     updateStatus?: UPDATE_STATUS;
 }
 
+declare interface IArrowLineOptions extends ILineOptions {
+    vertexStyle?: IconPointStyle;
+}
+
 declare interface IBaseShipOptions {
     id: string | number;
     name: string;
@@ -318,6 +571,7 @@ declare interface IBaseShipOptions {
 declare interface ICMapOptions extends MapOptions {
     type?: MapType;
     TDTToken?: string;
+    http2?: boolean;
 }
 
 declare interface Icon {
@@ -326,11 +580,16 @@ declare interface Icon {
     options?: Partial<StyleImageMetadata>;
 }
 
+declare const ICON_ROTATE: DataDrivenPropertyValueSpecification<number>;
+
+declare type IconAnchor = 'center' | 'left' | 'right' | 'top' | 'bottom' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+
 export declare class IconManager {
     static SUCCESS: RESULT_CODE;
     static FAIL: RESULT_CODE;
     _map: Map_2;
     _cache: Cache_2;
+    private loadingPromises;
     constructor(map: Map_2);
     load(icons: Icon[]): Promise<{
         success: result[];
@@ -350,22 +609,132 @@ export declare class IconManager {
     error(icon: Icon | SvgIcon, err: string | Error): result;
 }
 
+export declare class IconPoint extends Point<IIconPointOptions> {
+    static NAME: PlotType;
+    readonly LAYER: string;
+    constructor(map: Map_2, options: IIconPointOptions);
+    onAdd(): void;
+    getFeature(): GeoJSON_2.Feature<GeoJSON_2.Point | null>;
+}
+
+declare interface IconPointStyle {
+    'text-color'?: string;
+    'text-size'?: number;
+    'icon-size'?: number;
+    'icon-rotate'?: number;
+    'text-offset'?: [number, number];
+    'icon-anchor'?: IconAnchor;
+}
+
+export declare namespace IconPointVars {
+    export {
+        NAME_2 as NAME,
+        POINT_ICON_LAYER_NAME,
+        DEFAULT_TEXT_SIZE,
+        DEFAULT_ICON_ANCHOR,
+        GAP_PX,
+        DEFAULT_ICON_SIZE,
+        ICON_ROTATE,
+        POINT_ICON_LAYER,
+        LAYER_LIST_2 as LAYER_LIST
+    }
+}
+
 declare interface IContextOptions {
     map: Map_2;
 }
 
+declare interface IFillOptions extends IPoiOptions {
+    position?: PolygonPosition;
+    style?: FillStyle;
+    icon?: string;
+    outLineStyle?: LineStyle;
+    vertexStyle?: PointStyle;
+    midStyle?: PointStyle;
+    titleStyle?: PointStyle;
+    properties?: Record<string, any>;
+}
+
 declare interface IFocusOptions {
     size?: number;
     padding?: number;
     armLength?: number;
 }
 
+declare interface IIconPointOptions extends IPointOptions {
+    icon: string;
+    style?: IconPointStyle;
+}
+
+declare interface IIndexLineOptions extends ILineOptions {
+}
+
+declare interface IIndexPointOptions extends IPointOptions {
+    index: number;
+    style?: IndexPointStyle;
+}
+
+declare interface ILineOptions extends IPoiOptions {
+    position?: LineStringPosition;
+    style?: LineStyle;
+    vertexStyle?: PointStyle;
+    midStyle?: PointStyle;
+    properties?: Record<string, any>;
+}
+
 declare interface Image_2 {
     width: number;
     height: number;
     image: ImageBitmap | HTMLImageElement | ImageData;
 }
 
+export declare class IndexLine extends Line<IIndexLineOptions> {
+    constructor(map: Map_2, options: IIndexLineOptions);
+    createVertex(id: string, index: number, position: LngLat): PointInstance;
+}
+
+export declare class IndexPoint extends Point<IIndexPointOptions> {
+    static NAME: PlotType;
+    readonly LAYER: string;
+    constructor(map: Map_2, options: IIndexPointOptions);
+    onAdd(): void;
+    getFeature(): GeoJSON_2.Feature<GeoJSON_2.Point | null>;
+}
+
+declare interface IndexPointStyle {
+    'text-color'?: string;
+    'text-size'?: number;
+    'circle-stroke-width'?: number;
+    'circle-stroke-color'?: ColorSpecification;
+    'circle-radius'?: number;
+    'circle-color'?: ColorSpecification;
+}
+
+export declare namespace IndexPointVars {
+    export {
+        NAME_3 as NAME,
+        POINT_INDEX_LAYER_NAME,
+        DEFAULT_TEXT_COLOR,
+        POINT_INDEX_LAYER,
+        LAYER_LIST_3 as LAYER_LIST
+    }
+}
+
+declare interface IPointOptions extends IPoiOptions {
+    position?: PointPosition;
+    style?: PointStyle;
+    properties?: Record<string, any>;
+}
+
+declare interface IPoiOptions {
+    id: string;
+    name?: string;
+    visibility: PlotVisibility;
+    isName?: boolean;
+    style?: any;
+    properties?: Record<string, any>;
+}
+
 declare interface IShipOptions {
     plugins?: BaseShipConstructor[];
 }
@@ -373,6 +742,7 @@ declare interface IShipOptions {
 declare interface ITooltipOptions {
     id: string | number;
     visible?: boolean;
+    line?: boolean;
     className?: string;
     position: LngLat;
     element: HTMLElement;
@@ -386,37 +756,227 @@ declare interface ITrackOptions {
     endLabel: string;
 }
 
-declare const LAYER_LIST: LayerSpecification[];
+declare const LAYER_LIST: SortLayer[];
+
+declare const LAYER_LIST_2: SortLayer[];
+
+declare const LAYER_LIST_3: SortLayer[];
+
+declare const LAYER_LIST_4: SortLayer[];
+
+declare const LAYER_LIST_5: SortLayer[];
+
+declare const LAYER_LIST_6: SortLayer[];
+
+declare const LAYER_LIST_7: SortLayer[];
+
+export declare class Line<T extends ILineOptions = ILineOptions> extends Poi<T, GeoJSON_2.LineString | null> {
+    static NAME: PlotType;
+    readonly LAYER: string;
+    points: PointInstance[];
+    midPoints: Point[];
+    titles: GeoJSON_2.Feature<GeoJSON_2.LineString | null>[];
+    residentEvent: LineResidentEvent;
+    updateEvent: LineUpdateEvent;
+    createEvent: LineCreateEvent;
+    constructor(map: Map_2, options: T);
+    get id(): string;
+    get center(): LngLat | null;
+    get geometry(): GeoJSON_2.LineString | null;
+    onAdd(): void;
+    onRemove(): void;
+    getFeature(): GeoJSON_2.Feature<GeoJSON_2.LineString | null>;
+    start(): void;
+    stop(): void;
+    show(): void;
+    hide(): void;
+    edit(): void;
+    unedit(): void;
+    focus(): void;
+    unfocus(): void;
+    select(): void;
+    unselect(): void;
+    move(position: LngLat): void;
+    update(options: T): void;
+    remove(): void;
+    render(): void;
+    getMidPoint(index: number): Point | null;
+    getPoint(index: number): PointInstance | null;
+    createVertex(id: string, index: number, position: LngLat): PointInstance;
+    createMid(id: string, index: number, position: LngLat): Point;
+    createTitles(): Feature<LineString>[];
+    removeTitles(): GeoJSON_2.Feature<null>[];
+    createPoint(): void;
+    /**
+     * 插入一个新节点 (例如: 将中点转为实点时调用)
+     * @param index 要插入的位置索引
+     * @param position 新节点的坐标
+     */
+    insertPoint(index: number, position: LngLat): PointInstance;
+    /**
+     * 更新某个实点的位置 (例如: 拖拽某个节点)
+     * @param index 节点索引
+     * @param position 拖拽后的新坐标
+     * @param isRender 是否立即渲染
+     */
+    updatePoint(index: number, position: LngLat, isRender?: boolean): void;
+    /** 更新指定中点的坐标 (例如：拖拽中点时触发，但在松手前它还是个中点) */
+    updateMidPoint(index: number, position: LngLat): void;
+    removePointAt(index: number): void;
+    /** 清空所有点 (替代原有的 removePoint) */
+    clearAll(): void;
+    removePoint(): void;
+    /**
+     * 内部机制：全量重新生成所有的中点
+     */
+    protected syncMidPoints(): void;
+    /**
+     * 内部机制：修补数组增减后的索引及属性ID
+     */
+    protected reindexPoints(): void;
+    /**
+     * 内部机制：只更新指定节点相邻的两个中点 (用于优化拖拽时的渲染性能)
+     */
+    protected updateAdjacentMidPoints(index: number): void;
+    /**
+     * 内部计算：获取两点之间的中点坐标
+     */
+    protected calcMidPosition(p1: LngLat, p2: LngLat): LngLat;
+    /** 内部：当数组发生增删时，修复 properties 中的 index 和 id */
+    private _reindexPoints;
+    /** 内部：重新计算并全量同步所有中点 */
+    private _syncMidPoints;
+}
+
+declare const LINE_LAYER: LayerSpecification;
+
+declare const LINE_LAYER_NAME = "mapbox-gl-plot-line-layer";
+
+declare const LINE_TEXT_LAYER: LayerSpecification;
+
+declare const LINE_TEXT_LAYER_NAME = "mapbox-gl-plot-line-text-layer";
 
-declare const LAYER_LIST_2: LayerSpecification[];
+declare abstract class LineBaseEvent extends EventState {
+    protected line: Line;
+    protected constructor(map: Map_2, line: Line);
+    abstract onAdd(): void;
+    abstract onRemove(): void;
+    abstract enabled(): void;
+    abstract disabled(): void;
+}
+
+declare class LineCreateEvent extends LineBaseEvent {
+    private count;
+    private drawPoint;
+    private onClick;
+    private onMousemove;
+    private stop;
+    constructor(map: Map_2, line: Line);
+    onAdd(): void;
+    onRemove(): void;
+    setDrawLngLat(position: LngLat | null): void;
+    getDrawLngLat(): LngLat | null;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare class LineResidentEvent extends LineBaseEvent {
+    private onLineMouseenter;
+    private onLineMouseLeave;
+    private onClick;
+    private onLineClick;
+    constructor(map: Map_2, line: Line);
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare type LineStringPosition = PointPosition[];
+
+declare interface LineStyle {
+    'line-color'?: DataDrivenPropertyValueSpecification<ColorSpecification>;
+    'line-width'?: DataDrivenPropertyValueSpecification<number>;
+    'text-size'?: DataDrivenPropertyValueSpecification<number>;
+}
+
+declare class LineUpdateEvent extends LineBaseEvent {
+    protected dragStartLngLat: LngLat | null;
+    protected modifyMid: Point | null;
+    private onVertexUpdate;
+    private onMidBeforeUpdate;
+    private onMidUpdate;
+    private onMidDone;
+    private onLineMousedown;
+    private onLineMouseenter;
+    private onLineMouseLeave;
+    private onMousemove;
+    private onMouseup;
+    constructor(map: Map_2, line: Line);
+    onAdd(): void;
+    onRemove(): void;
+    setModifyLngLat(point: Point | null): void;
+    getModifyLngLat(): Point | null;
+    setDragLngLat(position: LngLat | null): void;
+    getDragLngLat(): LngLat | null;
+    enabled(): void;
+    disabled(): void;
+}
+
+export declare namespace LineVars {
+    export {
+        NAME_4 as NAME,
+        Z_INDEX_2 as Z_INDEX,
+        TEXT_Z_INDEX,
+        LINE_LAYER_NAME,
+        DOTTED_LINE_LAYER_NAME,
+        LINE_TEXT_LAYER_NAME,
+        DEFAULT_LINE_COLOR,
+        DEFAULT_LINE_WIDTH,
+        DEFAULT_TEXT_COLOR_2 as DEFAULT_TEXT_COLOR,
+        DEFAULT_TEXT_SIZE_2 as DEFAULT_TEXT_SIZE,
+        DOTTED_LINE_LAYER,
+        LINE_LAYER,
+        LINE_TEXT_LAYER,
+        LAYER_LIST_4 as LAYER_LIST
+    }
+}
 
 declare enum MapType {
     LAND = "land",
-    SATELLITE = "satellite",
-    CUSTOM = "custom"
+    SATELLITE = "satellite"
 }
 
 declare const MAX_ICON_SIZE = 0.5;
 
 declare const MIN_ICON_SIZE = 0.2;
 
-export declare abstract class Module {
+export declare abstract class Module extends default_3 {
     protected context: Context;
     /**
      * 构造函数，初始化地图上下文和选项配置
      * @param map - 地图实例对象
      */
     protected constructor(map: Map_2);
-    emit(): void;
     mount(): void;
     destroy(): void;
     abstract onAdd(): void;
     abstract onRemove(): void;
 }
 
-declare const NAME = "Ais";
+declare const NAME = PlotType.Fill;
+
+declare const NAME_2 = PlotType.ICON_POINT;
+
+declare const NAME_3 = PlotType.INDEX_POINT;
+
+declare const NAME_4 = PlotType.LINE;
+
+declare const NAME_5 = PlotType.POINT;
+
+declare const NAME_6 = "Ais";
 
-declare const NAME_2 = "Track";
+declare const NAME_7 = "Track";
 
 declare const NORMAL_ICON = "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"74\" height=\"74\" viewBox=\"0 0 74 74\" fill=\"none\"><circle cx=\"37\" cy=\"37\" r=\"32\" stroke=\"rgba(172, 51, 193, 1)\" stroke-width=\"10\"      fill=\"#FFFFFF\" ></circle></svg>";
 
@@ -424,6 +984,201 @@ declare const NORMAL_ICON_NAME = "track-normal";
 
 declare type Orientation = 'static' | 'left' | 'right' | 'straight';
 
+declare enum PlotType {
+    POINT = "Point",
+    INDEX_POINT = "IndexPoint",
+    ICON_POINT = "IconPoint",
+    LINE = "LineString",
+    Fill = "Polygon",
+    CIRCLE = "Circle"
+}
+
+declare type PlotVisibility = 'visible' | 'none';
+
+declare abstract class Poi<T extends IPoiOptions = IPoiOptions, G extends GeoJSON_2.Geometry | null = GeoJSON_2.Geometry> extends Module {
+    options: T;
+    readonly SOURCE: string;
+    readonly LAYER: string;
+    protected constructor(map: Map_2, options: T);
+    abstract onAdd(): void;
+    abstract onRemove(): void;
+    abstract get id(): T['id'];
+    get isEdit(): boolean;
+    get isFocus(): boolean;
+    get isCreate(): boolean;
+    get visibility(): PlotVisibility;
+    abstract get center(): LngLat | null;
+    abstract get geometry(): G | null;
+    abstract getFeature(): GeoJSON_2.Feature<G>;
+    abstract start(): void;
+    abstract stop(): void;
+    abstract edit(): void;
+    abstract unedit(): void;
+    abstract focus(): void;
+    abstract unfocus(): void;
+    abstract select(): void;
+    abstract unselect(): void;
+    abstract move(position: LngLat): void;
+    abstract update(options: T): void;
+    abstract remove(): void;
+    abstract render(): void;
+    show(): void;
+    hide(): void;
+    setState(states: Record<string, unknown>): void;
+    getState(): Record<string, unknown> | null | undefined;
+}
+
+export declare class Point<T extends IPointOptions = IPointOptions> extends Poi<T, GeoJSON_2.Point | null> {
+    static NAME: PlotType;
+    readonly LAYER: string;
+    residentEvent: PointResidentEvent;
+    updateEvent: PointUpdateEvent;
+    createEvent: PointCreateEvent;
+    constructor(map: Map_2, options: T);
+    onAdd(): void;
+    onRemove(): void;
+    get id(): string;
+    edit(): void;
+    unedit(): void;
+    focus(): void;
+    unfocus(): void;
+    select(): void;
+    unselect(): void;
+    get center(): LngLat | null;
+    get geometry(): GeoJSON_2.Point | null;
+    getFeature(): GeoJSON_2.Feature<GeoJSON_2.Point | null>;
+    start(): void;
+    stop(): void;
+    move(position: T['position']): void;
+    update(options: T): void;
+    remove(): void;
+    render(): void;
+    /**
+     * 计算文字相对于图标的偏移量
+     * 返回单位为 em (Mapbox text-offset 标准单位)
+     */
+    protected calculateTextOffset(params: CalcOffsetParams): [number, number];
+}
+
+declare const POINT_CIRCLE_LAYER: LayerSpecification;
+
+declare const POINT_CIRCLE_LAYER_NAME = "mapbox-gl-plot-point-circle-layer";
+
+declare const POINT_ICON_LAYER: LayerSpecification;
+
+declare const POINT_ICON_LAYER_NAME = "mapbox-gl-plot-point-icon-layer";
+
+declare const POINT_INDEX_LAYER: LayerSpecification;
+
+declare const POINT_INDEX_LAYER_NAME = "mapbox-gl-plot-point-index-layer";
+
+declare const POINT_TEXT_LAYER: LayerSpecification;
+
+declare const POINT_TEXT_LAYER_NAME = "mapbox-gl-plot-point-text-layer";
+
+declare abstract class PointBaseEvent<T extends Point = Point> extends EventState {
+    protected point: T;
+    protected constructor(map: Map_2, point: T);
+    abstract onAdd(): void;
+    abstract onRemove(): void;
+    abstract enabled(): void;
+    abstract disabled(): void;
+}
+
+declare class PointCreateEvent<T extends Point = Point> extends PointBaseEvent<T> {
+    private onClick;
+    private onMousemove;
+    constructor(map: Map_2, point: T);
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare interface PointInstance<T extends IPointOptions = IPointOptions> {
+    options: T;
+    readonly SOURCE: string;
+    LAYER: string;
+    residentEvent: PointResidentEvent;
+    updateEvent: PointUpdateEvent;
+    createEvent: PointCreateEvent;
+    readonly id: string;
+    readonly isEdit: boolean;
+    readonly isCreate: boolean;
+    readonly visibility: PlotVisibility;
+    readonly center: LngLat | null;
+    readonly geometry: GeoJSON_2.Point | null;
+    onAdd(): void;
+    onRemove(): void;
+    getFeature(): GeoJSON_2.Feature<GeoJSON_2.Point | null>;
+    start(): void;
+    stop(): void;
+    edit(): void;
+    unedit(): void;
+    focus(): void;
+    unfocus(): void;
+    select(): void;
+    unselect(): void;
+    move(position: T['position']): void;
+    update(options: T): void;
+    remove(): void;
+    render(): void;
+    show(): void;
+    hide(): void;
+    setState(states: Record<string, unknown>): void;
+    getState(): Record<string, unknown> | null | undefined;
+    on<T extends default_3.EventNames<string>>(event: T, fn: default_3.EventListener<string, T>, context?: any): this;
+    off<T extends default_3.EventNames<string>>(event: T, fn?: default_3.EventListener<string, T>, context?: any, once?: boolean): this;
+}
+
+declare type PointPosition = LngLat;
+
+declare class PointResidentEvent<T extends Point = Point> extends PointBaseEvent<T> {
+    private onMouseEnter;
+    private onMouseLeave;
+    private onClick;
+    private onDblclick;
+    constructor(map: Map_2, point: T);
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+declare type PointStyle = CirclePointStyle | IndexPointStyle | IconPointStyle;
+
+declare class PointUpdateEvent<T extends Point = Point> extends PointBaseEvent<T> {
+    private onMousedown;
+    private onMousemove;
+    private onMouseup;
+    constructor(map: Map_2, point: T);
+    onAdd(): void;
+    onRemove(): void;
+    enabled(): void;
+    disabled(): void;
+}
+
+export declare namespace PointVars {
+    export {
+        NAME_5 as NAME,
+        Z_INDEX_3 as Z_INDEX,
+        TEXT_Z_INDEX_2 as TEXT_Z_INDEX,
+        POINT_CIRCLE_LAYER_NAME,
+        POINT_TEXT_LAYER_NAME,
+        DEFAULT_TEXT_SIZE_3 as DEFAULT_TEXT_SIZE,
+        GAP_PX_2 as GAP_PX,
+        DEFAULT_CIRCLE_RADIUS,
+        DEFAULT_CIRCLE_COLOR,
+        DEFAULT_CIRCLE_STROKE_WIDTH,
+        DEFAULT_CIRCLE_STROKE_COLOR,
+        POINT_CIRCLE_LAYER,
+        POINT_TEXT_LAYER,
+        LAYER_LIST_5 as LAYER_LIST
+    }
+}
+
+declare type PolygonPosition = PointPosition[];
+
 declare class ResidentEvent extends EventState {
     private ships;
     protected hoverId: IAisShipOptions['id'] | null | undefined;
@@ -432,8 +1187,8 @@ declare class ResidentEvent extends EventState {
     protected _leave: OmitThisParameter<(e: MapMouseEvent) => void>;
     protected _zoomEnd: () => void;
     constructor(map: Map_2, ships?: AisShip[]);
-    on(): void;
-    off(): void;
+    enabled(): void;
+    disabled(): void;
     onAdd(): void;
     onRemove(): void;
     add(ship: AisShip): void;
@@ -451,9 +1206,18 @@ declare class ResidentEvent extends EventState {
 declare class ResourceRegister {
     private map;
     private sourceData;
+    /** Feature 索引，key 为 `${sourceId}:${featureId}` */
+    private featureIndex;
     private dirtySourceIds;
     private renderFrameId;
+    private layerList;
+    private destroyed;
+    /** 记录由此类创建的 source id */
+    private managedSourceIds;
+    /** 记录由此类创建的 layer id */
+    private managedLayerIds;
     constructor(map: Map_2);
+    private checkDestroyed;
     /**
      * 幂等地添加 Source
      */
@@ -461,7 +1225,15 @@ declare class ResourceRegister {
     /**
      * 幂等地添加 Layer
      */
-    addLayer(layer: LayerSpecification, beforeId?: string): void;
+    addLayer(sortLayer: SortLayer): void;
+    /**
+     * 移除 Layer
+     */
+    removeLayer(layerId: string): void;
+    /**
+     * 移除 Source（会先移除关联的 Layer）
+     */
+    removeSource(sourceId: string): void;
     findFeature(source: string, featureId: string): GeoJSON_2.Feature | undefined;
     /**
      * 获取 Source
@@ -484,8 +1256,9 @@ declare class ResourceRegister {
     getState(source: string, id: string): Record<string, unknown> | null | undefined;
     /**
      * 销毁清理
+     * @param removeFromMap 是否从地图上移除由此类管理的 Source 和 Layer，默认 false
      */
-    destroy(): void;
+    destroy(removeFromMap?: boolean): void;
 }
 
 declare interface result {
@@ -513,16 +1286,16 @@ declare enum Scopes {
  * 方向点 拐点 船首 船首右舷 船尾右舷 右船尾 左船尾 船尾左舷 船首左舷
  */
 declare interface Shape {
-    leftDirection: Point;
-    rightDirection: Point;
-    turn: Point;
-    head: Point;
-    rightBow: Point;
-    rightQuarter: Point;
-    rightStern: Point;
-    leftStern: Point;
-    leftQuarter: Point;
-    leftBow: Point;
+    leftDirection: Point_2;
+    rightDirection: Point_2;
+    turn: Point_2;
+    head: Point_2;
+    rightBow: Point_2;
+    rightQuarter: Point_2;
+    rightStern: Point_2;
+    leftStern: Point_2;
+    leftQuarter: Point_2;
+    leftBow: Point_2;
 }
 
 export declare class Ship extends Module {
@@ -545,6 +1318,8 @@ export declare class Ship extends Module {
     removeAll(): void;
     render(): void;
     get(id: string | number): BaseShip<any> | undefined;
+    focus(id: IBaseShipOptions['id']): void;
+    unfocus(id: IBaseShipOptions['id']): void;
     select(id: IBaseShipOptions['id']): void;
     unselect(id: IBaseShipOptions['id']): void;
 }
@@ -557,6 +1332,10 @@ declare enum SHIP_COLOR {
 
 declare const SHIP_ICON: SvgIcon[];
 
+declare const SHIP_ICON_DIRECTION_LAYER: LayerSpecification;
+
+declare const SHIP_ICON_DIRECTION_LAYER_NAME = "mapbox-gl-ship-icon-direction-layer";
+
 declare const SHIP_ICON_LAYER: LayerSpecification;
 
 declare const SHIP_ICON_LAYER_NAME = "mapbox-gl-ship-icon-layer";
@@ -573,19 +1352,22 @@ declare const SHIP_SOURCE_NAME = "mapbox-gl-ship-source";
 
 export declare namespace ShipVars {
     export {
-        NAME,
+        NAME_6 as NAME,
+        Z_INDEX_4 as Z_INDEX,
         SHIP_SOURCE_NAME,
         SHIP_ICON_LAYER_NAME,
+        SHIP_ICON_DIRECTION_LAYER_NAME,
         SHIP_REAL_LAYER_NAME,
         SHIP_REAL_OUTLINE_LAYER_NAME,
         MIN_ICON_SIZE,
         MAX_ICON_SIZE,
         UPDATE_STATUS,
         SHIP_COLOR,
+        SHIP_ICON_DIRECTION_LAYER,
         SHIP_ICON_LAYER,
         SHIP_REAL_LAYER,
         SHIP_REAL_OUTLINE_LAYER,
-        LAYER_LIST,
+        LAYER_LIST_6 as LAYER_LIST,
         SHIP_ICON
     }
 }
@@ -597,6 +1379,11 @@ declare interface SimpleAnchor {
     'bottom-right': BBox;
 }
 
+declare interface SortLayer {
+    zIndex: number;
+    layer: LayerSpecification;
+}
+
 declare const START_ICON = "<svg xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\" width=\"74\" height=\"74\" viewBox=\"0 0 74 74\" fill=\"none\"><circle cx=\"37\" cy=\"37\" r=\"32\" stroke=\"rgba(172, 51, 193, 1)\" stroke-width=\"10\"      fill=\"#AC33C1\" ></circle><path d=\"M36.4 50.84C40.84 51.08 45.24 51.08 45.24 51.08C50.52 51.08 55.12 50.8 55.12 50.8L54.48 54.36C50.16 54.64 45.24 54.64 45.24 54.64C40.32 54.64 35.96 54.36 35.96 54.36C31.16 54.08 28.16 52.72 28.16 52.72C25.16 51.36 23.4 48.36 23.4 48.36C22.64 51.96 20.84 55.72 20.84 55.72L18 53.52C19.16 51.04 19.76 48.94 19.76 48.94C20.36 46.84 20.62 44.26 20.62 44.26C20.88 41.68 20.88 37.64 20.88 37.64L24.2 37.64C24.2 40.92 24.04 43.12 24.04 43.12C25.16 46.52 27.28 48.24 27.28 48.24L27.28 35.44L18.68 35.44L18.68 32.08L26.32 32.08L26.32 27.12L20.08 27.12L20.08 23.72L26.32 23.72L26.32 19L29.84 19L29.84 23.72L35.64 23.72L35.64 27.12L29.84 27.12L29.84 32.08L36.76 32.08L36.76 35.44L30.72 35.44L30.72 40.96L36.36 40.96L36.36 44.32L30.72 44.32L30.72 49.96C33 50.64 36.4 50.84 36.4 50.84ZM48.96 30.88L48.96 24.64L37.8 24.64L37.8 21.12L52.44 21.12L52.44 34.4L41.84 34.4L41.84 41.52C41.84 42.72 42.02 43.24 42.02 43.24C42.2 43.76 42.68 43.98 42.68 43.98C43.16 44.2 44.28 44.32 44.28 44.32C44.88 44.36 46 44.36 46 44.36C47.12 44.36 47.72 44.32 47.72 44.32C48.88 44.2 49.44 43.98 49.44 43.98C50 43.76 50.22 43.28 50.22 43.28C50.44 42.8 50.52 41.8 50.52 41.8C50.68 39.72 50.68 38.44 50.68 38.44L54.08 39.24C53.96 41.12 53.8 43 53.8 43C53.6 45.04 53.16 45.98 53.16 45.98C52.72 46.92 51.72 47.3 51.72 47.3C50.72 47.68 48.64 47.8 48.64 47.8C46.8 47.88 45.88 47.88 45.88 47.88C44.96 47.88 43.12 47.8 43.12 47.8C41.2 47.68 40.22 47.2 40.22 47.2C39.24 46.72 38.8 45.64 38.8 45.64C38.36 44.56 38.36 42.44 38.36 42.44L38.36 30.88L48.96 30.88Z\"   fill=\"#FFFFFF\" ></path></svg>";
 
 declare const START_ICON_NAME = "track-start";
@@ -615,6 +1402,10 @@ declare interface SvgIcon {
     svg: string;
 }
 
+declare const TEXT_Z_INDEX: number;
+
+declare const TEXT_Z_INDEX_2: number;
+
 export declare class Tooltip extends Module {
     static DEBUG: boolean;
     options: ITooltipOptions;
@@ -629,6 +1420,7 @@ export declare class Tooltip extends Module {
     private debug;
     hide(): void;
     show(): void;
+    update(options: ITooltipOptions): void;
     setAnchor(anchor: ITooltipOptions['anchor']): void;
     getSimpleBbox(): SimpleAnchor;
     getAllBbox(): AllAnchor;
@@ -636,7 +1428,7 @@ export declare class Tooltip extends Module {
     private getOffDOMSize;
     remove(): void;
     _create(): void;
-    _getOffsetByAnchor(): Point;
+    _getOffsetByAnchor(): Point_2;
     setLngLat(lngLat: LngLat): this;
     connectLine(): void;
     connectPoint(): LngLat | null;
@@ -705,7 +1497,8 @@ declare interface TrackItemWithLabel extends TrackItem {
 
 export declare namespace TrackVars {
     export {
-        NAME_2 as NAME,
+        NAME_7 as NAME,
+        Z_INDEX_5 as Z_INDEX,
         TRACK_SOURCE_NAME,
         TRACK_ARROW_LAYER_NAME,
         TRACK_ICON_LAYER_NAME,
@@ -721,7 +1514,7 @@ export declare namespace TrackVars {
         TRACK_ARROW_LAYER,
         TRACK_ICON_LAYER,
         TRACK_LINE_LAYER,
-        LAYER_LIST_2 as LAYER_LIST
+        LAYER_LIST_7 as LAYER_LIST
     }
 }
 
@@ -731,4 +1524,14 @@ declare enum UPDATE_STATUS {
     OFFLINE = "Offline"
 }
 
+declare const Z_INDEX = 3;
+
+declare const Z_INDEX_2 = 5;
+
+declare const Z_INDEX_3 = 10;
+
+declare const Z_INDEX_4 = 300;
+
+declare const Z_INDEX_5 = 290;
+
 export { }