@xingm/vmap-cesium-toolbar 0.0.7-alpha.1 → 0.0.7-alpha.2

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

@@ -0,0 +1,101 @@
+import * as Cesium from "cesium";
+/**
+ * 句柄样式（颜色/描边/像素大小）
+ */
+export type HandleStyle = {
+    color: Cesium.Color;
+    outlineColor: Cesium.Color;
+    pixelSize: number;
+};
+/**
+ * 创建编辑句柄实体
+ */
+export type CreateHandle = (position: Cesium.Cartesian3, style: HandleStyle, meta: any) => Cesium.Entity;
+export interface OverlayEditOptions {
+    vertex: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    mid: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    move: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    rotate: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+    scale: {
+        enable?: boolean;
+        color?: Cesium.Color;
+        outlineColor?: Cesium.Color;
+        outlineWidth?: number;
+        pixelSize?: number;
+    } | boolean;
+}
+export declare const DEFAULT_OPTIONS: OverlayEditOptions;
+/**
+ * 构建/更新句柄所需的依赖函数集合
+ */
+export interface HandleHelpers {
+    createHandle: CreateHandle;
+    computePolygonCenterCartesian: (positions: Cesium.Cartesian3[]) => Cesium.Cartesian3;
+    computePolylineHandleRadius: (positions: Cesium.Cartesian3[], center: Cesium.Cartesian3) => number;
+    offsetByMeters: (center: Cesium.Cartesian3, meters: number, bearingDeg: number) => Cesium.Cartesian3;
+    circleRadiusHandlePosition: (center: Cesium.Cartesian3, radiusMeters: number) => Cesium.Cartesian3;
+}
+/**
+ * 构建多边形编辑句柄（顶点/中点/整体移动）
+ */
+export declare function buildPolygonHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
+/**
+ * 构建矩形编辑句柄（顶点/边中点/整体移动）
+ */
+export declare function buildRectangleHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
+/**
+ * 构建折线编辑句柄（顶点/中点/整体移动/旋转/缩放）
+ */
+export declare function buildPolylineHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
+/**
+ * 构建点编辑句柄
+ */
+export declare function buildPointHandles(pos: Cesium.Cartesian3 | null, helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
+/**
+ * 构建圆形编辑句柄（圆心/半径）
+ */
+export declare function buildCircleHandles(center: Cesium.Cartesian3 | null, radiusMeters: number, helpers: HandleHelpers, options: OverlayEditOptions): Cesium.Entity[];
+/**
+ * 更新多边形句柄位置
+ * @returns false 表示句柄数量不匹配，需重建
+ */
+export declare function updatePolygonHandlePositions(verts: Cesium.Cartesian3[], handles: Cesium.Entity[], helpers: HandleHelpers): boolean;
+/**
+ * 更新折线句柄位置
+ * @returns false 表示句柄数量不匹配，需重建
+ */
+export declare function updatePolylineHandlePositions(verts: Cesium.Cartesian3[], handles: Cesium.Entity[], helpers: HandleHelpers): boolean;
+/**
+ * 更新点句柄位置
+ * @returns false 表示句柄数量不匹配或参数为空
+ */
+export declare function updatePointHandlePositions(pos: Cesium.Cartesian3 | null, handles: Cesium.Entity[]): boolean;
+/**
+ * 更新圆形句柄位置
+ * @returns false 表示句柄数量不匹配或参数为空
+ */
+export declare function updateCircleHandlePositions(center: Cesium.Cartesian3 | null, radiusMeters: number, handles: Cesium.Entity[], helpers: HandleHelpers): boolean;

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

@@ -0,0 +1,40 @@
+import { Entity } from '../../../node_modules/cesium';
+import { DrawEntity } from '../drawHelper';
+import { OverlayEntity } from './types';
+import { MapCircle } from './MapCircle';
+import { MapPolygon } from './MapPolygon';
+import { MapRectangle } from './MapRectangle';
+import * as Cesium from "cesium";
+export interface OverlayHighlightHost {
+    getEntities(): Cesium.EntityCollection;
+    getOverlayById(id: string): (DrawEntity & OverlayEntity) | undefined;
+    getPropertyValue<T>(prop: any, fallback: T): T;
+    getNumberProperty(prop: any, fallback: number): number;
+    getCircle(): MapCircle;
+    getPolygon(): MapPolygon;
+    getRectangle(): MapRectangle;
+}
+export declare class OverlayHighlight {
+    private readonly host;
+    private static readonly DEFAULT_HIGHLIGHT_COLOR;
+    private static readonly DEFAULT_HIGHLIGHT_FILL_ALPHA;
+    private static readonly DEFAULT_HIGHLIGHT_GLOW_POWER;
+    private static readonly GLOW_OUTLINE_ROOT_ID_PROP;
+    private readonly entities;
+    constructor(host: OverlayHighlightHost);
+    mapGlowOutlineEntityToRoot(entity: Cesium.Entity): (DrawEntity & OverlayEntity) | null;
+    setOverlayHighlightReason(targets: Entity[], reason: "click" | "hover", enabled: boolean): void;
+    toggleOverlayHighlight(entity: OverlayEntity, reason?: "click" | "hover"): void;
+    setOverlayHighlight(entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover"): boolean;
+    private getEntityPropertyString;
+    private getPropertyValue;
+    private getNumberProperty;
+    private resolveHighlightOptions;
+    private getActiveHighlightOptions;
+    private getClosedPositions;
+    private generateEllipseOutlinePositions;
+    private ensureGlowOutline;
+    private removeGlowOutline;
+    private applyOverlayHighlightStyle;
+    private restoreOverlayHighlightStyle;
+}

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

@@ -0,0 +1,23 @@
+export { CesiumOverlayService } from '../CesiumOverlayService';
+export type { CesiumOverlayServiceOptions } from '../CesiumOverlayService';
+export { MapMarker } from './MapMarker';
+export { MapLabel } from './MapLabel';
+export { MapIcon } from './MapIcon';
+export { MapSVG } from './MapSVG';
+export { MapInfoWindow } from './MapInfoWindow';
+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';
+export type { IconOptions } from './MapIcon';
+export type { SvgOptions } from './MapSVG';
+export type { InfoWindowOptions } from './MapInfoWindow';
+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/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/dist/libs/overlay/primitives/CirclePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface CirclePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * 为 Circle（圆）Primitive 渲染维护一个稳定的有序图层栈。
+ *
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有外环图层（从下到上）
+ *
+ * 这样可以确保在存在多个半透明填充重叠时，外环边界仍然清晰可见。
+ */
+export declare class CirclePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): CirclePrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/PolygonPrimitiveBatch.d.ts

@@ -0,0 +1,43 @@
+import { Viewer, Entity } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface PolygonPrimitiveParts {
+    fill: Entity;
+    border: Entity;
+}
+export declare class PolygonPrimitiveBatch {
+    private viewer;
+    private fillCollection;
+    private borderCollection;
+    private ownsCollections;
+    private ownedRootCollection;
+    private fillPrimitive;
+    private borderPrimitive;
+    private records;
+    private rebuildScheduled;
+    private colorApplyScheduled;
+    private pendingColorApplyIds;
+    constructor(viewer: Viewer, options?: {
+        fillCollection?: Cesium.PrimitiveCollection;
+        borderCollection?: Cesium.PrimitiveCollection;
+    });
+    destroy(): void;
+    upsertGeometry(args: {
+        polygonId: string;
+        parts: PolygonPrimitiveParts;
+        fillPositions: Cesium.Cartesian3[];
+        borderPositions: Cesium.Cartesian3[];
+        borderWidth: number;
+        fillColor: Cesium.Color;
+        borderColor: Cesium.Color;
+        visible: boolean;
+    }): void;
+    remove(polygonId: string): void;
+    setVisible(polygonId: string, visible: boolean): void;
+    setColors(polygonId: string, borderColor: Cesium.Color, fillColor: Cesium.Color): void;
+    private scheduleApplyColors;
+    setBorderWidth(polygonId: string, borderWidth: number): void;
+    private scheduleRebuild;
+    private assertCloneableInstanceId;
+    private rebuild;
+    private applyCurrentColors;
+}

package/dist/libs/overlay/primitives/PolygonPrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface PolygonPrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    borderCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * 为 Polygon（多边形）Primitive 渲染维护一个稳定的有序图层栈。
+ *
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有边框图层（从下到上）
+ *
+ * 这样可以确保在存在多个半透明填充重叠时，边框仍然清晰可见。
+ */
+export declare class PolygonPrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private bordersRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): PolygonPrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/RectanglePrimitiveBatch.d.ts

