@gis_victory/gismap 2.0.24 → 2.0.25

package/dist/composables/useLayer.d.ts

@@ -0,0 +1,57 @@
+import { MaybeRefOrGetter } from 'vue';
+import { LayerConfig, LayerEntity, EntityId } from '../domain';
+/** 图层选项 */
+export interface UseLayerOptions {
+    /** 初始可见性 */
+    visible?: boolean;
+    /** 初始透明度 */
+    opacity?: number;
+    /** 是否自动添加到地图 */
+    autoAdd?: boolean;
+}
+/** 使用单个图层 */
+export declare function useLayer(layerId: MaybeRefOrGetter<EntityId>): {
+    layer: import('vue').ComputedRef<LayerEntity | undefined>;
+    state: import('vue').ComputedRef<any>;
+    visible: import('vue').WritableComputedRef<any, boolean>;
+    opacity: import('vue').WritableComputedRef<any, number>;
+    type: import('vue').ComputedRef<import('../domain').LayerType | undefined>;
+    metadata: import('vue').ComputedRef<Record<string, any> | undefined>;
+    exists: import('vue').ComputedRef<boolean>;
+    show: () => void;
+    hide: () => void;
+    toggle: () => any;
+    remove: () => any;
+    setOpacity: (value: number) => void;
+};
+/** 使用图层列表 */
+export declare function useLayers(): {
+    layers: import('vue').ComputedRef<any>;
+    layerStates: any;
+    visibleLayers: import('vue').ComputedRef<any>;
+    count: import('vue').ComputedRef<any>;
+    addLayer: (config: LayerConfig, beforeId?: string) => any;
+    removeLayer: (layerId: EntityId) => any;
+    removeAll: () => void;
+    showAll: () => void;
+    hideAll: () => void;
+    getLayer: (layerId: EntityId) => any;
+    getLayersByType: (type: string) => any;
+};
+/** 使用图层组 */
+export declare function useLayerGroup(groupId: MaybeRefOrGetter<EntityId>): {
+    group: import('vue').ComputedRef<any>;
+    layers: import('vue').ComputedRef<any>;
+    visible: import('vue').WritableComputedRef<any, boolean>;
+    expanded: import('vue').WritableComputedRef<any, boolean>;
+    exists: import('vue').ComputedRef<boolean>;
+};
+/** 创建并管理图层 */
+export declare function useLayerManager(config: MaybeRefOrGetter<LayerConfig>, options?: UseLayerOptions): {
+    layerId: Readonly<import('vue').Ref<string | null, string | null>>;
+    isAdded: Readonly<import('vue').Ref<boolean, boolean>>;
+    layer: import('vue').ComputedRef<LayerEntity | undefined>;
+    visible: import('vue').ComputedRef<import('vue').WritableComputedRef<any, boolean> | undefined>;
+    opacity: import('vue').ComputedRef<any>;
+    remove: () => void;
+};

package/dist/composables/useMap.d.ts

