@xingm/vmap-cesium-toolbar 0.0.5 → 1.0.0

package/dist/adapters/DrawHelperAdapter.d.ts

@@ -0,0 +1,143 @@
+import { Viewer, Entity, Cartesian3 } from '../../node_modules/cesium';
+import { DrawMode, MeasurementTheme, MeasurementSummaryLabelStyle } from '../core/services/draw/DrawService';
+import * as Cesium from 'cesium';
+/**
+ * 旧版绘制回调接口（保持向后兼容）
+ */
+export interface LegacyDrawCallbacks {
+    onDrawStart?: () => void;
+    onDrawEnd?: (entity: Entity | null) => void;
+    onEntityRemoved?: (entity: Entity) => void;
+    onMeasureComplete?: (result: {
+        type: 'line' | 'polygon' | 'rectangle' | 'circle';
+        positions: Cartesian3[];
+        distance?: number;
+        areaKm2?: number;
+    }) => void;
+}
+/**
+ * 旧版绘制选项接口（保持向后兼容）
+ */
+export interface LegacyDrawOptions {
+    measurementTheme?: MeasurementTheme;
+    lineColor?: Cesium.Color | string;
+    lineWidth?: number;
+    fillColor?: Cesium.Color | string;
+    clampToGround?: boolean;
+    segmentDistanceLabelStyle?: MeasurementSummaryLabelStyle;
+    totalDistanceLabelStyle?: MeasurementSummaryLabelStyle;
+    previewAreaLabelStyle?: MeasurementSummaryLabelStyle;
+    totalAreaLabelStyle?: MeasurementSummaryLabelStyle;
+    hintBubbleStyle?: MeasurementSummaryLabelStyle;
+    onClick?: (entity: Entity, positions?: Cartesian3[]) => void;
+}
+/**
+ * 旧版绘制实体类型（保持向后兼容）
+ */
+export interface LegacyDrawEntity extends Entity {
+    _drawType?: string;
+    _drawOptions?: LegacyDrawOptions;
+    _groundPositions?: Cartesian3[];
+    _groundPosition?: Cartesian3;
+    _labelEntities?: Entity[];
+}
+/**
+ * DrawHelper 适配器
+ *
+ * 基于新的 DrawService 架构，提供与旧版 DrawHelper 兼容的 API。
+ * 用于平滑迁移，让现有代码无需修改即可使用新架构。
+ *
+ * @example
+ * ```typescript
+ * // 旧代码可以继续使用，无需修改
+ * const drawHelper = new DrawHelperAdapter(viewer);
+ * drawHelper.startDrawingLine({ lineColor: '#FF0000' });
+ * ```
+ */
+export declare class DrawHelperAdapter {
+    private viewer;
+    private drawService;
+    private callbacks;
+    constructor(viewer: Viewer);
+    /**
+     * 映射绘制模式到类型字符串
+     */
+    private mapDrawModeToType;
+    /**
+     * 转换选项格式
+     */
+    private convertOptions;
+    /**
+     * 开始绘制线
+     */
+    startDrawingLine(options?: LegacyDrawOptions): void;
+    /**
+     * 开始绘制多边形
+     */
+    startDrawingPolygon(options?: LegacyDrawOptions): void;
+    /**
+     * 开始绘制矩形
+     */
+    startDrawingRectangle(options?: LegacyDrawOptions): void;
+    /**
+     * 开始绘制圆形
+     */
+    startDrawingCircle(options?: LegacyDrawOptions): void;
+    /**
+     * 结束绘制
+     */
+    endDrawing(): void;
+    /**
+     * 取消绘制
+     */
+    cancelDrawing(): void;
+    /**
+     * 清除所有绘制
+     */
+    clearAll(): void;
+    /**
+     * 删除指定实体
+     */
+    removeEntity(entity: Entity): void;
+    /**
+     * 获取已完成的实体
+     */
+    getFinishedEntities(): Entity[];
+    /**
+     * 检查是否正在绘制
+     */
+    isDrawing(): boolean;
+    /**
+     * 获取当前绘制模式
+     */
+    getCurrentDrawMode(): DrawMode;
+    /**
+     * 设置绘制开始回调
+     */
+    onDrawStart(callback: () => void): void;
+    /**
+     * 设置绘制结束回调
+     */
+    onDrawEnd(callback: (entity: Entity | null) => void): void;
+    /**
+     * 设置实体移除回调
+     */
+    onEntityRemoved(callback: (entity: Entity) => void): void;
+    /**
+     * 设置测量完成回调
+     */
+    onMeasureComplete(callback: (result: {
+        type: 'line' | 'polygon' | 'rectangle' | 'circle';
+        positions: Cartesian3[];
+        distance?: number;
+        areaKm2?: number;
+    }) => void): void;
+    /**
+     * 销毁助手
+     */
+    destroy(): void;
+}
+/**
+ * 创建 DrawHelperAdapter 的工厂函数
+ */
+export declare function createDrawHelperAdapter(viewer: Viewer): DrawHelperAdapter;

