@gis_victory/gismap 2.0.23 → 2.0.25

package/dist/core/StateStore.d.ts

@@ -0,0 +1,96 @@
+import { MapState, IStateStore, StateSubscriber, ITimeTravelStore } from '../types/IState';
+/**
+ * 状态存储实现
+ */
+export declare class StateStore implements IStateStore {
+    private state;
+    private subscribers;
+    private mutationId;
+    constructor(initialState?: Partial<MapState>);
+    /**
+     * 获取当前状态
+     */
+    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;
+    /**
+     * 通知订阅者
+     */
+    private notifySubscribers;
+    /**
+     * 获取 mutation ID
+     */
+    getMutationId(): number;
+}
+/**
+ * 支持时间旅行的状态存储
+ */
+export declare class TimeTravelStateStore extends StateStore implements ITimeTravelStore {
+    private past;
+    private future;
+    private maxHistorySize;
+    private isRestoring;
+    constructor(initialState?: Partial<MapState>);
+    /**
+     * 撤销
+     */
+    undo(): void;
+    /**
+     * 重做
+     */
+    redo(): void;
+    /**
+     * 是否可撤销
+     */
+    canUndo(): boolean;
+    /**
+     * 是否可重做
+     */
+    canRedo(): boolean;
+    /**
+     * 清空历史
+     */
+    clearHistory(): void;
+    /**
+     * 设置历史记录最大大小
+     */
+    setMaxHistorySize(size: number): void;
+    /**
+     * 覆盖父类方法以支持时间旅行
+     */
+    setState(partial: Partial<MapState>): void;
+}
+/**
+ * 创建状态存储
+ */
+export declare function createStateStore(initialState?: Partial<MapState>): IStateStore;
+/**
+ * 创建支持时间旅行的状态存储
+ */
+export declare function createTimeTravelStore(initialState?: Partial<MapState>): ITimeTravelStore;

package/dist/core/TypedEventEmitter.d.ts

@@ -0,0 +1,67 @@
+import { GISMapEventName, GISMapEventData, EventCallback, EventHistoryItem } from '../types/IEvents';
+export declare class TypedEventEmitter {
+    private events;
+    private onceEvents;
+    private history;
+    private maxHistorySize;
+    private namespaceListeners;
+    /**
+     * 订阅事件
+     */
+    on<K extends GISMapEventName>(event: K, callback: EventCallback<GISMapEventData[K]>): () => void;
+    /**
+     * 订阅事件（仅触发一次）
+     */
+    once<K extends GISMapEventName>(event: K, callback: EventCallback<GISMapEventData[K]>): () => void;
+    /**
+     * 取消订阅
+     */
+    off(event: GISMapEventName, callback?: EventCallback): void;
+    /**
+     * 发射事件
+     */
+    emit<K extends GISMapEventName>(event: K, data?: GISMapEventData[K]): void;
+    /**
+     * 订阅命名空间下的所有事件
+     */
+    onNamespace(namespace: string, callback: (payload: {
+        event: string;
+        data: any;
+    }) => void): () => void;
+    /**
+     * 获取事件历史
+     */
+    getHistory(): EventHistoryItem[];
+    /**
+     * 清空事件历史
+     */
+    clearHistory(): void;
+    /**
+     * 获取订阅者数量
+     */
+    listenerCount(event: GISMapEventName): number;
+    /**
+     * 检查是否有订阅者
+     */
+    hasListeners(event?: GISMapEventName): boolean;
+    /**
+     * 获取所有事件名称
+     */
+    eventNames(): GISMapEventName[];
+    /**
+     * 清空所有事件
+     */
+    clear(): void;
+    /**
+     * 添加到历史记录
+     */
+    private addToHistory;
+    /**
+     * 设置历史记录最大大小
+     */
+    setMaxHistorySize(size: number): void;
+}
+/**
+ * 创建事件发射器实例
+ */
+export declare function createEventEmitter(): TypedEventEmitter;

