@xingm/vmap-cesium-toolbar 0.0.6 → 1.0.0

package/dist/components/Toolbar.d.ts

@@ -0,0 +1,115 @@
+import { BaseComponent } from './BaseComponent';
+import { ToolbarButton } from './ToolbarButton';
+import { ToolbarConfig, CustomButtonConfig, StyleConfig } from '../core/types';
+/**
+ * 工具栏组件
+ */
+export declare class Toolbar extends BaseComponent {
+    private config;
+    private buttons;
+    private buttonContainer;
+    /**
+     * 构造函数
+     * @param config 工具栏配置
+     * @param styleConfig 样式配置
+     */
+    constructor(config?: Partial<ToolbarConfig>, styleConfig?: StyleConfig);
+    /**
+     * 获取位置样式（静态方法）
+     */
+    private static getPositionStyle;
+    /**
+     * 获取位置样式（实例方法）
+     */
+    private getPositionStyle;
+    /**
+     * 应用配置
+     */
+    private applyConfig;
+    /**
+     * 添加按钮
+     * @param buttonConfig 按钮配置
+     * @returns 创建的按钮实例
+     */
+    addButton(buttonConfig: CustomButtonConfig): ToolbarButton;
+    /**
+     * 移除按钮
+     * @param buttonId 按钮ID
+     */
+    removeButton(buttonId: string): boolean;
+    /**
+     * 获取按钮
+     * @param buttonId 按钮ID
+     */
+    getButton(buttonId: string): ToolbarButton | undefined;
+    /**
+     * 获取所有按钮
+     */
+    getButtons(): ToolbarButton[];
+    /**
+     * 更新按钮配置
+     * @param buttonId 按钮ID
+     * @param config 新的按钮配置
+     */
+    updateButton(buttonId: string, config: Partial<CustomButtonConfig>): boolean;
+    /**
+     * 排序按钮
+     */
+    private sortButtons;
+    /**
+     * 启用按钮
+     * @param buttonId 按钮ID
+     */
+    enableButton(buttonId: string): boolean;
+    /**
+     * 禁用按钮
+     * @param buttonId 按钮ID
+     */
+    disableButton(buttonId: string): boolean;
+    /**
+     * 显示按钮
+     * @param buttonId 按钮ID
+     */
+    showButton(buttonId: string): boolean;
+    /**
+     * 隐藏按钮
+     * @param buttonId 按钮ID
+     */
+    hideButton(buttonId: string): boolean;
+    /**
+     * 激活按钮
+     * @param buttonId 按钮ID
+     */
+    activateButton(buttonId: string): boolean;
+    /**
+     * 取消激活按钮
+     * @param buttonId 按钮ID
+     */
+    deactivateButton(buttonId: string): boolean;
+    /**
+     * 更新工具栏配置
+     * @param config 新的工具栏配置
+     */
+    updateConfig(config: Partial<ToolbarConfig>): void;
+    /**
+     * 获取工具栏配置
+     */
+    getConfig(): ToolbarConfig;
+    /**
+     * 清空所有按钮
+     */
+    clearButtons(): void;
+    /**
+     * 添加多个按钮
+     * @param buttonConfigs 按钮配置数组
+     */
+    addButtons(buttonConfigs: CustomButtonConfig[]): ToolbarButton[];
+    /**
+     * 销毁工具栏
+     */
+    destroy(): void;
+}
+/**
+ * 创建工具栏的工厂函数
+ */
+export declare function createToolbar(config?: Partial<ToolbarConfig>, styleConfig?: StyleConfig): Toolbar;

package/dist/components/ToolbarButton.d.ts

