@xingm/vmap-cesium-toolbar 0.0.2-alpha.1 → 0.0.2-alpha.11

package/dist/libs/CesiumHeatmapLayer.d.ts

@@ -0,0 +1,109 @@
+import * as Cesium from "cesium";
+export interface HeatPoint {
+    /** 经度（度） */
+    lon: number;
+    /** 纬度（度） */
+    lat: number;
+    /** 强度值，用于控制热度（0~maxValue） */
+    value: number;
+}
+export interface HeatmapGradient {
+    /**
+     * 0~1 的比例到颜色字符串的映射，例如：
+     * { 0.0: "#0000ff", 0.5: "#ffff00", 1.0: "#ff0000" }
+     */
+    [stop: number]: string;
+}
+export interface HeatmapOptions {
+    /** Canvas 分辨率，越大越清晰但开销越大 */
+    width?: number;
+    height?: number;
+    /** 单个点的影响半径（像素） */
+    radius?: number;
+    /** 最小/最大值，用于归一化 value，如果不传则自动根据数据计算 */
+    minValue?: number;
+    maxValue?: number;
+    /** 全局不透明度 0~1 */
+    opacity?: number;
+    /** 颜色梯度 */
+    gradient?: HeatmapGradient;
+}
+export interface HeatmapAutoUpdateOptions {
+    /** 是否启用随视角变化自动重绘（默认 true） */
+    enabled?: boolean;
+    /** 视域范围 padding（比例，默认 0.15） */
+    viewPaddingRatio?: number;
+    /** 聚合网格边长（米）。不传则根据相机高度自动估算 */
+    cellSizeMeters?: number;
+    /** 根据相机高度（米）动态返回网格边长（米）。优先级高于 cellSizeMeters */
+    cellSizeMetersByHeight?: (cameraHeightMeters: number) => number;
+}
+/**
+ * Cesium 热力图图层封装
+ * - 使用离屏 Canvas 绘制热力图
+ * - 通过 SingleTileImageryProvider 叠加到地球上
+ */
+export default class CesiumHeatmapLayer {
+    private viewer;
+    private imageryLayer;
+    private rectangle;
+    private canvas;
+    private ctx;
+    private options;
+    private data;
+    private gradientLUT;
+    private autoUpdateEnabled;
+    private autoUpdateOptions;
+    private removeMoveEndListener;
+    private aggregateWorker;
+    private workerReady;
+    private pendingUpdate;
+    private lastUpdateKey;
+    constructor(viewer: Cesium.Viewer, options?: HeatmapOptions);
+    /**
+     * 设置/替换热力图数据（度为单位）
+     */
+    setData(points: HeatPoint[]): void;
+    /**
+     * 更新调色板
+     */
+    setGradient(gradient: HeatmapGradient): void;
+    /**
+     * 设置透明度
+     */
+    setOpacity(opacity: number): void;
+    /**
+     * 显隐控制
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 销毁并移除图层
+     */
+    destroy(): void;
+    /**
+     * 启用/关闭基于视域与缩放的自动聚合重绘（方格聚合 + moveEnd + WebWorker）。
+     * - 启用后：热力图仅渲染当前视域范围内的聚合结果，缩放/平移后自动更新。
+     * - 关闭后：回退为 setData() 时按全量范围绘制一张 SingleTile。
+     */
+    setAutoUpdate(options?: HeatmapAutoUpdateOptions): void;
+    stopAutoUpdate(): void;
+    private clearLayer;
+    private startAutoUpdateInternal;
+    private requestAutoUpdate;
+    private getPaddedViewRectangleDegrees;
+    private ensureWorker;
+    private pushDataToWorker;
+    /**
+     * 构建颜色查找表（0-255 -> RGBA）
+     */
+    private buildGradientLUT;
+    /**
+     * 在离屏 canvas 上绘制热力图，并更新到 Cesium 图层
+     */
+    private renderHeatmap;
+    /**
+     * 将当前 canvas 映射为 Cesium 影像图层
+     */
+    private updateImageryLayer;
+}
+export { CesiumHeatmapLayer };

package/dist/libs/CesiumMapDraw.d.ts

