@xingm/vmap-cesium-toolbar 1.0.0 → 1.0.2

package/{dist/adapters → adapters}/DrawHelperAdapter.d.ts

@@ -1,5 +1,6 @@
 import { Viewer, Entity, Cartesian3 } from '../../node_modules/cesium';
 import { DrawMode, MeasurementTheme, MeasurementSummaryLabelStyle } from '../core/services/draw/DrawService';
+import { CoordSystem, LngLat } from '../core/types';
 import * as Cesium from 'cesium';
 /**
  * 旧版绘制回调接口（保持向后兼容）
@@ -11,6 +12,8 @@ export interface LegacyDrawCallbacks {
     onMeasureComplete?: (result: {
         type: 'line' | 'polygon' | 'rectangle' | 'circle';
         positions: Cartesian3[];
+        geographicPositions?: LngLat[];
+        outputCoordSystem?: CoordSystem;
         distance?: number;
         areaKm2?: number;
     }) => void;
@@ -22,6 +25,10 @@ export interface LegacyDrawOptions {
     measurementTheme?: MeasurementTheme;
     lineColor?: Cesium.Color | string;
     lineWidth?: number;
+    strokeColor?: Cesium.Color | string;
+    strokeWidth?: number;
+    outlineColor?: Cesium.Color | string;
+    outlineWidth?: number;
     fillColor?: Cesium.Color | string;
     clampToGround?: boolean;
     segmentDistanceLabelStyle?: MeasurementSummaryLabelStyle;
@@ -29,7 +36,11 @@ export interface LegacyDrawOptions {
     previewAreaLabelStyle?: MeasurementSummaryLabelStyle;
     totalAreaLabelStyle?: MeasurementSummaryLabelStyle;
     hintBubbleStyle?: MeasurementSummaryLabelStyle;
+    selfIntersectionEnabled?: boolean;
+    selfIntersectionAllowTouch?: boolean;
+    selfIntersectionAllowContinue?: boolean;
     onClick?: (entity: Entity, positions?: Cartesian3[]) => void;
+    outputCoordSystem?: CoordSystem;
 }
 /**
  * 旧版绘制实体类型（保持向后兼容）
@@ -59,10 +70,6 @@ export declare class DrawHelperAdapter {
     private drawService;
     private callbacks;
     constructor(viewer: Viewer);
-    /**
-     * 映射绘制模式到类型字符串
-     */
-    private mapDrawModeToType;
     /**
      * 转换选项格式
      */