package/dist/core/di/Container.d.ts

@@ -0,0 +1,61 @@
+import { Token, Provider, IContainer, InjectableConstructor } from './types';
+/** 依赖注入容器 */
+export declare class Container implements IContainer {
+    private services;
+    private singletons;
+    private parent;
+    private disposed;
+    constructor(parent?: Container);
+    /**
+     * 注册服务
+     */
+    register<T>(token: Token<T>, provider: Provider<T>): this;
+    /**
+     * 注册类
+     */
+    registerClass<T>(token: Token<T>, useClass: InjectableConstructor<T>, singleton?: boolean): this;
+    /**
+     * 注册工厂
+     */
+    registerFactory<T>(token: Token<T>, useFactory: (container: IContainer) => T, singleton?: boolean): this;
+    /**
+     * 注册值
+     */
+    registerValue<T>(token: Token<T>, useValue: T): this;
+    /**
+     * 解析服务
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * 检查服务是否存在
+     */
+    has<T>(token: Token<T>): boolean;
+    /**
+     * 创建子作用域
+     */
+    createScope(): IContainer;
+    /**
+     * 清理容器
+     */
+    dispose(): void;
+    /**
+     * 创建实例
+     */
+    private createInstance;
+    /**
+     * 创建类实例（支持依赖注入）
+     */
+    private createClassInstance;
+    /**
+     * 检查是否为单例
+     */
+    private isSingleton;
+    /**
+     * 确保容器未销毁
+     */
+    private ensureNotDisposed;
+}
+/** 全局容器实例 */
+export declare const rootContainer: Container;
+/** 创建新容器 */
+export declare function createContainer(): IContainer;

package/dist/core/di/decorators.d.ts

@@ -0,0 +1,32 @@
+import { Token, InjectableConstructor } from './types';
+/**
+ * @Injectable 装饰器
+ * 标记类可被依赖注入
+ */
+export declare function Injectable<T extends InjectableConstructor>(singleton?: boolean): (target: T) => T;
+/**
+ * @Inject 装饰器
+ * 标记构造函数参数需要注入
+ */
+export declare function Inject<T>(token: Token<T>): (target: any, _propertyKey: string | symbol | undefined, parameterIndex: number) => void;
+/**
+ * @Optional 装饰器
+ * 标记依赖为可选
+ */
+export declare function Optional(): (target: any, _propertyKey: string | symbol | undefined, parameterIndex: number) => void;
+/**
+ * 注册服务（简化语法）
+ */
+export declare function registerService<T>(token: Token<T>, constructor: InjectableConstructor<T>, singleton?: boolean): void;
+/**
+ * 注册值
+ */
+export declare function registerValue<T>(token: Token<T>, value: T): void;
+/**
+ * 注册工厂
+ */
+export declare function registerFactory<T>(token: Token<T>, factory: (container: any) => T, singleton?: boolean): void;
+/**
+ * 解析服务
+ */
+export declare function resolveService<T>(token: Token<T>): T;

package/dist/core/di/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 依赖注入模块统一导出
+ */
+export { Container, rootContainer, createContainer } from './Container';
+export { Injectable, Inject, Optional, registerService, registerValue, registerFactory, resolveService, } from './decorators';
+export { createToken } from './types';
+export type { Token, Provider, ClassProvider, FactoryProvider, ValueProvider, IContainer, InjectableConstructor, DependencyMetadata, IDisposable, IInitializable, } from './types';

