@gis_victory/gismap 2.0.23 → 2.0.25

package/dist/manager/IconManager.d.ts

@@ -0,0 +1,18 @@
+import { VectorTileAdapter } from '../adapters/types';
+/** 图标配置 */
+export interface IconConfig {
+    /** 图标 ID（对应 layout.icon-image） */
+    name: string;
+    /** 图标图片 URL */
+    url: string;
+}
+export default class IconManager {
+    private adapter;
+    constructor(adapter: VectorTileAdapter);
+    /**
+     * 批量加载图标
+     * @param icons 图标配置数组
+     */
+    load(icons: IconConfig[]): Promise<void>;
+    private _loadImage;
+}

package/dist/manager/LayerManager.d.ts

@@ -0,0 +1,50 @@
+import { VectorTileAdapter } from '../adapters/types';
+import { BaseManager } from '../types/IManager';
+import { IEventBus, CoreMapEvents } from '../core/event';
+/**
+ * 图层管理器
+ * 管理地图图层的添加、移除和查询
+ */
+export default class LayerManager extends BaseManager {
+    private adapter;
+    private eventBus?;
+    private checkedParentLayers;
+    private checkedLayers;
+    queryLayerIds: string[];
+    private symbolLayerIds;
+    private pointLayerIds;
+    private lineLayerIds;
+    private polygonLayerIds;
+    constructor(adapter: VectorTileAdapter, eventBus?: IEventBus<CoreMapEvents>);
+    /**
+     * 初始化管理器
+     */
+    protected onInitialize(): void;
+    /**
+     * 销毁管理器
+     */
+    protected onDispose(): void;
+    /**
+     * 启用管理器
+     */
+    protected onEnable(): void;
+    /**
+     * 禁用管理器
+     */
+    protected onDisable(): void;
+    /**
+     * 重置管理器状态
+     */
+    protected onReset(): void;
+    /**
+     * 清理所有图层
+     */
+    private clearAllLayers;
+    addSource(source: any): void;
+    addLayer(layerConfig: any, beforeLayerId?: string): this;
+    addGroupLayer(layer: any): void;
+    removeLayer(layer: any): void;
+    removeGroupLayer(layer: any): void;
+    getCheckedLayers(): any[];
+    getLayer(id: string): any;
+}

package/dist/manager/MaskManager.d.ts

@@ -0,0 +1,52 @@
+import { VectorTileAdapter } from '../adapters/types';
+/**
+ * 遮罩管理器配置
+ */
+export interface MaskOptions {
+    /** 遮罩图层ID */
+    layerId?: string;
+    /** 数据源URL或GeoJSON数据 */
+    data: string | any;
+    /** 样式配置 */
+    style?: any;
+    /** 插入到指定图层之前 */
+    beforeId?: string;
+}
+export default class MaskManager {
+    private adapter;
+    private layerId;
+    private lineLayerId;
+    constructor(adapter: VectorTileAdapter, layerId?: string);
+    /**
+     * 添加遮罩图层
+     * @param options 遮罩配置
+     */
+    add(options: MaskOptions): this;
+    /**
+     * 添加遮罩边界线
+     * @param style 样式配置
+     */
+    addLine(style?: any): void;
+    /**
+     * 移除遮罩
+     */
+    remove(): void;
+    /**
+     * 更新遮罩数据
+     * @param data 新的GeoJSON数据
+     */
+    updateData(data: any): void;
+    /**
+     * 设置遮罩可见性
+     * @param visible 是否可见
+     */
+    setVisible(visible: boolean): void;
+    /**
+     * 获取遮罩图层ID
+     */
+    getLayerId(): string;
+    /**
+     * 获取遮罩边界线图层ID
+     */
+    getLineLayerId(): string;
+}

package/dist/manager/PlaceholderManager.d.ts

