@xingm/vmap-cesium-toolbar 0.0.2-alpha.15 → 0.0.2-alpha.17

package/dist/libs/CesiumHeatmapLayer.d.ts

@@ -20,6 +20,10 @@ export interface HeatmapOptions {
     height?: number;
     /** 单个点的影响半径（像素） */
     radius?: number;
+    /** 低强度提升（伽马矫正），< 1 可增强边缘，默认 0.7 */
+    gamma?: number;
+    /** 最小可见 alpha（0~1），用于避免外圈完全消失，默认 0.03 */
+    minAlpha?: number;
     /** 最小/最大值，用于归一化 value，如果不传则自动根据数据计算 */
     minValue?: number;
     maxValue?: number;
@@ -47,6 +51,7 @@ export default class CesiumHeatmapLayer {
     private viewer;
     private imageryLayer;
     private rectangle;
+    private fullDataRectangle;
     private canvas;
     private ctx;
     private options;

package/dist/libs/CesiumMapLoader.d.ts

@@ -44,6 +44,7 @@ interface InitOptions {
     maximumScreenSpaceError?: number;
     maximumNumberOfLoadedTiles?: number;
     requestRenderMode?: boolean;
+    maximumRenderTimeChange?: number;
     token?: string;
     cesiumToken?: string;
     success?: () => void;

package/dist/libs/CesiumMapModel.d.ts

@@ -1,4 +1,5 @@
 import { Cartesian3, Cartographic, Color } from '../../node_modules/cesium';
+import { I18nLike } from '../libs/i18n';
 import * as Cesium from 'cesium';
 export interface ToolbarConfig {
     position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
@@ -11,12 +12,15 @@ export interface ToolbarConfig {
     boxShadow?: string;
     zIndex?: number;
     buttons?: CustomButtonConfig[];
+    useI18n?: boolean;
+    i18n?: I18nLike;
 }
 export interface ButtonConfig {
     sort?: number;
     id: string;
     icon: string;
     title: string;
+    titleKey?: string;
     size?: number;
     color?: string;
     borderColor?: string;
@@ -32,6 +36,7 @@ export interface CustomButtonConfig {
     id: string;
     icon: string | HTMLElement | false;
     title: string;
+    titleKey?: string;
     enabled?: boolean;
     visible?: boolean;
     size?: number;
@@ -74,6 +79,7 @@ export interface ZoomCallback {
 export interface MapType {
     id: string;
     name: string;
+    nameKey?: string;
     thumbnail: string;
     provider: (token: string) => Cesium.ImageryProvider[];
     terrainProvider?: (token: string) => Cesium.TerrainProvider | null;

package/dist/libs/CesiumMapToolbar.d.ts

@@ -1,4 +1,9 @@
 import { Viewer } from '../../node_modules/cesium';
+import { CesiumMapController } from './toolBar/CesiumMapController';
+import { MeasurementService } from './toolBar/MeasurementService';
+import { SearchService } from './toolBar/MapSearchService';
+import { MapLayersService } from './toolBar/MapLayersService';
+import { NotFlyZonesService } from './toolBar/NotFlyZonesService';
 import { MapType, ToolbarConfig, SearchCallback, MeasurementCallback, ZoomCallback, CustomButtonConfig } from './CesiumMapModel';
 /**
  * Cesium地图工具栏类
@@ -15,6 +20,8 @@ export declare class CesiumMapToolbar {
     private notFlyZonesService;
     private measurementCallback?;
     private zoomCallback?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
     private initialCenter?;
     private currentMapType;
     TD_Token: string;
@@ -22,6 +29,9 @@ export declare class CesiumMapToolbar {
     private isNoFlyZoneChecked;
     private currentGeoWTFS;
     private measurementService;
+    private unsubscribeI18n?;
+    private i18n;
+    private useI18n;
     readonly measurement: {
         getMeasureMode: () => "none" | "distance" | "area";
     };
@@ -30,12 +40,42 @@ export declare class CesiumMapToolbar {
         search?: SearchCallback;
         measurement?: MeasurementCallback;
         zoom?: ZoomCallback;
+        fullscreen?: (isFullscreen: boolean) => void;
+        resetLocation?: () => void;
     }, initialCenter?: {
         longitude: number;
         latitude: number;
         height: number;
     });
+    /**
+     * searchService 对外暴露的获取搜索服务方法
+     */
+    getSearchService(): SearchService;
+    /**
+     * notFlyZonesService 对外暴露的获取禁飞区服务方法
+     */
+    getNotFlyZonesService(): NotFlyZonesService;
+    /**
+     * measurementService 对外暴露的获取测量服务方法
+     */
+    getMeasurementService(): MeasurementService;
+    /**
+     * cesmapController 对外暴露的获取地图控制器方法
+     */
+    getCesiumMapCtrl(): CesiumMapController;
+    /**
+     * mapLayersService 对外暴露的获取图层服务方法
+     */
+    getMapLayersService(): MapLayersService;
+    /**
+     * 设置地图类型配置
+     * @param mapTypes
+     */
     setMapTypes(mapTypes: MapType[]): void;
+    /**
+     * 设置天地图密钥
+     * @param TD_Token
+     */
     setTDToken(TD_Token: string): void;
     /**
      * 设置初始中心点
@@ -69,7 +109,13 @@ export declare class CesiumMapToolbar {
     /**
      * 获取所有按钮配置（包括默认按钮和自定义按钮），并添加 sort 值
      */
-    private getAllButtonsWithSort;
+    private resolveIcon;
+    /**
+     * 获取按钮配置（已排序，包含默认按钮兜底）
+     * - 未传 buttons：使用默认按钮
+     * - 传了 buttons：按传入按钮列表渲染，并用默认按钮补齐缺省字段
+     */
+    private getButtonConfigs;
     /**
      * 重新构建工具栏按钮
      */
@@ -86,10 +132,6 @@ export declare class CesiumMapToolbar {
      * 创建工具栏
      */
     private createToolbar;
-    /**
-     * 获取按钮配置（已排序）
-     */
-    private getButtonConfigs;
     /**
      * 创建按钮
      */

package/dist/libs/i18n/en-US.d.ts

@@ -0,0 +1,66 @@
+declare const enUS: {
+    locale: string;
+    toolbar: {
+        search: string;
+        measure: string;
+        view2d3d: string;
+        layers: string;
+        location: string;
+        zoom_in: string;
+        zoom_out: string;
+        fullscreen: string;
+    };
+    measurement: {
+        start: string;
+        distance_done: string;
+        area_done: string;
+        cleared: string;
+        menu: {
+            area: string;
+            distance: string;
+            clear: string;
+        };
+    };
+    search: {
+        placeholder: string;
+        failed: string;
+        no_results: string;
+    };
+    layers: {
+        title: string;
+        overlay_title: string;
+        overlay: {
+            airport: string;
+        };
+    };
+    map_type: {
+        normal: string;
+        "3d": string;
+        imagery: string;
+        terrain: string;
+    };
+    no_fly: {
+        description: string;
+    };
+    draw: {
+        hint: {
+            circle_start: string;
+            circle_radius: string;
+            rectangle_start: string;
+            rectangle_end: string;
+            finish_or_undo: string;
+            polygon_start: string;
+            polygon_add: string;
+            polygon_continue: string;
+            line_start: string;
+            line_add: string;
+            line_continue: string;
+            polygon_no_intersection: string;
+        };
+        label: {
+            total_length: string;
+            area: string;
+        };
+    };
+};
+export default enUS;

package/dist/libs/i18n/index.d.ts

@@ -0,0 +1,24 @@
+type Locale = "zh-CN" | "en-US" | (string & {});
+type I18nDict = Record<string, any>;
+interface I18nLike {
+    getLocale(): Locale;
+    setLocale(locale: Locale, options?: {
+        persist?: boolean;
+    }): void;
+    t(key: string, params?: Record<string, any>, localeOverride?: Locale): string;
+    onLocaleChange(cb: (locale: Locale) => void): () => void;
+    bindElement(el: HTMLElement, key: string, attr?: "text" | "title" | "placeholder", params?: Record<string, any>): void;
+    updateTree(root: HTMLElement): void;
+    addMessages?(locale: Locale, dict: I18nDict, options?: {
+        merge?: boolean;
+    }): void;
+    setFallbackLocale?(locale: Locale): void;
+    configure?(options: {
+        persist?: boolean;
+        useStoredLocale?: boolean;
+        fallbackLocale?: Locale;
+        locale?: Locale;
+    }): void;
+}
+export declare const i18n: I18nLike;
+export type { Locale, I18nLike };

package/dist/libs/i18n/zh-CN.d.ts

@@ -0,0 +1,66 @@
+declare const zhCN: {
+    locale: string;
+    toolbar: {
+        search: string;
+        measure: string;
+        view2d3d: string;
+        layers: string;
+        location: string;
+        zoom_in: string;
+        zoom_out: string;
+        fullscreen: string;
+    };
+    measurement: {
+        start: string;
+        distance_done: string;
+        area_done: string;
+        cleared: string;
+        menu: {
+            area: string;
+            distance: string;
+            clear: string;
+        };
+    };
+    search: {
+        placeholder: string;
+        failed: string;
+        no_results: string;
+    };
+    layers: {
+        title: string;
+        overlay_title: string;
+        overlay: {
+            airport: string;
+        };
+    };
+    map_type: {
+        normal: string;
+        "3d": string;
+        imagery: string;
+        terrain: string;
+    };
+    no_fly: {
+        description: string;
+    };
+    draw: {
+        hint: {
+            circle_start: string;
+            circle_radius: string;
+            rectangle_start: string;
+            rectangle_end: string;
+            finish_or_undo: string;
+            polygon_start: string;
+            polygon_add: string;
+            polygon_continue: string;
+            line_start: string;
+            line_add: string;
+            line_continue: string;
+            polygon_no_intersection: string;
+        };
+        label: {
+            total_length: string;
+            area: string;
+        };
+    };
+};
+export default zhCN;

package/dist/libs/overlay/MapCircle.d.ts

@@ -43,6 +43,13 @@ export interface CircleOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 circle 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -52,9 +59,13 @@ export declare class MapCircle {
     private viewer;
     private entities;
     private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
     private static bearingTableCache;
     constructor(viewer: Viewer);
     private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
     private resolveMaterialColor;
     private canUsePrimitive;
     private addPrimitiveCircle;

package/dist/libs/overlay/MapPolygon.d.ts

@@ -36,6 +36,13 @@ export interface PolygonOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 polygon 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -45,8 +52,12 @@ export declare class MapPolygon {
     private viewer;
     private entities;
     private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
     constructor(viewer: Viewer);
     private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
     private resolveMaterialColor;
     private canUsePrimitive;
     private addPrimitivePolygon;

package/dist/libs/overlay/MapRectangle.d.ts

@@ -36,6 +36,13 @@ export interface RectangleOptions {
         fillAlpha?: number;
     };
     onClick?: (entity: Entity) => void;
+    /**
+     * Primitive 模式分层渲染 key。
+     * - 相同 layerKey 的 rectangle 会被合并到同一个批次中（更高性能）
+     * - 不同 layerKey 会进入不同的“图层空间”，并按首次出现顺序确定上下层
+     * - 只对 primitive 生效；entity 模式忽略
+     */
+    layerKey?: string;
     id?: string;
 }
 /**
@@ -45,8 +52,12 @@ export declare class MapRectangle {
     private viewer;
     private entities;
     private primitiveBatch;
+    private primitiveLayerStack;
+    private primitiveBatchesByLayer;
     constructor(viewer: Viewer);
     private getPrimitiveBatch;
+    private getLayeredPrimitiveBatch;
+    private getPrimitiveBatchForOverlay;
     private resolveMaterialColor;
     private canUsePrimitive;
     private addPrimitiveRectangle;

package/dist/libs/overlay/primitives/CirclePrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface CirclePrimitiveParts {
 }
 export declare class CirclePrimitiveBatch {
     private viewer;
-    private collection;
+    private ringCollection;
+    private fillCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private ringPrimitive;
     private fillPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        ringCollection?: Cesium.PrimitiveCollection;
+        fillCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     has(circleId: string): boolean;
     upsertGeometry(args: {

package/dist/libs/overlay/primitives/CirclePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface CirclePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * Maintains a stable, ordered layer stack for Circle primitive rendering.
+ *
+ * Rendering order:
+ * - all fill layers (bottom -> top)
+ * - all ring layers (bottom -> top)
+ *
+ * This ensures boundaries (rings) remain visible even when multiple translucent fills overlap.
+ */
+export declare class CirclePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): CirclePrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/PolygonPrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface PolygonPrimitiveParts {
 }
 export declare class PolygonPrimitiveBatch {
     private viewer;
-    private collection;
+    private fillCollection;
+    private borderCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private fillPrimitive;
     private borderPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        fillCollection?: Cesium.PrimitiveCollection;
+        borderCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     upsertGeometry(args: {
         polygonId: string;

package/dist/libs/overlay/primitives/PolygonPrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface PolygonPrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    borderCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * Maintains a stable, ordered layer stack for Polygon primitive rendering.
+ *
+ * Rendering order:
+ * - all fill layers (bottom -> top)
+ * - all border layers (bottom -> top)
+ *
+ * This ensures borders remain visible even when multiple translucent fills overlap.
+ */
+export declare class PolygonPrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private bordersRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): PolygonPrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/primitives/RectanglePrimitiveBatch.d.ts

@@ -6,14 +6,20 @@ export interface RectanglePrimitiveParts {
 }
 export declare class RectanglePrimitiveBatch {
     private viewer;
-    private collection;
+    private ringCollection;
+    private fillCollection;
+    private ownsCollections;
+    private ownedRootCollection;
     private ringPrimitive;
     private fillPrimitive;
     private records;
     private rebuildScheduled;
     private colorApplyScheduled;
     private pendingColorApplyIds;
-    constructor(viewer: Viewer);
+    constructor(viewer: Viewer, options?: {
+        ringCollection?: Cesium.PrimitiveCollection;
+        fillCollection?: Cesium.PrimitiveCollection;
+    });
     destroy(): void;
     upsertGeometry(args: {
         rectangleId: string;

package/dist/libs/overlay/primitives/RectanglePrimitiveLayerStack.d.ts

@@ -0,0 +1,24 @@
+import { Viewer } from '../../../../node_modules/cesium';
+import * as Cesium from 'cesium';
+export interface RectanglePrimitiveLayerCollections {
+    fillCollection: Cesium.PrimitiveCollection;
+    ringCollection: Cesium.PrimitiveCollection;
+}
+/**
+ * 为矩形 Primitive 渲染维护一个稳定的有序图层栈。
+ *
+ * 渲染顺序：
+ * - 所有填充图层（从下到上）
+ * - 所有描边图层（从下到上）
+ *
+ * 这样可以确保在存在多个半透明填充重叠时，描边仍然清晰可见。
+ */
+export declare class RectanglePrimitiveLayerStack {
+    private viewer;
+    private fillsRoot;
+    private ringsRoot;
+    private layers;
+    constructor(viewer: Viewer);
+    getLayerCollections(layerKey: string): RectanglePrimitiveLayerCollections;
+    destroy(): void;
+}

package/dist/libs/overlay/types.d.ts

@@ -106,6 +106,8 @@ export interface OverlayEntity extends Entity {
     _innerRadius?: number;
     _outerRectangle?: Rectangle;
     /** primitive circle: 内部使用的纯色缓存（用于高亮恢复） */
+    /** primitive layer key: 用于分层批处理路由 */
+    _primitiveLayerKey?: string;
     _primitiveRingBaseColor?: Color;
     _primitiveFillBaseColor?: Color;
     /** primitive polygon/rectangle: 边框纯色缓存（用于高亮恢复） */

package/dist/libs/toolBar/CesiumMapController.d.ts

@@ -17,6 +17,10 @@ interface CesiumMapControllerOptions {
     zoomCallback?: ZoomCallback;
     /** 场景模式切换后回调（例如通知 DrawHelper 重新计算偏移） */
     onSceneModeChanged?: () => void;
+    /** 全屏切换回调 */
+    fullscreenCallback?: (isFullscreen: boolean) => void;
+    /** 复位位置回调 */
+    resetLocationCallback?: () => void;
 }
 /**
  * 负责地图相机控制、缩放层级和 2D/3D 切换等逻辑的控制器
@@ -30,6 +34,8 @@ export declare class CesiumMapController {
     private getToken?;
     private zoomCallback?;
     private onSceneModeChanged?;
+    private fullscreenCallback?;
+    private resetLocationCallback?;
     constructor(viewer: Viewer, options?: CesiumMapControllerOptions);
     /**
      * 监听相机缩放，限制层级范围到 [1, 18]，并参考当前底图的 maximumLevel

package/dist/libs/toolBar/MapLayersService.d.ts

@@ -1,5 +1,6 @@
 import { Viewer } from '../../../node_modules/cesium';
 import { MapType } from '../CesiumMapModel';
+import { I18nLike } from '../../libs/i18n';
 /**
  * 图层服务配置接口
  */
@@ -9,6 +10,8 @@ export interface MapLayersServiceConfig {
     token: string;
     isNoFlyZoneChecked: boolean;
     isNoFlyZoneVisible: boolean;
+    i18n?: I18nLike;
+    useI18n?: boolean;
     onMapTypeChange?: (mapTypeId: string) => void;
     onNoFlyZoneToggle?: (isChecked: boolean) => void;
     onShowNoFlyZones?: () => Promise<void> | void;
@@ -22,6 +25,8 @@ export declare class MapLayersService {
     private toolbarElement;
     private config;
     private currentGeoWTFS;
+    private i18n;
+    private useI18n;
     constructor(viewer: Viewer, toolbarElement: HTMLElement, config: MapLayersServiceConfig);
     /**
      * 更新配置

package/dist/libs/toolBar/MapSearchService.d.ts

@@ -1,5 +1,6 @@
 import { Viewer } from '../../../node_modules/cesium';
 import { SearchResult, SearchCallback } from '../CesiumMapModel';
+import { I18nLike } from '../../libs/i18n';
 /**
  * 搜索服务类
  * 负责处理地图搜索相关的所有逻辑
@@ -9,7 +10,12 @@ export declare class SearchService {
     private toolbarElement;
     private searchCallback?;
     private searchContainer;
-    constructor(viewer: Viewer, toolbarElement: HTMLElement, searchCallback?: SearchCallback);
+    private i18n;
+    private useI18n;
+    constructor(viewer: Viewer, toolbarElement: HTMLElement, searchCallback?: SearchCallback, options?: {
+        i18n?: I18nLike;
+        useI18n?: boolean;
+    });
     /**
      * 设置搜索回调
      */

package/dist/libs/toolBar/NotFlyZonesService.d.ts

@@ -1,10 +1,13 @@
 import { Viewer } from '../../../node_modules/cesium';
+import { I18nLike } from '../../libs/i18n';
 /**
  * 禁飞区服务配置接口
  */
 export interface NotFlyZonesServiceConfig {
     extrudedHeight?: number;
     autoLoad?: boolean;
+    i18n?: I18nLike;
+    useI18n?: boolean;
 }
 /**
  * 禁飞区服务类
@@ -16,6 +19,8 @@ export declare class NotFlyZonesService {
     private isNoFlyZoneVisible;
     private isNoFlyZoneLoading;
     private readonly extrudedHeight;
+    private i18n;
+    private useI18n;
     constructor(viewer: Viewer, config?: NotFlyZonesServiceConfig);
     /**
      * 加载并显示机场禁飞区

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xingm/vmap-cesium-toolbar",
-  "version": "0.0.2-alpha.15",
+  "version": "0.0.2-alpha.17",
   "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
   "type": "module",
   "main": "index.js",