@@ -0,0 +1,111 @@
+import { InjectionKey, App, Ref } from 'vue';
+import { MapContext } from '../services';
+import { CoreMapEvents } from '../core/event';
+/** 地图上下文注入键 - 现在注入的是 Ref */
+export declare const MapContextKey: InjectionKey<Ref<MapContext | null>>;
+/** 地图状态注入键 */
+export declare const MapStateKey: InjectionKey<Ref<ReturnType<typeof createMapState> | null>>;
+/** 创建响应式地图状态（供 MapContainer 内部使用） */
+export declare function createMapState(context: MapContext): {
+    view: Readonly<Ref<{
+        readonly center: {
+            readonly lng: number;
+            readonly lat: number;
+            readonly wrap: () => import('@gis_victory/mapbox-gl').LngLat;
+            readonly toArray: () => [number, number];
+            readonly toString: () => string;
+            readonly distanceTo: (lngLat: import('@gis_victory/mapbox-gl').LngLat) => number;
+            readonly toBounds: (radius?: number) => import('@gis_victory/mapbox-gl').LngLatBounds;
+            readonly toEcef: (altitude: number) => [number, number, number];
+        };
+        readonly zoom: number;
+        readonly pitch: number;
+        readonly bearing: number;
+        readonly padding?: any;
+    }, {
+        readonly center: {
+            readonly lng: number;
+            readonly lat: number;
+            readonly wrap: () => import('@gis_victory/mapbox-gl').LngLat;
+            readonly toArray: () => [number, number];
+            readonly toString: () => string;
+            readonly distanceTo: (lngLat: import('@gis_victory/mapbox-gl').LngLat) => number;
+            readonly toBounds: (radius?: number) => import('@gis_victory/mapbox-gl').LngLatBounds;
+            readonly toEcef: (altitude: number) => [number, number, number];
+        };
+        readonly zoom: number;
+        readonly pitch: number;
+        readonly bearing: number;
+        readonly padding?: any;
+    }>>;
+    loaded: Readonly<Ref<boolean, boolean>>;
+    ready: Readonly<Ref<boolean, boolean>>;
+    layers: Readonly<Ref<ReadonlyMap<string, any>, ReadonlyMap<string, any>>>;
+    markers: Readonly<Ref<ReadonlyMap<string, any>, ReadonlyMap<string, any>>>;
+    dispose: () => void;
+};
+/** 使用地图上下文 - 返回 Ref */
+export declare function useMap(): Ref<MapContext | null>;
+/** 使用地图状态 */
+export declare function useMapState(): Ref<ReturnType<typeof createMapState> | null>;
+/** 使用视图状态 */
+export declare function useViewState(): {
+    view: import('vue').ComputedRef<Readonly<Ref<{
+        readonly center: {
+            readonly lng: number;
+            readonly lat: number;
+            readonly wrap: () => import('@gis_victory/mapbox-gl').LngLat;
+            readonly toArray: () => [number, number];
+            readonly toString: () => string;
+            readonly distanceTo: (lngLat: import('@gis_victory/mapbox-gl').LngLat) => number;
+            readonly toBounds: (radius?: number) => import('@gis_victory/mapbox-gl').LngLatBounds;
+            readonly toEcef: (altitude: number) => [number, number, number];
+        };
+        readonly zoom: number;
+        readonly pitch: number;
+        readonly bearing: number;
+        readonly padding?: any;
+    }, {
+        readonly center: {
+            readonly lng: number;
+            readonly lat: number;
+            readonly wrap: () => import('@gis_victory/mapbox-gl').LngLat;
+            readonly toArray: () => [number, number];
+            readonly toString: () => string;
+            readonly distanceTo: (lngLat: import('@gis_victory/mapbox-gl').LngLat) => number;
+            readonly toBounds: (radius?: number) => import('@gis_victory/mapbox-gl').LngLatBounds;
+            readonly toEcef: (altitude: number) => [number, number, number];
+        };
+        readonly zoom: number;
+        readonly pitch: number;
+        readonly bearing: number;
+        readonly padding?: any;
+    }>> | undefined>;
+    center: import('vue').ComputedRef<{
+        readonly lng: number;
+        readonly lat: number;
+        readonly wrap: () => import('@gis_victory/mapbox-gl').LngLat;
+        readonly toArray: () => [number, number];
+        readonly toString: () => string;
+        readonly distanceTo: (lngLat: import('@gis_victory/mapbox-gl').LngLat) => number;
+        readonly toBounds: (radius?: number) => import('@gis_victory/mapbox-gl').LngLatBounds;
+        readonly toEcef: (altitude: number) => [number, number, number];
+    } | undefined>;
+    zoom: import('vue').ComputedRef<number | undefined>;
+    pitch: import('vue').ComputedRef<number | undefined>;
+    bearing: import('vue').ComputedRef<number | undefined>;
+};
+/** 使用地图事件 */
+export declare function useMapEvent<K extends keyof CoreMapEvents>(event: K, handler: (payload: CoreMapEvents[K]) => void): () => void;
+/** 使用地图就绪事件 */
+export declare function useMapReady(callback: (context: MapContext) => void): void;
+/** 地图提供者
+ * 在应用或组件树的顶层使用
+ */
+export declare function provideMap(context: MapContext): void;
+/** 安装地图插件
+ * 用于 Vue app.use()
+ */
+export declare function installMapPlugin(context: MapContext): {
+    install(app: App): void;
+};

