@xingm/vmap-cesium-toolbar 0.0.3-alpha.5 → 0.0.4-alpha.1

package/dist/libs/CesiumMapLoader.d.ts

@@ -8,6 +8,7 @@ interface InitOptions {
     terrain?: Terrain;
     terrainProvider?: TerrainProvider;
     mapType?: string;
+    tdtMapTypeId?: string;
     imageryProvider?: Cesium.UrlTemplateImageryProvider;
     imageryLayers?: Cesium.ImageryLayerCollection;
     terrainShadows?: Cesium.ShadowMode;

package/dist/libs/CesiumMapModel.d.ts

@@ -80,6 +80,12 @@ export interface MapType {
     id: string;
     name: string;
     nameKey?: string;
+    /** 选中态左上角“地名”文案（可选，未配置时走 i18n 默认 key） */
+    placeNameLabel?: string;
+    /** 选中态左上角“地名”文案 i18n key（可选） */
+    placeNameLabelKey?: string;
+    /** 是否强制始终显示地名层（不受 placeName 开关影响） */
+    forcePlaceName?: boolean;
     thumbnail: string;
     provider: (token: string) => Cesium.ImageryProvider[];
     terrainProvider?: (token: string) => Cesium.TerrainProvider | null;

package/dist/libs/CesiumOverlayService.d.ts

@@ -23,6 +23,12 @@ export interface CesiumOverlayServiceOptions {
      * 参数为“已回写后的覆盖物 entity”。
      */
     onOverlayEditChange?: (entity: DrawEntity & OverlayEntity) => void;
+    /**
+     * 点击 pick 节流间隔（毫秒）。
+     * 用于降低 “贴地几何 + pick + ground pipeline” 的偶发 DataCloneError 风险。
+     * @default 120
+     */
+    clickPickMinIntervalMs?: number;
 }
 /**
  * Cesium 覆盖物服务类
@@ -45,9 +51,12 @@ export declare class CesiumOverlayService {
     private lastHoverPickTime;
     private lastHoverPickPos;
     private bulkUpdateDepth;
+    private lastClickPickTime;
+    private readonly clickPickMinIntervalMs;
     private static readonly HOVER_PICK_MIN_INTERVAL_MS;
     private static readonly HOVER_PICK_MIN_MOVE_PX;
     private static readonly HOVER_SUSPEND_AFTER_MUTATION_MS;
+    private static readonly CLICK_PICK_MIN_INTERVAL_MS;
     private markOverlayMutated;
     /**
      * 显式开始一次批量更新：在 begin/end 期间暂停 hover pick。

package/dist/libs/CesiumPointClusterLayer.d.ts

@@ -66,6 +66,7 @@ export interface PointClusterLayerOptions {
 }
 export default class CesiumPointClusterLayer {
     private static readonly CLUSTER_STYLE_MIN_INTERVAL_MS;
+    private static readonly CLICK_PICK_MIN_INTERVAL_MS;
     private viewer;
     private readonly options;
     private dataSource;
@@ -76,6 +77,7 @@ export default class CesiumPointClusterLayer {
     private clusterStyleRAF;
     private clusterStyleTimer;
     private lastClusterStyleFlushTime;
+    private lastClickPickTime;
     constructor(viewer: Viewer, options?: PointClusterLayerOptions);
     /** 设置/替换点数据（经纬度单位：度） */
     setData(points: ClusterPoint[]): void;

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

@@ -32,6 +32,9 @@ declare const enUS: {
         overlay: {
             airport: string;
         };
+        map_type: {
+            place_name: string;
+        };
     };
     map_type: {
         normal: string;

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

@@ -32,6 +32,9 @@ declare const zhCN: {
         overlay: {
             airport: string;
         };
+        map_type: {
+            place_name: string;
+        };
     };
     map_type: {
         normal: string;

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

@@ -29,6 +29,8 @@ export interface CircleOptions {
      * - false：填充与边框都使用 position 高度悬空。
      */
     clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
     heightReference?: HeightReference;
     extrudedHeight?: number;
     heightEpsilon?: number;

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

@@ -23,6 +23,8 @@ export interface PolygonOptions {
      * - false：填充与边框都在统一的 baseHeight 上悬空。
      */
     clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
     heightReference?: HeightReference;
     extrudedHeight?: number;
     /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */

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

@@ -9,6 +9,8 @@ export interface PolylineOptions {
     width?: number;
     material?: Cesium.MaterialProperty | Color | string;
     clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
     /** 点击该覆盖物时是否高亮显示（默认 false）。支持传入自定义颜色等参数 */
     clickHighlight?: boolean | {
         color?: Color | string;
@@ -41,6 +43,7 @@ export declare class MapPolyline {
      * 解析材质
      */
     private resolveMaterial;
+    private elevatePositions;
     /**
      * 添加 Polyline（折线）
      */

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

@@ -19,6 +19,8 @@ export interface RectangleOptions {
     outlineWidth?: number;
     /** 是否贴地（默认：在粗边框模式下为 true） */
     clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
     /** 悬空时的基准高度（米，clampToGround=false 时有效） */
     height?: number;
     heightReference?: HeightReference;

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

@@ -36,6 +36,8 @@ export interface RingOptions {
     glowPower?: number;
     /** 是否贴地（默认 true） */
     clampToGround?: boolean;
+    /** 贴地抬高量（米，clampToGround=true 时生效） */
+    groundHeightEpsilon?: number;
     /** 圆环分段数（默认 128），越大越圆滑 */
     segments?: number;
     /** 覆盖物点击回调 */
@@ -93,7 +95,7 @@ export declare class MapRing {
     /**
      * 更新 Ring 样式
      */
-    updateStyle(entity: Entity, options: Partial<Pick<RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments">>): void;
+    updateStyle(entity: Entity, options: Partial<Pick<RingOptions, "color" | "showInnerLine" | "lineColor" | "lineStyle" | "lineMaterialMode" | "stripeRepeat" | "dashLength" | "dashPattern" | "gapColor" | "width" | "glowWidth" | "lineWidth" | "glowPower" | "clampToGround" | "segments" | "groundHeightEpsilon">>): void;
     /**
      * 显示/隐藏 Ring
      */

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

@@ -87,6 +87,8 @@ export interface OverlayEntity extends Entity {
     _clampToGround?: boolean;
     /** 复合形状的基准高度（米，clampToGround=false 时有效） */
     _baseHeight?: number;
+    /** 贴地抬高量（米，clampToGround=true 时有效） */
+    _groundHeightEpsilon?: number;
     _isThickOutline?: boolean;
     _outlineWidth?: number;
     _isRing?: boolean;

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

@@ -13,21 +13,31 @@ export interface MapLayersServiceConfig {
     i18n?: I18nLike;
     useI18n?: boolean;
     onMapTypeChange?: (mapTypeId: string) => void;
-    onNoFlyZoneToggle?: (isChecked: boolean) => void;
     onShowNoFlyZones?: () => Promise<void> | void;
+    onNoFlyZoneToggle?: (isChecked: boolean) => void;
 }
 /**
  * 图层服务类
  * 负责处理地图图层切换相关的所有逻辑
  */
 export declare class MapLayersService {
+    private static readonly PLACE_NAME_LAYER_TAG;
     private viewer;
     private toolbarElement;
     private config;
     private currentGeoWTFS;
+    private currentMapTypeConfig;
+    private currentMapLayers;
+    private currentPlaceNameProvider;
+    private currentPlaceNameLayer;
+    private isPlaceNameChecked;
     private i18n;
     private useI18n;
     constructor(viewer: Viewer, toolbarElement: HTMLElement, config: MapLayersServiceConfig);
+    /**
+     * 初始化当前地图上下文：用于“初始底图不是通过 switchMapType 加载”时的地名层识别。
+     */
+    private bootstrapCurrentMapContext;
     /**
      * 更新配置
      */
@@ -61,6 +71,13 @@ export declare class MapLayersService {
      * 获取当前地图类型
      */
     getCurrentMapType(): string;
+    private setPlaceNameChecked;
+    private shouldEnablePlaceName;
+    private isSameProvider;
+    private resolveExistingPlaceNameLayer;
+    private ensurePlaceNameProvider;
+    private addPlaceNameLayer;
+    private removePlaceNameLayer;
     /**
      * 关闭图层菜单
      */

package/package.json

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