@gis_victory/gismap 2.0.23 → 2.0.25

package/dist/core/state/Store.d.ts

@@ -0,0 +1,145 @@
+import { StateListener, StateSelector, IStateStore, ITimeTravelStore, IPersistableStore } from './types';
+/** 状态存储配置 */
+export interface StoreOptions<T> {
+    /** 初始状态 */
+    initialState: T;
+    /** 状态名称（用于调试） */
+    name?: string;
+    /** 启用严格模式（只允许通过 setState 修改） */
+    strict?: boolean;
+}
+/** 基础状态存储 */
+export declare class Store<T extends Record<string, any>> implements IStateStore<T> {
+    protected state: T;
+    protected listeners: Set<StateListener<T>>;
+    protected name: string;
+    protected strict: boolean;
+    protected disposed: boolean;
+    constructor(options: StoreOptions<T>);
+    /**
+     * 获取当前状态
+     */
+    getState(): T;
+    /**
+     * 获取特定键的值
+     */
+    get<K extends keyof T>(key: K): T[K];
+    /**
+     * 更新状态
+     */
+    setState(partial: Partial<T>): void;
+    /**
+     * 设置特定键的值
+     */
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    /**
+     * 订阅状态变化
+     */
+    subscribe(listener: StateListener<T>): () => void;
+    /**
+     * 订阅特定键的变化
+     */
+    subscribeKey<K extends keyof T>(key: K, listener: (value: T[K], prevValue: T[K]) => void): () => void;
+    /**
+     * 使用选择器获取值
+     */
+    select<R>(selector: StateSelector<T, R>): R;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+    /**
+     * 销毁
+     */
+    dispose(): void;
+    /**
+     * 通知监听器
+     */
+    protected notifyListeners(prevState: T): void;
+    /**
+     * 浅比较两个状态
+     */
+    protected isEqual(a: T, b: T): boolean;
+    /**
+     * 确保未销毁
+     */
+    protected ensureNotDisposed(): void;
+}
+/** 支持时间旅行的状态存储 */
+export declare class TimeTravelStore<T extends Record<string, any>> extends Store<T> implements ITimeTravelStore<T> {
+    private history;
+    private future;
+    private maxHistorySize;
+    private isRestoring;
+    constructor(options: StoreOptions<T> & {
+        maxHistorySize?: number;
+    });
+    /**
+     * 撤销
+     */
+    undo(): void;
+    /**
+     * 重做
+     */
+    redo(): void;
+    /**
+     * 是否可以撤销
+     */
+    canUndo(): boolean;
+    /**
+     * 是否可以重做
+     */
+    canRedo(): boolean;
+    /**
+     * 清空历史
+     */
+    clearHistory(): void;
+    /**
+     * 获取历史大小
+     */
+    getHistorySize(): number;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+    /**
+     * 更新状态（重写以支持历史记录）
+     */
+    setState(partial: Partial<T>): void;
+}
+/** 支持持久化的状态存储 */
+export declare class PersistableStore<T extends Record<string, any>> extends Store<T> implements IPersistableStore<T> {
+    readonly storageKey: string;
+    private storage;
+    constructor(options: StoreOptions<T> & {
+        storageKey: string;
+        storage?: Storage;
+    });
+    /**
+     * 持久化状态
+     */
+    persist(): void;
+    /**
+     * 从存储恢复
+     */
+    restore(): void;
+    /**
+     * 清除持久化数据
+     */
+    clearPersisted(): void;
+    /**
+     * 重置状态
+     */
+    reset(): void;
+}
+/** 创建状态存储 */
+export declare function createStore<T extends Record<string, any>>(options: StoreOptions<T>): Store<T>;
+/** 创建支持时间旅行的状态存储 */
+export declare function createTimeTravelStore<T extends Record<string, any>>(options: StoreOptions<T> & {
+    maxHistorySize?: number;
+}): TimeTravelStore<T>;
+/** 创建支持持久化的状态存储 */
+export declare function createPersistableStore<T extends Record<string, any>>(options: StoreOptions<T> & {
+    storageKey: string;
+    storage?: Storage;
+}): PersistableStore<T>;

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

@@ -0,0 +1,6 @@
+/**
+ * 状态管理模块统一导出
+ */
+export { Store, TimeTravelStore, PersistableStore, createStore, createTimeTravelStore, createPersistableStore, } from './Store';
+export type { StateListener, StateSelector, StateMutation, IStateStore, ITimeTravelStore, IPersistableStore, ViewState, LayerState, MarkerState, PopupState, SourceState, MapState, } from './types';
+export { DEFAULT_VIEW_STATE, createDefaultMapState } from './types';

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