package/dist/composables/useMarker.d.ts

@@ -0,0 +1,55 @@
+import { MaybeRefOrGetter } from 'vue';
+import { MarkerConfig, MarkerEntity, EntityId, GeoCoordinate } from '../domain';
+/** 标记选项 */
+export interface UseMarkerOptions {
+    /** 是否自动添加到地图 */
+    autoAdd?: boolean;
+    /** 初始可见性 */
+    visible?: boolean;
+    /** 是否可拖拽 */
+    draggable?: boolean;
+}
+/** 使用单个标记 */
+export declare function useMarker(markerId: MaybeRefOrGetter<EntityId>): {
+    marker: import('vue').ComputedRef<MarkerEntity | undefined>;
+    state: import('vue').ComputedRef<any>;
+    position: import('vue').WritableComputedRef<GeoCoordinate | undefined, GeoCoordinate | undefined>;
+    visible: import('vue').WritableComputedRef<any, boolean>;
+    draggable: import('vue').ComputedRef<boolean>;
+    dragging: import('vue').ComputedRef<boolean>;
+    popupVisible: import('vue').ComputedRef<boolean>;
+    exists: import('vue').ComputedRef<boolean>;
+    show: () => void;
+    hide: () => void;
+    toggle: () => any;
+    remove: () => any;
+    setPosition: (lng: number, lat: number) => void;
+    moveTo: (lng: number, lat: number, animate?: boolean) => void;
+    openPopup: () => void;
+    closePopup: () => void;
+    togglePopup: () => any;
+};
+/** 使用标记列表 */
+export declare function useMarkers(): {
+    markers: import('vue').ComputedRef<any>;
+    markerStates: any;
+    visibleMarkers: import('vue').ComputedRef<any>;
+    count: import('vue').ComputedRef<any>;
+    addMarker: (config: MarkerConfig) => any;
+    removeMarker: (markerId: EntityId) => any;
+    removeAll: () => void;
+    showAll: () => void;
+    hideAll: () => void;
+    getMarker: (markerId: EntityId) => any;
+    getMarkersInBounds: (bounds: [[number, number], [number, number]]) => any;
+};
+/** 创建并管理标记 */
+export declare function useMarkerManager(config: MaybeRefOrGetter<MarkerConfig>, options?: UseMarkerOptions): {
+    markerId: Readonly<import('vue').Ref<string | null, string | null>>;
+    isAdded: Readonly<import('vue').Ref<boolean, boolean>>;
+    marker: import('vue').ComputedRef<MarkerEntity | undefined>;
+    position: import('vue').ComputedRef<import('vue').WritableComputedRef<GeoCoordinate | undefined, GeoCoordinate | undefined> | undefined>;
+    visible: import('vue').ComputedRef<import('vue').WritableComputedRef<any, boolean> | undefined>;
+    popupVisible: import('vue').ComputedRef<import('vue').ComputedRef<boolean> | undefined>;
+    remove: () => void;
+};

package/dist/composables/useMeasure.d.ts

