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

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

@@ -1,121 +0,0 @@
-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

@@ -1,84 +0,0 @@
-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;
-    /** 缩放回调（来自 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 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

@@ -1,89 +0,0 @@
-import { Viewer } from '../../../node_modules/cesium';
-import { MapType } from '../CesiumMapModel';
-import { I18nLike } from '../../libs/i18n';
-/**
- * 图层服务配置接口
- */
-export interface MapLayersServiceConfig {
-    mapTypes: MapType[];
-    currentMapType: string;
-    token: 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 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): void;
-    /**
-     * 获取当前地图类型
-     */
-    getCurrentMapType(): string;
-    private setPlaceNameChecked;
-    private shouldEnablePlaceName;
-    private isSameProvider;
-    private resolveExistingPlaceNameLayer;
-    private ensurePlaceNameProvider;
-    private addPlaceNameLayer;
-    private removePlaceNameLayer;
-    /**
-     * 关闭图层菜单
-     */
-    closeLayersMenu(): void;
-    /**
-     * 销毁图层服务
-     */
-    destroy(): void;
-}

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

@@ -1,47 +0,0 @@
-import { Viewer } from '../../../node_modules/cesium';
-import { SearchResult, SearchCallback } from '../CesiumMapModel';
-import { I18nLike } from '../../libs/i18n';
-/**
- * 搜索服务类
- * 负责处理地图搜索相关的所有逻辑
- */
-export declare class SearchService {
-    private viewer;
-    private toolbarElement;
-    private searchCallback?;
-    private searchContainer;
-    private i18n;
-    private useI18n;
-    constructor(viewer: Viewer, toolbarElement: HTMLElement, searchCallback?: SearchCallback, options?: {
-        i18n?: I18nLike;
-        useI18n?: boolean;
-    });
-    /**
-     * 设置搜索回调
-     */
-    setSearchCallback(callback: SearchCallback): void;
-    /**
-     * 切换搜索功能
-     */
-    toggleSearch(buttonElement: HTMLElement): void;
-    /**
-     * 执行默认搜索（使用天地图 API）
-     */
-    private performDefaultSearch;
-    /**
-     * 显示搜索结果
-     */
-    displaySearchResults(results: SearchResult[], container: HTMLElement): void;
-    /**
-     * 选择搜索结果
-     */
-    selectSearchResult(result: SearchResult): void;
-    /**
-     * 关闭搜索框
-     */
-    closeSearchContainer(): void;
-    /**
-     * 销毁搜索服务
-     */
-    destroy(): void;
-}

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

@@ -1,10 +0,0 @@
-import { ButtonConfig, ToolbarConfig } from '../CesiumMapModel';
-export declare const defaultButtonSorts: Record<string, number>;
-export declare const defaultButtons: ButtonConfig[];
-export declare const defaultMeasureItems: {
-    id: string;
-    text: string;
-    textKey: string;
-    icon: string;
-}[];
-export declare const defaultToolBarStyle: ToolbarConfig;

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

@@ -1,16 +0,0 @@
-import { Viewer } from '../../../node_modules/cesium';
-import { default as DrawHelper } from '../CesiumMapDraw';
-import { MeasurementCallback } from '../CesiumMapModel';
-export type MeasureMode = 'none' | 'distance' | 'area';
-export declare class MeasurementService {
-    private viewer;
-    private drawHelper;
-    private measurementCallback?;
-    private currentMode;
-    constructor(viewer: Viewer, drawHelper: DrawHelper, measurementCallback?: MeasurementCallback);
-    getMeasureMode(): MeasureMode;
-    setupDrawHelperCallbacks(): void;
-    startAreaMeasurement(): void;
-    startDistanceMeasurement(): void;
-    clearMeasurements(): void;
-}

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

@@ -1,51 +0,0 @@
-import { Viewer } from '../../../node_modules/cesium';
-import { I18nLike } from '../../libs/i18n';
-/**
- * 禁飞区服务配置接口
- */
-export interface NotFlyZonesServiceConfig {
-    extrudedHeight?: number;
-    autoLoad?: boolean;
-    i18n?: I18nLike;
-    useI18n?: boolean;
-}
-/**
- * 禁飞区服务类
- * 负责处理机场禁飞区相关的所有逻辑
- */
-export declare class NotFlyZonesService {
-    private viewer;
-    private noFlyZoneEntities;
-    private isNoFlyZoneVisible;
-    private isNoFlyZoneLoading;
-    private readonly extrudedHeight;
-    private i18n;
-    private useI18n;
-    constructor(viewer: Viewer, config?: NotFlyZonesServiceConfig);
-    /**
-     * 加载并显示机场禁飞区
-     */
-    showNoFlyZones(): Promise<void>;
-    /**
-     * 隐藏机场禁飞区
-     */
-    hideNoFlyZones(): void;
-    /**
-     * 切换机场禁飞区显示状态
-     */
-    toggleNoFlyZones(): Promise<void>;
-    /**
-     * 获取禁飞区显示状态
-     */
-    getNoFlyZoneVisible(): boolean;
-    /**
-     * 创建禁飞区多边形配置选项
-     * @param positions - 多边形的顶点坐标数组，使用笛卡尔坐标系
-     * @returns 返回一个包含多边形图形配置选项的对象
-     */
-    private createNoFlyZonePolygonOptions;
-    /**
-     * 销毁禁飞区服务
-     */
-    destroy(): void;
-}