package/dist/adapters/MapLoaderAdapter.d.ts

@@ -0,0 +1,44 @@
+import { Viewer } from '../../node_modules/cesium';
+import { MapPlugin } from '../core/MapPlugin';
+import * as Cesium from 'cesium';
+export interface LegacyMapCenter {
+    latitude: number;
+    longitude: number;
+    height: number;
+    pitch?: number;
+    heading?: number;
+}
+export interface LegacyInitOptions {
+    viewerOptions?: Cesium.Viewer.ConstructorOptions;
+    mapType?: string;
+    tdtMapTypeId?: string;
+    token?: string;
+    cesiumToken?: string;
+    loadNoFlyZonesOnInit?: boolean;
+    mapCenter?: LegacyMapCenter;
+    isFly?: boolean;
+    flyDuration?: number;
+    success?: () => void;
+    cancel?: () => void;
+    animation?: boolean;
+    timeline?: boolean;
+    navigationHelpButton?: boolean;
+    fullscreenButton?: boolean;
+    geocoder?: boolean;
+    homeButton?: boolean;
+    infoBox?: boolean;
+    sceneModePicker?: boolean;
+    baseLayerPicker?: boolean;
+    selectionIndicator?: boolean;
+    [key: string]: unknown;
+}
+export interface LegacyInitResult {
+    viewer: Viewer;
+    initialCenter: LegacyMapCenter;
+    mapPlugin: MapPlugin;
+}
+/**
+ * initCesium 兼容适配器。
+ * 旧函数签名保持不变，内部切换到 MapPlugin。
+ */
+export declare function initCesium(containerId: string, options?: LegacyInitOptions, mapCenterOrCesiumToken?: LegacyMapCenter | string, cesiumToken?: string): Promise<LegacyInitResult>;

package/dist/adapters/OverlayServiceAdapter.d.ts

@@ -0,0 +1,102 @@
+import { Viewer, Entity } from '../../node_modules/cesium';
+import { OverlayService, OverlayServiceOptions } from '../core/services/overlay/OverlayService';
+import { MarkerOptions, LabelOptions, IconOptions, SvgOptions, InfoWindowOptions, PolylineOptions, PolygonOptions, RectangleOptions, CircleOptions, RingOptions, OverlayEntity } from '../core/entities';
+/**
+ * 旧版覆盖物服务选项（保持向后兼容）
+ */
+export interface LegacyCesiumOverlayServiceOptions extends OverlayServiceOptions {
+    /** 是否启用 hover 处理器 */
+    enableHoverHandler?: boolean;
+    /** 点击节流间隔 */
+    clickPickMinIntervalMs?: number;
+}
+/**
+ * OverlayService 适配器
+ *
+ * 基于新的 OverlayService 架构，提供与旧版 CesiumOverlayService 兼容的 API。
+ * 用于平滑迁移，让现有代码无需修改即可使用新架构。
+ *
+ * @example
+ * ```typescript
+ * // 旧代码可以继续使用，无需修改
+ * const overlayService = new OverlayServiceAdapter(viewer);
+ * const marker = overlayService.addMarker({ position: [120.1, 30.2] });
+ * const polygon = overlayService.addPolygon({ positions: [[120.1, 30.2], [120.2, 30.3]] });
+ * ```
+ */
+export declare class OverlayServiceAdapter {
+    private viewer;
+    private overlayService;
+    constructor(viewer: Viewer, options?: LegacyCesiumOverlayServiceOptions);
+    /**
+     * 添加 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;
+    /**
+     * 设置覆盖物可见性
+     */
+    setOverlayVisible(id: string, visible: boolean): boolean;
+    /**
+     * 获取所有覆盖物 ID
+     */
+    getAllOverlayIds(): string[];
+    toggleOverlayHighlight(entityOrId: OverlayEntity | Entity | string, reason?: 'click' | 'hover'): boolean;
+    setOverlayHighlight(entityOrId: OverlayEntity | Entity | string, enabled: boolean, reason?: 'click' | 'hover'): boolean;
+    getCoreService(): OverlayService;
+    /**
+     * 销毁服务
+     */
+    destroy(): void;
+}
+/**
+ * 创建 OverlayServiceAdapter 的工厂函数
+ */
+export declare function createOverlayServiceAdapter(viewer: Viewer, options?: LegacyCesiumOverlayServiceOptions): OverlayServiceAdapter;