package/dist/core/di/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 依赖注入类型定义
+ * 提供类型安全的 DI 容器支持
+ */
+/** 服务标识符 */
+export interface Token<T> {
+    readonly symbol: symbol;
+    readonly name: string;
+}
+/** 创建服务标识符 */
+export declare function createToken<T>(name: string): Token<T>;
+/** 提供者类型 */
+export type Provider<T> = ClassProvider<T> | FactoryProvider<T> | ValueProvider<T>;
+/** 类提供者 */
+export interface ClassProvider<T> {
+    type: 'class';
+    useClass: new (...args: any[]) => T;
+    singleton?: boolean;
+}
+/** 工厂提供者 */
+export interface FactoryProvider<T> {
+    type: 'factory';
+    useFactory: (container: IContainer) => T;
+    singleton?: boolean;
+}
+/** 值提供者 */
+export interface ValueProvider<T> {
+    type: 'value';
+    useValue: T;
+}
+/** 容器接口 */
+export interface IContainer {
+    /** 注册服务 */
+    register<T>(token: Token<T>, provider: Provider<T>): this;
+    /** 解析服务 */
+    resolve<T>(token: Token<T>): T;
+    /** 检查是否存在 */
+    has<T>(token: Token<T>): boolean;
+    /** 创建子作用域 */
+    createScope(): IContainer;
+    /** 清理 */
+    dispose(): void;
+}
+/** 可注入的构造函数 */
+export type InjectableConstructor<T = any> = new (...args: any[]) => T;
+/** 依赖元数据 */
+export interface DependencyMetadata {
+    index: number;
+    token: Token<any>;
+    optional?: boolean;
+}
+/** 可销毁接口 */
+export interface IDisposable {
+    dispose(): void;
+}
+/** 可初始化接口 */
+export interface IInitializable {
+    initialize(): void;
+}

package/dist/core/event/EventBus.d.ts

@@ -0,0 +1,101 @@
+import { EventHandler, Unsubscribe, EventMap, EventHistoryItem, INamespacedEventBus } from './types';
+/** 事件总线配置 */
+export interface EventBusOptions {
+    /** 历史记录最大长度 */
+    maxHistorySize?: number;
+    /** 启用命名空间监听 */
+    enableNamespace?: boolean;
+    /** 日志级别 */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'none';
+}
+/** 统一事件总线实现 */
+export declare class EventBus<T extends EventMap = EventMap> implements INamespacedEventBus<T> {
+    private subscriptions;
+    private namespaceSubscriptions;
+    private history;
+    private options;
+    private disposed;
+    constructor(options?: EventBusOptions);
+    /**
+     * 订阅事件
+     */
+    on<K extends keyof T>(event: K, handler: EventHandler<T[K]>): Unsubscribe;
+    /**
+     * 订阅一次性事件
+     */
+    once<K extends keyof T>(event: K, handler: EventHandler<T[K]>): Unsubscribe;
+    /**
+     * 发射事件
+     */
+    emit<K extends keyof T>(event: K, payload: T[K]): void;
+    /**
+     * 取消订阅
+     */
+    off<K extends keyof T>(event?: K, handler?: EventHandler<T[K]>): void;
+    /**
+     * 订阅命名空间
+     */
+    onNamespace(namespace: string, handler: (event: string, payload: any) => void): Unsubscribe;
+    /**
+     * 获取订阅数量
+     */
+    listenerCount<K extends keyof T>(event: K): number;
+    /**
+     * 是否有订阅者
+     */
+    hasListeners<K extends keyof T>(event?: K): boolean;
+    /**
+     * 获取历史记录
+     */
+    getHistory(): EventHistoryItem[];
+    /**
+     * 清空历史
+     */
+    clearHistory(): void;
+    /**
+     * 销毁
+     */
+    dispose(): void;
+    /**
+     * 生成唯一ID
+     */
+    private generateId;
+    /**
+     * 移除订阅
+     */
+    private removeSubscription;
+    /**
+     * 触发命名空间监听
+     */
+    private triggerNamespaceListeners;
+    /**
+     * 添加到历史
+     */
+    private addToHistory;
+    /**
+     * 日志
+     */
+    private log;
+    /**
+     * 确保未销毁
+     */
+    private ensureNotDisposed;
+}
+/** 创建事件总线 */
+export declare function createEventBus<T extends EventMap = EventMap>(options?: EventBusOptions): EventBus<T>;
+/**
+ * ⚠️ 多地图架构说明
+ *
+ * 本项目支持同一页面挂载多个地图实例（多 MapContainer）。
+ * 每个 MapContainer 在 onMounted 时创建自己的独立 EventBus 实例，
+ * 通过 Vue provide/inject 下发给子组件树，确保事件完全隔离。
+ *
+ * 正确用法：
+ *   const { events } = useMap();          // ✅ 当前地图的独立事件总线
+ *   context.events.emit('view:change', …) // ✅ 当前地图的独立事件总线
+ *
+ * 禁止：
+ *   import { globalEventBus } from '…'    // ❌ 会造成多地图事件串扰
+ *
+ * globalEventBus 已从公开导出中移除，如需跨地图通信请在业务层自行管理。
+ */

