@jorgmoritz/gis-manager 0.1.21

package/dist/index.d.cts

@@ -0,0 +1,1891 @@
+import * as Cesium from 'cesium';
+export { V as VertexDetailInfo, a as VertexOperationInfo } from './VertexDetailInfo-BoVDy22s.cjs';
+
+interface InitOptions {
+    appName?: string;
+}
+interface VersionInfo {
+    name: string;
+    version: string;
+}
+interface CameraView {
+    destination: any;
+    heading?: number;
+    pitch?: number;
+    roll?: number;
+}
+type CameraDestinationInput = [number, number] | [number, number, number] | {
+    lon: number;
+    lat: number;
+    height?: number;
+} | {
+    lng: number;
+    lat: number;
+    height?: number;
+} | {
+    longitude: number;
+    latitude: number;
+    height?: number;
+};
+interface CameraOrientation {
+    heading?: number;
+    pitch?: number;
+    roll?: number;
+}
+interface CameraInitOptions {
+    destination: CameraDestinationInput;
+    height?: number;
+    orientation?: CameraOrientation;
+}
+interface CameraFlyOptions extends CameraInitOptions {
+    duration?: number;
+}
+interface CameraSetViewOptions {
+    destination: CameraDestinationInput;
+    orientation?: CameraOrientation;
+}
+type ImageryProviderKind = 'urlTemplate' | 'wmts' | 'wms' | 'arcgis';
+interface ImageryOptions {
+    provider: ImageryProviderKind;
+    url: string;
+    opacity?: number;
+    attribution?: string;
+    zIndex?: number;
+    zoomRange?: {
+        min?: number;
+        max?: number;
+    };
+    rectangle?: [number, number, number, number];
+    [key: string]: any;
+}
+type TerrainKind = 'cesium-ion' | 'url' | 'ellipsoid';
+interface TerrainOptions {
+    type: TerrainKind;
+    url?: string;
+    ionAssetId?: number;
+}
+
+declare const version: string;
+declare const versionInfo: {
+    name: string;
+    version: string;
+};
+
+interface CesiumAssetsOptions {
+    baseUrl: string;
+    ionToken?: string;
+}
+declare function configureCesiumAssets(opts: CesiumAssetsOptions): void;
+declare function getCesiumBaseUrl(): string | undefined;
+declare function assertCesiumAssetsConfigured(): void;
+/** Configure Cesium Ion token only. Safe to call before or after Cesium is imported. */
+declare function configureCesiumIonToken(token: string): void;
+declare function getCesiumIonToken(): string | undefined;
+/**
+ * Ensure the provided Cesium namespace uses the configured Ion token.
+ * This solves cases where the app's Cesium module instance differs from the one we can require(),
+ * especially under ESM bundlers. Call this with the Cesium instance actually used to construct Viewer.
+ */
+declare function ensureCesiumIonToken(CesiumNS: typeof Cesium): void;
+
+type Listener<T> = (payload: T) => void;
+declare class Emitter<T> {
+    private listeners;
+    on(fn: Listener<T>): () => void;
+    off(fn: Listener<T>): void;
+    emit(payload: T): void;
+    clear(): void;
+}
+/**
+ * 相机 FOV 变化事件
+ */
+interface CameraFOVChangeEvent {
+    /** 当前 FOV 值（度） */
+    fov: number;
+    /** 等效焦距（mm） */
+    focalLength: number;
+    /** 事件来源 */
+    source: 'controller' | 'preview' | 'frustum' | 'user';
+}
+/**
+ * 相机姿态变化事件
+ */
+interface CameraPoseChangeEvent {
+    /** 相机位置 */
+    position: any;
+    /** 航向角（度） */
+    heading: number;
+    /** 俯仰角（度） */
+    pitch: number;
+    /** 翻滚角（度） */
+    roll: number;
+    /** FOV（度） */
+    fov?: number;
+    /** 事件来源 */
+    source: 'preview' | 'frustum' | 'airplane' | 'user';
+}
+/**
+ * 视锥体形状变化事件
+ */
+interface FrustumShapeChangeEvent {
+    /** FOV（度） */
+    fov: number;
+    /** 视锥体长度（米） */
+    length: number;
+    /** 宽高比 */
+    aspectRatio: number;
+    /** 事件来源 */
+    source: 'controller' | 'user';
+}
+/**
+ * 全局事件总线
+ * 用于管理 CameraFOVController、PathPreview、FrustumPyramid 之间的通信
+ */
+declare class CameraEventBus {
+    /** FOV 变化事件 */
+    readonly onFOVChange: Emitter<CameraFOVChangeEvent>;
+    /** 相机姿态变化事件 */
+    readonly onPoseChange: Emitter<CameraPoseChangeEvent>;
+    /** 视锥体形状变化事件 */
+    readonly onFrustumShapeChange: Emitter<FrustumShapeChangeEvent>;
+    /**
+     * 清理所有监听器
+     */
+    destroy(): void;
+}
+/**
+ * 全局单例事件总线实例
+ * 用于跨组件通信
+ */
+declare const globalCameraEventBus: CameraEventBus;
+
+type LayerType = 'terrain' | 'imagery' | 'tileset' | 'datasource';
+interface LayerHandle {
+    id: string;
+    type: LayerType;
+    dispose(): void;
+}
+interface LayerEvents {
+    added: LayerHandle;
+    removed: LayerHandle;
+    error: {
+        id?: string;
+        error: unknown;
+    };
+}
+interface PhotoBillboardItem {
+    lon: number;
+    lat: number;
+    height?: number;
+    imgUrl: string;
+    name?: string;
+    id?: string;
+}
+interface PhotoBillboardLayerOptions {
+    items: PhotoBillboardItem[];
+    layerName?: string;
+    size?: number;
+    preloadImages?: boolean;
+}
+interface PhotoBillboardResult {
+    handle: LayerHandle;
+    dataSource: Cesium.CustomDataSource;
+    layerName: string;
+    added: number;
+    total: number;
+}
+declare class LayerManager {
+    private CesiumNS;
+    private viewer;
+    private imageryIdMap;
+    private tilesetIdMap;
+    private dataSourceIdMap;
+    private terrainId?;
+    events: Emitter<LayerEvents>;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer);
+    addDOM(options: ImageryOptions): LayerHandle | undefined;
+    addDEM(options: TerrainOptions): Promise<LayerHandle | undefined>;
+    addDSM(options: {
+        url: string;
+        show?: boolean;
+        maximumScreenSpaceError?: number;
+    }): Promise<LayerHandle | undefined>;
+    addPhotoBillboards(options: PhotoBillboardLayerOptions): Promise<PhotoBillboardResult | undefined>;
+    setVisible(id: string, visible: boolean): void;
+    setOpacity(id: string, opacity: number): void;
+    remove(id: string): void;
+    private composeImageWithBorder;
+    private createImageryProvider;
+    private createTerrain;
+    getImageryLayer(id: string): Cesium.ImageryLayer | undefined;
+    getTileset(id: string): Cesium.Cesium3DTileset | undefined;
+}
+
+type Toggle2D3DOptions = {
+    orthographicWidth?: number;
+    pitch3D?: number;
+    heading3D?: number;
+    roll3D?: number;
+    height3D?: number;
+    duration?: number;
+};
+type Orientation = {
+    heading: number;
+    pitch: number;
+    roll: number;
+};
+interface Toggle2D3DContext {
+    CesiumNS: typeof Cesium;
+    viewer: Cesium.Viewer;
+    getLastPerspectiveOrientation: () => Orientation | undefined;
+    setLastPerspectiveOrientation: (o: Orientation | undefined) => void;
+}
+/**
+ * Toggle between 3D and 2D scene modes with orientation preservation on return to 3D.
+ * This utility is framework-agnostic and only depends on Cesium viewer and a tiny state bridge.
+ */
+declare function toggle2D3D(ctx: Toggle2D3DContext, options?: Toggle2D3DOptions): void;
+
+interface FlyToOptions {
+    duration?: number;
+}
+interface PathOptions {
+    speed?: number;
+    loop?: boolean;
+}
+declare class CameraManager {
+    private CesiumNS;
+    private viewer;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer);
+    private _lastPerspectiveOrientation?;
+    private _isBirdsEyeView;
+    private _beforeBirdsEye?;
+    private parseLonLat;
+    initCamera(destination: CameraDestinationInput | CameraFlyOptions, height?: number, orientation?: CameraOrientation): void;
+    setPerspective(): void;
+    setOrthographic(width?: number): void;
+    /**
+     * Toggle between 2D and 3D scene modes while preserving and restoring a 3D orientation.
+     */
+    toggle2D3D(options?: Toggle2D3DOptions): void;
+    /**
+     * @deprecated Use toggle2D3D instead.
+     */
+    toggleBirdsEye3D(options?: Toggle2D3DOptions): void;
+    /**
+     * 切换鸟瞰视角（垂直俯视）
+     * 在当前3D场景中切换到垂直向下的俯视角度，并可选择使用正交投影
+     *
+     * @param options 配置选项
+     * @param options.useOrthographic 是否使用正交投影（默认false，使用透视投影）
+     * @param options.height 鸟瞰高度（米，默认自动计算）
+     * @param options.orthographicWidth 正交视图宽度（米，默认1000000）
+     * @param options.duration 飞行动画时长（秒，默认1.0）
+     *
+     * @example
+     * ```typescript
+     * // 切换到鸟瞰视角（透视投影）
+     * cameraManager.toggleBirdsEyeView();
+     *
+     * // 切换到鸟瞰视角（正交投影）
+     * cameraManager.toggleBirdsEyeView({ useOrthographic: true });
+     *
+     * // 自定义高度和宽度
+     * cameraManager.toggleBirdsEyeView({
+     *   useOrthographic: true,
+     *   height: 50000,
+     *   orthographicWidth: 500000
+     * });
+     * ```
+     */
+    toggleBirdsEyeView(options?: {
+        useOrthographic?: boolean;
+        height?: number;
+        orthographicWidth?: number;
+        duration?: number;
+    }): void;
+    /**
+     * 进入鸟瞰视角
+     */
+    private enterBirdsEyeView;
+    flyToSimple(lon: number, lat: number, height?: number): void;
+    /**
+     * 从鸟瞰视角恢复
+     */
+    private restoreFromBirdsEye;
+    /**
+     * 设置为鸟瞰视角（不切换，直接设置）
+     *
+     * @param options 配置选项
+     * @param options.useOrthographic 是否使用正交投影
+     * @param options.height 鸟瞰高度
+     * @param options.orthographicWidth 正交视图宽度
+     */
+    setBirdsEyeView(options?: {
+        useOrthographic?: boolean;
+        height?: number;
+        orthographicWidth?: number;
+    }): void;
+    /**
+     * 检查当前是否处于鸟瞰视角
+     */
+    isBirdsEyeView(): boolean;
+    setView(view: CameraView): void;
+    moveToChengdu(): void;
+    isitwork(): void;
+    setViewEasy(args: {
+        destination: CameraDestinationInput;
+        orientation?: CameraOrientation;
+    }): void;
+    flyToTerrain(bounds: [number, number, number, number], tp: Cesium.CesiumTerrainProvider): Promise<void>;
+    flyToEasy(destination: CameraDestinationInput | CameraFlyOptions, heightOrOrientation?: number | CameraOrientation, orientationOrDuration?: CameraOrientation | number, duration?: number): void;
+    flyTo(view: CameraView, opts?: FlyToOptions): void;
+    lookAt(target: any, offset?: any): void;
+    zoom(delta: number): void;
+    pan(dx: number, dy: number): void;
+    followPath(positions: any[], opts?: PathOptions): Promise<void>;
+    flyToRectangle(rect: Cesium.Rectangle, opts?: FlyToOptions & {
+        heading?: number;
+        pitch?: number;
+        roll?: number;
+        zoomScale?: number;
+    }): void;
+    focusOnImageryLayer(layer: Cesium.ImageryLayer, opts?: FlyToOptions & {
+        heading?: number;
+        pitch?: number;
+        roll?: number;
+        height?: number;
+        zoomScale?: number;
+    }): void;
+    /**
+     * fly to with promise
+     * @param view
+     * @param opts
+     * @returns
+     */
+    private flyToAsync;
+}
+
+interface SceneOptions {
+    container: string | HTMLElement;
+    imagery?: ImageryOptions;
+    terrain?: TerrainOptions;
+    initialCamera?: CameraView | CameraInitOptions;
+    sunlight?: {
+        enabled: boolean;
+        time?: Date;
+    };
+    shadows?: boolean;
+    viewerOptions?: Cesium.Viewer.ConstructorOptions;
+}
+declare class SceneManager {
+    private CesiumNS;
+    private viewer;
+    private layerManager;
+    private cameraManager;
+    constructor(CesiumNS: typeof Cesium, options: SceneOptions);
+    getViewer(): Cesium.Viewer;
+    /**
+     * Set a black background for areas without imagery. Optionally clear existing base imagery layers.
+     */
+    useBlackBackground(removeAllImagery?: boolean): void;
+    destroy(): void;
+    configureSunlight(enabled: boolean, datetime?: Date): void;
+    setShadows(enabled: boolean): void;
+    setInitialCamera(view: CameraView | CameraInitOptions): void;
+    getCameraManager(): CameraManager;
+    getLayerManager(): LayerManager;
+    setBaseImagery(url: string, layer_id: string, opts?: Omit<ImageryOptions, 'url'>): Cesium.ImageryLayer | undefined;
+    set3DTiles(url: string, layer_id: string): Promise<any | undefined>;
+    setTerrain(options: TerrainOptions): Promise<Cesium.TerrainProvider | undefined>;
+    addDSM(options: {
+        url: string;
+        show?: boolean;
+        maximumScreenSpaceError?: number;
+    }): Promise<LayerHandle | undefined>;
+    private resolveContainer;
+    private applyImagery;
+    private apply3Dtiles;
+    private applyTerrain;
+}
+
+/**
+ * Sinofly 航点信息接口
+ */
+interface SinoflyWaypointInfo {
+    waypointId: number | string;
+    waylineId: number | string;
+    index: number;
+    latitude: string;
+    longitude: string;
+    altitude: string;
+    action: string;
+    noReturn: number;
+    createUserId?: string;
+    createTime?: string;
+    modifyUserId?: string;
+    modifyTime?: string;
+}
+/**
+ * Sinofly 航线路数据结构接口
+ */
+interface SinoflyWaylineData {
+    waylineId: number | string;
+    waylineName: string;
+    waylineType: number;
+    waylineVersion: string;
+    source: number;
+    heightType?: string;
+    droneModelKey: number | string;
+    relativeHeight: number;
+    autoFlightSpeed: number;
+    takeOffSecurityHeight: number;
+    globalRthHeight: number;
+    fileId: number | string;
+    fileMd5: string;
+    distance: number;
+    duration: number;
+    waypointNumber: number;
+    photoNumber: number;
+    createUserId?: string;
+    createTime?: string;
+    modifyUserId?: string;
+    modifyTime?: string;
+    stationId?: number;
+    subarrayId?: number;
+    stationName?: string;
+    subarrayName?: string;
+    /** 起始点位置坐标（Cartesian3 序列化后的字符串，JSON 格式包含 longitude/latitude/height） */
+    takeOffRefPoint?: string;
+    thumbnailFileId?: number;
+    waypointInfo: SinoflyWaypointInfo[];
+}
+/**
+ * 转换后的航点数据格式（用于 renderFlightPath）
+ */
+interface ConvertedWaypointData {
+    position: Cesium.Cartesian3;
+    heading: number;
+    pitch: number;
+    roll: number;
+    fov: number;
+    index: number;
+}
+/**
+ * 转换后的航线路数据格式
+ */
+interface ConvertedWaylineData {
+    id?: string;
+    name?: string;
+    description?: string;
+    waypointData: ConvertedWaypointData[];
+    metadata?: {
+        waylineId: number | string;
+        waylineType: number;
+        waylineVersion: string;
+        relativeHeight: number;
+        autoFlightSpeed: number;
+        distance: number;
+        duration: number;
+        stationId?: number;
+        subarrayId?: number;
+        stationName?: string;
+        subarrayName?: string;
+        takeOffSecurityHeight?: number;
+        hasTakeOffRefPoint?: boolean;
+        [key: string]: any;
+    };
+}
+/**
+ * Sinofly 数据适配器配置选项
+ */
+interface SinoflyAdapterOptions {
+    /**
+     * Cesium 命名空间（用于创建 Cartesian3）
+     */
+    CesiumNS: typeof Cesium;
+    /**
+     * 默认航向角（度），默认 0
+     */
+    defaultHeading?: number;
+    /**
+     * 默认俯仰角（度），默认 -10
+     */
+    defaultPitch?: number;
+    /**
+     * 默认横滚角（度），默认 0
+     */
+    defaultRoll?: number;
+    /**
+     * 默认视场角（度），默认 50
+     */
+    defaultFov?: number;
+    /**
+     * 是否从 action 字段解析姿态信息（默认 true）
+     * 如果为 true，会尝试从 action JSON 字符串中解析姿态信息：
+     * - heading: 从 rotateYaw 或 rotateYaw.aircraftHeading 获取
+     * - pitch: 从 gimbalRotate 或 gimbalRotate.gimbalPitchRotateAngle 获取
+     * - fov: 从 zoom 或 zoom.focalLength 获取
+     * - roll: 保持默认值（Sinofly 数据中通常不包含 roll 信息）
+     */
+    parseActionForPose?: boolean;
+    /**
+     * 是否按 index 排序航点（默认 true）
+     */
+    sortByIndex?: boolean;
+    /**
+     * 自定义航点过滤函数，返回 false 的航点将被过滤
+     */
+    filterWaypoint?: (waypoint: SinoflyWaypointInfo, index: number) => boolean;
+}
+/**
+ * 将 Sinofly 航线路数据转换为本库所需的数据格式
+ *
+ * @param data Sinofly 航线路数据
+ * @param options 适配器配置选项
+ * @returns 转换后的航线路数据
+ *
+ * @example
+ * ```typescript
+ * import * as Cesium from 'cesium';
+ * import { convertSinoflyWayline } from '@jorgmoritz/gis-manager';
+ *
+ * const sinoflyData = {
+ *   waylineId: 1,
+ *   waylineName: "测试航线",
+ *   waypointInfo: [
+ *     {
+ *       index: 0,
+ *       latitude: "39.9042",
+ *       longitude: "116.4074",
+ *       altitude: "100.0",
+ *       action: JSON.stringify({
+ *         rotateYaw: { aircraftHeading: 45 },
+ *         gimbalRotate: { gimbalPitchRotateAngle: -10 },
+ *         zoom: { focalLength: 50 }
+ *       })
+ *     }
+ *   ]
+ * };
+ *
+ * const converted = convertSinoflyWayline(sinoflyData, {
+ *   CesiumNS: Cesium,
+ *   // parseActionForPose 默认为 true，会自动从 action 中解析姿态信息
+ *   defaultHeading: 0,  // 如果 action 中没有 rotateYaw，使用此默认值
+ *   defaultPitch: -10,  // 如果 action 中没有 gimbalRotate，使用此默认值
+ *   defaultRoll: 0,
+ *   defaultFov: 50      // 如果 action 中没有 zoom，使用此默认值
+ * });
+ *
+ * // 使用转换后的数据
+ * czmlPathManager.renderFlightPath({
+ *   id: converted.id,
+ *   name: converted.name,
+ *   waypointData: converted.waypointData,
+ *   description: converted.description
+ * });
+ * ```
+ */
+declare function convertSinoflyWayline(data: SinoflyWaylineData, options: SinoflyAdapterOptions): ConvertedWaylineData;
+/**
+ * 批量转换多个 Sinofly 航线路
+ *
+ * @param dataList Sinofly 航线路数据数组
+ * @param options 适配器配置选项
+ * @returns 转换后的航线路数据数组
+ *
+ * @example
+ * ```typescript
+ * const results = convertSinoflyWaylines(
+ *   [wayline1, wayline2, wayline3],
+ *   { CesiumNS: Cesium }
+ * );
+ *
+ * results.forEach(result => {
+ *   if (result.success) {
+ *     czmlPathManager.renderFlightPath({
+ *       waypointData: result.data.waypointData,
+ *       name: result.data.name
+ *     });
+ *   } else {
+ *     console.error('转换失败:', result.error);
+ *   }
+ * });
+ * ```
+ */
+declare function convertSinoflyWaylines(dataList: SinoflyWaylineData[], options: SinoflyAdapterOptions): Array<{
+    success: boolean;
+    data?: ConvertedWaylineData;
+    error?: string;
+    waylineId?: number | string;
+}>;
+
+/**
+ * 回显飞航路线的选项类型
+ */
+interface RenderFlightPathOptions {
+    /** Sinofly 航线路数据 */
+    data: SinoflyWaylineData;
+    /** Sinofly 适配器配置选项 */
+    adapterOptions?: Omit<SinoflyAdapterOptions, 'CesiumNS'>;
+    id?: string;
+    name?: string;
+    description?: string;
+    layer?: Cesium.CustomDataSource;
+    style?: {
+        width?: number;
+        color?: Cesium.Color;
+        material?: Cesium.MaterialProperty | Cesium.Color;
+    };
+    hasHiddenClimb?: boolean;
+    altitudeMode?: string;
+    climbHeight?: number;
+}
+
+type PathSample = {
+    time: Cesium.JulianDate | Date | string | number;
+    lon: number;
+    lat: number;
+    height?: number;
+} | [Cesium.JulianDate | Date | string | number, number, number, number?];
+interface PathStyleOptions {
+    width?: number;
+    color?: Cesium.Color;
+    material?: Cesium.MaterialProperty | Cesium.Color;
+    leadTime?: number;
+    trailTime?: number;
+    resolution?: number;
+}
+
+interface CzmlImportOptions {
+}
+interface CzmlExportOptions {
+    name?: string;
+}
+interface ShapePointProps {
+    id?: string;
+    lon: number;
+    lat: number;
+    height?: number;
+    name?: string;
+    description?: string;
+}
+interface ShapeLineProps {
+    id?: string;
+    coords: Array<[number, number, number?]>;
+    name?: string;
+    description?: string;
+}
+interface ShapePolygonProps {
+    id?: string;
+    coords: Array<[number, number, number?]>;
+    name?: string;
+    description?: string;
+}
+type Entity = Cesium.Entity;
+type LonLatHeight = {
+    lon: number;
+    lat: number;
+    height: number | null;
+};
+declare class CZMLManager {
+    private CesiumNS;
+    private viewer;
+    private currentSelectedEntity;
+    private activePolygonSession;
+    private polygonSessionCleanup?;
+    constructor(CesiumNS: typeof Cesium, viewer: Cesium.Viewer);
+    private _polygonEditor?;
+    private get polygonEditor();
+    private _pathMgr?;
+    private get pathMgr();
+    importCZML(czml: any | URL, _opts?: CzmlImportOptions): Promise<any>;
+    exportCZML(entities: Entity[] | Cesium.EntityCollection, opts?: CzmlExportOptions): any[];
+    /**
+     * 回显飞航路线：显示完整飞航路线、航点编号和起始点箭头
+     *
+     * 接收 Sinofly 航线路数据，自动转换为本库格式并渲染显示。
+     * 请使用 pathMgr.renderFlightPath() 方法或直接导入 renderFlightPath 函数。
+     *
+     * @deprecated 请使用 pathMgr.renderFlightPath() 或直接导入 renderFlightPath 函数
+     * @param options Sinofly 数据和配置选项
+     * @returns 创建的 polyline 实体
+     *
+     * @example
+     * ```typescript
+     * // 推荐方式 1: 使用 pathMgr
+     * const entity = czmlManager.pathMgr.renderFlightPath(Cesium, viewer, {
+     *   data: sinoflyData
+     * });
+     *
+     * // 推荐方式 2: 直接导入函数
+     * import { renderFlightPath } from '@jorgmoritz/gis-manager';
+     * const entity = renderFlightPath(Cesium, viewer, {
+     *   data: sinoflyData
+     * });
+     * ```
+     */
+    renderFlightPath(options: RenderFlightPathOptions): Entity;
+    addPathSample(entityOrId: Entity | string, sample: PathSample): void;
+    addPathSamples(entityOrId: Entity | string, samples: PathSample[]): void;
+    setPathSamples(entityOrId: Entity | string, samples: PathSample[]): void;
+    clearPathSamples(entityOrId: Entity | string): void;
+    setPathStyle(entityOrId: Entity | string, style: PathStyleOptions): void;
+    startPathDrawing(options?: {
+        layer?: Cesium.CustomDataSource;
+        idPrefix?: string;
+        defaultHeight?: number;
+        width?: number;
+        material?: Cesium.MaterialProperty | Cesium.Color;
+    }, onComplete?: (entity: Entity) => void): {
+        stop: () => void;
+    };
+    startPathEditing(entityOrId: Entity | string, options?: {
+        layer?: Cesium.CustomDataSource;
+        defaultHeight?: number;
+        width?: number;
+        material?: Cesium.MaterialProperty | Cesium.Color;
+    }): {
+        stop: () => void;
+    } | undefined;
+    addPoint(props: ShapePointProps): Entity;
+    addLine(props: ShapeLineProps): Entity;
+    addPolygon(props: ShapePolygonProps): Entity;
+    /**
+     * 创建一个新的自定义图层用于存放多边形实体。
+     * @param name 自定义图层名称:string，默认值为'Polygons'
+     * @returns 自定义图层对象
+     */
+    createPolygonLayer(name?: string): Cesium.CustomDataSource;
+    /**
+     * 多边形绘制会话管理接口，创建一个polygon绘制对话，允许用户通过鼠标交互绘制多边形。
+     * @param type 图层类型 ('subarray' | 'inverter' | 'other')
+     * @param onComplete 结果回调函数，参数为新创建的多边形实体
+     * @returns 返回一个polygon绘制会话对象
+     */
+    startPolygonDrawing(type: string, onComplete?: (entity: Entity) => void): any;
+    /**
+     * 圆形绘制会话管理接口，创建一个圆形绘制对话，允许用户通过鼠标交互绘制圆形。
+     * 使用流程:
+     * 1. 左键点击确定圆心
+     * 2. 移动鼠标动态调整半径
+     * 3. 再次左键点击确定半径，完成绘制
+     * 4. 或右键/ESC取消绘制
+     *
+     * @param onComplete 结果回调函数，参数为新创建的圆形实体
+     * @returns 返回一个圆形绘制会话对象，包含 stop() 方法
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 startCircleDrawing 方法
+     */
+    startCircleDrawing(onComplete?: (entity: Entity) => void): any;
+    /**
+     * 点标记绘制会话管理接口，创建一个点标记绘制对话，允许用户通过鼠标交互连续添加点标记。
+     * 使用流程:
+     * 1. 左键点击地图添加点标记
+     * 2. 可连续点击添加多个点
+     * 3. 右键或 ESC 结束绘制
+     *
+     * @param iconSvg SVG 图标的 data URL 或路径
+     * @param onComplete 每次添加点时的回调函数（可选）
+     * @returns 返回一个点标记绘制会话对象，包含 stop() 方法
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 startPointDrawing 方法
+     */
+    startPointDrawing(iconSvg?: string, onComplete?: (entity: Entity) => void): any;
+    startPolygonEditing(entityOrId?: Entity | string | undefined | null, onComplete?: (entity: Entity) => void): any;
+    private ensurePolygonSessionHooks;
+    private cancelActivePolygonDrawing;
+    /**
+     * 删除一个 polygon 实体及其 outline
+     * @param entityOrId 要删除的实体,或实体 ID,或 undefined 使用当前选中的实体
+     * @param onComplete 删除完成后的回调函数
+     * @returns 是否成功删除
+     */
+    startPolygonDeleting(entityOrId?: Entity | string | undefined | null, onComplete?: (entity: Entity) => void): boolean;
+    updateEntity(id: string, patch: Partial<{
+        name: string;
+        description: string;
+    }>): void;
+    deleteEntity(id: string): void;
+    listEntities(): Entity[];
+    /**
+     * 获取实体的经纬度与地形高数组（仅外环/各点/单点）。
+     * - 地形高来自 viewer.scene.globe.getHeight(carto)
+     * - 高度保留 3 位小数；若为负数则置为 0
+     * - 无法获取地形高时 height 为 null
+     *
+     * 支持的实体类型：polygon（仅外环）、polyline、point/billboard
+     */
+    getEntityLonLatTerrainHeightArray(entity: any): LonLatHeight[];
+    getEntityDataSource(entity: any): Cesium.DataSource | null;
+    /**
+     * 选择一个 polygon 实体并高亮显示
+     * 新逻辑：
+     * - 只对 subarray 和 inverter 图层的多边形生效
+     * - 设置 checked=true，使用 type 对应的高亮颜色（faceColor 和 lineColor）
+     * - faceColor：鲜艳的填充色（用于高亮）
+     * - lineColor：鲜艳的轮廓线色（用于高亮）
+     *
+     * @param entity 要选择的实体,如果为 null 则取消当前选择
+     * @returns 是否成功选择
+     */
+    selectPolygonEntity(entity: Entity | null): boolean;
+    /**
+     * 检查当前是否处于多边形绘制模式
+     * @returns 如果正在绘制多边形则返回 true
+     */
+    isDrawingActive(): boolean;
+    /**
+     * 检查当前是否处于多边形编辑模式
+     * @returns 如果正在编辑多边形则返回 true
+     */
+    isEditingActive(): boolean;
+    /**
+     * 清除当前的 polygon 选择状态
+     * 新逻辑：
+     * - 设置 checked=false
+     * - 恢复为对应 type 的默认颜色（faceFinalColor 和 lineFinalColor）
+     * - faceFinalColor：较淡的填充色（默认状态）
+     * - lineFinalColor：较淡的轮廓线色（默认状态）
+     *
+     * @returns 是否成功清除
+     */
+    clearPolygonSelection(): boolean;
+    /**
+     * 获取当前选中的 polygon 实体
+     * @returns 当前选中的实体,如果没有则返回 null
+     */
+    getSelectedPolygonEntity(): Entity | null;
+    /**
+     * 从点位数组创建一个多边形及其轮廓线和标签
+     * @param options 创建选项
+     *   - layerName: 图层名称 ('subarray' 或 'inverter')
+     *   - id: 实体ID
+     *   - name: 实体名称
+     *   - points: 点位数组 [{ lon, lat, height }]
+     * @returns 创建的主多边形实体
+     */
+    createPolygonFromPoints(options: {
+        layerName: 'subarray' | 'inverter';
+        id: string;
+        name: string;
+        points: Array<{
+            lon: number;
+            lat: number;
+            height?: number;
+        }>;
+    }): Entity | null;
+    /**
+     * 确保 inverter 图层始终在最上层
+     */
+    ensureInverterLayerOnTop(): void;
+    /**
+     * 分析子阵和组串的层级关系,并自动重新编码
+     * 代理到 PolygonEditor.analyzeAndEncodePolygonHierarchy()
+     * @param targetSubarrayEntity - 可选,指定要处理的子阵实体。如果提供,则只处理该子阵及其内部组串
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 analyzeAndEncodePolygonHierarchy 方法
+     */
+    analyzeAndEncodePolygonHierarchy(targetSubarrayEntity?: any): any;
+    /**
+     * 还原多边形的原始名称
+     * 代理到 PolygonEditor.restoreOriginalNames()
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 restoreOriginalNames 方法
+     */
+    restoreOriginalNames(): any;
+    /**
+     * 仅分析多边形层级关系,不修改名称
+     * 代理到 PolygonEditor.getPolygonHierarchyWithoutEncoding()
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 getPolygonHierarchyWithoutEncoding 方法
+     */
+    getPolygonHierarchyWithoutEncoding(): any;
+    /**
+     * 导出指定子阵及其内部组串的层级结构
+     * 代理到 PolygonEditor.exportSingleSubarrayHierarchy()
+     * @param subarrayEntity - 要导出的子阵实体
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 exportSingleSubarrayHierarchy 方法
+     */
+    exportSingleSubarrayHierarchy(subarrayEntity: any): any;
+    /**
+     * 导出指定组串的扁平结构
+     * 代理到 PolygonEditor.exportSingleInverter()
+     * @param inverterEntity - 要导出的组串实体
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 exportSingleInverter 方法
+     */
+    exportSingleInverter(inverterEntity: any): any;
+    /**
+     * 从 JSON 数据批量创建多边形(层级结构)
+     * 代理到 PolygonEditor.importPolygonsFromHierarchy()
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 importPolygonsFromHierarchy 方法
+     */
+    importPolygonsFromHierarchy(data: any): any;
+    /**
+     * 从 JSON 数据批量创建多边形(扁平结构)
+     * 代理到 PolygonEditor.importPolygonsFromFlatStructure()
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 importPolygonsFromFlatStructure 方法
+     */
+    importPolygonsFromFlatStructure(data: any): any;
+    /**
+     * 更新多边形实体的类型、颜色和标签
+     * 代理到 PolygonEditor.updatePolygonTypeAndStyle()
+     * @param entity 要更新的多边形实体
+     * @param newType 新的类型 ('subarray' | 'inverter' | 'astrict' | 'rail' | 'feature')
+     * @param customName 可选的自定义名称
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 updatePolygonTypeAndStyle 方法
+     */
+    updatePolygonTypeAndStyle(entity: any, newType: string, customName?: string): any;
+    /**
+     * 从 JSON 数据加载 other 图层 (多边形、圆形、特征点)
+     * 代理到 PolygonEditor.loadOtherLayerFromJson()
+     * @param data JSON 数据,包含 astrict, rail, feature, feature_point 数组
+     *
+     * ⚠️ 注意：此方法需要 PolygonEditor 实现 loadOtherLayerFromJson 方法
+     */
+    loadOtherLayerFromJson(data: {
+        astrict?: Array<any>;
+        rail?: Array<any>;
+        feature?: Array<any>;
+        feature_point?: Array<any>;
+    }): any;
+    /**
+     * 计算多边形的周长和面积（忽略高度值）
+     * 代理到 PolygonEditor.calculatePolygonPerimeterAndArea()
+     * @param points 点位数组 [{ lon, lat, height }]
+     * @returns { perimeter: 周长(米), area: 面积(平方米) }
+     */
+    calculatePolygonPerimeterAndArea(points: Array<{
+        lon: number;
+        lat: number;
+        height?: number;
+    }>): {
+        perimeter: number;
+        area: number;
+    };
+}
+
+type Viewer$1 = Cesium.Viewer;
+interface PolygonDrawingOptions {
+    layer?: Cesium.CustomDataSource;
+    idPrefix?: string;
+}
+interface PolygonEditingSession {
+    stop: () => void;
+}
+declare class PolygonEditor {
+    private CesiumNS;
+    private viewer;
+    private handler?;
+    private drawingPositions;
+    private tempPolyline?;
+    private tempPolygon?;
+    private drawHandles;
+    private rubberBandPoint?;
+    private editHandles;
+    private draggingIndex;
+    private originalPositionOnDrag?;
+    private segmentHighlight?;
+    private editOutline?;
+    private insertPreviewHandle?;
+    private keydownHandler?;
+    private originalPolygonNames;
+    constructor(CesiumNS: typeof Cesium, viewer: Viewer$1);
+    /**
+     * 根据图层名称获取颜色配置
+     * @param layerName 图层名称 ('subarray' | 'inverter' | 其他)
+     * @returns 颜色配置对象
+     */
+    getColorConfig(layerName: string): {
+        lineColor: any;
+        lineFinalColor: any;
+        faceColor: any;
+        faceFinalColor: any;
+        pointColor: any;
+    };
+    private getPositionFromMouse;
+    /**
+     *
+     * @param fn 计算属性函数
+     * @returns 计算函数返回值的CallbackProperty对象
+     */
+    private makeCallback;
+    /**
+     * 生成复杂唯一的 Entity ID
+     * 格式: {timestamp}-{random}
+     */
+    private generateUniqueId;
+    /**
+     * 将轮廓线设置为虚线样式（公用方法）
+     */
+    applyDashedOutlineStyle(outlineEntity: any, color: any, width?: number, dashLength?: number): void;
+    /**
+     * 清除所有图层中多边形的高亮状态
+     */
+    private clearAllPolygonHighlights;
+    /**
+     * 创建轮廓线实体
+     */
+    private createOutlineEntity;
+    /**
+     * 创建标签实体
+     */
+    private createLabelEntity;
+    /**
+     * 清理临时绘制元素
+     */
+    private cleanupDrawingTemporaries;
+    /**
+     * 设置键盘事件监听器（ESC/X 键）
+     */
+    private setupKeyboardListener;
+    /**
+     * 移除键盘事件监听器
+     */
+    private removeKeyboardListener;
+    /**
+     * 销毁事件处理器
+     */
+    private destroyHandler;
+    /**
+     * 完成编辑/绘制的通用清理逻辑
+     */
+    private finalizePolygonSession;
+    /**
+     * 创建polygon绘制会话，允许用户通过鼠标交互绘制多边形。
+     * @param type 多边形类型
+     * @param layer 自定义图层对象
+     * @param onComplete 结果回调函数，参数为新创建的多边形实体
+     * @returns 返回一个polygon绘制会话对象
+     */
+    startDrawing(type: string, layer?: Cesium.CustomDataSource, onComplete?: (entity: Cesium.Entity) => void): {
+        stop: () => void;
+    };
+    private stopInternal;
+    /**
+     * 开始编辑多边形
+     * @param polygonEntity 要编辑的多边形实体
+     * @param layer 多边形所属的图层
+     * @param onComplete 编辑完成回调函数
+     * @returns 返回编辑会话对象
+     */
+    startEditing(polygonEntity: Cesium.Entity, layer: Cesium.CustomDataSource, onComplete?: (entity: Cesium.Entity) => void): PolygonEditingSession;
+    private cleanupHandles;
+    /**
+     * 计算多边形的周长和面积
+     */
+    calculatePolygonPerimeterAndArea(points: Array<{
+        lon: number;
+        lat: number;
+        height?: number;
+    }>): {
+        perimeter: number;
+        area: number;
+    };
+    /**
+     * 从点位数组创建一个多边形及其轮廓线和标签
+     * @param options 创建选项
+     *   - layer: 目标图层 (CustomDataSource)
+     *   - id: 实体ID
+     *   - name: 实体名称
+     *   - points: 点位数组 [{ lon, lat, height }]
+     * @returns 创建的主多边形实体,如果失败则返回 null
+     */
+    createPolygonFromPoints(options: {
+        layer: Cesium.CustomDataSource;
+        id: string;
+        name: string;
+        points: Array<{
+            lon: number;
+            lat: number;
+            height?: number;
+        }>;
+    }): Cesium.Entity | null;
+    /**
+     * 辅助方法：从实体中提取经纬度高度数组
+     * @param entity 多边形实体
+     * @returns 点位数组 [{ lon, lat, height }]
+     */
+    private getEntityLonLatTerrainHeightArray;
+    /**
+     * 辅助方法：获取实体所属的 DataSource
+     * @param entity 实体对象
+     * @returns DataSource 或 undefined
+     */
+    private getEntityDataSource;
+    /**
+     * 分析子阵和组串的层级关系,并自动重新编码
+     *
+     * 功能说明：
+     * 1. 收集所有 subarray 和 inverter 多边形 (或仅处理指定的子阵)
+     * 2. 使用射线法判断 inverter 是否在 subarray 内部
+     * 3. 构建层级关系数据结构
+     * 4. 按空间位置排序（从北到南、从东到西）
+     * 5. 重新编码：
+     *    - 子阵: #01, #02, #03, ...
+     *    - 子阵内组串: G1.1.1, G1.1.2, ..., G1.1.99, G1.2.1, ...
+     *    - 独立组串: GX.1.1, GX.1.2, ..., GX.1.99, GX.2.1, ...
+     * 6. 保存原始名称用于还原
+     *
+     * @param targetSubarrayEntity - 可选,指定要处理的子阵实体。如果提供,则只处理该子阵及其内部组串
+     * @returns 编码结果对象,包含成功状态、统计信息、层级关系等
+     */
+    analyzeAndEncodePolygonHierarchy(targetSubarrayEntity?: any): {
+        success: boolean;
+        subarrayCount: number;
+        inverterCount: number;
+        independentCount: number;
+        savedNamesCount: number;
+        hierarchy?: {
+            subarrays: Array<{
+                id: string;
+                name: string;
+                oldName?: string;
+                inverters: Array<{
+                    id: string;
+                    name: string;
+                    oldName?: string;
+                }>;
+            }>;
+            independentInverters?: Array<{
+                id: string;
+                name: string;
+                oldName?: string;
+            }>;
+        };
+        recodingResult?: Array<{
+            oldId: string;
+            oldName: string;
+            newCode: string;
+            subarraySeq: number | string;
+            subarrayName: string;
+            globalIndex: number;
+            isIndependent?: boolean;
+        }>;
+        error?: string;
+    };
+    /**
+     * 还原多边形的原始名称
+     *
+     * 功能说明：
+     * 1. 检查是否有保存的原始名称
+     * 2. 遍历所有保存的实体并还原名称
+     * 3. 同步更新关联的 label 文本
+     * 4. 还原后清空映射表
+     *
+     * @returns 还原结果对象,包含成功状态、统计信息等
+     */
+    restoreOriginalNames(): {
+        success: boolean;
+        restoredCount: number;
+        notFoundCount: number;
+        message?: string;
+    };
+    /**
+     * 仅分析多边形层级关系,不修改名称
+     *
+     * 功能说明：
+     * 1. 收集所有 subarray 和 inverter 多边形
+     * 2. 使用射线法判断 inverter 是否在 subarray 内部
+     * 3. 构建层级关系数据结构
+     * 4. 不进行任何重新编码操作,保持原始名称
+     * 5. 按当前名称组织层级结构
+     *
+     * @returns 层级关系对象,包含成功状态和层级数据
+     */
+    getPolygonHierarchyWithoutEncoding(): {
+        success: boolean;
+        subarrayCount: number;
+        inverterCount: number;
+        independentCount: number;
+        hierarchy?: {
+            subarrays: Array<{
+                id: string;
+                name: string;
+                points: Array<{
+                    lon: number;
+                    lat: number;
+                    height: number;
+                }>;
+                inverters: Array<{
+                    id: string;
+                    name: string;
+                    points: Array<{
+                        lon: number;
+                        lat: number;
+                        height: number;
+                    }>;
+                }>;
+            }>;
+            independentInverters: Array<{
+                id: string;
+                name: string;
+                points: Array<{
+                    lon: number;
+                    lat: number;
+                    height: number;
+                }>;
+            }>;
+        };
+        error?: string;
+    };
+    /**
+     * 导出指定子阵及其内部组串的层级结构
+     *
+     * @param subarrayEntity - 要导出的子阵实体
+     * @returns 导出结果,包含该子阵及其内部组串的层级结构
+     */
+    exportSingleSubarrayHierarchy(subarrayEntity: any): {
+        success: boolean;
+        subarrayCount: number;
+        inverterCount: number;
+        hierarchy?: {
+            subarrays: Array<{
+                id: string;
+                name: string;
+                points: Array<{
+                    lon: number;
+                    lat: number;
+                    height: number;
+                }>;
+                inverters: Array<{
+                    id: string;
+                    name: string;
+                    points: Array<{
+                        lon: number;
+                        lat: number;
+                        height: number;
+                    }>;
+                }>;
+            }>;
+            independentInverters: Array<any>;
+        };
+        error?: string;
+    };
+    /**
+     * 导出指定组串的扁平结构
+     *
+     * @param inverterEntity - 要导出的组串实体
+     * @returns 导出结果,包含该组串的扁平结构数据
+     */
+    exportSingleInverter(inverterEntity: any): {
+        success: boolean;
+        data: {
+            subarray: Array<any>;
+            inverter: Array<{
+                id: string;
+                name: string;
+                points: Array<{
+                    lon: number;
+                    lat: number;
+                    height: number;
+                }>;
+            }>;
+        };
+        error?: string;
+    };
+    /**
+     * 从 JSON 数据批量创建多边形(层级结构)
+     *
+     * @param data - 层级结构的 JSON 数据
+     * @param createPolygonFromPointsFn - 创建多边形的函数(由 CZMLManager 提供)
+     * @returns 创建结果统计
+     */
+    importPolygonsFromHierarchy(data: {
+        subarrays: Array<{
+            id: string;
+            name: string;
+            oldName?: string;
+            points: Array<{
+                lon: number;
+                lat: number;
+                height: number;
+            }>;
+            inverters: Array<{
+                id: string;
+                name: string;
+                oldName?: string;
+                points: Array<{
+                    lon: number;
+                    lat: number;
+                    height: number;
+                }>;
+            }>;
+        }>;
+        independentInverters: Array<{
+            id: string;
+            name: string;
+            oldName?: string;
+            points: Array<{
+                lon: number;
+                lat: number;
+                height: number;
+            }>;
+        }>;
+    }, createPolygonFromPointsFn: (params: {
+        layerName: string;
+        id: string;
+        name: string;
+        points: Array<{
+            lon: number;
+            lat: number;
+            height: number;
+        }>;
+    }) => any): {
+        success: boolean;
+        subarrayCount: number;
+        inverterCount: number;
+        independentCount: number;
+        errors: Array<{
+            type: string;
+            name: string;
+            error: string;
+        }>;
+    };
+    /**
+     * 从 JSON 数据批量创建多边形(扁平结构)
+     *
+     * @param data - 扁平结构的 JSON 数据
+     * @param createPolygonFromPointsFn - 创建多边形的函数(由 CZMLManager 提供)
+     * @returns 创建结果统计
+     */
+    importPolygonsFromFlatStructure(data: {
+        subarray: Array<{
+            id: string;
+            name: string;
+            points: Array<{
+                lon: number;
+                lat: number;
+                height: number;
+            }>;
+        }>;
+        inverter: Array<{
+            id: string;
+            name: string;
+            points: Array<{
+                lon: number;
+                lat: number;
+                height: number;
+            }>;
+        }>;
+    }, createPolygonFromPointsFn: (params: {
+        layerName: string;
+        id: string;
+        name: string;
+        points: Array<{
+            lon: number;
+            lat: number;
+            height: number;
+        }>;
+    }) => any): {
+        success: boolean;
+        subarrayCount: number;
+        inverterCount: number;
+        errors: Array<{
+            type: string;
+            name: string;
+            error: string;
+        }>;
+    };
+    /**
+     * 更新多边形实体的类型、颜色和标签
+     * @param entity 要更新的多边形实体
+     * @param newType 新的类型 ('subarray' | 'inverter' | 'astrict' | 'rail' | 'feature')
+     * @param customName 可选的自定义名称
+     * @returns 更新结果
+     */
+    updatePolygonTypeAndStyle(entity: Cesium.Entity, newType: string, customName?: string): {
+        success: boolean;
+        message: string;
+        oldType?: string;
+        newType?: string;
+        oldName?: string;
+        newName?: string;
+    };
+    /**
+     * 开始圆形绘制
+     * 用户流程:
+     * 1. 左键点击确定圆心
+     * 2. 移动鼠标动态调整半径
+     * 3. 再次左键点击确定半径，完成绘制
+     * 4. 或右键/ESC取消绘制
+     *
+     * @param layer 图层对象 (使用 'other' 类型的 DataSource)
+     * @param onComplete 绘制完成回调函数
+     * @returns 返回绘制会话对象，包含 stop() 方法
+     */
+    startCircleDrawing(layer?: Cesium.CustomDataSource, onComplete?: (entity: Cesium.Entity) => void): {
+        stop: () => void;
+    };
+    /**
+     * 开始点标记绘制
+     * 用户流程:
+     * 1. 左键点击地图添加点标记
+     * 2. 可连续点击添加多个点
+     * 3. 右键或 ESC 结束绘制
+     *
+     * @param layer 图层对象 (使用 'other' 类型的 DataSource)
+     * @param iconSvg SVG 图标的 data URL 或路径
+     * @param onComplete 每次添加点时的回调函数（可选）
+     * @returns 返回绘制会话对象，包含 stop() 方法
+     */
+    startPointDrawing(layer?: Cesium.CustomDataSource, iconSvg?: string, onComplete?: (entity: Cesium.Entity) => void): {
+        stop: () => void;
+    };
+    /**
+     * 从 JSON 数据加载多边形、圆形和特征点到 other 图层
+     * @param data JSON 数据,包含 astrict, rail, feature, feature_point 数组
+     * @returns 加载结果统计
+     */
+    loadOtherLayerFromJson(data: {
+        astrict?: Array<any>;
+        rail?: Array<any>;
+        feature?: Array<any>;
+        feature_point?: Array<any>;
+    }): {
+        success: boolean;
+        message: string;
+        stats: {
+            astrict: number;
+            rail: number;
+            feature: number;
+            feature_point: number;
+            total: number;
+        };
+    };
+    /**
+     * 加载多边形实体 (复用代码)
+     */
+    private loadPolygonEntity;
+    /**
+     * 加载圆形实体 (复用代码)
+     * 圆形数据格式: points[0] 包含 {lon, lat, height, radius}
+     */
+    private loadCircleEntity;
+    /**
+     * 加载特征点实体 (复用代码)
+     */
+    private loadPointEntity;
+}
+
+interface SelectionChange<T = unknown> {
+    current?: T;
+    previous?: T;
+}
+interface EditingChange<T = unknown> {
+    editing: boolean;
+    target?: T;
+}
+interface PreviousViewChange {
+    current?: CameraView;
+    previous?: CameraView;
+}
+/**
+ * Lightweight state manager for common UI states:
+ * - selection (arbitrary payload)
+ * - editing (boolean + optional target)
+ * - previous camera view (for simple back navigation)
+ */
+declare class StateManager<TSelection = unknown, TEditingTarget = unknown> {
+    private selected?;
+    private editing;
+    private editingTarget?;
+    private previousView?;
+    readonly onSelectionChange: Emitter<SelectionChange<TSelection>>;
+    readonly onEditingChange: Emitter<EditingChange<TEditingTarget>>;
+    readonly onPreviousViewChange: Emitter<PreviousViewChange>;
+    setSelected(next?: TSelection): void;
+    /**
+     * 获取当前选中对象。
+     * - 若未传入类型，直接返回当前选中对象。
+     * - 若传入类型，则当且仅当选中对象的 `type` 字段与之匹配时返回，否则返回 undefined。
+     */
+    getSelected(): TSelection | undefined;
+    getSelected(type: 'line' | 'shape' | 'point' | 'unknown'): TSelection | undefined;
+    clearSelected(): void;
+    startEditing(target?: TEditingTarget): void;
+    stopEditing(): void;
+    toggleEditing(target?: TEditingTarget): void;
+    isEditing(): boolean;
+    getEditingTarget(): TEditingTarget | undefined;
+    setPreviousCameraView(view?: CameraView): void;
+    getPreviousCameraView(): CameraView | undefined;
+}
+declare const globalState: StateManager<any, any>;
+
+type Viewer = Cesium.Viewer;
+interface SelectionResult {
+    /** 世界坐标（Cartesian3）。若拾取失败则为 undefined */
+    position?: any;
+    /** 被选中的实体（如果有的话） */
+    entity?: Cesium.Entity;
+}
+interface SelectionSession {
+    /** 停止选择（移除事件、恢复光标等） */
+    stop: () => void;
+}
+/**
+ * 选择器：提供点击场景返回坐标点与选中的 entity（如果有）的能力。
+ */
+declare class Selector {
+    private CesiumNS;
+    private viewer;
+    private state?;
+    private handler?;
+    constructor(CesiumNS: typeof Cesium, viewer: Viewer, state?: StateManager<any, any> | undefined);
+    /**
+     * 从鼠标事件解析世界坐标。
+     */
+    private getPositionFromMouse;
+    /**
+     * 在窗口坐标处进行一次拾取，返回坐标与实体。
+     */
+    pickAt(windowPosition: {
+        x: number;
+        y: number;
+    }): SelectionResult;
+    /**
+     * 开启点击选择会话。左键点击触发回调，返回坐标与实体。
+     * @param onSelect 回调函数，参数为 { position, entity }
+     * @param options 可选项：{ cursor?: string }
+     */
+    startSelecting(onSelect: (result: SelectionResult) => void, options?: {
+        cursor?: string;
+    }): SelectionSession;
+}
+
+interface FOVControllerOptions {
+    /** 初始 FOV 值（度） */
+    initialFOV?: number;
+    /** 最小 FOV 值（度），对应长焦 */
+    minFOV?: number;
+    /** 最大 FOV 值（度），对应广角 */
+    maxFOV?: number;
+    /** UI 容器元素，如果不提供则自动创建 */
+    container?: HTMLElement;
+    /** 是否显示焦距刻度标签 */
+    showLabels?: boolean;
+    /** 预设焦距档位（焦距值数组，mm） */
+    focalLengthPresets?: number[];
+    /** 传感器宽度（mm），用于计算焦距，默认 35mm 全画幅 */
+    sensorWidth?: number;
+    /** 是否使用全局事件总线，默认 true */
+    useGlobalEventBus?: boolean;
+    /** 滑块容器高度（px），默认 300 */
+    sliderHeight?: number;
+}
+interface FOVChangeEvent {
+    /** 当前 FOV 值（度） */
+    fov: number;
+    /** 等效焦距（mm） */
+    focalLength: number;
+}
+/**
+ * 相机 FOV（视场角）控制器
+ * 提供焦距滑块控制，模拟镜头焦距变化（14mm 广角 到 200mm 长焦）
+ * 通过全局事件总线与 PathPreview 和 FrustumPyramid 通信
+ */
+declare class CameraFOVController {
+    private opts;
+    private containerEl?;
+    private sliderEl?;
+    private labelEl?;
+    private destroyed;
+    private useGlobalEventBus;
+    onFOVChange: Emitter<FOVChangeEvent>;
+    private minFOV;
+    private maxFOV;
+    private currentFOV;
+    private sensorWidth;
+    private focalLengthPresets;
+    constructor(opts?: FOVControllerOptions);
+    /**
+     * 变焦倍数转换为 FOV（度）- 直接计算版本
+     */
+    private zoomMultiplierToFOVDirect;
+    /**
+     * 创建 UI 控件
+     */
+    private createUI;
+    /**
+     * 滑块变化处理
+     */
+    private handleSliderChange;
+    /**
+     * 根据索引插值计算变焦倍数
+     */
+    private interpolateZoomMultiplier;
+    /**
+     * 根据变焦倍数计算对应的索引（可以是小数）
+     */
+    private getZoomMultiplierIndex;
+    /**
+     * 根据 FOV 找到最接近的预设索引（可以是小数）
+     */
+    private getClosestPresetIndex;
+    /**
+     * 更新显示
+     */
+    private updateDisplay;
+    /**
+     * 发射 FOV 变化事件
+     */
+    private emitChange;
+    /**
+     * FOV 转换为等效焦距（mm）
+     * 公式: f = (sensor_width / 2) / tan(fov / 2)
+     */
+    private fovToFocalLength;
+    /**
+     * 焦距转换为 FOV（度）
+     * 公式: fov = 2 * atan(sensor_width / (2 * f))
+     */
+    private focalLengthToFOV;
+    /**
+     * 变焦倍数转换为 FOV（度）
+     */
+    private zoomMultiplierToFOV;
+    /**
+     * 设置焦距（mm）
+     */
+    setFocalLength(focalLengthMm: number): void;
+    /**
+     * 设置变焦倍数
+     */
+    setZoomMultiplier(zoomMultiplier: number): void;
+    /**
+     * 设置 FOV（度）
+     */
+    setFOV(fovDeg: number): void;
+    /**
+     * 获取当前 FOV
+     */
+    getFOV(): number;
+    /**
+     * 获取当前焦距
+     */
+    getFocalLength(): number;
+    /**
+     * 显示控制器
+     */
+    show(): void;
+    /**
+     * 隐藏控制器
+     */
+    hide(): void;
+    /**
+     * 销毁控制器
+     */
+    destroy(): void;
+}
+
+/**
+ * 视锥体/金字塔可视化工具
+ * - 用多段线与多边形在 Cesium 中绘制一个“相机视锥体”样式的方锥体
+ * - 支持静态一次性绘制（showAt）与基于 CallbackProperty 的动态绘制（showAtDynamic）
+ * - 几何计算集中在 computeFrustumGeometry，避免重复代码
+ */
+
+interface FrustumPyramidOptions {
+    /** 顶点到底面中心的距离（米） */
+    length?: number;
+    /** 水平视场角（度，整角） */
+    fov?: number;
+    /** 底面宽高比（width:height），默认 4:3 模拟相机画幅 */
+    aspectRatio?: number;
+    /** 边线颜色 */
+    color?: Cesium.Color;
+    /** 面填充颜色（alpha 由 fillAlpha 决定或自身附带） */
+    fillColor?: Cesium.Color;
+    /** 面透明度 [0..1]，默认 0.25 */
+    fillAlpha?: number;
+    /** 边线宽度（像素） */
+    width?: number;
+    /** 是否打印上下左右半视场角（度）变化日志（默认关闭） */
+    logAngles?: boolean;
+    /** 日志节流间隔（毫秒），仅在 logAngles=true 时生效，默认 250ms */
+    logThrottleMs?: number;
+}
+/**
+ * 在给定姿态处渲染一个方锥体视锥（边线 + 面填充 + 垂直箭头）
+ * - 通过 Entity 层级维护几何，支持重复更新与清理
+ */
+declare class FrustumPyramid {
+    private CesiumNS;
+    private layer;
+    private opts;
+    /** 4 条边线实体（apex->四个角） */
+    private edgeEntities;
+    /** 底面填充多边形实体（可选显示） */
+    private baseFillEntity?;
+    /** 4 个侧面三角形实体（apex->ci->c(i+1)） */
+    private faceEntities;
+    /** 顶点到底面中心的垂直“箭头线”（用于指示方向/深度） */
+    private verticalLineEntity?;
+    private destroyed;
+    /** 上次记录的半视场角（度），用于判定变化 */
+    private lastAngles?;
+    /** 上次打印日志的时间戳（ms） */
+    private lastLogAt;
+    constructor(CesiumNS: typeof Cesium, layer: Cesium.CustomDataSource, opts?: FrustumPyramidOptions);
+    /**
+     * 计算视锥体几何（顶点、四个底面角点与底面中心）
+     * - 先根据 HPR 在 apex 处构造模型矩阵，取 forward（列1）方向
+     * - 用 apex 的地表法线作为世界 up，重建无滚转的 right/up，从而避免 pitch 时的视觉侧倾
+     * - 基于 fov 与 aspectRatio 求得底面半宽半高，沿 forward 推进 length 得到 baseCenter
+     */
+    private computeFrustumGeometry;
+    /**
+     * 若启用日志，则在“左右/上下对应的世界角度”变化时打印一条日志。
+     * - 左右角度：以 heading 为中心的 ±(FOV/2)
+     * - 上下角度：以 pitch 为中心的 ±(verticalHalfFov)
+     * - 采用节流与变化判定：小于 logThrottleMs 的间隔或角度未变时不重复打印
+     */
+    private logAnglesIfChanged;
+    /**
+     * 确保实体已创建：
+     * - 4 条边线、4 个侧面三角形、1 个底面填充、多一条垂直箭头线
+     * - 若已存在则直接返回，避免重复创建
+     */
+    private ensureEntities;
+    /**
+     * 静态更新：在给定姿态一次性计算并更新几何
+     * - 适合低频率更新或仅渲染一次的场景
+     */
+    showAt(apex: Cesium.Cartesian3, headingDeg: number, pitchDeg?: number, rollDeg?: number, fovDeg?: number, lengthOverride?: number): void;
+    /**
+     * 动态更新：通过回调获取实时姿态，由 Cesium 在每帧调用 CallbackProperty 自动评估
+     * - 适合高频率变化（相机/游标联动）
+     */
+    showAtDynamic(apexCallback: () => Cesium.Cartesian3, headingDegCallback: () => number, pitchDegCallback: () => number, rollDegCallback: () => number, fovDegCallback: () => number, lengthCallback: () => number): void;
+    /**
+     * 销毁：移除所有已创建的实体并释放引用
+     * - 与 clear 的区别：destroy 彻底删除实体；clear 仅隐藏/清空坐标以复用
+     */
+    destroy(): void;
+    /**
+     * 清理：隐藏几何但不销毁实例（保留复用能力）
+     */
+    clear(): void;
+}
+
+/**
+ * 🆕 快速编辑模式配置选项
+ */
+interface QuickEditOptions {
+    /** 是否启用（默认 false） */
+    enabled?: boolean;
+    /** 新顶点的默认爬升高度（米） */
+    climbHeight?: number;
+    /** 高度模式 */
+    altitudeMode?: 'absolute' | 'relativeToStart' | 'relativeToGround';
+}
+
+/**
+ * Path 编辑保存结果数据接口
+ * 对应 pathEditing.ts 中 saveAndStop() 返回的数据结构
+ */
+interface PathEditingSaveResult {
+    entity: Cesium.Entity;
+    positions: Cesium.Cartesian3[];
+    startPoint: {
+        position: Cesium.Cartesian3;
+    };
+    climbHeight?: number;
+    waypointData: Array<{
+        position: Cesium.Cartesian3;
+        heading: number;
+        pitch: number;
+        roll: number;
+        fov: number;
+        index: number;
+        distance: number;
+    }>;
+    altitudeMode?: string;
+    hasHiddenClimb?: boolean;
+}
+/**
+ * Path 到 Sinofly 转换选项
+ */
+interface PathToSinoflyOptions {
+    CesiumNS: typeof Cesium;
+    waylineId: number | string;
+    waylineName?: string;
+    waylineType?: number;
+    waylineVersion?: string;
+    source?: number;
+    heightType?: string;
+    droneModelKey?: number | string;
+    relativeHeight?: number;
+    autoFlightSpeed?: number;
+    globalRthHeight?: number;
+    fileId?: number | string;
+    fileMd5?: string;
+    duration?: number;
+    photoNumber?: number;
+    thumbnailFileId?: number;
+    stationId?: number;
+    subarrayId?: number;
+    stationName?: string;
+    subarrayName?: string;
+    createUserId?: string;
+    createTime?: string;
+    modifyUserId?: string;
+    modifyTime?: string;
+    /** 航点的 noReturn 值，默认 0 */
+    defaultNoReturn?: number;
+    /** 航点的 createUserId，如果提供则应用到所有航点 */
+    waypointCreateUserId?: string;
+    /** 航点的 createTime，如果提供则应用到所有航点 */
+    waypointCreateTime?: string;
+    /** 航点的 modifyUserId，如果提供则应用到所有航点 */
+    waypointModifyUserId?: string;
+    /** 航点的 modifyTime，如果提供则应用到所有航点 */
+    waypointModifyTime?: string;
+}
+/**
+ * 将 Path 编辑保存结果转换为 Sinofly 航线路数据格式
+ *
+ * @param data Path 编辑保存结果数据
+ * @param options 转换选项
+ * @returns Sinofly 航线路数据
+ *
+ * @example
+ * ```typescript
+ * import * as Cesium from 'cesium';
+ * import { convertPathToSinofly } from '@jorgmoritz/gis-manager';
+ *
+ * const editSession = startPathEditing(Cesium, viewer, entity, {
+ *   onVertexSelectDetail: (info) => console.log(info)
+ * });
+ *
+ * // 编辑完成后保存
+ * const saveResult = editSession.saveAndStop();
+ *
+ * // 转换为 Sinofly 格式
+ * const sinoflyData = convertPathToSinofly(saveResult, {
+ *   CesiumNS: Cesium,
+ *   waylineId: 12345,
+ *   waylineName: '测试航线',
+ *   takeOffSecurityHeight: saveResult.climbHeight ?? 50,
+ * });
+ *
+ * // 发送到 Sinofly 服务器
+ * await fetch('/api/waylines', {
+ *   method: 'POST',
+ *   body: JSON.stringify(sinoflyData)
+ * });
+ * ```
+ */
+declare function convertPathToSinofly(data: PathEditingSaveResult, options: PathToSinoflyOptions): SinoflyWaylineData;
+
+declare const placeholder: {
+    ready: boolean;
+};
+
+export { CZMLManager, type CameraDestinationInput, CameraEventBus, type CameraFOVChangeEvent, CameraFOVController, type CameraFlyOptions, type CameraInitOptions, CameraManager, type CameraOrientation, type CameraPoseChangeEvent, type CameraSetViewOptions, type CameraView, type CesiumAssetsOptions, type ConvertedWaylineData, type ConvertedWaypointData, type CzmlExportOptions, type CzmlImportOptions, type EditingChange, Emitter, type FOVChangeEvent, type FOVControllerOptions, type FlyToOptions, FrustumPyramid, type FrustumPyramidOptions, type FrustumShapeChangeEvent, type ImageryOptions, type ImageryProviderKind, type InitOptions, type LayerEvents, type LayerHandle, LayerManager, type LayerType, type Listener, type LonLatHeight, type Orientation, type PathEditingSaveResult, type PathOptions, type PathToSinoflyOptions, type PhotoBillboardItem, type PhotoBillboardLayerOptions, type PhotoBillboardResult, type PolygonDrawingOptions, type PolygonEditingSession, PolygonEditor, type PreviousViewChange, type QuickEditOptions, SceneManager, type SceneOptions, type SelectionChange, type SelectionResult, type SelectionSession, Selector, type ShapeLineProps, type ShapePointProps, type ShapePolygonProps, type SinoflyAdapterOptions, type SinoflyWaylineData, type SinoflyWaypointInfo, StateManager, type TerrainKind, type TerrainOptions, type Toggle2D3DContext, type Toggle2D3DOptions, type VersionInfo, assertCesiumAssetsConfigured, configureCesiumAssets, configureCesiumIonToken, convertPathToSinofly, convertSinoflyWayline, convertSinoflyWaylines, ensureCesiumIonToken, getCesiumBaseUrl, getCesiumIonToken, globalCameraEventBus, globalState, placeholder, toggle2D3D, version, versionInfo };