@@ -0,0 +1,28 @@
+import { VectorTileAdapter } from '../adapters/types';
+/** 占位符图层 ID 常量（供外部引用） */
+export default class PlaceholderManager {
+    /** 符号图层（Symbol）占位符 ID */
+    static readonly symbolPointId = "gismap_placeholder_symbol_point";
+    /** 点图层（Circle）占位符 ID */
+    static readonly layerPointId = "gismap_placeholder_layer_point";
+    /** 线图层（Line）占位符 ID */
+    static readonly layerLineId = "gismap_placeholder_layer_line";
+    /** 面图层（Fill）占位符 ID */
+    static readonly layerPolygonId = "gismap_placeholder_layer_polygon";
+    /** 遮罩图层（Mask）占位符 ID */
+    static readonly maskLayerId = "gismap_placeholder_mask_layer";
+    private adapter;
+    /** 占位符专用空 GeoJSON Source ID */
+    private readonly sourceId;
+    constructor(adapter: VectorTileAdapter);
+    /**
+     * 初始化所有占位符图层（点、线、面、符号、遮罩）。
+     * 应在地图加载完成后、业务图层添加之前调用一次。
+     */
+    addLayer(options?: {
+        beforeLayerPointId?: string;
+        beforeLayerLineId?: string;
+        beforeLayerFillId?: string;
+        beforeMaskLayerId?: string;
+    }): void;
+}

package/dist/manager/PopupManager.d.ts

@@ -0,0 +1,13 @@
+export default class PopupManager {
+    private map;
+    private popups;
+    constructor(map: any);
+    show(options: {
+        position: [number, number];
+        offset?: [number, number];
+        html: string;
+        flyTo?: boolean;
+    }): string;
+    hide(id: string): void;
+    clear(): void;
+}

package/dist/manager/QuickSearchManager.d.ts

@@ -0,0 +1,24 @@
+export default class QuickSearchManager {
+    private map;
+    private markers;
+    private selectMarker;
+    private popup;
+    private callback;
+    private templateManager;
+    private popupManager;
+    constructor(map: any);
+    addFunction(callback: any): void;
+    add(options: {
+        uuid: string;
+        templateId: string;
+        geometry: any;
+        index: number;
+        properties: any;
+    }): void;
+    addGroup(options: {
+        data: any[];
+    }): void;
+    flyTo(uuid: string): void;
+    addPopup(): void;
+    clear(): void;
+}

package/dist/manager/RadarManager.d.ts

@@ -0,0 +1,46 @@
+import { VectorTileAdapter } from '../adapters/types';
+/**
+ * 雷达配置选项
+ */
+export interface RadarOptions {
+    /** 雷达中心点 [lng, lat] */
+    center: [number, number];
+    /** 雷达半径（米），默认 100 */
+    radius?: number;
+    /** 扫描一圈时间（毫秒），默认 3000 */
+    period?: number;
+    /** 背景颜色，默认 "rgba(255,0,0,0.1)" */
+    backgroundColor?: string;
+    /** 边框颜色，默认 "rgba(255,0,0,0.8)" */
+    borderColor?: string;
+    /** 边框宽度，默认 2 */
+    borderWidth?: number;
+    /** 扇形是否可见，默认 false */
+    sectorVisible?: boolean;
+    /** 扫描扇形角度（度），默认 30 */
+    sectorAngle?: number;
+    /** 扇形颜色，默认 "rgba(0,255,0,0.4)" */
+    sectorColor?: string;
+    /** 扇形边框颜色，默认 "rgba(0,0,255,0.8)" */
+    sectorBorderColor?: string;
+}
+export default class RadarManager {
+    private adapter?;
+    private id;
+    private radius;
+    private period;
+    private backgroundColor;
+    private borderColor;
+    private borderWidth;
+    private sectorVisible;
+    private sectorAngle;
+    private sectorColor;
+    private sectorBorderColor;
+    private center;
+    private animationId;
+    constructor(adapter?: VectorTileAdapter);
+    add(options: RadarOptions): this;
+    startScan(): this;
+    stopScan(): this;
+    remove(): void;
+}

package/dist/manager/SplitScreenDrawManager.d.ts