@@ -0,0 +1,49 @@
+import { Ref } from 'vue';
+import { MeasureType, MeasureResult, CoordinateType, DistanceUnit, AreaUnit } from '../manager/mapbox/MeasureManager';
+/** 测量选项 */
+export interface UseMeasureOptions {
+    /** 测量完成回调 */
+    onMeasure?: (result: MeasureResult) => void;
+    /** 坐标类型：经纬度或墨卡托投影 */
+    coordinateType?: CoordinateType;
+    /** 经纬度小数位数，默认6位 */
+    lnglatDecimal?: number;
+    /** 墨卡托投影小数位数，默认2位 */
+    mercatorDecimal?: number;
+    /** 距离单位，默认自动 */
+    distanceUnit?: DistanceUnit;
+    /** 面积单位，默认自动 */
+    areaUnit?: AreaUnit;
+}
+/** useMeasure 返回值 */
+export interface UseMeasureReturn {
+    /** 是否正在测量 */
+    isMeasuring: Ref<boolean>;
+    /** 当前测量类型 */
+    measureType: Ref<MeasureType | 'none'>;
+    /** 测量结果数量 */
+    count: Ref<number>;
+    /** 开始测量 */
+    startMeasure: (type: MeasureType) => void;
+    /** 停止测量 */
+    stopMeasure: () => void;
+    /** 清除当前测量 */
+    clearMeasuring: () => void;
+    /** 获取所有结果 */
+    getAll: () => MeasureResult[];
+    /** 获取指定结果 */
+    get: (id: string) => MeasureResult | undefined;
+    /** 删除指定结果 */
+    delete: (id: string) => boolean;
+    /** 删除所有结果 */
+    clear: () => void;
+    /** 更新配置 */
+    updateOptions: (options: Partial<UseMeasureOptions>) => void;
+    /** 设置测量完成回调 */
+    onMeasure: (callback: (result: MeasureResult) => void) => void;
+}
+/**
+ * 使用地图测量功能
+ * @param options 回调选项
+ */
+export declare function useMeasure(options?: UseMeasureOptions): UseMeasureReturn;

package/dist/composables/useSearch.d.ts

@@ -0,0 +1,20 @@
+import { default as QuickSearchManager } from '../manager/QuickSearchManager';
+import { SearchResult, SearchOptions } from '../types/IEvents';
+export interface UseSearchReturn {
+    searchManager: QuickSearchManager | null;
+    keyword: string;
+    searching: boolean;
+    results: SearchResult[];
+    search: (keyword: string, options?: SearchOptions) => Promise<SearchResult[]>;
+    clearSearch: () => void;
+    selectResult: (result: SearchResult) => void;
+    history: string[];
+    addToHistory: (keyword: string) => void;
+    clearHistory: () => void;
+}
+/**
+ * 地图搜索组合式函数
+ * 封装 QuickSearchManager 的功能
+ */
+export declare function useSearch(): UseSearchReturn;
+export default useSearch;

package/dist/config/api.config.d.ts

@@ -0,0 +1,40 @@
+/**
+ * API配置 - 集中管理所有API端点
+ * 便于部署配置和环境切换
+ */
+export interface ApiEndpoint {
+    path: string;
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    description?: string;
+}
+export interface ApiConfig {
+    baseURL: string;
+    timeout: number;
+    endpoints: Record<string, string | ApiEndpoint>;
+}
+declare const API_CONFIG: ApiConfig;
+/**
+ * 获取API端点URL
+ */
+export declare const getEndpoint: (key: string) => string;
+/**
+ * 获取完整URL
+ */
+export declare const getFullUrl: (key: string) => string;
+/**
+ * 设置baseURL
+ */
+export declare const setBaseURL: (url: string) => void;
+/**
+ * 设置超时时间
+ */
+export declare const setTimeout: (ms: number) => void;
+/**
+ * 自定义端点
+ */
+export declare const setEndpoint: (key: string, path: string) => void;
+/**
+ * 获取完整配置
+ */
+export declare const getConfig: () => ApiConfig;
+export default API_CONFIG;

package/dist/config/gismap.config.d.ts

