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

package/dist/libs/CesiumMapToolbar.d.ts

@@ -1,219 +0,0 @@
-import { Viewer } from '../../node_modules/cesium';
-import { CesiumMapController } from './toolBar/CesiumMapController';
-import { MeasurementService } from './toolBar/MeasurementService';
-import { SearchService } from './toolBar/MapSearchService';
-import { MapLayersService } from './toolBar/MapLayersService';
-import { NotFlyZonesService } from './toolBar/NotFlyZonesService';
-import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback, CustomButtonConfig } from './CesiumMapModel';
-/**
- * Cesium地图工具栏类
- * 提供搜索、测量、2D/3D切换、图层切换、定位、缩放、全屏等功能
- */
-export declare class CesiumMapToolbar {
-    private viewer;
-    private drawHelper;
-    private container;
-    private toolbarElement;
-    private config;
-    private searchService;
-    private mapLayersService;
-    private notFlyZonesService;
-    private measurementCallback?;
-    private zoomCallback?;
-    private fullscreenCallback?;
-    private resetLocationCallback?;
-    private initialCenter?;
-    private currentMapType;
-    TD_Token: string;
-    mapTypes: MapType[];
-    private isNoFlyZoneChecked;
-    private currentGeoWTFS;
-    private measurementService;
-    private unsubscribeI18n?;
-    private i18n;
-    private useI18n;
-    readonly measurement: {
-        getMeasureMode: () => "none" | "distance" | "area";
-    };
-    private mapController;
-    constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: {
-        search?: SearchCallback;
-        measurement?: MeasurementCallback;
-        zoom?: ZoomCallback;
-        fullscreen?: (isFullscreen: boolean) => void;
-        resetLocation?: () => void;
-    }, initialCenter?: {
-        longitude: number;
-        latitude: number;
-        height: number;
-    });
-    /**
-     * searchService 对外暴露的获取搜索服务方法
-     */
-    getSearchService(): SearchService;
-    /**
-     * notFlyZonesService 对外暴露的获取禁飞区服务方法
-     */
-    getNotFlyZonesService(): NotFlyZonesService;
-    /**
-     * measurementService 对外暴露的获取测量服务方法
-     */
-    getMeasurementService(): MeasurementService;
-    /**
-     * cesmapController 对外暴露的获取地图控制器方法
-     */
-    getCesiumMapCtrl(): CesiumMapController;
-    /**
-     * mapLayersService 对外暴露的获取图层服务方法
-     */
-    getMapLayersService(): MapLayersService;
-    /**
-     * 设置地图类型配置
-     * @param mapTypes
-     */
-    setMapTypes(mapTypes: MapType[]): void;
-    /**
-     * 设置天地图密钥
-     * @param TD_Token
-     */
-    setTDToken(TD_Token: string): void;
-    /**
-     * 设置初始中心点
-     */
-    setInitialCenter(center: {
-        longitude: number;
-        latitude: number;
-        height: number;
-    }): void;
-    /**
-     * 获取初始中心点
-     */
-    getInitialCenter(): {
-        longitude: number;
-        latitude: number;
-        height: number;
-    } | undefined;
-    /**
-     * 复位到初始位置（公共方法）
-     */
-    resetToInitialLocation(): void;
-    /**
-     * 更新按钮配置
-     */
-    updateButtonConfig(buttonId: string, config: Partial<CustomButtonConfig>): void;
-    /**
-     * 添加自定义按钮
-     * @param config 按钮配置，支持 sort 参数控制插入位置
-     */
-    addCustomButton(config: CustomButtonConfig): void;
-    /**
-     * 获取所有按钮配置（包括默认按钮和自定义按钮），并添加 sort 值
-     */
-    private resolveIcon;
-    /**
-     * 获取按钮配置（已排序，包含默认按钮兜底）
-     * - 未传 buttons：使用默认按钮
-     * - 传了 buttons：按传入按钮列表渲染，并用默认按钮补齐缺省字段
-     */
-    private getButtonConfigs;
-    /**
-     * 重新构建工具栏按钮
-     */
-    private rebuildToolbarButtons;
-    /**
-     * 移除按钮
-     */
-    removeButton(buttonId: string): void;
-    /**
-     * 获取按钮元素
-     */
-    private setupDrawHelperCallbacks;
-    /**
-     * 创建工具栏
-     */
-    private createToolbar;
-    /**
-     * 创建按钮
-     */
-    private createButton;
-    /**
-     * 设置按钮图标
-     */
-    private setButtonIcon;
-    /**
-     * 判断是否为图片路径
-     */
-    private isImagePath;
-    /**
-     * 加载图片图标
-     */
-    private loadImageIcon;
-    /**
-     * 设置默认图标（当图片加载失败时）
-     */
-    private setDefaultIcon;
-    /**
-     * 设置按钮事件
-     */
-    private setupButtonEvents;
-    /**
-     * 按钮鼠标离开时关闭菜单
-     */
-    private closeMenuOnButtonLeave;
-    /**
-     * 关闭搜索框
-     */
-    private closeSearchContainer;
-    /**
-     * 处理按钮点击
-     */
-    private handleButtonClick;
-    /**
-     * 切换测量功能
-     */
-    private toggleMeasurement;
-    /**
-     * 处理测量操作
-     */
-    private handleMeasurementAction;
-    /**
-     * 切换2D/3D视图
-     */
-    private toggle2D3D;
-    /**
-     * 复位到初始位置
-     */
-    private resetLocation;
-    /**
-     * 放大
-     */
-    private zoomIn;
-    /**
-     * 缩小
-     */
-    private zoomOut;
-    /**
-     * 加载并显示机场禁飞区
-     * @deprecated 使用 NotFlyZonesService.showNoFlyZones 代替
-     */
-    showNoFlyZones(): Promise<void>;
-    /**
-     * 隐藏机场禁飞区
-     * @deprecated 使用 NotFlyZonesService.hideNoFlyZones 代替
-     */
-    hideNoFlyZones(): void;
-    /**
-     * 切换机场禁飞区显示状态
-     * @deprecated 使用 NotFlyZonesService.toggleNoFlyZones 代替
-     */
-    toggleNoFlyZones(): Promise<void>;
-    /**
-     * 获取禁飞区显示状态
-     * @deprecated 使用 NotFlyZonesService.getNoFlyZoneVisible 代替
-     */
-    getNoFlyZoneVisible(): boolean;
-    /**
-     * 销毁工具栏
-     */
-    destroy(): void;
-}