@@ -0,0 +1,41 @@
+import { Viewer, Entity } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface RectanglePrimitiveParts {
+    outer: Entity;
+    inner: Entity;
+}
+export declare class RectanglePrimitiveBatch {
+    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;
+    upsertGeometry(args: {
+        rectangleId: string;
+        parts: RectanglePrimitiveParts;
+        outerPositions: Cesium.Cartesian3[];
+        innerPositions: Cesium.Cartesian3[];
+        ringColor: Cesium.Color;
+        fillColor: Cesium.Color;
+        visible: boolean;
+    }): void;
+    remove(rectangleId: string): void;
+    setVisible(rectangleId: string, visible: boolean): void;
+    setColors(rectangleId: string, ringColor: Cesium.Color, fillColor: Cesium.Color): void;
+    private scheduleApplyColors;
+    private scheduleRebuild;
+    private assertCloneableInstanceId;
+    private rebuild;
+    private applyCurrentColors;
+}

package/dist/libs/overlay/primitives/RectanglePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface RectanglePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * 为矩形 Primitive 渲染维护一个稳定的有序图层栈。
+ *
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有描边图层（从下到上）
+ *
+ * 这样可以确保在存在多个半透明填充重叠时，描边仍然清晰可见。
+ */
+export declare class RectanglePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): RectanglePrimitiveLayerCollections;
+    destroy(): void;
+}

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

