@xingm/vmap-cesium-toolbar 0.0.5 → 1.0.0

package/dist/core/services/overlay/OverlayService.d.ts

@@ -0,0 +1,188 @@
+import { Viewer, Entity } from '../../../../node_modules/cesium';
+import { Marker, MarkerOptions } from '../../entities/Marker';
+import { Label, LabelOptions } from '../../entities/Label';
+import { Icon, IconOptions } from '../../entities/Icon';
+import { SVG, SvgOptions } from '../../entities/SVG';
+import { InfoWindow, InfoWindowOptions } from '../../entities/InfoWindow';
+import { Polyline, PolylineOptions } from '../../entities/Polyline';
+import { Polygon, PolygonOptions } from '../../entities/Polygon';
+import { Rectangle, RectangleOptions } from '../../entities/Rectangle';
+import { Circle, CircleOptions } from '../../entities/Circle';
+import { Ring, RingOptions } from '../../entities/Ring';
+import { OverlayEntity } from '../../entities/BaseOverlay';
+type OverlayInstance = Marker | Label | Icon | SVG | InfoWindow | Polyline | Polygon | Rectangle | Circle | Ring;
+/**
+ * 覆盖物服务选项
+ */
+export interface OverlayServiceOptions {
+    /** 是否启用 hover 处理器（默认 true） */
+    enableHoverHandler?: boolean;
+    /** 点击节流间隔（毫秒，默认 120） */
+    clickPickMinIntervalMs?: number;
+}
+/**
+ * 覆盖物服务类
+ *
+ * 统一管理所有覆盖物的创建、更新和删除。
+ * 基于新的实体类架构，提供便捷的服务层 API。
+ *
+ * @example
+ * ```typescript
+ * const overlayService = new OverlayService(viewer);
+ *
+ * // 添加标记
+ * const marker = overlayService.addMarker({
+ *   position: [120.1, 30.2],
+ *   pixelSize: 12,
+ *   color: '#FF0000'
+ * });
+ *
+ * // 添加多边形
+ * const polygon = overlayService.addPolygon({
+ *   positions: [[120.1, 30.2], [120.2, 30.3], [120.3, 30.25]],
+ *   material: 'rgba(255, 0, 0, 0.3)'
+ * });
+ *
+ * // 根据 ID 获取覆盖物
+ * const m = overlayService.getOverlay(marker.getId());
+ *
+ * // 删除覆盖物
+ * overlayService.removeOverlay(marker.getId());
+ * ```
+ */
+export declare class OverlayService {
+    private viewer;
+    private overlays;
+    private entityOverlayMap;
+    private options;
+    private nextId;
+    private clickHandler;
+    private hoverHandler;
+    private clickHighlightTargets;
+    private hoverHighlightTargets;
+    private lastClickPickAt;
+    private pendingHoverRaf;
+    private pendingHoverPosition;
+    private readonly highlightCache;
+    private markerFactory;
+    private labelFactory;
+    private iconFactory;
+    private svgFactory;
+    private infoWindowFactory;
+    private polylineFactory;
+    private polygonFactory;
+    private rectangleFactory;
+    private circleFactory;
+    private ringFactory;
+    constructor(viewer: Viewer, options?: OverlayServiceOptions);
+    /**
+     * 生成唯一 ID
+     */
+    generateId(prefix?: string): string;
+    /**
+     * 注册覆盖物
+     */
+    registerOverlay(id: string, overlay: OverlayInstance): void;
+    /**
+     * 注销覆盖物
+     */
+    unregisterOverlay(id: string): void;
+    /**
+     * 根据 ID 获取覆盖物
+     */
+    getOverlay(id: string): OverlayInstance | undefined;
+    /**
+     * 获取所有覆盖物 ID
+     */
+    getAllOverlayIds(): string[];
+    /**
+     * 添加 Marker
+     */
+    addMarker(options: MarkerOptions): Marker;
+    /**
+     * 添加 Label
+     */
+    addLabel(options: LabelOptions): Label;
+    /**
+     * 添加 Icon
+     */
+    addIcon(options: IconOptions): Icon;
+    /**
+     * 添加 SVG
+     */
+    addSvg(options: SvgOptions): SVG;
+    /**
+     * 添加 InfoWindow
+     */
+    addInfoWindow(options: InfoWindowOptions): InfoWindow;
+    /**
+     * 添加 Polyline
+     */
+    addPolyline(options: PolylineOptions): Polyline;
+    /**
+     * 添加 Polygon
+     */
+    addPolygon(options: PolygonOptions): Polygon;
+    /**
+     * 添加 Rectangle
+     */
+    addRectangle(options: RectangleOptions): Rectangle;
+    /**
+     * 添加 Circle
+     */
+    addCircle(options: CircleOptions): Circle;
+    /**
+     * 添加 Ring
+     */
+    addRing(options: RingOptions): Ring;
+    /**
+     * 根据 ID 删除覆盖物
+     */
+    removeOverlay(id: string): boolean;
+    /**
+     * 删除所有覆盖物
+     */
+    removeAllOverlays(): void;
+    /**
+     * 设置覆盖物可见性
+     */
+    setOverlayVisible(id: string, visible: boolean): boolean;
+    /**
+     * 显式切换覆盖物高亮状态。
+     */
+    toggleOverlayHighlight(entityOrId: OverlayEntity | Entity | string, reason?: 'click' | 'hover'): boolean;
+    /**
+     * 显式设置覆盖物高亮状态。
+     */
+    setOverlayHighlight(entityOrId: OverlayEntity | Entity | string, enabled: boolean, reason?: 'click' | 'hover'): boolean;
+    /**
+     * 安装 Hover 处理器
+     */
+    private setupHoverHandler;
+    /**
+     * 安装点击处理器
+     */
+    private setupClickHandler;
+    private bindOverlayEntities;
+    private unbindOverlayEntities;
+    private collectOverlayEntities;
+    private pickOverlayEntity;
+    private safeDrillPick;
+    private resolvePickedOverlayEntity;
+    private resolveOverlayEntity;
+    private getHighlightTargets;
+    private setHighlightTargets;
+    private setEntityHighlight;
+    private isHighlightActive;
+    private clearOverlayHighlightState;
+    private normalizeHighlightOptions;
+    private resolveHighlightColor;
+    private applyEntityHighlight;
+    private restoreEntityStyle;
+    private captureEntityStyle;
+    /**
+     * 销毁服务
+     */
+    destroy(): void;
+}
+export {};