@@ -0,0 +1,134 @@
+import { LngLat, Style } from '@gis_victory/mapbox-gl';
+/** 状态变更监听器 */
+export type StateListener<T> = (state: T, prevState: T) => void;
+/** 选择器函数 */
+export type StateSelector<T, R> = (state: T) => R;
+/** 状态变更描述 */
+export interface StateMutation<T = any> {
+    type: string;
+    payload: T;
+    timestamp: number;
+}
+/** 状态存储接口 */
+export interface IStateStore<T extends Record<string, any> = Record<string, any>> {
+    /** 获取当前状态 */
+    getState(): T;
+    /** 获取部分状态 */
+    get<K extends keyof T>(key: K): T[K];
+    /** 更新状态 */
+    setState(partial: Partial<T>): void;
+    /** 设置特定键值 */
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    /** 订阅状态变化 */
+    subscribe(listener: StateListener<T>): () => void;
+    /** 订阅特定键的变化 */
+    subscribeKey<K extends keyof T>(key: K, listener: (value: T[K], prevValue: T[K]) => void): () => void;
+    /** 使用选择器订阅 */
+    select<R>(selector: StateSelector<T, R>): R;
+    /** 重置状态 */
+    reset(): void;
+    /** 销毁 */
+    dispose(): void;
+}
+/** 可时间旅行的状态存储 */
+export interface ITimeTravelStore<T extends Record<string, any> = Record<string, any>> extends IStateStore<T> {
+    /** 撤销 */
+    undo(): void;
+    /** 重做 */
+    redo(): void;
+    /** 是否可以撤销 */
+    canUndo(): boolean;
+    /** 是否可以重做 */
+    canRedo(): boolean;
+    /** 清空历史 */
+    clearHistory(): void;
+    /** 获取历史长度 */
+    getHistorySize(): number;
+}
+/** 可持久化的状态存储 */
+export interface IPersistableStore<T extends Record<string, any> = Record<string, any>> extends IStateStore<T> {
+    /** 持久化键 */
+    readonly storageKey: string;
+    /** 保存到存储 */
+    persist(): void;
+    /** 从存储恢复 */
+    restore(): void;
+    /** 清除持久化数据 */
+    clearPersisted(): void;
+}
+/** 视图状态 */
+export interface ViewState {
+    center: LngLat;
+    zoom: number;
+    pitch: number;
+    bearing: number;
+    padding?: any;
+}
+/** 图层状态 */
+export interface LayerState {
+    id: string;
+    type: string;
+    visible: boolean;
+    opacity: number;
+    minzoom?: number;
+    maxzoom?: number;
+    metadata?: Record<string, any>;
+}
+/** 标记状态 */
+export interface MarkerState {
+    id: string;
+    position: LngLat;
+    visible: boolean;
+    draggable?: boolean;
+    metadata?: Record<string, any>;
+}
+/** 弹窗状态 */
+export interface PopupState {
+    id: string;
+    position: LngLat;
+    visible: boolean;
+    content?: string;
+    metadata?: Record<string, any>;
+}
+/** 数据源状态 */
+export interface SourceState {
+    id: string;
+    type: 'geojson' | 'vector' | 'raster' | 'raster-dem' | 'image' | 'video';
+    loaded: boolean;
+}
+/** 完整地图状态 */
+export interface MapState {
+    /** 视图状态 */
+    view: ViewState;
+    /** 图层状态映射 */
+    layers: Map<string, LayerState>;
+    /** 标记状态映射 */
+    markers: Map<string, MarkerState>;
+    /** 弹窗状态映射 */
+    popups: Map<string, PopupState>;
+    /** 数据源状态映射 */
+    sources: Map<string, SourceState>;
+    /** 当前激活的弹窗ID */
+    activePopupId: string | null;
+    /** 选中的要素 */
+    selectedFeatures: any[];
+    /** 地图是否加载完成 */
+    loaded: boolean;
+    /** 地图是否就绪 */
+    ready: boolean;
+    /** 当前样式 */
+    style: Style | null;
+    /** 容器元素 */
+    container: HTMLElement | null;
+    /** 交互状态 */
+    interaction: {
+        isDragging: boolean;
+        isZooming: boolean;
+        isRotating: boolean;
+        cursor: string;
+    };
+}
+/** 默认视图状态 */
+export declare const DEFAULT_VIEW_STATE: ViewState;
+/** 创建默认地图状态 */
+export declare function createDefaultMapState(): MapState;