package/dist/package.json

@@ -1,46 +0,0 @@
-{
-  "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.5",
-  "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
-  "type": "module",
-  "main": "index.es.js",
-  "module": "index.es.js",
-  "types": "index.d.ts",
-  "files": [
-    "index.es.js",
-    "index.umd.js",
-    "index.d.ts",
-    "style.css",
-    "README.md",
-    "geojson"
-  ],
-  "exports": {
-    ".": {
-      "import": "./index.es.js",
-      "default": "./index.es.js"
-    },
-    "./style": "./style.css"
-  },
-  "peerDependencies": {
-    "vue": "^3.0.0"
-  },
-  "keywords": [
-    "cesium",
-    "map",
-    "toolbar",
-    "drawing",
-    "measurement",
-    "vue3",
-    "typescript"
-  ],
-  "author": "pengxueyou",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/BenXueYou/vmap-cesium-tool.git"
-  },
-  "bugs": {
-    "url": "https://github.com/BenXueYou/vmap-cesium-tool/issues"
-  },
-  "homepage": "https://github.com/BenXueYou/vmap-cesium-tool#readme"
-}

package/dist/utils/calc.d.ts

@@ -1,50 +0,0 @@
-import { Cartesian3, Ellipsoid, Rectangle } from '../../node_modules/cesium';
-/**
- * 判断一个 Cartesian3 是否为有效坐标（x/y/z 都是有限数字）
- */
-export declare function isValidCartesian3(pos: Cartesian3 | null | undefined): pos is Cartesian3;
-/**
- * 格式化距离显示
- * 超过1000m时转换为km，保留两位小数
- * @param distance 距离（米）
- * @returns 格式化后的距离字符串
- */
-export declare function formatDistance(distance: number): string;
-/**
- * 格式化面积显示
- * @param areaKm2 面积（平方公里）
- * @returns 格式化后的面积字符串
- */
-export declare function formatArea(areaKm2: number): string;
-/**
- * 计算矩形
- * @param p1 第一个点
- * @param p2 第二个点
- * @returns 矩形对象
- */
-export declare function calculateRectangle(p1: Cartesian3, p2: Cartesian3): Rectangle;
-/**
- * 计算矩形面积
- * @param rect 矩形对象
- * @returns 面积（平方公里）
- */
-export declare function calculateRectangleArea(rect: Rectangle): number;
-/**
- * 计算多边形面积
- * @param positions 多边形顶点坐标数组
- * @param ellipsoid 椭球体对象（默认使用 WGS84）
- * @returns 面积（平方公里）
- */
-export declare function calculatePolygonArea(positions: Cartesian3[], ellipsoid?: Ellipsoid): number;
-/**
- * 计算多边形中心点
- * @param positions 多边形顶点坐标数组
- * @returns 中心点坐标
- */
-export declare function calculatePolygonCenter(positions: Cartesian3[]): Cartesian3;
-/**
- * 计算折线总长度
- * @param positions 折线顶点坐标数组
- * @returns 总长度（米）
- */
-export declare function calculatePolylineDistance(positions: Cartesian3[]): number;

package/dist/utils/common.d.ts

@@ -1,14 +0,0 @@
-export declare function getViteTdToken(): any;
-export declare function getViteCesiumToken(): any;
-/**
- * 将相机高度转换为地图层级
- * @param height 相机高度（米）
- * @returns 地图层级（1-18）
- */
-export declare function heightToZoomLevel(height: number): number;
-/**
- * 将地图层级转换为相机高度
- * @param zoomLevel 地图层级（1-18）
- * @returns 相机高度（米）
- */
-export declare function zoomLevelToHeight(zoomLevel: number): number;

package/dist/utils/geojson.d.ts