@@ -0,0 +1,121 @@
+import { Cartesian3, Entity, Color, MaterialProperty, Rectangle, Cartographic } from '../../../node_modules/cesium';
+/**
+ * 覆盖物位置类型
+ */
+export type OverlayPosition = Cartesian3 | [number, number] | [number, number, number];
+export interface OverlayHighlightOriginalStyle {
+    point?: {
+        pixelSize?: any;
+        color?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+    };
+    label?: {
+        fillColor?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        scale?: any;
+    };
+    billboard?: {
+        scale?: any;
+        color?: any;
+    };
+    polyline?: {
+        width?: any;
+        material?: any;
+    };
+    polygon?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+    rectangle?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+    ellipse?: {
+        outline?: any;
+        outlineColor?: any;
+        outlineWidth?: any;
+        material?: any;
+    };
+}
+export interface OverlayClickHighlightOptions {
+    /** 高亮主颜色（默认 yellow） */
+    color?: Color | string;
+    /** 面填充透明度（默认 0.35） */
+    fillAlpha?: number;
+}
+/** 与 clickHighlight 使用同样的参数结构（颜色 + 面填充透明度） */
+export type OverlayHoverHighlightOptions = OverlayClickHighlightOptions;
+/**
+ * 覆盖物扩展实体类型
+ * 用于在 Cesium.Entity 上挂载覆盖物相关的元数据
+ */
+export interface OverlayEntity extends Entity {
+    /** 覆盖物点击回调（由各 Map* 工具类设置） */
+    _onClick?: (entity: Entity) => void;
+    /** 点击覆盖物时是否启用高亮（由各 Map* 工具类设置） */
+    _clickHighlight?: boolean | OverlayClickHighlightOptions;
+    /** 鼠标移入覆盖物时是否启用高亮（由各 Map* 工具类设置） */
+    _hoverHighlight?: boolean | OverlayHoverHighlightOptions;
+    /** 高亮联动的实体集合（复合覆盖物：边框/填充等一起切换） */
+    _highlightEntities?: Entity[];
+    /** 当前是否处于高亮状态 */
+    _isHighlighted?: boolean;
+    /** 当前高亮原因（click/hover 可叠加；click 优先显示） */
+    _highlightState?: {
+        click?: boolean;
+        hover?: boolean;
+    };
+    /** 用于还原高亮前的原始样式 */
+    _highlightOriginalStyle?: OverlayHighlightOriginalStyle;
+    /** 高亮时临时创建的“发光边框”实体（由 CesiumOverlayService 管理） */
+    _highlightGlowEntity?: Entity;
+    /** 覆盖物类型标识（用于 CesiumOverlayService 做差异化更新/删除） */
+    _overlayType?: string;
+    /** 信息窗口根 DOM（由 MapInfoWindow / CesiumOverlayService 使用） */
+    _infoWindow?: HTMLElement;
+    /** 复合图形的内层实体或边框实体等关联引用 */
+    _borderEntity?: Entity;
+    _innerEntity?: Entity;
+    /** 粗边框 / 环形等形状相关元数据 */
+    /** 是否贴地（粗边框/环形等复合形状用） */
+    _clampToGround?: boolean;
+    /** 复合形状的基准高度（米，clampToGround=false 时有效） */
+    _baseHeight?: number;
+    /** 贴地抬高量（米，clampToGround=true 时有效） */
+    _groundHeightEpsilon?: number;
+    _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;
+    /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
+    /** primitive layer key: 用于分层批处理路由 */
+    _primitiveLayerKey?: string;
+    _primitiveRingBaseColor?: Color;
+    _primitiveFillBaseColor?: Color;
+    /** primitive：用于高亮发光边框的外圈/边界位置（通常为闭合折线） */
+    _primitiveOutlinePositions?: Cartesian3[];
+    /** primitive polygon/rectangle: 边框纯色缓存（用于高亮恢复） */
+    _primitiveBorderBaseColor?: Color;
+}