package/dist/core/services/overlay/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 覆盖物服务模块入口
+ *
+ * @packageDocumentation
+ */
+export { OverlayService } from './OverlayService';
+export type { OverlayServiceOptions } from './OverlayService';

package/dist/core/services/toolbar/ToolbarService.d.ts

@@ -0,0 +1,175 @@
+import { Toolbar } from '../../../components/Toolbar';
+import { CustomButtonConfig, LayersPanelStyleConfig, SearchPanelStyleConfig, ToolbarConfig as CoreToolbarConfig } from '../../../core/types';
+import { IButtonHandler, ToolbarServiceConfig, MeasurementServiceLike } from './types';
+import { MapControllerLike } from './buttons/SimpleButtonHandler';
+/**
+ * 工具栏服务配置扩展
+ * 支持自定义工具栏样式和按钮配置
+ */
+export interface ToolbarServiceOptions {
+    /** 工具栏样式配置 */
+    toolbarStyle?: Partial<CoreToolbarConfig>;
+    /** 按钮配置列表（覆盖默认配置） */
+    buttonConfigs?: CustomButtonConfig[];
+    /** 是否使用默认按钮 */
+    useDefaultButtons?: boolean;
+    /** 搜索面板样式 */
+    searchPanelStyle?: SearchPanelStyleConfig;
+    /** 搜索面板默认动作图标 */
+    searchIdleActionIcon?: string | HTMLElement;
+    /** 搜索面板清空动作图标 */
+    searchClearActionIcon?: string | HTMLElement;
+    /** 图层菜单样式 */
+    layersPanelStyle?: LayersPanelStyleConfig;
+}
+/**
+ * 工具栏服务类
+ */
+export declare class ToolbarService {
+    /** 工具栏 UI 组件 */
+    private toolbar;
+    /** 按钮处理器映射表 */
+    private buttonHandlers;
+    /** 配置 */
+    private config;
+    /** 国际化实例 */
+    private i18n?;
+    /** 是否使用国际化 */
+    private useI18n;
+    /** 地图控制器 */
+    private mapController?;
+    /** 测量服务实例 */
+    private measurementService?;
+    /** 搜索服务实例 */
+    private searchService?;
+    /** 图层服务实例 */
+    private layersService?;
+    /** 绘图助手实例 */
+    private drawHelper?;
+    /** 工具栏服务选项 */
+    private options;
+    private buttonConfigs?;
+    private unsubscribeI18n?;
+    /**
+     * 构造函数
+     * @param config 工具栏服务配置
+     * @param options 工具栏服务选项
+     */
+    constructor(config: ToolbarServiceConfig, options?: ToolbarServiceOptions);
+    /**
+     * 初始化工具栏
+     */
+    initialize(): void;
+    private setupLocaleSync;
+    /**
+     * 创建工具栏 UI
+     */
+    private createToolbar;
+    /**
+     * 注册默认按钮处理器
+     */
+    private registerDefaultButtonHandlers;
+    /**
+     * 初始化按钮
+     */
+    private initializeButtons;
+    /**
+     * 注册按钮处理器
+     * @param handler 按钮处理器
+     */
+    registerButtonHandler(handler: IButtonHandler): void;
+    /**
+     * 获取按钮处理器
+     * @param id 按钮 ID
+     */
+    getButtonHandler(id: string): IButtonHandler | null;
+    /**
+     * 移除按钮处理器
+     * @param id 按钮 ID
+     */
+    unregisterButtonHandler(id: string): void;
+    /**
+     * 添加自定义按钮
+     * @param config 自定义按钮配置
+     * @param onClick 点击回调
+     */
+    addCustomButton(config: CustomButtonConfig, onClick?: (buttonId: string, buttonElement: HTMLElement) => void): void;
+    /**
+     * 移除按钮
+     * @param buttonId 按钮 ID
+     */
+    removeButton(buttonId: string): void;
+    /**
+     * 更新按钮配置
+     * @param buttonId 按钮 ID
+     * @param config 新的按钮配置
+     */
+    updateButton(buttonId: string, config: Partial<CustomButtonConfig>): void;
+    /**
+     * 更新工具栏样式，避免业务层重新初始化工具栏。
+     */
+    updateToolbarStyle(config: Partial<CoreToolbarConfig>): void;
+    /**
+     * 启用按钮
+     * @param buttonId 按钮 ID
+     */
+    enableButton(buttonId: string): void;
+    /**
+     * 禁用按钮
+     * @param buttonId 按钮 ID
+     */
+    disableButton(buttonId: string): void;
+    /**
+     * 显示按钮
+     * @param buttonId 按钮 ID
+     */
+    showButton(buttonId: string): void;
+    /**
+     * 隐藏按钮
+     * @param buttonId 按钮 ID
+     */
+    hideButton(buttonId: string): void;
+    /**
+     * 设置测量服务
+     * @param service 测量服务实例
+     */
+    setMeasurementService(service: MeasurementServiceLike): void;
+    /**
+     * 设置搜索服务
+     * @param service 搜索服务实例
+     */
+    setSearchService(service: any): void;
+    /**
+     * 设置图层服务
+     * @param service 图层服务实例
+     */
+    setLayersService(service: any): void;
+    /**
+     * 设置地图控制器
+     * @param controller 地图控制器
+     */
+    setMapController(controller: MapControllerLike): void;
+    /**
+     * 获取工具栏 UI 组件
+     */
+    getToolbar(): Toolbar | null;
+    /**
+     * 获取工具栏容器元素
+     */
+    getToolbarElement(): HTMLElement | null;
+    /**
+     * 关闭所有打开的菜单
+     */
+    closeAllMenus(): void;
+    /**
+     * 销毁工具栏服务
+     */
+    destroy(): void;
+}
+/**
+ * 创建工具栏服务的工厂函数
+ * @param config 工具栏服务配置
+ * @param options 工具栏服务选项
+ * @returns 工具栏服务实例
+ */
+export declare function createToolbarService(config: ToolbarServiceConfig, options?: ToolbarServiceOptions): ToolbarService;