@@ -0,0 +1,100 @@
+import { BaseComponent } from './BaseComponent';
+import { CustomButtonConfig, StyleConfig } from '../core/types';
+/**
+ * 工具栏按钮组件
+ */
+export declare class ToolbarButton extends BaseComponent {
+    private config;
+    private onClickHandler?;
+    private isActive;
+    private static readonly DEFAULT_TITLES;
+    /**
+     * 构造函数
+     * @param config 按钮配置
+     * @param styleConfig 样式配置
+     */
+    constructor(config: CustomButtonConfig, styleConfig?: StyleConfig);
+    /**
+     * 设置按钮
+     */
+    private setupButton;
+    /**
+     * 设置图标
+     * @param icon 图标配置
+     */
+    private setIcon;
+    /**
+     * 判断是否为图片路径
+     */
+    private isImagePath;
+    private getResolvedTitle;
+    /**
+     * 处理点击事件
+     */
+    private handleClick;
+    /**
+     * 处理鼠标进入事件
+     */
+    private handleMouseEnter;
+    /**
+     * 处理鼠标离开事件
+     */
+    private handleMouseLeave;
+    /**
+     * 激活按钮
+     */
+    activate(): void;
+    /**
+     * 取消激活按钮
+     */
+    deactivate(): void;
+    /**
+     * 切换激活状态
+     */
+    toggleActive(): void;
+    /**
+     * 启用按钮
+     */
+    enable(): void;
+    /**
+     * 禁用按钮
+     */
+    disable(): void;
+    /**
+     * 显示按钮
+     */
+    show(): void;
+    /**
+     * 隐藏按钮
+     */
+    hide(): void;
+    /**
+     * 更新按钮配置
+     * @param config 新的按钮配置
+     */
+    updateConfig(config: Partial<CustomButtonConfig>): void;
+    /**
+     * 获取按钮配置
+     */
+    getConfig(): CustomButtonConfig;
+    /**
+     * 获取按钮ID
+     */
+    getId(): string;
+    /**
+     * 检查是否激活
+     */
+    isButtonActive(): boolean;
+    /**
+     * 检查是否启用
+     */
+    isButtonEnabled(): boolean;
+    /**
+     * 检查是否可见
+     */
+    isButtonVisible(): boolean;
+}
+/**
+ * 创建工具栏按钮的工厂函数
+ */
+export declare function createToolbarButton(config: CustomButtonConfig, styleConfig?: StyleConfig): ToolbarButton;

package/dist/components/index.d.ts

@@ -0,0 +1,33 @@
+import { BaseComponent, createComponent } from './BaseComponent';
+import { ToolbarButton, createToolbarButton } from './ToolbarButton';
+import { Toolbar, createToolbar } from './Toolbar';
+import { SearchBox, createSearchBox } from './SearchBox';
+export { BaseComponent, createComponent } from './BaseComponent';
+export { ToolbarButton, createToolbarButton } from './ToolbarButton';
+export { Toolbar, createToolbar } from './Toolbar';
+export { SearchBox, createSearchBox, type SearchBoxConfig } from './SearchBox';
+export type { StyleConfig } from '../core/types';
+/**
+ * 组件模块版本信息
+ */
+export declare const VERSION = "1.0.0";
+/**
+ * 组件模块描述
+ */
+export declare const DESCRIPTION = "VMap Cesium Tool \u7EC4\u4EF6\u6A21\u5757 - \u63D0\u4F9B\u53EF\u91CD\u7528\u7684UI\u7EC4\u4EF6\uFF0C\u652F\u6301\u6837\u5F0F\u9694\u79BB\u548C\u81EA\u5B9A\u4E49";
+/**
+ * 默认导出组件模块
+ */
+declare const componentsModule: {
+    VERSION: string;
+    DESCRIPTION: string;
+    BaseComponent: typeof BaseComponent;
+    ToolbarButton: typeof ToolbarButton;
+    Toolbar: typeof Toolbar;
+    SearchBox: typeof SearchBox;
+    createComponent: typeof createComponent;
+    createToolbarButton: typeof createToolbarButton;
+    createToolbar: typeof createToolbar;
+    createSearchBox: typeof createSearchBox;
+};
+export default componentsModule;

package/dist/core/MapPlugin.d.ts

