@gis_victory/gismap 2.0.24 → 2.0.25

package/dist/types/IGISMap.d.ts

@@ -0,0 +1,234 @@
+import { IManager } from './IManager';
+import { IEventSystem } from './IEvents';
+import { IStateStore, MapState } from './IState';
+/**
+ * 地图配置选项
+ */
+export interface GISMapOptions extends Omit<mapboxgl.MapboxOptions, 'container'> {
+    /** 容器 ID 或元素 */
+    container: string | HTMLElement;
+    /** 地图样式 */
+    style?: string | mapboxgl.StyleSpecification;
+    /** 初始中心点 */
+    center?: [number, number];
+    /** 初始缩放级别 */
+    zoom?: number;
+    /** 初始俯仰角 */
+    pitch?: number;
+    /** 初始旋转角度 */
+    bearing?: number;
+    /** 最小缩放 */
+    minZoom?: number;
+    /** 最大缩放 */
+    maxZoom?: number;
+    /** 最小俯仰角 */
+    minPitch?: number;
+    /** 最大俯仰角 */
+    maxPitch?: number;
+    /** 交互选项 */
+    interactive?: boolean;
+    /** 样式加载完成回调 */
+    onStyleLoad?: (event: any) => void;
+    /** 地图加载完成回调 */
+    onLoad?: (map: IGISMap) => void;
+    /** 错误回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 地图样式配置
+ */
+export interface GISMapStyleConfig {
+    /** 基础样式 URL */
+    base?: string;
+    /** 矢量样式 */
+    vector?: string;
+    /** 影像样式 */
+    satellite?: string;
+    /** 地形样式 */
+    terrain?: string;
+    /** 自定义样式 */
+    custom?: mapboxgl.StyleSpecification;
+    /** 字体 */
+    glyphs?: string;
+    /** 图标集 */
+    sprites?: string;
+}
+/**
+ * GIS 地图核心接口
+ * 继承 MapboxGL.Map 并扩展功能
+ */
+export interface IGISMap extends mapboxgl.Map {
+    /** 地图唯一标识 */
+    readonly id: string;
+    /** 地图名称 */
+    name: string;
+    /** 事件系统 */
+    readonly events: IEventSystem;
+    /** 状态管理 */
+    readonly store: IStateStore;
+    /** Manager 注册表 */
+    readonly managers: IManagerRegistry;
+    /** 插件系统 */
+    readonly plugins: IPluginRegistry;
+    /**
+     * 初始化地图
+     */
+    initialize(): Promise<void>;
+    /**
+     * 销毁地图
+     */
+    destroy(): void;
+    /**
+     * 获取地图状态
+     */
+    getState(): MapState;
+    /**
+     * 设置视图状态
+     */
+    setView(center: [number, number], zoom: number, bearing?: number, pitch?: number): void;
+    /**
+     * 飞转到指定位置
+     */
+    flyToCenter(center: [number, number], options?: any): void;
+    /**
+     * 缩放到指定级别
+     */
+    zoomTo(zoom: number, options?: mapboxgl.CameraOptions & mapboxgl.AnimationOptions): this;
+    /**
+     * 适应边界
+     */
+    fitBounds(bounds: [number, number, number, number], options?: mapboxgl.FitBoundsOptions): this;
+    /**
+     * 获取视图范围
+     */
+    getBounds(): mapboxgl.LngLatBounds;
+    /**
+     * 获取中心点
+     */
+    getCenter(): mapboxgl.LngLat;
+    /**
+     * 获取缩放级别
+     */
+    getZoom(): number;
+    /**
+     * 导出地图为图片
+     */
+    toImage(options?: {
+        format?: 'png' | 'jpg';
+        quality?: number;
+        width?: number;
+        height?: number;
+    }): Promise<string>;
+    /**
+     * 添加控件
+     */
+    addControl(control: mapboxgl.IControl, position?: string): this;
+    /**
+     * 移除控件
+     */
+    removeControl(control: mapboxgl.IControl): this;
+}
+/**
+ * Manager 注册表接口
+ */
+export interface IManagerRegistry {
+    /**
+     * 注册 Manager
+     */
+    register<T extends IManager>(name: string, factory: () => T, options?: any): 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(): void;
+    /**
+     * 销毁所有 Manager
+     */
+    disposeAll(): void;
+    /**
+     * 获取 Manager 名称列表
+     */
+    getNames(): string[];
+}
+/**
+ * 插件接口
+ */
+export interface IPlugin {
+    /** 插件名称 */
+    readonly name: string;
+    /** 插件版本 */
+    readonly version: string;
+    /**
+     * 安装插件
+     */
+    install(context: IGISMap, options?: any): void;
+    /**
+     * 卸载插件
+     */
+    uninstall?(context: IGISMap): void;
+}
+/**
+ * 插件注册表接口
+ */
+export interface IPluginRegistry {
+    /**
+     * 使用插件
+     */
+    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[];
+}
+/**
+ * GIS 地图工厂函数
+ */
+export interface GISMapFactory {
+    /**
+     * 创建地图实例
+     */
+    create(options: GISMapOptions): IGISMap;
+    /**
+     * 销毁地图实例
+     */
+    destroy(map: IGISMap): void;
+    /**
+     * 获取默认配置
+     */
+    getDefaultOptions(): GISMapOptions;
+}
+/**
+ * 全局 GISMap 实例类型
+ */
+export type GISMapInstance = IGISMap;

package/dist/types/IManager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Manager 基础接口
+ * 所有 Manager 必须实现此接口
+ */
+export interface IManager {
+    /** Manager 名称 */
+    readonly name: string;
+    /** 是否已初始化 */
+    readonly isInitialized: boolean;
+    /** 是否启用 */
+    readonly isEnabled: boolean;
+    /**
+     * 初始化 Manager
+     */
+    initialize(): void;
+    /**
+     * 销毁 Manager
+     */
+    dispose(): void;
+    /**
+     * 启用 Manager
+     */
+    enable(): void;
+    /**
+     * 禁用 Manager
+     */
+    disable(): void;
+    /**
+     * 重置 Manager 状态
+     */
+    reset(): void;
+}
+/**
+ * Manager 抽象基类
+ * 提供通用的 Manager 实现
+ */
+export declare abstract class BaseManager implements IManager {
+    readonly name: string;
+    protected _isInitialized: boolean;
+    protected _isEnabled: boolean;
+    constructor(name: string);
+    get isInitialized(): boolean;
+    get isEnabled(): boolean;
+    initialize(): void;
+    dispose(): void;
+    enable(): void;
+    disable(): void;
+    reset(): void;
+    /**
+     * 子类实现的初始化逻辑
+     */
+    protected onInitialize(): void;
+    /**
+     * 子类实现的销毁逻辑
+     */
+    protected onDispose(): void;
+    /**
+     * 子类实现的启用逻辑
+     */
+    protected onEnable(): void;
+    /**
+     * 子类实现的禁用逻辑
+     */
+    protected onDisable(): void;
+    /**
+     * 子类实现的重置逻辑
+     */
+    protected onReset(): void;
+}
+/**
+ * Manager 工厂函数类型
+ */
+export type ManagerFactory<T extends IManager = IManager> = (...args: any[]) => T;
+/**
+ * Manager 注册项
+ */
+export interface ManagerRegistration {
+    name: string;
+    factory: ManagerFactory;
+    options?: ManagerOptions;
+}
+/**
+ * Manager 配置选项
+ */
+export interface ManagerOptions {
+    /** 是否默认启用 */
+    enabled?: boolean;
+    /** 优先级，数值越大越先初始化 */
+    priority?: number;
+    /** 依赖的其他 Manager */
+    dependencies?: string[];
+}
+/**
+ * Manager 错误类
+ */
+export declare class ManagerError extends Error {
+    readonly managerName: string;
+    readonly code: ManagerErrorCode;
+    constructor(message: string, managerName: string, code?: ManagerErrorCode);
+}
+/**
+ * Manager 错误代码
+ */
+export declare const ManagerErrorCode: {
+    readonly NOT_INITIALIZED: "NOT_INITIALIZED";
+    readonly ALREADY_INITIALIZED: "ALREADY_INITIALIZED";
+    readonly DISABLED: "DISABLED";
+    readonly NOT_FOUND: "NOT_FOUND";
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly OPERATION_FAILED: "OPERATION_FAILED";
+    readonly UNKNOWN: "UNKNOWN";
+};
+export type ManagerErrorCode = typeof ManagerErrorCode[keyof typeof ManagerErrorCode];

package/dist/types/IMapSearch.d.ts

@@ -0,0 +1,28 @@
+/**
+ * {
+            "id": "xzq",
+            "name": "xzq",
+            "label": "行政村名称",
+            "placeholder": "请输入行政村名称",
+            "defaultValue": "",
+            "serviceUrl": "commonServer/query/quick_xzc",
+            "templateId": "quick_xzc"
+        }
+ */
+export interface MapSearchItem {
+    id: string;
+    name: string;
+    label: string;
+    placeholder?: string;
+    defaultValue?: string;
+    serviceUrl?: string;
+    templateId: string;
+}
+export interface TiandituQuery {
+    specify?: string;
+    queryType?: string;
+    start?: string;
+    count?: string;
+    dataTypes?: string;
+    show?: string;
+}

package/dist/types/IState.d.ts

@@ -0,0 +1,259 @@
+import { LngLat, Style } from '@gis_victory/mapbox-gl';
+/**
+ * 视图状态
+ */
+export interface ViewState {
+    center: LngLat;
+    zoom: number;
+    pitch: number;
+    bearing: number;
+    padding?: any;
+}
+/**
+ * 视图状态变化事件数据
+ */
+export interface ViewStateChangeEvent {
+    viewState: ViewState;
+    animate: boolean;
+}
+/**
+ * 图层类型
+ */
+export type LayerType = 'background' | 'fill' | 'line' | 'symbol' | 'raster' | 'circle' | 'fill-extrusion' | 'heatmap' | 'hillshade' | 'sky' | 'model' | 'custom' | 'geojson' | 'vector' | 'raster-dem';
+/**
+ * 图层可见性
+ */
+export type LayerVisibility = 'visible' | 'none' | 'visible';
+/**
+ * 图层配置
+ */
+export interface LayerConfig {
+    id: string;
+    type: LayerType;
+    source?: string | GeoJSONSource | VectorSource | RasterSource;
+    sourceLayer?: string;
+    minzoom?: number;
+    maxzoom?: number;
+    layout?: LayerLayout;
+    paint?: LayerPaint;
+    metadata?: Record<string, any>;
+    /** 是否可交互（点击、悬停） */
+    interactive?: boolean;
+    /** 是否可查询 */
+    queryable?: boolean;
+}
+/**
+ * 图层布局属性
+ */
+export interface LayerLayout {
+    visibility?: LayerVisibility;
+    'symbol-placement'?: 'point' | 'line' | 'line-center';
+    'symbol-spacing'?: number;
+    'symbol-avoid-edges'?: boolean;
+    'text-field'?: any;
+    'text-font'?: string[];
+    'text-size'?: number;
+}
+/**
+ * 图层绘制属性
+ */
+export interface LayerPaint {
+    'fill-color'?: any;
+    'fill-opacity'?: number;
+    'fill-pattern'?: string;
+    'fill-outline-color'?: any;
+    'line-color'?: any;
+    'line-width'?: number;
+    'line-opacity'?: number;
+    'line-dasharray'?: number[];
+    'text-color'?: any;
+    'text-halo-color'?: any;
+    'text-halo-width'?: number;
+}
+/**
+ * 图层状态
+ */
+export interface LayerState {
+    id: string;
+    type: LayerType;
+    visible: boolean;
+    opacity: number;
+    minzoom?: number;
+    maxzoom?: number;
+    config: LayerConfig;
+}
+/**
+ * 图层可见性变化事件数据
+ */
+export interface LayerVisibilityChangeEvent {
+    layerId: string;
+    visible: boolean;
+}
+/**
+ * 标记配置
+ */
+export interface MarkerConfig {
+    id?: string;
+    position: LngLat | [number, number];
+    element?: HTMLElement;
+    html?: string;
+    icon?: string;
+    iconName?: string;
+    offset?: [number, number];
+    anchor?: 'center' | 'top' | 'bottom' | 'left' | 'right';
+    rotation?: number;
+    rotationOrigin?: string;
+    draggable?: boolean;
+    popup?: PopupConfig;
+}
+/**
+ * 标记状态
+ */
+export interface MarkerState {
+    id: string;
+    position: LngLat;
+    visible: boolean;
+    config: MarkerConfig;
+}
+/**
+ * 弹窗配置
+ */
+export interface PopupConfig {
+    id?: string;
+    position: LngLat | [number, number];
+    content?: string | HTMLElement;
+    html?: string;
+    closeButton?: boolean;
+    closeOnClick?: boolean;
+    closeOnMove?: boolean;
+    maxWidth?: string;
+    anchor?: 'center' | 'top' | 'bottom' | 'left' | 'right';
+    offset?: number | [number, number] | Record<string, [number, number]>;
+}
+/**
+ * 弹窗状态
+ */
+export interface PopupState {
+    id: string;
+    position: LngLat;
+    visible: boolean;
+    config: PopupConfig;
+}
+/**
+ * GeoJSON 数据源
+ */
+export interface GeoJSONSource {
+    type: 'geojson';
+    data?: any;
+    url?: string;
+    cluster?: boolean;
+    clusterMaxZoom?: number;
+    clusterRadius?: number;
+    lineMetrics?: boolean;
+    generateId?: boolean;
+}
+/**
+ * Vector 数据源
+ */
+export interface VectorSource {
+    type: 'vector';
+    url?: string;
+    tiles?: string[];
+    bounds?: [number, number, number, number];
+    minzoom?: number;
+    maxzoom?: number;
+    attribution?: string;
+}
+/**
+ * Raster 数据源
+ */
+export interface RasterSource {
+    type: 'raster';
+    url?: string;
+    tiles?: string[];
+    tileSize?: number;
+    minzoom?: number;
+    maxzoom?: number;
+    bounds?: [number, number, number, number];
+}
+/**
+ * 地图状态
+ */
+export interface MapState {
+    /** 视图状态 */
+    view: ViewState;
+    /** 图层状态 */
+    layers: Map<string, LayerState>;
+    /** 标记状态 */
+    markers: Map<string, MarkerState>;
+    /** 弹窗状态 */
+    popups: Map<string, PopupState>;
+    /** 当前激活的弹窗 */
+    activePopup: PopupState | null;
+    /** 当前选中的要素 */
+    selectedFeatures: any[];
+    /** 地图是否加载完成 */
+    loaded: boolean;
+    /** 地图是否可用 */
+    ready: boolean;
+    /** 地图样式 */
+    style: Style | null;
+    /** 地图容器 */
+    container: HTMLElement | null;
+}
+/**
+ * 状态变更
+ */
+export interface StateMutation {
+    type: string;
+    payload: any;
+    timestamp: number;
+}
+/**
+ * 状态订阅者
+ */
+export type StateSubscriber = (mutation: StateMutation, state: MapState) => void;
+/**
+ * 状态管理接口
+ */
+export interface IStateStore {
+    /** 获取当前状态 */
+    getState(): MapState;
+    /** 获取特定状态 */
+    get<K extends keyof MapState>(key: K): MapState[K];
+    /** 更新状态 */
+    setState(partial: Partial<MapState>): void;
+    /** 设置特定状态 */
+    set<K extends keyof MapState>(key: K, value: MapState[K]): void;
+    /** 订阅状态变更 */
+    subscribe(listener: StateSubscriber): () => void;
+    /** 重置状态 */
+    reset(): void;
+    /** 持久化状态 */
+    persist(): void;
+    /** 恢复状态 */
+    restore(): void;
+}
+/**
+ * 状态历史记录
+ */
+export interface StateHistory {
+    past: MapState[];
+    future: MapState[];
+    maxSize: number;
+}
+/**
+ * 可时间旅行的状态管理
+ */
+export interface ITimeTravelStore extends IStateStore {
+    /** 撤销 */
+    undo(): void;
+    /** 重做 */
+    redo(): void;
+    /** 是否可撤销 */
+    canUndo(): boolean;
+    /** 是否可重做 */
+    canRedo(): boolean;
+    /** 清空历史 */
+    clearHistory(): void;
+}

package/dist/types/ITemplate.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 模板字段配置
+ */
+export interface TemplateField {
+    fieldType: string;
+    fieldName: string;
+    fieldLabel: string;
+    format: string;
+    unit: string;
+    style: {
+        span: number;
+    };
+    isShowList?: boolean;
+    isShowInfo?: boolean;
+    isShowMore?: boolean;
+}
+/**
+ * 模板按钮配置
+ */
+export interface TemplateButton {
+    label: string;
+    type: string;
+    event?: string;
+}
+/**
+ * 模板配置
+ */
+export interface TemplateItem {
+    id: string;
+    width?: number;
+    labelWidth?: number;
+    header: string;
+    body: TemplateField[];
+    footer: TemplateButton[];
+}

package/dist/types/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * GIS 地图类型定义入口
+ */
+export * from './IManager';
+export * from './IGISMap';
+export * from './IEvents';
+export * from './IState';

package/dist/utils/hooks/layout.d.ts

@@ -0,0 +1,4 @@
+import { MapAdapter } from '../../adapters';
+export default function useLayout(mapAdapter: MapAdapter | undefined): {
+    mapHeight: import('vue').Ref<number, number>;
+};

package/dist/utils/http/axios.d.ts

@@ -0,0 +1,3 @@
+import { AxiosInstance } from 'axios';
+declare const axiosInstance: AxiosInstance;
+export default axiosInstance;

package/dist/utils/http/config.d.ts

@@ -0,0 +1,3 @@
+export declare const serverDefaultCfg: {
+    baseURL: string;
+};