package/dist/domain/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 领域层统一导出
+ */
+export * from './types';
+export * from './layer/LayerEntity';
+export * from './layer/LayerService';
+export * from './marker/MarkerEntity';
+export * from './marker/MarkerService';

package/dist/domain/layer/LayerEntity.d.ts

@@ -0,0 +1,90 @@
+import { IEntity, IVisible, IConfigurable, EntityId } from '../types';
+/** 图层类型 */
+export type LayerType = 'background' | 'fill' | 'line' | 'symbol' | 'raster' | 'circle' | 'fill-extrusion' | 'heatmap' | 'hillshade' | 'sky' | 'model';
+/** 数据源类型 */
+export type SourceType = 'geojson' | 'vector' | 'raster' | 'raster-dem' | 'image' | 'video';
+/** 图层配置 */
+export interface LayerConfig {
+    id?: EntityId;
+    type: LayerType;
+    source?: string | SourceConfig;
+    sourceLayer?: string;
+    minzoom?: number;
+    maxzoom?: number;
+    layout?: Record<string, any>;
+    paint?: Record<string, any>;
+    filter?: any[];
+    metadata?: Record<string, any>;
+    beforeId?: string;
+}
+/** 数据源配置 */
+export interface SourceConfig {
+    id?: EntityId;
+    type: SourceType;
+    data?: any;
+    url?: string;
+    tiles?: string[];
+    tileSize?: number;
+    minzoom?: number;
+    maxzoom?: number;
+    bounds?: [number, number, number, number];
+    scheme?: 'xyz' | 'tms';
+    attribution?: string;
+}
+/** 图层实体 */
+export declare class LayerEntity implements IEntity, IVisible, IConfigurable<LayerConfig> {
+    readonly id: EntityId;
+    readonly type: LayerType;
+    private _visible;
+    private _opacity;
+    private _config;
+    private _source?;
+    private _metadata;
+    constructor(config: LayerConfig);
+    get visible(): boolean;
+    show(): void;
+    hide(): void;
+    toggle(): boolean;
+    get opacity(): number;
+    setOpacity(value: number): void;
+    get config(): LayerConfig;
+    updateConfig(updates: Partial<LayerConfig>): void;
+    get source(): SourceConfig | undefined;
+    setSource(source: SourceConfig): void;
+    get sourceId(): string | undefined;
+    get minzoom(): number | undefined;
+    get maxzoom(): number | undefined;
+    isVisibleAtZoom(zoom: number): boolean;
+    setMetadata(key: string, value: any): void;
+    getMetadata(key: string): any;
+    toJSON(): Record<string, any>;
+    /**
+     * 从 JSON 创建实例
+     */
+    static fromJSON(json: Record<string, any>): LayerEntity;
+    /**
+     * 克隆图层
+     */
+    clone(newId?: string): LayerEntity;
+}
+/** 图层组 */
+export declare class LayerGroup {
+    readonly id: EntityId;
+    name: string;
+    private layers;
+    private _visible;
+    private _expanded;
+    constructor(id?: EntityId, name?: string);
+    get visible(): boolean;
+    show(): void;
+    hide(): void;
+    get expanded(): boolean;
+    expand(): void;
+    collapse(): void;
+    addLayer(layer: LayerEntity): void;
+    removeLayer(layerId: EntityId): boolean;
+    getLayer(layerId: EntityId): LayerEntity | undefined;
+    getLayers(): LayerEntity[];
+    hasLayer(layerId: EntityId): boolean;
+    clear(): void;
+}

package/dist/domain/layer/LayerService.d.ts