@@ -0,0 +1,75 @@
+import { MapContext } from '../services/MapContext';
+/**
+ * 拉框对比管理器
+ * 用于实现两个叠在一起的地图通过拖动分割线进行对比的功能
+ */
+export declare class SplitScreenDrawManager {
+    private leftMapContext;
+    private rightMapContext;
+    private isDragging;
+    private dividerElement;
+    private containerElement;
+    private direction;
+    private initialPosition;
+    private initialMousePosition;
+    /**
+     * 初始化拉框对比管理器
+     * @param leftMapContext 左侧地图上下文
+     * @param rightMapContext 右侧地图上下文
+     * @param containerElement 容器元素
+     * @param dividerElement 分割线元素
+     */
+    initialize(leftMapContext: MapContext, rightMapContext: MapContext, containerElement: HTMLElement, dividerElement: HTMLElement): void;
+    /**
+     * 设置事件监听器
+     */
+    private setupEventListeners;
+    /**
+     * 处理分割线鼠标按下事件
+     * @param event 鼠标事件
+     */
+    private handleDividerMouseDown;
+    /**
+     * 处理文档鼠标移动事件
+     * @param event 鼠标事件
+     */
+    private handleDocumentMouseMove;
+    /**
+     * 处理文档鼠标释放事件
+     * @param event 鼠标事件
+     */
+    private handleDocumentMouseUp;
+    /**
+     * 更新分割线位置
+     * @param position 新位置
+     */
+    private updateDividerPosition;
+    /**
+     * 更新地图显示范围
+     * @param position 分割线位置
+     */
+    private updateMapVisibility;
+    /**
+     * 设置地图同步
+     */
+    private setupMapSync;
+    /**
+     * 同步地图视图
+     * @param sourceMap 源地图
+     * @param targetMap 目标地图
+     */
+    private syncMapView;
+    /**
+     * 设置分割方向
+     * @param newDirection 新的分割方向
+     */
+    setDirection(newDirection: 'horizontal' | 'vertical'): void;
+    /**
+     * 重置分割线位置到中心
+     */
+    resetDividerPosition(): void;
+    /**
+     * 销毁拉框对比管理器
+     */
+    destroy(): void;
+}

package/dist/manager/SplitScreenManager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 双屏对比管理器
+ * 用于实现地图的双屏对比功能 - 天地图版本
+ */
+export interface SplitScreenOptions {
+    /** 分割方向：horizontal 或 vertical */
+    direction?: 'horizontal' | 'vertical';
+    /** 分割比例：0-1之间的值，表示左侧/上侧占比 */
+    ratio?: number;
+    /** 天地图 Token */
+    tdtToken?: string;
+}
+export default class SplitScreenManager {
+    private map;
+    private options;
+    private isActive;
+    private splitElement;
+    private leftMapContainer;
+    private rightMapContainer;
+    private leftMap;
+    private rightMap;
+    constructor(map: any, options?: SplitScreenOptions);
+    /**
+     * 开启双屏对比
+     */
+    startSplitScreen(): void;
+    /**
+     * 关闭双屏对比
+     */
+    stopSplitScreen(): void;
+    /**
+     * 更新分割比例
+     * @param ratio 分割比例：0-1之间的值
+     */
+    updateRatio(ratio: number): void;
+    /**
+     * 更新分割方向
+     * @param direction 分割方向：horizontal 或 vertical
+     */
+    updateDirection(direction: 'horizontal' | 'vertical'): void;
+    /**
+     * 获取当前状态
+     */
+    getIsActive(): boolean;
+    /**
+     * 创建分割容器
+     */
+    private createSplitContainer;
+    /**
+     * 创建左侧地图（矢量地图）
+     */
+    private createLeftMap;
+    /**
+     * 创建右侧地图（影像地图）
+     */
+    private createRightMap;
+    /**
+     * 添加天地图矢量图层
+     */
+    private addTdtVecLayer;
+    /**
+     * 添加天地图影像图层
+     */
+    private addTdtImgLayer;
+    /**
+     * 添加天地图注记图层
+     */
+    private addTdtCiaLayer;
+    /**
+     * 同步两个地图的视图
+     */
+    private syncMapViews;
+    /**
+     * 更新分割样式
+     */
+    private updateSplitStyle;
+    /**
+     * 销毁管理器
+     */
+    destroy(): void;
+}

package/dist/manager/TDTManager.d.ts