package/dist/adapters/ToolbarAdapter.d.ts

@@ -0,0 +1,71 @@
+import { Viewer } from '../../node_modules/cesium';
+import { CustomButtonConfig, MapType, MeasurementCallback, SearchCallback, ToolbarConfig, ZoomCallback } from '../core/types';
+import { ToolbarService } from '../core/services/toolbar/ToolbarService';
+interface LegacyInitialCenter {
+    longitude: number;
+    latitude: number;
+    height: number;
+}
+export interface LegacyCesiumMapToolbarCallbacks {
+    search?: SearchCallback;
+    measurement?: MeasurementCallback;
+    zoom?: ZoomCallback;
+    fullscreen?: (isFullscreen: boolean) => void;
+    resetLocation?: () => void;
+}
+declare class ToolbarAdapterMapController {
+    private readonly viewer;
+    private initialCenter;
+    private readonly callbacks?;
+    constructor(viewer: Viewer, initialCenter: LegacyInitialCenter, callbacks?: {
+        zoom?: ZoomCallback;
+        fullscreen?: (isFullscreen: boolean) => void;
+        resetLocation?: () => void;
+    } | undefined);
+    toggle2D3D(): void;
+    resetLocation(): void;
+    zoomIn(): void;
+    zoomOut(): void;
+    toggleFullscreen(): void;
+    setInitialCenter(center: LegacyInitialCenter): void;
+    getInitialCenter(): LegacyInitialCenter;
+}
+/**
+ * CesiumMapToolbar 兼容适配器。
+ * 旧类名仍可继续使用，但内部已经转调新的 ToolbarService。
+ */
+export declare class ToolbarAdapter {
+    private readonly viewer;
+    private readonly container;
+    private readonly config;
+    private readonly callbacks?;
+    private readonly toolbarService;
+    private readonly drawHelper;
+    private readonly mapController;
+    private readonly i18nInstance;
+    private currentMapType;
+    TD_Token: string;
+    mapTypes: MapType[];
+    constructor(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: LegacyCesiumMapToolbarCallbacks, initialCenter?: LegacyInitialCenter);
+    private applyMapType;
+    private syncLayersHandler;
+    setMapType(mapTypeId: string): void;
+    getToolbarService(): ToolbarService;
+    getToolbarElement(): HTMLElement | null;
+    getCesiumMapCtrl(): ToolbarAdapterMapController;
+    setMapTypes(mapTypes: MapType[]): void;
+    setTDToken(token: string): void;
+    setInitialCenter(center: LegacyInitialCenter): void;
+    getInitialCenter(): LegacyInitialCenter;
+    resetToInitialLocation(): void;
+    updateButtonConfig(buttonId: string, config: Partial<CustomButtonConfig>): void;
+    addCustomButton(config: CustomButtonConfig): void;
+    removeButton(buttonId: string): void;
+    showButton(buttonId: string): void;
+    hideButton(buttonId: string): void;
+    enableButton(buttonId: string): void;
+    disableButton(buttonId: string): void;
+    destroy(): void;
+}
+export declare function createToolbarAdapter(viewer: Viewer, container: HTMLElement, config?: ToolbarConfig, callbacks?: LegacyCesiumMapToolbarCallbacks, initialCenter?: LegacyInitialCenter): ToolbarAdapter;
+export {};