package/dist/libs/CesiumOverlayService.d.ts

@@ -1,227 +0,0 @@
-import { Viewer, Entity } from '../../node_modules/cesium';
-import { DrawEntity } from './drawHelper';
-import { OverlayEntity, OverlayPosition } from './overlay/types';
-import { MapMarker, MarkerOptions } from './overlay/MapMarker';
-import { MapLabel, LabelOptions } from './overlay/MapLabel';
-import { MapIcon, IconOptions } from './overlay/MapIcon';
-import { MapSVG, SvgOptions } from './overlay/MapSVG';
-import { MapInfoWindow, InfoWindowOptions } from './overlay/MapInfoWindow';
-import { MapPolyline, PolylineOptions } from './overlay/MapPolyline';
-import { MapPolygon, PolygonOptions } from './overlay/MapPolygon';
-import { MapRectangle, RectangleOptions } from './overlay/MapRectangle';
-import { MapCircle, CircleOptions } from './overlay/MapCircle';
-import { MapRing, RingOptions } from './overlay/MapRing';
-import { OverlayEditOptions } from './overlay/OverlayEditHandles';
-export interface CesiumOverlayServiceOptions {
-    /**
-     * 是否启用实体 hover 处理器（MOUSE_MOVE 下会执行 pick/drillPick 并触发 hover 高亮）。
-     * 大屏/高负载场景可考虑关闭以规避 Cesium 在 primitive 重建窗口期的边界问题。
-     * @default true
-     */
-    enableHoverHandler?: boolean;
-    /**
-     * 覆盖物处于编辑模式时：一次拖拽结束（LEFT_UP）且几何发生变化会触发。
-     * 参数为“已回写后的覆盖物 entity”。
-     */
-    onOverlayEditChange?: (entity: DrawEntity & OverlayEntity) => void;
-    /**
-     * 点击 pick 节流间隔（毫秒）。
-     * 用于降低 “贴地几何 + pick + ground pipeline” 的偶发 DataCloneError 风险。
-     * @default 120
-     */
-    clickPickMinIntervalMs?: number;
-    /** 编辑功能配置项，默认为全开（除 rotate） */
-    overlayEditOptions?: OverlayEditOptions;
-}
-/**
- * Cesium 覆盖物服务类
- * 统一管理各种覆盖物工具类
- */
-export declare class CesiumOverlayService {
-    private viewer;
-    private entities;
-    private overlayMap;
-    private infoWindowContainer;
-    /** 构造参数（用于开关 hover handler 等运行时策略） */
-    private readonly options;
-    private overlayEditor;
-    private overlayHighlight;
-    private lastHoverTargets;
-    private hoverPickRAF;
-    private hoverPickPos;
-    private overlayMutationRevision;
-    private hoverSuspendUntil;
-    private bulkUpdateDepth;
-    private readonly clickPickMinIntervalMs;
-    private readonly pickGovernor;
-    private static readonly HOVER_SUSPEND_AFTER_MUTATION_MS;
-    private static readonly CLICK_PICK_MIN_INTERVAL_MS;
-    private markOverlayMutated;
-    /**
-     * 显式开始一次批量更新：在 begin/end 期间暂停 hover pick。
-     * 建议 websocket 批量 add/remove 覆盖物时包裹使用，降低 Cesium GroundPrimitive 异步重建窗口期的 pick/update 压力。
-     */
-    beginBulkUpdate(): void;
-    /**
-     * 结束一次批量更新。
-     */
-    endBulkUpdate(): void;
-    /**
-     * 批量更新包裹器（自动 begin/end）。
-     */
-    bulkUpdate<T>(fn: () => T): T;
-    /**
-     * Primitive 模式下，GeometryInstance.id 会是字符串（structured-cloneable），
-     * 需要映射回 overlayMap 内的根覆盖物 id。
-     */
-    private normalizeOverlayPickId;
-    private resolveOverlayByPickId;
-    private resolvePickedOverlayEntity;
-    readonly marker: MapMarker;
-    readonly label: MapLabel;
-    readonly icon: MapIcon;
-    readonly svg: MapSVG;
-    readonly infoWindow: MapInfoWindow;
-    readonly polyline: MapPolyline;
-    readonly polygon: MapPolygon;
-    readonly rectangle: MapRectangle;
-    readonly circle: MapCircle;
-    readonly ring: MapRing;
-    constructor(viewer: Viewer, options?: CesiumOverlayServiceOptions);
-    /**
-     * 尝试从屏幕坐标拾取地表/模型位置并转为 Cartographic
-     */
-    private pickCartographic;
-    /**
-     * 当 pick/drillPick 未命中时，使用经纬度判断是否落在 Rectangle 覆盖物内
-     */
-    private findHoverableRectangleByCartographic;
-    /**
-     * 判断点是否在多边形内（2D）
-     */
-    private isPointInPolygon2D;
-    private resolvePolygonPositions;
-    private findHoverablePolygonByCartographic;
-    private findHoverableCircleByCartographic;
-    /**
-     * 初始化信息窗口容器
-     */
-    private initInfoWindowContainer;
-    /**
-     * 设置实体点击处理器
-     */
-    private setupEntityClickHandler;
-    /**
-     * 开启或是关闭覆盖物的Hover高亮（鼠标移入高亮，移出取消）。
-     * - 开启后：覆盖物会触发高亮，且高亮状态会在鼠标移出时取消。
-     * - 关闭后：覆盖物不再触发 hover 高亮。
-     */
-    toggleOverlayHoverHighlight(enabled: boolean): void;
-    /**
-     * 开启/关闭覆盖物编辑模式。
-     * - 开启后：点击覆盖物会进入编辑，并显示可拖拽控制点。
-     * - 关闭后：退出编辑并移除控制点。
-     * @param enabled 是否启用编辑模式
-     * @param overlayEditOptions 编辑功能配置项，可选。不传时使用构造函数传入的配置或默认配置
-     */
-    setOverlayEditMode(enabled: boolean, overlayEditOptions?: OverlayEditOptions): void;
-    /** 当前是否处于覆盖物编辑模式（全局开关） */
-    getOverlayEditModeEnabled(): boolean;
-    /** 停止当前正在编辑的覆盖物（不会关闭全局编辑模式） */
-    stopOverlayEdit(): void;
-    /**
-     * 主动开始编辑某个覆盖物。
-     * @returns true 表示成功进入编辑
-     */
-    startOverlayEdit(entityOrId: (DrawEntity & OverlayEntity) | string, options?: OverlayEditOptions): boolean;
-    /**
-     * 设置实体 hover 高亮处理器（鼠标移入高亮，移出取消）
-     */
-    private setupEntityHoverHandler;
-    private getPropertyValue;
-    private getNumberProperty;
-    /**
-     * 生成唯一ID
-     */
-    private generateId;
-    toggleOverlayHighlight(entity: OverlayEntity, reason?: 'click' | 'hover'): void;
-    /**
-     * 高亮/取消高亮覆盖物（显式设置）
-     * @param entityOrId 覆盖物实体或 id
-     * @param enabled 是否高亮
-     * @param reason 高亮原因（默认 click）
-     */
-    setOverlayHighlight(entityOrId: OverlayEntity | string, enabled: boolean, reason?: 'click' | 'hover'): boolean;
-    /**
-     * 添加 Marker
-     */
-    addMarker(options: MarkerOptions): Entity;
-    /**
-     * 添加 Label
-     */
-    addLabel(options: LabelOptions): Entity;
-    /**
-     * 添加 Icon
-     */
-    addIcon(options: IconOptions): Entity;
-    /**
-     * 添加 SVG
-     */
-    addSvg(options: SvgOptions): Entity;
-    /**
-     * 添加 InfoWindow
-     */
-    addInfoWindow(options: InfoWindowOptions): Entity;
-    /**
-     * 添加 Polyline
-     */
-    addPolyline(options: PolylineOptions): Entity;
-    /**
-     * 添加 Polygon
-     */
-    addPolygon(options: PolygonOptions): Entity;
-    /**
-     * 添加 Rectangle
-     */
-    addRectangle(options: RectangleOptions): Entity;
-    /**
-     * 添加 Circle
-     */
-    addCircle(options: CircleOptions): Entity;
-    /**
-     * 添加 Ring
-     */
-    addRing(options: RingOptions): Entity;
-    /**
-     * 根据ID获取覆盖物
-     */
-    getOverlay(id: string): Entity | undefined;
-    /**
-     * 根据ID删除覆盖物
-     */
-    removeOverlay(id: string): boolean;
-    /**
-     * 删除所有覆盖物
-     */
-    removeAllOverlays(): void;
-    /**
-     * 更新覆盖物位置
-     */
-    updateOverlayPosition(id: string, position: OverlayPosition): boolean;
-    /**
-     * 显示/隐藏覆盖物
-     */
-    setOverlayVisible(id: string, visible: boolean): boolean;
-    /**
-     * 获取所有覆盖物ID
-     */
-    getAllOverlayIds(): string[];
-    /**
-     * 获取所有覆盖物
-     */
-    getAllOverlays(): Entity[];
-    /**
-     * 销毁服务，清理所有资源
-     */
-    destroy(): void;
-}