@@ -0,0 +1,156 @@
+import { GISMapOptions, GISMapStyleConfig } from '../types/IGISMap';
+import { LayerConfig } from '../types/IState';
+/**
+ * 图标配置
+ */
+export interface IconConfig {
+    id: string;
+    name: string;
+    url: string;
+    size?: [number, number];
+    anchor?: 'center' | 'top' | 'bottom' | 'left' | 'right';
+}
+/**
+ * 模板配置
+ */
+export interface TemplateConfig {
+    id: string;
+    name: string;
+    header?: string;
+    body?: string;
+    footer?: string;
+    style?: Record<string, any>;
+}
+/**
+ * 控件配置
+ */
+export interface ControlConfig {
+    enabled: boolean;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    options?: Record<string, any>;
+}
+/**
+ * GISMap 完整配置
+ */
+export interface GISMapFullConfig {
+    /** 地图基础配置 */
+    map: Partial<GISMapOptions>;
+    /** 样式配置 */
+    styles: GISMapStyleConfig;
+    /** 默认图层 */
+    defaultLayers: LayerConfig[];
+    /** 图标配置 */
+    icons: IconConfig[];
+    /** 模板配置 */
+    templates: TemplateConfig[];
+    /** 控件配置 */
+    controls: {
+        navigation?: ControlConfig;
+        scale?: ControlConfig;
+        fullscreen?: ControlConfig;
+        geolocate?: ControlConfig;
+        attribution?: ControlConfig;
+    };
+    /** TDT 配置 */
+    tdt: {
+        enabled: boolean;
+        token: string;
+        defaultLayer: 'vec' | 'img' | 'ter';
+    };
+    /** 地形配置 */
+    terrain: {
+        enabled: boolean;
+        exaggeration: number;
+        source?: any;
+    };
+    /** 交互配置 */
+    interaction: {
+        doubleClickZoom: boolean;
+        dragPan: boolean;
+        dragRotate: boolean;
+        scrollZoom: boolean;
+        touchZoomRotate: boolean;
+        keyboard: boolean;
+    };
+}
+/**
+ * 默认配置
+ */
+export declare const defaultConfig: GISMapFullConfig;
+/**
+ * 配置管理器
+ */
+declare class ConfigManager {
+    private config;
+    private listeners;
+    constructor();
+    /**
+     * 获取完整配置
+     */
+    getConfig(): GISMapFullConfig;
+    /**
+     * 获取地图配置
+     */
+    getMapConfig(): Partial<GISMapOptions>;
+    /**
+     * 获取样式配置
+     */
+    getStyleConfig(): GISMapStyleConfig;
+    /**
+     * 获取图标配置
+     */
+    getIconConfig(id: string): IconConfig | undefined;
+    /**
+     * 获取所有图标
+     */
+    getAllIcons(): IconConfig[];
+    /**
+     * 获取模板配置
+     */
+    getTemplateConfig(id: string): TemplateConfig | undefined;
+    /**
+     * 获取所有模板
+     */
+    getAllTemplates(): TemplateConfig[];
+    /**
+     * 更新配置
+     */
+    updateConfig(partial: Partial<GISMapFullConfig>): void;
+    /**
+     * 设置地图配置
+     */
+    setMapConfig(mapConfig: Partial<GISMapOptions>): void;
+    /**
+     * 添加图标
+     */
+    addIcon(icon: IconConfig): void;
+    /**
+     * 添加模板
+     */
+    addTemplate(template: TemplateConfig): void;
+    /**
+     * 加载配置（从 JSON 文件或对象）
+     */
+    loadConfig(config: Partial<GISMapFullConfig> | string): void;
+    /**
+     * 重置为默认配置
+     */
+    reset(): void;
+    /**
+     * 订阅配置变更
+     */
+    subscribe(listener: (config: GISMapFullConfig) => void): () => void;
+    /**
+     * 通知所有监听器
+     */
+    private notifyListeners;
+}
+/**
+ * 全局配置管理器实例
+ */
+export declare const configManager: ConfigManager;
+/**
+ * 获取配置管理器
+ */
+export declare function useConfig(): ConfigManager;
+export default configManager;

package/dist/core/ManagerRegistry.d.ts