package/dist/core/services/toolbar/buttons/BaseButtonHandler.d.ts

@@ -0,0 +1,111 @@
+import { ToolbarButton } from '../../../../components/ToolbarButton';
+import { IButtonHandler } from '../types';
+import { I18nLike } from '../../../../i18n';
+/**
+ * 按钮处理器基类
+ */
+export declare abstract class BaseButtonHandler implements IButtonHandler {
+    /** 按钮 ID */
+    readonly id: string;
+    /** 按钮实例引用 */
+    protected button: ToolbarButton | null;
+    /** 国际化实例 */
+    protected i18n?: I18nLike;
+    /** 是否使用国际化 */
+    protected useI18n: boolean;
+    /** Cesium Viewer 实例 */
+    protected viewer: any;
+    /** 工具栏容器元素 */
+    protected toolbarElement: HTMLElement | null;
+    /**
+     * 构造函数
+     * @param id 按钮 ID
+     * @param viewer Cesium Viewer 实例
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(id: string, viewer: any, i18n?: I18nLike, useI18n?: boolean);
+    /**
+     * 初始化按钮（由子类实现）
+     * @param button 按钮实例
+     */
+    abstract initialize(button: ToolbarButton): void;
+    /**
+     * 处理点击事件（由子类实现）
+     */
+    abstract handleClick(): void;
+    /**
+     * 处理鼠标进入事件（可选，由子类实现）
+     */
+    handleMouseEnter?(): void;
+    /**
+     * 处理鼠标离开事件（可选，由子类实现）
+     */
+    handleMouseLeave?(): void;
+    /**
+     * 销毁处理器（由子类实现）
+     */
+    abstract destroy(): void;
+    /**
+     * 设置工具栏容器元素
+     * @param element 工具栏容器元素
+     */
+    setToolbarElement(element: HTMLElement): void;
+    /**
+     * 获取按钮实例
+     */
+    getButton(): ToolbarButton | null;
+    /**
+     * 激活按钮
+     */
+    protected activateButton(): void;
+    /**
+     * 取消激活按钮
+     */
+    protected deactivateButton(): void;
+    /**
+     * 切换按钮激活状态
+     */
+    protected toggleButtonActive(): void;
+    /**
+     * 检查按钮是否激活
+     */
+    protected isButtonActive(): boolean;
+    /**
+     * 翻译文本
+     * @param key 翻译键
+     * @param params 翻译参数
+     */
+    protected t(key: string, params?: Record<string, any>): string;
+    /**
+     * 绑定元素翻译
+     * @param element DOM 元素
+     * @param key 翻译键
+     * @param attribute 属性名（默认为 textContent）
+     */
+    protected bindElement(element: HTMLElement, key: string, attribute?: string): void;
+    /**
+     * 创建菜单项元素
+     * @param id 菜单项 ID
+     * @param text 显示文本
+     * @param icon 图标
+     * @param onClick 点击回调
+     */
+    protected createMenuItem(id: string, text: string, icon: string, onClick: () => void): HTMLElement;
+    /**
+     * 关闭其他打开的菜单
+     * @param excludeId 排除的按钮 ID
+     */
+    protected closeOtherMenus(excludeId?: string): void;
+    /**
+     * 延迟关闭菜单
+     * @param menu 菜单元素
+     * @param delay 延迟时间（毫秒）
+     */
+    protected scheduleMenuClose(menu: HTMLElement, delay?: number): void;
+    /**
+     * 调整菜单位置以避免超出可视区域
+     * @param menu 菜单元素
+     */
+    protected adjustMenuPosition(menu: HTMLElement): void;
+}