package/dist/adapters/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 适配器模块入口
+ *
+ * 提供基于新框架架构的适配器，保持与旧 libs 代码的 API 兼容性。
+ *
+ * @packageDocumentation
+ */
+export { ToolbarAdapter, createToolbarAdapter } from './ToolbarAdapter';
+export type { LegacyCesiumMapToolbarCallbacks } from './ToolbarAdapter';
+export { initCesium } from './MapLoaderAdapter';
+export type { LegacyInitOptions, LegacyInitResult, LegacyMapCenter } from './MapLoaderAdapter';
+export { DrawHelperAdapter, createDrawHelperAdapter } from './DrawHelperAdapter';
+export type { LegacyDrawCallbacks, LegacyDrawOptions, LegacyDrawEntity } from './DrawHelperAdapter';
+export { OverlayServiceAdapter, createOverlayServiceAdapter } from './OverlayServiceAdapter';
+export type { LegacyCesiumOverlayServiceOptions } from './OverlayServiceAdapter';
+/**
+ * 适配器模块版本信息
+ */
+export declare const ADAPTERS_VERSION = "1.0.0";
+/**
+ * 适配器模块描述
+ */
+export declare const ADAPTERS_DESCRIPTION = "VMap Cesium Tool \u9002\u914D\u5668\u6A21\u5757 - \u63D0\u4F9B\u57FA\u4E8E\u65B0\u6846\u67B6\u67B6\u6784\u7684\u9002\u914D\u5668\uFF0C\u4FDD\u6301\u4E0E\u65E7 libs \u4EE3\u7801\u7684 API \u517C\u5BB9\u6027";

package/dist/components/BaseComponent.d.ts