@@ -1,86 +0,0 @@
-/**
- * GeoJSON 类型定义
- */
-export interface GeoJSONPoint {
-    type: 'Point';
-    coordinates: [number, number];
-}
-export interface GeoJSONPolygon {
-    type: 'Polygon';
-    coordinates: number[][][];
-}
-export interface GeoJSONFeature<T = GeoJSONPolygon> {
-    type: 'Feature';
-    geometry: T;
-    properties?: Record<string, any>;
-}
-export interface GeoJSONFeatureCollection<T = GeoJSONPolygon> {
-    type: 'FeatureCollection';
-    features: GeoJSONFeature<T>[];
-    name?: string;
-}
-/**
- * 机场禁飞区数据接口
- */
-export interface AirportNoFlyZone {
-    name: string;
-    feature: GeoJSONFeature<GeoJSONPolygon>;
-    fileName: string;
-}
-/**
- * GeoJSON 加载配置
- */
-export interface GeoJSONLoaderConfig {
-    /**
-     * GeoJSON 文件的基础路径
-     * 开发环境: '/geojson' (指向 public/geojson)
-     * 生产环境: 可以是 '/geojson' 或用户自定义路径
-     * @default '/geojson'
-     */
-    basePath?: string;
-    /**
-     * 是否在加载失败时静默处理（不抛出错误）
-     * @default false
-     */
-    silent?: boolean;
-}
-/**
- * 读取所有机场禁飞区 GeoJSON 文件
- *
- * 注意：由于无法直接获取目录文件列表，需要提供文件列表
- * 可以通过以下方式之一：
- * 1. 提供 fileList 参数
- * 2. 在 public/geojson 目录下放置 file-list.json 文件
- * 3. 使用 getAllAirportNoFlyZonesWithList 方法
- *
- * @param fileList 可选的文件名列表（不含扩展名）
- * @param config 加载配置
- * @returns Promise<AirportNoFlyZone[]> 机场禁飞区数据数组
- */
-export declare function loadAllAirportNoFlyZones(fileList?: string[], config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone[]>;
-/**
- * 读取单个机场禁飞区 GeoJSON 文件
- * @param fileName 文件名（不含扩展名，如 '珠海_金湾机场'）
- * @param config 加载配置
- * @returns Promise<AirportNoFlyZone | null> 机场禁飞区数据或 null
- */
-export declare function loadAirportNoFlyZone(fileName: string, config?: GeoJSONLoaderConfig): Promise<AirportNoFlyZone | null>;
-/**
- * 将 GeoJSON 坐标转换为 Cesium Cartesian3 数组
- * @param coordinates GeoJSON 多边形坐标数组
- * @param height 高度偏移（米），默认为 0
- * @returns 包含 longitude, latitude, height 的对象数组
- */
-export declare function geojsonCoordinatesToCartesian3(coordinates: number[][], height?: number): Array<{
-    longitude: number;
-    latitude: number;
-    height: number;
-}>;
-/**
- * 从文件名列表生成 file-list.json
- * 这个函数可以在构建时使用，生成文件列表
- *
- * @param fileNames 文件名列表（不含扩展名）
- * @returns JSON 字符串
- */
-export declare function generateFileListJson(fileNames: string[]): string;

package/dist/utils/selfIntersection.d.ts

@@ -1,15 +0,0 @@
-import { Cartesian3 } from '../../node_modules/cesium';
-export type IntersectionKind = "none" | "touch" | "cross" | "overlap";
-/**
- * Returns true if adding `nextPoint` to an open polygon polyline would create a self-intersection.
- */
-export declare function wouldCreatePolygonSelfIntersection(existingPoints: Cartesian3[], nextPoint: Cartesian3, opts?: {
-    allowTouch?: boolean;
-}): boolean;
-export declare function wouldCreatePolygonSelfIntersectionKind(existingPoints: Cartesian3[], nextPoint: Cartesian3): IntersectionKind;
-/**
- * Returns true if the closed polygon described by `points` is self-intersecting.
- */
-export declare function isClosedPolygonSelfIntersecting(points: Cartesian3[], opts?: {
-    allowTouch?: boolean;
-}): boolean;

package/dist/z.const.d.ts

@@ -1,24 +0,0 @@
-export declare const defaultHeatmapData: ({
-    lon: string;
-    lat: string;
-    height: string;
-    appearTime: number;
-    lng?: undefined;
-} | {
-    lng: string;
-    lat: string;
-    height: string;
-    appearTime: number;
-    lon?: undefined;
-})[][];
-export declare const defaultHeatmapColors: {
-    0: string;
-    40: string;
-    60: string;
-    90: string;
-    110: string;
-};
-export declare const defaultHeatmapOpacity: {
-    0: number;
-    0.5: number;
-};