@@ -0,0 +1,33 @@
+import { VectorTileAdapter } from '../adapters/types';
+/** 天地图图层 ID 常量 */
+export declare const TDT_LAYER_IDS: {
+    readonly img: "tdt-img";
+    readonly vec: "tdt-vec";
+    readonly cia: "tdt-cia";
+};
+export default class TDTManager {
+    private adapter;
+    private token;
+    /** 各图层对应的 Source 配置 */
+    private layerSources;
+    constructor(adapter: VectorTileAdapter, token?: string);
+    private addTdtLayer;
+    private removeTdtLayer;
+    /** 添加天地图影像底图（+ 注记） */
+    addImgLayer(sourceConfig?: any, beforeId?: string): void;
+    removeImgLayer(): void;
+    /** 添加天地图矢量底图 */
+    addVecLayer(sourceConfig?: any, beforeId?: string): void;
+    removeVecLayer(): void;
+    /** 添加天地图注记图层 */
+    addCiaLayer(sourceConfig?: any, beforeId?: string): void;
+    removeCiaLayer(): void;
+    /** 移除所有天地图图层 */
+    clear(): void;
+    /** 显示天地图（恢复可见性） */
+    show(): void;
+    /** 隐藏天地图（保留图层，仅隐藏） */
+    hideAll(): void;
+    /** 隐藏指定的天地图图层 */
+    hide(layerId: string): void;
+}

package/dist/manager/TemplateManager.d.ts

@@ -0,0 +1,52 @@
+import { TemplateItem } from '../types/ITemplate';
+export default class TemplateManager {
+    private templates;
+    /**
+     * 初始化模板数据
+     * @param templateItems 模板数据数组
+     */
+    initialize(templateItems: TemplateItem[]): void;
+    /**
+     * 根据模板id查询配置
+     * @param templateId 模板id
+     * @returns 模板配置，如果不存在则返回 undefined
+     */
+    getTemplate(templateId: string): TemplateItem | undefined;
+    /**
+     * 添加模板
+     * @param templateId 模板id
+     * @param template 模板配置
+     */
+    addTemplate(templateId: string, template: TemplateItem): void;
+    /**
+     * 删除模板
+     * @param templateId 模板id
+     */
+    removeTemplate(templateId: string): void;
+    /**
+     * 更新模板
+     * @param templateId 模板id
+     * @param template 模板配置
+     */
+    updateTemplate(templateId: string, template: TemplateItem): void;
+    /**
+     * 获取所有模板
+     * @returns 所有模板的映射
+     */
+    getAllTemplates(): Map<string, TemplateItem>;
+    /**
+     * 获取所有模板id
+     * @returns 所有模板id的数组
+     */
+    getTemplateIds(): string[];
+    /**
+     * 检查模板是否存在
+     * @param templateId 模板id
+     * @returns 是否存在
+     */
+    hasTemplate(templateId: string): boolean;
+    /**
+     * 清除所有模板
+     */
+    clear(): void;
+}

package/dist/manager/TerrainManager.d.ts

@@ -0,0 +1,39 @@
+import { VectorTileAdapter } from '../adapters/types';
+export default class TerrainManager {
+    private adapter;
+    constructor(adapter: VectorTileAdapter);
+    /**
+     * 添加 raster-dem 数据源。
+     * @param options 必须包含 tiles: string[] 瓦片地址
+     */
+    addSource(options: {
+        tiles: string[];
+        minzoom?: number;
+        maxzoom?: number;
+        tileSize?: number;
+        [key: string]: any;
+    }): this;
+    /**
+     * 添加地形（setTerrain）。
+     * 若 raster-dem 数据源不存在，会先调用 addSource 创建。
+     * @param options.source  数据源配置（需包含 tiles）
+     * @param options.layer   地形配置（exaggeration 等）
+     */
+    add(options?: {
+        source?: any;
+        layer?: {
+            exaggeration?: number;
+            [key: string]: any;
+        };
+    }): this;
+    /** 移除地形 */
+    remove(): this;
+    /** 添加山体阴影图层（需先添加 raster-dem 数据源） */
+    addHillshade(): this;
+    /** 移除山体阴影图层 */
+    removeHillshade(): this;
+    /** 显示地形（添加地形 + 山体阴影） */
+    show(options?: Parameters<TerrainManager['add']>[0]): this;
+    /** 隐藏地形（移除地形 + 山体阴影） */
+    hide(): this;
+}