package/dist/libs/toolBar/CesiumMapController.d.ts

@@ -0,0 +1,87 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { MapType, ZoomCallback } from '../CesiumMapModel';
+interface MapInitialCenter {
+    longitude: number;
+    latitude: number;
+    height: number;
+}
+interface CesiumMapControllerOptions {
+    initialCenter?: MapInitialCenter;
+    /** 当前可用的地图类型列表（由外部维护），用于读取 maximumLevel 等配置 */
+    getMapTypes?: () => MapType[];
+    /** 获取当前底图类型 id（由外部维护） */
+    getCurrentMapTypeId?: () => string;
+    /** 获取当前天地图 token（用于从 provider 读取 maximumLevel 时保持行为一致） */
+    getToken?: () => string;
+    /** 获取当前天地图 sk（用于从 provider 读取 maximumLevel 时保持行为一致） */
+    getSk?: () => string | undefined;
+    /** 缩放回调（来自 Toolbar 的 ZoomCallback） */
+    zoomCallback?: ZoomCallback;
+    /** 场景模式切换后回调（例如通知 DrawHelper 重新计算偏移） */
+    onSceneModeChanged?: () => void;
+    /** 全屏切换回调 */
+    fullscreenCallback?: (isFullscreen: boolean) => void;
+    /** 复位位置回调 */
+    resetLocationCallback?: () => void;
+}
+/**
+ * 负责地图相机控制、缩放层级和 2D/3D 切换等逻辑的控制器
+ * 与 UI（工具栏）解耦，避免 Cesium 细节散落在各处。
+ */
+export declare class CesiumMapController {
+    private viewer;
+    private initialCenter?;
+    private getMapTypes?;
+    private getCurrentMapTypeId?;
+    private getToken?;
+    private getSk?;
+    private zoomCallback?;
+    private onSceneModeChanged?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
+    constructor(viewer: Viewer, options?: CesiumMapControllerOptions);
+    /**
+     * 监听相机缩放，限制层级范围到 [1, 18]，并参考当前底图的 maximumLevel
+     */
+    setupCameraZoomLimitListener(): void;
+    /**
+     * 获取当前地图层级（1-18）
+     */
+    getCurrentZoomLevel(): number;
+    /**
+     * 设置地图层级
+     * @param zoomLevel 目标层级（1-18）
+     */
+    setZoomLevel(zoomLevel: number): void;
+    /** 放大 */
+    zoomIn(): void;
+    /** 缩小 */
+    zoomOut(): void;
+    /**
+     * 2D/3D 切换
+     */
+    toggle2D3D(buttonElement: HTMLElement): void;
+    /**
+     * 复位到初始位置
+     */
+    resetLocation(): void;
+    setInitialCenter(center: MapInitialCenter): void;
+    getInitialCenter(): MapInitialCenter | undefined;
+    /**
+     * 切换全屏
+     */
+    toggleFullscreen(): void;
+    /**
+     * 检查是否处于全屏状态
+     */
+    isFullscreen(): boolean;
+    /**
+     * 进入全屏
+     */
+    enterFullscreen(): void;
+    /**
+     * 退出全屏
+     */
+    exitFullscreen(): void;
+}
+export {};