@@ -0,0 +1,160 @@
+import { CameraConfig, DrawPluginOptions, LayersConfig, MapPluginOptions, OverlayPluginOptions, ToolbarConfig, ToolbarPluginOptions } from './types';
+import { OverlayService } from './services/overlay/OverlayService';
+import { DrawService } from './services/draw/DrawService';
+import { ToolbarService } from './services/toolbar/ToolbarService';
+import * as Cesium from 'cesium';
+/**
+ * 地图插件核心类
+ * 负责整合所有地图功能，提供统一的 API 接口
+ */
+export declare class MapPlugin {
+    private viewer;
+    private containerId;
+    private viewerOptions;
+    private cameraConfig;
+    private layersConfig;
+    private cesiumToken;
+    private toolbarConfig;
+    private toolbarLayersMenuConfig;
+    private servicesConfig;
+    private noFlyZoneConfig;
+    private initialCenter;
+    private toolbarController;
+    private toolbarMapTypes;
+    private currentMapTypeId;
+    private placeNameVisible;
+    private noFlyZoneVisible;
+    private noFlyZoneDataSource;
+    private noFlyZoneLoadPromise;
+    private currentGeoWTFS;
+    private sceneModeListenerDispose;
+    private toolbarService;
+    private overlayService;
+    private drawService;
+    private isInitialized;
+    /**
+     * 构造函数
+     * @param containerId 地图容器 ID
+     * @param options 地图插件配置选项
+     */
+    constructor(containerId: string, options?: Partial<MapPluginOptions>);
+    private getToolbarConfig;
+    private getToolbarLayersMenuConfig;
+    private resolveNoFlyZoneConfig;
+    private toInitialCenter;
+    private isServiceEnabled;
+    private getServiceConfig;
+    private ensureViewer;
+    private getToolbarContainer;
+    private getToolbarController;
+    private initializeServices;
+    /**
+     * 合并相机配置
+     */
+    private mergeCameraConfig;
+    /**
+     * 合并图层配置
+     */
+    private mergeLayersConfig;
+    private resolveCurrentMapTypeId;
+    private resolvePlaceNameVisible;
+    private getToolbarMapTypes;
+    private getCurrentToolbarMapType;
+    private getLayerToken;
+    private ensureNoFlyZoneDataSource;
+    private destroyGeoWTFS;
+    private syncGeoWTFS;
+    private updateToolbarLayerState;
+    private createLayersServiceBridge;
+    private setMapType;
+    private setPlaceNameVisible;
+    private showNoFlyZones;
+    private hideNoFlyZones;
+    private toggleNoFlyZones;
+    /**
+     * 初始化地图
+     */
+    initialize(): Promise<Cesium.Viewer>;
+    /**
+     * 添加地图图层
+     */
+    private addLayers;
+    /**
+     * 添加天地图图层
+     */
+    private addTDTLayers;
+    /**
+     * 添加高德地图图层
+     */
+    private addGaodeLayers;
+    /**
+     * 添加百度地图图层
+     */
+    private addBaiduLayers;
+    /**
+     * 添加 OSM 图层
+     */
+    private addOSMLayers;
+    /**
+     * 添加自定义图层
+     */
+    private addCustomLayers;
+    /**
+     * 设置相机视图
+     */
+    private setCameraView;
+    /**
+     * 获取 Cesium Viewer 实例
+     */
+    getViewer(): Cesium.Viewer | null;
+    /**
+     * 获取当前配置
+     */
+    getConfig(): MapPluginOptions;
+    /**
+     * 更新相机配置
+     */
+    updateCamera(config: Partial<CameraConfig>): void;
+    /**
+     * 更新图层配置
+     */
+    updateLayers(config: Partial<LayersConfig>): void;
+    /**
+     * 创建 ToolbarService
+     */
+    createToolbarService(options?: ToolbarPluginOptions): ToolbarService;
+    /**
+     * 获取 ToolbarService
+     */
+    getToolbarService(): ToolbarService | null;
+    /**
+     * 创建 OverlayService
+     */
+    createOverlayService(options?: OverlayPluginOptions): OverlayService;
+    /**
+     * 获取 OverlayService
+     */
+    getOverlayService(): OverlayService;
+    /**
+     * 创建 DrawService
+     */
+    createDrawService(options?: DrawPluginOptions): DrawService;
+    /**
+     * 获取 DrawService
+     */
+    getDrawService(): DrawService;
+    /**
+     * 销毁插件
+     */
+    destroy(): void;
+    /**
+     * 检查是否已初始化
+     */
+    isReady(): boolean;
+}
+/**
+ * 创建地图插件实例的工厂函数
+ * @param containerId 地图容器 ID
+ * @param options 地图插件配置选项
+ */
+export declare function createMapPlugin(containerId: string, options?: Partial<MapPluginOptions>, toolbarConfig?: ToolbarConfig): MapPlugin;

package/dist/core/constants.d.ts

