@xingm/vmap-cesium-toolbar 0.0.3-alpha.2 → 0.0.3-alpha.4

package/dist/libs/CesiumMapDraw.d.ts

@@ -73,6 +73,11 @@ declare class DrawHelper {
      * @param viewer Cesium Viewer 实例
      */
     constructor(viewer: Cesium.Viewer);
+    /**
+     * 检测并输出可能存在高度限制问题的实体信息
+     * @param tag 标识本次检测的唯一标签
+     * @returns 返回包含检测结果的报告对象
+     */
     private dumpPotentialClampingEntities;
     /**
      * 对新创建的实体进行净化处理，确保其符合渲染要求
@@ -85,6 +90,11 @@ declare class DrawHelper {
      * 这是一个私有方法，主要用于拦截和修改Cesium中EntityCollection的add方法
      */
     private installEntitiesAddHook;
+    /**
+     * 卸载实体集合添加钩子函数
+     * 该方法用于移除之前添加到EntityCollection原型中的自定义add方法
+     * 恢复原始的add方法实现
+     */
     private uninstallEntitiesAddHook;
     /**
      * 安装地面几何更新器调试钩子

package/dist/libs/CesiumOverlayService.d.ts

@@ -36,6 +36,7 @@ export declare class CesiumOverlayService {
     /** 构造参数（用于开关 hover handler 等运行时策略） */
     private readonly options;
     private overlayEditor;
+    private overlayHighlight;
     private lastHoverTargets;
     private hoverPickRAF;
     private hoverPickPos;
@@ -44,10 +45,6 @@ export declare class CesiumOverlayService {
     private lastHoverPickTime;
     private lastHoverPickPos;
     private bulkUpdateDepth;
-    private static readonly DEFAULT_HIGHLIGHT_COLOR;
-    private static readonly DEFAULT_HIGHLIGHT_FILL_ALPHA;
-    private static readonly DEFAULT_HIGHLIGHT_GLOW_POWER;
-    private static readonly GLOW_OUTLINE_ROOT_ID_PROP;
     private static readonly HOVER_PICK_MIN_INTERVAL_MS;
     private static readonly HOVER_PICK_MIN_MOVE_PX;
     private static readonly HOVER_SUSPEND_AFTER_MUTATION_MS;
@@ -70,17 +67,6 @@ export declare class CesiumOverlayService {
      * 需要映射回 overlayMap 内的根覆盖物 id。
      */
     private normalizeOverlayPickId;
-    private getEntityPropertyString;
-    private mapGlowOutlineEntityToRoot;
-    private getClosedPositions;
-    private generateEllipseOutlinePositions;
-    /**
-     * 确保发光轮廓效果
-     * @param root - 根覆盖物实体
-     * @param color - 发光颜色
-     */
-    private ensureGlowOutline;
-    private removeGlowOutline;
     private resolveOverlayByPickId;
     private resolvePickedOverlayEntity;
     readonly marker: MapMarker;
@@ -122,6 +108,12 @@ export declare class CesiumOverlayService {
      * 设置实体点击处理器
      */
     private setupEntityClickHandler;
+    /**
+     * 开启或是关闭覆盖物的Hover高亮（鼠标移入高亮，移出取消）。
+     * - 开启后：覆盖物会触发高亮，且高亮状态会在鼠标移出时取消。
+     * - 关闭后：覆盖物不再触发 hover 高亮。
+     */
+    toggleOverlayHoverHighlight(enabled: boolean): void;
     /**
      * 开启/关闭覆盖物编辑模式。
      * - 开启后：点击覆盖物会进入编辑，并显示可拖拽控制点。
@@ -143,16 +135,6 @@ export declare class CesiumOverlayService {
     private setupEntityHoverHandler;
     private getPropertyValue;
     private getNumberProperty;
-    private resolveHighlightOptions;
-    private getActiveHighlightOptions;
-    private setOverlayHighlightReason;
-    private applyOverlayHighlightStyle;
-    /**
-     * 恢复覆盖物的高亮样式
-     * @param entity - 覆盖物实体对象
-     * @returns 无返回值
-     */
-    private restoreOverlayHighlightStyle;
     /**
      * 生成唯一ID
      */

package/dist/libs/drawHelper/DrawCircle.d.ts

@@ -11,6 +11,7 @@ export declare class DrawCircle extends BaseDraw {
      * 开始绘制
      */
     startDrawing(options?: DrawOptions): void;
+    addPoint(position: Cartesian3): void;
     /**
      * 更新绘制实体（预览）
      */

package/dist/libs/drawHelper/DrawHint.d.ts

@@ -17,16 +17,16 @@ export declare class DrawHintHelper {
     private drawHintOverrideUntil;
     constructor(entities: Cesium.EntityCollection, getState: () => DrawHintState, translate: (key: string, params?: Record<string, any>) => string);
     handleSceneModeChanged(): void;
-    setOverride(text: string, ms?: number): void;
+    setOverride(options: Cesium.LabelGraphics | Cesium.LabelGraphics.ConstructorOptions, ms?: number): void;
     updatePosition(position: Cesium.Cartesian3): void;
     refreshTextOnly(): void;
     clear(): void;
     /**
-     * 获取绘图提示文本的私有方法
+     * 获取绘图提示文本的公共方法
      * 根据当前的绘图状态和模式返回相应的提示信息
      * @returns {string} 返回对应的提示文本，如果不在绘图状态则返回空字符串
      */
-    private getDrawHintText;
+    getDrawHintText(): string;
     private toHintDisplayPosition;
 }
 export {};

package/dist/libs/{overlay → overlay-edit}/OverlayEditController.d.ts

@@ -1,6 +1,6 @@
 import { Viewer } from '../../../node_modules/cesium';
 import { DrawEntity } from '../drawHelper';
-import { OverlayEntity } from './types';
+import { OverlayEntity } from '../overlay/types';
 import * as Cesium from "cesium";
 export type OverlayEditChangeCallback = (entity: DrawEntity & OverlayEntity) => void;
 export interface OverlayEditControllerOptions {
@@ -62,6 +62,7 @@ export declare class OverlayEditController {
      * @returns true 表示成功进入编辑
      */
     start(entityOrId: (DrawEntity & OverlayEntity) | string): boolean;
+    private resolveEditTarget;
     private detectEditableKind;
     private getPropertyValue;
     private getNumberProperty;
@@ -72,21 +73,22 @@ export declare class OverlayEditController {
     private getEditablePointPosition;
     private getEditableRectangle;
     private getEditableCircleInfo;
-    /**
-     * 确保编辑处理器已初始化
-     * 如果处理器不存在，则创建一个新的 ScreenSpaceEventHandler 并设置各种交互事件处理函数
-     * @private
-     */
-    /**
-     * 确保事件处理器已初始化
-     * 如果处理器不存在，则创建并设置各种事件处理函数
-     * @private
-     */
     /**
      * 确保屏幕空间事件处理器已初始化
      * 如果处理器不存在，则创建一个新的处理器并设置各种交互事件
      */
     private ensureHandler;
+    private beginDrag;
+    private beginMoveDrag;
+    private computeMovedPositions;
+    private emitChange;
+    private prepareOnChangeTarget;
+    private resolveOverlayTypeFromId;
+    private attachMarkerLngLat;
+    private attachPolylineLngLat;
+    private attachCircleLngLat;
+    private attachPolygonLngLat;
+    private attachRectangleLngLat;
     private captureDragSnapshot;
     private isGeometryChangedSinceSnapshot;
     private destroyHandler;
@@ -94,17 +96,8 @@ export declare class OverlayEditController {
     private restoreCameraController;
     private clearHandles;
     private rebuildHandles;
+    private getHandleHelpers;
     private createHandle;
-    private buildPolygonHandles;
-    private buildRectangleHandles;
-    private buildPolylineHandles;
-    private buildPointHandles;
-    private buildCircleHandles;
-    private updatePolygonHandlePositions;
-    private updateRectangleHandlePositions;
-    private updatePolylineHandlePositions;
-    private updatePointHandlePositions;
-    private updateCircleHandlePositions;
     private applyEditedPolygon;
     private applyEditedRectangle;
     private applyEditedCircle;
@@ -112,10 +105,14 @@ export declare class OverlayEditController {
     private applyEditedPoint;
     private getEditingClampToGround;
     private getCartesianHeight;
+    private convertOutlineToLngLat;
+    private convertPositionToLngLat;
+    private convertCartoToLngLat;
     private pickCartesianOnGlobe;
     private computeSurfaceDistanceMeters;
     private circleRadiusHandlePosition;
     private rectangleToPositions;
+    private rectangleToLngLatPositions;
     private positionsToRectangle;
     private getRectangleEditHeight;
     private computePolygonCenterCartesian;

package/dist/libs/overlay-edit/OverlayEditHandles.d.ts

@@ -0,0 +1,63 @@
+import * as Cesium from "cesium";
+/**
+ * 句柄样式（颜色/描边/像素大小）
+ */
+export type HandleStyle = {
+    color: Cesium.Color;
+    outlineColor: Cesium.Color;
+    pixelSize: number;
+};
+/**
+ * 创建编辑句柄实体
+ */
+export type CreateHandle = (position: Cesium.Cartesian3, style: HandleStyle, meta: any) => Cesium.Entity;
+/**
+ * 构建/更新句柄所需的依赖函数集合
+ */
+export interface HandleHelpers {
+    createHandle: CreateHandle;
+    computePolygonCenterCartesian: (positions: Cesium.Cartesian3[]) => Cesium.Cartesian3;
+    computePolylineHandleRadius: (positions: Cesium.Cartesian3[], center: Cesium.Cartesian3) => number;
+    offsetByMeters: (center: Cesium.Cartesian3, meters: number, bearingDeg: number) => Cesium.Cartesian3;
+    circleRadiusHandlePosition: (center: Cesium.Cartesian3, radiusMeters: number) => Cesium.Cartesian3;
+}
+/**
+ * 构建多边形编辑句柄（顶点/中点/整体移动）
+ */
+export declare function buildPolygonHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+/**
+ * 构建矩形编辑句柄（顶点/边中点/整体移动）
+ */
+export declare function buildRectangleHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+/**
+ * 构建折线编辑句柄（顶点/中点/整体移动/旋转/缩放）
+ */
+export declare function buildPolylineHandles(verts: Cesium.Cartesian3[], helpers: HandleHelpers): Cesium.Entity[];
+/**
+ * 构建点编辑句柄
+ */
+export declare function buildPointHandles(pos: Cesium.Cartesian3 | null, helpers: HandleHelpers): Cesium.Entity[];
+/**
+ * 构建圆形编辑句柄（圆心/半径）
+ */
+export declare function buildCircleHandles(center: Cesium.Cartesian3 | null, radiusMeters: number, helpers: HandleHelpers): Cesium.Entity[];
+/**
+ * 更新多边形句柄位置
+ * @returns false 表示句柄数量不匹配，需重建
+ */
+export declare function updatePolygonHandlePositions(verts: Cesium.Cartesian3[], handles: Cesium.Entity[], helpers: HandleHelpers): boolean;
+/**
+ * 更新折线句柄位置
+ * @returns false 表示句柄数量不匹配，需重建
+ */
+export declare function updatePolylineHandlePositions(verts: Cesium.Cartesian3[], handles: Cesium.Entity[], helpers: HandleHelpers): boolean;
+/**
+ * 更新点句柄位置
+ * @returns false 表示句柄数量不匹配或参数为空
+ */
+export declare function updatePointHandlePositions(pos: Cesium.Cartesian3 | null, handles: Cesium.Entity[]): boolean;
+/**
+ * 更新圆形句柄位置
+ * @returns false 表示句柄数量不匹配或参数为空
+ */
+export declare function updateCircleHandlePositions(center: Cesium.Cartesian3 | null, radiusMeters: number, handles: Cesium.Entity[], helpers: HandleHelpers): boolean;

package/dist/libs/overlay-edit/OverlayHighlight.d.ts

@@ -0,0 +1,40 @@
+import { Entity } from '../../../node_modules/cesium';
+import { DrawEntity } from '../drawHelper';
+import { OverlayEntity } from '../overlay/types';
+import { MapCircle } from '../overlay/MapCircle';
+import { MapPolygon } from '../overlay/MapPolygon';
+import { MapRectangle } from '../overlay/MapRectangle';
+import * as Cesium from "cesium";
+export interface OverlayHighlightHost {
+    getEntities(): Cesium.EntityCollection;
+    getOverlayById(id: string): (DrawEntity & OverlayEntity) | undefined;
+    getPropertyValue<T>(prop: any, fallback: T): T;
+    getNumberProperty(prop: any, fallback: number): number;
+    getCircle(): MapCircle;
+    getPolygon(): MapPolygon;
+    getRectangle(): MapRectangle;
+}
+export declare class OverlayHighlight {
+    private readonly host;
+    private static readonly DEFAULT_HIGHLIGHT_COLOR;
+    private static readonly DEFAULT_HIGHLIGHT_FILL_ALPHA;
+    private static readonly DEFAULT_HIGHLIGHT_GLOW_POWER;
+    private static readonly GLOW_OUTLINE_ROOT_ID_PROP;
+    private readonly entities;
+    constructor(host: OverlayHighlightHost);
+    mapGlowOutlineEntityToRoot(entity: Cesium.Entity): (DrawEntity & OverlayEntity) | null;
+    setOverlayHighlightReason(targets: Entity[], reason: "click" | "hover", enabled: boolean): void;
+    toggleOverlayHighlight(entity: OverlayEntity, reason?: "click" | "hover"): void;
+    setOverlayHighlight(entityOrId: OverlayEntity | string, enabled: boolean, reason?: "click" | "hover"): boolean;
+    private getEntityPropertyString;
+    private getPropertyValue;
+    private getNumberProperty;
+    private resolveHighlightOptions;
+    private getActiveHighlightOptions;
+    private getClosedPositions;
+    private generateEllipseOutlinePositions;
+    private ensureGlowOutline;
+    private removeGlowOutline;
+    private applyOverlayHighlightStyle;
+    private restoreOverlayHighlightStyle;
+}

package/dist/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@xingm/vmap-cesium-toolbar",
+  "version": "0.0.3-alpha.4",
+  "description": "A powerful Cesium map toolbar plugin with drawing, measurement, and interaction features",
+  "type": "module",
+  "main": "index.es.js",
+  "module": "index.es.js",
+  "types": "index.d.ts",
+  "files": [
+    "index.es.js",
+    "index.umd.js",
+    "index.d.ts",
+    "style.css",
+    "README.md",
+    "geojson"
+  ],
+  "exports": {
+    ".": {
+      "import": "./index.es.js",
+      "default": "./index.es.js"
+    },
+    "./style": "./style.css"
+  },
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "keywords": [
+    "cesium",
+    "map",
+    "toolbar",
+    "drawing",
+    "measurement",
+    "vue3",
+    "typescript"
+  ],
+  "author": "pengxueyou",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BenXueYou/vmap-cesium-tool.git"
+  },
+  "bugs": {
+    "url": "https://github.com/BenXueYou/vmap-cesium-tool/issues"
+  },
+  "homepage": "https://github.com/BenXueYou/vmap-cesium-tool#readme"
+}

package/dist/style.css

@@ -0,0 +1,162 @@
+/* VMap Cesium Toolbar Plugin Styles */
+
+/* 工具栏基础样式 */
+.cesium-map-toolbar {
+  position: absolute;
+  background: rgba(255, 255, 255, 0.95);
+  border: 1px solid #e0e0e0;
+  border-radius: 6px;
+  box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
+  padding: 8px;
+  z-index: 1000;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+/* 工具栏按钮样式 */
+.cesium-toolbar-button {
+  width: 40px;
+  height: 40px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: rgba(66, 133, 244, 0.4);
+  color: white;
+  border: none;
+  border-radius: 4px;
+  cursor: pointer;
+  font-size: 14px;
+  font-weight: bold;
+  transition: all 0.2s ease;
+  user-select: none;
+  position: relative;
+}
+
+.cesium-toolbar-button:hover {
+  background: rgba(51, 103, 214, 0.9);
+  transform: scale(1.05);
+}
+
+/* 搜索容器样式 */
+.search-container {
+  position: absolute;
+  background: white;
+  border: 1px solid #e0e0e0;
+  border-radius: 4px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  padding: 8px;
+  min-width: 200px;
+  z-index: 1001;
+}
+
+.search-container input {
+  padding: 6px 8px;
+  border: 1px solid #ddd;
+  border-radius: 3px;
+  font-size: 14px;
+  outline: none;
+  width: 100%;
+  box-sizing: border-box;
+}
+
+.search-results {
+  margin-top: 8px;
+  max-height: 200px;
+  overflow-y: auto;
+}
+
+.search-results > div {
+  padding: 8px;
+  border-bottom: 1px solid #f0f0f0;
+  cursor: pointer;
+  transition: background-color 0.2s;
+}
+
+.search-results > div:hover {
+  background-color: #f5f5f5;
+}
+
+/* 测量菜单样式 */
+.measurement-menu,
+.layers-menu {
+  position: absolute;
+  background: white;
+  border: 1px solid #e0e0e0;
+  border-radius: 4px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
+  padding: 4px 0;
+  min-width: 120px;
+  z-index: 1001;
+}
+
+.layers-menu {
+  padding: 8px;
+  min-width: 200px;
+}
+
+.measurement-menu > div,
+.layers-menu > div {
+  padding: 8px 12px;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  transition: background-color 0.2s;
+}
+
+.measurement-menu > div:hover,
+.layers-menu > div:hover {
+  background-color: #f5f5f5;
+}
+
+/* 图层菜单项样式 */
+.layers-menu .map-type-item {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 6px;
+  cursor: pointer;
+  border-radius: 3px;
+  transition: background-color 0.2s;
+}
+
+.layers-menu .map-type-item:hover {
+  background-color: #f5f5f5;
+}
+
+.layers-menu .map-type-item.selected {
+  background-color: #e3f2fd;
+}
+
+.layers-menu .map-type-thumbnail {
+  width: 20px;
+  height: 20px;
+  border-radius: 2px;
+}
+
+.layers-menu .map-type-checkmark {
+  color: #1976d2;
+  font-weight: bold;
+  margin-left: auto;
+}
+
+/* 响应式设计 */
+@media (max-width: 768px) {
+  .cesium-map-toolbar {
+    padding: 6px;
+    gap: 6px;
+  }
+  
+  .cesium-toolbar-button {
+    width: 36px;
+    height: 36px;
+    font-size: 12px;
+  }
+  
+  .search-container,
+  .measurement-menu,
+  .layers-menu {
+    min-width: 180px;
+  }
+}

package/package.json

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