package/dist/core/event/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 事件系统模块统一导出
+ */
+export { EventBus, createEventBus } from './EventBus';
+export type { EventHandler, Unsubscribe, EventMap, EventSubscription, EventHistoryItem, IEventBus, INamespacedEventBus, CoreMapEvents, ViewChangePayload, LayerAddPayload, LayerClickPayload, LayerHoverPayload, SwitchLayerPayload, SwitchClickPayload, TemplateGetPayload, } from './types';

package/dist/core/event/types.d.ts

@@ -0,0 +1,215 @@
+/**
+ * 事件系统类型定义
+ * 统一、类型安全的事件系统
+ */
+/** 事件处理器 */
+export type EventHandler<T = any> = (payload: T) => void;
+/** 取消订阅函数 */
+export type Unsubscribe = () => void;
+/** 事件映射 */
+export interface EventMap {
+    [key: string]: any;
+}
+/** 事件订阅 */
+export interface EventSubscription<T = any> {
+    id: string;
+    handler: EventHandler<T>;
+    once: boolean;
+}
+/** 事件历史记录 */
+export interface EventHistoryItem<T = any> {
+    event: string;
+    payload: T;
+    timestamp: number;
+}
+/** 事件总线接口 */
+export interface IEventBus<T extends EventMap = EventMap> {
+    /**
+     * 订阅事件
+     */
+    on<K extends keyof T>(event: K, handler: EventHandler<T[K]>): Unsubscribe;
+    /**
+     * 订阅一次性事件
+     */
+    once<K extends keyof T>(event: K, handler: EventHandler<T[K]>): Unsubscribe;
+    /**
+     * 发射事件
+     */
+    emit<K extends keyof T>(event: K, payload: T[K]): void;
+    /**
+     * 取消所有订阅
+     */
+    off<K extends keyof T>(event?: K, handler?: EventHandler<T[K]>): void;
+    /**
+     * 获取订阅数量
+     */
+    listenerCount<K extends keyof T>(event: K): number;
+    /**
+     * 是否有订阅者
+     */
+    hasListeners<K extends keyof T>(event?: K): boolean;
+    /**
+     * 清空历史
+     */
+    clearHistory(): void;
+    /**
+     * 获取历史
+     */
+    getHistory(): EventHistoryItem[];
+    /**
+     * 销毁
+     */
+    dispose(): void;
+}
+/** 命名空间事件总线 */
+export interface INamespacedEventBus<T extends EventMap = EventMap> extends IEventBus<T> {
+    /**
+     * 订阅命名空间下的所有事件
+     */
+    onNamespace(namespace: string, handler: (event: string, payload: any) => void): Unsubscribe;
+}
+/** 地图核心事件 */
+export interface CoreMapEvents extends EventMap {
+    'map:load': {
+        map: any;
+    };
+    'map:ready': {
+        map: any;
+    };
+    'map:error': {
+        error: Error;
+        source?: string;
+    };
+    'map:destroy': void;
+    'view:change': ViewChangePayload;
+    'view:move': ViewChangePayload;
+    'view:zoom': {
+        zoom: number;
+        center: [number, number];
+    };
+    'view:rotate': {
+        bearing: number;
+    };
+    'view:pitch': {
+        pitch: number;
+    };
+    'layer:add': LayerAddPayload;
+    'layer:remove': {
+        layerId: string;
+    };
+    'layer:show': {
+        layerId: string;
+    };
+    'layer:hide': {
+        layerId: string;
+    };
+    'layer:click': LayerClickPayload;
+    'layer:hover': LayerHoverPayload;
+    'layer:queryClick': LayerQueryClickPayload;
+    'marker:add': {
+        markerId: string;
+        position: [number, number];
+    };
+    'marker:remove': {
+        markerId: string;
+    };
+    'marker:click': {
+        markerId: string;
+        position: [number, number];
+    };
+    'popup:open': {
+        popupId: string;
+        position: [number, number];
+    };
+    'popup:close': {
+        popupId: string;
+    };
+    'select:start': void;
+    'select:end': {
+        features: any[];
+    };
+    'draw:start': {
+        mode: string;
+    };
+    'draw:end': {
+        feature: any;
+        mode: string;
+    };
+    /** 底图图层切换（非内置 tdt-img/tdt-vec 时触发，name 为自定义图层名） */
+    'switch:layer': SwitchLayerPayload;
+    /** 任意底图切换后通知（所有底图点击均触发） */
+    'switch:widgets': SwitchLayerPayload;
+    /** 叠加图层（extension）点击事件 */
+    'switch:click': SwitchClickPayload;
+    /** 指定叠加图层点击事件，key 形如 "switch:click:terrain" */
+    'switch:click:terrain': SwitchClickPayload;
+    'switch:click:custom': SwitchClickPayload;
+    'template:get': TemplateGetPayload;
+}
+/** 视图变化载荷 */
+export interface ViewChangePayload {
+    center: [number, number];
+    zoom: number;
+    pitch: number;
+    bearing: number;
+    animate: boolean;
+}
+/** 图层添加载荷 */
+export interface LayerAddPayload {
+    layerId: string;
+    type: string;
+    source?: any;
+    config?: any;
+}
+/** 图层点击载荷 */
+export interface LayerClickPayload {
+    layerId: string;
+    feature: any;
+    coordinates: [number, number];
+    point: [number, number];
+    originalEvent: MouseEvent;
+}
+/** 图层查询点击载荷 */
+export interface LayerQueryClickPayload {
+    layerId: string;
+    templateId?: string;
+    center?: [number, number];
+    feature?: any;
+    features?: any[];
+    dataExtension?: any;
+    isShowTooltip?: boolean;
+    isCommonPopup?: boolean;
+}
+/** 图层悬停载荷 */
+export interface LayerHoverPayload {
+    layerId: string;
+    feature: any | null;
+    coordinates: [number, number] | null;
+}
+/** 底图图层切换载荷（MapSwitch / MobileBaseLayerSwitch 触发） */
+export interface SwitchLayerPayload {
+    /** 图层名称标识 */
+    name: string;
+    /** 图层标签 */
+    label?: string;
+    /** 是否选中 */
+    checked?: boolean;
+    /** 自定义 source 配置（可选） */
+    source?: any;
+    /** 其他扩展字段 */
+    [key: string]: any;
+}
+/** 叠加图层切换载荷 */
+export interface SwitchClickPayload {
+    /** 是否选中 */
+    checked: boolean;
+    /** 原始数据 */
+    data: SwitchLayerPayload;
+}
+/** 模板查询载荷（MapSearch 触发，业务层监听后调用 callback 回填配置） */
+export interface TemplateGetPayload {
+    /** 模板 ID */
+    templateId: string;
+    /** 回调：业务层取到配置后调用此函数将配置传回 */
+    callback: (config: any) => void;
+}

package/dist/core/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 核心基础设施统一导出
+ */
+export * from './di';
+export * from './event';
+export * from './state';