@@ -0,0 +1,88 @@
+import { TDTLayerConfig } from './types';
+export { DEFAULT_BUTTON_SORTS, DEFAULT_BUTTON_CONFIGS, DEFAULT_MEASURE_ITEMS, DEFAULT_TOOLBAR_STYLE, DEFAULT_MAP_TYPES, } from './services/toolbar/config';
+/**
+ * 核心常量定义
+ */
+export declare const DEFAULT_CAMERA_CONFIG: {
+    center: [number, number, number];
+    pitch: number;
+    heading: number;
+    roll: number;
+};
+/**
+ * 默认图层提供商类型
+ */
+export declare const DEFAULT_PROVIDER_TYPE: 'tdt';
+/**
+ * 默认天地图配置
+ */
+export declare const DEFAULT_TDT_CONFIG: TDTLayerConfig;
+export declare const DEFAULT_MAP_CENTER: {
+    longitude: number;
+    latitude: number;
+    height: number;
+};
+export declare const DEFAULT_ZOOM_LEVELS: number[];
+export declare const DEFAULT_ZOOM_INDEX = 3;
+export declare const CSS_CLASSES: {
+    TOOLBAR: string;
+    TOOLBAR_BUTTON: string;
+    SEARCH_CONTAINER: string;
+    SEARCH_RESULTS: string;
+    MEASUREMENT_MENU: string;
+    LAYERS_MENU: string;
+    MAP_TYPE_ITEM: string;
+    MAP_TYPE_THUMBNAIL: string;
+    MAP_TYPE_CHECKMARK: string;
+    SELECTED: string;
+};
+export declare const EVENT_NAMES: {
+    BUTTON_CLICK: string;
+    SEARCH_START: string;
+    SEARCH_COMPLETE: string;
+    SEARCH_SELECT: string;
+    MEASUREMENT_START: string;
+    MEASUREMENT_COMPLETE: string;
+    MEASUREMENT_CLEAR: string;
+    LAYER_CHANGE: string;
+    VIEW_MODE_CHANGE: string;
+    ZOOM_CHANGE: string;
+    FULLSCREEN_CHANGE: string;
+};
+export declare const STYLE_PREFIX = "vmap-cesium-";
+declare const _default: {
+    DEFAULT_MAP_CENTER: {
+        longitude: number;
+        latitude: number;
+        height: number;
+    };
+    DEFAULT_ZOOM_LEVELS: number[];
+    DEFAULT_ZOOM_INDEX: number;
+    CSS_CLASSES: {
+        TOOLBAR: string;
+        TOOLBAR_BUTTON: string;
+        SEARCH_CONTAINER: string;
+        SEARCH_RESULTS: string;
+        MEASUREMENT_MENU: string;
+        LAYERS_MENU: string;
+        MAP_TYPE_ITEM: string;
+        MAP_TYPE_THUMBNAIL: string;
+        MAP_TYPE_CHECKMARK: string;
+        SELECTED: string;
+    };
+    EVENT_NAMES: {
+        BUTTON_CLICK: string;
+        SEARCH_START: string;
+        SEARCH_COMPLETE: string;
+        SEARCH_SELECT: string;
+        MEASUREMENT_START: string;
+        MEASUREMENT_COMPLETE: string;
+        MEASUREMENT_CLEAR: string;
+        LAYER_CHANGE: string;
+        VIEW_MODE_CHANGE: string;
+        ZOOM_CHANGE: string;
+        FULLSCREEN_CHANGE: string;
+    };
+    STYLE_PREFIX: string;
+};
+export default _default;

package/dist/core/entities/BaseOverlay.d.ts