package/dist/libs/toolBar/MapLayersService.d.ts

@@ -0,0 +1,98 @@
+import { Viewer } from '../../../node_modules/cesium';
+import { MapType } from '../CesiumMapModel';
+import { I18nLike } from '../../libs/i18n';
+/**
+ * 图层服务配置接口
+ */
+export interface MapLayersServiceConfig {
+    mapTypes: MapType[];
+    currentMapType: string;
+    token: string;
+    sk?: string;
+    isNoFlyZoneChecked: boolean;
+    isNoFlyZoneVisible: boolean;
+    i18n?: I18nLike;
+    useI18n?: boolean;
+    onMapTypeChange?: (mapTypeId: string) => void;
+    onShowNoFlyZones?: () => Promise<void> | void;
+    onNoFlyZoneToggle?: (isChecked: boolean) => void;
+}
+/**
+ * 图层服务类
+ * 负责处理地图图层切换相关的所有逻辑
+ */
+export declare class MapLayersService {
+    private static readonly PLACE_NAME_LAYER_TAG;
+    private viewer;
+    private readonly defaultTerrainProvider;
+    private toolbarElement;
+    private config;
+    private currentGeoWTFS;
+    private currentMapTypeConfig;
+    private currentMapLayers;
+    private currentPlaceNameProvider;
+    private currentPlaceNameLayer;
+    private isPlaceNameChecked;
+    private i18n;
+    private useI18n;
+    constructor(viewer: Viewer, toolbarElement: HTMLElement, config: MapLayersServiceConfig);
+    /**
+     * 初始化当前地图上下文：用于“初始底图不是通过 switchMapType 加载”时的路网层识别。
+     */
+    private bootstrapCurrentMapContext;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<MapLayersServiceConfig>): void;
+    adjustMenuPosition: (menu: HTMLElement) => void;
+    /**
+     * 切换图层菜单
+     */
+    toggleLayers(buttonElement: HTMLElement): void;
+    /**
+     * 创建地图类型部分
+     */
+    private createMapTypeSection;
+    /**
+     * 创建地图类型项
+     */
+    private createMapTypeItem;
+    /**
+     * 创建叠加图层部分
+     */
+    private createOverlaySection;
+    /**
+     * 创建叠加图层项
+     */
+    private createOverlayItem;
+    /**
+     * 切换地图类型
+     */
+    switchMapType(mapTypeId: string): Promise<void>;
+    /**
+     * 获取当前地图类型
+     */
+    getCurrentMapType(): string;
+    private setPlaceNameChecked;
+    private ensureTDTPluginForMapType;
+    private syncGeoWTFSWithPlugin;
+    private shouldEnablePlaceName;
+    private isSameProvider;
+    private resolveExistingPlaceNameLayer;
+    private ensurePlaceNameProvider;
+    private addPlaceNameLayer;
+    private removePlaceNameLayer;
+    private shouldUse3DForCurrentMapType;
+    private ensure3DSceneIfNeeded;
+    private applyTerrainForMapType;
+    private syncGeoWTFS;
+    private destroyGeoWTFS;
+    /**
+     * 关闭图层菜单
+     */
+    closeLayersMenu(): void;
+    /**
+     * 销毁图层服务
+     */
+    destroy(): void;
+}