@@ -0,0 +1,128 @@
+import { IDomainService, EntityId } from '../types';
+import { LayerEntity, LayerGroup, LayerConfig, SourceConfig } from './LayerEntity';
+import { IEventBus, CoreMapEvents } from '../../core/event';
+import { IStateStore, MapState } from '../../core/state';
+/** 图层服务配置 */
+export interface LayerServiceConfig {
+    eventBus: IEventBus<CoreMapEvents>;
+    stateStore: IStateStore<MapState>;
+}
+/** 图层领域服务 */
+export declare class LayerService implements IDomainService {
+    private layers;
+    private groups;
+    private sources;
+    private layerOrder;
+    private eventBus;
+    private stateStore;
+    private initialized;
+    constructor(config: LayerServiceConfig);
+    initialize(): void;
+    dispose(): void;
+    /**
+     * 添加图层
+     */
+    addLayer(config: LayerConfig, beforeId?: string): LayerEntity;
+    /**
+     * 移除图层
+     */
+    removeLayer(layerId: EntityId): boolean;
+    /**
+     * 获取图层
+     */
+    getLayer(layerId: EntityId): LayerEntity | undefined;
+    /**
+     * 获取所有图层
+     */
+    getLayers(): LayerEntity[];
+    /**
+     * 检查图层是否存在
+     */
+    hasLayer(layerId: EntityId): boolean;
+    /**
+     * 更新图层
+     */
+    updateLayer(layerId: EntityId, updates: Partial<LayerConfig>): LayerEntity;
+    /**
+     * 显示图层
+     */
+    showLayer(layerId: EntityId): void;
+    /**
+     * 隐藏图层
+     */
+    hideLayer(layerId: EntityId): void;
+    /**
+     * 切换图层可见性
+     */
+    toggleLayer(layerId: EntityId): boolean;
+    /**
+     * 设置图层透明度
+     */
+    setLayerOpacity(layerId: EntityId, opacity: number): void;
+    /**
+     * 创建图层组
+     */
+    createGroup(name: string, id?: EntityId): LayerGroup;
+    /**
+     * 获取图层组
+     */
+    getGroup(groupId: EntityId): LayerGroup | undefined;
+    /**
+     * 删除图层组
+     */
+    removeGroup(groupId: EntityId): boolean;
+    /**
+     * 添加图层到组
+     */
+    addLayerToGroup(layerId: EntityId, groupId: EntityId): void;
+    /**
+     * 注册数据源
+     */
+    registerSource(source: SourceConfig): void;
+    /**
+     * 添加数据源
+     */
+    addSource(source: SourceConfig): void;
+    /**
+     * 获取数据源
+     */
+    getSource(sourceId: EntityId): SourceConfig | undefined;
+    /**
+     * 移除数据源
+     */
+    removeSource(sourceId: EntityId): boolean;
+    /**
+     * 移动图层到指定位置
+     */
+    moveLayer(layerId: EntityId, beforeId?: string): void;
+    /**
+     * 获取图层顺序
+     */
+    getLayerOrder(): EntityId[];
+    /**
+     * 根据类型获取图层
+     */
+    getLayersByType(type: string): LayerEntity[];
+    /**
+     * 获取可见图层
+     */
+    getVisibleLayers(): LayerEntity[];
+    /**
+     * 获取可查询的图层
+     */
+    getQueryableLayers(): LayerEntity[];
+    /**
+     * 显示所有图层
+     */
+    showAll(): void;
+    /**
+     * 隐藏所有图层
+     */
+    hideAll(): void;
+    /**
+     * 移除所有图层
+     */
+    removeAll(): void;
+    private updateState;
+    private syncFromState;
+}

package/dist/domain/marker/MarkerEntity.d.ts

@@ -0,0 +1,77 @@
+import { IEntity, IVisible, IConfigurable, EntityId, GeoCoordinate } from '../types';
+import { LngLat } from '@gis_victory/mapbox-gl';
+/** 标记锚点位置 */
+export type MarkerAnchor = 'center' | 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+/** 标记配置 */
+export interface MarkerConfig {
+    id?: EntityId;
+    position: GeoCoordinate | [number, number] | LngLat;
+    element?: HTMLElement;
+    html?: string;
+    icon?: string;
+    iconName?: string;
+    iconUrl?: string;
+    offset?: [number, number];
+    anchor?: MarkerAnchor;
+    rotation?: number;
+    rotationAlignment?: 'map' | 'viewport' | 'auto';
+    pitchAlignment?: 'map' | 'viewport' | 'auto';
+    draggable?: boolean;
+    scale?: number;
+    color?: string;
+    popup?: PopupConfig;
+    metadata?: Record<string, any>;
+}
+/** 弹窗配置 */
+export interface PopupConfig {
+    id?: EntityId;
+    content?: string | HTMLElement;
+    html?: string;
+    closeButton?: boolean;
+    closeOnClick?: boolean;
+    closeOnMove?: boolean;
+    maxWidth?: string;
+    anchor?: MarkerAnchor;
+    offset?: number | [number, number];
+}
+/** 标记实体 */
+export declare class MarkerEntity implements IEntity, IVisible, IConfigurable<MarkerConfig> {
+    readonly id: EntityId;
+    private _position;
+    private _visible;
+    private _config;
+    private _draggable;
+    private _dragging;
+    private _popup?;
+    private _popupVisible;
+    private _metadata;
+    constructor(config: MarkerConfig);
+    get position(): GeoCoordinate;
+    setPosition(position: GeoCoordinate | [number, number] | LngLat): void;
+    get lngLat(): [number, number];
+    get visible(): boolean;
+    show(): void;
+    hide(): void;
+    toggle(): boolean;
+    get draggable(): boolean;
+    setDraggable(value: boolean): void;
+    get dragging(): boolean;
+    startDrag(): void;
+    endDrag(): void;
+    get popup(): PopupConfig | undefined;
+    setPopup(config: PopupConfig): void;
+    get popupVisible(): boolean;
+    openPopup(): void;
+    closePopup(): void;
+    togglePopup(): boolean;
+    get config(): MarkerConfig;
+    updateConfig(updates: Partial<MarkerConfig>): void;
+    setMetadata(key: string, value: any): void;
+    getMetadata(key: string): any;
+    toJSON(): Record<string, any>;
+    /**
+     * 从 JSON 创建实例
+     */
+    static fromJSON(json: Record<string, any>): MarkerEntity;
+    private normalizePosition;
+}