@@ -0,0 +1,75 @@
+import { IManager, ManagerOptions } from '../types/IManager';
+type ManagerFactory = (map: any, ...args: any[]) => any;
+/**
+ * Manager 注册中心类
+ */
+export declare class ManagerRegistry {
+    private map;
+    private instances;
+    private initialized;
+    private enabledManagers;
+    tdtToken?: string;
+    constructor(map: any, tdtToken?: string);
+    /**
+     * 注册 Manager（静态方法，全局注册）
+     */
+    static register(name: string, factory: ManagerFactory, options?: ManagerOptions): void;
+    /**
+     * 获取已注册的 Manager 名称列表
+     */
+    static getRegisteredNames(): string[];
+    /**
+     * 实例方法：注册 Manager（实例级注册）
+     */
+    register(name: string, factory: ManagerFactory, options?: ManagerOptions): void;
+    /**
+     * 获取 Manager
+     */
+    get<T extends IManager = any>(name: string): T | undefined;
+    /**
+     * 获取所有 Manager
+     */
+    getAll(): Map<string, IManager>;
+    /**
+     * 检查 Manager 是否存在
+     */
+    has(name: string): boolean;
+    /**
+     * 移除 Manager
+     */
+    unregister(name: string): void;
+    /**
+     * 初始化所有已注册的 Manager
+     * 按依赖顺序和优先级初始化
+     */
+    initializeAll(): this;
+    /**
+     * 销毁所有 Manager
+     */
+    disposeAll(): void;
+    /**
+     * 获取 Manager 名称列表
+     */
+    getNames(): string[];
+    /**
+     * 启用 Manager
+     */
+    enable(name: string): void;
+    /**
+     * 禁用 Manager
+     */
+    disable(name: string): void;
+    /**
+     * 检查 Manager 是否启用
+     */
+    isEnabled(name: string): boolean;
+    /**
+     * 获取启用的 Manager 列表
+     */
+    getEnabled(): string[];
+}
+/**
+ * 创建 Manager 注册中心
+ */
+export declare function createManagerRegistry(map: any): ManagerRegistry;
+export default ManagerRegistry;

package/dist/core/PluginSystem.d.ts

@@ -0,0 +1,71 @@
+import { IPlugin, IPluginRegistry, IGISMap } from '../types/IGISMap';
+import { IManager } from '../types/IManager';
+/**
+ * 插件注册表
+ */
+export declare class PluginRegistry implements IPluginRegistry {
+    private plugins;
+    private dependencies;
+    private map;
+    constructor(map: IGISMap);
+    /**
+     * 使用插件
+     */
+    use(plugin: IPlugin, options?: any): void;
+    /**
+     * 卸载插件
+     */
+    unuse(name: string): void;
+    /**
+     * 获取插件
+     */
+    get(name: string): IPlugin | undefined;
+    /**
+     * 检查插件是否已安装
+     */
+    has(name: string): boolean;
+    /**
+     * 获取所有插件
+     */
+    getAll(): Map<string, IPlugin>;
+    /**
+     * 获取插件依赖
+     */
+    getDependencies(name: string): string[];
+    /**
+     * 卸载所有插件
+     */
+    unuseAll(): void;
+}
+/**
+ * 基础插件类
+ * 提供插件的通用实现
+ */
+export declare abstract class BasePlugin implements IPlugin {
+    abstract readonly name: string;
+    abstract readonly version: string;
+    dependencies: string[];
+    abstract install(context: IGISMap, options?: any): void;
+    uninstall?(context: IGISMap): void;
+}
+/**
+ * 创建插件注册表
+ */
+export declare function createPluginRegistry(map: IGISMap): IPluginRegistry;
+/**
+ * 插件管理器 - 整合 Manager 和 Plugin
+ * Manager 可以作为插件注册
+ */
+export declare class PluginManager {
+    private pluginRegistry;
+    constructor(map: IGISMap);
+    /**
+     * 注册 Manager 作为插件
+     */
+    registerManagerAsPlugin(managerName: string, managerFactory: () => IManager): void;
+    /**
+     * 获取插件注册表
+     */
+    getPluginRegistry(): IPluginRegistry;
+}
+export default PluginRegistry;