@@ -0,0 +1,116 @@
+import { StyleConfig } from '../core/types';
+/**
+ * 组件基础类
+ * 提供样式管理、事件处理等通用功能
+ */
+export declare abstract class BaseComponent {
+    protected element: HTMLElement;
+    protected styleConfig: StyleConfig;
+    protected isMounted: boolean;
+    /**
+     * 构造函数
+     * @param tagName 元素标签名
+     * @param styleConfig 样式配置
+     */
+    constructor(tagName?: string, styleConfig?: StyleConfig);
+    /**
+     * 应用样式配置
+     */
+    protected applyStyle(): void;
+    /**
+     * 更新样式配置
+     * @param styleConfig 新的样式配置
+     */
+    updateStyle(styleConfig: Partial<StyleConfig>): void;
+    /**
+     * 获取元素
+     */
+    getElement(): HTMLElement;
+    /**
+     * 挂载到父元素
+     * @param parent 父元素或选择器
+     */
+    mount(parent: HTMLElement | string): void;
+    /**
+     * 从父元素卸载
+     */
+    unmount(): void;
+    /**
+     * 显示组件
+     */
+    show(): void;
+    /**
+     * 隐藏组件
+     */
+    hide(): void;
+    /**
+     * 切换显示状态
+     */
+    toggle(): void;
+    /**
+     * 添加事件监听器
+     * @param event 事件类型
+     * @param handler 事件处理函数
+     * @param options 事件选项
+     */
+    addEventListener(event: string, handler: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    /**
+     * 移除事件监听器
+     * @param event 事件类型
+     * @param handler 事件处理函数
+     * @param options 事件选项
+     */
+    removeEventListener(event: string, handler: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    /**
+     * 设置属性
+     * @param name 属性名
+     * @param value 属性值
+     */
+    setAttribute(name: string, value: string): void;
+    /**
+     * 获取属性
+     * @param name 属性名
+     */
+    getAttribute(name: string): string | null;
+    /**
+     * 移除属性
+     * @param name 属性名
+     */
+    removeAttribute(name: string): void;
+    /**
+     * 添加CSS类
+     * @param className CSS类名
+     */
+    addClass(className: string): void;
+    /**
+     * 移除CSS类
+     * @param className CSS类名
+     */
+    removeClass(className: string): void;
+    /**
+     * 切换CSS类
+     * @param className CSS类名
+     */
+    toggleClass(className: string): void;
+    /**
+     * 检查是否包含CSS类
+     * @param className CSS类名
+     */
+    hasClass(className: string): boolean;
+    /**
+     * 挂载后的回调（子类可重写）
+     */
+    protected onMount(): void;
+    /**
+     * 卸载后的回调（子类可重写）
+     */
+    protected onUnmount(): void;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}
+/**
+ * 创建组件实例的工厂函数
+ */
+export declare function createComponent<T extends BaseComponent>(ComponentClass: new (...args: any[]) => T, ...args: any[]): T;

package/dist/components/SearchBox.d.ts

@@ -0,0 +1,136 @@
+import { BaseComponent } from './BaseComponent';
+import { SearchResult, StyleConfig } from '../core/types';
+/**
+ * 搜索框组件配置
+ */
+export interface SearchBoxConfig {
+    placeholder?: string;
+    debounceTime?: number;
+    minQueryLength?: number;
+    maxResults?: number;
+    showClearButton?: boolean;
+    autoFocus?: boolean;
+}
+/**
+ * 搜索框组件
+ */
+export declare class SearchBox extends BaseComponent {
+    private config;
+    private inputElement;
+    private clearButton;
+    private resultsContainer;
+    private debounceTimer;
+    private onSearchCallback?;
+    private onSelectCallback?;
+    private currentResults;
+    /**
+     * 构造函数
+     * @param config 搜索框配置
+     * @param styleConfig 样式配置
+     */
+    constructor(config?: SearchBoxConfig, styleConfig?: StyleConfig);
+    /**
+     * 设置输入框
+     */
+    private setupInput;
+    /**
+     * 设置清除按钮
+     */
+    private setupClearButton;
+    /**
+     * 设置结果容器
+     */
+    private setupResultsContainer;
+    /**
+     * 处理输入事件
+     */
+    private handleInput;
+    /**
+     * 处理键盘事件
+     */
+    private handleKeyDown;
+    /**
+     * 处理聚焦事件
+     */
+    private handleFocus;
+    /**
+     * 处理失焦事件
+     */
+    private handleBlur;
+    /**
+     * 执行搜索
+     */
+    private performSearch;
+    /**
+     * 显示搜索结果
+     */
+    private displayResults;
+    /**
+     * 显示错误信息
+     */
+    private displayError;
+    /**
+     * 创建结果元素
+     */
+    private createResultElement;
+    /**
+     * 导航结果
+     */
+    private navigateResults;
+    /**
+     * 选择结果
+     */
+    private selectResult;
+    /**
+     * 显示结果容器
+     */
+    private showResults;
+    /**
+     * 隐藏结果容器
+     */
+    private hideResults;
+    /**
+     * 设置搜索回调
+     */
+    setOnSearch(callback: (query: string) => Promise<SearchResult[]>): void;
+    /**
+     * 设置选择回调
+     */
+    setOnSelect(callback: (result: SearchResult) => void): void;
+    /**
+     * 获取当前查询
+     */
+    getQuery(): string;
+    /**
+     * 设置查询
+     */
+    setQuery(query: string): void;
+    /**
+     * 清空搜索框
+     */
+    clear(): void;
+    /**
+     * 聚焦输入框
+     */
+    focus(): void;
+    /**
+     * 失焦输入框
+     */
+    blur(): void;
+    /**
+     * 更新配置
+     */
+    updateConfig(config: Partial<SearchBoxConfig>): void;
+    /**
+     * 获取配置
+     */
+    getConfig(): SearchBoxConfig;
+    /**
+     * 销毁组件
+     */
+    destroy(): void;
+}
+/**
+ * 创建搜索框的工厂函数
+ */
+export declare function createSearchBox(config?: SearchBoxConfig, styleConfig?: StyleConfig): SearchBox;