package/dist/domain/marker/MarkerService.d.ts

@@ -0,0 +1,105 @@
+import { IDomainService, EntityId } from '../types';
+import { MarkerEntity, MarkerConfig } from './MarkerEntity';
+import { IEventBus, CoreMapEvents } from '../../core/event';
+import { IStateStore, MapState } from '../../core/state';
+/** 标记服务配置 */
+export interface MarkerServiceConfig {
+    eventBus: IEventBus<CoreMapEvents>;
+    stateStore: IStateStore<MapState>;
+}
+/** 标记领域服务 */
+export declare class MarkerService implements IDomainService {
+    private markers;
+    private eventBus;
+    private stateStore;
+    private initialized;
+    constructor(config: MarkerServiceConfig);
+    initialize(): void;
+    dispose(): void;
+    /**
+     * 添加标记
+     */
+    addMarker(config: MarkerConfig): MarkerEntity;
+    /**
+     * 移除标记
+     */
+    removeMarker(markerId: EntityId): boolean;
+    /**
+     * 获取标记
+     */
+    getMarker(markerId: EntityId): MarkerEntity | undefined;
+    /**
+     * 获取所有标记
+     */
+    getMarkers(): MarkerEntity[];
+    /**
+     * 检查标记是否存在
+     */
+    hasMarker(markerId: EntityId): boolean;
+    /**
+     * 更新标记
+     */
+    updateMarker(markerId: EntityId, updates: Partial<MarkerConfig>): MarkerEntity;
+    /**
+     * 设置标记位置
+     */
+    setPosition(markerId: EntityId, position: [number, number]): void;
+    /**
+     * 移动标记（带动画）
+     */
+    moveMarker(markerId: EntityId, position: [number, number], _animate?: boolean): void;
+    /**
+     * 显示标记
+     */
+    showMarker(markerId: EntityId): void;
+    /**
+     * 隐藏标记
+     */
+    hideMarker(markerId: EntityId): void;
+    /**
+     * 切换标记可见性
+     */
+    toggleMarker(markerId: EntityId): boolean;
+    /**
+     * 打开标记弹窗
+     */
+    openPopup(markerId: EntityId): void;
+    /**
+     * 关闭标记弹窗
+     */
+    closePopup(markerId: EntityId): void;
+    /**
+     * 切换弹窗
+     */
+    togglePopup(markerId: EntityId): boolean;
+    /**
+     * 设置标记可拖拽
+     */
+    setDraggable(markerId: EntityId, draggable: boolean): void;
+    /**
+     * 开始拖拽
+     */
+    startDrag(markerId: EntityId): void;
+    /**
+     * 结束拖拽
+     */
+    endDrag(markerId: EntityId): void;
+    /**
+     * 显示所有标记
+     */
+    showAll(): void;
+    /**
+     * 隐藏所有标记
+     */
+    hideAll(): void;
+    /**
+     * 移除所有标记
+     */
+    removeAll(): void;
+    /**
+     * 获取范围内的标记
+     */
+    getMarkersInBounds(bounds: [[number, number], [number, number]]): MarkerEntity[];
+    private updateState;
+    private syncFromState;
+}