package/dist/manager/layer/MarkerLayer.d.ts

@@ -0,0 +1,89 @@
+import { VectorTileAdapter, MarkerOptions } from '../../adapters/types';
+import { Marker, LngLatLike } from '@gis_victory/mapbox-gl';
+/**
+ * 标记图层配置
+ */
+export interface MarkerConfig {
+    /** 标记ID */
+    id: string;
+    /** 标记位置 [lng, lat] */
+    lngLat: LngLatLike;
+    /** 标记选项 */
+    options?: MarkerOptions;
+    /** 自定义DOM元素 */
+    element?: HTMLElement;
+}
+/**
+ * 标记图层组配置
+ */
+export interface MarkerGroupConfig {
+    /** 标记数据数组 */
+    data: Array<{
+        /** 标记ID */
+        id: string;
+        /** 标记位置 [lng, lat] */
+        lngLat: LngLatLike;
+        /** 标记选项 */
+        options?: MarkerOptions;
+        /** 自定义DOM元素 */
+        element?: HTMLElement;
+    }>;
+}
+export default class MarkerLayer {
+    private adapter;
+    private markers;
+    private customLayers;
+    constructor(adapter: VectorTileAdapter);
+    /**
+     * 添加单个标记
+     * @param config 标记配置
+     */
+    add(config: MarkerConfig): void;
+    /**
+     * 批量添加标记
+     * @param config 标记组配置
+     */
+    addGroup(config: MarkerGroupConfig): void;
+    /**
+     * 移除标记
+     * @param id 标记ID
+     */
+    remove(id: string): void;
+    /**
+     * 清除所有标记
+     */
+    clear(): void;
+    /**
+     * 添加自定义图层
+     * @param id 图层ID
+     * @param layerConfig 图层配置
+     */
+    addCustomLayer(id: string, layerConfig: any): void;
+    /**
+     * 移除自定义图层
+     * @param id 图层ID
+     */
+    removeCustomLayer(id: string): void;
+    /**
+     * 清除所有自定义图层
+     */
+    clearCustomLayers(): void;
+    /**
+     * 获取所有标记
+     */
+    getMarkers(): Marker[];
+    /**
+     * 获取指定标记
+     * @param id 标记ID
+     */
+    getMarker(id: string): Marker | undefined;
+    /**
+     * 获取所有自定义图层
+     */
+    getCustomLayers(): any[];
+    /**
+     * 获取指定自定义图层
+     * @param id 图层ID
+     */
+    getCustomLayer(id: string): any;
+}

package/dist/manager/layer/VectorLayer.d.ts

@@ -0,0 +1,30 @@
+import { VectorTileAdapter } from '../../adapters/types';
+import { IEventBus, CoreMapEvents } from '../../core/event';
+import { LayerQueryClickPayload } from '../../core/event/types';
+/**
+ * 矢量图层封装
+ * 依赖 VectorTileAdapter 而非 GSMap，可与 Mapbox GL / MapLibre 等引擎配合使用。
+ */
+export default class VectorLayer {
+    private map;
+    /** 事件总线（由 LayerManager 注入） */
+    eventBus?: IEventBus<CoreMapEvents>;
+    layerId: string;
+    layerFilter: any;
+    isQuery: boolean;
+    dataExtension: any;
+    tooltipTemplate: string;
+    templateId: string | undefined;
+    isShowTooltip: boolean;
+    isCommonPopup: boolean;
+    private feature;
+    /** 图层点击回调（由 LayerManager 注入） */
+    onLayerClick?: (payload: LayerQueryClickPayload) => void;
+    get id(): string;
+    constructor(map: VectorTileAdapter, eventBus?: IEventBus<CoreMapEvents>);
+    private addSource;
+    add(layerConfig: any, beforeLayerId?: string): void;
+    remove(): void;
+    addInteraction(): void;
+    removeInteraction(): void;
+}