package/dist/libs/CesiumPointClusterLayer.d.ts

@@ -1,93 +0,0 @@
-import { Viewer, Entity } from '../../node_modules/cesium';
-import * as Cesium from 'cesium';
-export interface ClusterPoint {
-    /** 业务 id（可选，建议传以便稳定更新） */
-    id?: string;
-    /** 经度（度） */
-    lon: number;
-    /** 纬度（度） */
-    lat: number;
-    /** 高度（米，默认 0） */
-    height?: number;
-    /** 可选：权重/热度值（暂未参与聚类，仅透传给回调） */
-    value?: number;
-    /** 任意业务属性 */
-    properties?: Record<string, unknown>;
-}
-export interface ClusterStyleStep {
-    /** 当 count >= minCount 时命中该样式（按 minCount 从大到小匹配更直观） */
-    minCount: number;
-    color: Cesium.Color | string;
-    /** 聚合点圆点大小（像素），不填则使用 options.clusterPixelSize */
-    pixelSize?: number;
-}
-export interface PointClusterLayerOptions {
-    /** 图层 id（用于 Cesium.DataSourceCollection 里区分） */
-    id?: string;
-    /** 单点渲染：像素大小 */
-    pointPixelSize?: number;
-    /** 单点渲染：颜色 */
-    pointColor?: Cesium.Color | string;
-    /** 单点渲染：是否贴地（height=0 时等价贴地效果更明显） */
-    clampToGround?: boolean;
-    /** 聚类开关（默认 true） */
-    clusteringEnabled?: boolean;
-    /** 聚类像素范围（越大越容易聚合），默认 50 */
-    pixelRange?: number;
-    /** 最小聚类数量，默认 2 */
-    minimumClusterSize?: number;
-    /** 聚合点默认大小（像素） */
-    clusterPixelSize?: number;
-    /** 聚合点样式分段：用 count 决定颜色/大小 */
-    clusterStyleSteps?: ClusterStyleStep[];
-    /** 自定义聚合点渲染（直接修改 cluster entity） */
-    renderCluster?: (args: {
-        cluster: Entity;
-        clusteredEntities: Entity[];
-        count: number;
-    }) => void;
-    /** 自定义单点渲染（直接修改 point entity） */
-    renderSinglePoint?: (args: {
-        entity: Entity;
-        point: ClusterPoint;
-    }) => void;
-    /** 点击聚合点回调：返回该聚合内的原始点 */
-    onClusterClick?: (points: ClusterPoint[], ctx: {
-        screenPosition: Cesium.Cartesian2;
-        worldPosition?: Cesium.Cartesian3;
-    }) => void;
-    /** 点击单点回调 */
-    onPointClick?: (point: ClusterPoint, ctx: {
-        screenPosition: Cesium.Cartesian2;
-        worldPosition?: Cesium.Cartesian3;
-    }) => void;
-    /** entity id 前缀（用于避免与外部实体冲突） */
-    idPrefix?: string;
-}
-export default class CesiumPointClusterLayer {
-    private static readonly CLUSTER_STYLE_MIN_INTERVAL_MS;
-    private static readonly CLICK_PICK_MIN_INTERVAL_MS;
-    private viewer;
-    private readonly options;
-    private dataSource;
-    private entityIdToPoint;
-    private clickHandler;
-    private readonly layerId;
-    private pendingClusterStyles;
-    private clusterStyleRAF;
-    private clusterStyleTimer;
-    private lastClusterStyleFlushTime;
-    private readonly pickGovernor;
-    constructor(viewer: Viewer, options?: PointClusterLayerOptions);
-    /** 设置/替换点数据（经纬度单位：度） */
-    setData(points: ClusterPoint[]): void;
-    setVisible(visible: boolean): void;
-    setClusteringEnabled(enabled: boolean): void;
-    destroy(): void;
-    private enqueueClusterStyle;
-    private flushClusterStyles;
-    private applyClusterStyle;
-    private pickStyle;
-    private installClickHandler;
-}
-export { CesiumPointClusterLayer };