package/dist/core/services/toolbar/buttons/LayersButtonHandler.d.ts

@@ -0,0 +1,47 @@
+import { LayersPanelStyleConfig } from '../../../../core/types';
+import { ToolbarButton } from '../../../../components/ToolbarButton';
+import { BaseMenu } from '../menus/BaseMenu';
+export interface MapTypeConfig {
+    id: string;
+    name: string;
+    nameKey?: string;
+    thumbnail?: string;
+    placeNameLabel?: string;
+    placeNameLabelKey?: string;
+    forcePlaceName?: boolean;
+}
+export interface LayersButtonHandlerOptions {
+    layersService?: any;
+    mapTypes?: MapTypeConfig[];
+    currentMapType?: string;
+    isPlaceNameChecked?: boolean;
+    token?: string;
+    isNoFlyZoneChecked?: boolean;
+    onMapTypeChange?: (mapTypeId: string) => void;
+    onPlaceNameToggle?: (isChecked: boolean) => void;
+    onShowNoFlyZones?: () => Promise<void>;
+    onNoFlyZoneToggle?: (isChecked: boolean) => void;
+    panelStyle?: LayersPanelStyleConfig;
+}
+export declare class LayersButtonHandler extends BaseMenu {
+    readonly id = "layers";
+    private options;
+    private button;
+    private panelStyle;
+    constructor(toolbarElement: HTMLElement, options?: LayersButtonHandlerOptions, i18n?: any, useI18n?: boolean);
+    show(anchor: HTMLElement): void;
+    initialize(button: ToolbarButton): void;
+    handleClick(): void;
+    handleMouseEnter(): void;
+    handleMouseLeave(): void;
+    destroy(): void;
+    updateOptions(options: Partial<LayersButtonHandlerOptions>): void;
+    private createSection;
+    private createMapTypeItem;
+    private createPlaceNameToggle;
+    private createNoFlyZoneItem;
+    private selectMapType;
+    private toggleNoFlyZone;
+    private togglePlaceName;
+    private getPanelStyles;
+}