@@ -9,7 +9,6 @@ declare class DrawHelper {
     private viewer;
     private scene;
     private entities;
-    private frustumPrimitives;
     private drawMode;
     private isDrawing;
     private tempPositions;
@@ -20,6 +19,8 @@ declare class DrawHelper {
     private finishedPointEntities;
     private publicEntities;
     private _doubleClickPending;
+    private lastPreviewPosition;
+    private static activeDrawingHelper;
     private drawLine;
     private drawPolygon;
     private drawRectangle;
@@ -86,11 +87,6 @@ declare class DrawHelper {
      * 删除最后一个添加的点及其相关的临时实体
      */
     private removeLastPoint;
-    /**
-     * 重新创建剩余的点实体和绘制实体
-     * 用于右键删除点后的重建
-     */
-    private recreateRemainingEntities;
     /**
      * 更新预览线/面
      * @param currentMousePosition 当前鼠标位置世界坐标
@@ -114,6 +110,12 @@ declare class DrawHelper {
      * 公共方法：结束当前绘制（如果正在进行）
      */
     endDrawing(): void;
+    /**
+     * 公共方法：取消当前正在进行的绘制（不触发完成回调，不生成实体）
+     * 主要用于在外部开启新的绘制前，保证旧的未完成绘制被安全终止，
+     * 避免同时存在多个绘制事件处理器。
+     */
+    cancelDrawing(): void;
     /**
      * 销毁事件处理器
      */
@@ -142,15 +144,6 @@ declare class DrawHelper {
      * @returns 实体数组
      */
     getFinishedEntities(): Cesium.Entity[];
-    /**
-     * 使用 Canvas 绘制总长文本，生成用于 billboard 的图片
-     */
-    private createTotalLengthBillboardImage;
-    /**
-     * 使用 Canvas 绘制分段长度文本，生成用于 billboard 的图片
-     * 样式与总长保持一致，便于统一视觉
-     */
-    private createSegmentLengthBillboardImage;
     onMeasureComplete(callback: (result: {
         type: "line" | "polygon" | "rectangle" | "circle";
         positions: Cesium.Cartesian3[];

package/dist/libs/CesiumMapLoader.d.ts

@@ -40,6 +40,7 @@ interface InitOptions {
     terrainExaggeration?: number;
     maximumScreenSpaceError?: number;
     maximumNumberOfLoadedTiles?: number;
+    requestRenderMode?: boolean;
     token?: string;
     cesiumToken?: string;
     success?: () => void;
@@ -53,6 +54,8 @@ interface MapCenter {
     pitch?: number;
     heading?: number;
 }
+export declare const setCameraView: (viewer: CesiumViewer, center: MapCenter) => void;
+export declare const setCameraFlyTo: (viewer: CesiumViewer, center: MapCenter, options: InitOptions) => void;
 export declare function initCesium(containerId: string, options: InitOptions, mapCenterOrCesiumToken?: MapCenter | string, cesiumToken?: string): Promise<{
     viewer: CesiumViewer;
     initialCenter: MapCenter;

package/dist/libs/CesiumOverlayService.d.ts

@@ -8,6 +8,7 @@ import { MapPolyline, PolylineOptions } from './overlay/MapPolyline';
 import { MapPolygon, PolygonOptions } from './overlay/MapPolygon';
 import { MapRectangle, RectangleOptions } from './overlay/MapRectangle';
 import { MapCircle, CircleOptions } from './overlay/MapCircle';
+import { MapRing, RingOptions } from './overlay/MapRing';
 import { OverlayPosition } from './overlay/types';
 /**
  * Cesium 覆盖物服务类
@@ -27,6 +28,7 @@ export declare class CesiumOverlayService {
     readonly polygon: MapPolygon;
     readonly rectangle: MapRectangle;
     readonly circle: MapCircle;
+    readonly ring: MapRing;
     constructor(viewer: Viewer);
     /**
      * 初始化信息窗口容器
@@ -76,6 +78,10 @@ export declare class CesiumOverlayService {
      * 添加 Circle
      */
     addCircle(options: CircleOptions): Entity;
+    /**
+     * 添加 Ring
+     */
+    addRing(options: RingOptions): Entity;
     /**
      * 根据ID获取覆盖物
      */

package/dist/libs/drawHelper/BaseDraw.d.ts

@@ -15,10 +15,31 @@ export interface DrawResult {
  */
 export interface DrawCallbacks {
     onDrawStart?: () => void;
-    onDrawEnd?: (entity: Entity | null) => void;
+    onDrawEnd?: (entity: Entity | null, result: DrawResult) => void;
     onEntityRemoved?: (entity: Entity) => void;
     onMeasureComplete?: (result: DrawResult) => void;
 }
+/**
+ * 扩展后的绘制实体类型
+ * 用于在 Entity 上挂载绘图相关的元数据
+ */
+export type DrawEntity = Entity & {
+    _drawType?: "line" | "polygon" | "rectangle" | "circle";
+    _drawOptions?: DrawOptions;
+    _groundPositions?: Cartesian3[];
+    _groundPosition?: Cartesian3;
+    _groundRectangle?: Cesium.Rectangle;
+    _radius?: number;
+    _borderEntity?: Entity;
+    _onClick?: (entity: Entity, ...args: any[]) => void;
+    _isSelected?: boolean;
+    _originalStyle?: {
+        material?: any;
+        width?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+    };
+};
 /**
  * 绘制时可选的样式和事件回调
  */
@@ -58,16 +79,44 @@ export declare abstract class BaseDraw {
     protected finishedPointEntities: Cesium.Entity[];
     /** 当前绘制的选项（如果有） */
     protected drawOptions?: DrawOptions;
+    /**
+     * 公开只读访问当前临时数据，供调度器使用
+     */
+    getTempPositions(): Cartesian3[];
+    getTempEntities(): Entity[];
+    getTempLabelEntities(): Entity[];
+    getFinishedPointEntities(): Entity[];
+    /**
+     * 允许调度器安全地重建临时数据
+     */
+    setTempPositions(positions: Cartesian3[]): void;
+    setTempEntities(entities: Entity[]): void;
+    setTempLabelEntities(entities: Entity[]): void;
+    /**
+     * 供调度器调用的公开包装方法
+     */
+    addPointForHelper(position: Cartesian3): void;
+    clearTempEntitiesForHelper(): void;
+    /**
+     * 清除当前绘制过程中的临时点实体
+     * 仅删除带有 point 组件的临时实体，保留其它临时线/面实体
+     */
+    clearTempPointEntitiesForHelper(): void;
+    /**
+     * 删除最后一个点并根据剩余点重建预览实体
+     * 供调度器在右键删除点时调用，具体重建逻辑仍由各子类的 updateDrawingEntity 实现
+     */
+    removeLastPointAndRedraw(): void;
     /**
      * 将任意颜色输入解析为 Cesium.Color
      */
     protected resolveColor(input?: Cesium.Color | string): Cesium.Color;
     /**
-     * 应用选中样式（可切换）
+     * 应用/切换选中样式（统一逻辑，供调度器和子类共用）
      */
     protected applySelectedStyleToEntity(entity: Entity): void;
     /**
-     * 恢复原始样式
+     * 恢复原始样式（兼容旧接口，内部仍走统一逻辑）
      */
     protected restoreOriginalStyleForEntity(entity: Entity): void;
     abstract updateDrawingEntity(previewPoint?: Cesium.Cartesian3): void;
@@ -114,3 +163,8 @@ export declare abstract class BaseDraw {
      */
     protected clearTempEntities(): void;
 }
+/**
+ * 静态工具方法：切换实体的选中样式
+ * 用于避免在多个模块中重复实现相同逻辑
+ */
+export declare function toggleSelectedStyle(entity: DrawEntity): void;

package/dist/libs/drawHelper/DrawCircle.d.ts

@@ -5,6 +5,7 @@ import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
  */
 export declare class DrawCircle extends BaseDraw {
     private currentCircleEntity;
+    private currentBorderEntity;
     private centerPosition;
     /**
      * 开始绘制
@@ -22,4 +23,8 @@ export declare class DrawCircle extends BaseDraw {
      * 获取绘制类型
      */
     getDrawType(): "line" | "polygon" | "rectangle" | "circle";
+    /**
+     * 生成近似圆（多边形）顶点
+     */
+    private generateCirclePositions;
 }

package/dist/libs/drawHelper/DrawPolgon.d.ts

@@ -5,6 +5,7 @@ import { BaseDraw, DrawResult, DrawOptions } from './BaseDraw';
  */
 export declare class DrawPolygon extends BaseDraw {
     private currentPolygonEntity;
+    private currentBorderEntity;
     /**
      * 开始绘制
      */
@@ -17,6 +18,10 @@ export declare class DrawPolygon extends BaseDraw {
      * 完成绘制
      */
     finishDrawing(): DrawResult | null;
+    /**
+     * 清理所有绘制相关的实体
+     */
+    clear(): void;
     /**
      * 获取绘制类型
      */

package/dist/libs/drawHelper/index.d.ts

@@ -1,4 +1,4 @@
-export { BaseDraw, type DrawResult, type DrawCallbacks, type DrawOptions } from './BaseDraw';
+export { BaseDraw, type DrawResult, type DrawCallbacks, type DrawOptions, type DrawEntity, toggleSelectedStyle } from './BaseDraw';
 export { DrawLine } from './DrawLine';
 export { DrawPolygon } from './DrawPolgon';
 export { DrawRectangle } from './DrawRectangle';

package/dist/libs/overlay/MapCircle.d.ts

@@ -13,6 +13,7 @@ export interface CircleOptions {
     outlineWidth?: number;
     heightReference?: HeightReference;
     extrudedHeight?: number;
+    heightEpsilon?: number;
     onClick?: (entity: Entity) => void;
     id?: string;
 }
@@ -39,6 +40,11 @@ export declare class MapCircle {
      * 添加 Circle（圆形）
      */
     add(options: CircleOptions): Entity;
+    /**
+     * 生成近似圆（多边形）顶点，返回 Cartesian3 数组。
+     * 使用大圆航线公式，segments 越大越平滑。
+     */
+    private generateCirclePositions;
     /**
      * 更新 Circle 位置
      */
@@ -51,4 +57,8 @@ export declare class MapCircle {
      * 更新 Circle 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<CircleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+    /**
+     * 移除 Circle（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapIcon.d.ts

@@ -52,4 +52,8 @@ export declare class MapIcon {
      * 更新 Icon 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<IconOptions, 'scale' | 'rotation' | 'color'>>): void;
+    /**
+     * 移除 Icon（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapInfoWindow.d.ts

@@ -15,7 +15,16 @@ export interface InfoWindowOptions {
     backgroundColor?: string;
     color?: string;
     font?: string;
+    className?: string;
+    style?: Partial<CSSStyleDeclaration>;
+    showArrow?: boolean;
+    arrowSize?: number;
+    positionOffset?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom';
     hideWhenOutOfView?: boolean;
+    anchorHeight?: number;
+    anchorPixel?: number;
+    tailGap?: number;
+    updateInterval?: number;
 }
 /**
  * 面向 Cesium 的 HTML 信息窗口管理器
@@ -26,7 +35,25 @@ export declare class MapInfoWindow {
     private container;
     private entityMap;
     private currentTopZIndex;
+    private defaultUpdateInterval;
+    private isCameraMoving;
+    private cameraMoveStartListener?;
+    private cameraMoveEndListener?;
+    /**
+     * 合并用户传入的 InfoWindowOptions 与默认值，提升入参灵活性。
+     * 注意：必填项 position / content 由调用方提供，不在默认值内。
+     */
+    private mergeOptions;
     constructor(viewer: Viewer, container: HTMLElement);
+    /**
+     * Set default update interval (ms) for position updates when an InfoWindow doesn't specify `updateInterval`.
+     * 0 means update every frame.
+     */
+    setDefaultUpdateInterval(ms: number): void;
+    /**
+     * Force immediate update (recompute positions) of all managed info windows.
+     */
+    forceUpdateAll(): void;
     private convertPosition;
     /**
      * 将世界坐标转换为相对于 container 的 CSS 像素坐标

package/dist/libs/overlay/MapLabel.d.ts

@@ -56,4 +56,8 @@ export declare class MapLabel {
      * 更新 Label 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<LabelOptions, 'fillColor' | 'outlineColor' | 'outlineWidth' | 'font' | 'scale'>>): void;
+    /**
+     * 移除 Label（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapMarker.d.ts

@@ -43,4 +43,8 @@ export declare class MapMarker {
      * 更新 Marker 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<MarkerOptions, 'color' | 'outlineColor' | 'outlineWidth' | 'pixelSize'>>): void;
+    /**
+     * 移除 Marker（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapPolygon.d.ts

@@ -34,6 +34,23 @@ export declare class MapPolygon {
      * 解析材质
      */
     private resolveMaterial;
+    /**
+     * 计算二维多边形方向（正值为 CCW）
+     */
+    private polygonArea2D;
+    /**
+     * 向内偏移二维多边形顶点（线偏移 + 邻边相交）。厚度单位：米。
+     * 对复杂凹形可能產生伪影，更适合凸多边形或温和凹形。
+     */
+    private offsetPolygon2DInward;
+    /**
+     * 计算内偏移后的 3D 顶点：使用切平面近似进行 2D 偏移再投回椭球，并统一高度。
+     */
+    private computeInnerOffsetPositions;
+    /**
+     * 为多边形顶点统一高度（含微小抬升）
+     */
+    private elevatePositions;
     /**
      * 添加 Polygon（多边形）
      */
@@ -46,4 +63,8 @@ export declare class MapPolygon {
      * 更新 Polygon 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<PolygonOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+    /**
+     * 移除 Polygon（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapPolyline.d.ts

@@ -43,4 +43,8 @@ export declare class MapPolyline {
      * 更新 Polyline 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<PolylineOptions, 'width' | 'material'>>): void;
+    /**
+     * 移除 Polyline（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapRectangle.d.ts

@@ -29,6 +29,14 @@ export declare class MapRectangle {
      * 解析材质
      */
     private resolveMaterial;
+    /**
+     * 将 Rectangle 转为四点多边形顶点（按西南→东南→东北→西北顺序）
+     */
+    private rectangleToPositions;
+    /**
+     * 按米单位向内收缩矩形边界，返回新的 Rectangle
+     */
+    private shrinkRectangle;
     /**
      * 添加 Rectangle（矩形）
      */
@@ -41,4 +49,8 @@ export declare class MapRectangle {
      * 更新 Rectangle 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<RectangleOptions, 'material' | 'outline' | 'outlineColor' | 'outlineWidth'>>): void;
+    /**
+     * 移除 Rectangle（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/MapRing.d.ts

@@ -0,0 +1,95 @@
+import { Viewer, Entity, Color } from '../../../node_modules/cesium';
+import { OverlayPosition } from './types';
+/**
+ * Ring（边缘发光圆环）选项
+ */
+export interface RingOptions {
+    /** 中心点（经纬度/高度 或 Cartesian3） */
+    position: OverlayPosition;
+    /** 半径（米） */
+    radius: number;
+    /** 边缘发光颜色 */
+    color?: Color | string;
+    /** 是否绘制内层线（默认 true）。关闭可去掉“白色芯子” */
+    showInnerLine?: boolean;
+    /** 实线颜色 */
+    lineColor?: Color | string;
+    /** 内层线型：实线/虚线（默认 solid） */
+    lineStyle?: "solid" | "dashed";
+    /** 虚线材质方案：stripe(默认) / dash */
+    lineMaterialMode?: "stripe" | "dash";
+    /** stripe 模式：条纹重复次数（默认 32） */
+    stripeRepeat?: number;
+    /** 虚线长度（像素，默认 16） */
+    dashLength?: number;
+    /** 虚线模式（16bit pattern，可选） */
+    dashPattern?: number;
+    /** 虚线间隙颜色（默认透明） */
+    gapColor?: Color | string;
+    /** 线宽（像素） */
+    width?: number;
+    /** 外层发光线宽（像素）。优先于 width */
+    glowWidth?: number;
+    /** 内层实线线宽（像素）。不传则使用自动计算 */
+    lineWidth?: number;
+    /** 发光强度（0-1），越大越“亮/粗” */
+    glowPower?: number;
+    /** 是否贴地（默认 true） */
+    clampToGround?: boolean;
+    /** 圆环分段数（默认 128），越大越圆滑 */
+    segments?: number;
+    /** 覆盖物点击回调 */
+    onClick?: (entity: Entity) => void;
+    id?: string;
+}
+/**
+ * Ring 工具类：使用 polyline + PolylineGlowMaterialProperty 实现发光圆环
+ */
+export declare class MapRing {
+    private viewer;
+    private entities;
+    constructor(viewer: Viewer);
+    /**
+     * 转换位置为 Cartesian3
+     */
+    private convertPosition;
+    /**
+     * 转换颜色
+     */
+    private resolveColor;
+    private resolveLineMaterial;
+    private resolveGlowMaterial;
+    private getInnerWidth;
+    private addInnerEntity;
+    private removeInnerEntity;
+    private rebuildRingPositions;
+    /**
+     * 生成近似圆顶点（Cartesian3 数组）。segments 越大越平滑。
+     * 这里沿用 MapCircle 的大圆航线近似，保证在经纬度空间更稳定。
+     */
+    private generateCirclePositions;
+    /**
+     * 添加 Ring（边缘发光圆环）
+     */
+    add(options: RingOptions): Entity;
+    /**
+     * 更新 Ring 中心
+     */
+    updatePosition(entity: Entity, position: OverlayPosition): void;
+    /**
+     * 更新 Ring 半径
+     */
+    updateRadius(entity: Entity, radius: number): void;
+    /**
+     * 更新 Ring 样式
+     */
+    updateStyle(entity: Entity, options: Partial<Pick<RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>): void;
+    /**
+     * 显示/隐藏 Ring
+     */
+    setVisible(entity: Entity, visible: boolean): void;
+    /**
+     * 移除 Ring（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
+}

package/dist/libs/overlay/MapSVG.d.ts

@@ -56,4 +56,8 @@ export declare class MapSVG {
      * 更新 SVG 样式
      */
     updateStyle(entity: Entity, options: Partial<Pick<SvgOptions, 'scale' | 'rotation' | 'color'>>): void;
+    /**
+     * 移除 SVG（通过实体或实体 id）
+     */
+    remove(entityOrId: Entity | string): boolean;
 }

package/dist/libs/overlay/index.d.ts

@@ -8,6 +8,7 @@ export { MapPolyline } from './MapPolyline';
 export { MapPolygon } from './MapPolygon';
 export { MapRectangle } from './MapRectangle';
 export { MapCircle } from './MapCircle';
+export { MapRing } from './MapRing';
 export type { OverlayPosition } from './types';
 export type { MarkerOptions } from './MapMarker';
 export type { LabelOptions } from './MapLabel';
@@ -18,3 +19,4 @@ export type { PolylineOptions } from './MapPolyline';
 export type { PolygonOptions } from './MapPolygon';
 export type { RectangleOptions } from './MapRectangle';
 export type { CircleOptions } from './MapCircle';
+export type { RingOptions } from './MapRing';

package/dist/libs/overlay/types.d.ts

@@ -1,5 +1,41 @@
-import { Cartesian3 } from '../../../node_modules/cesium';
+import { Cartesian3, Entity, Color, MaterialProperty, Rectangle, Cartographic } from '../../../node_modules/cesium';
 /**
  * 覆盖物位置类型
  */
 export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+/**
+ * 覆盖物扩展实体类型
+ * 用于在 Cesium.Entity 上挂载覆盖物相关的元数据
+ */
+export interface OverlayEntity extends Entity {
+    /** 覆盖物点击回调（由各 Map* 工具类设置） */
+    _onClick?: (entity: Entity) => void;
+    /** 覆盖物类型标识（用于 CesiumOverlayService 做差异化更新/删除） */
+    _overlayType?: string;
+    /** 信息窗口根 DOM（由 MapInfoWindow / CesiumOverlayService 使用） */
+    _infoWindow?: HTMLElement;
+    /** 复合图形的内层实体或边框实体等关联引用 */
+    _borderEntity?: Entity;
+    _innerEntity?: Entity;
+    /** 粗边框 / 环形等形状相关元数据 */
+    _isThickOutline?: boolean;
+    _outlineWidth?: number;
+    _isRing?: boolean;
+    _ringThickness?: number;
+    _ringSegments?: number;
+    _ringGlowPower?: number;
+    _ringLineColor?: Color | string;
+    _ringLineStyle?: 'solid' | 'dashed';
+    _ringLineMaterialMode?: 'stripe' | 'dash';
+    _ringStripeRepeat?: number;
+    _ringDashLength?: number;
+    _ringDashPattern?: number;
+    _ringGapColor?: Color | string;
+    _ringShowInnerLine?: boolean;
+    _fillMaterial?: MaterialProperty | Color | string;
+    _ringHeightEpsilon?: number;
+    _centerCartographic?: Cartographic;
+    _outerRadius?: number;
+    _innerRadius?: number;
+    _outerRectangle?: Rectangle;
+}