@@ -0,0 +1,156 @@
+import { Viewer, Entity } from '../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+/**
+ * 覆盖物位置类型
+ */
+export type OverlayPosition = Cesium.Cartesian3 | [number, number] | [number, number, number];
+/**
+ * 基础覆盖物配置选项
+ */
+export interface BaseOverlayOptions {
+    /** 唯一标识符（可选，不传则自动生成） */
+    id?: string;
+    /** 位置（笛卡尔坐标或经纬度数组） */
+    position?: OverlayPosition;
+    /** 是否显示（默认 true） */
+    show?: boolean;
+    /** 点击回调函数 */
+    onClick?: (entity: Entity) => void;
+    /** 点击高亮配置 */
+    clickHighlight?: boolean | OverlayClickHighlightOptions;
+    /** Hover 高亮配置 */
+    hoverHighlight?: boolean | OverlayHoverHighlightOptions;
+    /** 自定义元数据 */
+    metadata?: Record<string, any>;
+    /** 兼容旧版图层分组键 */
+    layerKey?: string;
+}
+/** 点击高亮配置 */
+export interface OverlayClickHighlightOptions {
+    /** 高亮主颜色（默认 yellow） */
+    color?: Cesium.Color | string;
+    /** 面填充透明度（默认 0.35） */
+    fillAlpha?: number;
+}
+/** Hover 高亮配置（与 clickHighlight 使用同样的参数结构） */
+export type OverlayHoverHighlightOptions = OverlayClickHighlightOptions;
+/**
+ * 覆盖物扩展实体类型
+ * 用于在 Cesium.Entity 上挂载覆盖物相关的元数据
+ */
+export interface OverlayEntity extends Entity {
+    /** 覆盖物点击回调 */
+    _onClick?: (entity: Entity) => void;
+    /** 点击高亮配置 */
+    _clickHighlight?: boolean | OverlayClickHighlightOptions;
+    /** Hover 高亮配置 */
+    _hoverHighlight?: boolean | OverlayHoverHighlightOptions;
+    /** 高亮联动的实体集合 */
+    _highlightEntities?: Entity[];
+    /** 当前是否处于高亮状态 */
+    _isHighlighted?: boolean;
+    /** 当前高亮原因（click/hover） */
+    _highlightState?: {
+        click?: boolean;
+        hover?: boolean;
+    };
+    /** 覆盖物类型标识 */
+    _overlayType?: string;
+    /** 信息窗口根 DOM */
+    _infoWindow?: HTMLElement;
+    /** 复合图形的内层实体或边框实体 */
+    _borderEntity?: Entity;
+    _innerEntity?: Entity;
+    /** 贴地标志 */
+    _clampToGround?: boolean;
+    /** 基准高度（米） */
+    _baseHeight?: number;
+    /** 绘制类型标识（如果是由 DrawService 创建） */
+    _drawType?: string;
+    /** 绘制配置 */
+    _drawOptions?: any;
+    /** 地面位置缓存 */
+    _groundPosition?: Cesium.Cartesian3;
+    _groundPositions?: Cesium.Cartesian3[];
+    /** 标签实体列表 */
+    _labelEntities?: Entity[];
+    /** 关联的覆盖物 ID */
+    _overlayId?: string;
+    /** 旧版圆环/粗边框标记 */
+    _isRing?: boolean;
+    _ringThickness?: number;
+    _primitiveLayerKey?: string;
+}
+/**
+ * 覆盖物基类
+ * 所有具体覆盖物类（Marker, Polygon, Circle 等）的父类
+ *
+ * @example
+ * ```typescript
+ * const marker = new Marker(viewer, {
+ *   position: [120.1, 30.2],
+ *   onClick: (entity) => console.log('clicked', entity)
+ * });
+ * ```
+ */
+export declare abstract class BaseOverlay {
+    /** Cesium Viewer 实例 */
+    protected viewer: Viewer;
+    /** Cesium Entity 实例 */
+    protected entity: Entity;
+    /** 覆盖物配置选项 */
+    protected options: BaseOverlayOptions;
+    /** 是否已销毁 */
+    protected destroyed: boolean;
+    /**
+     * 构造函数
+     * @param viewer - Cesium Viewer 实例
+     * @param options - 基础配置选项
+     */
+    constructor(viewer: Viewer, options?: BaseOverlayOptions);
+    /**
+     * 生成唯一 ID
+     */
+    protected generateId(prefix?: string): string;
+    /**
+     * 将位置转换为 Cartesian3 坐标
+     */
+    protected toCartesian3(position?: OverlayPosition): Cesium.Cartesian3 | undefined;
+    /**
+     * 将 Cartesian3 坐标转换为经纬度
+     */
+    protected toLngLat(cartesian: Cesium.Cartesian3): [number, number];
+    /**
+     * 获取 Entity 实例
+     */
+    getEntity(): Entity;
+    /**
+     * 获取覆盖物 ID
+     */
+    getId(): string;
+    /**
+     * 设置是否显示
+     */
+    setVisible(show: boolean): void;
+    /**
+     * 获取是否显示
+     */
+    isVisible(): boolean;
+    /**
+     * 更新配置
+     * @param options - 新的配置选项
+     */
+    abstract update(options: Partial<BaseOverlayOptions & any>): void;
+    /**
+     * 从场景中移除覆盖物
+     */
+    remove(): void;
+    /**
+     * 销毁覆盖物（别名，与 remove 相同）
+     */
+    destroy(): void;
+    /**
+     * 检查是否已销毁
+     */
+    isDestroyed(): boolean;
+}