package/dist/libs/PickGovernor.d.ts

@@ -1,23 +0,0 @@
-export type PickGovernorKind = 'hover' | 'click' | 'cluster' | 'draw' | 'edit';
-export interface PickGovernorProfile {
-    minIntervalMs: number;
-    minMovePx: number;
-}
-export interface PickGovernorOptions {
-    profiles?: Partial<Record<PickGovernorKind, Partial<PickGovernorProfile>>>;
-}
-type PointLike = {
-    x: number;
-    y: number;
-};
-export declare function isMacPlatform(): boolean;
-export declare class PickGovernor {
-    private readonly profiles;
-    private readonly lastByKind;
-    private suspendUntil;
-    constructor(options?: PickGovernorOptions);
-    shouldPick(kind: PickGovernorKind, point: PointLike, nowMs?: number): boolean;
-    suspend(ms: number): void;
-    private isFinitePoint;
-}
-export {};

package/dist/libs/config/CesiumMapConfig.d.ts

@@ -1,13 +0,0 @@
-import { Viewer } from '../../../node_modules/cesium';
-import { default as DrawHelper } from '../CesiumMapDraw';
-import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback } from '../CesiumMapModel';
-export interface CesiumMapConfig {
-    viewer?: Viewer;
-    drawHelper?: DrawHelper;
-    toolbar?: ToolbarConfig;
-    search?: SearchCallback;
-    measurement?: MeasurementCallback;
-    zoom?: ZoomCallback;
-    mapTypes?: MapType[];
-}
-export declare const TDTMapTypes: MapType[];