@gis_victory/gismap 2.0.80 → 2.0.82

package/dist/index.d.ts

@@ -313,6 +313,15 @@ enable: () => void;
 disable: () => void;
 reset: () => void;
 } | undefined;
+readonly maskManager: {
+add: (options: MaskOptions) => MaskManager;
+addLine: (style?: any) => void;
+remove: () => void;
+updateData: (data: any) => void;
+setVisible: (visible: boolean) => void;
+getLayerId: () => string;
+getLineLayerId: () => string;
+} | undefined;
 readonly templateManager: {
 initialize: (templateItems: TemplateItem[]) => void;
 getTemplate: (templateId: string) => TemplateItem | undefined;
@@ -367,6 +376,8 @@ zoomTo: (zoom: number) => void;
 zoomIn: () => void;
 zoomOut: () => void;
 getInitialViewState: () => ViewState_2 | null;
+getSourceBounds: () => [number, number, number, number] | null;
+setSourceBounds: (bounds: [number, number, number, number] | null) => void;
 readonly isReady: boolean;
 on: <K extends keyof CoreMapEvents>(event: K, handler: (payload: CoreMapEvents[K]) => void) => () => void;
 once: <K extends keyof CoreMapEvents>(event: K, handler: (payload: CoreMapEvents[K]) => void) => () => void;
@@ -411,6 +422,7 @@ name: string;
 url: string;
 }>;
 options: Partial<MapInitOptions>;
+theme: "light" | "dark";
 }, {}, {}, {}, string, ComponentProvideOptions, false, {
 containerRef: HTMLDivElement;
 mapContainerRef: HTMLDivElement;
@@ -755,6 +767,9 @@ declare interface CoreMapEvents extends EventMap {
         source?: string;
     };
     'map:destroy': void;
+    'map:boundsChange': {
+        bounds: [number, number, number, number] | null;
+    };
     'view:change': ViewChangePayload;
     'view:move': ViewChangePayload;
     'view:zoom': {
@@ -6437,6 +6452,8 @@ export declare class MapContext {
     readonly measureOptions?: MeasureManagerOptions;
     /** 是否为移动端模式 */
     readonly isMobile: boolean;
+    /** 全局 sourceBounds */
+    private _sourceBounds;
     private initialViewState;
     private _layerService?;
     private _markerService?;
@@ -6452,6 +6469,7 @@ export declare class MapContext {
     private _drawManager?;
     private _measureManager?;
     private _queryLayerManager?;
+    private _maskManager?;
     constructor(config: MapContextConfig);
     /**
      * 图层服务
@@ -6497,6 +6515,10 @@ export declare class MapContext {
      * 获取查询图层管理器
      */
     get queryLayerManager(): QueryLayerManager | undefined;
+    /**
+     * 获取遮罩管理器
+     */
+    get maskManager(): MaskManager | undefined;
     /**
      * 获取模板管理器
      */
@@ -6586,6 +6608,15 @@ export declare class MapContext {
      * 获取初始视图状态
      */
     getInitialViewState(): ViewState_2 | null;
+    /**
+     * 获取全局 bounds
+     */
+    getSourceBounds(): [number, number, number, number] | null;
+    /**
+     * 设置全局 sourceBounds
+     * @param bounds [minLng, minLat, maxLng, maxLat]
+     */
+    setSourceBounds(bounds: [number, number, number, number] | null): void;
     /**
      * 获取地图是否就绪
      */
@@ -6622,6 +6653,8 @@ export declare interface MapContextConfig {
     measureOptions?: MeasureManagerOptions;
     /** 是否为移动端模式 */
     isMobile?: boolean;
+    /** 全局 sourceBounds [minLng, minLat, maxLng, maxLat] */
+    sourceBounds?: [number, number, number, number] | null;
 }
 
 /** 地图上下文注入键 - 现在注入的是 Ref */
@@ -6647,6 +6680,8 @@ declare interface MapInitOptions {
     accessToken?: string;
     /** 是否为移动端模式 */
     isMobile?: boolean;
+    /** 全局 sourceBounds [minLng, minLat, maxLng, maxLat] */
+    sourceBounds?: [number, number, number, number];
 }
 
 export declare interface MapLoadEvent {
@@ -7185,6 +7220,59 @@ declare interface MarkerState_2 {
     metadata?: Record<string, any>;
 }
 
+declare 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;
+}
+
+/**
+ * 遮罩管理器配置
+ */
+declare interface MaskOptions {
+    /** 遮罩图层ID */
+    layerId?: string;
+    /** 数据源URL或GeoJSON数据 */
+    data: string | any;
+    /** 样式配置 */
+    style?: any;
+    /** 插入到指定图层之前 */
+    beforeId?: string;
+}
+
 /** 测量完成回调 */
 declare type MeasureCallback = (result: MeasureResult) => void;
 
@@ -8410,6 +8498,8 @@ declare interface VectorTileAdapter extends MapAdapter {
     removeSource(id: string): void;
     /** 获取数据源，不存在返回 undefined */
     getSource(id: string): any;
+    /** 获取数据范围限制 [minLng, minLat, maxLng, maxLat] */
+    getSourceBounds(): [number, number, number, number] | undefined;
     /** 添加图层（若已存在则跳过），beforeId 指定插入位置 */
     addLayer(layer: any, beforeId?: string): void;
     /** 移除图层（若不存在则跳过） */