@@ -95,6 +102,16 @@ export declare class DrawHelperAdapter {
      * 清除所有绘制
      */
     clearAll(): void;
+    /**
+     * 兼容旧版完整清空方法。
+     * 旧实现会直接清空场景中的实体，这里保留同名 API。
+     */
+    clearAllEntities(): void;
+    /**
+     * 兼容旧版点实体清空方法。
+     * 新版绘制服务不单独维护点池，这里退化为清空当前绘制结果。
+     */
+    clearAllPoints(): void;
     /**
      * 删除指定实体
      */
@@ -107,6 +124,11 @@ export declare class DrawHelperAdapter {
      * 检查是否正在绘制
      */
     isDrawing(): boolean;
+    /**
+     * 兼容旧版场景模式切换通知。
+     * 新绘制服务内部不依赖固定偏移，这里保留空实现以避免业务侧报错。
+     */
+    handleSceneModeChanged(): void;
     /**
      * 获取当前绘制模式
      */
@@ -129,9 +151,12 @@ export declare class DrawHelperAdapter {
     onMeasureComplete(callback: (result: {
         type: 'line' | 'polygon' | 'rectangle' | 'circle';
         positions: Cartesian3[];
+        geographicPositions?: LngLat[];
+        outputCoordSystem?: CoordSystem;
         distance?: number;
         areaKm2?: number;
     }) => void): void;
+    getPositionLngLat(position: Cartesian3, outputCoordSystem?: CoordSystem): LngLat;
     /**
      * 销毁助手
      */

package/adapters/HeatmapLayerAdapter.d.ts

@@ -0,0 +1,11 @@
+import { default as CoreHeatmapLayer, HeatPoint, HeatmapAutoUpdateOptions, HeatmapGradient, HeatmapOptions } from '../libs/CesiumHeatmapLayer';
+/**
+ * 兼容旧 0.x API 的热力图图层。
+ *
+ * 直接继承当前核心实现，保留旧业务依赖的方法签名与自动更新能力，
+ * 让 package 顶层导出继续可用而不强迫业务迁移到新的 core 命名。
+ */
+export declare class HeatmapLayer extends CoreHeatmapLayer {
+}
+export default HeatmapLayer;
+export type { HeatPoint, HeatmapAutoUpdateOptions, HeatmapGradient, HeatmapOptions, };

package/{dist/adapters → adapters}/MapLoaderAdapter.d.ts

@@ -1,5 +1,6 @@
 import { Viewer } from '../../node_modules/cesium';
 import { MapPlugin } from '../core/MapPlugin';
+import { BaseMapConfig, MapAuthConfig } from '../core/types';
 import * as Cesium from 'cesium';
 export interface LegacyMapCenter {
     latitude: number;
@@ -7,13 +8,27 @@ export interface LegacyMapCenter {
     height: number;
     pitch?: number;
     heading?: number;
+    coordSystem?: 'WGS84' | 'GCJ02' | 'BD09';
 }
 export interface LegacyInitOptions {
     viewerOptions?: Cesium.Viewer.ConstructorOptions;
     mapType?: string;
     tdtMapTypeId?: string;
     token?: string;
+    TD_Token?: string;
+    sk?: string;
+    TD_SK?: string;
     cesiumToken?: string;
+    terrainProvider?: Cesium.TerrainProvider | null;
+    requestRenderMode?: boolean;
+    maximumRenderTimeChange?: number;
+    showRenderLoopErrors?: boolean;
+    useBrowserRecommendedResolution?: boolean;
+    automaticallyTrackDataSourceClocks?: boolean;
+    contextOptions?: Cesium.ContextOptions;
+    resolutionScale?: number;
+    depthTestAgainstTerrain?: boolean;
+    fxaa?: boolean;
     loadNoFlyZonesOnInit?: boolean;
     mapCenter?: LegacyMapCenter;
     isFly?: boolean;
@@ -30,6 +45,8 @@ export interface LegacyInitOptions {
     sceneModePicker?: boolean;
     baseLayerPicker?: boolean;
     selectionIndicator?: boolean;
+    baseMap?: BaseMapConfig;
+    mapAuth?: MapAuthConfig;
     [key: string]: unknown;
 }
 export interface LegacyInitResult {

package/adapters/MapMarkAdapter.d.ts

@@ -0,0 +1,29 @@
+import { MarkCallbacks, MarkDrawOptions, MarkDrawResult, MarkDrawType, MarkExportItem, MarkServiceOptions, MarkWorkAreaKind, MarkWorkAreaType } from '../core/services/mark';
+import type * as Cesium from 'cesium';
+export interface CesiumMapMarkOptions extends MarkServiceOptions {
+    callbacks?: MarkCallbacks;
+}
+export declare class MapMarkAdapter {
+    private readonly service;
+    constructor(viewer: Cesium.Viewer, options?: CesiumMapMarkOptions);
+    startDrawing(type: MarkDrawType, options?: MarkDrawOptions): void;
+    drawPoint(options?: MarkDrawOptions): void;
+    drawPolyline(options?: MarkDrawOptions): void;
+    drawPolygon(options?: MarkDrawOptions): void;
+    drawRectangle(options?: MarkDrawOptions): void;
+    drawCircle(options?: MarkDrawOptions): void;
+    startWorkAreaDraw(type: MarkWorkAreaType, kind?: MarkWorkAreaKind, options?: MarkDrawOptions): void;
+    stopDraw(): void;
+    cancelDrawing(): void;
+    clearAll(): void;
+    deleteEntity(entity: Cesium.Entity | string): void;
+    enableEdit(): void;
+    disableEdit(): MarkDrawResult | null;
+    startEdit(entity: Cesium.Entity | string): boolean;
+    stopEdit(): MarkDrawResult | null;
+    setColor(type: MarkDrawType, color: string): void;
+    getColor(type: MarkDrawType): string;
+    getEntities(): Cesium.Entity[];
+    exportData(): MarkExportItem[];
+    destroy(): void;
+}

package/{dist/adapters → adapters}/OverlayServiceAdapter.d.ts

@@ -1,6 +1,6 @@
 import { Viewer, Entity } from '../../node_modules/cesium';
 import { OverlayService, OverlayServiceOptions } from '../core/services/overlay/OverlayService';
-import { MarkerOptions, LabelOptions, IconOptions, SvgOptions, InfoWindowOptions, PolylineOptions, PolygonOptions, RectangleOptions, CircleOptions, RingOptions, OverlayEntity } from '../core/entities';
+import { MarkerOptions, LabelOptions, IconOptions, SvgOptions, InfoWindowOptions, PolylineOptions, PolygonOptions, RectangleOptions, CircleOptions, RingOptions, OverlayEntity, OverlayPosition } from '../core/entities';
 /**
  * 旧版覆盖物服务选项（保持向后兼容）
  */
@@ -9,6 +9,12 @@ export interface LegacyCesiumOverlayServiceOptions extends OverlayServiceOptions
     enableHoverHandler?: boolean;
     /** 点击节流间隔 */
     clickPickMinIntervalMs?: number;
+    /** 兼容旧版编辑变化回调 */
+    onOverlayEditChange?: (entity: Entity & OverlayEntity) => void;
+    /** 兼容旧版编辑结束回调 */
+    onOverlayEditEnd?: (entity: Entity & OverlayEntity | null) => void;
+    /** 兼容旧版编辑参数 */
+    overlayEditOptions?: Record<string, any>;
 }
 /**
  * OverlayService 适配器
@@ -27,7 +33,12 @@ export interface LegacyCesiumOverlayServiceOptions extends OverlayServiceOptions
 export declare class OverlayServiceAdapter {
     private viewer;
     private overlayService;
+    private hoverEnabled;
+    private bulkUpdateDepth;
+    private overlayEditOptions;
     constructor(viewer: Viewer, options?: LegacyCesiumOverlayServiceOptions);
+    private resolveOverlayEntity;
+    private applyHoverState;
     /**
      * 添加 Marker
      */
@@ -72,6 +83,10 @@ export declare class OverlayServiceAdapter {
      * 根据 ID 获取覆盖物
      */
     getOverlay(id: string): Entity | undefined;
+    /**
+     * 获取所有覆盖物实体。
+     */
+    getAllOverlays(): Entity[];
     /**
      * 根据 ID 删除覆盖物
      */
@@ -84,12 +99,51 @@ export declare class OverlayServiceAdapter {
      * 设置覆盖物可见性
      */
     setOverlayVisible(id: string, visible: boolean): boolean;
+    /**
+     * 更新覆盖物位置。
+     * 兼容旧版的单点位置更新 API。
+     */
+    updateOverlayPosition(id: string, position: OverlayPosition): boolean;
     /**
      * 获取所有覆盖物 ID
      */
     getAllOverlayIds(): string[];
-    toggleOverlayHighlight(entityOrId: OverlayEntity | Entity | string, reason?: 'click' | 'hover'): boolean;
-    setOverlayHighlight(entityOrId: OverlayEntity | Entity | string, enabled: boolean, reason?: 'click' | 'hover'): boolean;
+    toggleOverlayHighlight(entityOrId: OverlayEntity | Entity | string | number, reason?: 'click' | 'hover'): boolean;
+    setOverlayHighlight(entityOrId: OverlayEntity | Entity | string | number, enabled: boolean, reason?: 'click' | 'hover'): boolean;
+    /**
+     * 显式开启/关闭 hover 高亮处理。
+     */
+    toggleOverlayHoverHighlight(enabled: boolean): void;
+    /**
+     * 开启/关闭覆盖物编辑模式。
+     * compat 层直接转发到底层 OverlayService。
+     */
+    setOverlayEditMode(enabled: boolean, overlayEditOptions?: Record<string, any>): void;
+    /**
+     * 获取当前编辑模式开关。
+     */
+    getOverlayEditModeEnabled(): boolean;
+    /**
+     * 停止当前编辑目标，但不强制关闭全局编辑开关。
+     */
+    stopOverlayEdit(): void;
+    /**
+     * 主动开始编辑某个覆盖物。
+     * compat 层会切换到编辑状态并抑制 hover，但不会真正渲染编辑控制点。
+     */
+    startOverlayEdit(entityOrId: OverlayEntity | Entity | string | number, options?: Record<string, any>): boolean;
+    /**
+     * 批量更新包裹器。
+     */
+    beginBulkUpdate(): void;
+    /**
+     * 结束一次批量更新。
+     */
+    endBulkUpdate(): void;
+    /**
+     * 批量更新包裹器（自动 begin/end）。
+     */
+    bulkUpdate<T>(fn: () => T): T;
     getCoreService(): OverlayService;
     /**
      * 销毁服务

package/{dist/adapters → adapters}/ToolbarAdapter.d.ts

@@ -1,6 +1,9 @@
 import { Viewer } from '../../node_modules/cesium';
-import { CustomButtonConfig, MapType, MeasurementCallback, SearchCallback, ToolbarConfig, ZoomCallback } from '../core/types';
+import { CustomButtonConfig, MapType, MapAuthConfig, MeasurementCallback, SearchCallback, ToolbarConfig, ZoomCallback } from '../core/types';
 import { ToolbarService } from '../core/services/toolbar/ToolbarService';
+import { LayersServiceBridge } from '../core/MapPlugin';
+import { SearchService as LegacySearchService } from '../libs/toolBar/MapSearchService';
+import { MeasurementService as LegacyMeasurementService } from '../libs/toolBar/MeasurementService';
 interface LegacyInitialCenter {
     longitude: number;
     latitude: number;
@@ -13,6 +16,16 @@ export interface LegacyCesiumMapToolbarCallbacks {
     fullscreen?: (isFullscreen: boolean) => void;
     resetLocation?: () => void;
 }
+interface LegacyMapLayersBridge {
+    setMapType: (mapTypeId: string) => void;
+    setPlaceNameVisible: (isChecked: boolean) => void;
+    togglePlaceNameVisibility: () => void;
+    showNoFlyZones: () => Promise<void>;
+    hideNoFlyZones: () => void;
+    toggleNoFlyZoneVisibility: () => void;
+    toggleNoFlyZones: () => Promise<void>;
+    getNoFlyZoneVisible: () => boolean;
+}
 declare class ToolbarAdapterMapController {
     private readonly viewer;
     private initialCenter;
@@ -43,18 +56,39 @@ export declare class ToolbarAdapter {
     private readonly drawHelper;
     private readonly mapController;
     private readonly i18nInstance;
+    private readonly mapPlugin;
+    private searchService;
+    private measurementService;
+    private layersServiceBridge;
     private currentMapType;
+    private placeNameVisible;
+    private noFlyZoneVisible;
     TD_Token: string;
+    TD_SK: string;
     mapTypes: MapType[];
+    readonly measurement: {
+        getMeasureMode: () => "none" | "distance" | "area";
+    };
     constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: LegacyCesiumMapToolbarCallbacks, initialCenter?: LegacyInitialCenter);
-    private applyMapType;
+    private getLayersButtonCallback;
+    private emitLayersButtonCallback;
     private syncLayersHandler;
+    private syncTdtAuthToMapPlugin;
+    private createLayersServiceBridge;
+    private applyMapTypeDirectly;
+    getSearchService(): LegacySearchService | null;
+    getMeasurementService(): LegacyMeasurementService | null;
+    getMapLayersService(): LegacyMapLayersBridge | LayersServiceBridge | null;
     setMapType(mapTypeId: string): void;
     getToolbarService(): ToolbarService;
     getToolbarElement(): HTMLElement | null;
     getCesiumMapCtrl(): ToolbarAdapterMapController;
     setMapTypes(mapTypes: MapType[]): void;
     setTDToken(token: string): void;
+    setTDSK(sk: string): void;
+    setTDTAuth(token: string, sk?: string): void;
+    setMapAuth(auth: MapAuthConfig): void;
+    setBaseMapProvider(provider: 'tdt' | 'gaode' | 'tencent' | 'baidu' | 'google' | 'custom', type?: string): void;
     setInitialCenter(center: LegacyInitialCenter): void;
     getInitialCenter(): LegacyInitialCenter;
     resetToInitialLocation(): void;
@@ -65,6 +99,10 @@ export declare class ToolbarAdapter {
     hideButton(buttonId: string): void;
     enableButton(buttonId: string): void;
     disableButton(buttonId: string): void;
+    showNoFlyZones(): Promise<void>;
+    hideNoFlyZones(): void;
+    toggleNoFlyZones(): Promise<void>;
+    getNoFlyZoneVisible(): boolean;
     destroy(): void;
 }
 export declare function createToolbarAdapter(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: LegacyCesiumMapToolbarCallbacks, initialCenter?: LegacyInitialCenter): ToolbarAdapter;

package/{dist/adapters → adapters}/index.d.ts

@@ -11,8 +11,12 @@ export { initCesium } from './MapLoaderAdapter';
 export type { LegacyInitOptions, LegacyInitResult, LegacyMapCenter } from './MapLoaderAdapter';
 export { DrawHelperAdapter, createDrawHelperAdapter } from './DrawHelperAdapter';
 export type { LegacyDrawCallbacks, LegacyDrawOptions, LegacyDrawEntity } from './DrawHelperAdapter';
+export { HeatmapLayer } from './HeatmapLayerAdapter';
+export type { HeatPoint, HeatmapAutoUpdateOptions, HeatmapGradient, HeatmapOptions, } from './HeatmapLayerAdapter';
 export { OverlayServiceAdapter, createOverlayServiceAdapter } from './OverlayServiceAdapter';
 export type { LegacyCesiumOverlayServiceOptions } from './OverlayServiceAdapter';
+export { MapMarkAdapter } from './MapMarkAdapter';
+export type { CesiumMapMarkOptions } from './MapMarkAdapter';
 /**
  * 适配器模块版本信息
  */

package/{dist/core → core}/MapPlugin.d.ts

@@ -1,8 +1,18 @@
-import { CameraConfig, DrawPluginOptions, LayersConfig, MapPluginOptions, OverlayPluginOptions, ToolbarConfig, ToolbarPluginOptions } from './types';
+import { BaseMapConfig, MapAuthConfig, CameraConfig, DrawPluginOptions, LayersConfig, MapPluginOptions, OverlayPluginOptions, ToolbarConfig, ToolbarPluginOptions } from './types';
 import { OverlayService } from './services/overlay/OverlayService';
 import { DrawService } from './services/draw/DrawService';
 import { ToolbarService } from './services/toolbar/ToolbarService';
 import * as Cesium from 'cesium';
+export interface LayersServiceBridge {
+    setMapType: (mapTypeId: string) => void;
+    setPlaceNameVisible: (isChecked: boolean) => void;
+    togglePlaceNameVisibility: () => void;
+    showNoFlyZones: () => Promise<void>;
+    hideNoFlyZones: () => void;
+    toggleNoFlyZoneVisibility: () => void;
+    toggleNoFlyZones: () => Promise<void>;
+    getNoFlyZoneVisible: () => boolean;
+}
 /**
  * 地图插件核心类
  * 负责整合所有地图功能，提供统一的 API 接口
@@ -13,6 +23,8 @@ export declare class MapPlugin {
     private viewerOptions;
     private cameraConfig;
     private layersConfig;
+    private baseMapConfig;
+    private mapAuthConfig;
     private cesiumToken;
     private toolbarConfig;
     private toolbarLayersMenuConfig;
@@ -23,11 +35,14 @@ export declare class MapPlugin {
     private toolbarMapTypes;
     private currentMapTypeId;
     private placeNameVisible;
+    private nonForcedPlaceNameVisible;
     private noFlyZoneVisible;
     private noFlyZoneDataSource;
     private noFlyZoneLoadPromise;
     private currentGeoWTFS;
     private sceneModeListenerDispose;
+    private offlineCleanup;
+    private layerRequestVersion;
     private toolbarService;
     private overlayService;
     private drawService;
@@ -56,21 +71,32 @@ export declare class MapPlugin {
      * 合并图层配置
      */
     private mergeLayersConfig;
+    private resolveBaseMapConfig;
     private resolveCurrentMapTypeId;
     private resolvePlaceNameVisible;
     private getToolbarMapTypes;
     private getCurrentToolbarMapType;
     private getLayerToken;
+    private getLayerSk;
+    private resetTerrainProvider;
+    private applyTerrainProvider;
     private ensureNoFlyZoneDataSource;
     private destroyGeoWTFS;
     private syncGeoWTFS;
+    private refreshLayersAndGeoWTFS;
+    private syncCreditDisplay;
+    private clearOfflineConstraints;
+    private applyOfflineConstraints;
     private updateToolbarLayerState;
     private createLayersServiceBridge;
+    private syncOfflineToolbarState;
     private setMapType;
     private setPlaceNameVisible;
-    private showNoFlyZones;
-    private hideNoFlyZones;
-    private toggleNoFlyZones;
+    showNoFlyZones(): Promise<void>;
+    hideNoFlyZones(): void;
+    toggleNoFlyZones(): Promise<void>;
+    getNoFlyZoneVisible(): boolean;
+    getLayersServiceBridge(): LayersServiceBridge;
     /**
      * 初始化地图
      */
@@ -119,6 +145,8 @@ export declare class MapPlugin {
      * 更新图层配置
      */
     updateLayers(config: Partial<LayersConfig>): void;
+    updateBaseMap(baseMap: Partial<BaseMapConfig>): void;
+    updateMapAuth(mapAuth: MapAuthConfig): void;
     /**
      * 创建 ToolbarService
      */

package/{dist/core → core}/entities/BaseOverlay.d.ts

@@ -1,4 +1,5 @@
 import { Viewer, Entity } from '../../../node_modules/cesium';
+import { CoordSystem } from '../mapProviders/coordinates/types';
 import * as Cesium from 'cesium';
 /**
  * 覆盖物位置类型
@@ -24,6 +25,8 @@ export interface BaseOverlayOptions {
     metadata?: Record<string, any>;
     /** 兼容旧版图层分组键 */
     layerKey?: string;
+    /** 当前入参坐标系，默认 WGS84 */
+    coordSystem?: CoordSystem;
 }
 /** 点击高亮配置 */
 export interface OverlayClickHighlightOptions {
@@ -128,6 +131,10 @@ export declare abstract class BaseOverlay {
      * 获取覆盖物 ID
      */
     getId(): string;
+    /**
+     * 兼容 0.x：外部常直接把覆盖物实例当作 Entity 用，读取 `id`。
+     */
+    get id(): string;
     /**
      * 设置是否显示
      */

package/{dist/core → core}/entities/Circle.d.ts

@@ -1,5 +1,6 @@
-import { Viewer, Color, MaterialProperty, HeightReference } from '../../../node_modules/cesium';
+import { Viewer, Entity, Color, MaterialProperty, HeightReference } from '../../../node_modules/cesium';
 import { BaseOverlay, BaseOverlayOptions, OverlayPosition } from './BaseOverlay';
+import * as Cesium from 'cesium';
 /**
  * Circle 配置选项
  */
@@ -48,9 +49,20 @@ export interface CircleOptions extends BaseOverlayOptions {
  * ```
  */
 export declare class Circle extends BaseOverlay {
+    private static primitiveManagers;
     private circleOptions;
     private innerEntity?;
+    private primitiveMode;
+    private primitiveManager;
     constructor(viewer: Viewer, options: CircleOptions);
+    private static getPrimitiveManager;
+    private canUsePrimitive;
+    private resolveMaterialColor;
+    private getDefaultSegmentsForRadius;
+    private initPrimitiveCircle;
+    private updatePrimitiveGeometry;
+    private getPrimitiveRoot;
+    private getPrimitiveBatchColorFallback;
     /**
      * 创建粗边框圆形（环形）
      */
@@ -95,6 +107,10 @@ export declare class Circle extends BaseOverlay {
      * 获取半径
      */
     getRadius(): number;
+    setPrimitiveVisible(entity: Entity, visible: boolean): void;
+    applyPrimitiveHighlight(entity: Entity, hlColor: Cesium.Color, _fillAlpha: number): void;
+    restorePrimitiveHighlight(entity: Entity): void;
+    setVisible(show: boolean): void;
     /**
      * 从场景中移除圆形
      */

package/{dist/core → core}/entities/Polyline.d.ts

@@ -10,6 +10,8 @@ export interface PolylineOptions extends BaseOverlayOptions {
     width?: number;
     /** 材质（颜色、字符串或 MaterialProperty） */
     material?: MaterialProperty | Color | string;
+    /** 兼容旧版颜色字段 */
+    color?: Color | string;
     /** 是否贴地（默认 false） */
     clampToGround?: boolean;
     /** 贴地抬高量（米，clampToGround=true 时生效） */

package/{dist/core → core}/entities/Ring.d.ts

@@ -40,6 +40,8 @@ export interface RingOptions extends BaseOverlayOptions {
     segments?: number;
     /** 兼容旧版发光宽度配置 */
     glowWidth?: number;
+    /** 兼容旧版动画速度字段（当前保留，不参与渲染） */
+    speed?: number;
 }
 /**
  * Ring 发光圆环类

package/core/entities/primitives/CirclePrimitiveBatch.d.ts

@@ -0,0 +1,42 @@
+import { Viewer, Entity } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface CirclePrimitiveParts {
+    outer: Entity;
+    inner: Entity;
+}
+export declare class CirclePrimitiveBatch {
+    private viewer;
+    private ringCollection;
+    private fillCollection;
+    private ownsCollections;
+    private ownedRootCollection;
+    private ringPrimitive;
+    private fillPrimitive;
+    private records;
+    private rebuildScheduled;
+    private colorApplyScheduled;
+    private pendingColorApplyIds;
+    constructor(viewer: Viewer, options?: {
+        ringCollection?: Cesium.PrimitiveCollection;
+        fillCollection?: Cesium.PrimitiveCollection;
+    });
+    destroy(): void;
+    has(circleId: string): boolean;
+    upsertGeometry(args: {
+        circleId: string;
+        parts: CirclePrimitiveParts;
+        ringPositions: Cesium.Cartesian3[];
+        fillPositions: Cesium.Cartesian3[];
+        ringColor: Cesium.Color;
+        fillColor: Cesium.Color;
+        visible: boolean;
+    }): void;
+    remove(circleId: string): void;
+    setVisible(circleId: string, visible: boolean): void;
+    setColors(circleId: string, ringColor: Cesium.Color, fillColor: Cesium.Color): void;
+    private scheduleApplyColors;
+    private scheduleRebuild;
+    private assertCloneableInstanceId;
+    private rebuild;
+    private applyCurrentColors;
+}

package/core/entities/primitives/CirclePrimitiveLayerStack.d.ts

@@ -0,0 +1,15 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface CirclePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+export declare class CirclePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): CirclePrimitiveLayerCollections;
+    destroy(): void;
+}

package/core/layers/TDTMapLayer.d.ts

@@ -0,0 +1,61 @@
+import { TDTLayerConfig } from '../types';
+import { MapLayer } from './MapLayer';
+import * as Cesium from 'cesium';
+export declare function setTDTPlugin(plugin: unknown): void;
+export declare function ensureTDT3DExtensionLoaded(): Promise<boolean>;
+export declare const hasTDT3DExtension: (_CesiumNS: typeof Cesium) => boolean;
+/**
+ * 天地图影像图层配置（带注记）
+ */
+export declare const createTDTImageryConfig: (token: string, sk?: string) => Cesium.ImageryProvider[];
+/**
+ * 天地图矢量图层配置（带注记）
+ */
+export declare const createTDTVectorConfig: (token: string, sk?: string) => Cesium.ImageryProvider[];
+/**
+ * 天地图地形图层配置（带注记）
+ */
+export declare const createTDTTerrainConfig: (token: string, sk?: string) => Cesium.ImageryProvider[];
+/**
+ * 天地图三维影像图层配置（带注记）
+ */
+export declare const createTDT3DImageryConfig: (token: string, sk?: string) => Cesium.ImageryProvider[];
+/**
+ * 天地图三维地形提供者配置
+ */
+export declare const createTDT3DTerrainProvider: (token: string, sk?: string) => Cesium.TerrainProvider | null;
+export declare const createTDT3DGeoWTFS: (token: string, viewer: Cesium.Viewer, sk?: string) => any | null;
+/**
+ * 天地图图层类
+ * 支持矢量、影像、地形、三维地图四种类型的天地图图层
+ */
+export declare class TDTMapLayer extends MapLayer {
+    private config;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param config 天地图图层配置
+     */
+    constructor(viewer: Cesium.Viewer, config: TDTLayerConfig);
+    /**
+     * 获取影像提供者数组
+     */
+    /**
+     * 获取地图服务提供者数组
+     * @returns {Cesium.ImageryProvider[]} 返回符合配置的地图服务提供者数组
+     */
+    protected getProviders(): Cesium.ImageryProvider[];
+    /**
+     * 添加图层到 Viewer
+     */
+    addToViewer(): void;
+    /**
+     * 更新图层配置
+     * @param config 新的天地图图层配置
+     */
+    updateConfig(config: Partial<TDTLayerConfig>): void;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): TDTLayerConfig;
+}

package/{dist/core → core}/layers/index.d.ts

@@ -9,6 +9,7 @@ export { GaodeMapLayer } from './GaodeMapLayer';
 export { BaiduMapLayer } from './BaiduMapLayer';
 export { OSMMapLayer } from './OSMMapLayer';
 export { CustomMapLayer } from './CustomMapLayer';
+export { setTDTPlugin, createTDTImageryConfig, createTDTVectorConfig, createTDTTerrainConfig, createTDT3DImageryConfig, createTDT3DTerrainProvider, createTDT3DGeoWTFS, hasTDT3DExtension, } from './TDTMapLayer';
 export { HeatmapLayer } from './HeatmapLayer';
 export type { HeatPoint, HeatmapGradient, HeatmapOptions } from './HeatmapLayer';
 export { PointClusterLayer } from './PointClusterLayer';