package/dist/core/services/toolbar/buttons/MeasureButtonHandler.d.ts

@@ -0,0 +1,94 @@
+import { BaseButtonHandler } from './BaseButtonHandler';
+import { ToolbarButton } from '../../../../components/ToolbarButton';
+import { MeasurementServiceLike } from '../types';
+/**
+ * 测量按钮处理器配置
+ */
+export interface MeasureButtonHandlerOptions {
+    /** 测量服务实例 */
+    measurementService?: MeasurementServiceLike;
+    /** 绘图助手实例 */
+    drawHelper?: any;
+    /** 测距开始回调 */
+    onDistanceStart?: () => void;
+    /** 测距绘制选项 */
+    getDistanceDrawOptions?: () => any;
+    /** 测面积开始回调 */
+    onAreaStart?: () => void;
+    /** 测面积绘制选项 */
+    getAreaDrawOptions?: () => any;
+    /** 测距完成回调 */
+    onDistanceComplete?: (positions: any[], distance: number) => void;
+    /** 测面积完成回调 */
+    onAreaComplete?: (positions: any[], area: number) => void;
+    /** 清除测量回调 */
+    onClear?: () => void;
+}
+/**
+ * 测量按钮处理器类
+ */
+export declare class MeasureButtonHandler extends BaseButtonHandler {
+    readonly id = "measure";
+    private menu;
+    private options;
+    private activeMeasurementMode;
+    private boundMeasurementService;
+    private boundDrawHelper;
+    /**
+     * 构造函数
+     * @param viewer Cesium Viewer 实例
+     * @param options 配置选项
+     * @param i18n 国际化实例
+     * @param useI18n 是否使用国际化
+     */
+    constructor(viewer: any, options?: MeasureButtonHandlerOptions, i18n?: any, useI18n?: boolean);
+    updateOptions(options: Partial<MeasureButtonHandlerOptions>): void;
+    /**
+     * 初始化按钮
+     * @param button 按钮实例
+     */
+    initialize(button: ToolbarButton): void;
+    /**
+     * 处理点击事件
+     */
+    handleClick(): void;
+    /**
+     * 处理鼠标进入事件
+     */
+    handleMouseEnter(): void;
+    /**
+     * 处理鼠标离开事件
+     */
+    handleMouseLeave(): void;
+    /**
+     * 销毁处理器
+     */
+    destroy(): void;
+    private bindMeasurementServiceCallbacks;
+    private bindDrawCallbacks;
+    private handleMeasurementComplete;
+    private handleClearComplete;
+    private handleLegacyMeasureComplete;
+    private handleDrawComplete;
+    /**
+     * 显示测量菜单
+     * @param anchor 锚点元素
+     */
+    private showMenu;
+    /**
+     * 开始测距
+     */
+    private startDistanceMeasurement;
+    /**
+     * 开始测面积
+     */
+    private startAreaMeasurement;
+    /**
+     * 清除测量
+     */
+    private clearMeasurements;
+    /**
+     * 隐藏菜单
+     */
+    hideMenu(): void;
+}